CocoaPods创建私有仓库

关于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 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 or pod update一次。 //Todo

why

6. 提交自己的Pods

1. 创建自己的代码，完成测试。
2. 提交Pod到Spec之前，需要验证一下自己的代码是否正确。可以通过pod lib lint --verbose命令验证当前pod本地代码是否运行正常。
   
3. 测试通过以后，可以提交代码到remote端，并打上跟.podspec文件中，s.version 相同的tag号
4. 本地验证通过以后，就可以提交到远程仓库，然后打上对应于version版本号的tag,在通过pod spec lint --verbose进行测试，看.podspec文件中对应的代码是否运行通过。
5. 通过测试以后，通过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

1. 怎么在开发中调试程序
   开发过程中，可以修改Podfile文件的，将pod版本指向本地。
   
   对应pod的代码会被引入Development Pods中
   
2. 模块之间的命名问题，最好以模块为单位添加不同的前缀。
3. Pod之间的引用

#import "Masonry.h"
#import <Masonry/Masonry.h>

4. 添加pod的某个tag如0.0.1 到repo后，需要修改代码但又不想提升tag版本时，注意修改完后清理CocoaPods的本地缓存

rm -rf "${HOME}/Library/Caches/CocoaPods"
pod cache list/cache

5. 第三方库的修改，尽量fork再通过pod引用
6. 使用ssh协议
7. .gitignore
   有时候突然想要忽略某个文件，但是跟新.gitignore以后，remote端并没有马上删除这个文件，原因是ignore文件只能忽略没有加入版本管理的文件，已经被纳入了版本管理的文件是无效的。

git rm -r --cached .
git add .
git commit -m 'update .gitignore'

8. 解决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

9. CIssh问题

#解决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