使用Jenkins构建Unity项目的IOS包

Jenkins

一、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环境

若没有java环境前往官网下载安装即可:

https://www.java.com/en/download/

Jenkins安装方式有两种：

• 安装包方式：前往Jenkins官网下载.pkg安装包进行安装即可。

• Homebrew命令行方式：请确保已安装Homebrew，如未安装可去Homebrew官网，复制命令一键安装 Jenkins安装命令：

brew install jenkins //推荐使用这种方式安装。

安装结束后，在终端输入命令：

jenkins

启动服务，即可在浏览器中输入http://localhost:8080中进行访问，如下图：

获取管理员密码

依照图中描述在终端输入 cat + 密码路径，获取密码复制下一步。

cat /Users/fsbm/.jenkins/secrets/initialAdminPassword

选择推荐安装的插件进行安装：

image

等待插件安装完成：

安装推荐插件

配置完管理员账户：

创建管理员

三、配置插件

成功安装后，接下来要配置Unity，xcode构建的所需环境等，需要安装的插件有：

插件	作用
SVN	源码管理工具（如果使用git请忽略）
Unity3D Plugin	Unity 运行Unity Editor 编辑器
Xcode integration Version	构建xcode项目，调用agvtool和包。ipa文件的构建器
Publish Over SSH Version	通过SSH发送编译包到服务器

安装步骤：

1. 点击管理Jenkins；
2. 点击插件管理；
3. 点击可用插件；
4. 点击搜索

5. 点击下载并安装。

   
   选择管理插件

搜索安装插件

四、新建任务

点击 Jenkins首页 > 新建Item。输入任务名称并选中自由风格工程，下一步。

新建项目

在通用选项里可进行一些描述信息填写和构建包丢弃计划（非必要设置），如图：

添加描述，参数等

五、配置SVN

1. 填写Repository URL，即项目的SVN路径；
2. 添加凭证，SVN的账户和密码；
3. 选择刚才添加好的凭证；
4. 点击保存；

配置SVN

5. 点击现在构建；

拉取SVN项目

6. 点击正在构建的项目可以查看构建进度和日志；

查看状态，日志等信息

等到构建完成，打开工作空间，发现你的项目已经被克隆下来了。

六、配置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";
 }
}

3. 配置编译命令

• 选中当前项目；
• 点击添加编译步骤，选择调用Unity编辑器

添加编译Unity命令 选择调用Unity编辑器

• 选择上一步配置好的Unity编辑器
• 输入编译命令

-quit -batchmode -executeMethod PerformBuild.CommandLineBuild

输入命令

• 保存，然后点击现在编译，等待编译完成，打开工作区间，找到“Build/Build_ios”目录，发现Xcode工程已经生成出来了。

七、配置Xcode

• 打IOS包需要开发者账号和必要的证书。

• 在Unity里设置：

1. 包名（在苹果开发者后台创建）；
2. 团队ID，开发者账号对应的Team ID；

3. 勾选自动签名。

   
   IOS导出配置

• 配置证书

1. 点击Jenkins主页->管理Jenkins->证书管理->全局证书
2. 点击左边的添加证书
3. 类型选择Mac OSkeychain password and path
4. 描述填：login.keychain
5. 路径填：/Users/xxx/Library/Keychains/login.keychain-db

6. 密码为电脑密码。

   
   配置IOS证书

• 添加Xcode编译步骤

1. 点击Jenkins主页->选中项目->选中配置

2. 在构建一项中点击添加构建步骤，选择Xcode

   
   选择Xcode

3. 在通用编译设置里面填写开发者团队ID

填写Team ID

4. 配置填写：Release
5. Xcode Schema File 填写： 项目名
6. 勾选创建压缩包选
7. 导出方式填写：development
8. 导出文件夹填写：${WORKSPACE}/Build/Build_ipa

填写项目名等

9. 勾选自动签名
10. 勾选解锁钥匙串，钥匙串选择之前配置好的login.keychain,地址和密码和之前一样

选择签名

11. 打开高级选项填写Xcode工程文件夹和编译输出文件夹

填写Xcode工程文件夹

12. 点击应用，点击保存，点击编译，等待编译结果。编译时间根据项目情况而定，我的项目编译用时大概是6-8个小时。

八、配置SSH服务器

• 配置服务器信息（需要https服务器，否则无法下载安装）

1. 点击Jenkins主页- > 系统配置 ,找到Publish over SSH
2. Server Name 填写：XRL
3. Hostname 填写: 远程服务器地址
4. 用户名填写：服务器用户名
5. 远程文件夹填写：要存放的目录
6. Passphrase ：选择密码，然后填写服务器密码

配置SSD服务器

• 配置SSH构建步骤

1. 点击Jenkins主页->选中项目->选中配置，选择发送文件到SSH

添加SSH构建步骤

2. 服务器选择上一步配置好的服务器
3. 文件名填写： */.ipa （注意，是相对路径）
4. 远程文件夹可以不填，不填会直接上传到服务器配置时候填写的文件夹里。
5. 执行命令是必填的，可以随便写一个命令。

配置要上传的文件

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