Gitlab搭建私有库-向内网远程库发布版本

目录

一、前面部分是创建本地库，这里省略

二、发布版本 -- 发布到公司内网

三、发布版本 -- 发布到外网

四、打包framework

五、遇到的错误

一、前面部分是创建本地库，这里省略

有需要的可以参考简书的文章：https://www.jianshu.com/p/7d1533fc6ce7

以下介绍的内容为创建本地私有库后，怎么向远程库发布版本，以期最后可以通过pod search xxx、pod install方式安装自己的远程库到项目；

以及发布远程版本过程中遇到的问题，以及解决方法；

二、发布版本 -- 发布到公司内网

1、创建私有库

在内网 Git 创建一个空的仓库，用来存放私有库；-- 我们这里是网络配置管理帮我们创建好的，这一步省略，有需要的可自行搜索，网上资料很多；

2、提交代码，打tag

(1)克隆这个项目WztFoundation到本地，指令：$ git checkout clone https://gitlab.wztcom.com/NewEnergy/IOSAPP/WztFoundation.git

(2)使用命令创建模板项目：$ pod lib create WztFoundation

按照步骤提示，创建模版组件项目；

(3)用 XCode打开 WztFoundation.podspec，进行修改

podspec文件修改并通过校验
……（略）

(4)提交代码修改

$ git add .

$ git commit -m "WztFoundation first commit"

(5)打tag并推送到gitlab远程私有库

git tag -m "version 0.1.5.9" 0.1.5.9

git push --tags

3、本地检测

指令：

$ pod spec lint WztFoundation.podspec --allow-warnings --verbose --no-clean --use-libraries --skip-import-validation

如果有警告，会导致无法通过，需要添加--allow-warnings
如果使用了 C 函数相关的，需要添加--use-libraries
如果导入的私有库有动态库/静态库，有些C++的代码会导致pod命令编译找不到头文件问题，而真机调试却正常，解决方法：--skip-import-validation

本地检测--指令：

// 本地检测
$ pod lib lint WztFoundation.podspec --allow-warnings --verbose --no-clean --use-libraries --skip-import-validation 
// 或者使用者一条指令
$ pod spec lint WztFoundation.podspec --allow-warnings --verbose --no-clean --use-libraries --skip-import-validation

4、产生私有库

$ pod repo add WztFoundation 'https://gitlab.wztcom.com/NewEnergy/IOSAPP/WztFoundation.git'

把内网仓库 WztFoundation 添加到CocoaPods本地仓库，这步操作会在 ~/.cocoapods/repo 路径下创建一个名字为 WztFoundation 的空文件夹；

指令：

$ pod repo add WztFoundation 'https://gitlab.wztcom.com/NewEnergy/IOSAPP/WztFoundation.git' master`

$ pod repo push `WztFoundation` WztFoundation.podspec --allow-warnings --verbose --use-libraries --skip-import-validation`

4.1遇到的问题总结：

pod repo add命令后，可以通过pod repo可以查看刚刚添加的本地库信息：

$ pod repo

WztFoundation

- Type: git (master)

- URL:  /Users/wzt/.cocoapods/repos/master

- Path: /Users/wzt/.cocoapods/repos/WztFoundation

WztFoundation https:

- Type: file system

- URL:  

- Path: /Users/wzt/.cocoapods/repos/WztFoundation https:

master

- Type: git (remotes/origin/master)

- URL:  [https://github.com/CocoaPods/Specs.git](https://github.com/CocoaPods/Specs.git)

- Path: /Users/wzt/.cocoapods/repos/master

volcengine-volcengine-specs

- Type: git (master)

- URL:  [https://github.com/volcengine/volcengine-specs.git](https://github.com/volcengine/volcengine-specs.git)

- Path: /Users/wzt/.cocoapods/repos/volcengine-volcengine-specs

4.1.1 WztFoundation路径下，config文件url为空？

不知道什么原因，只知道url需要修改为我们的远程私有库地址：https://gitlab.wztcom.com/NewEnergy/IOSAPP/WztFoundation.git

4.1.2 报错：

Validating spec

Cloning spec repo `-1` from ``

  $ /usr/bin/git clone  -- -1

  fatal: repository '' does not exist

[!] Unable to add a source with url `` named `-1`.

(/usr/bin/git clone  -- -1

fatal: repository '' does not exist

)

You can try adding it manually in `/Users/wzt/.cocoapods/repos` or via `pod repo add`.

以上是报错信息，下方是问题分析及解决方法 ：

(1)~/.cocoapods/repos/WztFoundation/config文件下url为https://gitlab.wztcom.com/NewEnergy/IOSAPP/WztFoudnation.git

再次pod repo push

依然失败...

(2)直到看到这篇资料：https://github.com/CocoaPods/CocoaPods/issues/8315

说是因为pod repo list，有的repo更新失败导致的，需要删掉一些没用的repo，比如一些url为空的repo;

再次执行，成功~

成功后打印：

WztFoundation passed validation.

Adding the spec to the `SpecRepo' repo

  $ /usr/bin/git -C /Users/wzt/.cocoapods/repos/SpecRepo status --porcelain

 - [No change] WztFoundation (0.1.5.9)

Pushing the `SpecRepo' repo

  $ /usr/bin/git -C /Users/wzt/.cocoapods/repos/SpecRepo push origin HEAD

  To [https://gitlab.wztcom.com/NewEnergy/IOSAPP/WztFoundation.git](https://gitlab.wztcom.com/NewEnergy/IOSAPP/WztFoundation.git)

     1244815..3613322  HEAD -> master

5、项目中引用私有库

在 podfile 文件中添加 source 参考:

source 'https://gitlab.wztcom.com/NewEnergy/IOSAPP/WztFoundation.git'  
source 'https://github.com/CocoaPods/Specs.git'

target 'xxxx' do

  pod 'WztFoundation'

end

三、发布版本 -- 发布到外网

1、提交修改

$ git add .
$ git commit -m "changes' description"

2、验证本地.podspec 文件的有效性

$ pod lib lint WztFoundation.podspec --allow-warnings --verbose --no-clean --use-libraries --skip-import-validation
##或者
$ pod spec lint WztFoundation.podspec --allow-warnings --verbose --no-clean --use-libraries --skip-import-validation

打印表示成功：WztFoundation passed validation.

3、推到 pod 上

$ pod trunk push WztFoundation.podspec --allow-warnings --verbose --use-libraries --skip-import-validation

成功后打印：

- Log messages:
- May 4th, 06:11: Push for `WztFoundation 0.1.5.5' initiated.
- May 4th, 06:11: Push for `WztFoundation 0.1.5.5' has been pushed (0.428640813 s).
3.1 error
Error: Authentication token is invalid or unverified. Either verify it with the email that was sent or register a new session.

解决方法--注册 CocoaPods 的 Trunk 服务：

$ pod trunk register [wzt@wztcom.com](mailto:wzt@wztcom.com) 'A21001' --verbose

行完以下命令，去邮箱点击 Trunk 验证链接。
查询注册信息。

$ pod trunk me
3.2 error
[!] An unexpected error occurred: <!DOCTYPE html>

解决方法：
https://github.com/CocoaPods/CocoaPods/issues/11621
这个问题上说，这一步会有50%的成功概率，要多尝试几次
然后会有概率遇到另外一个错误："error":"Unable to accept duplicate entry for: WztFoundation (0.1.5.4)"

3.3 error
"error\":\"Unable to accept duplicate entry for: WztFoundation (0.1.5.4)\"

解决方法：

$ pod trunk delete WztFoundation 0.1.5.4 --allow-warnings --verbose

然后继续重试~

成功后打印信息：

Push for `WztFoundation 0.1.5.4' has been pushed (0.421013575 s).

4.可以新建一个项目测试一下自己的库是否发布成功

pod search 一下自己的类库

$ pod search WztFoundation

成功打印：

-> WztFoundation (0.1.5.6)
A short description of WztFoundation.
pod 'WztFoundation', '~> 0.1.5.6'
- Homepage: [https://gitlab.wztcom.com/NewEnergy/IOSAPP/WztFoundation](https://gitlab.wztcom.com/NewEnergy/IOSAPP/WztFoundation)
- Source: [https://gitlab.wztcom.com/NewEnergy/IOSAPP/WztFoundation.git](https://gitlab.wztcom.com/NewEnergy/IOSAPP/WztFoundation.git)
- Versions: 0.1.5.6, 0.1.5.5, 0.1.5.4 [master repo]
4.1 error：Unable to find a pod with name, author, summary, or description matching WztFoundation

解决方法：

$ pod setup
$ rm -rf ~/Library/Caches/Cocoapods
$ pod search WztFoundation
4.2 error

依然报错：Unable to find a pod with name, author, summary, or description matching WztFoundation
解决方法：

cd ~/.cocoapods/repos
pod repo remove master
pod repo add master [https://github.com/CocoaPods/Specs.git](https://github.com/CocoaPods/Specs.git)

pod repo add master https://gitlab.wztcom.com/NewEnergy/IOSAPP/WztFoundation.git

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

四、打包framework

1、pod命令package
2、Xcode项目添加xcodbuild命令

五、遇到的错误

1、创建私有库后，pod install时报Classes和Assets的错误

https://juejin.cn/post/6952753809974099982

2、[!] An unexpected version directory Classes was encountered for the 'xxxx'

或者使用这种方法解决，简单快捷

pod 'WztFoundation', :git => "https://gitlab.wztcom.com/NewEnergy/IOSAPP/WztFoundation.git", :tag => '0.1.6.0'

参考资料：

CocoaPods公有库和私有库制作 https://blog.csdn.net/Johncahong/article/details/123426980

(CocoaPods) - 在内网搭建私有库 https://www.jianshu.com/p/89e22651952f

最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 194,088评论 5赞 459
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 81,715评论 2赞 371
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 141,361评论 0赞 319
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 52,099评论 1赞 263
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 60,987评论 4赞 355
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 46,063评论 1赞 272
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 36,486评论 3赞 381
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 35,175评论 0赞 253
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 39,440评论 1赞 290
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,518评论 2赞 309
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,305评论 1赞 326
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 32,190评论 3赞 312
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 37,550评论 3赞 298
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,880评论 0赞 17
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,152评论 1赞 250
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 41,451评论 2赞 341
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 40,637评论 2赞 335