使用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 PluginUnity 运行Unity Editor 编辑器Xcode integration Version构建xcode项目,调用agvtool和包。ipa文件的构建器Publish Over SSH Version通过SSH发送编译包到服务器
安装步骤:
点击管理Jenkins;点击插件管理;点击可用插件;点击搜索
点击下载并安装。
选择管理插件
搜索安装插件
四、新建任务
点击 Jenkins首页 > 新建Item。输入任务名称并选中自由风格工程,下一步。
新建项目
在通用选项里可进行一些描述信息填写和构建包丢弃计划(非必要设置),如图:
添加描述,参数等
五、配置SVN
填写Repository URL,即项目的SVN路径;添加凭证,SVN的账户和密码;选择刚才添加好的凭证;点击保存;
配置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"; } 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
页:
[1]