美文网首页
iOS 私有库创建

iOS 私有库创建

作者: zl_xust | 来源:发表于2018-09-10 15:31 被阅读45次

    私有库的是随着公司在多个项目开展的时候,把一些常用的工具类制作成pod,方便在多个项目中使用,避免了来回拖入代码造成的时间浪费。iOS组件化实现基本基于cocoapods,如何使用cocoapods创建自己的组件库,是实现组件化的第一要素。

    创建一个远程私有库,需要一个私有库,需要一个索引库:

    私有库:用于真正存放组件代码

    索引库:存放spec文件,用于所引导代码的位置

    索引库和私有库的关系可以简单理解就像指针和对象关系,指针就是索引库,对象就是私有库

    以码云“gitee”为例:

    一、创建私有库的索引库——一般的命名方式以Repo或者Spec (如XXPrivateSpec)

    1、首先在终端命令行 pod repo 查看本地索引库,可以查看只有一个Master索引库,默认情况下是只有一个master仓库,我们常用的SDWebImage,AFNetWoking等的本地索引就在这个仓库中。

    master

    - Type: git (master)

    - URL: https://github.com/CocoaPods/Specs.git

        2、添加一个自己的索引库 首先在gitee上创建一个新的项目命名XXPrivateSpec

        3、添加自己的本地远程索引库 后面的地址就是远端工程的“克隆/下载"地址

    pod repo addXXPrivateSpec https://gitee.com/XXX/XXPrivateSpec.git

    4、可以Command+shif+G 到$ ~/.cocoapods/repos 下查看自己的本地仓库路径,添加完以后可以通过pod repo命令查看,本地会多一个你刚才添加的镜像库,如果想要移除刚才添加的镜像库,执行pod repo --remove XXXPrivateSpec命令就可以了。

      5、说明:该仓库下只放各组件索引文件,不存放组件代码(组件代码需要重新创建组件工程)

    二、创建自己的组件库工程(本地和远端的仓库podspec)

        1、码云托管平台上,在Gitee上创建一存放基础组件的工程XXXComponent(工程创建和上一步类似)

    2、快速创建一个模板工程用于编辑自己的基础组件

    cd /Users/XXX/Desktop/PrivateLib

          终端命令输入:

          pod lib create 组件库名 

          接下来会输入一系列的东西,根据提示输入,账户密码等的如下图:

    3、以上信息完成以后,Xcode会自动打开创建好的模板工程,在这里可以把自己编的本地组件文件替换工程中的Replace.m文件

        4、终端 cd 命令行 切换到Example文件路径下,执行pod install命令    

    出现pod installation complete!那么本地私有库就完成,工程中就能看到导入的组件库文件,然后可以编辑修改组件库

    5、最后就是将本地的组件库地址提交到远端组件库工程XXXComponent上(注意此处不是索引库,切莫弄混淆了)

            5.1 切换到本地组件库工程目录下,执行下面三条命令(这里就将模板文件上传到了远端)

    cd /Users/XXX/Desktop/PrivateLib/FoundationExtention/XXXComponent

    git remote add origin https://gitee.com/XXX/XXXComponent.git

                git push -u origin master

    5.1 修改模板工程中的podspec文件, 打开Xcode工程,找到.podspec

    s.version  版本号初次使用不需要修改

    s.summary  一段简介描述(可以修改为自己想要的)

    s.homepage = '工程主页地址'

    s.source   = '项目仓库地址,不是索引库地址'

     5.2 修改完这些主要信息之后,可以用 pod lib lint --allow-warnings校验本地podspec文件是否正确,如有error则需要逐条修改

            5.3 保存本地仓库代码修改,打上tag标签,推送到远程仓库,使用如下命令行

                git add .

    git commit  -m  '初始化'      (-m 后面是对本次提交信息的描述)

    git push -u origin master

    5.4 校验远端podspec文件是否正确,终端输入 pod spec lint --allow-warnings

     当输出XXXComponent.podspec passed validation. 说明远端校验通过

    如果出现了警告,可以尝试将s.homepage的文件地址删掉一级尝试

    5.5 给版本打一个标签

    git tag 0.1.0

                git push --tags 

                小结:

                               1)打分支这一步很重要,直接决定下面的步骤是否能够继续,当我们有版本更新的时候就要更改版本号

                               2)这里默认是0.1.0,一定要与之前我们在Xcode中看到的s.version号一致!

    5.6 最后一步建立关联,将podspec文件关联到远端私有索引库XXXPrivateSpec.pod repo push XXPrivateSpec  XXXComponent.podspec--allow-warnings

    注意:注意:提交后,依然会验证 podspec文件,验证通过后 会自动上传到在远程spec索引库。通过这一步我们就同步好了远程和本地索引库

    5.7修改基础工程进行版本迭代,本质上修改XXXComponent项目。并且修改是修改podspec文件tag(s.version),打标签。并切将podspec文件推送到远端私有索引库。即重复5.3~5.5 把文件修改推送到远端。

    最后还要进行组件库与远端索引库的关联:

    即:pod repo push XXPrivateSpec  XXXComponent.podspec--allow-warnings

    三、创建新工程,使用自己的私有库

    cd 到新工程目录

            pod init    这里需要

      当我们在使用自己创建的私有库时,Podfile文件,要引用我们之前第一步创建的索引仓库地址,也就是指针仓库地址

    下面是Podfile

    source 'https://github.com/CocoaPods/Specs.git'

    source 'https://gitee.com/XXX/XXPrivateSpec.git'

    # Uncomment the next line to define a global platform for your project

    # platform :ios, '9.0'

    target 'TestP1' do

     # Uncomment the next line if you're using Swift or would like to use dynamic frameworks

     use_frameworks!

     pod 'XXXComponent', '~> 0.1.0'

    end

    然后 pod install 就可以了

    相关文章

      网友评论

          本文标题:iOS 私有库创建

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