【HarmonyOS Next之旅】DevEco Studio使用指南(四)

目录

1 -> 适配OHPM包管理

1.1 -> 历史工程手动迁移

2 -> 关闭数据采集

3 -> 日志上传


1 -> 适配OHPM包管理

OHPM CLI(OpenHarmony Package Manager Command-line Interface) 作为鸿蒙生态三方库的包管理工具,支持共享包的发布、安装和依赖管理。

在DevEco Studio 3.1 Release及更高版本上新建API 9及以上版本的工程将使用ohpm作为默认包管理器。

说明

仅使用npm包管理的API 8/9历史工程需进行迁移。

整体迁移流程如下:

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.1 -> 历史工程手动迁移

迁移前需对工程进行备份。

具体迁移流程如下:

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_file
loglevel 日志级别 log_level

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

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

5. 点击File>Sync and Refresh Project,至此,历史工程手动迁移完成。

2 -> 关闭数据采集

DevEco Studio在首次启动时,弹窗出现提示开启数据采集功能。该功能用于帮助DevEco Studio改进使用体验,收集的数据将按照关于HUAWEI DevEco Studio 平台与隐私的声明处理。

若后续需要关闭数据采集功能,请在File > Settings(macOS为DevEco Studio > Preferences)> Appearance & Behavior > System Settings > Data Sharing设置界面,取消勾选Send usage statistics关闭数据采集开关。

3 -> 日志上传

若开发过程中遇到DevEco Studio卡顿、卡死或其他故障时,可点击IDE Error问题弹窗中Send Report,点击OK后向DevEco Studio回传日志信息。

或通过菜单栏Help > Collect Logs and Diagnostic Data,选择并上传相关日志,帮助DevEco Studio提升稳定性体验。

若后续需要关闭数据采集功能,请在File > Settings(macOS为DevEco Studio > Preferences)> Appearance & Behavior > System Settings > Data Sharing设置界面,取消勾选Send usage statistics关闭数据采集开关。


感谢各位大佬支持!!!

互三啦!!!

猜你喜欢

转载自blog.csdn.net/weixin_74809706/article/details/146286891
今日推荐