一、下载 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,会弹出如下对话框:
按照对话框提示步骤:
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、可以看到依赖已经被缓存在远程仓库
四、Local 仓库使用
选择Home->Set Me Up->cocoapods-local,会弹出如下对话框:
按照对话框提示步骤:
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<USERNAME>:<PASSWORD> -XPUT http://localhost:8081/artifactory/cocoapods-local/<TARGET_FILE_PATH> -T <PATH_TO_FILE>
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失败。
解决办法:
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仓库名称
可参考链接: