xcode打包脚本

官方文档

准备

• 证书，配置文件无误
• 项目编译没有问题

命令行步骤

1. clean,保证不会出现些未知的错误

xcodebuild clean -workspace <workspace_path>  -scheme <app_scheme> -configuration <Debug Or Release>

// 实际操作：
xcodebuild clean -workspace /Users/wuzhihua/Desktop/Project/hiveconsumer/HiveConsumer/HiveConsumer.xcworkspace -scheme HiveConsumer -configuration Release

<workspace_path>：项目.xcworkspace的绝对路径

<app_scheme>: 项目App的scheme (非Extension App)

<Debug Or Release>： 编译环境，Debug Or Release

2. archive

xcodebuild archive -workspace <workspace_path> -scheme <app_scheme> -archivePath <xcarchive_path>

// 实际操作：
xcodebuild archive -workspace /Users/wuzhihua/Desktop/Project/hiveconsumer/HiveConsumer/HiveConsumer.xcworkspace -scheme HiveConsumer -archivePath /Users/wuzhihua/Desktop/App/archive/hiveconsumer.xcarchive

<xcarchive_path>： 导出achive文件路径

3. 配置导包

xcodebuild -exportArchive -archivePath <xcarchive_path> -exportPath <export_ipa_path> -exportOptionsPlist <exportOptionsPlist_path>

// 实际操作:
xcodebuild -exportArchive -archivePath /Users/wuzhihua/Desktop/App/archive/hiveconsumer.xcarchive -exportPath /Users/wuzhihua/Desktop/App/ipa/ -exportOptionsPlist /Users/wuzhihua/Desktop/App/fcapp_config.plist

<xcarchive_path>： 操作2中的achive文件路径

<export_ipa_path>： ipa文件导出路径

<exportOptionsPlist_path>：导包配置plist文件(需手动创建)

exportOptionsPlist配置

exportOptionsPlist配置文件为使用xcode导包的配置项

image

provisioningProfiles: Dictionary类型，App的bundle ID作为key，mobileprovision的文件名作为value，注意Extension APP的配置也要包括

method: String类型，决定导出包的类型，有 app-store, ad-hoc, package, enterprise, development, developer-id, and mac-application

teamID: String类型，开发者ID，可在keychain或者登录开发者网站�中查看

image

compileBitcode: Bool类型，必须与项目中的bitcode值一致，默认true

注意其他字段配置都有默认值，详情配置说明可通过官方文档或终端命令xcodebuild -help 查看

测试打包出现的问题

1.未配置compileBitcode字段的值，打包失败
compileBitcode字段的值必须与项目中Build Setting中的bitcode的值一致
2.测试通过ssh远程连接iMac终端执行脚本打包，出现code sign签名问题
远程连接没有keychain权限，打包前需执行以下命令

// 在Mac Sierra中在Keychains下面是没有Login.keychain的，新的名字被改成了Login.keychain-db.所以需要做一个软连接
ln -s ~/Library/Keychains/login.keychain-db ~/Library/Keychains/login.keychain
// 解锁权限
security unlock -p <password> /Users/<username>/Library/Keychains/login.keychain

若未使用Cocoapods （workspace）

将操作1和操作2中，-workspace更改成-project，<workspace_path>为项目中.xcodeproj绝对路径

脚本

