[iOS]CocoaPods安装和使用

1.了解brew、rvm、ruby、gem、cocaspods之间的关系

在 macOS 环境中，Brew、RVM、Ruby、Gem 和 CocoaPods 之间存在以下关系：

Homebrew (Brew)：Homebrew 是 macOS 上的包管理器，用于安装和管理各种开源软件包。它使您能够轻松地从命令行安装、更新和卸载软件包，包括开发工具、库和其他应用程序。
RVM (Ruby Version Manager)：RVM 是一个用于管理和安装多个 Ruby 版本的工具。它允许您在同一台计算机上同时安装和切换不同版本的 Ruby。RVM 还提供了一个独立的环境，以隔离不同版本的 Ruby 和它们的依赖项。
Ruby：Ruby 是一种动态、面向对象的编程语言，经常用于 Web 开发和脚本编写。它由日本开发者松本行弘（Yukihiro Matsumoto）创建，并且具有简洁、优雅的语法。RVM 用于安装和管理不同版本的 Ruby。
Gem：Gem 是 Ruby 的软件包管理系统。它用于安装、管理和分发 Ruby 应用程序和库。Gem 包含可重用的代码库，让开发人员能够轻松地共享和使用 Ruby 的扩展功能。通过 Gem，您可以安装和管理与 Ruby 相关的软件包和依赖项。
CocoaPods：CocoaPods 是一个用于管理 iOS 和 macOS 项目中的第三方库依赖项的工具。它使用 Ruby 编写，并且依赖于 Gem 来安装和管理自己的软件包。CocoaPods 允许您在 Xcode 项目中轻松地集成和更新各种开源库。

综上所述，Brew 是用于管理 macOS 上的软件包的包管理器，RVM 是用于管理和安装多个 Ruby 版本的工具，Ruby 是编程语言本身，Gem 是 Ruby 的软件包管理系统，而 CocoaPods 是用于管理 iOS 和 macOS 项目中的第三方库依赖项的工具，它使用 Gem 来安装和管理自己的软件包。Brew、RVM、Ruby、Gem 和 CocoaPods 提供了一套工具链，使您能够更方便地安装、管理和使用 Ruby 和相关的软件包和依赖项。

2.检查并安装brew

验证 Homebrew 是否安装

$ brew doctor

执行以下指令，下载 Homebrew 的安装脚本并自动执行安装过程。

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

(1).提示无法连接到服务器

tbd@tbddeMacBook-Air ~ % /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
curl: (7) Failed to connect to raw.githubusercontent.com port 443 after 10 ms: Couldn't connect to server

出现这个问题按如下排查：

网络问题：

你的网络连接可能存在问题。请检查你的网络连接是否正常。
如果你在中国大陆，GitHub 的某些资源可能会受到网络审查的影响，你可能需要使用 VPN 或者代理来访问 GitHub。

DNS 解析问题：

打开“系统偏好设置”。
点击“网络”图标。
选择你正在使用的网络服务（如 Wi-Fi 或以太网）。
点击“高级”按钮。
切换到“DNS”标签页。
点击左下角的“+”号，添加一个新的 DNS 服务器地址（例如 8.8.8.8 或 1.1.1.1）。
点击“好”，然后点击“应用”来保存设置。

系统设置：

确认你的系统没有设置错误的代理或者防火墙规则，这些设置可能会阻止你的连接。

在本地的hosts文件中手动解析域名到特定IP：

打开你的终端应用程序（Terminal）。
输入以下命令以使用管理员权限编辑 hosts 文件：

$ sudo nano /etc/hosts

这里使用 nano 作为文本编辑器，你也可以使用其他你熟悉的编辑器，比如 vi 或 vim。

你将被提示输入你的管理员密码。
在打开的 hosts 文件中，你可以添加一行来指定域名到 IP 的映射。例如：

140.82.114.4 github.com

查询域名对应的IP地址网站https://mxtoolbox.com/SuperTool.aspx

保存并关闭文件。如果你使用 nano，可以按 Control + O 保存文件更改（Ctrl+O后需要按Enter回车键），然后按 Control + X 退出编辑器。
为了让更改立即生效，你可能需要刷新你的本地 DNS 缓存。在 macOS 上，你可以使用以下命令：

$ sudo killall -HUP mDNSResponder

现在，当你访问 github.com 时，你的系统将直接使用在 hosts 文件中指定的 IP 地址，而不是通过 DNS 解析域名。请确保你使用的是 GitHub 服务器的正确 IP 地址，你可以通过 ping 命令来找到当前的 IP 地址：

$ ping github.com

(2).安装警告

warning: /opt/homebrew/bin is not in your PATH. Instructions on how to configure your shell for Homebrew canbe found in the "Next steps " section below.

安装 Homebrew 后出现这个错误是因为 Homebrew 的可执行文件目录 /opt/homebrew/bin 没有添加到您的 PATH 环境变量中。为了使 Homebrew 正常工作，您需要确保该路径包含在您的 PATH 环境变量中。

根据您使用的 shell，这里有几种方法来解决这个问题：

如果你使用的是 Bash：

打开您的 ~/.bash_profile 或 ~/.bashrc 文件（通常 ~/.bash_profile 用于登录 shell，而 ~/.bashrc 用于非登录 shell。如果您不确定，可以两个都设置）：

$ nano ~/.bash_profile

或者

$ nano ~/.bashrc

然后添加以下行到文件的末尾：

export PATH="/opt/homebrew/bin:$PATH"

保存并关闭文件。在使用 nano 文本编辑器时，保存和退出的步骤通常如下：

按下 Ctrl + O 会提示你保存文件。在底部会显示 File Name to Write: /etc/hosts。
这时候你按下 Enter 键以确认保存。
保存文件后，按下 Ctrl + X 退出 nano 编辑器。

之后，您需要加载新的配置。您可以通过关闭并重新打开终端来做到这一点，或者运行以下命令：

$ source ~/.bash_profile

或者

$ source ~/.bashrc

如果你使用的是 Zsh：

打开您的 ~/.zshrc 文件：

$ nano ~/.zshrc

然后添加以下行到文件的末尾：

export PATH="/opt/homebrew/bin:$PATH"

保存并关闭文件。之后，您需要加载新的配置。您可以通过关闭并重新打开终端来做到这一点，或者运行以下命令：

$ source ~/.zshrc

3.检查并安装rvm

检查rvm是否安装

$ rvm -v

检查提示rvm: command not found时，就表示rvm需要安装。

先用下面命令安装

$ curl -L https://get.rvm.io | bash -s stable

上一步执行完成后再执行

$ source ~/.rvm/scripts/rvm

再次查询rvm的安装情况

$ rvm -v

4.检查并安装ruby

先检查ruby的信息，安装cocaPods，ruby环境不得低于2.2.2，否则会报错。

$ ruby -v

安装最新Ruby版本

最好更新到新版本，可以去官网查询ruby最新版本下载 Ruby

安装最新稳定版本Ruby

$ rvm install 3.2.2

然后输入指令查看是否安装成功

$ rvm list

切换Ruby版本

$ rvm use ruby-3.2.2

移除Ruby版本

$ rvm uninstall ruby-2.6.6

如果遇到权限问题或其他错误，确保你有足够的权限来执行这些操作，或者尝试使用sudo（在知道自己在做什么的情况下）。

$ sudo rvm remove ruby-2.6.6

5.检查并更新gem ruby

检查gem ruby版本，需要输入一次密码。

$ sudo gem -v

更新gem ruby

最新版本，可以去网站查询一下https://rubygems.org/pages/download

$ gem update --system

6.检查并更新ruby源

检查ruby源

$ gem sources -l

如果展示https://rubygems.org/ 则移除此ruby源。

$ gem sources --remove https://rubygems.org/

然后添加https://gems.ruby-china.com/这个ruby源。

$ gem sources --add https://gems.ruby-china.com/

注意：先不急着切换，看能否进行下一步的安装。https://rubygems.org/和https://gems.ruby-china.com/这两个源都是能正常使用的，某个源下载安装不了就换一个。

7.安装CocoaPods

cocoapods官网地址:https://cocoapods.org/

安装cocoapods指令，sudo表示管理员指令，需要输入密码。

$ sudo gem install -n /usr/local/bin cocoapods

或者

$ sudo gem install -n /usr/local/bin cocoapods  --pre

安装后，检查安装情况。

$ pod --version

8.CocoaPods使用

先创建一个iOS测试工程GaminTestDemo

(1).创建Podfile

Podfile 是一个用于定义你的项目中需要使用哪些第三方依赖的文件。要在你的项目中创建一个 Podfile，你首先需要在终端中定位到你的项目目录，然后执行pod init.

然后打开终端，cd到项目。

$ cd /Users/gamin/Desktop/GaminTestDemo

然后再初始化pod，执行成功后，目录中会多出一个Podfile文件。

$ pod init

(2).管理依赖和版本控制

打开Podfile文件，比如想在项目中使用 Alamofire 网络库。

# Uncomment the next line to define a global platform for your project
# platform :ios, '9.0'target 'GaminTestDemo' do# Comment the next line if you don't want to use dynamic frameworksuse_frameworks!# Pods for YourProjectNamepod 'Alamofire', '~> 5.2'
end

use_frameworks! 指示 CocoaPods 使用动态框架而非静态库。

pod 'Alamofire', '~> 5.2' 表示你想要安装 Alamofire，版本约束为大于等于 5.2 但小于 6.0。

一旦你编辑完 Podfile，可以通过以下命令来安装这些依赖：

$ pod install

这个命令会根据 Podfile 的定义来安装所需的库，并创建一个 .xcworkspace 文件。你应当使用这个 workspace 文件来打开你的项目，而不是原来的 .xcodeproj 文件。

为了管理版本控制，CocoaPods 提供了锁定已安装依赖版本的机制。当你运行 pod install 时，CocoaPods 会创建一个名为 Podfile.lock 的文件，它记录了实际安装的库的确切版本。这确保了项目的所有协作者都会使用完全相同的依赖版本，从而避免了因版本不一致导致的构建或运行时问题。

当你想要更新某个库到最新版本时，可以运行：