巧用DevEco Studio增量補(bǔ)丁修復(fù)功能 提升鴻蒙開(kāi)發(fā)效率

在參與鴻蒙應(yīng)用開(kāi)發(fā)的過(guò)程中，許多開(kāi)發(fā)者都面臨一個(gè)共同的挑戰(zhàn)：如何縮短代碼修改到效果驗(yàn)證的周期？尤其是在大型項(xiàng)目中，哪怕是很小的調(diào)整，完整的編譯和部署流程也可能耗費(fèi)不少時(shí)間。我們都希望能夠更快地看到代碼變更所帶來(lái)的實(shí)際效果，提升迭代效率。DevEco Studio 提供了一些機(jī)制來(lái)應(yīng)對(duì)這個(gè)問(wèn)題，其中，“增量補(bǔ)丁修復(fù)”相關(guān)的技術(shù)，特別是 Hot Reload 和 Apply Changes 這兩個(gè)功能，值得我們深入了解。它們?yōu)榧铀嬴櫭蓱?yīng)用的調(diào)試和驗(yàn)證過(guò)程提供了有效的途徑。

增量補(bǔ)丁修復(fù)原理圖

增量更新：理解快速生效背后的邏輯

所謂“增量補(bǔ)丁修復(fù)”，簡(jiǎn)單來(lái)說(shuō)，就是一種避免全量編譯的技術(shù)思路。當(dāng)開(kāi)發(fā)者修改了代碼或資源后，系統(tǒng)只針對(duì)發(fā)生變化的部分進(jìn)行構(gòu)建，生成一個(gè)“補(bǔ)丁包”。然后，這個(gè)補(bǔ)丁包會(huì)被推送到設(shè)備上，更新正在運(yùn)行的應(yīng)用或準(zhǔn)備下次啟動(dòng)時(shí)加載。

這個(gè)過(guò)程根據(jù)應(yīng)用是否需要重啟來(lái)使修改生效，可以大致分為兩種模式：

熱修復(fù) :補(bǔ)丁應(yīng)用后，修改能夠無(wú)需重啟應(yīng)用就生效。這種方式的好處是能保持應(yīng)用當(dāng)前的狀態(tài)，比如用戶界面停留在哪個(gè)頁(yè)面，變量的當(dāng)前值等。

冷修復(fù):補(bǔ)丁應(yīng)用后，需要重啟應(yīng)用 (或 Ability)才能讓修改生效。這通常是因?yàn)樾薷纳婕暗搅藨?yīng)用啟動(dòng)時(shí)才初始化的組件或全局狀態(tài)，需要通過(guò)重啟來(lái)重新加載。

DevEco Studio 基于這套邏輯，提供了兩種具體的實(shí)現(xiàn)方式：Hot Reload 和 Apply Changes，它們各有側(cè)重，適用于不同的開(kāi)發(fā)場(chǎng)景。

Hot Reload：ArkTS 開(kāi)發(fā)的加速器

對(duì)于主要使用 ArkTS 進(jìn)行 UI 和交互邏輯開(kāi)發(fā)的場(chǎng)景，Hot Reload 是一個(gè)非常有用的功能。它結(jié)合了增量構(gòu)建和熱修復(fù)的能力，目標(biāo)是實(shí)現(xiàn) ArkTS 代碼修改后的“即時(shí)”預(yù)覽。

Hot Reload使用位置

使用上，通常在 DevEco Studio 中選擇支持熱重載的運(yùn)行模式啟動(dòng)應(yīng)用，然后在修改 ArkTS 代碼后，點(diǎn)擊工具欄的 Hot Reload 圖標(biāo)（或使用快捷鍵）。IDE 還支持設(shè)置“保存時(shí)自動(dòng) Hot Reload”，進(jìn)一步提升流暢性。

Hot Reload 的主要價(jià)值在于：及時(shí)反饋、 保持應(yīng)用狀態(tài)和開(kāi)發(fā)更流暢。

修改及時(shí)反饋：比如修改按鈕顏色、調(diào)整字體或者微調(diào)布局，以往我們都要重新編譯再運(yùn)行，特別是大項(xiàng)目，每次重啟可能耗費(fèi)好幾分鐘。但用了Hot Reload后，只要代碼改動(dòng)一保存，點(diǎn)一下熱重載按鈕，幾乎秒生效，非常直觀。

保持應(yīng)用狀態(tài)：另一個(gè)亮點(diǎn)是不用重啟應(yīng)用，可以保留應(yīng)用運(yùn)行狀態(tài)。比如在應(yīng)用里走到某個(gè)復(fù)雜場(chǎng)景（比如多步表單填寫(xiě)），代碼改了之后還可以繼續(xù)從當(dāng)前狀態(tài)看效果，不用再一遍遍地重頭操作，這一點(diǎn)確實(shí)提升了不少調(diào)試體驗(yàn)。

開(kāi)發(fā)更流暢：Hot Reload還支持保存時(shí)自動(dòng)重載，開(kāi)發(fā)時(shí)修改完代碼，保存后立刻看到效果，整體開(kāi)發(fā)節(jié)奏更流暢。

不過(guò)，Hot Reload 主要服務(wù)于 ArkTS/TS 代碼。它的實(shí)現(xiàn)原理（基于首次構(gòu)建的映射信息進(jìn)行增量編譯和虛擬機(jī)字節(jié)碼更新）決定了其局限性：

不支持部分修改:如添加新的 import（如果該文件之前未被使用）、修改 @Entry 入口組件的結(jié)構(gòu)（如增刪成員函數(shù)/變量）等。詳細(xì)限制可查閱官方文檔。

狀態(tài)可能異常:在某些復(fù)雜情況下，應(yīng)用狀態(tài)可能無(wú)法完全正確地保留，尤其是在狀態(tài)管理本身不規(guī)范時(shí)。

范圍有限:它不能處理 C++、資源文件或 .so 庫(kù)的修改。

幾個(gè)關(guān)于Hot Reload的實(shí)用小Tips分享給大家：

小步快跑：分解更改為小塊，每次修改后使用Hot Reload查看效果。

結(jié)合狀態(tài)管理：使用狀態(tài)管理工具（如@State、@Prop）可以更好地控制狀態(tài)，確保Hot Reload后狀態(tài)的正確性。

定期重啟應(yīng)用：在長(zhǎng)時(shí)間開(kāi)發(fā)后，建議偶爾完全重啟應(yīng)用，以確保代碼和狀態(tài)的一致性。

Apply Changes：覆蓋更廣的多面手

當(dāng)需要修改 C++ 代碼、原生庫(kù) (.so)、資源文件，或者遇到了 Hot Reload 不支持的場(chǎng)景時(shí)，Apply Changes 便派上了用場(chǎng)。它同樣采用增量構(gòu)建來(lái)提升速度，但為了支持更廣泛的文件類型和更底層的變更，它選擇了“冷修復(fù)”路線——修改生效前會(huì)重啟應(yīng)用。

Apply Changes 的使用入口在 IDE 中也很明顯，通常位于標(biāo)準(zhǔn)運(yùn)行配置旁邊。點(diǎn)擊后，IDE 會(huì)構(gòu)建增量補(bǔ)丁，停止設(shè)備上的應(yīng)用，應(yīng)用補(bǔ)丁，然后重新啟動(dòng)應(yīng)用。

Apply Changes使用位置

Apply Changes 的優(yōu)勢(shì)體現(xiàn)在：

一是支持更多樣的文件修改：

目前Apply Changes能夠同時(shí)支持C++、SO、資源文件的一種或多種修改快速生效，且修改場(chǎng)景限制較小。

二是僅需一次推包，關(guān)閉應(yīng)用后也可直接進(jìn)行Apply Changes：

關(guān)于C++、SO以及資源文件的增量編譯及打包都是與工程的運(yùn)行狀態(tài)解耦的，只要設(shè)備中已經(jīng)安裝工程對(duì)應(yīng)的應(yīng)用，那么無(wú)需運(yùn)行工程，直接修改代碼點(diǎn)擊Apply Changes即可自動(dòng)拉起應(yīng)用，使修改生效，避免再一次全量構(gòu)建。

三是穩(wěn)定性更高：

由于Apply Changes能夠重啟應(yīng)用，能夠及時(shí)進(jìn)行增量補(bǔ)丁的重新加載，避免了潛在的狀態(tài)不一致問(wèn)題，修復(fù)因狀態(tài)污染可能導(dǎo)致的邏輯異常。

Apply Changes 的工作流程涉及根據(jù)緩存信息進(jìn)行差異比較和增量構(gòu)建（如 C++ 修改觸發(fā) CMake），然后通過(guò)停止、修復(fù)、重啟應(yīng)用的步驟完成更新。

它的主要代價(jià)是丟失應(yīng)用狀態(tài)。每次 Apply Changes 后，應(yīng)用都會(huì)回到初始狀態(tài)，需要開(kāi)發(fā)者手動(dòng)操作才能恢復(fù)之前的場(chǎng)景。此外，目前 Apply Changes暫不支持 ArkTS/TS 代碼的增量更新，這部分仍需依賴 Hot Reload 或完整構(gòu)建。

Apply Changes的幾個(gè)實(shí)用小Tips也分享一下：

優(yōu)先 Hot Reload:當(dāng)你主要跟 ArkTS 代碼打交道，特別是頻繁調(diào)整 UI 和前端邏輯時(shí)，用它來(lái)獲得最快的反饋。

切換 Apply Changes:當(dāng)修改涉及 C++、.so、資源文件，或者進(jìn)行 Hot Reload 不支持的復(fù)雜 ArkTS 修改時(shí)，使用 Apply Changes。雖然需要重啟，但比全量構(gòu)建快得多。

定期全量運(yùn)行:在長(zhǎng)時(shí)間開(kāi)發(fā)或進(jìn)行重要節(jié)點(diǎn)測(cè)試前，進(jìn)行一次完整的重新構(gòu)建和運(yùn)行，有助于暴露和清理潛在問(wèn)題，確保應(yīng)用的整體穩(wěn)定性。

在日常開(kāi)發(fā)中，Hot Reload 和 Apply Changes 是相輔相成的。理解并恰當(dāng)運(yùn)用 DevEco Studio 提供的這兩種增量更新機(jī)制，能實(shí)實(shí)在在地提升鴻蒙應(yīng)用的開(kāi)發(fā)調(diào)試效率，幫助開(kāi)發(fā)者將更多精力聚焦于功能實(shí)現(xiàn)和體驗(yàn)優(yōu)化。