关闭

Unity3d Jenkins 打包Android

2203人阅读 评论(2) 收藏 举报
分类:

Jenkins是一个丰富的图形化构建平台。提供脚本命令工具(bat、shell、perl、python、ant等),代码管理工具(svn cvs等)及账号权限管理等上千个辅助插件。为软件的持续化集成工作流程提供完美支持。
下面将介绍,如何在windows下使用Jenkins输出Android apk包


配置环境

  • windows 7
  • Jenkins1.650
  • Unity3d4.6.7 (需要Pro版)
  • Android SDK (API 21以上)
  • JDK 1.8

创建Unity3d工程

  1. 新建C#脚本重命名为Main.cs
  2. Main.cs代码,如下

    public class Main : MonoBehaviour
    {
        private Rect rect = new Rect(0f, 0f, Screen.width , Screen.height);
        void OnGUI()
        {
            GUI.skin.label.fontSize = 40;
            GUI.Label(rect, "Hello Jenkins");
        }
    }
  3. 依次点击File->New Scene,新建场景,重命名为Main.unity
  4. 在Main.unity场景中,创建GameObject节点,重命名为Node
  5. 将Main.c挂载到节点Node上
    这里写图片描述
  6. 打开File->BuildSettings,将Main拖进到Scenes In Build窗口下
    这里写图片描述
  7. 保存以上所有信息。
  8. 运行可以看到如下图显示
    这里写图片描述
  9. 检查是否已正确配置包名,Anroid Sdk路径。建议先在Unity3d BuildSetting成功输出Android,以隔离下面Jenkins打包失败问题。

Unity打包命令

UnityEditor命令空间下,有打包接口(需要Pro版本)

public static string BuildPlayer(string[] levels, string locationPathName, BuildTarget target, BuildOptions options);

参数:
levels 为的打包的场景路径数据
locationPathName 包输出目录
target 输出平台
option 输出选项
上面4个参数的具体用处,其实对应下面的Unity图形界面
这里写图片描述
这里写图片描述
这里写图片描述
同时Unity3d支持以命令行形式启动,并且允执行一个Editor目录的静态方法。所以只要在此静态方法里使用BuildPlayer.BuildPlayer即可以通过命令行实现打包功能。命令行的各项参数见官方文档
http://docs.unity3d.com/540/Documentation/Manual/CommandLineArguments.html
这里写图片描述
这里我简单实现这个静态方法

public class JenkinsAdapter
{
    [MenuItem("Jenkins/JenkinsBuild")]
    public static void Build()
    {
        EditorUserBuildSettings.SwitchActiveBuildTarget(BuildTarget.Android);

        List<string> sceneList = new List<string>();
        EditorBuildSettingsScene[] temp = EditorBuildSettings.scenes;
        for (int i = 0, iMax = temp.Length; i < iMax; ++i)
            sceneList.Add(temp[i].path);

        BuildPipeline.BuildPlayer(sceneList.ToArray(), "./android.apk", BuildTarget.Android, BuildOptions.None);
    }
}

在命令中增加了选项-logFile build.log以查看失败原因。

H:\Unity3d492\Editor\Unity.exe -projectPath D:\Test\workspace -executeMethod JenkinsAdapter.Build -quit -batchmode -logFile build.log

将上面脚本的Unity安装和工程路径,抽离出来。编写到脚本文件build.bat,存放到工程根目录下。

%1 -projectPath %2 -executeMethod JenkinsAdapter.Build -quit -batchmode -logFile build.log

这里写图片描述
注意:保存以上操作。并提交到代码仓库。
下面将介绍使用Jenkins。


安装Jenkins

配置Jenkins极为简单,安装即可用,无需要再进行配置。官网下载https://jenkins.io/index.html安装结束后,浏览器打开地址http://127.0.0.1:8080/显示Jenkins平台主页
这里写图片描述

新建Jenkins Job

  1. 点击进行,创建一个新任务
    这里写图片描述
  2. 创建一个自由风格的项目,项目名称为Test
    这里写图片描述
  3. 填写代码仓库地址。此处以使用代码管理SVN为例。注意选择更新策略
    我建议使用use ‘svn update’ as much as possible, with ‘svn revert’ before update。因为代码可能会出现冲突导致打包失败。(务必禁止在Jekins打包机上对checkout下来的代码进行修改)
    这里写图片描述
  4. 选择执行脚本命令。这里以window的bat命令为例。
    这里写图片描述
  5. 编写命令build.bat "H:\Unity3d492\Editor\Unity.exe" "%WORKSPACE%"变量%WORKSPACE%指向代码仓库的checkout目录,build.bat的执行目录同样也为%WORKSPACE%
    这里写图片描述
  6. 保存退出。
  7. 大功告成。立即进行一次构建。
    这里写图片描述

常见打包失败原因

  1. 未在Edit-Perfences配置Android sdk路径
  2. Androiod API版本低于Unity3d运行版本要求。
  3. 未在PlayerSettings配置包名和应用名
  4. 代码冲突。
  5. Unity3d不是Pro版本
  6. Jekins默认使用访客账号登录,会缺少执行安全权限,导致启动Unity3d时失败。错误信息“Validating Project structure … 0.000224 seconds. Refresh: detecting if any”。你需要在Jenkins启动服务属性中,指定登录账号。
    这里写图片描述
    这里写图片描述
1
0

查看评论
* 以上用户言论只代表其个人观点,不代表CSDN网站的观点或立场
    个人资料
    • 访问:51399次
    • 积分:543
    • 等级:
    • 排名:千里之外
    • 原创:15篇
    • 转载:0篇
    • 译文:1篇
    • 评论:18条
    文章分类
    最新评论