主页 cocoapods私有库
Post
Cancel

cocoapods私有库

　由 SeongBrave 发布于 2018-08-03 2018-08-03T00:00:00+00:00

1. 添加私有仓储

1

pod repo add CYSpecs https://git.coding.net/SeongBrave/CYSpecs.git

2.模块开发

1. 模块初始化

1

 pod lib create UtilCore

这个错误是因为依赖库（s.dependency）包含了.a 静态库造成的。虽然这并不影响 Pod 的使用，但是验证是无法通过的。可以通过 –use-libraries 来让验证通过。

1

pod spec lint UtilCore.podspec --verbose --use-libraries

这种情况下使用 –use-libraries 虽然不会出现错误（error），但是有时候会带来一些警告（waring），警告同样是无法通过验证的。这时可以用 –allow-warnings 来允许警告。

1

pod spec lint UtilCore.podspec --verbose --use-libraries --allow-warnings

1.1 只创建一个 podspecs

1

pod spec create UtilCore_Lib.podspec

2. 模块验证

  • 本地模块验证
1

 pod lib lint --allow-warnings --sources='https://git.coding.net/SeongBrave/CYSpecs.git,https://github.com/CocoaPods/Specs'
  • 确定没问题了可以先打 tag 验证:
1

pod spec lint --sources='https://git.coding.net/SeongBrave/CYSpecs.git,https://github.com/CocoaPods/Specs'

3. 提交模块到私有仓储

1

pod repo push CYSpecs UtilCore.podspec --sources='https://git.coding.net/SeongBrave/CYSpecs.git,https://github.com/CocoaPods/Specs'

3.1 或者提交到公共仓储

3.1.1 首先需要注册

1

pod trunk register seongbrave@sina.com

3.1.2 提交注册到公共仓储

1

pod trunk push UtilCore_Lib.podspec --allow-warnings

3. 打包成 Framework 或者 Library

可以使用 pod package 命令打包成 Framework 或者 Library ，默认是头文件都会打包，如果需要指定公开的头文件可以在 UtilCore.podspec文件中配置s.public_header_files

1. 默认打包成 Framework

1

pod package UtilCore.podspec  --force

2. 加上--library即可打包成.a 文件

1

pod package UtilCore.podspec  --force --library

3. 指定私有仓储

如果项目中使用了私有库，需要指定对应的私有仓储,需要加上 --spec-sources指定私有仓储

1

 pod package UtilCore.podspec  --force  --spec-sources=https://git.coding.net/SeongBrave/CYSpecs.git,https://github.com/CocoaPods/Specs.git

3.1.私有仓储依赖 Framework

在UtilCore.podspec文件中添加一下类似代码即可依赖 Framework

1
2

  s.vendored_frameworks = ['UtilCore/vendored_frameworks/UtilCore.framework']
  spec.resource_bundles = {'Resources' => 'UtilCore/vendored_frameworks/UtilCore.framework/Resources/UtilCore.bundle'}

4. 打包完后使用注意

1. 提供给外部人员使用 Framework

可以将打包成的 Framework 放大JBox上(理论应该可以，但是我测试了貌似不行不过我将 Framework 压缩然后放到骑牛上就完全没有问题),以下以设备指纹项目UtilCore为例说明:

  • 第一步取得上面生成打包好的 UtilCore.Framework 将其放到桌面或者其它地方已经创建好的UtilCore文件夹中,文件夹中应该包含的内容包括

    • 最终要的 UtilCore.Framework 文件库
    • 一定要包含的 Doc 文件，帮助用户使用的
    • 还要包含的就是版本更新记录UtilCore_Sdk_ReleaseNotes
    • 当然最好再包含一份 Demo项目就完美了

    参照友盟的如:

  • 第二步 然后压缩文件夹 为UtilCore.zip包，并在直接上传到骑牛空间，最终得到一个地址:http://o82jar85w.bkt.clouddn.com/UtilCore.zip

  • 第三步 生成对应外部人员使用的UtilCore.podspec文件 UtilCore.podspec文件上传到提供静态服务的网站即可，我是在本地测试通过的

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

Pod::Spec.new do |s|
  s.name             = 'UtilCore'
  s.version          = '0.0.3'
  s.summary          = '京东金融基础工具库'

  s.description      = <<-DESC
TODO:包含以下简单的工具封装，JSON的解析等基础库.
                       DESC

  s.homepage         = 'http://jci.cbpmgt.com/repo/repoDetailShow/4316/git'
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
  s.author           = { 'seongbrave' => 'seongbrave@sina.com' }
  s.source              = { :http => "http://o82jar85w.bkt.clouddn.com/UtilCore.zip" }
  s.social_media_url = 'http://seongbrave.github.io/'
  s.vendored_frameworks = "*/UtilCore.framework"
  s.framework           = "CoreTelephony"
  s.xcconfig            = { "LIBRARY_SEARCH_PATHS" => "\"$(PODS_ROOT)/UtilCore/**\"" }
