Mac上实现iOS自动化打包和分发

起初想法:

基于公司原有的Jenkins服务的基础上,最近在公司自动化打包的时,遇到一个尴尬的问题?为什么不能直接通过Jenkins直接打包出来不同类型的ipa(常见的ad-hoc、enterprise、development、app store)?
1、公司之前同事集成的只能支持development
2、通过深入查看,对.xcodeproj和.xcworkspace 的兼容性也不是很好。

直入正题:

一、需要的环境

1、Jenkins

版本信息:Jenkins ver. 2.5
不要问我是什么,可以直接问题“度娘”、“Google” 也行。因为我是基于公司已有的环境,这里对于安装过程自行百度。需要注意一点,既然是一个服务,建议安装到新的电脑上,独立操作。有一段时间在自己开发的电脑上折腾了一个node,后面由于内存不够,已弃疗。。。

2、Xcode

Version 8.3.2

3、蒲公英

官网
主要参考使用 Jenkins 实现持续集成 (iOS)

二、支持的功能

1、不同类型的ipa enterprise、development
2、兼容性.xcodeproj、.xcworkspace
3、解决证书导入问题(新的工程无须每次都去装有Jenkins的电脑上导入证书)

三、命令行介绍及使用

1、xcodebuild

使用 xcodebuild -h 来看看 xcodebuild 到底是干啥的

Usage: xcodebuild [-project <projectname>] [[-target <targetname>]...|-alltargets] [-configuration <configurationname>] [-arch <architecture>]... [-sdk [<sdkname>|<sdkpath>]] [-showBuildSettings] [<buildsetting>=<value>]... [<buildaction>]... xcodebuild [-project <projectname>] -scheme <schemeName> [-destination <destinationspecifier>]... [-configuration <configurationname>] [-arch <architecture>]... [-sdk [<sdkname>|<sdkpath>]] [-showBuildSettings] [<buildsetting>=<value>]... [<buildaction>]... xcodebuild -workspace <workspacename> -scheme <schemeName> [-destination <destinationspecifier>]... [-configuration <configurationname>] [-arch <architecture>]... [-sdk [<sdkname>|<sdkpath>]] [-showBuildSettings] [<buildsetting>=<value>]... [<buildaction>]... xcodebuild -version [-sdk [<sdkfullpath>|<sdkname>] [<infoitem>] ] xcodebuild -list [[-project <projectname>]|[-workspace <workspacename>]] [-json] xcodebuild -showsdks xcodebuild -exportArchive -archivePath <xcarchivepath> -exportPath <destinationpath> -exportOptionsPlist <plistpath> xcodebuild -exportLocalizations -localizationPath <path> -project <projectname> [-exportLanguage <targetlanguage>...] xcodebuild -importLocalizations -localizationPath <path> -project <projectname>

备注:这里我只截取了 usage 部分,option 部分太多没有截取。

主要介绍常用到的命令:

2、xcodebuild -project ...

未加入cocoa pods
方案一:编译生成build文件夹
xcodebuild -project testApp.xcodeproj -target testApp -configuration Release
方案二:
编译生成xcarchive
xcodebuild archive -project testApp.xcodeproj -scheme testApp -configuration Release -archivePath testApp.xcarchive

3、xcodebuild -workspace ...

已加入cocoa pods
方案一:
编译未生成build文件夹
xcodebuild archive -workspace testApp.xcworkspace -scheme testApp -archivePath testApp.xcarchive
方案二:编译生成xcarchive
xcodebuild archive -workspace testApp.xcworkspace -scheme testApp -archivePath testApp.xcarchive

4、xcrun -sdk iphoneos -v PackageApplication ...

生成ipa
xcrun -sdk iphoneos -v PackageApplication ./build/Release-iphoneos/testApp.app -o ~/Desktop/testApp.ipa

主要与 未加入cocoa pods 方案一联合使用。

但是,在 macos10.12 和 Xcode8 的环境下会出现一个警告warning: PackageApplication is deprecated, use xcodebuild -exportArchive instead.
说明 PackageApplication 已经被弃用了。
不过其实这一步可以几乎等价于将 xx.app 放入一个 payload 的文件夹下然后压缩文件夹为 xx.ipa,当然这样做缺失一些信息,不过并不影响程序的运行。

5、xcodebuild -exportArchive ...

生成ipa
xcodebuild -exportArchive -archivePath testApp.xcarchive -exportPath . -exportOptionsPlist ~/Downloads/build.plist

主要与 未加入cocoa pods 方案二已加入cocoa pods 方案二联合使用。


总结:以上是两种工程类型的两种命令行操作的例子,其中testApp
为工程名,build.plist
主要用于输出不同的打包类型。其他参数或关键字见官方文档说明。

