CocoaPods 使用小结

景天儿
4,570 阅读6分钟

部分参考了使用 CocoaPods 打包

1 工具安装

//安装
sudo gem install cocoapods-packager

//更新
sudo gem update --system 
sudo gem install cocoapods 
sudo gem install cocospods-trunk

1.1 更换源/替换源

pod repo remove master
pod repo add master https://github.com/CocoaPods/Specs.git
pod repo update

注意，如果官方源太慢，可以用清华的tuna源（有时下载会出问题，换个时间试试，相对还是快很多） 但是新版不允许直接添加master源了，但仍然有workaround

pod repo remove master
git clone https://mirrors.tuna.tsinghua.edu.cn/git/CocoaPods/Specs.git ~/.cocoapods/repos/master

1.2 修改工程Podfile的源

//在自己工程的Podfile（不是podspec文件）第一行加上：
source 'https://mirrors.tuna.tsinghua.edu.cn/git/CocoaPods/Specs.git'

1.3 当前版本中，如果不指定工程的Podfile源，默认是使用trunk，而不是master

2 pod仓库账号管理

//注册（要去邮箱里点击确认，流程才算完。）
pod trunk register xxx@163.com 'Yang' --description='Yang's xhzy mac'

//查看这个设备上的账号、相关设备信息、相关仓库信息。
pod trunk me

//换台电脑，需要登录(注册一个session)cocoapod仓库. （一样要去邮箱确认身份）
//一个账号可以有多台设备。
pod trunk register xxx@163.com

//给pod仓库添加owner, 相当于github上，添加开发者。
pod trunk add-owner SHWChatRobotNOUI xxx@gmail.com

3 创建lib项目

pod lib create [pod name]

3.1 podspec文件名，podspec中s.name保持一致，决定打出来的包是什么名字

比较好的做法是，

项目 git项目名 工程名 podspec name
源码 shw-voice-sdk-sourcecode SHWVoice SHWVoice
sdk shw-voice-sdk SHWVoiceSDK SHWVoiceSDK，spec文件中指定的framework是SHWVoice.framework
  1. 源码项目：看不到SDK字样
  2. 实际推送framework的项目：项目名带SDK，实际framework不带SDK

3.2 修改.gitignore以适应自己的打包情况

上一步操作，.gitignore已经自动生成。

4 lib包管理

4.1 校验

无论源码打包，framework提交，都要先校验。

//有静态库依赖时，需要加上选项 --use-libraries
pod lib lint SHWAccount.podspec --allow-warnings --use-libraries
//对于有私有库依赖的库，校验时需要加上--source
pod lib lint SHWAccount.podspec --allow-warnings --use-libraries --sources="https://code.aliyun.com/xhzy-ios/frameworkplatform.git,https://github.com/CocoaPods/Specs.git"

4.2 打包，即源码打包，和framework无关。如果开源，也不用打包，直接推送。

打包时注意s.version的版本号。

  1. 如果使用本地源码打包，不要求git仓库有对应的tag。
  2. 如果使用git地址打包，并且spec的source中里面写了tag，需要打tag。
//--no-mangle，表示不把第三方源码、framework打进去
//--exclude-deps，解决pod-numm冲突，不包含依赖的符号表
//--force，强制覆盖之前已经生成过的二进制库 
pod package SHWAccount.podspec --force --no-mangle --exclude-deps
//对于有私有库依赖的库，打包时需要加上--spec-sources
$ pod package SHWAccount.podspec --force --no-mangle --exclude-deps --spec-sources="https://code.aliyun.com/xhzy-ios/frameworkplatform.git,https://github.com/CocoaPods/Specs.git"

4.3 推送

4.3.1 到自己的仓库

4.3.1.1 添加仓库

pod repo add REPO_NAME SOURCE_URL

4.3.1.2 推送到仓库

pod repo push platform XYiOSComponent.podspec
//--use-libraries 如果有.a就需要添加这个选项

4.3.2 推送到公网仓库

pod trunk push xx.podspec --allow-warnings --use-libraries    //--use-libraries 如果有.a就需要添加这个选项

4.3.3 查看本地仓库

pod repo list

4.3.4 清理本地仓库，同时也删掉了本地使用的源

pod repo remove trunk
pod repo remove master

4.3.5 本地仓库路径

~/.cocoapods/repos

4.4 删除已提交的版本（不好用）

pod_trunk_delete

pod trunk deprecate xxx
pod trunk delete xxx 0.5.8

4.5 其他参数

Pod二进制化，可以参考，但一些参数的描述和项目实际使用中不太一样。

5 缓存相关（同版本号打多次无效）

5.1 缓存路径

~/Library/Caches/CocoaPods/Pods/Specs/External

5.2 列出缓存

pod cache list

5.3 清理缓存

pod cache clean -all

6 Podfile

source 'https://github.com/CocoaPods/Specs.git'

inhibit_all_warnings!

platform :ios, "9.0"

#use_frameworks!

#可以对多个target设置不同的引用
target "WorkApp" do    
  pod 'Masonry'
  pod 'AFNetworking'
end

use_frameworks! 把lib-Pod打成framework，而不是.a，用于swift中，oc中不要加这句，可能报错。

6.1 lib项目的Podfile

source 'https://github.com/CocoaPods/Specs.git'
inhibit_all_warnings!

platform :ios, "8.0"
target 'SHWRecommendUI_Example' do
#这里可以改
  pod 'SHWRecommendUI', :path => '../'
  pod 'YYText'
  target 'SHWRecommendUI_Tests' do
    inherit! :search_paths
    pod 'Kiwi'
  end
end

6.2 新特性，加快索引速度

//Podfile
install! 'cocoapods', generate_multiple_pod_projects: true

之前Cocoapods把每个依赖作为 target 放到 Pods 项目里，由于 xcodeproj 编码原因，pod多的时候，解析的效率会急剧下降。 generate_multiple_pod_projects选项，让每个依赖都作为一个单独的项目引入，大大增加了解析速度.

系统升级后的一些问题提示 pod search 出错 pod search 找不到 s.source源引起的问题

7 podspec

Podspec 语法

友盟的subspec

MJRefresh的podspec

NewsFeedsUISDK的podspec

FFToast的podspec

Pod::Spec.new do |s|
    s.name = 'SHWAnalyticsSDK'
    s.version = '1.2.2'
    s.summary = 'Analytics framework.'
    s.description = "项目 iOS SDK 源码"

    s.homepage = 'https://code.aliyun.com/xhzy-ios/SHWAnalytics'
    s.license = { :type => 'MIT', :file => 'LICENSE' }
    s.author = { "yangyang" => "xxx@xxx.com" }

#s.source = { :git => 'git@code.aliyun.com:xhzy-ios/ios-account-sdk.git', :tag => s.version.to_s }
    # develop source
    s.source = { :git => 'git@code.aliyun.com:xhzy-ios/ios-analytics-sdk.git'}

    s.ios.deployment_target = '9.0'
    s.source_files = 'SHWAnalyticsSDK/Classes/**/*'

    s.public_header_files = 'SHWAnalyticsSDK/Classes/Public/*.h'
    s.frameworks = 'CoreLocation','CoreTelephony','Foundation','JavaScriptCore','UIKit','WebKit', 'SystemConfiguration','CoreFoundation','Security'
    s.dependency 'UTDID', '~> 1.0.0'
end

7.1 打包第三方静态库.a 动态库.framework, 以及subspec

Pod::Spec.new do |s|
    s.name = 'SHWAIConversation'
    s.version = '1.52.0'
    s.summary = 'xxx'
    s.homepage = 'https://code.aliyun.com/xxx'

    s.license = { :type => 'MIT', :file => 'LICENSE' }
    s.author = { 'yangyang' => 'youxiang' }
    s.ios.deployment_target = '9.0'

# s.source = { :git => 'git@code.aliyun.com:xxx.git', :tag => s.version.to_s}
    s.source = { :git => '/Users/yayang/Desktop/SHWAIConversation'}
    s.source_files = 'SHWAIConversation/Classes/**/*'
    s.public_header_files = 'SHWAIConversation/Classes/public/*.h'
    s.resources = 'SHWAIConversation/Resource/*'

    s.frameworks = 'CoreLocation', 'SystemConfiguration', 'CoreFoundation', 'JavaScriptcore', 'CoreTelephony', 'Security', 'AudioToolbox', 'CoreMotion', 'OpenGLES', 'CoreGraphics', 'AVFoundation'
    s.libraries = 'icucore'
    #第三方.a
    s.ios.vendored_library = 'SHWNLSClient/Classes/3rd/Opus/lib/libopus.a'
    
    # subspec
    s.subspec 'NlsClientSDK' do |nls|
        nls.name = 'NlsClientSDK'
        nls.frameworks = 'CoreLocation', 'SystemConfiguration', 'CoreFoundation', 'JavaScriptcore', 'CoreTelephony', 'Security', 'AudioToolbox', 'CoreMotion', 'OpenGLES', 'CoreGraphics', 'AVFoundation'
        nls.libraries = 'icucore'
        #第三方framework
        nls.ios.vendored_frameworks = 'SHWAIConversation/Frameworks/NlsClientSDK.framework'
    end

    # dependencys
    s.dependency 'Masonry', '~> 1.1.0'