end
  • 第四步 具体 demo 的pofile文件中的使用
1

pod 'UtilCore', :podspec => "http://10.13.100.75:8887/UtilCore.podspec"

最后说下 上面的代码中的 s.name = 'UtilCore'这个 name 很关键 ，这块的 name 直接决定了使用的时候在 podfile文件中引用第三方项目的名称的

2. 私有库中包含了其它静态库或者私有的 Framework

如果私有库中包含了其它静态库或者私有 Framework，则要使用pod package 就会存在问题

参考资料,以下是解决办法

1. 第一步:打包命令添加参数 –no-mangle

这时候如果拿去运行，则会报错，因为我们依赖的静态库没有被打包到Framework中，这个文件是我们的静态库依赖的另一个静态库，需要你手动添加进项目，所以再把依赖的这个静态库 拖进项目就好了，运行成功

1

pod package CYSpecs.podspec  --force  --spec-sources=https://git.coding.net/SeongBrave/CYSpecs.git,https://github.com/CocoaPods/Specs.git --no-mangle

上面的命令中，有一个是–no-mangle，表示 Do not mangle symbols of depedendant Pods，当你的项目依赖包含 静态库时

2. 第二步:作为 cocoapods 的库输出Framework和其它静态库

其实也不需要这一步了，因为已经打包成了目标Framework了，告诉使用者直接使用即可，但是有两条原因:

  • 作为 cocoapods 库的形式提供，方便导入其它依赖项目，使用者无需手动导入

  • 如果想将该Framework作为其它模块使用的时候作为依赖

参照 libWeChatSDK 专门为静态库创建一个 仓储即可解决以上问题

1
2
3
4
5
6
7
8
9
10
11
12
13
14

#libWeChatSDK.podspec
Pod::Spec.new do |s|
s.name         = "libWeChatSDK(1.6.2)"
s.version      = "1.6.2"
s.summary      = "微信官方SDK 1.6.2版本."

s.homepage     = "https://open.weixin.qq.com/cgi-bin/index?t=home/index&lang=zh_CN"
s.license      = 'MIT'
s.platform     = :ios, "6.0"
s.ios.deployment_target = "6.0"
s.source       = { :git => "https://github.com/zfan67/libWeChatSDK.git", :tag => s.version}
s.source_files  = 'zfan67/libWeChatSDK/*.{h,m,a}'
s.requires_arc = true
end

3. 项目使用

podfile

首先导入私有仓储

1
2

source 'https://github.com/CocoaPods/Specs.git'  # 官方库
source 'https://git.coding.net/SeongBrave/CYSpecs.git'   # 私有库

然后引入私有库即可

1

pod 'UtilCore', '0.0.7'

如果处于开发阶段可以指定模块仓储地址并且指定分子

The Podfile

1

 pod 'UtilCore', :git => 'https://github.com/SeongBrave/UtilCore.git', :branch => 'dev'

4. 遇到的问题

1.当搜索不到私有库的时候可以尝试 :

1

rm ~/Library/Caches/CocoaPods/search_index.json

2. 可以不用打新标签更新库，具体操作为:

1
2
3

rm -rf "${HOME}/Library/Caches/CocoaPods"
rm -rf "`pwd`/Pods/"
pod update

3. 更新 pod 源

1

pod repo update

4. 如果需要 swif4 则需要在终端中执行

1

echo 4.0 > .swift-version

5. git 相关操作

1. 删除远程分支和 tag:

1

git push origin --delete tag  0.0.1

2. 删除本地分子:

1

git tag -d 0.0.1

3. 设置本地记录用户名和密码

1

git config --global credential.helper osxkeychain

5. cocoapods 插件

1. cocoapods-playground

可以在 playground 中方便测试第三方项目

1. 下载

1

sudo gem install cocoapods -n /usr/local/bin

2. 使用

1

pod playgrounds SnapKit

2. cocoapods-package

1. 头文件导入问题

参考资料

cocoapods 版本降级

参考资料

1. 移除 pod 组件

1

which pod

2.你可以手动移除这个组件 :

1

sudo rm -rf <path>

3. 查看 gems 中本地程序包

1

gem list --local | grep cocoapods

4. 最后指定版本全部删除

1

sudo gem uninstall cocoapods-packager -v 1.5.0

pod package 参数

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

//强制覆盖之前已经生成过的二进制库
--force

//生成静态.framework
--embedded

//生成静态.a
--library

//生成动态.framework
--dynamic

//动态.framework是需要签名的，所以只有生成动态库的时候需要这个BundleId
--bundle-identifier

