起初想法：

基于公司原有的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自動化打包留下的經歷！！！