#!/bin/bash
#Use:命令行进入目录直接执行sh APP_BUILD.sh即可完成打包安装

 echo "~~~~~~~~~~~~~~~~开始执行脚本~~~~~~~~~~~~~~~~"

 #-------------------------脚本配置信息--------------------------------------------
 #工程目录
 #BASE_PROJECT=$(dirname $1)
 BASE_PROJECT=$1

 #工程名称
 PROJECT_NAME="HiveConsumer"

 #编译模式 工程默认有 Debug Release
 CONFIGURATION_TARGET=Debug

 #编译路径
 BUILDPATH=~/Desktop/
 #导出ipa 所需plist
 ADHOCExportOptionsPlist=$(dirname ${BASE_PROJECT})/config/fcapp_config.plist

 #archivePath
 ARCHIVEPATH=${BUILDPATH}/App/hiveconsumer/${PROJECT_NAME}_$(date +%F-%T)/${PROJECT_NAME}.xcarchive
 IPAPATH=${BUILDPATH}/App/hiveconsumer/ipa_$(date +%F-%T)/
 #---------------------------------------------------------------------------------
 if [ ! -d ${BASE_PROJECT}/${PROJECT_NAME} ]; then
        echo ${BASE_PROJECT}/${PROJECT_NAME}"不存在!"
        exit 1
 else
        echo "工程目录--->>"${BASE_PROJECT}
        cd ${BASE_PROJECT}/${PROJECT_NAME}
 fi

 echo "~~~~~~~~~~~~~~~~开始清理~~~~~~~~~~~~~~~~~~~"
 # 清理 避免出现一些莫名的错误
 xcodebuild clean -workspace ${PROJECT_NAME}.xcworkspace -scheme ${PROJECT_NAME} -configuration ${CONFIGURATION_TARGET}

 echo "~~~~~~~~~~~~~~~~开始解锁~~~~~~~~~~~~~~~~~~~"
 #执行解锁命令
 ln -s ~/Library/Keychains/login.keychain-db ~/Library/Keychains/login.keychain
 security unlock -p <password> /Users/<username>/Library/Keychains/login.keychain

 echo "~~~~~~~~~~~~~~~~开始编译~~~~~~~~~~~~~~~~~~~"
 #开始构建
 #xcodebuild archive -workspace ${PROJECT_NAME}.xcworkspace \
 #-scheme ${TARGET_NAME} \
 #-archivePath ${ARCHIVEPATH} \

 xcodebuild archive -workspace ${PROJECT_NAME}.xcworkspace -scheme ${PROJECT_NAME} -archivePath ${ARCHIVEPATH} -configuration ${CONFIGURATION_TARGET}

 echo "~~~~~~~~~~~~~~~~检查是否编译成功~~~~~~~~~~~~~~~~~~~"
 # xcarchive 实际是一个文件夹不是一个文件,使用 -d 判断
 if [ -d "$ARCHIVEPATH" ]
 then
        echo "编译成功......"
 else
        echo "编译失败......"
        #rm -rf ${ARCHIVEPATH}
 exit 1
 fi
 endTime=`date +%s`
 ArchiveTime="构建编译时间$[ endTime - beginTime ]秒"

 echo "~~~~~~~~~~~~~~~~导出ipa~~~~~~~~~~~~~~~~~~~"

 beginTime=`date +%s`

 xcodebuild -exportArchive -archivePath ${ARCHIVEPATH} -exportPath ${IPAPATH} -exportOptionsPlist ${ADHOCExportOptionsPlist}

 echo "~~~~~~~~~~~~~~~~检查是否成功导出  ipa~~~~~~~~~~~~~~~~~~~"
 IPAPATH=${IPAPATH}/${PROJECT_NAME}.ipa
 if [ -f "$IPAPATH" ]
 then
         echo "导出ipa成功......"

 else
         echo "导出ipa失败......"
 # 结束时间
 endTime=`date +%s`
        echo "$ArchiveTime"
        echo "导出ipa时间$[ endTime - beginTime ]秒"
 exit 1
 fi

 echo "~~~~~~~~~~~~~~~~安装ipa到手机~~~~~~~~~~~~~~~~~~~"
 echo "~~~~~~~~~~~~~~~手机UDID:$(/usr/local/bin/idevice_id -l)"

/usr/local/bin/ideviceinstaller -i ${IPAPATH}

问题详情

image

因为 Xcode 9 默认不允许访问钥匙串的内容，必须要设置 allowProvisioningUpdates 才会允许，Jenkins的Xcode插件目前无法支持此项完成打包流程。

解决方案:将 Jenkins 项目里的 Xcode integration 构建步骤去掉，选择脚本构建步骤，配合ExportOptions.plist进行打包：

image

plist文件配置

1.可以参照下面步骤2的格式创建一个,或者先使用xcode9手动打包一次(一次就够了,只要获得这个文件即可)然后在导出的文件夹中找到以下文件:ExportOptions.plist

image

2. ExportOptions.plist详细配置如下:

image

3. 将plist文件拷贝到Jenkins的工作目录(其他目录也可以,但是尽量是一个不随便变动的路径)

4. 配置脚本

脚本配置

参考配置格式(一定记得替换脚本中的xcarchive文件、xcodeproj/xcworkspace文件、exportOptionsPlist文件和scheme的路径为你自己的路径,Debug看情况而定,如果要打ad-hoc的包记得切换为Release):

由于Jenkins的安装方式不同,工作空间的路径也会有所区别,以下脚本中的路径为通过pkg包的方式安装之后的路径,如果是通过war包安装的Jenkins,路径中的/Users/USERNAME/.jenkins需要替换为/Users/share/Jenkins/Home (只要你确保是Jenkins的工作路径即可)

注意:如果是 workspace 的项目，那就将第一段的命令中 -project /Users/USERNAME/.jenkins/workspace/PROJECT NAME/APPNAME.xcodeproj修改为 -workspace /Users/USERNAME/.jenkins/workspace/PROJECT NAME/APPNAME.xcworkspace 即可。
记得替换命令中的APPNAME,USERNAME,PROJECT NAME, SCHEMENAME 为自己项目的参数

xcodebuild -archivePath "/Users/USERNAME/.jenkins/workspace/APPNAME/build/Debug-iphoneos/APPNAME.xcarchive" -project /Users/USERNAME/.jenkins/workspace/PROJECT NAME/APPNAME.xcodeproj -sdk iphoneos -scheme "SCHEMENAME" -configuration "Debug" archive

xcodebuild -exportArchive -archivePath "/Users/USERNAME/.jenkins/workspace/APPNAME/build/Debug-iphoneos/APPNAME.xcarchive" -exportPath "/Users/USERNAME/.jenkins/workspace/APPNAME/build/APPNAME_debug" -exportOptionsPlist '/Users/USERNAME/.jenkins/workspace/APPNAME/build/ExportOptions.plist' -allowProvisioningUpdates

https://www.jianshu.com/p/8b3d6b0d71e2
http://www.cocoachina.com/cms/wap.php?action=article&id=20803
链接：https://www.jianshu.com/p/eace84c1b990