美文网首页
cocoapods创建远程私有库及相关踩坑

cocoapods创建远程私有库及相关踩坑

作者: 猿逗比 | 来源:发表于2019-11-22 16:23 被阅读0次

      最近因为项目需求变多且很多工具会在不同的项目中重复使用,因此需要把常用的工具或者封装的库进行剥离;于是就想要像其他的三方库一样使用cocoapods的方式进行管理。接下来就让我们一步步来实现它吧!
      以下的 Repository 为项目库的待位名称,操作的时候更换成自己的库名即可。

    一.在GitHub上创建\color{red}{项目索引私有库}

    新建库
    填写库信息

    二.创建本地私有库索引文件,并与远程私有索引库进行关联

     1.如何查看本地索引库:
      使用如下命令查看本地已经存在的索引:

    pod repo  
    
    查看索引
      正常情况下只会有一个 master 我涂鸦掉的就是自己添加的本地索引库。
     2.添加一个自己的索引并与远程库进行关联
      执行如下命令行为自己增加一个本地索引并关联到远程库
    pod repo add RepositorySpec [GitHub上创建的索引库地址](https://xxx.git/)
    

      这一步完成后再使用 pod repo 命令即可看到自己创建的本地索引了。

    三.创建\color{red}{项目私有库}

     在GitHub上创建一个项目私有库,运来存放真正需要pod安装的代码;创建步骤同第一步(命名去掉Spec即可)。
    注意:\color{red}{这个库是真正的代码库,第一步创建的是索引库,是为项目库做索引的}

    四.创建模板工程,并推送到远程代码库

     1.创建模板工程:
      新建一个项目存放文件夹并在终端cd到文件夹目录下:
      使用如下命令创建新的模板工程:

    pod lib create Repository(库名)
    

      执行命令后会出现以下界面,如下图:


    新建工程模板

     2.替换代码文件
      生成工程后Xcode 会自动将其打开,然后我们需要找到 ReplaceMe.m 文件,并将其在Finder中打开,然后将自己的代码放到这个位置,删除 ReplaceMe.m 文件,完成代码的替换。

    更换自己的库代码
    文件替换
     3.安装替换的代码文件
      在终端cd到项目的Example目录下,执行 pod install 工程会自动将你刚才替换的文件代码更新到pod文件夹相应的位置下,如下图:
    更新pod代码
    pod执行后的效果
     4.修改podspec文件配置
      打开工程中的Repository.podspec文件,对其中的内容进行修改;
     5.验证仓库并推送模板工程到远程仓库
      使用终端cd 到项目的根目录,执行如下命令验证:
    pod lib lint
    pod lib lint --allow-warnings (warning 验证不通过时使用此命令)
    
    验证podspec

      使用git命令提交到远程仓库;(用SourceTree管理的直接使用SourceTree进行操作,主要目的是把项目推送到远端仓库,采用什么方式都可)

    git status 
    git add .
    git commit -m'注释'
    git remote add origin https://xxx/Repository.git 
    (将本地库与远程代码仓库进行关联)
    git push origin master  (提交到远程仓库)
    

    五.设置Tag并推送到远程管理库

     1.使用如下命令打tag并推送:

    git tag '0.1.0'
    git push --tags
    
    推送tag

     2.使用如下命令进行验证:(这一步不做的话在push的时候也会进行验证)

    pod spec lint --allow-warnings (验证远程)
    

     3.将本地的私有索引库推送到远端库

    pod repo push RepositorySpec Repository.podspec --allow-warnings
    

      成功后就可以在你GitHub的Tags中找到发布的版,如图:


    成功推送的私有库版本tag

    六.私有库的使用

    划重点:打开podfile文件,在顶部source 添加一个索引\color{red}{GitHub上的私有索引库地址} 注意是\color{red}{索引库地址}不是库的地址,如图:

    podfile添加索引库源地址
      添加完索引源地址之后再加上pod命令:
    pod 'Repository'
    

      至此终端执行pod install即可安装使用。完美!

    几个注意点及问题:

    • 创建私有库的时候,建议不要选择使用 README 创建,因为创建模板项目的时候会自动创建一个 README 文件,在提交的时候会产生冲突,一般会使用模板里的。
    • 当遇到如下错误时,一般是你的文件路径不对,验证会不通过;这里是路径是和Repository.podspec文件同级去取的。
     [iOS] file patterns: The `source_files` pattern did not match any file.
    
    • 验证时可能会遇到各种问题通过不了,我也是走过了不少坑,如果有遇到问题的可以给我留言,助你渡劫。

    • 使用码云创建私有库的需要把podspec文件中的源地址更换一下,如下图:


      更换源地址
    • 当你的私有库需要依赖于另一个私有库的时候验证会报错,需要在验证的时候指定所有的索引源地址,比如我项目中当前引用了GitHub中的AFN以及自己的私有库,就需要在source中指定索引库来源,如下(多个索引库来源采取 “,”来分隔开):

    pod lib lint --sources= [cocoapods地址](https://github.com/CocoaPods/Specs.git),[自己的私有库索引地址](https://xxxSpec.git) --allow-warnings
    
    • 当你的私有库中包含静态库时,需要采用如下命令(当然这些,命令是可以组合使用的):
     pod lib lint --use-libraries
    
    • 引入的三方库里面含有framework的时候 pod install 会报错,如下图:
    framework问题

    此时可以在podfile中加入如下代码解决(此问题也可采取将 use_frameworks!注释掉解决,前提是不需要 use_frameworks!):

    pre_install do |installer| Pod::Installer::Xcode::TargetValidator.send(:define_method, :verify_no_static_framework_transitive_dependencies) {}
    
    • 在私有库中使用到其他三方库的时候导入的头文件在.h中会报错找不到,需要放到.m文件中才行;

    暂且更新至此,后续有新的内容会继续补充。

    参考内容:

    相关文章

      网友评论

          本文标题:cocoapods创建远程私有库及相关踩坑

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