diff --git a/zh-cn/application-dev/application-models/start-page.md b/zh-cn/application-dev/application-models/start-page.md index ff276bf674c61d8af9cf1c8170e5f3f9dad258fe..418a5985ae5831d062d20b30482b3b13b983147a 100644 --- a/zh-cn/application-dev/application-models/start-page.md +++ b/zh-cn/application-dev/application-models/start-page.md @@ -70,7 +70,7 @@ struct Index { ``` -当PageAbility的启动模式设置为标准模式或为首次启动单例模式的PageAbility时（具体设置方法和典型场景示例见[PageAbility的启动模式](pageability-launch-type.md)），在调用方PageAbility中，通过want中的parameters参数传递要启动的指定页面的pages信息，调用startAbility()方法启动PageAbility。被调用方可以在onCreate中使用featrueAbility的getWant方法获取want，再通过调用router.push实现启动指定页面。 +当PageAbility的启动模式设置为标准模式或为首次启动单例模式的PageAbility时（具体设置方法和典型场景示例见[PageAbility的启动模式](pageability-launch-type.md)），在调用方PageAbility中，通过want中的parameters参数传递要启动的指定页面的pages信息，调用startAbility()方法启动PageAbility。被调用方可以在onCreate中使用featureAbility的getWant方法获取want，再通过调用router.push实现启动指定页面。 调用方的页面中实现按钮点击触发startAbility方法启动目标端PageAbility，startAbility方法的入参want中携带指定页面信息，示例代码如下： @@ -119,7 +119,7 @@ struct Index { ``` -目标端PageAbility的onCreate生命周期回调中通过featrueAbility的getWant方法获取want，并对参数进行解析，实现指定页面拉起： +目标端PageAbility的onCreate生命周期回调中通过featureAbility的getWant方法获取want，并对参数进行解析，实现指定页面拉起： ```ts import featureAbility from '@ohos.ability.featureAbility'; diff --git a/zh-cn/application-dev/quick-start/figures/hap-release.png b/zh-cn/application-dev/quick-start/figures/hap-release.png index 535c7ab70ee83ff9ef6ad69936e629c97a930035..8cdc278fa3b9c2cf3157ba475a2a6b235fefcff7 100644 Binary files a/zh-cn/application-dev/quick-start/figures/hap-release.png and b/zh-cn/application-dev/quick-start/figures/hap-release.png differ diff --git a/zh-cn/application-dev/quick-start/multi-hap-build-view.md b/zh-cn/application-dev/quick-start/multi-hap-build-view.md index 35255cd1a9f579149b4dbc3ee98cb6f6d26b8e90..b45343e654d906902445f943bcbd69edbd75f48c 100644 --- a/zh-cn/application-dev/quick-start/multi-hap-build-view.md +++ b/zh-cn/application-dev/quick-start/multi-hap-build-view.md @@ -16,8 +16,8 @@ IDE支持在一个应用工程中进行多个HAP的开发与构建，如[多HAP **说明：** - 该目录由IDE自动生成，名称不可更改。 - AppScope目录下面的文件名与Entry、Feature模块下面的文件名不能重复，否则IDE会报错。 - - entry或者featrue目录（名称可由开发者自定义） - - 由IDE引导开发者创建的Module，在该Module中实现应用的业务逻辑；可以创建多个Module，图中entry和featrue即是创建的两个Module。 + - entry或者feature目录（名称可由开发者自定义） + - 由IDE引导开发者创建的Module，在该Module中实现应用的业务逻辑；可以创建多个Module，图中entry和feature即是创建的两个Module。 - resources目录：放置该Module中所使用到的资源。 - ets目录：开发者的业务逻辑。 - [module.json5](module-configuration-file.md)：配置该Module的描述信息，如：Module的名称、Module的入口代码路径、包含的组件信息等。 diff --git a/zh-cn/application-dev/quick-start/multi-hap-release-deployment.md b/zh-cn/application-dev/quick-start/multi-hap-release-deployment.md index 753eeee6cd73fb8f4a5adf2ffaa77799f32fb1bf..d592140c8371f4a16346248d401cc3f39a91d303 100644 --- a/zh-cn/application-dev/quick-start/multi-hap-release-deployment.md +++ b/zh-cn/application-dev/quick-start/multi-hap-release-deployment.md @@ -9,29 +9,37 @@ 开发者通过[DevEco Studio](https://developer.harmonyos.com/cn/develop/deveco-studio)工具按照业务的需要创建多个Module，在相应的Module中完成自身业务的开发。 ## 调试 -通过DevEco Studio编译打包，生成单个或者多个HAP，即可基于HAP进行调试。 +通过DevEco Studio编译打包，生成单个或者多个HAP，即可基于HAP进行调试。在调试前，需要先安装或更新HAP，以下介绍具体做法。 * 使用DevEco Studio进行调试 使用指导可参考[应用程序包调试方法](https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ohos-debugging-and-running-0000001263040487#section10491183521520)，其中包括了单HAP与多HAP通过DevEco Studio工具的安装调试方法。 -* 使用[hdc_std工具](../../device-dev/subsystems/subsys-toolchain-hdc-guide.md)(可通过OpenHarmony SDK获取，在SDK的toolchains目录下)进行调试 +* 使用[hdc工具](../../device-dev/subsystems/subsys-toolchain-hdc-guide.md)(可通过OpenHarmony SDK获取，在SDK的toolchains目录下)进行调试 + + 在调试前，需要先安装或更新HAP，此处有两种方式。 + + 1. 直接使用hdc安装、更新HAP。 + + HAP的路径为开发平台上的文件路径，以Windows开发平台为例，命令参考如下： - 使用hdc_std安装HAP时，HAP的路径为开发平台上的文件路径，以Windows开发平台为例，命令参考如下： ``` // 安装、更新，多HAP可以指定多个文件路径 - hdc_std install C:\entry.hap C:\feature.hap + hdc install C:\entry.hap C:\feature.hap // 执行结果 install bundle successfully. // 卸载 - hdc_std uninstall com.example.myapplication + hdc uninstall com.example.myapplication // 执行结果 uninstall bundle successfully. ``` + + 2. 先执行hdc shell，再使用bm工具安装、更新HAP。 -* 使用[bm工具](../../application-dev/tools/bm-tool.md)进行调试 - - 使用bm工具进行安装、更新HAP时，传入的文件路径为真机上 的文件路径，命令参考如下： + HAP的文件路径为真机上的文件路径，命令参考如下： + ``` + // 先执行hdc shell才能使用bm工具 + hdc shell // 安装、更新，多HAP可以指定多个文件路径 bm install -p /data/app/entry.hap /data/app/feature.hap // 执行结果 @@ -41,6 +49,8 @@ // 执行结果 uninstall bundle successfully. ``` + 完成HAP安装或更新后，即可参考相关调试命令进行[调试](https://docs.openharmony.cn/pages/v3.2Beta/zh-cn/application-dev/tools/aa-tool.md/)。 + ## 发布 当开发的程序包满足发布要求时，可以在工具中打包编译生成App包。将该App包上架到应用市场云端，应用市场会对上架的App包校验签名，校验签名通过后会将App包中的HAP拆分出来，同时对拆分出的HAP重新添加签名，然后对HAP进行分发。 diff --git a/zh-cn/application-dev/quick-start/multi-hap-rules.md b/zh-cn/application-dev/quick-start/multi-hap-rules.md index df77b090d6dd40f522b6c9d779a22104aff5d7de..f93b0a208a9962263a897f6d8a711887ebfa38ab 100644 --- a/zh-cn/application-dev/quick-start/multi-hap-rules.md +++ b/zh-cn/application-dev/quick-start/multi-hap-rules.md @@ -7,7 +7,7 @@ - App Pack包中所有HAP的配置文件中的versionCode标签必须一致。 -- App Pack包中同一设备类型的所有HAP中必须有且只有一个entry类型的HAP，featrue类型的HAP可以有一个或者多个，也可以没有。 +- App Pack包中同一设备类型的所有HAP中必须有且只有一个entry类型的HAP，feature类型的HAP可以有一个或者多个，也可以没有。 - App Pack包中的每个HAP必须配置moduleName标签，同一设备类型的所有HAP对应的moduleName标签必须唯一。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-bundleManager-applicationInfo.md b/zh-cn/application-dev/reference/apis/js-apis-bundleManager-applicationInfo.md index c0c78d5314de14552ffe72ffc43860e8feb07871..5a60a7b6ac2c192b3f5a2aceee32c2fd72135f5e 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-bundleManager-applicationInfo.md +++ b/zh-cn/application-dev/reference/apis/js-apis-bundleManager-applicationInfo.md @@ -12,12 +12,12 @@ | 名称 | 类型 | 可读 | 可写 | 说明 | | -------------------------- | ------------------------------------------------------------ | ---- | ---- | ------------------------------------------------------------ | | name | string | 是 | 否 | 应用程序的名称。 | -| description | string | 是 | 否 | 标识应用的描述信息。 | +| description | string | 是 | 否 | 标识应用的描述信息，使用示例："description": $string: mainability_description"。 | | descriptionId | number | 是 | 否 | 标识应用的描述信息的资源id。 | | enabled | boolean | 是 | 否 | 判断应用程序是否可以使用，默认为true。 | -| label | string | 是 | 否 | 标识应用的名称。 | +| label | string | 是 | 否 | 标识应用的名称，使用示例："label": "$string: mainability_description"。| | labelId | number | 是 | 否 | 标识应用名称的资源id。 | -| icon | string | 是 | 否 | 应用程序的图标。 | +| icon | string | 是 | 否 | 应用程序的图标，使用示例："icon": "$media:icon"。 | | iconId | number | 是 | 否 | 应用程序图标的资源id。 | | process | string | 是 | 否 | 应用程序的进程，如果不设置，默认为包的名称。 | | permissions | Array\ | 是 | 否 | 访问应用程序所需的权限，通过调用[bundleManager.getApplicationInfo](js-apis-bundleManager.md#bundlemanagergetapplicationinfo)接口，传入GET_APPLICATION_INFO_WITH_PERMISSION获取。 | @@ -26,9 +26,9 @@ | removable | boolean | 是 | 否 | 应用程序是否可以被移除。 | | accessTokenId | number | 是 | 否 | 应用程序的accessTokenId。 | | uid | number | 是 | 否 | 应用程序的uid。 | -| iconResource | [Resource](js-apis-resource-manager.md#resource9) | 是 | 否 | 应用程序的图标资源信息。 | -| labelResource | [Resource](js-apis-resource-manager.md#resource9) | 是 | 否 | 应用程序的标签资源信息。 | -| descriptionResource | [Resource](js-apis-resource-manager.md#resource9) | 是 | 否 | 应用程序的描述资源信息。 | +| iconResource | [Resource](js-apis-resource-manager.md#resource9) | 是 | 否 | 应用程序的图标资源信息，通过ApplicationInfo 获取的resource 包含了该资源的信息的bundleName、moduleName 和 id，可以调用全球化的接口[@ohos.resourceManager.d.ts](https://gitee.com/openharmony/interface_sdk-js/blob/master/api/@ohos.resourceManager.d.ts)中的getMediaContent来获取详细的资源数据信息。 | +| labelResource | [Resource](js-apis-resource-manager.md#resource9) | 是 | 否 | 应用程序的标签资源信息，通过ApplicationInfo 获取的resource 包含了该资源的信息的bundleName、moduleName 和 id，可以调用全球化的接口[@ohos.resourceManager.d.ts](https://gitee.com/openharmony/interface_sdk-js/blob/master/api/@ohos.resourceManager.d.ts)中的getMediaContent来获取详细的资源数据信息。 | +| descriptionResource | [Resource](js-apis-resource-manager.md#resource9) | 是 | 否 | 应用程序的描述资源信息，通过ApplicationInfo 获取的resource 包含了该资源的信息的bundleName、moduleName 和 id，可以调用全球化的接口[@ohos.resourceManager.d.ts](https://gitee.com/openharmony/interface_sdk-js/blob/master/api/@ohos.resourceManager.d.ts)中的getMediaContent来获取详细的资源数据信息。| | appDistributionType | string | 是 | 否 | 应用程序签名证书的分发类型，分为：app_gallery、enterprise、os_integration和crowdtesting。 | | appProvisionType | string | 是 | 否 | 应用程序签名证书文件的类型，分为debug和release两种类型。 | | systemApp | boolean | 是 | 否 | 标识应用是否为系统应用。 | \ No newline at end of file diff --git a/zh-cn/application-dev/tools/aa-tool.md b/zh-cn/application-dev/tools/aa-tool.md index 3a5665c2767600fbb10d83fe4bc97ce5ba5fe5d5..eb3c727c7128072b7d51d3303448fc6ad30b299f 100644 --- a/zh-cn/application-dev/tools/aa-tool.md +++ b/zh-cn/application-dev/tools/aa-tool.md @@ -1,7 +1,11 @@ # aa工具 -Ability assistant（Ability助手，简称为aa），是实现应用及测试用例启动功能的工具，为开发者提供基本的应用调试和测试的能力。通过该工具，开发者可以在hdc shell中，发送命令以执行各种系统操作，例如启动应用组件、强制停止进程、打印应用组件相关信息等。 +Ability assistant（Ability助手，简称为aa），是实现应用及测试用例启动功能的工具，为开发者提供基本的应用调试和测试能力，例如启动应用组件、强制停止进程、打印应用组件相关信息等。 + +> **说明：** +> +> 在使用本工具前，开发者需要先获取[hdc工具](../../device-dev/subsystems/subsys-toolchain-hdc-guide.md)，执行hdc shell。 - help diff --git a/zh-cn/application-dev/tools/anm-tool.md b/zh-cn/application-dev/tools/anm-tool.md index f91ad97ae854237ac5ec4afbae827f62a23494d3..11cfcb7f4894ba60e2165e6280cbc1598679d32c 100644 --- a/zh-cn/application-dev/tools/anm-tool.md +++ b/zh-cn/application-dev/tools/anm-tool.md @@ -1,6 +1,10 @@ # anm工具 -Advanced Notification Manager（通知管理工具，简称anm）是实现通知打印、设置通知参数等功能的工具，为开发者提供基本的通知调试和测试能力。通过该工具，开发者可以在hdc shell中，发送命令以执行各种系统操作，例如打印已发布通知详细信息、设置通知缓存个数、使能通知等。 +Advanced Notification Manager（通知管理工具，简称anm）是实现通知打印、设置通知参数等功能的工具，为开发者提供基本的通知调试和测试能力，例如打印已发布通知详细信息、设置通知缓存个数、使能通知等。 + +> **说明：** +> +> 在使用本工具前，开发者需要先获取[hdc工具](../../device-dev/subsystems/subsys-toolchain-hdc-guide.md)，执行hdc shell。 ### help diff --git a/zh-cn/application-dev/tools/bm-tool.md b/zh-cn/application-dev/tools/bm-tool.md index 6b7fade3819c991b669bb5b3d183f208cdbee0c0..da66b105073487925e953c5a64fa332fa7925469 100644 --- a/zh-cn/application-dev/tools/bm-tool.md +++ b/zh-cn/application-dev/tools/bm-tool.md @@ -1,7 +1,11 @@ # bm工具 -Bundle Manager（包管理工具，简称bm）是实现应用安装、卸载、更新、查询等功能的工具，bm为开发者提供基本的应用安装包的调试能力，开发者可以在hdc shell中，执行bm命令以触发各种系统操作，例如：安装应用，卸载应用，查询安装包信息等。 +Bundle Manager（包管理工具，简称bm）是实现应用安装、卸载、更新、查询等功能的工具，bm为开发者提供基本的应用安装包的调试能力，例如：安装应用，卸载应用，查询安装包信息等。 + +> **说明：** +> +> 在使用本工具前，开发者需要先获取[hdc工具](../../device-dev/subsystems/subsys-toolchain-hdc-guide.md)，执行hdc shell。 **表1** bm工具命令列表 diff --git a/zh-cn/application-dev/tools/cem-tool.md b/zh-cn/application-dev/tools/cem-tool.md index a799e27b7c3b482e9eeba092d4c48f5821779a2a..7f7f4b03bef40c2acd13ca5a474abd3478a6fc79 100644 --- a/zh-cn/application-dev/tools/cem-tool.md +++ b/zh-cn/application-dev/tools/cem-tool.md @@ -1,6 +1,10 @@ # cem工具 -Common Event Manager（公共事件管理工具， 简称cem）是实现公共事件信息打印、发布公共事件等功能的工具，为开发者提供基本的公共事件调试和测试能力。通过该工具，开发者可以在hdc shell中，发送命令执行各种系统操作，例如打印所有公共事件订阅者、已发送公共事件和接受者、模拟发布公共事件等。 +Common Event Manager（公共事件管理工具， 简称cem）是实现公共事件信息打印、发布公共事件等功能的工具，为开发者提供基本的公共事件调试和测试能力，例如打印所有公共事件订阅者、已发送公共事件和接受者、模拟发布公共事件等。 + +> **说明：** +> +> 在使用本工具前，开发者需要先获取[hdc工具](../../device-dev/subsystems/subsys-toolchain-hdc-guide.md)，执行hdc shell。 ## cem调试助手