build.plist内容

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>method</key>
<string>enterprise</string>
<key>compileBitcode</key>
<false/>
</dict>
</plist>

build.plist中enterprise可替换成为ad-hoc、enterprise、development、app store,目的用于输出不同类型的包。当然这个和证书有关,后续会有描述。

操作方法:通过命令行方式进入与.xcodeproj(.xcworkspace)文件同级目录,输入以上代码即可实现命令行打包。

四、脚本代码

以下是通过shell脚本方式实现

  #!/bin/bash
  
  echo "ios build"
  token="842d5082c885df71a1a99ce4fd352cb5" #fir token,对应fir账号
  
  function func_log_print(){
      local level="$1"
      local msg="$2"
  
      case $level in
              error)  echo -e "${msg} ";;
              warn)   echo -e "${msg} ";;
              info)   echo -e "${msg} ";;
              concern)        echo -e "${msg} ";;
              *)              echo "${msg}";;
      esac
  }
  
  function func_ios_build(){
  
      #build.plist路径
      exportOptionsPlistPath=/Users/jenkins/jenkins/shell/build.plist
  
      #打包类型选择
      sed -i "" "s/enterprise/${pack_method}/g" $exportOptionsPlistPath
      sed -i "" "s/ad-hoc/${pack_method}/g" $exportOptionsPlistPath
      sed -i "" "s/development/${pack_method}/g" $exportOptionsPlistPath
      sed -i "" "s/app-store/${pack_method}/g" $exportOptionsPlistPath
  
      #更新license.lic文件
      if [ -f ../license_local_mid.lic ];then
          mv ../license_local_mid.lic ./license_local_mid.lic
      fi
  
      local local_path=$1
      JOB_NAME=`echo $JOB_NAME|cut -d "-" -f 1`
      echo "###############BUILD_TYPE############"
      echo "               $BUILD_TYPE            "   
  
      cd "$local_path"
      func_log_print "info" "[+] `date +'%H:%M:%S'` info(@$LINENO): 第一步:构建"
  
      if [ -z $SCHEME ];then
          SCHEME=${JOB_NAME}
      fi
  
      #输出xcarchive路径
      outArchivePath=./${BUILD_TYPE}-iphoneos/${SCHEME}.xcarchive
      #输出ipa路径
      outIPAPath=./${BUILD_TYPE}-iphoneos/
      outIPAPathFile=${outIPAPath}/${SCHEME}.ipa
  
  
      #编译成xcarchive
      if [ -e *.xcworkspace ];then
          xcodebuild archive -workspace ${SCHEME}.xcworkspace -scheme ${SCHEME} -configuration ${BUILD_TYPE} -archivePath ${outArchivePath}
          #-archivePath testApp.xcarchive
      else
          xcodebuild archive -project ${SCHEME}.xcodeproj -scheme ${SCHEME} -configuration ${BUILD_TYPE} -archivePath ${outArchivePath}
      fi
  
  
      #打印log
      func_log_print "info" "[+] `date +'%H:%M:%S'` info(@$LINENO):xcodebuild -configuration ${BUILD_TYPE} -scheme $SCHEME clean build SYMROOT=$JOB_NAME" 
  
  
      if [ -e ${outArchivePath} ];then
          func_log_print "info" "[+] `date +'%H:%M:%S'` info(@$LINENO): 第二步:打包分发"
        
          if [ ! -e ${outIPAPathFile} ];then
           rm -rf ${outIPAPathFile} #删除老的ipa
          else
              func_log_print "info" "[+] `date +'%H:%M:%S'` info(@$LINENO):${outIPAPathFile} 老IPA不存在"
          fi
        
          #签名后输出ipa
          xcodebuild -exportArchive -archivePath ${outArchivePath} -exportPath ${outIPAPath} -exportOptionsPlist ${exportOptionsPlistPath} 
  
        func_log_print "info" "[+] `date +'%H:%M:%S'` info(@$LINENO): xcodebuild -exportArchive -archivePath ${outArchivePath} -exportPath ${outIPAPath} -exportOptionsPlist ${exportOptionsPlistPath}"
  
  
          if [ -e ${outIPAPathFile} ];then
              func_log_print "info" "[+] `date +'%H:%M:%S'` info(@$LINENO): ipa 生成成功!"
            #while [ -z $download_url ]
            #do
              #ipa=`pwd`/${JOB_NAME}.ipa
              #func_log_print "error" "[+] `date +'%H:%M:%S'` debug(@$LINENO):ipa path:$ipa"
            #download_url=`/Users/XWH/.rvm/gems/ruby-2.3.2/bin/fir publish -Q -T $token $ipa | grep http | cut -d ":" -f 5-`
            json=`curl -F "file=@${outIPAPathFile}" -F "uKey=eeb24ba7660ab63bbc4e3bc094cce3ae" -F "_api_key=50bd1341957a052a280cbf4a4a2f0546" -F "password=sensetime" -F "updateDescription=${DESCRIPTION}" https://www.pgyer.com/apiv1/app/upload`
  
            result_code=`echo $json | /usr/local/bin/jq ".code"`
            
              if [[ $result_code = "0" ]];then
                download_url=`echo $json | /usr/local/bin/jq ".data" | /usr/local/bin/jq ".appShortcutUrl"`
                download_url=`echo "https://www.pgyer.com/$download_url" | tr -d '"'`
            else
                echo $json | /usr/local/bin/jq ".message"
                exit 1 
            fi
        else
           func_log_print "error" "[+] `date +'%H:%M:%S'` error(@$LINENO):IOS Build(xcodebuild -exportArchive): 生成ipa失败!"
           exit 1
          fi
      else
        func_log_print "error" "[+] `date +'%H:%M:%S'` error(@$LINENO):IOS Build(xcodebuild archive -project): 生成archive失败!"
        exit 1
      fi
  
      func_log_print "concern" "####################################"
      func_log_print "concern"
      func_log_print "concern" "ios自动打包成功,下载链接为:"
      func_log_print "concern"  "${download_url}"
      func_log_print "concern"   #密码为:sensetime
      func_log_print "concern"
      func_log_print "concern" "####################################"
      func_log_print "concern"
      echo $download_url
      exit 0
  }
  
  func_ios_build $1 

