?

2025/6/21，最近鴻蒙出最新的API和modelVsersion了，模擬器支持熱更新了（不支持hsp動態共享包），Build Analyzer支持查看構建過程的內存消耗情況，buildOption/resOptions下新增ignoreResourcePattern，用于對資源目錄resources或開發者自定義的資源目錄下的文件/文件夾名稱進行過濾，匹配到的文件不會被打包到產物中，ArkTS代碼調試支持查看異步函數堆棧，那么作者作為開源區up，也特別想要試試去實現版本的更新遷移。

那么如何遷移更新呢？接下來就是手動遷移更新的教程，修改完成，點擊同步即可完成，使用最新的API19。（以三層架構路徑為例，大家可以對照著看，位置差不多）

第一步：

找到根目錄下的該文件，位置為： 根目錄>hvigor>hvigor-config.json5

?編輯

點擊進去，modelVersion修改為如下5.1.1

?編輯

第二步：

找到根目錄的該文件,位置為： 根目錄>build-profile.json5

?編輯

點擊進去，找到app，products里的targetSdkVersion，compatibleSdkVersion，修改為如下

?編輯

第三步：找到根目錄的該文件,位置為： 根目錄>on-package.json5

?編輯

點擊進去，modelVersion修改為如下5.1.1

?編輯

第四步：點擊右上角的Sync Now，運行代碼，即可使用API19

?編輯

溫馨提示：

在API18時，廢棄了很多的API，請注意API更新，但是在ability中，使用 windowStage.getMainWindowSync().getUIContext()官方示例代碼（2025/6/21），去獲取上下文，將會報錯，如何解決這個問題呢，請使用 ，如下代碼

windowStage.getMainWindow().then((win) => {
      const uiContext = win.getUIContext()
      // 儲存安全區域數據
      AppStorage.setOrCreate('safeTop', uiContext.px2vp(top.height))
      AppStorageV2.connect(Number, 'safeTop', () => new Number(uiContext.px2vp(top.height)))

      AppStorage.setOrCreate('safeBottom', uiContext.px2vp(bottom.height))
      AppStorageV2.connect(Number, 'safeBottom', () => new Number(uiContext.px2vp(bottom.height)))
    })

避免程序運行不了，對了AppStorageV2.connect(UIContext,'uiContext',()=>new UIContext())?.getHostContext()，去獲取上下文在ability只能得到為空，只能使用我提供的解決方案，具體的詳解，請參考文檔另一篇文章鴻蒙NEXT-API19獲取上下文，在class中和ability中獲取上下文，API遷移示例-解決無法在EntryAbility中無法使用最新版API獲取上下文。

審核編輯 黃宇

?