iOS后台开发专题一起学起来

macOS Jenkins安装&配置

2017-03-01  本文已影响11411人  知德

一、依赖环境

1. JavaSDK（Java SE Development Kit）

在终端命令行输入java -version命令，如果打印出java版本，则代表已安装，可以略过此步骤。
如果没有安装过，进入JavaSDK官网，接受协议，选择 & 下载对应系统的 安装包

下载完成，点击安装，安装完成再次在终端中执行上面的命令，可以看到已安装JavaSDK的版本

2. Apache

Mac系统自带，略过

二、安装Jenkins

1. 下载安装Jenkins

方法有多种，暂以下载dmg客户端为例
进入Jenkins官网，下载最新版本的Jenkins客户端

双击下载好的dmg文件进行安装，其将会自动生成全局变量jenkins
Jenkins默认安装路径：/Applications/Jenkins/jenkins.war
（如果下载.war格式文件，将文件复制到欲安装文件夹即可）
修改参数： jenkins + 相关参数，如
jenkins –httpPort=8888#更换端口号，当默认端口8080被占用，或指定特定端口时。

2. 启动Jenkins

如果是使用dmg文件安装的，安装完成之后，会自动启动jenkins，打开浏览器，进入网页 localhost:8080

终端命令

设置开机自启动：sudo launchctl load -w /Library/LaunchDaemons/org.jenkins-ci.plist
取消开机自启动：sudo launchctl unload -w /Library/LaunchDaemons/org.jenkins-ci.plist
手动启动：Java -jar jenkins.war
后台启动(默认端口)：nohup java -jar jenkins.war &
后台启动(指定端口)：nohup java -jar jenkins.war -httpPort=88 &
后台启动(HTTPS)：nohup java -jar jenkins.war -httpsPort=88 &

注：可能出现连接不到服务器的问题，原因就是Java环境有问题，重新配置Java环境即可。

三、配置Jenkins

1、重启电脑

重启电脑之后，你会发现Jenkins给你的电脑新增了一个用户，名字就叫Jenkins
打开localhost:8080，出现Unlock Jenkins(重设初始密码)界面
密码在/Users/userName/.jenkins/secrets/initialAdminPassword**文件(下图标注红色路径)中，打开文件，复制密码填到网页密码输入框中，继续

选择建议安装设置


安装中


等待Jenkins重启完成


创建管理员账号：输入用户名、密码、邮件等


创建完，进入Jenkins初始界面


2、管理插件

选择“系统管理”——“管理插件”，进入插件管理界面（可以安装、更新、卸载jenkins插件）

注：打√号的建议安装，? 号按系统和编辑器安装，其他 选择安装

3、系统设置

选择“系统管理”——“系统设置”，进入系统设置界面（可以管理全局属性、配置邮件通知）
全局属性下面，勾选Environment variables，增加一对键值对：

4、新建项目

点击“新建”或者“创建一个新任务”


输入新项目名称，选“新建一个自由风格的软件项目”


点击新建好的项目（第一次可能不需要吧，给忘记了，反正下一步是配置）


5、配置项目

点击“配置”


进入配置界面，配置项目参数

A. General配置

注：这里可以设置包（构建）的保留天数和保留的最大个数

B. 源码管理

由于现在我用到的是GitLab，先配置SSH Key

创建SSH证书：

添加SSH证书：

配置SSH也可以参考配置Git代码仓库

然后在“Credentials”处选择刚添加的那个SSH配置。
如果配置正确的话，是不会出现下图中的那段红色的警告。如果有下图的提示，就说明Jenkins还没有连通GitLab或者SVN，那就请再检查SSH Key是否配置正确。


C. 构建触发器

构建触发器设置这里是设置自动化测试的地方。这里涉及的内容很多，暂时没有深入研究，有自动化测试需求的可以好好研究研究这里的设置。

格式如下

分钟(0-59) 小时(0-23) 日期(1-31) 月(1-12) 周几(0-7,0和7都是周日) * 代表全部

D. 构建环境

iOS打包需要签名文件和证书，所以这部分我们勾选“Keychains and Code Signing Identities”。
这里我们又需要用到Jenkins的插件，在系统管理页面，选择“Keychains and Provisioning Profiles Management”。

进入Keychains and Provisioning Profiles Management页面，点击“浏览”按钮，分别上传自己的keychain和证书。上传成功后，我们再为keychain指明签名文件的名称。

点击“Add Code Signing Identity”，最后添加成功后如下图所示：


这样Adhoc证书和签名文件就在Jenkins中配置好了，接下来我们只需要在item设置中指定相关文件即可。

回到我们新建的item，找到构建环境，按下图选好自己的相关证书和签名文件。

E. 构建
①增加构建步骤：Execute shell

作用：改变项目中的build号

#---------------进入项目工程根目录----------------------------
cd $HOME/Home/workspace/${JOB_NAME}/xxx(工程名)
#---------------auto change versionNumber------------------
#/usr/bin/xcrun agvtool next-marketing-version -all
#---------------auto change buildNumber--------------------
/usr/bin/xcrun agvtool new-version -all $BUILD_NUMBER
②增加构建步骤：Execute shell

作用：打包，导出IPA
最好在xcode中设置scheme为shared，否则可能出现工程无scheme的错误

# 工程名
APP_NAME="xxx"  #替换成你的工程名
# 证书
CODE_SIGN_DISTRIBUTION="iPhone Distribution: xxx Co., Ltd. (xxxxxx)"  # 打包所用签名证书
# info.plist路径
project_infoplist_path="$HOME/Home/workspace/${JOB_NAME}/${APP_NAME}/${APP_NAME}/Info.plist"
#取版本号
bundleShortVersion=$(/usr/libexec/PlistBuddy -c "print CFBundleShortVersionString" "${project_infoplist_path}")
#获取日期
#DATE="$(date +%Y%m%d)"
ADHOC_PLIST_PATH="xxx/xxx/adhoc.plist"
#要上传的ipa文件路径
IPA_PATH="$HOME/Home/output/${JOB_NAME}/${bundleShortVersion}(${BUILD_ID})"
#创建IPA路径文件夹
mkdir $IPA_PATH
#archive文件路径
ARCHIVE_PATH="${IPA_PATH}/${APP_NAME}_${BUILD_ID}.xcarchive"

#进入工程目录
cd $HOME/Home/workspace/${JOB_NAME}/${APP_NAME}
# xcodebuild -list命令可以查看 工程的：Targets、Configurations、Schemes

echo "=================清理工程================="
xcodebuild clean -target "${APP_NAME}" -configuration 'Release'

echo "=================解锁钥匙串================="
#解决：codesign"seckey api returned: -25308,(null)"
# *** 是一般为电脑登录密码
security unlock-keychain -p "***" "${HOME}/Library/Keychains/login.keychain"

echo "=================生成xcarchive文件================="
# 在xcode中设置scheme为shared，否则可能出现工程无scheme的错误
# 还可以添加其他参数，不设置的都是默认使用项目Build Settings里面的配置，包括 CODE_SIGN_IDENTITY 和 PROVISIONING_PROFILE
xcodebuild archive -project "${APP_NAME}.xcodeproj" -scheme "${APP_NAME}" -sdk iphoneos -configuration "Release" -archivePath "${ARCHIVE_PATH}"

echo "=================打包IPA================="
xcodebuild -exportArchive -archivePath "${ARCHIVE_PATH}" -exportPath "${IPA_PATH}" -exportOptionsPlist "${ADHOC_PLIST_PATH}"

adhoc.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>ad-hoc</string>
        <key>compileBitcode</key>
        <false/>
    </dict>
</plist>
F、构建后操作

增加构建后操作步骤：Execute a set of scripts
建议勾选 Execute script only if build succeeds 只有构建成功，才执行构建后命令
Build steps => Execute shell

# 解决中文乱码问题
export LANG="zh_CN.UTF-8" #zh_CN.UTF-8  en_US.UTF-8
# 解决 fir: command not found 问题（前提：安装fir命令行工具 - gem install fir（再前提：安装了ruby环境））
# /usr/local/bin/:  为fir工具安装路径（安装完成fir时会有打印出来）
export PATH="/usr/local/bin/:$PATH"

APP_NAME="xxx"
# info.plist路径
project_infoplist_path="$HOME/Home/workspace/${JOB_NAME}/${APP_NAME}/${APP_NAME}/Info.plist"
#取版本号
bundleShortVersion=$(/usr/libexec/PlistBuddy -c "print CFBundleShortVersionString" "${project_infoplist_path}")

cd $HOME/Home/workspace/${JOB_NAME}

log=`git show -s --format=%B $GIT_COMMIT`

cd "$HOME/Home/output/${JOB_NAME}/${bundleShortVersion}(${BUILD_ID})"

fileName=`find . -name "${APP_NAME}.ipa"`

# 上传IPA到fir平台
fir p "$fileName" -c ${log} -Q -m "./${APP_NAME}_${BUILD_ID}.xcarchive/dSYMs/工程名.app.dSYM/Contents/Resources/DWARF/工程名" -P <bughd project id> -T <fir token>

# 设置上传fir返回二维码图片名称为qrcode.png
mv "./fir-${$APP_NAME}.png" "./qrcode.png"

# 设置构建版本描述信息为二维码，扫码可下载该构建版本
# 此设置无效，错误信息如下：
# [WARN] Failed to authenticate with your SSH keys. Proceeding as anonymous
# ERROR: No such job 'DESCRIPTION=<p>扫码下载xxx(xx)</p><img src=./qrcode.png>'
# java -jar ${HOME}/Home/jenkins-cli.jar -s http://localhost:8080/ set-build-description DESCRIPTION="<p>扫码下载${bundleShortVersion}(${BUILD_ID})</p><img src=./qrcode.png>"

解决 fir: command not found 问题

配置set build description 可以使用 HTML标签
设置如下：

  1. Jenkins -> 系统管理 -> Configure Global Security
  2. Markup Formatter 选择 "Safe HTML"

解决Unable to access jarfile jenkins-cli.jar 问题

注意：小心大坑，在Jenkins HOME目录下新建文件(夹)，权限要更改，否则会出现权限问题（Operation denied）

上一篇下一篇

猜你喜欢

热点阅读