创建一个Git项目
项目内容
- 项目文件
- YourProjectName.podspec文件(CocoaPods配置文件)
文件创建:使用终端命令
pod spec create [YourProjectName|ProjectUrl]
例:
pod spec create YourProjectName|https://git.coding.net/User/YourProject.git
创建podspec文件,使用命令
chmod +x YourProjectName.podspec
将文件转换成 Unix executable 文件
文件内容:
Pod::Spec.new do |s|
s.name = 'YourProjectName'
s.version = '1.0.0'
s.license = 'MIT'
s.summary = 'Project Summary'
s.homepage = 'https://www.baidu.com'
s.social_media_url = 'https://www.baidu.com'
s.authors = { 'YourName' => 'yourname@qq.com' }
s.source = { :git => 'https://git.coding.net/User/YourProject.git', :tag => s.version }
s.ios.deployment_target = '9.0'
# 指定你的三方文件(使用通配符,建议拿其他三方库的文件进行修改)
s.source_files = 'YourProject/*.swift'
s.dependency 'AFNetworking', '~> 2.3' #依赖关系,该项目所依赖的其他库,如果有多个需要填写多个s.dependency
end
该文件中 s.version
指定的版本号需要在Git上添加tag标记,该标记是给版本指定项目分支(如果没有添加或者格式错误,上传和获取的时候会产生branch错误)
- .swift-version文件(项目Swift版本说明文件,CocoaPods默认Swift版本是3.0)
文件内容:Swift版本号。例:
3.1
- LICENSE文件(该文件是版权说明文件,不提供该文件CocoaPods不会帮你自动配置项目)
文件创建:使用终端命令
vim LICENSE
创建文本文件(文件名:LICENSE),使用命令
chmod +x LICENSE
将文件转换成 Unix executable 文件
文件内容:授权说明。例:
Copyright © 2017年 YourName. All rights reserved.
other info...
私有三方库
当创建了一个Git项目后,就有了一个私有的三方库,可直接在Podfile文件中添加代码
pod 'YourProjectName', :git => ' https://git.coding.net/User/YourProject.git'
然后
pod install
或
pod update
公有三方库
Trunk
以上的方法,使用
pod search
是搜不到你的库的,因为这只是你私有的库而已。在你本地,前往~/.cocoapods/repos/master/Specs,你会看到CocoaPods所有公有的开源库配置,这个通过cocoapod官方在github的specs来管理,地址为https://github.com/CocoaPods/Specs 。说到这里,你会想把这个库fork分支下来,clone到你本地,把自己的YourProjectName.podspec加入,然后add、commit、 push,最后在github上pull request来和官方的主分支合并,可是你会发现请求马上被自动关闭。WHY!!!!!! 虽然一开始使用GitHub Pull Requests来整理所有公共pods效果很好。但是,随着Pod数量的增加,这个工作对于spec维护人员Keith Smiley来说变得十分繁杂。甚至一些没有通过$ pod lint的spec也被提交上来,造成repo无法build。 CocoaPods 0.33中加入了Trunk服务。CocoaPods Trunk服务的引入,解决了很多类似的问题。CocoaPods作为一个集中式的服务,使得分析和统计平台数据变得十分方便。下面来说说怎么分布CocoaPod。
使用Trunk服务
- 注册电脑
使用podspec文件中的邮箱和用户名进行注册
pod trunk register youremail@qq.com 'yourname'
成功后你会收到一份邮件,需要点击验证。
可以使用 pod trunk me
查看自己的注册信息
可以使用
pod trunk add-owner otheremail@qq.com
添加其他维护者提交podspec文件
pod trunk push YourProjectName.podspec
在提交之前你可以使用 pod spec lint YourProjectName.podspec
验证你本地的podspec文件(是否有错误)
如果验证成功的话会显示
YourProjectName.podspec passed validation.
但你收到类似消息,如:
[!] /usr/bin/git clone https://github.com/User/YourProject.git /var/folders/z2/h6c1f1hj72b6p5y3dhgjd27c0000gn/T/d20150827-4039-1ujw0u9 --single-branch --depth 1 --branch v1.0.0Cloning into '/var/folders/z2/h6c1f1hj72b6p5y3dhgjd27c0000gn/T/d20150827-4039-1ujw0u9'...
warning: Could not find remote branch v1.0.0 to clone.
fatal: Remote branch v1.0.0 not found in upstream originUnexpected end of command stream
这是因为Git项目没有给分支添加tag标记或者tag标记格式错误
如果错误提示是 branch v1.0.0
,格式就是v+版本号
如果错误提示是 branch 1.0.0
,格式就是版本号
等待部署成功。
上面的代码做了三件事: *验证你的podspec文件是否合法。在trunk方式之前我们一般用“pod spec lint”命令进行验证。 *上传podspec文件到trunk服务器(其实最终也会自动添加到https://github.com/CocoaPods/Specs中,只是使用trunk方式省去了以前先fork在pull request的繁琐操作) *将你上传的podspec文件转成json格式文件
执行上面的push操作,就相当于你把你的源代码提交给CocoaPods团队审核了,一般需要一到两个工作日可以审核结束。这种心情有点像提交App给Apple审核,哈哈。
其实在这里就可以使用 pod 'YourProjectName'
来安装自己的CocoaPods依赖库,只是不能 pod search
到而已
查看我们自己创建的pods依赖库 如果收到了cocoapods官方发过来的审核通过邮件后,你很急着用pod search命名肯定会失望,没收到,还记得我们本地的~/.cocoapods/repos/master/Specs吗,还没跟官方的github上的Specs同步, 执行一次
pod setup
或者
pod update
来更新本地缓存的Spec库,再去search就能看到了
就能够用
pod 'YourProjectName', '~> 1.0.0'
这样去安装自己pod依赖库了 而.podspec文件也可以作为管理内部代码的利器
pod 'Z', :path => 'path/to/directory/with/podspec'
这里不要使用 pod install
,这行命令不会更新本地的三方库列表
参考: http://m.blog.csdn.net/bluefish89/article/details/48030941