这是Unity Android APP il2cpp热更完かん美び解かい决方案あん的てきDemo（Git地ち址し）的てき说明。

和かず现有的てき热更解かい决方案あん不同ふどう的てき是ぜ，他た不ふ会かい引入多た余あまり的てき语言（只ただ是ぜUnityScript，c#...），对Unity程ほど序じょ设计和わ编码没ぼつ有ゆう任にん何なん限げん制せい。你可以在预置和わ场景里さと的てきGameObject上じょう添加てんか任にん何なん的てきCompnents组件，需要じゅよう序列じょれつ化か的てき和わ不ふ需要じゅよう序列じょれつ化か的てき，他た们都是ぜ可か以热更さら的てき，也不需要じゅよう做额外的がいてき标记处理。简而言ごと之の，在ざい此方こちら案下あんか，Unity的てき所有しょゆう资源和わ脚本きゃくほん，都みやこ是ただし可か以热更さら的てき。

本文ほんぶん接せっ下か来らい将はた介かい绍如何いか去さ制作せいさく热更文ぶん件けん和わ如何いか应用这些热更文ぶん件けん。为了简化Demo的てき设计，Demo包含ほうがん的てき热更文ぶん件けん会かい事こと先さき以全量りょう更新こうしん的てき方式ほうしき制作せいさく好こう，一起打到了Apk里さと面めん。具体ぐたい到いた项目中ちゅう热更文ぶん件けん得え放ひ服ふく务器，正式せいしき上じょう线得放ひCDN，以增量ぞうりょう更新こうしん的てき方式ほうしき捣鼓出で和文わぶん中ちゅう一样的目录结构就OK了りょう。

Demo代だい码适用ようUnity2018-？，2017需要じゅよう自己じこ看み版本はんぽん历史回かい退すさZip库。

Unity在ざい以il2cpp方式ほうしき导出Android工程こうてい（或ある者ものApk文ぶん件けん）的てき时候，代だい码会被ひ编译成なりlibil2cpp，而相关的资源、配置はいち和わ序列じょれつ化か数すう据すえ会かい以他们各自かくじ的てき格式かくしき导出到いたandroid的てきassets目め录（assets/bin/Data）。这两部分ぶぶん，libil2cpp和わassets目め录，必须匹ひき配はい（即そく需要じゅよう在ざい同どう一次打包中提取，可能かのう有ゆう的てき变了，有ゆう的てき没ぼつ变，增量ぞうりょう方式ほうしき只ただ提ひっさげ取ど变化的てき部分ぶぶん）才能さいのう正常せいじょう工作こうさく，不ふ然しかUnity会かい在ざい启动时崩溃。本ほん方案ほうあん就是热更这两部分ぶぶん。

热更的てき正式せいしき流りゅう程ほど如下图.

流りゅう程ほど说明：

• 步ふ骤1，在ざいUnity的てき逻辑之の前まえ，libbootstrap会かい检查本地ほんじ是ぜ否いや有ゆうPatch. Apk安あん装そう后きさき，没ぼつ应用过任何なん热更，本地ほんじ是ぜ不ふ会かい有ゆうPatch文ぶん件けん的てき，走はしno流りゅう程ほど。如果热更过，则会有ゆうPatch目め录，走はしyes流りゅう程ほど。如果是ぜ覆くつがえ盖安装そう，会かい检查apk和わPatch文ぶん件けん的てき修おさむ改あらため时间，走はしno流りゅう程ほど。Patch目め录如何なん准じゅん备，后きさき面会めんかい将はた到いた。

• 步ふ骤2，加か载Patch目め录对应架构（arm/x86）的てきlibil2cpp库，并应用ようassets目め录的更新こうしん文ぶん件けん。

• 步ふ骤3，开始Unity的てき流りゅう程ほど，进入Unity第だい一いち个场景けい，并执行ぎょう相しょう关的Unity Script，一般いっぱん是ぜC#，我わが们都以C#举例。

• 步ふ骤4，检查服ふく务端是ぜ否いや有ゆう新しん的てきpatch，这步demo没ぼつ有ゆう演えんじ示しめせ，需要じゅよう自己じこ实现。

• 步ふ骤5，下か载新的てきpatch，这步demo也没有ゆう演えんじ示しめせ，需要じゅよう自己じこ实现

