关于CocoaPods的一些粗浅知识,越感赞叹其作者的智慧。唯有膜拜与马不停蹄地的学习。
用到的代码
specs
LibObject
PrivatePodDome
1. 安装
sudo gem install cocoapods
2. 快速上手
pod init
pod search AFNetworking
pod install
pod update
Podfile.lock
pod install vs pod update
- pod install
- 将pod的版本写入
Podfile.lock
文件中. - 对于已经在
Podfile.lock
中有记录的Pod下载对应的版本,即便有新的版本,也不会去更新. - 对于没有记录的,根据
Podfile
中的约定,下载版本,并把版本信息写入Podfile.lock
中.
- 将pod的版本写入
- pod outdated
-
查询当前所用库的最新版本信息.
-
- pod update
- pod update PODNAME --no-update-repo
只有当需要更新pod
版本时,才用pod update
,其余时间都用pod install
3. 添加本地Repo
创建一个git仓库,使用pod repo add your_private_spec_repo_name your_private_spec_repo_url
添加本地Repo
#添加本地Repo
pod repo add specs https://github.com/lbencs/specs.git
建好以后,用pod repo
可以查看当前所有repo
的信息,可以看到specs已经添加到本地。
4. 创建自己的spec
利用pod
提供的工具创建一个spec
项目 pod lib create your_project_name
pod lib create LibObject
期间,会又一些选项需要你去填写,填写完后就会自动生成一个项目
如果停在
pod install
了。可以直接中断。改用pod install --no-repo-update
项目的目录如下:
分为
Example
和Pods
两个主要的目录。先看
LibObject
,分为两个目录LibObject
|- Assets //用来存放本地资源,比如图片、Assets.xcassets等
|- Classes //存放
pod
的.m.h.swift.xib
文件等Example
就没啥好讲的,就是一个项目。两个目录以外还有两个文件
LICENSE
//授权文件my_spec_product.podspec
LibObject.podspec
.podspec
文件为整个pod
的配置文件。CocoaPods就是通过这个文件中的配置,来管理、拉取指定版本的代码。
详细配置信息内容移步
5. 开发与调试
用xcode
打开项目
有一个
Development Pods
的虚拟文件夹,show on folder
以后你会发现,里面的Pod
其实就是Pods
文件夹。这意味着你在这个文件夹下的操作,其实就是对Pods
文件夹的操作。这样开发中就可以方便的在视列程序里面进行pod
的开发了。
!!!!!
特别注意,每次往Pod
里面添加文件、图片、等任何非代码级别的改动的时候,都需要对Example
程序进行一次pod install
orpod update
一次。//Todo
6. 提交自己的Pods
- 创建自己的代码,完成测试。
- 提交Pod到Spec之前,需要验证一下自己的代码是否正确。可以通过
pod lib lint --verbose
命令验证当前pod本地代码是否运行正常。
- 测试通过以后,可以提交代码到remote端,并打上跟.podspec文件中,s.version 相同的tag号
- 本地验证通过以后,就可以提交到远程仓库,然后打上对应于
version
版本号的tag
,在通过pod spec lint --verbose
进行测试,看.podspec
文件中对应的代码是否运行通过。 - 通过测试以后,通过
pod repo push <#your repo name#> .podspec
命提交到上文中创建的specs
仓库
pod repo push specs LibObject.podspec --verbose
已经成功添加到
specs
仓库之中。pod必须无警告、无错误,否则可以用
pod repo push specs LibObject.podspec --verbose --allow-warnings
7. 使用
新建一个Dome,在Podfile中引用私有库specs
, 然后在引用LibObject
就此,pod引用成功
8. Tips
- 怎么在开发中调试程序
开发过程中,可以修改Podfile
文件的,将pod
版本指向本地。
对应pod
的代码会被引入Development Pods
中
- 模块之间的命名问题,最好以模块为单位添加不同的
前缀
。 -
Pod
之间的引用
#import "Masonry.h"
#import <Masonry/Masonry.h>
- 添加
pod
的某个tag
如0.0.1 到repo
后,需要修改代码但又不想提升tag
版本时,注意修改完后清理CocoaPods
的本地缓存
rm -rf "${HOME}/Library/Caches/CocoaPods"
pod cache list/cache
- 第三方库的修改,尽量
fork
再通过pod
引用 - 使用
ssh
协议 -
.gitignore
有时候突然想要忽略某个文件,但是跟新.gitignore
以后,remote端并没有马上删除这个文件,原因是ignore文件只能忽略没有加入版本管理的文件,已经被纳入了版本管理的文件是无效的。
git rm -r --cached .
git add .
git commit -m 'update .gitignore'
- 解决ArgumentError - invalid byte sequence in US-ASCII错误
修改终端语言、地区等国际化环境变量
export LANG=en_US.UTF-8
export LANGUAGE=en_US.UTF-8
export LC_ALL=en_US.UTF-8
- CI
ssh
问题
#解决ci远程slave访问git时,要求验证私钥密码问题
#即,pod install 时,跟新pod的访问权限问题
#$SSH_PARIVATE_KEY_PASS变量为私钥密码
#为了安全在jenkins的环境变量里面设置这个常量
eval $(ssh-agent)
expect << EOF
spawn ssh-add $1
expect "Enter passphrase"
send "$SSH_PRIVATE_KEY_PASS\r"
expect eof
EOF
CocoaPods/Specs
CocoaPods安装和使用教程
How to Create a CocoaPod in Swift