五、踩的坑

1、由于涉及到描述文件、证书替换问题,Jenkins界面操作如下(方便用户操作):


Jenkins界面操作.png

则需要在Jenkins 项目仓库的配置中作如下操作:
(1)、主要用于参数输入的配置

参数输入的配置.png

(2)、主要用对输入后的文件进行更名操作,方便Xcode自动读取配置文件


文件进行更名操作.png

代码如下:

>  if [ ! -d ../iOSSTLibrary ];then
    mkdir ../iOSSTLibrary
  fi
  if [ ! -d ../CVFaceSDK ];then
    mkdir ../CVFaceSDK
  fi
  
  if [ -e "/Users/jenkins/Library/MobileDevice/Provisioning Profiles/distribution" ];then
    distributionFile="/Users/jenkins/Library/MobileDevice/Provisioning Profiles/distribution"
    mobileprovision_uuid=`/usr/libexec/PlistBuddy -c "Print UUID" /dev/stdin <<< $(/usr/bin/security cms -D -i "${distributionFile}" )`
    echo "UUID is:"
    echo ${mobileprovision_uuid}
    
      mv "${distributionFile}" "/Users/jenkins/Library/MobileDevice/Provisioning Profiles/${mobileprovision_uuid}.mobileprovision"
  fi
  
  if [ -e "/Users/jenkins/Library/MobileDevice/Provisioning Profiles/development" ];then
    developmentFile="/Users/jenkins/Library/MobileDevice/Provisioning Profiles/development"
    mobileprovision_uuid=`/usr/libexec/PlistBuddy -c "Print UUID" /dev/stdin <<< $(/usr/bin/security cms -D -i "${developmentFile}" )`
    echo "UUID is:"
    echo ${mobileprovision_uuid}
      
    mv "${developmentFile}" "/Users/jenkins/Library/MobileDevice/Provisioning Profiles/${mobileprovision_uuid}.mobileprovision"
 fi

2、涉及用shell 脚本替换文件中的内容,此处需要注意
正常操作: sed -i "" "s/enterprise/${pack_method}/g" $exportOptionsPlistPath

与Linux unix中的操作不一样
sed -i "s/enterprise/${pack_method}/g" $exportOptionsPlistPath

3、获取iOS .mobileprovision文件中的UUID查看mobileprovision命令行:security cms -D -I testApp.mobileprovision
参考:命令行获取mobileprovision文件的UUID

六、暂时不能有点疑问的地方

通过以上获知,若项目首次打包需要提供两个.mobileprovision文件(开发、发布)发布可以直接通过苹果开发者官网生成得出。但是在Xcode8以后开发证书自动获取,通过查找没有合适的、比较科学的方式获取此证书。目前比较简单、粗暴的方式获取:删除/Users/XWH/Library/MobileDevice/Provisioning Profiles
目录下的所有文件,通过xcode自动生成获取。

以上就是对于iOS 通过Jenkins自动化打包留下的经历!!!

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,126评论 6 481
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,254评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 152,445评论 0 341
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,185评论 1 278
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,178评论 5 371
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,970评论 1 284
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,276评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,927评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,400评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,883评论 2 323
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,997评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,646评论 4 322
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,213评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,204评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,423评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,423评论 2 352
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,722评论 2 345

推荐阅读更多精彩内容