CocoaPods私有库制作

前言

在前面的章节中有介绍过CocoaPods的使用:

制作CocoaPods公有库以及私有库的区别
[制作Framework以及上传至CocoaPods库]

(https://www.jianshu.com/p/a832740aa491)
此篇文章会着重介绍下制作过程以及记录过程遇到的一些问题和解决办法。

制作过程

首先,我们要先了解整个制作过程,这样我们可以快速的熟悉制作的整体流程,并且可以很好的控制过程中可能出现的问题。

  • 创建私有的源仓库
  • 创建私有的Pod仓库
  • 添加私有库源文件 (添加代码、资源、包等等)
  • 修改.podSpec文件
  • 验证.podSpec文件
  • 提交代码至远程仓库
  • 推送.podSpec文件
创建私有的源仓库

1.在远端仓库中,创建一个源索引库PodSpecs。 (远端仓库可以选择githubgitlab码云

2.将远端索引库添加到本地源中(使用终端输入以及命令)

/**
pod repo add [repoName] [source]
*/ 
pod repo add component https://github.com/component/specs.git
创建私有的Pod仓库

1.在远端仓库中,创建一个源代码pod库。 注意⚠️:这里先不着急关联到本地;

  1. 选择一个目录下,创建本地Pod库工程。
/**
pod lib create  Pod库名
*/
pod lib create RTCComponent

执行完成后,命令行会有一系例的问题,按需填写即可;

To get you started we need to ask a few questions, this should only take a minute.

If this is your first time we recommend running through with the guide: 
 - https://guides.cocoapods.org/making/using-pod-lib-create.html
 ( hold cmd and double click links to open in a browser. )


What platform do you want to use?? [ iOS / macOS ]
 > iOS

What language do you want to use?? [ Swift / ObjC ]
 > Swift

Would you like to include a demo application with your library? [ Yes / No ]
 > yes

Which testing frameworks will you use? [ Quick / None ]
 > none

Would you like to do view based testing? [ Yes / No ]
 > no

命令执行完后会帮我们创建一个Workspace,里面包含了两个Project, RTCComponent是我们Pod库的运行Demo项目;Pods是我们开发库的代码项目

项目层级

添加私有库源文件

我们可以在Pods/Development Pods/RTCComponent目录下导入我们的代码文件或者framework。在这一步就是将我们代码以及资源文件都放置到项目中,导入的文件以及资源目录后面需要在.podSpec文件中配置, 这里就不过多说明。

修改.podSpec文件
Pod::Spec.new do |s|
  s.name             = 'RTCComponent'
  s.version          = '0.1.0'
  s.summary          = '组件'
  s.description      = 'xxxxxxxxxxxxxxxxx'
  s.homepage         = 'http://xxxx/component'
  # s.screenshots     = 'www.example.com/screenshots_1', 'www.example.com/screenshots_2'
  s.license          = { :type => 'MIT', :file => 'LICENSE' }. 
  s.author           = { 'xxxxxxxx' => 'xxxxxxxxx@qq.com' }
  s.source           = { :git => 'http://xxxx/component/RTCComponent.git', :tag => s.version.to_s }
  # s.social_media_url = 'https://twitter.com/<TWITTER_USERNAME>'
  s.ios.deployment_target = '9.0'

  # 这里是源文件的路径 
  s.source_files = 'RTCComponent/Classes/**/*'
  
  # 这里是资源文件的路径 
  # s.resource_bundles = {
  #   'RTCComponent' => ['RTCComponent/Assets/*.png']
  # }
  # 这里是头文件的路径 
  # s.public_header_files = 'Pod/Classes/**/*.h'

  # 如果导入了framework
  s.frameworks = 'OpenAL', 'Accelerate'

  # 如果依赖了library(记得把lib前缀,以及.tbd去掉)
  s.libraries  = 'sqlite3', 'resolv', 'c++', 'z'

  # 如果依赖了三方pod库
  s.dependency 'HandyJSON', '~> 5.0.2'
  s.dependency 'TXLiteAVSDK_Professional', '~> 8.9.10382'
  s.dependency 'SwiftyBeaver', '~> 1.9.3' # Log
  s.dependency 'SwifterSwift/SwiftStdlib'

  # 如果需要修改pod中的target设置,写在这里
  s.pod_target_xcconfig = { 'VALID_ARCHS' => 'x86_64 armv7 arm64', 'ENABLE_BITCODE' => 'NO' }
  #  s.user_target_xcconfig = { 'ENABLE_BITCODE' => 'NO' }
end

这里如果需要设置请参照 CocoaPods官网文档

验证.podSpec文件

cd到该目录下;执行以下操作:

/** 网络校验 */
pod spec lint 

/** 本地校验 */
pod lib lint

常用附加处理:

  • 查看详细信息,请在命令后加入 --verbose
  • 忽略警告,请在命令后加入--allow-warnings
  • 使用本地库,请在命令后加入 --use-libraries
  • 检查所有问题,请在命令后加入 --no-clean
  • 依赖了私有库,需要添加源,请在命令后加入 --sources= (注意如果依赖了公有库,还需要添加公有库源:https://github.com/CocoaPods/Specs--sources=私有库名,https://github.com/CocoaPods/Specs
提交代码至远程仓库

将本地pod库工程提交推送到远程仓库,打上Tag发布。
1.提交本地仓库,并推送

/** cd Pod工程目录 */  
cd PodProject
/** git commit -m "提交信息" */  
git commit -m "commit"
/** git branch -M 分支 */  
git branch -M main
/** git remote add origin git仓库地址 */  
git remote add origin https://github.com/XXXX.git
/** git push -u origin 分支 */  
git push -u origin main

2.打上Tag发布

/** 新建tag git tag [tagName] */
git tag "0.0.1" 
/** 推送单个tag至远端 git push origin [tagName] */
git push origin "0.0.1" 
/** 推送本地所有tag  git push origin --tags */
git push origin --tags
推送.podSpec文件

检查下本地repo,如果有,继续下一步,反之,则重新在添加一次(pod repo add [name] [源仓库git地址]);

pod repo list

本地仓库检查无误后,开始将创建的Pod库中的.podspec文件推送至指定源仓库;
首先,还是cd.podspec文件的目录下,执行以下操作:

/** 推送命令: pod repo push [repoName] [name].podspec */ 
pod repo push component RTCComponent.podspec 

到这里所有流程已经完成;整个过程中的验证过程可能是最容易出问题的,如果验证通过,那么发布就不会有什么问题,所以如果验证没有通过的话,发布也是不会成功的;

文章的最后,我会把制作过程中所遇到的问题一一汇总。

问题汇总(Error)

  • 问题1: 校验失败
** BUILD FAILED **
The following build commands failed:
    CompileSwift normal x86_64
    CompileSwiftSources normal i386 com.apple.xcode.tools.swift.compiler
    CompileSwift normal i386
    CompileSwift normal arm64
(4 failures)
Testing with `xcodebuild`. 

解决办法:在.podspec文件中加入;参考iOS 指令集架构

s.pod_target_xcconfig = { 'VALID_ARCHS' => 'x86_64 armv7 arm64' }
  • 问题2: 组件中依赖的第三方库中有framework或者.a文件, pod install 报错
target has transitive dependencies that include statically linked binaries:

解决办法: 在podfile文件中加入以下代码;

pre_install do |installer| Pod::Installer::Xcode::TargetValidator.send(:define_method, :verify_no_static_framework_transitive_dependencies) {}
end
  • 问题3: Xcode setting ENABLE_BITCODE
You must rebuild it with bitcode enabled (Xcode setting ENABLE_BITCODE) 

解决办法:将target下 ENABLE_BITCODE 设置为 NO

参考文档:
CocoaPods官方制作文档
用 CocoaPods 私有库提高团队的整体效率
GitHub 将使用 main替换掉 master等术语

走过路过不要错过,觉得不错,来杯coffee☕️

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 217,406评论 6 503
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,732评论 3 393
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 163,711评论 0 353
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,380评论 1 293
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,432评论 6 392
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,301评论 1 301
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,145评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,008评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,443评论 1 314
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,649评论 3 334
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,795评论 1 347
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,501评论 5 345
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,119评论 3 328
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,731评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,865评论 1 269
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,899评论 2 370
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,724评论 2 354

推荐阅读更多精彩内容