//不包含依赖的符号表，生成动态库的时候不能包含这个命令，动态库一定需要包含依赖的符号表。
--exclude-deps

//表示生成的库是debug还是release，默认是release。--configuration=Debug
--configuration


--no-mangle
//表示不使用name mangling技术，pod package默认是使用这个技术的。我们能在用pod package生成二进制库的时候会看到终端有输出Mangling symbols和Building mangled framework。表示使用了这个技术。
//如果你的pod库没有其他依赖的话，那么不使用这个命令也不会报错。但是如果有其他依赖，不使用--no-mangle这个命令的话，那么你在工程里使用生成的二进制库的时候就会报错：Undefined symbols for architecture x86_64。

--subspecs

//如果你的pod库有subspec，那么加上这个命名表示只给某个或几个subspec生成二进制库，--subspecs=subspec1,subspec2。生成的库的名字就是你podspec的名字，如果你想生成的库的名字跟subspec的名字一样，那么就需要修改podspec的名字。
这个脚本就是批量生成subspec的二进制库，每一个subspec的库名就是podspecName+subspecName。

--spec-sources

//一些依赖的source，如果你有依赖是来自于私有库的，那就需要加上那个私有库的source，默认是cocoapods的Specs仓库。--spec-sources=private,https://github.com/CocoaPods/Specs.git。

个人理解

表示不使用 name mangling 技术，pod package默认是使用这个技术的。我们能在用 pod package 生成二进制库的时候会看到终端有输出 Mangling symbols 和 Building mangled framework。表示使用了这个技术。

如果你的 pod 库没有其他依赖的话，那么不使用这个命令也不会报错。但是如果有其他依赖，不使用--no-mangle 这个命令的话，那么你在工程里使用生成的二进制库的时候就会报错：Undefined symbols for architecture x86_64。

1. –no-mangle

  • 如果模块中包含了静态库则打包的时候必须添加改参数,否则编译不通过,报错:!] podspec has binary-only depedencies, mangling not possible.
  • 但是如果增加了改参数打包,则打包出来的 Framework 集成到主项目有可能会与之前的同名文件报冲突
  • 从上面的一条说明不加参数--no-mangle编译的时候统一增加了前缀,加上--no-managle就不会添加参数了
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

我试了一下, 按楼主提供的方式打包是没有问题的.
上面出现的问题主要是两个,
1) 头文件找不到.
cocoapods packager 也没有对头文件做改动, 就是单纯地做拷贝. 所以自己拷贝一个头文件到需要集成静态库的工程里去就行了. 静态库对外暴露的头文件一般也不多, 也就一两个, 而且每次头文件也基本不会变, ,所以也不算太大问题.

2) 出现 Undefined symbols for architecture, 也就是符号找不到.
因为打成的包还是一个静态库,不可能把系统的动态库也给打进去. 所以使用这个静态库的工程还是要手动去链接动态库, 包括这个静态库依赖的第三方库所要用到的动态库.

按这个例子就是, 使用这个静态库时, 首先需要链接 libBZLib.a, 然后还需要链接 YSASIHTTPRequest 所依赖的动态库. 如 SystemConfig, MobileCoreService, CFNetwork, CoreGraphics, z.1 等.

也就是说用它来打包生成静态库是没有问题的.但是
3) 符号混淆. cocoapods packager 确实也做了. 但是做得不够好.
使用引用链接里的方法, 用 nm 检查一下生成的 libBZLib.a, 会发现大部分符号确实是做了 mangling. 但是如果在集成了 libBZLib 的工程里, 再用 Podfile 去引用 YSASIHTTPRequest 时,会发现报符号重复, cocoapods packager 漏了几个符号没有做 mangling, 其实就等于没有做 mangling. 导致实际上还是不能在静态库把 YSASIHTTPRequest 给打进去.
而且 cocoapods packager 看起来并不活跃, 稳定性也不能保证.

总结下就是, 如果不需要它的 mangling 功能, 可以试一试. 如果需要 mangling 功能,还是使用引用链接里提供的脚本, 自己处理吧.

参考资料

  1. 创建私有库
  2. 私有库引用私有库
  3. 私有库管理和模块化管理
  4. pod 导入静态资源
  5. 官方资料
  6. cocoaPods 进行 SDK 二次包装(cocoapods-packager 完成 framework 静态库打包,避免第三方库冲突)
  7. CocoaPods 动/静态库混用封装组件化 推荐:**\*\*\***
  8. 与 Cocoapods 抗战的一天
  9. CocoaPods 建立自己的 Podspec（三）
cocoapods
模块化
该博客文章由作者通过 CC BY 4.0 进行授权。
文章目录

css-layout

Swift + RxSwift MVVM 模块化项目实践