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

2019-11-03  本文已影响0人  Gaizka

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'

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

上一篇下一篇

猜你喜欢

热点阅读