• 步ふ骤6，根ね据すえ规则准じゅん备patch目め录，详细规则会かい在ざい后きさき面めん描述。在ざいDemo中ちゅう只ただ是これ将はた全量ぜんりょう更新こうしん包つつみ解かい压，全量ぜんりょう更新こうしん包つつみ打だ包つつみ的てき时候目め录结构就是ぜ对的，所以ゆえん不ふ需要じゅよう做其他た的てき处理。

• 步ふ骤7，调用libbootstrap的てき接せっ口こう设置patch目め录，因いん为libil2cpp已やめ经加载进进程，所以ゆえん需要じゅよう重じゅう启APP，从新的てきpatch目め录加载patch。这步Demo中有ちゅうう设置patch目め录的例れい子こ。

• 步ふ骤8，重じゅう启APP，Demo提供ていきょう了りょう纯C#代だい码。

• 步ふ骤9，没ぼつ有ゆう新しん的てきPatch，就正常つね进入游ゆう戏了。

流りゅう程ほど里さと更さら详细的てき描述和わ如何いか生成せいせいPatch文ぶん件けん，见第三さん章しょう。

工程こうてい所有しょゆう文ぶん件けん均ひとし置おけ于AndroidIl2cppPatchDemo目め录下。各かく文ぶん件けん目め录说明あかり如下表ひょう。

所有しょゆう文ぶん件けん就这么多，项目用ようgit管理かんり，master分ぶん支ささえ为母包つつみ分ぶん支ささえ，version1和わversion2分ふん支ささえ为热更さら1和わ热更2分ふん支ささえ，分ふん支ささえ间会有ゆう些细微ほろ的まと差さ别，version1主要しゅよう测试序列じょれつ化か数すう据すえ，version2添加てんか了りょう新しん场景和わ新しん脚本きゃくほん，具体ぐたい可か以diff查看。下面かめん会かい详细描述打だ包つつみ过程和わ如何いか应用热更文ぶん件けん。

所有しょゆう的てき打だ包つつみ逻辑在ざい文ぶん件けんEditor\AndroidBuilder.cs里さと。展てん开主菜しゅさい单AndroidBuilder, 可か以看到いた有ゆう5步ほ，为了和わ热更启动流りゅう程ほど区分くぶん，我わが们就叫さけべ他た过程。

• 过程1：以il2cpp的てき方式ほうしき，导出Gradle Android工程こうてい。选择Gradle Android工程こうてい，而不是ぜADT Android工程こうてい，只ただ是ぜ因いん为Unity2018不ふ再さい支持しじADT方式ほうしき。Demo并不依よ赖AndroidStudio，只ただ是ぜ导出的てきAndroid工程こうてい目め录结构是以Gradle的てき方式ほうしき注ちゅう释，之これ后きさき的てき构建步ふ骤都是ぜ调用原始げんしJDK/SDK的てき方式ほうしき。Demo这部分ぶぶん的てき代だい码可以复用よう，但ただし需要じゅよう根ね据すえ项目需求做一些修改あらため。

• 过程2：需要じゅよう修おさむ改あらため一いち下かAndroid工程こうてい，因いん为libbootstrap需要じゅよう在ざい进入Unity的てき帧循环前，检查加か载本地ち准じゅん备好的てきpatch。大だい多数たすう情じょう况，你可以复用よう这个步ふ骤的代だい码。但ただし是ぜ如果你的项目修おさむ改あらため了りょうUnity Java的てき继承体系たいけい，你需要よう检查一下这块代码是否有调用到。如果没ぼつ有ゆう调用到いた，后きさき面めんUnity帧循环中的てき逻辑和わ资源，用よう的てき都と是ぜApk内的ないてき相しょう应文件けん。

• 过程3：生成せいせい热更文ぶん件けん。如在第だい二に章しょう所しょ述じゅつ，patch分ぶん为两部分ぶぶん，il2cpp库和assets/bin/Data目め录。具体ぐたい做法代だい码均有ゆう提供ていきょう，需要じゅよう注意ちゅうい的てき是ぜ必须遵守じゅんしゅ各かく个文件けん的てき命名めいめい方式ほうしき和わ相しょう对路径みち。各かく个文件けん均ひとし有ゆう压缩，对于增量ぞうりょう包つつめ，如果压缩前まえ的てき文ぶん件けん和之かずゆき前ぜん相そう比ひ没ぼつ有ゆう变化，则不需要じゅよう制作せいさく对应的てき压缩文ぶん件けん。这部分ぶぶん制作せいさく压缩部分ぶぶん的てき代だい码可复用，增量ぞうりょう部分ぶぶん需要じゅよう自己じこ实现，热更文ぶん件けん最さい好こう也加进版本ほん管理かんり（svn/git/...）中ちゅう。

• 过程4: 生成せいせい打だ包つつみ的てきwindows脚本きゃくほん。脚本きゃくほん仅依赖JDK/SDK命令めいれい，可か复用。生成せいせい脚本きゃくほん后きさき，Android工程こうてい就不依よ赖Unity了りょう，可か以随意ずいい替がえ换文件けん，再さい次つぎ调用脚本きゃくほん生成せいせい新しん的てきApk。需要じゅよう注意ちゅうい的てき是ぜ，打だ包つつみ用よう的てきso动态库，是ぜpkg_raw目め录下的てきso文ぶん件けん，替がえ换时请注意ちゅうい。首くび次じ会かい在ざいUnity目め录下生成せいせいkeystore目め录和相しょう应的签名文めいぶん件けん，可か以将此签名めい替がえ换，并修改あらため导出脚本きゃくほん中ちゅう的てき签名密みつ码。

• 过程5: 执行过程4中ちゅう的てき脚本きゃくほん，生成せいせいApk安あん装そう文ぶん件けん，可か复用。

主菜しゅさい单AndroidBuilder下か还提供ていきょう了りょう菜さい单“Running Step 1, 2, 4, 5 for the base version”，这是一键构建母包版本用的，母はは包つつみ不ふ需要じゅよう制作せいさくpatch文ぶん件けん，所以ゆえん少しょう了りょう过程3；和わ菜さい单“Runnnig Step 1-4 for patch versions”，这是一いち键构建けんPatch用よう的てき，因いん为在demo里さと，不ふ需要じゅよう导出Apk文ぶん件けん。

关于打だ包つつみ这里得とく多た说两句く。 如果没ぼつ有ゆう采さい用ようAssetBundle的てき方式ほうしき打だ包つつめ，Unity会かい按各自かくじ格式かくしき，将はた所有しょゆう场景和わ依よ赖输出で到いたassets/bin/Data目め录，这样子こ也是可か以热更さら的てき。但ただし是ぜ，不要ふよう这么做，因いん为这样做微小びしょう的てき改あらため动会影かげ响到多た个文件けん，导致热更文ぶん件けん过大。最さい好こう是ぜ自己じこ用ようAssetBundle的てき方式ほうしき将はた资源做一个清晰的划分，打だ包つつみ好このみ的てきAssetBundle放ひ在ざいassets下か的てき其他目め录。需要じゅよう注意ちゅうい和わlibil2cpp库和assets/bin/Data的てき文ぶん件けん向こう匹ひき配はい（保ほ证是同どう一个版本的输出）。运行时可以重写うつしAssetBundleManager.overrideBaseDownloadingURL加か载最新さいしん的てきAssetBundle。

我わが们回顾一下第二章的流程图，结合打だ包つつみ过程和わDemo的てき代だい码，做进一いち步ほ的てき说明.

打だ包つつみ过程2里り，需要じゅよう在ざいUnityPlayerActivity.java文ぶん件けん头导入いれ一いち个库，在ざいUnity的てき游ゆう戏逻辑之前まえ，插入そうにゅう了りょう一いち行ぎょうJava代だい码。

        import android.view.WindowManager;
+       import io.github.noodle1983.Boostrap;

+       Boostrap.InitNativeLibBeforeUnityPlay(getApplication().getApplicationContext().getFilesDir().getPath());
        mUnityPlayer = new UnityPlayer(this);

这三行代码保证了上图中步骤1-2能のう在ざい步ふ骤3之の前ぜん执行，下した一いち行ぎょうmUnityPlayer的てき代だい码即开始了りょう步ふ骤3的てき执行。步ふ骤3之これ后きさき所有しょゆう的てき逻辑，都みやこ是ただし已やめ热更过的il2cpp库里的てきUnity Script（c#，...）了りょう。热更部分ぶぶん的てき逻辑如果有ゆう修おさむ改あらため，会かい在ざい热更后きさき体たい现，如果这部分ぶぶん的てきbug不ふ影かげ响下次じ热更，则可以通过热更さら修おさむ复，否いや则应指ゆび引用いんよう户清除じょ本地ほんじ数すう据すえ，以母包つつみ热更逻辑更新こうしん到いた最新さいしん。所以ゆえん，在ざい方案ほうあん的てき应用中ちゅう，仍需尽つき量りょう保ほ证热更さら部分ぶぶん的てき代だい码稳定じょう，不能ふのう随意ずいい更改こうかい。

如前所しょ述じゅつ，Demo里さと没ぼつ有ゆう步ふ骤4和かず步あゆみ骤5的てき相しょう关逻辑，步ほ骤6中ちゅうPatch的てき准じゅん备，Demo只ただ是ぜ简单地ち将はた全量ぜんりょう压缩包つつみ解かい压，相そう关逻辑在Script/VersionSettor.cs文ぶん件けん中ちゅう。准じゅん备更新こうしん目め录时，应保证libil2cpp部分ぶぶん被ひ解かい压，命名めいめい方式ほうしき和わDemo保持ほじ一致いっち，而assets_bin_Data下か的てき文ぶん件けん不ふ需要じゅよう解かい压，应保证目录结构和Demo保持ほじ一致いっち。如果是ぜ增量ぞうりょう更新こうしん，Patch目め录下的てき文ぶん件けん应该是ぜ相しょう对于母はは包つつみ的てき修おさむ改あらため文ぶん件けん。在ざい持じ续热更さら中ちゅう，应保证在步ふ骤7前まえ，本地ほんじ当とう前ぜんPatch目め录的完かん整せい性せい（保ほ证运行ぎょう中ちゅう的てきApp还能正常せいじょう执行），新しん的てきPatch应新建けん目め录，通つう过硬链接的てき形式けいしき从当前ぜんPatch目め录中提ひっさげ取ど所ところ需要じゅよう的てき没ぼつ变化的てき文ぶん件けん，准じゅん备好后きさき执行步ふ骤7，重じゅう启后将はた老ろうPatch目め录删除じょ. 步ふ骤7和かず步あゆみ骤8的てき代だい码也在ざいScript/VersionSettor.cs文ぶん件けん中ちゅう，样子如下

        //4. tell libboostrap.so to use the right patch after reboot
        string error = Bootstrap.use_data_dir(runtimePatchPath);
        if (!string.IsNullOrEmpty(error))
        {
            messageBox.Show("use failed. path:" + zipLibil2cppPath + ", error:" + error, "ok", () => { messageBox.Close(); });
            yield break;
        }

        //5. reboot app
        yield return StartCoroutine(Restart());

安あん装そう预编译的Apk文ぶん件けん，点てん击按钮可以切换各个版本はんぽん。

release版本はんぽん

• Unity (我が用ようUnity2017/Unity2018/Unity2019)
• Unity2019.4 自じ带的JDK，SDK，NDK
• Git

• 1. 在ざいUnity中ちゅう（Edit->Preference->External tools）设置好こう JDK/SDK/NDK 路ろ径みち，打だ包つつみ代だい码里会かい从Unity中ちゅう读取。
• 2. 确保gradle能のう正常せいじょう工作こうさく（Unity内ない能のう正常せいじょう导出apk）
• 3. 出で母はは包つつめ，执行菜さい单 AndroidBuilder->Run Step 1, 2, 4, 5 for base version, 成功せいこう后きさき会かい弹出文ぶん件けん管理かんり器き显示apk所在しょざい的てき目め录.
• 4. 一般来说你不需要打Patch文ぶん件けん，如果要よう打だ，用ようgit checkout version1或あるversion2，执行菜さい单 AndroidBuilder->Run Step 1-4 for Patch Version。PrebuildPatches目め录下的てき相しょう应文件けん会かい被ひ更新こうしん。

打だ包つつみ部分ぶぶん

• 设置部分ぶぶん需要じゅよう根ね据すえ项目实际做修改あらため。
• 热更文ぶん件けん的てき增量ぞうりょう版本はんぽん化か管理かんり。

运行时部分ぶぶん

• 检查新しん版本はんぽん和わ下か载热更さら文ぶん件けん。
• 持もち续增量ぞうりょう更新こうしん的てきPatch目め录的准じゅん备。
• 用ようAsset Bundle管理かんり资源。

另外，打だ包つつみ的てき工作こうさく尽つき量りょう自じ动的一いち键化，一いち次じ化か，除じょ非ひ你想在ざい打だ包つつみ当とう晚ばん集しゅう体からだ晒さらし月がつ亮あきら。另外，低てい成本なりもと的てき打だ包つつみ流りゅう程ほど，大家たいか都みやこ愿すなお意い在ざい真ま机上きじょう看み结果，利り于产品ひん的てき稳定。Demo其实提供ていきょう了りょう一套自动化的框架和脚本，理解りかい透とおる，化か为己用よう，也是幸こう事ごと一いち件けん。如果有ゆう更さら好このみ的てき方式ほうしき，欢迎讨论。

MIT license.

• 1. noodle1983(Noodle)完成かんせい了りょう第だい一いち版はん， MIT开源
• 2. DesperateZero(_DespAir.)贡献了りょう首くび次じ上じょう线机会かい，协助解かい决了一いち下か问题
  • 文ぶん件けん句柄くがら泄漏
  • 适配：oppo手しゅ机つくえ，/data/data/appid/files 访问不ふ了りょう
  • Google abb打だ包つつみ的てき适配问题（原因げんいん是ぜabb的てき方式ほうしき会かい有ゆう多た个apk包つつめ，原はら来らい是ぜpatch第だい一いち个，目前もくぜん方案ほうあん是ぜpatch含路径みちasset/bin/Data的てき那な个）
• 3. [qq：墨すみ(2900180710)abram_ped@126.com]发现并解决了原げん读写锁不生せい效こう的てき问题，测试文ぶん件けんtest_mutex.cpp
• 4. sisong(e侯こう子こ.net)实现了りょう基もと于hook和わApkDiffPatch的てき另一种实现方式しき，实现了りょうmono和わUnity版本はんぽん的てき热更，并做了りょう大量たいりょう的てき机つくえ型がた和わ各かく个API Level的てき测试。项目地ち址し
• 5. qq：木子きご(406351314)、西にし's my baby(871967866)quange0314@163.com团队和わSin(446541451)yudimo@vip.qq.com团队，帮忙发现和わ验证随ずい机つくえ崩くずし溃问题：#12
• 6. qq：Enough.(1098839800) 实践文ぶん档：通つう过IL2CPP热更代だい码
• 7. qq:粽ちまき仔こ001(1144916875) 发现的てきDemo中ちゅう回かい退すさbase version，脚本きゃくほん常つね量りょう仍然是ぜpatch版本はんぽん的てき问题。（il2cpp cache没ぼつ清きよし）
• 8. qq:みなの総長そうちょう(53957801) 发现的てき新しん版本はんぽん没ぼつ有ゆう更新こうしん文ぶん件けん，仍走了りょう没ぼつ必要ひつよう的てき更新こうしん逻辑的てき问题。
• 9. github: marklalon及其项目组 性能せいのう优化和わ严谨的てき性能せいのう测试 repo link
• 10. github: ganlvtech tests/fixs spin lock issue.

• 1. 集成しゅうせい中ちゅう如果有ゆう问题，先さき看み看みDemo的てきrelease版本はんぽん有ゆう没ぼつ有ゆう问题。如果Demo有ゆう问题，直接ちょくせつ找我吧，QQ或ある邮件都と行ぎょう。
• 2. 如果感かん兴趣，可か以在log.h里さと，把わ日び志こころざし全ぜん开，会かい有ゆう一些很有意思的日志，对理解りかい原理げんり和わ调试都と很有用よう。
• 3. Android obb的てき支持しじ，欢迎pull request，提供ていきょう支持しじ
• 4. Q群ぐん：593413410
• 5. 遗留问题见Github Issues

• 邮件: noodle1983@126.com.
• Q群ぐん：593413410（广告免めん扰）

PayPal:https://www.paypal.me/noodle1983

Or Alipay: Or Wechat: