用到的命令
1. git clone 'https://github.com/jackLeong/MySDK.git' //克隆一份远程仓库
2. git add fileName //把文件纳入git的缓存区,可使用 * 代替目录下的所有文件
3. git status -s //查看文件修改状态
4. git commit -m 提交信息 //提交缓存区的内容和文件到本地仓库
5. git push //将本地分支仓库推送到与之有追踪关系的远程分支
6. pod repo add REPO_NAME REPO_URL //在CocoaPods目录在创建.podspec仓库
7. pod repo push REPO_NAME xxx.podspec //将.podspec文件推送到仓库
8. pod repo remove REPO_NAME //删除指定仓库
9. pod update --no-repo-update //更新Podfile的指定的依赖
10. git tag xxx //为最近提交打标签,xxx一般标签为版本号
11. git push origin --tags //推送标签
一 CocoaPod管理远程git仓库
在github上创建一个仓库,这个仓库存放类库文件和.podsepc文件并使用pod工具引用这个类库。在公司开发项目,一般会把类库源文件放在公司的SVN或git服务器上面。为了模拟pod管理类库就选择使用github,步骤如下
1.在github上新建一个新的源代码仓库MySDK
2.在Desktop
文件夹下创建一个Framework工程:MySDK
3.在MySDK中新建一些类用于测试
4.从github上克隆这个新的仓库到Desktop/temp
进入到Deskstop/temp/目录,终端输入:
git clone https://github.com/jackLeong/MySDK
5.将Framework工程MySKD下的所有文件copy到克隆的仓库MySKD
在终端,进入Deskstop目录下,输入cp -r MySDK/* temp/MySDK/
,以后添加文件,文件修改可以在这个仓库工程里做
6.将copy的文件添加到git缓存区
进入到仓库MySDK目录 ,终端输入命令:
cd temp/MySDK/
git add *
再查看文件状态:
git status -s
,在终端输出可以看到新添加的文件
7.将缓存区的修改文件提交到本地分支
在终端输入:git commit -m 提交SDK文件
8.为刚才的提交,打个标签,可以标志它的版本号,标签默认与最近commit绑定
在终端输入:git tag 1.0.0
9.把本地分支推送到远程分支
在终端输入:git push
10.把本地标签也推上去
在终端输入:git push origin --tags
11.创建podspec文件,.podspec它是类库的描述文件,说明了类库的版本信息,简介以及指定了pod工具拾取文件的规则等。.podspec的名称要和你的项目名称一样,如你的项目名为xxx,那么.podspec则名为xxx,不要写.podspec后缀,进入到MySDK目录下
在终端输入:```pod spec create MySDK```
12. 关键的一步,正确填写.podspec文件的内容,其中以#开头的是被注释掉的语句,我们要根据自己情况来填未注的内容或补充填写被注掉的内容。
Pod::Spec.new do |s|
s.name = "MySDK" //.podspec文件名称
s.version = "0.0.1" //指定.podspec文件的版本号,必须要与仓库的版本号一致
s.summary = "A short description of MySDK.podspec,that is it" //摘简信息
s.description = <<-DESC //开始标志
Just test,so what I can say Nothing,Nothing,Nothing,Nothing,Nothing,Nothing,Nothing,Nothing,
DESC //结束标志
s.homepage = "https://github.com/jackLeong/MySDK"//主页地址,可以你的博客,简书或github地址,反正是一个可正确访问的网页地址
s.license = {:type=>"MIT", :file=>"LICENSE"} //类库的许可,其它人对你的类库拥有MIT所指定的权利
s.author = { "xxxx" => "119999900@qq.com" }//作者名称,邮箱
# ――― Platform Specifics 指定类库适用平台―――――――――――――――――――――――
//如果这个pod库只运行在iOS或者OS X,就指定platform和发布的平台版本号
s.platform = :ios, "8.0" //平台iOS, 适用8.0+
# ――― Source Location 资源定位 ―――――――――――――――――――――――――――――――――――――――――――――――――――――――――― #
# 指定可寻找并检索类库资源的位置,支持 git,svn,http
//这个非常关键,要根据情况(是svn还是git)来填,:tag 标签要与s.version所指定的一样。记得给git仓库打标签
s.source = { :git => "https://github.com/jackLeong/MySDK.git", :tag =>s.version }
# ――― 代码源文件 ――――――――――――― #
# CocoaPods具有很智能的代码源文件拾取功能。
//这是它的示例,可以用","隔开指定多个路径Classes是文件夹名称
# s.source_files = "Classes", "Classes/**/*.{h,m}"
# s.exclude_files = "Classes/Exclude"
s.source_files = "MySDK/*.{h,m}"
# ――― Project Linking 链接所需要的库――――――――――――――――――― #
# s.framework = "SomeFramework"
# s.frameworks = "SomeFramework", "AnotherFramework"
13. 本地检验.podspec是否正确
在终端输入:pod lib lint
警告如下
-> MySDK (1.0.0)
- WARN | summary: The summary is not meaningful.
[!] MySDK did not pass validation, due to 1 warning (but you can use `--allow-warnings` to ignore it).
[!] The validator for Swift projects uses Swift 3.0 by default, if you are using a different version of swift you can use a `.swift-version` file to set the version for your Pod. For example to use Swift 2.3, run:
`echo "2.3" > .swift-version`.
You can use the `--no-clean` option to inspect any issue.
如果有警告,pod是认为.podspec是校验不通过的,可以加上参数--allow-warnings
重新校验,或者修改文件,kill掉warinnig
14.校验成功后,将MySDK.podspec推送到远程仓库
在终端执行以下命令:git add MySDK.podspec
, git commit -m 提交.podspec文件
,pod push
15.使用github上的MySDK类库,在工程的Podfile文件引入:
# Uncomment the next line to define a global platform for your project
platform :ios, '8.0'
target 'TestMyPod' do
# Uncomment the next line if you're using Swift or would like to use dynamic frameworks
# use_frameworks!
# Pods for TestMyPod
pod 'MySDK', :git=>'https://github.com/jackLeong/MySDK.git'
end
然后,更新一下pod:
在终端输入:pod update --no-repo-update
,如果首次安装pod,可以输入:pod install
二 创建并使用CocoaPods私有仓库
在工作中,公司的类库(或SDK)一般是不公开给其它人使用的,而公司内部开发员共同管理使用这个类库,可以像第一小节那样把类库和.podspec文件放到svn或git上,也可以在CocoaPods安装目录下(~/.cocoapods/)创建仓库来存放.podspec文件。
CocoaPods安装成功后,在用户目录下会有一个叫master的仓库,master里的Specs文件夹存放了所有第三方类库的.podspec文件,所以说master是一个公有仓库。我们可以创建私有仓库,来存放.podspec文件。
1.创建CocoaPods私有仓库
在github上或git服务器创建一个JL-Specs.git仓库(反正是一个空的git仓库):
然后把JL-Specs.git添加到CocoaPods下作为私有仓库,在终端输入:
pod repo add lzf-specs https://github.com/jackLeong/JL-Specs.git
之后,在.cocoapods/repos下出现一个JL-Specs.git的仓库,它就是我们的私有仓库。
2.将类库的.podspec文件放入私有仓库JL-Specs
将第一小节的MySDK.podspec放入私有仓库JL-Specs
在终端输入:
//注意:这步pod会同时把仓库新增的文件同步到远程分支的
pod repo push JL-Specs MySDK/MySDK.podspec
之后,在JL-Specs仓库存有类库MySDK的.podspec文件
3.使用私有仓库,在工程的Podfile文件写入:
platform :ios, '8.0'
target 'TestMyPod' do
# use_frameworks!
#私库要指定.podspec所在的仓库,如果既有公共库又有私库,还要加上
#source 'https://github.com/CocoaPods/Specs.git'
source 'https://github.com/jackLeong/JL-Specs.git'
pod 'MySDK', '~>1.0.0'
end
然后,更新一下pod:
在终端输入:pod update --no-repo-update
,如果首次安装pod,可以输入:pod install
三 在CocoaPods公开你的仓库
如果要像我们引用AFNetworking那样来让别人引用你的类库,需要把自己的库公开到CocoaPods仓库。
1.申请CocoaPods账号
在终端输入: pod trunk 邮箱 '用户名'
2.把.podspec推送到CocoaPods的Specs.git仓库
在终端输入: pod trunk push MySDK.podspec