如何搭建Jenkins导出Unity安卓环境

前言

早早去公司上班，老大经常会叫我出一个demo的包，我就想起来可以配置一个打包工具，让他随时想要一个运行包就可以自己打包看效果，就想起来可以配置一个Jenkins打包环境。这样在同一个局域网内不需要Unity开发环境，就只要浏览器打开Jenkins然后点击打包即可。

准备工具

  • 准备Jenkins环境，可以选择去Jenkins官网下载,我这里准备了一个Jenkins的war包。

搭建步骤

  • 首要前提本地Unity已经安装好Unity Android的打包环境，确保能够正确的用Unity导出Android apk包，这里就不过多介绍Unity如何导出Android环境了，自行解决。

  • 命令行启动Jenkins，java -jar jenkins.war,会看到如下运行即代表启动成功，可以在浏览器输入http://localhost:8080/来测试，会看到进入Jenkins网站。

  • 构建项目

注意windows路径和命令行的路径的转变，上图是Unity打包apk的批处理的路径，这个批处理如下图，并且要放到Unity的工程下。

注意：如果批处理路径中不能带有空格，如果有空格的话可以加上双引号，确保这个批处理能够正确的导出apk，批处理代码如下，并且注意用utf8保存：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

@echo off

echo "Start build apk..."

C:\"Program Files"\Unity1748f1\Unity\Editor\Unity.exe -projectPath D:\study\gitoschina\jenkinsTest\HelloUnity -quit -batchmode -executeMethod PerformBuild.CommandLineBuildAndroid -logFile build.log

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

if not %errorlevel%==0 ( goto fail ) else ( goto success )

:success

echo Build APK OK

goto end

:fail

echo Build APK Fail

goto end

:end

pause
  • 工程Editor目录下添加自动构建的代码
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146

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()

    {

        string dirPath = Application.dataPath + "/../build/iPhone";

        if (!System.IO.Directory.Exists(dirPath))

        {

            System.IO.Directory.CreateDirectory(dirPath);

        }

        return dirPath;

    }

    [UnityEditor.MenuItem("Tools/PerformBuild/Test Command Line Build iPhone Step")]

    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()

    {

        string dirPath = Application.dataPath.Replace("/Assets", "") + "/../build/android/"+Application.productName+".apk";

        if (!System.IO.Directory.Exists(dirPath))

        {

            System.IO.Directory.CreateDirectory(dirPath);

        }

        return dirPath;

    }

    [UnityEditor.MenuItem("Tools/PerformBuild/Test Command Line Build Step Android")]

    static void CommandLineBuildAndroid()

    {

        Debug.Log("Command line build android version\n------------------\n------------------");

        string[] scenes = GetBuildScenes();

        string path = GetBuildPathAndroid();

        if (scenes == null || scenes.Length == 0 || path == null)

        {

            Debug.LogError("Please add scene to buildsetting...");

            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 Android Build!");

        BuildPipeline.BuildPlayer(scenes, path, BuildTarget.Android, BuildOptions.None);

    }

}
  • 点击Jenkins构建

  • 本地生成apk

更深入的配置可以参考以下链接，更多Jenkins插件和功能可以摸索研究。Mac中导出iOS配置后续添加或者想尝试的朋友参考文末雨凇的文章。

注意事项

更新了jenkins之后会发现构建没有报错但没有生成apk，但我们在bat运行却能生成apk，详细看log会发现其实是有提示的，需要将sdk添加到jenkins环境变量里。

解决办法：

邮件通知

构建完成，打包出apk，我们可以将apk上传到服务器，以便下载，然后通过邮件通知构建完成，这样我们就不需要一直等待，邮件可以将apk添加到附件。

邮件通知配置：

邮件主题配置：

【构建通知】PROJECT_NAME - Build #BUILD_NUMBER - $BUILD_STATUS!

邮件内容模板配置：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
<!DOCTYPE html>    
<html>    
<head>    
<meta charset="UTF-8">    
<title>${ENV, var="JOB_NAME"}-第${BUILD_NUMBER}次构建日志</title>    
</head>    
<body leftmargin="8" marginwidth="0" topmargin="8" marginheight="4"    
    offset="0">    
    <table width="95%" cellpadding="0" cellspacing="0"  style="font-size: 11pt; font-family: Tahoma, Arial, Helvetica, sans-serif">    
        <tr>    
            本邮件由系统自动发出，无需回复！<br/>            
            各位同事，大家好，以下为${PROJECT_NAME }项目构建信息</br> 
            <td><font color="#CC0000">构建结果 - ${BUILD_STATUS}</font></td>   
        </tr>    
        <tr>    
            <td><br />    
            <b><font color="#0B610B">构建信息</font></b>    
            <hr size="2" width="100%" align="center" /></td>    
        </tr>    
        <tr>    
            <td>    
                <ul>    
                    <li>项目名称 ： ${PROJECT_NAME}</li>    
                    <li>构建编号 ： 第${BUILD_NUMBER}次构建</li>    
                    <li>触发原因： ${CAUSE}</li>    
                    <li>构建状态： ${BUILD_STATUS}</li>    
                    <li>构建日志： <a href="${BUILD_URL}console">${BUILD_URL}console</a></li>    
                    <li>构建  Url ： <a href="${BUILD_URL}">${BUILD_URL}</a></li>    
                    <li>工作目录 ： <a href="${PROJECT_URL}ws">${PROJECT_URL}ws</a></li>    
                    <li>项目  Url ： <a href="${PROJECT_URL}">${PROJECT_URL}</a></li>    
                </ul>    

<h4><font color="#0B610B">失败用例</font></h4>
<hr size="2" width="100%" />
$FAILED_TESTS<br/>

<h4><font color="#0B610B">最近提交(#$SVN_REVISION)</font></h4>
<hr size="2" width="100%" />
<ul>
${CHANGES_SINCE_LAST_SUCCESS, reverse=true, format="%c", changesFormat="<li>%d [%a] %m</li>"}
</ul>
详细提交: <a href="${PROJECT_URL}changes">${PROJECT_URL}changes</a><br/>

            </td>    
        </tr>    
    </table>    
</body>    
</html>

将邮件添加到任务中


设置完成，再次构建下我们的任务，AssetBundle打包完成，apk生成完毕，邮件发送事件被触发

邮件通知

下载链接

参考

后续

如果碰到问题欢迎留言讨论！

赏

努力赚奶粉钱

支付宝
微信

扫一扫，分享到微信

微信分享二维码

tag:

    缺失模块。
    1、请确保node版本大于6.2
    2、在博客根目录（注意不是yilia根目录）执行以下命令：
    npm i hexo-generator-json-content --save

    3、在根目录_config.yml里添加配置： 

      jsonContent:
    meta: false
    pages: false
    posts:
      title: true
      date: true
      path: true
      text: false
      raw: false
      content: false
      slug: false
      updated: false
      comments: false
      link: false
      permalink: false
      excerpt: false
      categories: false
      tags: true

一名<br>爱写代码的<br>码农