iOS由传统打包上传到自动化打包上传

    xiaoxiao2022-07-06  219

    前言

    在iOS开发中,我们常用的打包上传方式就是用Xcode的archive方式打包。到了测试阶段,需要频繁的打包提交到测试平台,整个流程包括:编译-打包-上传,整个过程需要我们去坚守每一步操作,提交app store同样免不了一系列复杂动手操作过程。因此,就研究了iOS自动化打包,通过使用shell脚本,输入命令,一键打包上传,提高工作效率。

    在讲自动化打包之前,我们先看下我们传统的打包方式:

    一、第一种打包方式:传统打包方式(archive方式)

    就是我们的传统打包方式——利用Xcode进行archive(归档)操作,通过编译、build构建、Archive存档、Export导出ipa。

    1.打包前准备工作:

    设置好对应版本号,证书正确配置,或使用自动管理证书,然后选择通用设备,如下图 2.开始进行achive归档打包:点击左上角product——>achive:如下图 3.通过编译归档之后生成archive文件,再点击右侧的distribute,如下图

    然后选择打包环境,如下图,第1种: 生产环境,上传到appStore的;第2种: 测试环境的上传到蒲公英或fir上的;第3种:用于企业账号发布;第4种: 开发调试用的,debug模式会输出日志信息。开发测试一般用第2种或第4种。 按提示点击next下一步操作,最后export导出来,会生成一个文件夹,里面装了ipa包,就是我们需要上传ipa包。通过xcode自带的插件工具Application Locader(通过右击Xcode图标选择Open Developer Tool)选择ipa包上传就行了。

    二、第二种打包方式:也可以通过生成文件Payload文件夹,生成ipa包。

    操作步骤:

    1.打包前准备:同样要相关证书的配置,编译能通过不报错。

    2.选择要编译的Shcheme,然后command+B编译成功,在products文件夹里可以看到由之前的红色变成了黑色如下图(编译前在上,编译后在下) 右键编译后的Projudct,show in Finder里面找到这个app如下图 在桌面建一个文件夹叫“Payload”,注意一个字母也不能改,然后把这个app放入这个文件夹里,压缩成zip,再修改后缀为.ipa,此时,ipa包就出来了。操作如下图 3.上传操作同第一种方式一样。

    三、自动化打包上传

    打包原理:

    主要是通过shell脚本实现archive->生成ipa->上传到第三方平台(Fir.im 、蒲公英)或 App store这一系列过程的自动化。

    1.准备工作:安装fir-cli插件

    打开终端输入sudo gem install fir-cli,如:图3-1-1 ,这里输入命令安装的时候要注意下权限问题。 对于没有安装过rvm的,需要安装rvm(一个命令行工具,可以提供一个便捷的多版本 Ruby 环境的管理和切换)

    安装rvm,网上有大把的教程。

    2.相关环境配置、shell脚本编写

    根据需求,我这里做了3种环境配置,appStore、ad-hoc、development三种环境plist文件添加和设置,如:图3-2-1 图3-2-1 用xcode创建这三份plist文件放在当前工程目录里。这里制作了一份通用shell脚本(以fir和appStore为例):

    #先清理目录(由于历史编译存留的文件) if [ -d ./ipaDir ]; then rm -rf ./ipaDir fi if [ -d ./build ]; then rm -rf ./build fi #ipa包存放路径 if [ ! -d ./ipaDir ]; then mkdir -p ipaDir; fi #脚本执行目录/工程绝对路径 project_path=$(cd `dirname $0`; pwd) #工程名 将XXX替换成自己的工程名 project_name=XXX #scheme名 将XXX替换成自己的sheme名 scheme_name=XXX #打包模式 Debug/Release development_mode=Debug #build文件夹路径 build_path=${project_path}/build #plist文件所在路径 exportOptionsPlistPath=${project_path}/exportTest.plist #导出.ipa文件所在路径 exportIpaPath=${project_path}/ipaDir/${development_mode} #输入1:appStore(发布) 2:ad-hoc(开发-测试) 3:dev(开发-测试) echo "Place enter the number you want to export ? [ 1:app-store 2:ad-hoc 3:dev] " read number while([[ $number != 1 ]] && [[ $number != 2 ]] && [[ $number != 3 ]]) do echo "Error! Should enter 1 or 2 or 3" echo "Place enter the number you want to export ? [ 1:app-store 2:ad-hoc 3:dev] " read number done #appStore if [ $number == 1 ];then development_mode=Release exportOptionsPlistPath=${project_path}/exportAppstore.plist exportIpaPath=${project_path}/ipaDir/${development_mode} #ad-hoc elif [ $number == 2 ];then development_mode=Release exportOptionsPlistPath=${project_path}/exportTest.plist #dev else scheme_name=fenlibao_iphone_DEV development_mode=Debug exportOptionsPlistPath=${project_path}/exportTest_DEV.plist fi echo '///-----------' echo '/// 正在清理工程' echo '///-----------' xcodebuild \ clean -configuration ${development_mode} -quiet || exit echo '///--------' echo '/// 清理完成' echo '///--------' echo '' echo '///-----------' echo '/// 正在编译工程:'${development_mode} echo '///-----------' #如果工程不是.xcworkspace类型而是.xcodeproj类型,则下面的.xcworkspace换成.xcodeproj xcodebuild \ archive -workspace ${project_path}/${project_name}.xcworkspace \ -scheme ${scheme_name} \ -configuration ${development_mode} \ -archivePath ${build_path}/${project_name}.xcarchive -quiet || exit echo '///--------' echo '/// 编译完成' echo '///--------' echo '' echo '///----------' echo '/// 开始ipa打包' echo '///----------' xcodebuild -exportArchive -archivePath ${build_path}/${project_name}.xcarchive \ -configuration ${development_mode} \ -exportPath ${exportIpaPath} \ -exportOptionsPlist ${exportOptionsPlistPath} \ -quiet || exit if [ -e $exportIpaPath/$scheme_name.ipa ]; then echo '///----------' echo '/// ipa包已导出' echo '///----------' open $exportIpaPath else echo '///-------------' echo '/// ipa包导出失败 ' echo '///-------------' fi echo '///------------' echo '/// ipa打包完成 ' echo '///-----------=' echo '' echo '///-------------' echo '/// 开始上传ipa包 ' echo '///-------------' if [ $number == 1 ];then #验证并上传到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 else #上传到Fir # 将XXX替换成自己的Fir平台的token fir login -T XXX fir publish $exportIpaPath/$scheme_name.ipa fi exit 0

    把shell脚本和三个plist配置文件放在工程目录下,将shell脚本做相应修改:

    1.换成自己项目的工程名和scheme名称:

    #工程名 将XXX替换成自己的工程名 project_name=XXX #scheme名 将XXX替换成自己的sheme名 scheme_name=XXX

    2.下面代码是在上传appStore的时候需要知道appleID 和密码

    这里要注意的一点就是对于开启了双重认证的账号,密码不是账号登录密码,而是app专用密码,app专用密码是要在开启双重认证之后,需要自己去开发者网站的用户信息设置里去生成。

    3.在上传fir内测平台的时候要自己fir平台的token,进入fir我的应用去获取token,获取方式如:图3-3-1

    图3-3-1 以上就完成了自动化的所有配置。1个shell脚本,3个plist文件对应三种打包环境,文件位置如下:

    3、开启一键打包上传

    接下来就是一行命令执行自动化打包上传:

    打开终端,cd到要打包的工程目录下,输入"./shell.sh" 回车,如下 这里会让你选择之前配置的3种环境中的一种环境,只能输入1、2、3,如果输入其他的数字会无效,让你重新输入,输入之后回车就开始执行自动化打包上传操作了,上传成功显示如下 上传到fir成功显示如下: 上传到itunes connect成功显示如下: 4、自动化打包注意事项

    1). 打包之前,确保证书配置正确,配置plist文件里面的compileBitcode设置为false,否则会打包报错;

    2). fir-cli安装时由于系统版本原因会提示各种权限不足,解决方式:sudo gem install -n /usr/local/bin fir-cli;

    3). 根据工程类型是.xcodeproj类型还是.workspace,脚本编译代码改成相应的工程类型;

    4). 打包到appStore的时候,对于开启双重认证的开发者账号,密码必须为账户的app专用密码,而不是开发者账号的登录密码。

    总结: 传统的打包方式耗费了我们开发者更多的时间和体力,而且效率低下,出错率也要偏高;利用shell脚本自动化打包,降低了人工操作成本的加快了工作效率。谢谢观赏!

    最新回复(0)