CocoaPods 常用命令
- 升级 Gem
sudo gem update -n /usr/local/bin --system
- 切换 Cocoapods 的数据源
gem sources --remove https://rubygems.org/
gem sources -a https://gems.ruby-china.com/
gem sources -l
- 安装 Cocoapods
sudo gem install -n /usr/local/bin cocoapods
ERROR: While executing gem ... (Gem::FilePermissionError)
You don't have write permissions for the /System/Library/Frameworks/Ruby.framework/Versions/2.6/usr/lib/ruby/gems/2.6.0 directory.
- 解决办法
重新安装 Ruby，见下文 `rvm install ruby-3.0.0`
- 安装 Cocoapods 指定版本
sudo gem install -n /usr/local/bin cocoapods -v 1.0.1
- 卸载
sudo gem uninstall -n /usr/local/bin cocoapods
- 查询
gem list --local | grep cocoapods
-
卸载 pod
- 查看
pod地址：which pod - 删除
pod：sudo rm -rf [pod 地址] - 查看
gem安装包：gem list - 按版本号卸载
cocoapods：sudo gem uninstall -n /usr/local/bin cocoapods -v 1.8.1
-
什么是CocoaPods?
CocoaPods是一个负责管理iOS项目中第三方开源库的工具。CocoaPods的项目源码在Github上管理。该项目开始于2011年8月12日，在这两年多的时间里，它持续保持活跃更新。开发iOS项目不可避免地要使用第三方开源库，CocoaPods的出现使得我们可以节省设置和更新第三方开源库的时间。
在我们有了CocoaPods这个工具之后，只需要将用到的第三方开源库放到一个名为Podfile的文件中，然后在命令行执行$ pod install
命令。CocoaPods就会自动将这些第三方开源库的源码下载下来，并且为我的工程设置好相应的系统依赖和编译参数。
-
CocoaPods 的好处
1、在引入第三方库时它可以自动为我们完成各种各样的配置，包括配置编译阶段、连接器选项、甚至是ARC环境下的-fno-objc-arc配置等。
2、使用CocoaPods可以很方便地查找新的第三方库，方便项目开发。
-
CocoaPods 安装步骤
1、升级 Ruby 环境
sudo gem update -n /usr/local/bin --system
出现 RubyGems system software updated 字样，
恭喜你升级Ruby成功了！
可能上面升级Ruby环境失败，这个时候使用
RVM对Ruby进行升级：
(1) 安装 RVM
RVM (Ruby Version Manager)，即Ruby版本管理器，包括Ruby的版本管理和Gem库管理。
curl -L get.rvm.io | bash -s stable
source ~/.bashrc
source ~/.bash_profile
若提示 -bash: /Users/***/.bash_profile: No such file or directory 找不到 .bash_profile 文件，直接在根目录创建一个即可：
cd ~
touch .bash_profile
安装成功后，可查看rvm版本：
rvm -v
(2) 用 RVM 升级 Ruby
- 查看当前ruby版本：
$ ruby -v - 列出已知的ruby版本：
$ rvm list known - 安装xcode command line：
$ xcode-select --install - 选择要安装的版本，如安装ruby 2.4.1：
$ rvm install 2.4.1 - 设置默认版本：
rvm use 2.4.1 --default - 查看已安装 ruby：
rvm list - 卸载一个已安装ruby版本：
sudo rvm remove 2.4.1
Warning! PATH is not properly set up, $GEM_HOME is not set.
Usually this is caused by shell initialization files. Search for PATH=... entries.
You can also re-add RVM to your profile by running: rvm get stable --auto-dotfiles
To fix it temporarily in this shell session run: rvm use ruby-2.5.3
To ignore this error add rvm_silence_path_mismatch_check_flag=1 to your ~/.rvmrc file.
- 遇到的问题
rvm install ruby-3.0.0
Searching for binary rubies, this might take some time.
No binary rubies available for: osx/11.6/x86_64/ruby-3.0.0.
Continuing with compilation. Please read 'rvm help mount' to get more information on binary rubies.
Checking requirements for osx.
Installing requirements for osx.
Updating system - please wait
Installing required packages: automake, libksba - please wait
There were package installation errors, make sure to read the log.
Try `brew tap --repair` and make sure `brew doctor` looks reasonable.
Check Homebrew requirements https://docs.brew.sh/Installation
- 先执行下面命令：
rvm autolibs read-only
There was an error(35).
Checking fallback: https://ftp.ruby-lang.org/pub/ruby/3.0/ruby-3.0.0.tar.gz
No fallback URL could be found, try increasing timeout with:
echo "export rvm_max_time_flag=20" >> ~/.rvmrc
There has been an error fetching the ruby interpreter. Halting the installation.
- 执行下面命令解决
echo "ruby_url=https://cache.ruby-china.com/pub/ruby" > ~/.rvm/user/db
- 安装
rvm install ruby-3.0.0
- 切换版本
rvm use 3.0.0
2、更换 Ruby 镜像
-
移除现有的
Ruby 镜像gem sources --remove https://rubygems.org/ -
添加国内最新镜像源
gem sources -a https://gems.ruby-china.com/ -
执行完毕之后输入
gem sources -l来查看当前镜像gem sources -l
输出结果如下：
*** CURRENT SOURCES ***
https://gems.ruby-china.com/
恭喜你添加成功啦
3、安装 CocoaPods
sudo gem install -n /usr/local/bin cocoapods
安装成功
然后执行 pod setup
终端输入：$ pod setup
提示如下信息说明执行完成：
For more information, see https://blog.cocoapods.org and the CHANGELOG for this version at https://github.com/CocoaPods/CocoaPods/releases/tag/1.4.0.beta.2
Setup completed
可以
command+n新建一个终端窗口，执行cd ~/.cocoapods/进入到该文件夹下，然后执行du -sh *来查看文件大小，当出现Setup completed的时候说明已经完成了。
4、CocoaPods 的使用
-
搜索第三方库
pod search *** -
创建
Podfile文件cd 工程目录进入工程文件目录下，然后创建Podfile文件
touch Podfile或者
pod init -
使用
vim编辑Podfile文件vim Podfile
An example of a more complex Podfile can be:
platform :ios, '9.0'
inhibit_all_warnings!
target 'MyApp' do
pod 'ObjectiveSugar', '~> 0.5'
target "MyAppTests" do
inherit! :search_paths
pod 'OCMock', '~> 2.0.1'
end
end
5、下载库到项目中
pod install
or
pod update
pod installted 完成后，工程目录会看到多了一个后缀名为 *.xcworkspace 文件。以后打开此文件即可开发啦~
6、文件和指令说明
-
Podfile.lock文件最后一次更新 Pods 时, 所有第三方框架的版本号 常用指令的区别
pod install
1.会根据 Podfile.lock 文件中列举的版本号来安装第三方框架
2.如果一开始 Podfile.lock 文件不存在, 就会按照 Podfile 文件列举的版
本号来安装第三方框架
3.安装框架之前, 默认会执行pod repo update指令
pod update
1.将所有第三方框架更新到最新版本, 并且创建一个新的 Podfile.lock 文件
2.安装框架之前, 默认会执行 pod repo update 指令
pod install --no-repo-update
pod update --no-repo-update
1.安装框架之前, 不会执行pod repo update指令
7、原理和说明
a. 第三方库会被编译成 .a 静态库供我们真正的工程使用
* CocoaPods 会将所有的第三方库以 target 的方式组成一个名为 Pod 的工程，该工程就放在刚才新生成的Pods目录下。整个第三方库工程会生成一个名称为 libPods.a 的静态库提供给自己的工程用。
* 对于资源文件，CocoaPods 提供了一个名为 Pods-resources.sh 的bash 脚本，该脚本在每次项目编译的时候都会执行，将第三方库的各种资源文件复制到目标目录中。
b. 我们的工程和第三方库所在的工程会由一个新生成的workspace 管理
为了方便我们直观的管理工程和第三方库，CocoaPodsTest 工程和Pods 工程会被以 workspace 的形式组织和管理，也就是我们刚才看到的*.xcworkspace文件。
c. 原来的工程设置已经被更改了，这时候我们直接打开原来的工程文件去编译就会报错，只能使用新生成的 workspace 来进行项目管理。
d.CocoaPods 通过一个名为 Pods.xcconfig 的文件来在编译时设置所有的依赖和参数。
8、其他
1、pod install 提速
每次执行 pod install 和 pod update 的时候，cocoapods 都会默认更新一次 spec 仓库。这是一个比较耗时的操作。在确认 spec 版本库不需要更新时，给这两个命令加一个参数跳过 spec 版本库更新,可以明显提高这两个命令的执行速度。
pod install --verbose --no-repo-update
pod update --verbose --no-repo-update
2、关于 Podfile 文件编辑时，第三方库版本号的各种写法
pod ‘AFNetworking’ //不显式指定依赖库版本，表示每次都获取最新版本
pod ‘AFNetworking’, ‘2.0’ //只使用2.0版本
pod ‘AFNetworking’, ‘>2.0′ //使用高于2.0的版本
pod ‘AFNetworking’, ‘>=2.0′ //使用大于或等于2.0的版本
pod ‘AFNetworking’, ‘<2.0′ //使用小于2.0的版本
pod ‘AFNetworking’, ‘<=2.0′ //使用小于或等于2.0的版本
pod ‘AFNetworking’, ‘~>0.1.2′ //使用大于等于0.1.2但小于0.2的版本，相当于>=0.1.2并且<0.2.0
pod ‘AFNetworking’, ‘~>0.1′ //使用大于等于0.1但小于1.0的版本
pod ‘AFNetworking’, ‘~>0′ //高于0的版本，写这个限制和什么都不写是一个效果，都表示使用最新版本
1、查看 CocoaPods 组件安装位置：
which pod
结果：
/usr/bin/pod
2、手动移除这个组件：
sudo rm -rf /usr/bin/pod
3、查看 gems 中本地程序包
gem list
还可以输入如下命令查看：
pod --version
4、移除程序包
有了版本号，就可以根据当前版本号移除 CocoaPods 了：
sudo gem uninstall cocoapods -v 1.3.1
结果:
Successfully uninstalled cocoapods-1.3.1
5、安装指定版本的 CocoaPods
sudo gem install cocoapods -v 1.3.1
结果:
Successfully installed cocoapods-1.3.1
