HarmonyOS 鸿蒙Next 升级DevEco Studio后打开API 9历史工程提示迁移如何操作

HarmonyOS 鸿蒙Next 升级DevEco Studio后打开API 9历史工程提示迁移如何操作 升级DevEco Studio后，打开API 9的历史工程时，若提示配置迁移：可参考按照如下，选择自动迁移或者手动迁移：

说明：仅API 9历史工程需进行迁移，API 8及以下版本无需迁移。

迁移流程如下：

  1. 迁移配置文件

    • 将工程和模块下npm包管理相关配置文件package.json或.npmrc，迁移为oh-package.json5或.ohpmrc文件。具体操作请参阅手动迁移步骤二。
    • 说明：若原工程中无.npmrc文件，则无需迁移为.ohpmrc文件。

  2. 新增编译构建相关文件

    • 在工程中新增hvigor相关的wrapper文件，包括hvigorw、hvigorw.bat、hvigor-config.json5、hvigor-wrapper.js配置文件。具体操作请参阅手动迁移步骤三。

  3. 删除不再使用的npm包管理文件

    • 包含package.json、package-lock.json、.npmrc、node_modules，工程和模块级别下均需进行删除处理。具体操作请参阅手动迁移步骤四。

迁移前文件目录 | 迁移后文件目录

历史工程自动迁移

  1. 打开API 9历史工程，在右侧Notifications会出现Sync Failed，点击Actions，选择Start automatic configuration migration进入自动化迁移。

  2. 在弹窗中点击Migrate启动自动化迁移。

    • 若自动化迁移失败，请参考下方历史工程手动迁移来完成迁移操作。

历史工程手动迁移

如自动化迁移不成功或希望进行手动迁移，迁移前需对工程进行备份。迁移流程如下：

  1. 在工程/模块级别中，涉及package.json或.npmrc的配置文件处，创建相同目录层级的oh-package.json5或.ohpmrc文件。

    • 说明
    • 若历史工程为C++工程，src>main>cpp目录下包含package.json或.npmrc，需做相同处理。

  2. 将历史工程package.json和.npmrc文件中包含的需要迁移的字段，拷贝到对应的oh-package.json5和.ohpmrc文件中。

表1 oh-package.json5字段及迁移说明

oh-package.json5包含字段 字段说明 迁移/新增字段 原package.json字段 说明
name 软件包名称 迁移字段 name 必选字段，若package.json文件中未指明，需在oh-package.json5添加补齐
version 软件包版本 迁移字段 version 必选字段，若package.json文件中未指明，需在oh-package.json5添加补齐
description 软件包简介 迁移字段 description 必选字段，若package.json文件中未指明，需在oh-package.json5添加补齐
keywords 软件包关键字 迁移字段 keywords -
homepage 主页链接 迁移字段 homepage -
license 开源协议 迁移字段 license -
author 软件包作者 迁移字段 author -
main 软件包入口 迁移字段 main -
repository 仓库地址 迁移字段 repository -
dependencies 生产依赖 迁移字段 dependencies 该字段处理方式请参阅下方说明内容
devDependencies 开发依赖 迁移字段 devDependencies -
types 类型定义 迁移字段 types -
artifactType 共享包类型 新增字段，非必选配置项 - 可选项：
  • original：源码，即发布源码(.ts/.ets)。
  • obfuscation：混淆代码，即源码经过混淆之后发布上传。

说明

  • 工程的package.json文件的dependencies字段处理方式如下：
    • @ohos/hypium：测试框架的依赖，迁移时需要放到oh-package.json5文件的devDependencies字段下；
    • 删除@ohos/hvigor和@ohos/hvigor-ohos-plugin字段，无需迁移到oh-package.json5中；
    • 其他依赖可直接复制到oh-package.json5的dependencies字段中。
  • 除表格中呈现的字段外，package.json中其余字段暂不支持迁移。如您在历史工程中使用到其余字段，请反馈您所使用的字段（选中文本，点击“意见反馈”）。

表2 .npmrc文件迁移字段对照及说明

.npmrc字段 字段释义 .ohpmrc对应字段
registry 仓库地址 registry
@${scope}:registry 指定仓库 @${group}:registry
cache 缓存路径 cache
noproxy 不使用proxy代理 no_proxy
proxy http代理 http_proxy
https-proxy https代理 https_proxy
strict-ssl ssl校验 strict_ssl
cafile ca证书路径 ca_files
loglevel 日志级别 log_level

  1. 工程需要添加ohpm编译构建四件套hvigorw、hvigorw.bat、hvigor-config.json5、hvigor-wrapper.js。可新建一个API 9的新工程，拷贝新工程中hvigorw、hvigorw.bat、hvigor-config.json5、hvigor-wrapper.js四项配置文件，粘贴到历史工程文件夹对应位置。

  2. 删除工程级别和模块级别下包含的package.json、package-lock.json、.npmrc、node_modules四项配置。

  3. 点击File>Synchronize and Refresh Project，至此，历史工程手动迁移完成。


更多关于HarmonyOS 鸿蒙Next 升级DevEco Studio后打开API 9历史工程提示迁移如何操作的实战教程也可以访问 https://www.itying.com/category-93-b0.html

1 回复

更多关于HarmonyOS 鸿蒙Next 升级DevEco Studio后打开API 9历史工程提示迁移如何操作的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


针对HarmonyOS 鸿蒙Next升级DevEco Studio后打开API 9历史工程提示迁移的问题，操作步骤如下：

首先，确保你已经成功升级到了最新版本的DevEco Studio。升级完成后，打开提示需要迁移的API 9历史工程。

在DevEco Studio中，系统可能会自动弹出迁移向导，按照向导的提示逐步进行迁移操作。迁移向导通常会包括检查项目兼容性、更新项目配置、调整代码以适配新版本API等功能。

如果自动迁移向导没有弹出，你可以手动进行迁移。检查项目的build.gradle文件，确保它使用的是与新版本DevEco Studio兼容的插件版本和编译选项。同时，检查代码库中是否有使用到已经废弃或在新版本中有所变动的API，并根据需要进行替换或调整。

此外，还需要注意项目中的资源文件和配置文件是否与新版本兼容。例如，检查AndroidManifest.xml或其他配置文件中的属性是否仍然有效，并根据需要进行更新。

完成上述步骤后，尝试重新构建项目并运行，以确保迁移成功且项目能够正常运行。

如果问题依旧没法解决请联系官网客服，官网地址是：https://www.itying.com/category-93-b0.html，

回到顶部