因为公司的业务渠道非常多,用Xcode一个个 打包ipa非常耗时费力,因此决定写一个脚本打包工具批量处理。由于之前没有接触过shell脚本,现学现用,本文主要侧重打包ipa的逻辑,如果有不足之处烦请指出。好了废话不多说,进入主题。
1、整体思路
为了实现一个工程可以打包多个同步的渠道,只需要替换相应的资源。因而我这个工具的思路的是每个文件夹包含了该渠道所有要替换资源,然后将替换资源替换主工程里面的相应信息,用一个for循环遍历整个文件夹,打印出每个相应的ipa文件。如下图所示,
2、具体shell 脚本实现
2.1、获取主工程的绝对路径
#工程绝对路径
cd $1
project_path=$(pwd)
2.2、创建build 文件夹
该文件夹的主要目的是存放在生成ipa以及过程的缓存文件
#创建ipa-build文件夹,先移除之前的文件夹
if [ -d ./ipa-build ];then
rm -rf ipa-build
fi
mkdir ipa-build
2.3、创建函数
首先该函数,要实现的功能是能够遍历该路径的下文件的目录和子目录文件。这个是实现自动替换的关键!
function systemConfig_path(){
for file in `ls $1`
do
if [ -d $1"/"$file ];then #目录文件
systemConfig_path $1"/"$file # 重新遍历子目录
else #非目录文件
dir=$1"/"$file
echo $dir
fi
done
}
#将要遍历文件夹路径传进去
systemConfig_path $project_path/../../doc/Config
2.4、在函数里面进行替换相应的资源
这里要注意的是,如果要替换主工程里面的配置文件信息,有两种方法:
1、直接拷贝工程里面的文件,将不同的渠道所需要的信息修改,而后再替换到主工程里面
2、将要修改的信息写一个txt文本,然后将这个文本信息替换到主工程。
个人推荐使用第二种方法,因为主工程里面的配置文件是在不断的实时更新,如果用第一种方法,每次打包都要去更新最新的配置文件,如果因为字段缺失,运行打包出来的ipa 会在某个时间段出现crash这种是很严重问题。因而第一种可操作性不强。第二种方法好处是只替换该渠道所需要的信息,不需要依赖主工程文件,这样降低了shell 脚本和主工程的耦合性,提升了代码的稳定性。
第一种方法:
dir=$1"/"$file
fileExtension="${file##*/}"
configPath=${project_path}/SystemConfig.h
if [ $fileExtension = SystemConfig.h ];then
cp -r $dir $configPath
fi
第二种方法:
if [ $fileExtension = SystemConfig.txt ];then
#获取text里面的信息
while read textLine
do
#将每一行的信息进行复制替换到SystemConfig.h 文件里面
header=$(echo "$textLine" |cut -f1 -d'&')
content=$(echo "$textLine" |cut -f2 -d'&')
while read line
do
line1="${line% *}"# 删除空格之后参数,注:%后面是空格
if [ "$line1" = "$header" ];then
#拼接成新的字段
newLine=${line1}${content}
sed -i "" "s/$line/$newLine/g" `grep $line -rl $configPath`
fi
done < $configPath #SystemConfig.h
done< $dir #SystemConfig.txt
对第二种方法稍加说明一下:
1、这里面有两个遍历循环,主遍历循环是获取txt里面每一行的信息textLine,通过'&'将textLine分割成header和content两部分(类似于iOS 的NSString 的对象方法componentsSeparatedByString:)用header 进行判断如果SystemConfig.h里面包含这个字段就可以进行替换。当子循环替换全部结束之后再进行第二字段替换,这样就可以做到全部替换。
2、对于shell 的sed -i "" "s/$line/$newLine/g" `grep $line -rl $configPath`注意事项:
sed 和grep 两者结合进行查找替换这两个大家应该很熟悉,这里要注意的是 "",由于iOS的内核是Unix ,因此在进行查找替换的时候,要求先进行备份存储。所以要是想存储备份在某个文件则写成".dat",不想存储直接写空""。
2.5 对于渠道值进行替换
channelplist_path=${project_path}/Info.plist
$(/usr/libexec/PlistBuddy -c "Set :chl $chlId" ${channelplist_path})
chlld 这个是外部传过来的渠道值。
2.6 对工程进行证书替换和签名
因为对于不同的渠道需要不同的证书,因此打包过程中需要进行签名,因此需要将相应的bundle id 证书,可执行文件传过来;我的做法是写在另外一个txt 文件里面。
build_cmd='xcodebuild'
build_cmd=${build_cmd}' -configuration 'Release
mobileprovision_uuid=`/usr/libexec/PlistBuddy -c "Print UUID" /dev/stdin <<< $(/usr/bin/security cms -D -i ${MOBILEPROVISION})`
#编译,签名
$build_cmd build CODE_SIGN_IDENTITY="${CERTIFICATE}" PROVISIONING_PROFILE="${mobileprovision_uuid}" PRODUCT_BUNDLE_IDENTIFIER="${BUNDLE_ID}" || exit
#运行打包
xcrun -sdk iphoneos PackageApplication -v ./${appdirname}/${build_scheme}.app -o ${build_path}/ipa-build/${ipa_name}.ipa || exit
1、对于编译里面的uuid 进行解释一下:
在ios developer 生成的证书里面,一般而言为了更好的区分可执行文件的名称,我们会重新命名例如叫fasdfasdfa.mobileprovision。但是fasdfasdfa这个并不是可执行文件的标识,一般要进行解析才能获得UUID,我们在装证书到mac里面的时候,双击其实已经解析了。因此可以用上述方法获取mobileprovision_uuid。ps:后期优化的时候考虑准备再写一个可以自动解析的函数方法。
要验证自己的解析出来的UUID是否正确,可以将UUID打印出来,然后和系统里面解析的对比,系统里有专门存放可执行文件路径:~/Library/MobileDevice/Provisioning Profiles。
2、CERTIFICATE 证书和BUNDLE_ID 两者必须要一一对应,否者无法打包成功。
3、对于在打包的时候是否要对编译的证书添加 --sign ${CERTIFICATE} --embed /embedded.mobileprovision就目前我自己实践而言是不需要添加的,百度搜索下来都是人云亦云,复制黏贴,如果有大神知晓请告知,谢谢!
好了,到目前为止替换打包的资源已经全部完成,在终端先进入doc 文件夹,然后输入执行运行即可。脚本指令是:
./ipa-build [project path] -c Distribution [-t <target name>] [-s <target name>] -n
由于里面涉及很多公司业务逻辑,相关信息已经抽离。只有整体架构,具体代码,我已经上传到github 上面,有兴趣的可以下载查看。如果不足之处,烦请指出!