特别说明:如果项目没有采用Cocoapods管理,没有.xcworkspace,只有xcodeproj;只需要将脚本中这句
xcodebuild \
archive -workspace ${project_path}/${project_name}.xcworkspace \
这句替换成下面这样就ok了
xcodebuild \
archive -project ${project_path}/${project_name}.xcodeproj \
日常编译打包工作主要是以下两个目的:
- 提交测试版本ipa给测试人员
配置好测试描述文件,然后Product -> Archive
编译打包,选择Organizer
,导出ad hoc 的 ipa
包。再上传到Fir等第三方平台上,然后通知测试同事进行测试。整个流程下来需要人工监守操作比较耗费时间。 - 提交ipa包到App Store已供审核
配置好正式的描述文件,然后同样的方式打包导出app store 的 ipa
包。通过Application Loader 等方式
提交到App store等待苹果处理二进制包,处理完后选择构建版本,最后提交等待苹果审核。
无论打测试包提供测试人员测试还是打正式包上传到App strore,整个过程都是重复耗费人工的操作,需要人工等待,然后各种点击选择...我们可以通过编写脚本语言来实现整个过程。
配置自动打包发布的流程
通过下面几步的设置好之后,以后再进行打包发布到第三方平台或者App Store 只需要一步就能搞定了(一个回车搞定)
笔者通过shell脚本
实现从archive->生成ipa->上传到第三方平台(Fir.im 、蒲公英)或 App store
。通过下面几步即可实现自动打包上传功能。
- 下载Shell脚本
- 将archiveScript中的几文件拖入工程的根目录
- 根据自己需求选择好描述文件
- 根据自己的项目修改一下shell.sh (修改哪里下面会指出)
- cd到工程根目录,通过./shell.sh 执行脚本即可
下面通过实例详细演示整个过程
第一种:打包上传到第三方平台Fir (上传蒲公英原理一样)
第二种:打包上传到App store
将通过这几步来讲解整个过程
- 准备工作
- 准备工作做完后,正式开启自动化之路
- 自动化脚本执行过程中可能遇到的错误
准备工作
-
因为要上传到Fir平台,需要先安装fir-cli
-
如果没有安装过rvm,需要安装rvm,在终端输入
rvm -v
命令查看,如果打印出rvm:command not found
说明没有安装过rvm,如果能打印出rvm版本等信息说明安装过。如果没有安装过rvm可以通过下面的命安装,如果已经安装过可以忽略。- 在终端输入
curl -L get.rvm.io | bash -s stable
,然后稍等一会rvm就安装好了 - 在终端输入
source ~/.bashrc
- 在终端输入
source ~/.bash_profile
- 再输入
rvm -v
查看安装成功
- 在终端输入
准备工作做完后,正式开启自动化之路
一、将archiveScript中的3个文件拖入工程的根目录
二、根据自己需求选择好描述文件
三、修改一下shell.sh 文件
Product ->Scheme -> Edit Scheme 查看自己的scheme_name
获取Fir平台的token
三、 cd到工程根目录,./shell.sh 回车就会执行脚本
四、 根据自己的需求选择即可
如果开始选择的1:app-store 会发布到app store
如果开始选择的2:ad-hoc 发布到fir平台
如果遇到下面的错误
解决方法:在终端 输入rvm system
后重新执行sehll脚本就可以了
如果前面已经安装过fir-cli,但是在脚本执行过程中任然报fir:command not found
的错误
解决办法: 在终端输入rvm get head
执行完毕后再次执行脚本就ok了
到这里就已经实现了通过脚本打包并发布到第三方平台Fir 和 Appstore的整个流程。接下来对shell中的脚本和一些自动化原理进行简单说明
shell中的脚本和一些自动化原理
正常情况下手动在Xcode中执行Product -> Archive
, 在Xcode底层是通过xcodebuild相关的命令编译、打包生成ipa包的.(xcodebuild主要是用来编译,打包成Archive和导出ipa包)
进入终端可以通过下面的命令查看一下xcodebuild的version
接下来,看一下Shell脚本
上面内容注释大家一看应该就明白
清理构建目录
xcodebuild \
clean -configuration ${development_mode}
编译之前先clean下,就如同在Xcode进行Product -> Clean
。
编译打包成Archive
xcodebuild \
archive -workspace ${project_path}/${project_name}.xcworkspace \
-scheme ${scheme_name} \
-configuration ${development_mode} \
-archivePath ${build_path}/${project_name}.xcarchive
编译工程,编译并生成.xcarchive文件,放在build_path下,名字是project_name.xcarchive,就如在Xcode进行Product -> Archive
这一步最为耗时.
将Archive导出ipa
xcodebuild -exportArchive -archivePath ${build_path}/${project_name}.xcarchive \
-configuration ${development_mode} \
-exportPath ${exportIpaPath} \
-exportOptionsPlist ${exportOptionsPlistPath}
将生成的.xcarchive文件导出.ipa包到指定的exportIpaPath路径下。
说明:
用\来进行换行分隔,一条shell命令过长时可以进行分割显示.
$变量名是引用变量,拿来使用
|| exit 指明如果这一条命令执行失败,则退出当前shell.
通过Fir-cli命令上传到Fir平台
# 将XXX替换成自己的Fir平台的token
fir login -T XXX
fir publish $exportIpaPath/$scheme_name.ipa
通过altool工具提交ipa包到app store
这个工具实际上是Application Loader
,打开Xcode-左上角Xcode-Open Developer Tool-Application Loader
可看到
altool的路径是:
/Applications/Xcode.app/Contents/Applications/Application\ Loader.app/Contents/Frameworks/ITunesSoftwareService.framework/Support/altool
#验证并上传到App Store
# 将-u 后面的XXX替换成自己的AppleID的账号,-p后面的XXX替换成自己的密码
altoolPath="/Applications/Xcode.app/Contents/Applications/Application Loader.app/Contents/Frameworks/ITunesSoftwareService.framework/Versions/A/Support/altool"
"$altoolPath" --validate-app -f ${exportIpaPath}/${scheme_name}.ipa -u XXX -p XXX -t ios --output-format xml
"$altoolPath" --upload-app -f ${exportIpaPath}/${scheme_name}.ipa -u XXX -p XXX -t ios --output-format xml
整个过程和原理还算比较简单,shell脚本还是满有意思的,作为苹果开发人员,有必要学习一下,本人也刚学习shell 不久,欢迎大家交流。
参考文档:
http://www.jianshu.com/p/bd4c22952e01
https://developer.apple.com/legacy/library/documentation/Darwin/Reference/ManPages/man1/xcodebuild.1.html