使用 Artifactory 搭建 CocoaPod 私服

一、下载 Artifactory

下载链接:
https://jfrog.com/download-artifactory-pro/
选择“ARTIFACTORY PRO STANDALONE”方案安装,无需配置数据库即可使用。

申请链接:
http://www.jfrogchina.com/artifactory/free-trial/
电子邮件:163邮箱不行,可以填写QQ邮箱
申请免费试用版 License,申请成功后,到邮箱中查看邮件。

二、创建 CocoaPod 仓库

解压下载的安装包,进入 bin 目录,执行 artifactory.sh文件(拖动artifactory.sh文件到终端,回车即可)
随后访问 localhost:8081,即可进入 Artifactory 页面。
默认用户名:admin 密码:password。

输入 License 信息(在邮箱邮件中),即可开始使用 Artifactory。
创建仓库时,选择 CocoaPods:

在此,创建了两个仓库,一个是 CocoaPod Local,目的是存储所有本地的CocoaPod 构建产出物,另一个是 CocoaPod Remote,能够作为外网 CocoaPod 源的本地代理,在内网提供服务。

三、Remote 仓库使用

选择Home->Set Me Up->cocoapods-remote,会弹出如下对话框:


使用 Artifactory 搭建 CocoaPod 私服_第1张图片
WechatIMG4.jpeg

按照对话框提示步骤:

1、执行下面命令,安装 cocoapod-art 插件

gem install cocoapods-art

2、右上角:Type password ,输入默认密码:password
打开/Users/用户名/下的.netrc文件(.netrc文件默认是隐藏文件),将弹框中的内容复制添加得到.netrc文件中,保存。

machine localhost
login admin
password xxxxxxxxxxxx

3、执行下面命令,等待完成提示出现“Successfully added repo cocoapods-remote”。

pod repo-art add cocoapods-remote "http://localhost:8081/artifactory/api/pods/cocoapods-remote"

4、将 Podfile 中添加该源作为 pod 的依赖解析源:

platform :ios, '8.0'
inhibit_all_warnings!

#use_frameworks!

plugin 'cocoapods-art', :sources => [
  'cocoapods-remote'
]

target 'testProject' do

pod 'AFNetworking', '~> 3.1.0'

end

5、执行:pod install 或者 执行不升级CocoaPods的spec仓库的方式。

pod install --verbose --no-repo-update 

6、可以看到依赖已经被缓存在远程仓库


使用 Artifactory 搭建 CocoaPod 私服_第2张图片
20190106124041833.png

四、Local 仓库使用

选择Home->Set Me Up->cocoapods-local,会弹出如下对话框:


使用 Artifactory 搭建 CocoaPod 私服_第3张图片
WechatIMG5.png

按照对话框提示步骤:

1、在 Remote 仓库使用过程已经执行,不需要再次执行

2、在 Remote 仓库使用过程已经执行,不需要再次执行

3、执行下面命令,等待完成提示出现“Successfully added repo cocoapods-local”。

pod repo-art add cocoapods-local "http://localhost:8081/artifactory/api/pods/cocoapods-local"

4、使用下面命令压缩pod包,pod包中包含 项目代码 or framework、boundle,以及.podspec or .podspec.json:

COPYFILE_DISABLE=1 tar czvf 压缩后名称.tar.gz 待压缩文件名称

5、使用下面的Artifactory's REST API将 压缩后名称.tar.gz 上传到Local 仓库。

curl -u: -XPUT http://localhost:8081/artifactory/cocoapods-local/ -T 

6、将 Podfile 中添加该源作为 pod 的依赖解析源。

platform :ios, '8.0'
inhibit_all_warnings!

#use_frameworks!

plugin 'cocoapods-art', :sources => [
  # 指定local仓库
  'cocoapods-local'
]

target '项目名称' do
# 指定pod内容 与 版本号
pod '压缩后名称', '0.0.1'

end

7、执行。

pod install

五、分支管理
每个项目使用多个Artifactory local仓库,dev-debug-local仓库、produce-debug-local仓库、produce-release-local仓库代替git中的分支概念,每个local仓库中使用版本号来进行管理。

六、权限管理
Artifactory有权限管理模块,可以创建权限目标对象,对不同项目设置不同用户的不同权限。
Managing Permissions

七、注意事项
1、Local仓库使用第5步,将tar.gz上传到Local仓库后,需要注意查看Local仓库tar.gz下,是否包含.DS_Store or ._.DS_Stroe or ._xxxxx等隐藏文件。
.DS_Store是Mac系统保存文件夹自定义属性的隐藏文件,
._xxxxx是压缩过程中出现的
如果包含上述文件,会导致pod install失败。


使用 Artifactory 搭建 CocoaPod 私服_第4张图片
WechatIMG6.png
解决办法:
1、在linux系统下压缩为tar.gz,应该没有此问题
2、在Windows系统下,使用7-zip工具压缩为tar.gz
3、在Mac系统下:
(1)删除.DS_Store
// 删除当前文件及子文件夹中的.DS_Store文件
find . -name '*.DS_Store' -type f -delete
(2)压缩
COPYFILE_DISABLE=1 tar czvf 压缩后名称.tar.gz 待压缩文件名称

2、podspec文件的编写与cocoapods + git的规范完全一致。Podspec Syntax Reference
(1)只需要修改homepage部分,改为四、Local 仓库使用中,第5步,-XPUT与-T之间的地址。
(2)source可以仍为之前cocoapods + git建立私库的地址,podspec上传到local仓库后,Artifactory会将source内容转换成他们自己的地址。(注:经测试source不填写git地址也是可以的,如:spec.source = { :git => "", :tag => "#{spec.version}" })

3、向Local 仓库上传新版本后,需要先执行下面命令,再执行pod install来pod新版本。

pod repo-art update local仓库名称 

可参考链接:

还在使用 Git 仓库作为 CocoaPod 私服?--使用Artifactory 1分钟搭建 CocoaPod 私服

CocoaPods Repositories

你可能感兴趣的:(使用 Artifactory 搭建 CocoaPod 私服)