[Unity 3D] 多场景任意组合的一键出多包的打包工具

这是一个笔记,梳理一下自己整理的自动打包工具,当成 Readme 也不错。

前言:

之前没想过,一旦遇见了才发现原来真有这样的情况,用一个项目打包 N 个应用,区别只是选择的 Scene 不同。这种需求如果用人工来处理就得在 Build Settings/Scene In Build中不停的切换和组合 Scene,同时还要考虑修改 ProjectSettings/Player/Product Name中的软件名称。
这种耗时还容易出错的事情,我们完全可以写一个一键处理的插件来解放双手!

需求:

实现一次配置,一键打包多个应用,还要有高可配置性:

  1. 打包平台可配置
  2. 打包存储位置可配置 ,使用 OpenFolderAttribute实现。
  3. 打包后处理可配置:打调试包、打包并运行、打包后打开存储位置
  4. 能够配置打成哪些个应用
  5. 能够配置出包的应用的场景列表哪些需要包含哪些不需要
  6. 优秀的人机交互,打包前有配置校验,打包后也要输出报告。
  7. 更广域的 Unity 版本支持(实测支持 2018.4 及以上)- 请使用高版本

实现:

由于笔者需要向下兼容到 Unity 2018.4.8,因为集合在旧版本 Unity 检视器(Inspecter)上还不支持拖动排序(亦既是暂未支持 ReorderableList),所以本工具将用到第三方的 ReorderableList 插件。
那么问题就简单了,直接变成了怎么用好 ReorderableList 插件,按人家示例看看就能用好,就 nice。
剩下的事情只是按需求设计好数据结构就行,数据结构在如下图所示 Data 文件夹中,这些数据构成了上面插件预览图中你看到的内容:

数据结构

当我们有了数据,接下来就是数据的取用了:一来用于绘制在 Inspector 上,二来用户保存和提供打包时各个自定义的数据。
全局配置

单个应用的配置

打包就更简单了,只需要将用户配置的数据进行整理,然后使用 Unity 的 BuildPlayer 接口即可,该系列接口为(演示了:设置应用名、设置版本、打包、展示打包结果):

var dir = $"{config.appLocationPath}/{profile.productName}";
var file = $"{dir}/{profile.productName}.exe";
PlayerSettings.productName = profile.productName;
PlayerSettings.bundleVersion= profile.productVersion;
var report = BuildPipeline.BuildPlayer(scenes.ToArray(), file, config.targetPlatform, options_unity);
Debug.Log($"{profile.productName} 打包结果:{report.summary.result}");

关于校验,只需要判断各个层级的数据是否合理的配置了即可,比如存储路径是否为空啊,软件名是否为空,软件是否没有指定 Scene或者 Scene没勾选呀这样。

   /// <summary>
        /// 配置校验,如果配置不对不打包
        /// </summary>
        /// <param name="config"></param>
        static void ValidateProfiles(AutoBuildConfiguration config)
        {
            if (string.IsNullOrEmpty(config.appLocationPath))
            {
                throw new Exception("应用打包存储路径未指定!");
            }
            if (config.profiles.Any(v => string.IsNullOrEmpty(v.productName)))
            {
                throw new Exception("配置中存在软件名称为空的情况,请修复!");
            }
            if (config.profiles.All(v => !v.isBuild))
            {
                throw new Exception("请至少保证一个打包的配置 isBuild = true");
            }
            foreach (var profile in config.profiles)
            {
                if (profile.isBuild)
                {
                    if (profile.scenes.Count == 0)
                    {
                        throw new Exception($"请至少给 {profile.productName} 一个场景!");
                    }
                    if (profile.scenes.Any(v => !v.scene))
                    {
                        throw new Exception("场景列表请不要留空!");
                    }
                    if (profile.scenes.All(v => !v.enabled))
                    {
                        throw new Exception($"{profile.productName} 场景列表请至少勾选一个场景!");
                    }
                }
            }
        }

演示:

  • 演示了打包前的校验
  • 演示了打包完成的应用唤起
  • 演示了打包完成的报告展示
  • 应用中则展示了场景的包含关系与配置的包含关系的一致性

扩展阅读:

写到最后:

内容很简单,效果很理想,总结几个关键字吧 :ReorderableListScriptableObjectEditorWindowBuildPipelinePropertyAttributePropertyAtrributeDrawer.asmdefUPM

2023年9月17日 更新

  1. 支持了用户自定义任务,现在更实用了
  2. 使用了新语法,移除了第三方 ReorderableList,故而请尽量使用高版本Unity (笔者 Unity 2021.3)

版权所有,转载请注明出处

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 213,864评论 6 494
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,175评论 3 387
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 159,401评论 0 349
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,170评论 1 286
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,276评论 6 385
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,364评论 1 292
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,401评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,179评论 0 269
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,604评论 1 306
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,902评论 2 328
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,070评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,751评论 4 337
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,380评论 3 319
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,077评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,312评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,924评论 2 365
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,957评论 2 351

推荐阅读更多精彩内容