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'
其他检测步骤和上传步骤跟之前一样