Swift 私有库、组件化快速搭建(CocoaPods私有库/索引库)

最近更新 2023.3.31
私有Cocoapods仓库&遇到的问题
pod索引库
私有pod仓库
pod组件化
pod遇到的问题

Git代码搬迁

  1. 在新Git服务器创建需要迁移的同名空项目(不同名也可以)

  2. Git clone 旧Git代码到本地 (或者本地有Git origin的代码,用Git remote -v 查看)

  3. Git push --mirror 新的空项目地址

  4. 完成后Git clone 新Git上的代码到本地game over

Pod 私有库(子组件)

1. 创建工程以YBBluetoothKit为例
pod lib create YBBluetoothKit

#然后回答几个问题

#选择平台
What platform do you want to use?? [ iOS / macOS ]  
 > ios

#选择语言
What language do you want to use?? [ Swift / ObjC ]  
 > swift

#是否需要Demo
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

2. 设置podspec 文件

注意必须修改的内容


Pod::Spec.new do |s|

  # 库名称,默认和工程名相同,建议不改
  s.name             = 'YTPrivateBaseKit'   

  # 库的版本,每次升级版本后必须要在这里修改版本号
  s.version          = '0.1.0'                  

  # 该库的简介,更改成适合的简介,使用默认简介会出现简介没有意义的错误
  s.summary          = '这是一个蓝牙库.'   

  # 详细描述,一般不用改,有readme呢
  s.description      = <<-DESC
TODO: Add long description of the pod here.
                       DESC

  # 库的主页,需要更改为正确的主页
  s.homepage         = 'http://101.132.74.65/fengming/YBBluetoothKit' 

  # 许可,私有库可以不改
  s.license          = { :type => 'MIT', :file => 'LICENSE' }

  # 作者,可以不改
  s.author           = { 'fengming' => '1028708571@qq.com' }    

  # 库的克隆地址,这个地址必须改成正确的克隆地址,可以是 https 或 ssh
  s.source           = { :git => 'http://101.132.74.65/fengming/YBBluetoothKit.git', :tag => s.version.to_s } 

  # 该库最低支持版本,可以修改为对应版本
  s.ios.deployment_target = '10.0'

  # 该库上传文件的路径,默认是 Classes 文件夹下的所有文件夹及文件,默认不需要改
  s.source_files = 'YBBluetoothKit/Classes/**/*'

  #--------------------------------------------------
  # 以下是默认没有但可以自行添加的基础配置

  # 设置指定版本号或非指定版本号的依赖库,
  #s.dependency 'SnapKit'

  # 指定 Swift 语言版本,Swift 项目需要设置这个
  # s.swift_version = '4.2'

end

5.本地校验pod lib lint

cd 到YBBluetoothKit => YBBluetoothKit.podspec 所在目录

pod lib lint --allow-warnings

出现YBBluetoothKit passed validation.表示成功

6. 创建远程库

在Git远端创建项目

7. 关联远程库
git remote add origin "http://101.132.74.65/fengming/YBBluetoothKit"
8.提交代码并为项目打上tag
git add .
git commit -m "project init"
git tag -m "first dev v0.1.0" 0.1.0
git push
git push --tags
9 .联网校验pod spec lint

Pod 索引库(主仓库)

如果已经创建过,就不需要再创建了

1. 在Git远端创建主工作项目 以ManagerSpecRepo为例

创建一个空的远端项目即可

2. 将索引库添加(关联)到CocoaPods的目录下
pod repo add ManagerSpecRepo http://101.132.74.65/fengming/ManagerSpecRepo
3.将子组件YBBluetoothKit.podspec添加并推送到ManagerSpecRepo主仓库
pod repo push ManagerSpecRepo YBBluetoothKit.podspec

查看本地索引库

pod repo list

删除本地索引库

pod repo remove name

Pod私有库更新流程

  1. 将修改过的子组件文件的.podspec文件,修改version即可

  2. 打tag,并将tag上传 (git push origin [tagname] / git push origin --tags)

  3. pod lib lint --allow-warnings

  4. pod repo push 主仓库 子组件.podspec --verbose --allow-warnings

  5. 如果有.a都静态库使用--use-libraries

pod repo push ManagerSpecRepo YBBluetoothKit.podspec --verbose --use-libraries --allow-warnings
  1. 如果里面已经依赖了其他私有库 需要指定 sources 地址(以逗号隔开)
pod repo push ManagerSpecRepo YBBluetoothKit.podspec --verbose --use-libraries --allow-warnings --sources="http://101.132.74.65/fengming/ManagerSpecRepo,https://github.com/CocoaPods/Specs.git"

Pod私有库异常整理

1. pod lib lint (检查本地pod)
[!] DemoPodSpecs did not pass validation, due to 2 warnings (but you can use --allow-warnings to ignore them).
 You can use the --no-clean option to inspect any issue.

解决办法:用 pod lib lint --allow-warnings 命令

2. pod spec lint (检查远程pod)
Encountered an unknown error (Simulator is not available.) during validation

解决办法:升级cocoapods sudo gem install -n /usr/local/bin cocoapods --pre

3. pod spec lint (检查远程pod)
[iOS] unknown: Encountered an unknown error (Must be in the root of the repo (/Users/*.cocoapods/repos/master), instead in ....

解决办法:可能是因为更新完Xcode以后Xcode路径更改了,Xcodebuild找不到路径。 执行命令 sudo xcode-select -switch /Applications/Xcode.app/Contents/Developer

4. pod repo push DemoPodSpecs DemoPodSpecs.podspec

The DemoPodSpecs.podspec specification does not validate.

解决办法: pod repo push DemoPodSpecs DemoPodSpecs.podspec --verbose --use-libraries --allow-warnings

5. pod repo push DemoPodSpecs DemoPodSpecs.podspec --verbose --use-libraries --allow-warnings
/usr/bin/git -C /Users/.cocoapods/repos/DemoPodSpecs -C
 /Users/.cocoapods/repos/DemoPodSpecs push origin master
 fatal: repository '' not found

解决办法:到 /Users/.cocoapods/目录下查看私有pod库是否存在

6. pod lib lint
[!] The validator for Swift projects uses Swift 3.0 by default, if you are using a different version of swift you can use a `.swift-version` file to set the version for your Pod. For example to use Swift 2.3, run: `echo "2.3" > .swift-version`.

解决办法:运行 echo 4.2 > .swift-version

7. Pod install

7.1

[!] CocoaPods could not find compatible versions for pod "YBCoreKit":
  In snapshot (Podfile.lock):
    YBCoreKit (= 1.2.1)

  In Podfile:
    YBSDKPayKit (from ../) was resolved to 1.8.1, which depends on
      YBCoreKit

It seems like you've changed the constraints of dependency YBCoreKit inside your development pod YBSDKPayKit.
You should run pod update YBCoreKit to apply changes you've made.

解决办法:

  1. 注释掉source,和所以pod 库,以及pod 'demo', :path => '../',然后 pod install
  2. 重新打开注释掉的内容,然后 pod install

7.2 Unable to find a specification for ""
解决办法:
别着急pod update 一下就好了

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

推荐阅读更多精彩内容