「这是我参与11月更文挑战的第2天,活动详情查看:2021最后一次更文挑战」。
前言
昨天给公司的M1
款iMac
安装CocoaPods
,遇到了一些问题,现在记录下来,以便大家学习和后续查阅。
- 硬件环境:
iMac (24-inch, M1, 2021)
- 芯片:
Apple M1
- 系统:
macOS Big Sur 11.3
执行下面的任何步骤时,如果遇到中断、进度缓慢、各种失败等问题,请参考以下原则:
1、多次重复几次,没准就能成功。
2、连接手机,使用手机移动网络(公司网络太慢,笔者使用的就是手机的5G网络)。
3、如果能科学上网,那么就科学上网;能使用镜像,就使用镜像。
4、在网络环境好的时候重试。
5、其他问题请百度或谷歌。
以下步骤本人M1
款iMac
亲测,如果中间网络不好导致失败或出错,重新执行一次命令就可以了。
CocoaPods
简介
CocoaPods
是一个用Ruby
写的、负责管理iOS
项目中第三方开源库的工具,CocoaPods
能让我们集中的、统一管理第三方开源库,为我们节省设置和更新第三方开源库的时间。
安装rvm
,升级Ruby
Mac
电脑自带Ruby
环境,但是版本一般比较低,为了避免在安装过程中出现问题,先对Ruby
进行升级。
1、检查当前Ruby
版本
ruby -v
2、安装rvm
,升级Ruby
环境
// 下载rvm稳定版,需要等待几分钟
curl -L get.rvm.io | bash -s stable
// 设置shell和profile,bash和zsh二选一
// bash
source ~/.bashrc
source ~/.bash_profile
// zsh,新版系统默认shell都是zsh
source ~/.zshrc
source ~/.profile
3、查看rvm
版本
rvm -v
笔者的最新版本:
rvm 1.29.12 (latest) by Michal Papis, Piotr Kuczynski, Wayne E. Seguin [https://rvm.io]
4、查看Ruby
可安装的版本
rvm list known
显示结果:
# MRI Rubies
[ruby-]1.8.6[-p420]
[ruby-]1.8.7[-head] # security released on head
[ruby-]1.9.1[-p431]
[ruby-]1.9.2[-p330]
[ruby-]1.9.3[-p551]
[ruby-]2.0.0[-p648]
[ruby-]2.1[.10]
[ruby-]2.2[.10]
[ruby-]2.3[.8]
[ruby-]2.4[.10]
[ruby-]2.5[.8]
[ruby-]2.6[.6]
[ruby-]2.7[.2]
[ruby-]3[.0.0] // 最新版
// 如有测试版会显示在这里
ruby-head
5、选择一个Ruby
版本安装
笔者选择的是3.0.0
版本,当然,你也可以根据自己的喜好选择其他版本。此过程需要输入电脑密码(不可见,只管输入就行)。
rvm install 3.0.0
如果上面的命令不行(因为需要使用openssl@1.1
),那就使用下面的这个,当然ruby
版本和openssl
版本自己定。
rvm install 3.3.6 --with-openssl-dir=$(brew --prefix openssl@3.4)
如果你电脑没有安装
Xcode
、Command Line Tools for Xcode
以及Homebrew
,此过程中会自动下载安装。建议提前安装好这三者Mac安装homebrew。
如果没有安装Homebrew
,可能会遇到错误,所以还是提前安装比较好。
6、设置为默认版本
rvm use 3.0.0 --default
7、更换源
由于国外Ruby
源较慢,我们更换成ruby-china
的源。
sudo gem update --system
gem sources --remove https://rubygems.org/
gem sources --add https://gems.ruby-china.com/
8、查看更换结果
gem sources -l
以下结果说明正确,其他情况请自行百度解决。
*** CURRENT SOURCES ***
http://gems.ruby-china.com/
https://gems.ruby-china.com/
安装CocoaPods
到这里,恭喜你,可以正式开始安装CocoaPods
了。
1、install cocoapods
sudo gem install -n /usr/local/bin cocoapods
2、选择Xcode
版本
如果安装了多个Xcode
版本,使用下面的命令选择(推荐选择最近的Xcode
版本)。
sudo xcode-select -switch /Applications/Xcode.app/Contents/Developer
3、安装本地库
pod setup
从Mac OS Catalina
开始,终端执行上面命令后就直接结束了。
没关系,我们手动安装本地库就可以了。
// 国外地址,如果你能科学上网的话,可以使用这个方法
git clone https://github.com/CocoaPods/Specs.git ~/.cocoapods/repos/trunk
// 清华大学镜像,速度杠杠的,推荐使用
git clone https://mirrors.tuna.tsinghua.edu.cn/git/CocoaPods/Specs.git ~/.cocoapods/repos/trunk
4、检查是否可用
执行pod search
命令,检查是否可用。
pod search AFNetworking
5、CocoaPods
使用
-
新建一个
Xcode
工程,使用终端cd
到工程目录下。 -
创建
Podfile
文件。
pod init
- 打开
Podfile
文件,添加AFNetworking
,保存并退出。
open Podfile
pod 'AFNetworking'
- 开始下载。
pod install
下载完成之后会生成.xcworkspace
文件,以后打开项目都使用这个文件。
6、一些简单pod
命令
安装
pod install
升级
pod update
不更新已有库安装和升级
pod install --verbose --no-repo-update
pod update --verbose --no-repo-update