美文网首页iOS开发技术分享iOS学习iOS开发
CocoaPods创建管理类库的步骤

CocoaPods创建管理类库的步骤

作者: LZF_home | 来源:发表于2017-07-14 17:44 被阅读42次
    用到的命令
    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文件

    私库.png
    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

    相关文章

      网友评论

        本文标题:CocoaPods创建管理类库的步骤

        本文链接:https://www.haomeiwen.com/subject/eshnhxtx.html