CocoaPods 便捷手册

安装 CocoaPods

CocoaPods 的安装都是通过 gem 来管理，所以安装/更新 CocoaPods 之前，我们需要先更新下 gem:

sudo gem update --system 。

• 安装 CocoaPods

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

• 更新CocoaPods

  sudo gem update cocoapods -n /usr/local/bin

• 回到上一版本

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

• 卸载 CocoaPods

  sudo gem uninstall cocoapods -n /usr/local/bin

Pod仓库显示

pod repo 或者 pod repo list

使用 Podfile

常用操作

• 在当前目录下创建Podfile

  pod init

• 安装依赖库

  pod install

• 更新依赖库

  pod update

• 更新特定依赖库

  pod update LibraryName --verbose --no-repo-update

Podfile样例

source 'https://cdn.cocoapods.org/'
platform :ios, '9.0'
use_frameworks!

workspace 'App.xcworkspace'

target ’SDK' do
  project 'SDK/SDK.xcodeproj'
  pod 'YYKit'
  pod 'FBSDKCoreKit', '~> 4.31.0'
  pod 'FBSDKLoginKit', '~> 4.31.0'
  pod 'FBSDKShareKit', '~> 4.31.0
end

target ‘App' do
  project ‘App.xcodeproj’
    # To use repo on your local machine:
    pod 'Alamofire', :path => '~/Documents/Alamofire'

    # To use the master branch of the repo:
    pod 'Alamofire', :git => 'https://github.com/Alamofire/Alamofire.git'

    # To use a different branch of the repo:
    pod 'Alamofire', :git => 'https://github.com/Alamofire/Alamofire.git', :branch => ‘dev'

    # To use a tag of the repo:
        pod 'Alamofire', :git => 'https://github.com/Alamofire/Alamofire.git', :tag => ‘3.1.1’

    # Or specify a commit:
      pod 'Alamofire', :git => 'https://github.com/Alamofire/Alamofire.git', :commit => ‘0f506b1c45'
end

post_install do |installer|
  installer.pods_project.targets.each do |target|
       target.build_configurations.each do |config|
          config.build_settings['GCC_WARN_INHIBIT_ALL_WARNINGS'] = 'YES'
                config.build_settings['ARCHS'] = 'arm64'
        end
    end
end

发布 Pod 库

发布公有 Pod 库

操作步骤

1. 注册CocoaPods

   pod trunk register yourname@xxx.com 'Evan Xie’ --description=’NEVER GIVE UP!!!'

2. 将你的 pod spec 上传到 CocoaPods 远程仓库

   pod trunk push YourLibraryName.podspec --allow-warnings

3. 创建 podspec 文件

   pod spec create YourLibraryName

4. 验证你的Pod库

   pod lib lint --allow-warnings

5. 创建 tag 并 push 到 git 远程仓库

   git tag 0.0.1

   git push --tags

公有 Pod Spec 管理

• 查看个人信息

  pod trunk me

• 废弃 podspec

  pod trunk deprecate YourLibraryName

• 删除某个版本

  pod trunk mepod trunk delete YourLibraryName PodspecVersion

发布私有 Pod 库

操作步骤

1. 创建存放 pod specs 的 Git 仓库, 并添加到 Pod 仓库中

   pod repo add PrivatePodSpecs git@github.com:xxx/PrivatePodSpecs.git

2. 在本地查看私有仓库

   第一步添加完成后，查看文件夹 ~/.cocoapods/repos， 可以发现增加了一个 PrivatePodSpecs 的仓库.

3. 创建代码仓库

   代码仓库创建完成克隆到本地，然后就可以创建私有 podspec 了。

4. 创建 podspec 文件

   pod spec create YourLibraryName

5. 验证你的Pod库

   pod lib lint --allow-warnings

6. 创建 tag 并 push 到 git 远程仓库

   git tag 0.0.1

   git push --tags

7. 将 podspec 推送到创建好的私有存放 PodSpecs 的 Git 仓库

   pod repo push PrivatePodSpecs YourLibraryName.podspec --verbose --allow-warnings

8. Push成功后，查看 ~/.cocoapods/repos， 就可以发现多了一个 YourLibraryName.podspec。如果未找到，可以先更新下 PrivatePodSpecs 仓库: pod repo update PrivatePodSpecs 。

使用私有Pod库

在 Podfile 中指明私有 pod spec 仓库地址:

source 'git@github.com:xxx/PrivatePodSpecs.git’

Podfile

最后你的Podfile可能长这个样子：

source 'https://cdn.cocoapods.org/'
source 'git@github.com:xxx/PrivatePodSpecs.git'

platform :ios, '9.0'

workspace 'MyApp.xcworkspace'

target 'MyApp' do
  use_frameworks!
  
  # 你的私有库
  pod 'YourLibraryName'
  
    # 公有库
    pod 'RxSwift' 
end

指明私有 pod spec 仓库地址

如果私有 pod 仓库不能访问，可以尝试下域名与IP的映射。

打开 /etc目录，编辑 hosts文件，添加映射即可。例如：

##
# Host Database
#
# localhost is used to configure the loopback interface
# when the system is booting.  Do not change this entry.
##
127.0.0.1   localhost
255.255.255.255 broadcasthost
::1             localhost

# 自己添加的域名与 IP 的映射
10.xxx.xxx.111 gitlab.compnayname.com

Pod Spec Beta 版本说明

比如我们要发的正式版本是 1.0.0, 不过目前还在开发过程中，所以我们可以使用用 beta 版本。

假设我们发了两个版本: 1.0.0-beta1, 1.0.0-beta2，然后我们在 Podfile 中可以这样使用：

pod 'MyLibrary', '~> 1.0.0-beta’

pod install 后，就会自动更新到 1.0.0-beta2.

假设我们正式发布了 1.0.0版本，如果 Podfile 中还是用 1.0.0-beta 版本，那么 pod install 后， 会自动升级到正式版本 1.0.0。

更多版本号说明，请看这里: Semantic Versioning 。

常见问题

1. pod lib lint 报xcrun unable to find simctl问题

​ 打开Xcode > Preferences > Locations 更改一下 Command Line Tools选项就可以了。