end

7.2 使用本地源码打包

目的：为了提前发现问题，可以在不提交的情况下进行测试。 实现方式：有两种

  1. 第一种方式，只需要在原工程上修改podspec
  2. 第二种方式，需要两个工程，原工程不修改，另一个工程修改podspec和Podfile

两种方式各有利弊，总的来说，因为可以用多桌面，可能还是第二种稍好。

    s.source = { :git => '/Users/yayang/Desktop/SHWAIConversation'}

source 'https://github.com/CocoaPods/Specs.git'

inhibit_all_warnings!

platform :ios, "8.0"

target 'SHWRecommendUI_Example' do
#这里有个大坑，注意要依赖于实际源码，而不是打包出的源码，如/Users/yangyang/Documents/code/workspace/test6/YangTest1Resource/YangTest1Resource-0.2.6
  pod 'SHWRecommendUI', :path => '/Users/yangyang/Documents/code/workspace/test6/YangTest1Resource'

  target 'SHWRecommendUI_Tests' do
    inherit! :search_paths

    pod 'Kiwi'
  end
end

7.3 framework中打包bundle文件

s.resource = 'NewsFeedsUISDK/NewsFeedsUISDK.framework/Versions/A/Resources/NFUIBundle.bundle'

8 一些问题

8.1 无法修改保存

The document could not be saved. The file doesn’t exist.

关掉Xcode，用Xcode单独打开这个文件，修改保存关闭。

再用Xcode打开项目。This issue is gone.

8.2 空文件夹不会自动放到Xcode中

在podspec文件创建好之后pod install。

但是源码根目录（Class目录下）的空文件夹，不会自动被放到Xcode中。

8.3 pod repo update + pod search 找不到/出错

//JSON::ParserError - A JSON text must at least contain two octets!
rm ~/Library/Caches/CocoaPods/search_index.json

8.4 系统升级后，pod install失败

//错误1 RuntimeError - [Xcodeproj] Unknown object version.
sudo gem install cocoapods --pre

//错误2 ERROR: While executing gem ... (Errno::EACCES)
// Permission denied @ rb_sysopen - /Library/Ruby/Gems/2.3.0/gems/xcodeproj-1.5.7/LICENSE
sudo chmod -R 777 /Library/Ruby/Gems/

//错误3 ERROR: While executing gem ... (Gem::FilePermissionError)
// You don't have write permissions for the /usr/bin directory.
sudo gem install -n /usr/local/bin cocoapods

8.5 其他问题

  1. podspec.json的source iOS使用cocoapods 安装libwebp 0.6.0遇到Error installing libwebp
find /Users/yangyang/.cocoapods/repos/master -iname libwebp
cd /Users/yangyang/.cocoapods/repos/master/Specs/1/9/2/libwebp
cd 0.6.1
修改libwebp.podspec.json
"source": {
"git": "https://chromium.googlesource.com/webm/libwebp",
"tag": "v0.6.0"
},
将其中的"git"对应的url替换为https://github.com/webmproject/libwebp.git
  1. 有些git源，只支持git@code.aliyun.com/xxx形式地址

也可能是，没有配好本地的https用户名密码。或阿里云阶段性抽风

8.6 raw.githubusercontent.com

CDN: trunk URL couldn't be downloaded: https://raw.githubusercontent.com/CocoaPods

错误原因：podfile文件中一定要指定master源，因为现在默认是trunk源，在podfile的第一行，指定官方仓库地址

source 'https://github.com/CocoaPods/Specs.git' #官方仓库地址

如果pod search出错

//删除trunk源
pod repo remove trunk

9 其他命令

pod search
avatar
文章
阅读
粉丝
相关推荐
如何使用 CocoaPods 分发 Swift 宏
1.1k阅读
 · 
5点赞
「CocoaPods」Podfile文件模板
1.5k阅读
 · 
8点赞
将项目依赖从 CocoaPods 迁移到 SPM
5.7k阅读
 · 
23点赞
gem 安装 cocoapods 遇到了问题
2.6k阅读
 · 
2点赞
CocoaPods搭建私有库
1.5k阅读
 · 
1点赞
iOS 创建framework依赖cocoapods
2.4k阅读
 · 
2点赞
cocoapods原理-配置调试环境
2.6k阅读
 · 
6点赞
CocoaPods Hook 心路历程
2.3k阅读
 · 
8点赞
CocoaPods使用指南
10k阅读
 · 
74点赞
cocoapods私有库之创建(一)
6.3k阅读
 · 
55点赞

友情链接：