Jenkins与IOS

一、简介

简单记录下IOS利用Jenkins进行自动打包。Jenkins，你可以认为是一个自动化工具，通过简单的界面配置来代替shell语法。迫不得已的时候才需要加入自己的shell脚本。

这里，我使用Jenkins来打包IOS app。需要的步骤：
1、从github拉取对应的IOS项目的代码
2、进行编译
3、生成ipa文件
以上的步骤全都可以通过shell脚本实现。为了更加方便，我这里通过Jenkins来进行自动化操作。

二、Jenkins自动化打包

安装Jenkins的话，百度很多资料。
然后通过Jenkins的自动化打包这部分，百度很多文章说的不好，有点笼统，而且很多还是无效的。经过我几天的探索，我决定重新整理一份。

1、要打包IOS软件，肯定需要配置证书和描述文件。在Jenkins上怎么配置呢？
证书配置
Manage Jenkins->Keychains and Provisioning Profiles Management(这个没找到，就去安装这个插件)
配置：Keychains
这里是配置证书，需要使用login.keychain
~/Library/Keychains/ 可以获取到。把Keychains目录拷贝到/Users/Shared/Jenkins/Library/Keychains。
上传login.keychain到Jenkins中，如下图：

1.png
Code Signing Identity：手动拷贝项目用到的证书的名字，可以在mac的钥匙串访问中拷贝。login.keychain包含了证书的具体内容，所以这里直接通过证书名字进行匹配。

Provisioning Profiles的配置
Provisioning Profiles Directory Path：按照上面的填，目的是为了配置拷贝后的位置，就是会在这个目录下有上传的描述文件的拷贝。

开始配置具体的项目
1、选择FreeStyle Project
2、进入配置项
- Genaral（不需要配置）

屏幕快照 2019-09-23 下午7.41.35.png

- 源码管理

屏幕快照 2019-09-23 下午7.40.29.png
这里就是设置github项目的地址。这里可能会报错
Jenkins stderr: xcrun: error: unable to exec Xcode native xcrun
这种就是没选对Xcode导致的，解决办法：
（1）方法一
sudo xcode-select --reset（这种是网上说的解法），这样确实可以暂时解决。但到后面编译的时候可能还会有问题。
（2）方法二
如果你的xcode也是像我一样不是安装在Application目录的，后面执行xcodebuild会报错。最好的解决办法是，把Xcode移到Application下，然后选址这个Xcode：
sudo xcode-select -s /Applications/Xcode.app
看是否设置成功，可以查看设置后的路径：
xcode-select --print-path

- 3、构造触发器（不需要设置）
这里我们手动触发就可以了

- 4、构建环境
网上很多是在这里配置描述文件和证书。其实也是不需要配置的

- 5、构建
（1）方法一、选择Xcode进行构建
1). General build settings：

屏幕快照 2019-09-23 下午7.52.33.png
屏幕快照 2019-09-23 下午7.52.56.png

这里只展示必要配置的选项：
Xcode Schema File：项目名称
Development Team ID：teamID，Xcode中可以看到，是根据这个来匹配证书的
Export method：打包时候看到的 development ,ad-hoc等
ipa filename pattern：生成的ipa的名字，可以使用它提示的变量来生成动态的名字

2).Code signing & OS X keychain options
配置证书和描述文件了

屏幕快照 2019-09-23 下午8.00.25.png
我选了手动配置
这里好像只配置了Provisioning文件，但没配置证书，其实证书是在上面配置TeamID时候，自动动态去之前的证书配置那里进行匹配了。

到这里，基本就算配置完成了。然后保存，进行构建就可以了。出问题的话，去看看打印的日志，对应着解决。

方法二、使用shell脚本进行构建
下面是我的脚本：

export PATH=$PATH:/usr/local/bin

APPNAME=myJenkinsTest
#### local config
## 切换到项目路径
#cd "$(dirname "$0")"/../../..
#
## 初始化项目路径和到处文件的路径
#WORKSPACE=$(pwd)
#APPNAME=BatteryCam
#EXPORT_TAR=$(echo ~)/Desktop/EufySecurity_Export

#### local config end

#### jenkins config
EXPORT_TAR=$WORKSPACE/export
#### jenkins config end




#####  初始化开始
PROJECT_PATH=$WORKSPACE/
cd $PROJECT_PATH

echo $PROJECT_PATH

# info.plist路径
InfoPlistPath=./${APPNAME}/Info.plist
echo ${InfoPlistPath}
#取版本号
bundleShortVersion=$(/usr/libexec/PlistBuddy -c "print CFBundleShortVersionString" ${InfoPlistPath})
#bundleShortVersion=1.0
#取build值
bundleVersion=$(/usr/libexec/PlistBuddy -c "print CFBundleVersion" ${InfoPlistPath})
#bundleVersion=100
#日期（到哪一天）
DATE_DAY="$(date +%Y-%m-%d)"
#日期（到秒）
DATE="$(date +%Y-%m-%d_%H_%M_%S)"

EXPORT_DIR=$EXPORT_TAR/${DATE_DAY}/${bundleShortVersion}_${bundleVersion}/${DATE}
mkdir -p ${EXPORT_DIR}

#####  初始化结束



######   archive
ARCHIVE_PATH=${EXPORT_DIR}/${APPNAME}
ARCHIVE_FILE=${ARCHIVE_PATH}.xcarchive
ARCHIVE_FILE_CONFIG_PLIST_PATH=${ARCHIVE_FILE}/Products/Applications/${APPNAME}.app/APPConfig.plist
ARCHIVE_FILE_INFO_PLIST_PATH=${ARCHIVE_FILE}/Products/Applications/${APPNAME}.app/Info.plist

xcodebuild -target ${APPNAME}.xcworkspace -scheme ${APPNAME} -archivePath ${ARCHIVE_PATH}  clean archive

#####打包成为哦ipa
IPA_PATH=${ARCHIVE_PATH}/app
IPA_FILE=${IPA_PATH}/${APPNAME}.ipa
Export_OptionsPlist=./${APPNAME}/ExportOptions.plist

echo '生成ipa文件'
xcodebuild -exportArchive -archivePath ${ARCHIVE_FILE} -exportPath ${IPA_PATH} -exportOptionsPlist ${Export_OptionsPlist}

最后生成ipa文件的时候，需要一个plist文件来配置描述文件，证书，teamID，method等参数：

<?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>compileBitcode</key>
    <false/>
    <key>method</key>
    <string>development</string>
    <key>provisioningProfiles</key>
    <dict>
        <key>Bundle ID</key>
        <string>Priovisioning Profile名字</string>
    </dict>
    <key>signingCertificate</key>
    <string>证书名字</string>
    <key>signingStyle</key>
    <string>manual</string>
    <key>teamID</key>
    <string>teamID号</string>
</dict>
</plist>

配置与构建

屏幕快照 2019-09-23 下午8.12.43.png

控制台

屏幕快照 2019-09-23 下午8.13.16.png