美文网首页
【cocoapods】基础 私有库 : 创建、使用、更新、集成第

【cocoapods】基础 私有库 : 创建、使用、更新、集成第

作者: Gaizka | 来源:发表于2019-11-03 16:30 被阅读0次

    cocoapods 私有库 : 创建、使用、更新 ; 技术有先后,一起学习 !

    一、 制作私有库

    创建自己的私有库仓库

    a: 找一个可以存放仓库索引的库 ,一般可以用github、gitlab、码云等,我用的是github,创建过程不赘述,假如我创建的私有库名字是 mySpecPod 地址https://github.com/name/mySpecRepo.git ,注意尽量是空的空,先不要存放其他东西;

    b: 创建自己的私有库

    pod repo add mySpecPod https://github.com/name/mySpecRepo.git
    以上的指令是 创建一个仓库 名字是 mySpecPod 地址: https://github.com/name/mySpecRepo.git 执行完后 在 ~/.cocoapods/repos 目录下会存在我们的私有库分支 mySpecPod ,master是cocoapods 默认的分支;

    c: 创建一个存在代码的仓库,这里我还是选择是 github ,注意之前我以为这个仓库a步骤的仓库是同一个,走了弯路,实际a是存在仓库索引的库,本步骤才是存在我们代码的位置,

    成功后clone到本地,假如我的仓库地址是:https://github.com/name/myTestPodProject.git

    d: 将自己的代码提交到 https://github.com/name/myTestPodProject.git , 并打tag,这一步主要是打tag,在下一步的 .specpod 文件中 version的值就是根据你的tag去索引的;

    git tag 1.0.0 ; git push --tags ;

    e: 制作索引文件,进入我们clone 的项目的根目录,执行以下的指令

    pod spec create SpecPodSDK
    执行完成后在项目根目录会生成 SpecPodSDK.podspec 文件,关于这个文件非常重要,最终cocoapods 将根据它的配置来将私有库的内容加载到宿主工程: 以下给出相关的解释,可能刚创建成功会有很多英文的注释,下面的是我自己注释的:

    Pod::Spec.new do |spec|
    
    # �����私有库名字
      spec.name         = "SpecPodSDK"
    
    # �����版本号,要跟链接代码库的最新的tag 一致;
      spec.version      = "1.0.0"
    
    # 搜索关键字 ����
      spec.summary      = "SpecPodSDK"
    
    # �����pod私有库描述
      spec.description  = "SpecPodSDK�xxx@gmail.com"
    
    # 代码仓库主页
      spec.homepage     = "https://github.com/name/myTestPodProject"
    
    # LICENSE
      spec.license      = "MIT"
    
    # ��作者信息
      spec.author       = { "xxxx" => "xxx@gmail.com" }
    
    # ��平台部署:iOS ���� ������
      spec.platform              = :ios
      spec.ios.deployment_target = '9.0'
    
    # 仓库引用����
      spec.source        = { :git => "https://github.com/name/myTestPodProject.git", :tag => "#{spec.version}" }
    
    # �引用的源代码文件,非常重要,里面的路径要相对的.specpod文件定位
      spec.source_files  = "SpecPodSDK/libs/*.{h,m}"
    
    # 设置自动引用计数
      spec.requires_arc = true
    
    # 引用的系统Frameworks库
    # spec.framework = "UIKit"
    spec.framework = "Foundation"
    
    # 引用的自定义Frameworks库
     spec.vendored_frameworks = "/xxx/xxx.framework"
    
    # 依赖的系统lib库,假如你有依赖libsqlite3.tdb 库,可以省略lib前缀,.tdb 后缀
      spec.libraries = 'sqlite3'
    
    # �依赖自定义lib库,假如你有依赖的自定义的.a文件
      # spec.vendored_libraries = 'SpecPodSDK/libs/libRobotPenSDK.a'
    
    end
    
    

    为了更好的集成使用,这里还是总结下所有的吧

    name:框架名
    version:当前版本(注意,是当前版本,假如你后续更新了新版本,需要修改此处)
    summary:简要描述,在pod search ZCPKit的时候会显示该信息 ,每一个版本的主要功能。
    description:详细描述
    homepage:代码私有库的https地址
    license:开源协议 MIT 不用修改啦
    author:作者
    source:源码git地址
    platform:支持最低ios版本
    source_files:源文件(可以包含.h和.m)
    public_header_files:头文件(.h文件)
    resources:资源文件(配置的文件都会被放到mainBundle中)
    resource_bundles:资源文件(配置的文件会放到你自己指定的bundle中)
    frameworks:依赖的系统框架
    vendored_frameworks:依赖的非系统框架
    libraries:依赖的系统库
    vendored_libraries:依赖的非系统的静态库
    dependency:依赖的三方库
    

    以上知识冰山一角的配置,关于多个库的依赖其实最难的,举一反三,这里制作入门介绍,有兴趣自己探究;

    e: 检验.specpod 文件是否合理

    pod lib lint --allow-warnings --verbose
    --verbose: 可以查看具体的日志 ;
    --allow-warnings : 允许有日志 ;
    还有很多相关配置 ,
    如果输出: 代表成功

    TALRobotPencilSDK passed validation.
    

    常见的失败: a 、代码仓库地址不正确 b、 source_file 目录不对 c、指定的部署iOS版本,这个在你pod install 如果跟你项目的ios 不兼容就会报错 等等

    f : 将私有库代码代码推到远程私有索引库

    pod repo push mySpecPod SpecPodSDK.podspec--allow-warnings
    a、mySpecPod 是我们在b创建的自己的私有索引库 b、SpecPodSDK.specpod 配置的对外使用的代码仓库的索引信息 ;
    常见的错误是 mySpecPod库可能初始化错误,在执行此命令之前保证有一个初始化文件存在,比如readme文件;

    h: 验证我们的私有库

    pod search SpecPodSDK
    如果找不到根据具体的报错信息寻找解决方法;

    i: install 私有库

    a、 配置podfile 文件

    # 非常关键: 这是我们私有库索引的仓库地址
    source 'https://github.com/name/mySpecRepo.git'
    
    # 1. 注意一定要把注释打开 2. 和自由库的部署版本一定要兼容
     platform :ios, '9.0'
    
    target 'myTestPodProject' do
      # Comment the next line if you don't want to use dynamic frameworks
      use_frameworks!
      inhibit_all_warnings!
    
    
      # Pods for TALRobotPencil-YHZZ
      pod 'SpecPodSDK', '~> 1.0.0'
    
    end
    
    
    

    这里最关键可能忘记添加私有库索引仓库的地址,我就是

    到此制作私有库的步骤就完啦

    更新私有库

    a: 在代码仓库里将私改的内容提交

    b: 制作tag 1.1.0

    git tag 1.1.0 ; git push --tags

    c: 修改本地specpod文件 ,注意非常关键 除了配置你修改的部分(添加新的文件、库、info 配置) 最重要是设置version 要跟b步骤tag 一致

    d: 验证 pod lib

    pod lib lint --allow-warnings --verbose
    除了错误,十有八九是source 、库、tag 、.a文件 不对 ,根据提示修改即可

    e: 将 specpod 推到自己的私有库

    pod repo push mySpecPod SpecPodSDK.specpod --allow-warnings

    f: e步骤完毕,你会发现在 ~/.cocoapods/repos/mySpecPod/SpecPodSDK 会有你打tag的文件夹 ,里面就是该版本的索引信息

    后面的验证跟制作私有库的验证步骤一致: h步骤 到最后一步 。。。。

    三、集成第三方库

    正确的写法:

    #dependency 跟其他的关键字还是有区别,我就是遇到这个坑,在dependency后面加上一个 = 号,导致总是失败,还有就是 dependency 没有 dependencies 字段 只有一个一个加
    spec.dependency 'SDWebImage', '~> 5.0.6'
    spec.dependency 'Masonry', '~> 1.1.0'
    

    其他检测步骤和上传步骤跟之前一样

    相关文章

      网友评论

          本文标题:【cocoapods】基础 私有库 : 创建、使用、更新、集成第

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