使用Jenkins构建Unity项目的IOS包

xiangtingsl · 发表于 2022-3-26 21:04

Jenkins

一、Jenkins简介

作为可扩展的自动化服务器，Jenkins 可以用作简单的持续集成（CI）服务器，或者变成任何项目的持续交付（CD）中心。它的特点如下：

简易安装

配置简单

插件

扩展

分布式

二、安装Jenkins

由于Jenkins 依赖于Java，所以在安装Jenkins前，需要先检查是否已安装Java环境。在终端输入命令进行检测：
java -version

检查是否已安装Java环境

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

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

Jenkins安装方式有两种：

安装包方式

Homebrew命令行方式

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发送编译包到服务器

安装步骤：

选择管理插件

搜索安装插件

四、新建任务

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

新建项目

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

添加描述，参数等

五、配置SVN

配置SVN

拉取SVN项目

查看状态，日志等信息

等到构建完成，打开工作空间，发现你的项目已经被克隆下来了。
六、配置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));  }  Debug.Log("Starting Build!");  BuildPipeline.BuildPlayer(scenes, path, BuildTarget.iOS, BuildOptions.None); } static string GetBuildPathAndroid() {  return "Bulid/android"; }}
配置编译命令

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

添加编译Unity命令

选择调用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

填写Team ID

配置填写：ReleaseXcode Schema File 填写：项目名勾选创建压缩包选导出方式填写：development导出文件夹填写：${WORKSPACE}/Build/Build_ipa

填写项目名等

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

选择签名

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

填写Xcode工程文件夹

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

八、配置SSH服务器

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

点击Jenkins主页- >  系统配置 ,找到Publish over SSHServer Name 填写：XRLHostname 填写: 远程服务器地址用户名填写：服务器用户名远程文件夹填写：要存放的目录Passphrase ：选择密码，然后填写服务器密码

配置SSD服务器

配置SSH构建步骤

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

添加SSH构建步骤

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

配置要上传的文件

6. 点击应用，点击保存，然后点击现在编译，编译成功之后会发现服务器指定的文件夹已经存在导出的  .ipa  文件啦！

<hr>
整个过程很长，中间可能会遇到很多问题，这里就不一一列举了，查一查资料，相信你可以自己解决。到这里还没完，还要生成网页链接，给到测试人员下载测试。这一步后面的文章会写到。
环境：
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

		自动登录	找回密码
密码			立即注册

使用Jenkins构建Unity项目的IOS包

本帖子中包含更多资源