由于公司业务的需要,经常需要打企业包并上传到蒲公英上,手工打包上传太浪费人力了,所以前几天研究了一下自动化,小有收获,给大家分享一下。
原理说明:
使用了苹果提供的Xcodebuild,他是xocde的Command line tools 提供的命令
第一步:archive
首先需要了解的是,archive 工程后,实际上我们是把整个工程编译,然后签名,变成了一个后缀名为 xcarchive 的文件。通过调用以下命令,我们将整个工程编译,签名,然后将生成的 xcarchive 文件放到自己规定的文件夹里。
$ xcodebuild -derivedDataPath 'projectPath' -scheme 'scheme_name' -archivePath 'archivePath' clean archive
参数说明:
projectPath 工程所在的地址(.xcodeproj文件所在地址)
scheme_name 需要打包的Scheme的名称
archivePath archive后生成的 .xcarchive文件存放的地址
命令:
clean 清除编译产生的问题,下次编译就是全新的编译了
archive 打包命令,会生成一个.xcarchive的文件
如果工程使用了 Cocoapods 来管理第三方库,那么命令的执行方式上有所不同,因为 Cocoapods 会把工程变成一个 workspace。将 workspace 工程 archive 的命令需要加上workspace这个参数:
-workspace 需要打包的workspace 后面接的文件一定要是.xcworkspace 结尾的
第二步:export
将上一步生成的 xcarchive 文件导出,生成 ipa 文件。这里需要用到的命令是xcodebuild -exportArchive
$ xcodebuild -exportArchive -archivePath 'archivePath' -exportPath 'exportPath' -exportFormat ipa -exportProvisioningProfile 'provisioning_profile'
参数说明:
archivePath archive后生成的 .xcarchive文件存放的地址
exportPath 生成IPA包存放的地址
provisioning_profile 打企业包使用的配置文件(可以从苹果开发者账号中查看)
命令:
exportArchive 告诉xcodebuild需要导出archive文件
其他可能使用的命令参数:
-configuration Debug archive出Debug环境的包 ,如果改成Release会archive出Release环境的包
大家可以查看官方文档,这里详细介绍了xcodebuild的使用。
第三步:上传蒲公英
蒲公英提供了一种使用Linux下的crul命令上传App的方法:
$ curl -F file=@'ipa_path' -F uKey='user_key' -F _api_key='api_key' https://www.pgyer.com/apiv1/app/upload
参数说明:
ipa_path IPA包所在的地址
user_key 用户Key,用来标识当前用户的身份,对于同一个蒲公英的注册用户来说,这个值在固定的
api_key API Key,用来识别API调用者的身份,如不特别说明,每个接口中都需要含有此参数。对于同一个蒲公英的注册用户来说,这个值在固定的
https://www.pgyer.com/apiv1/app/upload 固定的蒲公英上传地址
上传结束后,蒲公英会返回一个对象,可以根据返回的数据判断是否上传成功。
通过上述三步即可完成打包上传蒲公英的操作。
2017.05.08 更新
4月中旬的时候,一次打包失败了,看了下失败日志,是由于xcodebuild命令中export操作的参数-exportProvisioningProfile失效导致的。在网上查了下资料,ParadiseKiss的iOS自动签名打包(xcodebuild)给了我很大的帮助。
之前的命令是:
$ xcodebuild -exportArchive -archivePath 'archivePath' -exportPath 'exportPath' -exportFormat ipa -exportProvisioningProfile 'provisioning_profile'
现在改为:
$ xcodebuild -exportArchive -archivePath 'archivePath' -exportPath 'exportPath' -exportOptionsPlist 'plistPath' PROVISIONING_PROFILE="provisioning_profile"
或者:
xcodebuild -exportArchive -archivePath 'archivePath' -exportPath 'exportPath' -exportOptionsPlist 'plistPath' CODE_SIGN_IDENTITY= "iPhone Distribution: xxxx Co, Ltd." PROVISIONING_PROFILE="provisioning_profile" PRODUCT_BUNDLE_IDENTIFIER='bundle id'
参数说明:
archivePath archive后生成的 .xcarchive文件存放的地址
exportPath 生成IPA包存放的地址
plistPath 生成的IPA包的类型控制的plist文件(App Store、Ad Hoc、Enterprise)
provisioning_profile 打企业包使用的配置文件(可以从苹果开发者账号中查看)
CODE_SIGN_IDENTITY 等号后面双引号中填写发布证书
PROVISIONING_PROFILE 等号后面双引号中填写provisioning_profile
PRODUCT_BUNDLE_IDENTIFIER 等号后面填写bundle_identifier
注意:发布证书和发布的配置文件可能含有空格,所有要用双引号(" ")