快速修復是HarmonyOS系統提供給開發者的一種技術手段，支持開發者以遠快于應用升級的方式對應用程序包進行缺陷修復。和全量應用升級軟件版本相比，快速修復的主要優勢在小、快和用戶體驗好。在較短的時間內不中斷正在運行的應用的情況下(即不需要重啟應用)，修復應用的缺陷。

快速修復的使用規則

僅支持修復應用的TS和C++代碼，對應的文件為.abc文件(TS編譯后的文件)和.so文件(C++編譯后的文件)，不支持對資源的修復。

不支持新增.abc文件和.so文件。

快速修復包部署時要確保對應應用包已安裝，如果未安裝，則部署失敗。

快速修復包中配置的包名和應用版本號必須和已安裝的包名和版本號應用相同，如果不同則部署失敗。

如果已經部署過快速修復包，新部署的快速修復包的版本號必須大于之前快速修復包的版本號，否則部署失敗。

快速修復包的簽名信息和待修復的應用的簽名信息必須一致，否則會部署失敗。

新的應用版本發布安裝時，會清理掉快速修復包。

快速修復包結構

上圖是HarmonyOS應用程序發布的快速修復的包格式

從圖中可以看出包含兩種包格式：

appqf(Application Quick Fix)

appqf與應用的app pack包是一一對應關系，具體可參考應用程序包結構的介紹。

appqf包是HarmonyOS應用用于發布到應用市場的單元，不能夠直接安裝到設備上。

它是由一個或多個hqf(Harmony Ability Package Quick Fix)組成，這些hqf包在應用市場會從appqf包中拆分出來，再被分發到具體的設備上。

appqf包上架到應用市場前要有開發者的簽名信息。

hqf(Harmony Ability Package Quick Fix)

hqf包是修復HAP中問題的快速修復包，用于安裝到設備上的快速修復單元。一個hqf可以包含.abc的快速修復文件，.so的快速修復文件和描述該包的配置文件。

.abc文件：應用中修改后的ts代碼，編譯后生成的字節碼文件。

libs目錄：存放.so庫文件的差分文件，以.so.diff為后綴。區分的不同的系統cpu架構，例如arm平臺、x86平臺。

patch.json：

該文件用于描述hqf包版本信息的配置文件，由開發者填寫，具體內容如下：

{
    "app" : {
        "bundleName" : "com.ohos.quickfix",
        "versionCode" : 1000000,
        "versionName" : "1.0.0",
        "patchVersionCode" : 1000000,
        "patchVersionName" : "1.0.0"
    },
    "module" : {
        "name" : "entry",
        "type" : "patch",
        "deviceTypes" : [
        "default",
        "tablet"
        ],
        "originalModuleHash" : "11223344556677889900"
    }
}

 具體字段說明：

快速修復C++編譯后的文件

上圖是通過TS代碼編譯工具生成快速修復.abc文件的流程：

原始應用編譯時，生成.abc文件和.map文件。.abc是TS代碼編譯后的字節碼文件，應用運行時使用該文件。.map文件是通過TS代碼編譯工具編譯TS代碼時生成的中間文件，記錄有代碼中的函數、類等信息。

修復問題后的應用編譯時，根據上述的.map文件，結合當前的TS代碼，得到差異部分，根據差異部分生成快速修復的.abc文件。該.abc文件也既是最終要放到hqf包中的快速修復文件。

上圖是通過差分工具生成快速修復.so文件的流程：

原始應用C++源碼通過編譯工具生成.so文件，該.so文件供應用在運行時使用。

修復問題后的C++源碼通過編譯工具生成.so文件，該.so文件和原應用的.so文件通過差分工具生成.so快速修復文件，該.so快速修復文件也既是最終要放到hqf包中的快速修復文件。

上圖涉及到的模塊如下：

DevEco Studio：用于開發代碼的項目工程的集成開發環境。在快速修復的工程中能夠給予原應用的代碼和修復問題后的代碼生成快速修復包，并完成快速修復包的簽名。

應用市場服務器端：開發者將開發完成的快速修復包上架到該平臺，平臺會對上架的包進行簽名驗證、風險掃描和拆包重簽名等，然后分發到客戶端。

應用市場客戶端：用于接收應用市場服務器端分發的快速修復包，并觸發安裝快速修復包。

包管理服務：設備上用于管理應用包及快速修復包安裝和卸載的系統服務程序。

快速修復引擎：設備上用于管理應用切換使用快速修復包的系統服務程序。如果應用正在運行，快速修復引擎接收到有快速修復包部署完成會通知應用切換快速修復包，進而使得應用使能快速修復包。

文件系統：應用及快速修復包部署在設備上的位置。

上圖是快速修復包的端到端發布部署流程：

開發者通過DevEco Studio，基于原應用的源碼和修復后的源碼編譯打包生成快速修復包，并通過DevEco Studio完成快速修復包的簽名。

將生成的帶有簽名的快速修復包上架到應用市場，應用市場通過驗證簽名、風險掃描和拆包重簽名后進行分發。

設備側的應用市場客戶端檢測到應用市場服務器端有新上架的快速修復包會下載最新版本的快速修復包，接著通過系統中的包管理服務來安裝部署快速修復包。

快速修復包部署完成后，再由快速修復引擎觸發應用使用快速修復包，進而保證用戶使用到問題修復后的功能。

DevEco Studio中暫時還沒有集成快速修復的能力。當前階段，HarmonyOS為開發者提供了命令行的調試開發工具可供使用，具體的調試開發流程如下：

基于原應用的源碼和修復后的源碼，通過命令行工具可以編譯生成快速修復包，并通過命令行簽名工具完成對快速修復的包的簽名。通過命令行調試開發，要對.hqf包簽名，并通過命令行工具將.hqf包安裝到設備上，.appqf包不能直接安裝到設備上。

通過快速修復的命令行工具，將.hqf包安裝部署到設備上。

.hqf包安裝部署完成后，回調通知快速修復引擎觸發應用使用快速修復包，進而保證用戶使用到問題修復后的功能。