一、Jenkins简介
作为可扩展的自动化服务器，Jenkins 可以用作简单的 持续集成（CI）服务器，或者变成任何项目的持续交付（CD）中心。它的特点如下：
- 简易安装 Jenkins 是一个基于 Java 的独立程序，可以立即运行，包含 Windows、Mac OS X 和其他类 Unix 操作系统。
- 配置简单 Jenkins 可以通过其网页界面轻松设置和配置，其中包括即时错误检查和内置帮助。
- 插件 通过更新中心中的 1000 多个插件，Jenkins 集成了持续集成和持续交付工具链中几乎所有的工具。
- 扩展 Jenkins 可以通过其插件架构进行扩展，从而为 Jenkins 可以做的事提供几乎无限的可能性。
- 分布式 Jenkins 可以轻松地在多台机器上分配工作，帮助更快速地跨多个平台推动构建、测试和部署。
二、安装Jenkins
由于Jenkins 依赖于Java，所以在安装Jenkins前，需要先检查是否已安装Java环境。在终端输入命令进行检测：
java -version
若没有java环境前往官网下载安装即可:
Jenkins安装方式有两种：
安装包方式：前往Jenkins官网下载.pkg安装包进行安装即可。
Homebrew命令行方式：请确保已安装Homebrew，如未安装可去Homebrew官网，复制命令一键安装 Jenkins安装命令：
brew install jenkins //推荐使用这种方式安装。
安装结束后，在终端输入命令：
jenkins
启动服务，即可在浏览器中输入http://localhost:8080中进行访问，如下图：
依照图中描述在终端输入 cat + 密码路径，获取密码复制下一步。
cat /Users/fsbm/.jenkins/secrets/initialAdminPassword
选择推荐安装的插件进行安装：
等待插件安装完成：
配置完管理员账户：
三、配置插件
成功安装后，接下来要配置Unity，xcode构建的所需环境等，需要安装的插件有：
| 插件 | 作用 |
|---|---|
| SVN | 源码管理工具（如果使用git请忽略） |
| Unity3D Plugin | Unity 运行Unity Editor 编辑器 |
| Xcode integration Version | 构建xcode项目，调用agvtool和包。ipa文件的构建器 |
| Publish Over SSH Version | 通过SSH发送编译包到服务器 |
安装步骤：
- 点击管理Jenkins；
- 点击插件管理；
- 点击可用插件；
- 点击搜索
-
点击下载并安装。
选择管理插件
四、新建任务
点击 Jenkins首页 > 新建Item。输入任务名称并选中自由风格工程，下一步。
在通用选项里可进行一些描述信息填写和构建包丢弃计划（非必要设置），如图：
五、配置SVN
- 填写Repository URL，即项目的SVN路径；
- 添加凭证，SVN的账户和密码；
- 选择刚才添加好的凭证；
- 点击保存；
- 点击现在构建；
- 点击正在构建的项目可以查看构建进度和日志；
等到构建完成，打开工作空间，发现你的项目已经被克隆下来了。
六、配置Unity
-
配置Unity编辑器路径；
配置Unity编辑
2. 编写Unity打包脚本，在Unity工程中新建脚本，命名为：BuildProject.cs,放在Editor 文件夹中，脚本内容如下：
using UnityEditor;
using System.IO;
using System.Collections;
using UnityEngine;
using System.Collections.Generic;
class PerformBuild
{
static string[] GetBuildScenes()
{
List<string> names = new List<string>();
foreach (EditorBuildSettingsScene e in EditorBuildSettings.scenes)
{
if (e == null)
continue;
if (e.enabled)
names.Add(e.path);
}
return names.ToArray();
}
static string GetBuildPath()
{
return "Build/Build_ios";
}
[MenuItem("XRL/Build")]
static void CommandLineBuild()
{
Debug.Log("Command line build\n------------------\n------------------");
string[] scenes = GetBuildScenes();
string path = GetBuildPath();
if (scenes == null || scenes.Length == 0 || path == null)
//return;
Debug.Log(string.Format("Path: \"{0}\"", path));
for (int i = 0; i < scenes.Length; ++i)
{
Debug.Log(string.Format("Scene[{0}]: \"{1}\"", i, scenes[i]));
}
Debug.Log("Starting Build!");
BuildPipeline.BuildPlayer(scenes, path, BuildTarget.iOS, BuildOptions.None);
}
static string GetBuildPathAndroid()
{
return "Bulid/android";
}
}
- 配置编译命令
- 选中当前项目；
- 点击添加编译步骤，选择调用Unity编辑器
- 选择上一步配置好的Unity编辑器
- 输入编译命令
-quit -batchmode -executeMethod PerformBuild.CommandLineBuild
- 保存，然后点击现在编译，等待编译完成，打开工作区间，找到“Build/Build_ios”目录，发现Xcode工程已经生成出来了。
七、配置Xcode
打IOS包需要开发者账号和必要的证书。
在Unity里设置：
- 包名（在苹果开发者后台创建）；
- 团队ID，开发者账号对应的Team ID；
-
勾选自动签名。
IOS导出配置
- 配置证书
- 点击Jenkins主页->管理Jenkins->证书管理->全局证书
- 点击左边的添加证书
- 类型选择Mac OSkeychain password and path
- 描述填：login.keychain
- 路径填：/Users/xxx/Library/Keychains/login.keychain-db
-
密码为电脑密码。
配置IOS证书
- 添加Xcode编译步骤
点击Jenkins主页->选中项目->选中配置
-
在构建一项中点击添加构建步骤，选择Xcode
选择Xcode 在通用编译设置里面填写开发者团队ID
- 配置填写：Release
- Xcode Schema File 填写： 项目名
- 勾选创建压缩包选
- 导出方式填写：development
- 导出文件夹填写：${WORKSPACE}/Build/Build_ipa
- 勾选自动签名
- 勾选解锁钥匙串，钥匙串选择之前配置好的login.keychain,地址和密码和之前一样
- 打开高级选项填写Xcode工程文件夹和编译输出文件夹
- 点击应用，点击保存，点击编译，等待编译结果。编译时间根据项目情况而定，我的项目编译用时大概是6-8个小时。
八、配置SSH服务器
- 配置服务器信息（需要https服务器，否则无法下载安装）
- 点击Jenkins主页- > 系统配置 ,找到Publish over SSH
- Server Name 填写：XRL
- Hostname 填写: 远程服务器地址
- 用户名填写：服务器用户名
- 远程文件夹填写：要存放的目录
- Passphrase ：选择密码，然后填写服务器密码
- 配置SSH构建步骤
- 点击Jenkins主页->选中项目->选中配置，选择发送文件到SSH
- 服务器选择上一步配置好的服务器
- 文件名填写： */.ipa （注意，是相对路径）
- 远程文件夹可以不填，不填会直接上传到服务器配置时候填写的文件夹里。
- 执行命令是必填的，可以随便写一个命令。
6. 点击应用，点击保存，然后点击现在编译，编译成功之后会发现服务器指定的文件夹已经存在导出的 .ipa 文件啦！
整个过程很长，中间可能会遇到很多问题，这里就不一一列举了，查一查资料，相信你可以自己解决。到这里还没完，还要生成网页链接，给到测试人员下载测试。这一步后面的文章会写到。
环境：
Unity：2020.3.26f
Jenkins: 2.339
Xcode: 13.2.1
Mac OS: 12.2.1
Home Brew: 3.4.2
Java Version: 1.8.0_321
