安装CocoaPods方法(M1)

573 阅读4分钟

「这是我参与11月更文挑战的第2天,活动详情查看:2021最后一次更文挑战」。

前言

昨天给公司的M1iMac安装CocoaPods,遇到了一些问题,现在记录下来,以便大家学习和后续查阅。

  • 硬件环境:iMac (24-inch, M1, 2021)
  • 芯片:Apple M1
  • 系统:macOS Big Sur 11.3

执行下面的任何步骤时,如果遇到中断、进度缓慢、各种失败等问题,请参考以下原则:

1、多次重复几次,没准就能成功。
2、连接手机,使用手机移动网络(公司网络太慢,笔者使用的就是手机的5G网络)。
3、如果能科学上网,那么就科学上网;能使用镜像,就使用镜像。
4、在网络环境好的时候重试。
5、其他问题请百度或谷歌。

以下步骤本人M1iMac亲测,如果中间网络不好导致失败或出错,重新执行一次命令就可以了。

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)

如果你电脑没有安装XcodeCommand 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