您的当前位置:首页正文

CocoaPods创建管理类库的步骤

来源:华拓网
用到的命令
1.  git clone  //克隆一份远程仓库
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
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     = 
  s.license      = {:type=>"MIT", :file=>"LICENSE"} //类库的许可,其它人对你的类库拥有MIT所指定的权利
  
   
  s.author             = { "xxxx" =>  }//作者名称,邮箱
  
  # ――― 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 =>  :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',  

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 

之后,在.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文件

私库.png
3.使用私有仓库,在工程的Podfile文件写入:
    platform :ios, '8.0'

    target 'TestMyPod' do
    
  # use_frameworks!
  #私库要指定.podspec所在的仓库,如果既有公共库又有私库,还要加上
  #source 
    source 
    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