diff --git a/en/react-native-community-progress-bar-android.md b/en/react-native-community-progress-bar-android.md index eb800a60d34bc5f8e26802d299b74edb1a2607ae..8e9dc8dd3ac93babf255c0baefacdf4218b7dd5a 100644 --- a/en/react-native-community-progress-bar-android.md +++ b/en/react-native-community-progress-bar-android.md @@ -14,17 +14,18 @@ > [!TIP] [GitHub address](https://github.com/react-native-oh-library/progress-bar-android) +## Installation and Usage + Please check the corresponding version information at the third-party library's Releases page: | Library Version | Release Info | Supported RN Version | | ---------- | ------------------------------------------------------------ | ---------- | -| 1.0.4 | [@react-native-oh-tpl/progress-bar-android Releases](https://github.com/react-native-oh-library/progress-bar-android/releases) | 0.72 | -| 1.1.0 | @react-native-ohos/progress-bar-android Releases | 0.77 | +| <= 1.0.4-0.1.1@deprecated | [@react-native-oh-tpl/progress-bar-android Releases(deprecated)](https://github.com/react-native-oh-library/progress-bar-android/releases) | 0.72 | +| 1.0.6 | [@react-native-ohos/progress-bar-android Releases](https://gitcode.com/openharmony-sig/rntpc_progress-bar-android/releases) | 0.72 | +| 1.1.0 | [@react-native-ohos/progress-bar-android Releases](https://gitcode.com/openharmony-sig/rntpc_progress-bar-android/releases) For older versions that are not published to npm, please refer to the [installation guide](/en/tgz-usage-en.md) to install the tgz package. -## Installation and Usage - Enter the project directory and execute the following command: @@ -32,18 +33,12 @@ Enter the project directory and execute the following command: #### **yarn** ```bash -# 0.72 -yarn add @react-native-oh-tpl/progress-bar-android -# 0.77 yarn add @react-native-ohos/progress-bar-android ``` #### **npm** ```bash -# 0.72 -npm install @react-native-oh-tpl/progress-bar-android -# 0.77 npm install @react-native-ohos/progress-bar-android ``` @@ -68,7 +63,9 @@ export default function ProgressBarExample() { ## Link -Currently, HarmonyOS does not support AutoLink. Therefore, you need to manually configure the linking. +Version >= @react-native-ohos/progress-bar-android@1.0.6 now supports Autolink without requiring manual configuration, currently only supports 72 frameworks. Autolink Framework Guide Documentation: https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md + +This step provides guidance for manually configuring native dependencies. Open the `harmony` directory of the HarmonyOS project in DevEco Studio. @@ -94,17 +91,6 @@ Method 1 (recommended): Use the HAR file. Open `entry/oh-package.json5` file and add the following dependencies: -* 0.72 - -```json -"dependencies": { - "@rnoh/react-native-openharmony": "file:../react_native_openharmony", - "@react-native-oh-tpl/progress-bar-android": "file:../../node_modules/@react-native-oh-tpl/progress-bar-android/harmony/progress_bar_android.har" - } -``` - -* 0.77 - ```json "dependencies": { "@rnoh/react-native-openharmony": "file:../react_native_openharmony", @@ -127,6 +113,8 @@ Method 2: Directly link to the source code. ### 3. Configuring CMakeLists and Introducing ProgressBarAndroidPackage +> If you are using version <= 1.0.4-0.1.1, please skip this chapter. + Open `entry/src/main/cpp/CMakeLists.txt` and add the following code: ```diff @@ -148,9 +136,6 @@ add_subdirectory("${RNOH_CPP_DIR}" ./rn) # RNOH_BEGIN: manual_package_linking_1 add_subdirectory("../../../../sample_package/src/main/cpp" ./sample-package) -# 0.72 -+ add_subdirectory("${OH_MODULES}/@react-native-oh-tpl/progress-bar-android/src/main/cpp" ./progress-bar-android) -# 0.77 + add_subdirectory("${OH_MODULES}/@react-native-ohos/progress-bar-android/src/main/cpp" ./progress-bar-android) # RNOH_END: manual_package_linking_1 @@ -194,9 +179,6 @@ Find `function buildCustomRNComponent()`, which is usually located in `entry/src ```diff ... -# 0.72 -+ import { ProgressBarAndroid, PROGRESS_BAR_TYPE } from "@react-native-oh-tpl/progress-bar-android" -# 0.77 + import { ProgressBarAndroid, PROGRESS_BAR_TYPE } from "@react-native-ohos/progress-bar-android" @Builder @@ -243,11 +225,13 @@ Then build and run the code. ### Compatibility -This document is verified based on the following versions: +To use this repository, you need to use the correct React-Native and RNOH versions. In addition, you need to use DevEco Studio and the ROM on your phone. -1. RNOH：0.72.33; SDK：OpenHarmony 5.0.0.71(API Version 12 Release); IDE：DevEco Studio 5.0.3.900; ROM：NEXT.0.0.71; +Verified in the following versions. -2. RNOH：0.77.18; SDK：HarmonyOS 6.0.0 Release SDK; IDE：DevEco Studio 6.0.0.868; ROM： 6.0.0.112; +1. RNOH: 0.72.96; SDK: HarmonyOS 6.0.0 Release SDK; IDE: DevEco Studio 6.0.0.858; ROM: 6.0.0.112; +2. RNOH: 0.72.33; SDK: HarmonyOS NEXT B1; IDE: DevEco Studio: 5.0.3.900; ROM: Next.0.0.71; +3. RNOH: 0.77.18; SDK: HarmonyOS 6.0.0 Release SDK; IDE: DevEco Studio 6.0.0.858; ROM: 6.0.0.112; ## Properties diff --git a/en/react-native-community-push-notification-ios.md b/en/react-native-community-push-notification-ios.md index e2b369b3eb3c10e48b417d32d86fc8015a8c6222..02e8ec72471247e5365262c5e50a14cea12c2da0 100644 --- a/en/react-native-community-push-notification-ios.md +++ b/en/react-native-community-push-notification-ios.md @@ -12,8 +12,8 @@ | Third-party Library Version | Release Information | Supported RN Version | | ---------- | ------------------------------------------------------------ | ---------- | | <= 1.11.0-0.1.3@deprecated | [@react-native-oh-tpl/push-notification-ios Releases(deprecated)](https://github.com/react-native-oh-library/react-native-push-notification-ios/releases) | 0.72 | -| 1.11.2 | [@react-native-ohos/push-notification-ios Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-push-notification-ios/releases) | 0.72 | -| 1.12.0 | [@react-native-ohos/push-notification-ios Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-push-notification-ios/releases) | 0.77 | +| 1.11.2 | [@react-native-ohos/push-notification-ios Releases](https://gitcode.com/openharmony-sig/rntpc_ios/releases) | 0.72 | +| 1.12.0 | [@react-native-ohos/push-notification-ios Releases](https://gitcode.com/openharmony-sig/rntpc_ios/releases) | 0.77 | For older versions that are not published to npm, please refer to the [installation guide](/en/tgz-usage-en.md) to install the tgz package. @@ -165,7 +165,7 @@ export const App = () => { ## 2. Manual Link -Version >= @react-native-ohos/react-native-background-fetch@4.2.6 now supports Autolink without requiring manual configuration(The content that still needs to be manually configured has been marked in the corresponding title), currently only supports 72 frameworks. +Version >= @react-native-ohos/push-notification-ios@1.11.2 now supports Autolink without requiring manual configuration(The content that still needs to be manually configured has been marked in the corresponding title), currently only supports 72 frameworks. Autolink Framework Guide Documentation: https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md This step provides guidance for manually configuring native dependencies. diff --git a/en/react-native-incall-manager.md b/en/react-native-incall-manager.md index 55c0e2934a8fcef98816b5d8134724c009717cec..a75e415328526fde111925bb8c0b918f8319d47c 100644 --- a/en/react-native-incall-manager.md +++ b/en/react-native-incall-manager.md @@ -25,7 +25,7 @@ Please refer to the Releases page of the third-party library for the correspondi | ---------- | ------------------------------------------------------------ | ---------- | | <= 4.2.0-0.0.4@deprecated | [@react-native-oh-tpl/react-native-incall-manager Releases(deprecated)](https://github.com/react-native-oh-library/react-native-incall-manager/releases) | 0.72 | | 4.2.1 | [@react-native-ohos/react-native-incall-manager Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-incall-manager/releases) | 0.72 | -| 4.2.2 | [@react-native-ohos/react-native-incall-manager Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-incall-manager/releases) | 0.77 | +| 4.3.0 | [@react-native-ohos/react-native-incall-manager Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-incall-manager/releases) | 0.77 | For older versions not published on npm, please refer to the [Installation Guide](/en/tgz-usage-en.md) to install the tgz package. diff --git a/en/react-native-splash-screen.md b/en/react-native-splash-screen.md index b2952f7848f1a98c80d5afecbd1b11e0f225f650..5bb8bb6f69c23fa7d5b64600cafa550f8bb9088d 100644 --- a/en/react-native-splash-screen.md +++ b/en/react-native-splash-screen.md @@ -13,7 +13,7 @@ Please refer to the Releases page of the third-party library for the correspondi | Third-party Library Version | Release Information | Supported RN Version | |-----------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------| ---------- | | <= 3.3.0-0.0.2@deprecated | [@react-native-oh-tpl/react-native-splash-screen Releases(deprecated)](https://github.com/react-native-oh-library/react-native-splash-screen/releases) | 0.72 | -| 3.3.1 | [@react-native-ohos/react-native-splash-screen Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-splash-screen/releases) | 0.72 | +| 3.3.2 | [@react-native-ohos/react-native-splash-screen Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-splash-screen/releases) | 0.72 | | 3.4.0 | [@react-native-ohos/react-native-splash-screen Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-splash-screen/releases) | 0.77 | For older versions not published on npm, please refer to the [Installation Guide](/en/tgz-usage-en.md) to install the tgz package. @@ -95,13 +95,13 @@ export default class WelcomePage extends Component { ## 2. Use Codegen -Version >= @react-native-ohos/react-native-splash-screen@3.3.1, compatible with codegen-lib for generating bridge code. +Version >= @react-native-ohos/react-native-splash-screen@3.3.2, compatible with codegen-lib for generating bridge code. If this repository has been adapted to `Codegen`, generate the bridge code of the third-party library by using the `Codegen`. For details, see [Codegen Usage Guide](/en/codegen.md). ## 3. Manual Link -Version >= @react-native-ohos/react-native-splash-screen@3.3.1 now supports Autolink without requiring manual configuration, currently only supports 72 frameworks. Autolink Framework Guide Documentation: https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md +Version >= @react-native-ohos/react-native-splash-screen@3.3.2 now supports Autolink without requiring manual configuration, currently only supports 72 frameworks. Autolink Framework Guide Documentation: https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md This step provides guidance for manually configuring native dependencies. diff --git a/zh-cn/react-native-community-progress-bar-android.md b/zh-cn/react-native-community-progress-bar-android.md index 9fe070ba82cc376b333fb1a649d1045bdd11385f..4f67e33164f7cfac0a0db9224fa06a11996e4a42 100644 --- a/zh-cn/react-native-community-progress-bar-android.md +++ b/zh-cn/react-native-community-progress-bar-android.md @@ -14,17 +14,18 @@ > [!TIP] [Github 地址](https://github.com/react-native-oh-library/progress-bar-android) +## 安装与使用 + 请到三方库的 Releases 发布地址查看配套的版本信息: -| 三方库版本 | 发布信息 | 支持RN版本 | -| ---------- | ------------------------------------------------------------ | ---------- | -| 1.0.4 | [@react-native-oh-tpl/progress-bar-android Releases](https://github.com/react-native-oh-library/progress-bar-android/releases) | 0.72 | -| 1.1.0 | @react-native-ohos/progress-bar-android Releases | 0.77 | +| 三方库版本 | 发布信息 | 支持RN版本 | +|-------| ------------------------------------------------------------ | ---------- | +| <= 1.0.4-0.1.1@deprecated | [@react-native-oh-tpl/progress-bar-android Releases(deprecated)](https://github.com/react-native-oh-library/progress-bar-android/releases) | 0.72 | +| 1.0.6 | [@react-native-ohos/progress-bar-android Releases](https://gitcode.com/openharmony-sig/rntpc_progress-bar-android/releases) | 0.72 | +| 1.1.0 | [@react-native-ohos/progress-bar-android Releases](https://gitcode.com/openharmony-sig/rntpc_progress-bar-android/releases) | 0.77 | 对于未发布到npm的旧版本，请参考[安装指南](/zh-cn/tgz-usage.md)安装tgz包。 -## 安装与使用 - 进入到工程目录并输入以下命令： @@ -32,18 +33,12 @@ #### **yarn** ```bash -# 0.72 -yarn add @react-native-oh-tpl/progress-bar-android -# 0.77 yarn add @react-native-ohos/progress-bar-android ``` #### **npm** ```bash -# 0.72 -npm install @react-native-oh-tpl/progress-bar-android -# 0.77 npm install @react-native-ohos/progress-bar-android ``` @@ -68,7 +63,10 @@ export default function ProgressBarExample() { ## Link -目前 HarmonyOS 暂不支持 AutoLink，所以 Link 步骤需要手动配置。 +Version >= @react-native-ohos/progress-bar-android@1.0.6，已支持 Autolink，无需手动配置，目前只支持72框架。 +Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md + +此步骤为手动配置原生依赖项的指导。 首先需要使用 DevEco Studio 打开项目里的 HarmonyOS 工程 `harmony` @@ -97,17 +95,6 @@ export default function ProgressBarExample() { 打开 `entry/oh-package.json5`，添加以下依赖 -* 0.72 - -```json -"dependencies": { - "@rnoh/react-native-openharmony": "file:../react_native_openharmony", - "@react-native-oh-tpl/progress-bar-android": "file:../../node_modules/@react-native-oh-tpl/progress-bar-android/harmony/progress_bar_android.har" - } -``` - -* 0.77 - ```json "dependencies": { "@rnoh/react-native-openharmony": "file:../react_native_openharmony", @@ -130,6 +117,8 @@ ohpm install ### 3.配置 CMakeLists 和引入 ProgressBarAndroidPackage +> 若使用的是 <= 1.0.4-0.1.1 版本，请跳过本章。 + 打开 `entry/src/main/cpp/CMakeLists.txt`，添加： ```diff @@ -151,9 +140,6 @@ add_subdirectory("${RNOH_CPP_DIR}" ./rn) # RNOH_BEGIN: manual_package_linking_1 add_subdirectory("../../../../sample_package/src/main/cpp" ./sample-package) -# 0.72 -+ add_subdirectory("${OH_MODULES}/@react-native-oh-tpl/progress-bar-android/src/main/cpp" ./progress-bar-android) -# 0.77 + add_subdirectory("${OH_MODULES}/@react-native-ohos/progress-bar-android/src/main/cpp" ./progress-bar-android) # RNOH_END: manual_package_linking_1 @@ -197,9 +183,6 @@ std::vector> PackageProvider::getPackages(Package::Cont ```diff ... -# 0.72 -+ import { ProgressBarAndroid, PROGRESS_BAR_TYPE } from "@react-native-oh-tpl/progress-bar-android" -# 0.77 + import { ProgressBarAndroid, PROGRESS_BAR_TYPE } from "@react-native-ohos/progress-bar-android" @Builder export function buildCustomRNComponent(ctx: ComponentBuilderContext) { @@ -246,11 +229,13 @@ ohpm install ### 兼容性 -本文档内容基于以下版本验证通过： +要使用此库，需要使用正确的 React-Native 和 RNOH 版本。另外，还需要使用配套的 DevEco Studio 和 手机 ROM。 -1. RNOH：0.72.33; SDK：OpenHarmony 5.0.0.71(API Version 12 Release); IDE：DevEco Studio 5.0.3.900; ROM：NEXT.0.0.71; +在以下版本验证通过： -2. RNOH：0.77.18; SDK：HarmonyOS 6.0.0 Release SDK; IDE：DevEco Studio 6.0.0.868; ROM： 6.0.0.112; +1. RNOH: 0.72.96; SDK: HarmonyOS 6.0.0 Release SDK; IDE: DevEco Studio 6.0.0.858; ROM: 6.0.0.112; +2. RNOH: 0.72.33; SDK: HarmonyOS NEXT B1; IDE: DevEco Studio: 5.0.3.900; ROM: Next.0.0.71; +3. RNOH: 0.77.18; SDK: HarmonyOS 6.0.0 Release SDK; IDE: DevEco Studio 6.0.0.858; ROM: 6.0.0.112; ## 属性 diff --git a/zh-cn/react-native-community-push-notification-ios.md b/zh-cn/react-native-community-push-notification-ios.md index 9b8aa1903c4e6035f9dfbb4229ede8e90397d022..6da7b8514da6cd53fdd39f9f95f7760dbf4abf61 100644 --- a/zh-cn/react-native-community-push-notification-ios.md +++ b/zh-cn/react-native-community-push-notification-ios.md @@ -12,8 +12,8 @@ | 三方库版本 | 发布信息 | 支持RN版本 | | ---------- | ------------------------------------------------------------ | ---------- | | <= 1.11.0-0.1.3@deprecated | [@react-native-oh-tpl/push-notification-ios Releases(deprecated)](https://github.com/react-native-oh-library/react-native-push-notification-ios/releases) | 0.72 | -| 1.11.2 | [@react-native-ohos/push-notification-ios Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-push-notification-ios/releases) | 0.72 | -| 1.12.0 | [@react-native-ohos/push-notification-ios Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-push-notification-ios/releases) | 0.77 | +| 1.11.2 | [@react-native-ohos/push-notification-ios Releases](https://gitcode.com/openharmony-sig/rntpc_ios/releases) | 0.72 | +| 1.12.0 | [@react-native-ohos/push-notification-ios Releases](https://gitcode.com/openharmony-sig/rntpc_ios/releases) | 0.77 | 对于未发布到npm的旧版本，请参考[安装指南](/zh-cn/tgz-usage.md)安装tgz包。 @@ -165,7 +165,7 @@ export const App = () => { ## 2. Manual Link -Version >= @react-native-ohos/react-native-background-fetch@4.2.6，已支持 Autolink，无需手动配置（仍需手动配置的内容已在对应标题处标记），目前只支持72框架。 Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md +Version >= @react-native-ohos/push-notification-ios@1.11.2，已支持 Autolink，无需手动配置（仍需手动配置的内容已在对应标题处标记），目前只支持72框架。 Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md 此步骤为手动配置原生依赖项的指导。 diff --git a/zh-cn/react-native-incall-manager.md b/zh-cn/react-native-incall-manager.md index 4a4f208d7646cc254d9360aa0945b37bac02d2dd..3cf8955000b2300d8725b93304bfcc84ff540991 100644 --- a/zh-cn/react-native-incall-manager.md +++ b/zh-cn/react-native-incall-manager.md @@ -26,7 +26,7 @@ | ---------- | ------------------------------------------------------------ | ---------- | | <= 4.2.0-0.0.4@deprecated | [@react-native-oh-tpl/react-native-incall-manager Releases(deprecated)](https://github.com/react-native-oh-library/react-native-incall-manager/releases) | 0.72 | | 4.2.1 | [@react-native-ohos/react-native-incall-manager Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-incall-manager/releases) | 0.72 | -| 4.2.2 | [@react-native-ohos/react-native-incall-manager Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-incall-manager/releases) | 0.77 | +| 4.3.0 | [@react-native-ohos/react-native-incall-manager Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-incall-manager/releases) | 0.77 | 对于未发布到npm的旧版本，请参考[安装指南](/zh-cn/tgz-usage.md)安装tgz包。 @@ -497,7 +497,7 @@ export default function InCallManagerExample() { ``` ## Link -Version > @react-native-ohos/react-native-incall-manager@4.2.1，已支持 Autolink，无需手动配置，目前只支持72框架。 +Version >= @react-native-ohos/react-native-incall-manager@4.2.1，已支持 Autolink，无需手动配置，目前只支持72框架。 Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md 此步骤为手动配置原生依赖项的指导。 diff --git a/zh-cn/react-native-splash-screen.md b/zh-cn/react-native-splash-screen.md index 96c5f7e7540a3041ba24401d7ddf8b073b66b035..51abd01e004e6f181da6c58c0b89e505cbdc7a27 100644 --- a/zh-cn/react-native-splash-screen.md +++ b/zh-cn/react-native-splash-screen.md @@ -13,7 +13,7 @@ | 三方库版本 | 发布信息 | 支持RN版本 | |------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------| ---------- | | <= 3.3.0-0.0.2@deprecated | [@react-native-oh-tpl/react-native-splash-screen Releases(deprecated)](https://github.com/react-native-oh-library/react-native-splash-screen/releases) | 0.72 | -| 3.3.1 | [@react-native-ohos/react-native-splash-screen Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-splash-screen/releases) | 0.72 | +| 3.3.2 | [@react-native-ohos/react-native-splash-screen Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-splash-screen/releases) | 0.72 | | 3.4.0 | [@react-native-ohos/react-native-splash-screen Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-splash-screen/releases) | 0.77 | 对于未发布到npm的旧版本，请参考[安装指南](/zh-cn/tgz-usage.md)安装tgz包。 @@ -95,13 +95,13 @@ export default class WelcomePage extends Component { ## 2. 使用 Codegen -Version >= @react-native-ohos/react-native-splash-screen@3.3.1，已适配codegen-lib生成桥接代码。 +Version >= @react-native-ohos/react-native-splash-screen@3.3.2，已适配codegen-lib生成桥接代码。 本库已经适配了 `Codegen` ，在使用前需要主动执行生成三方库桥接代码，详细请参考[ Codegen 使用文档](/zh-cn/codegen.md)。 ## 3. Manual Link -Version >= @react-native-ohos/react-native-splash-screen@3.3.1，已支持 Autolink，无需手动配置，目前只支持72框架。 Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md +Version >= @react-native-ohos/react-native-splash-screen@3.3.2，已支持 Autolink，无需手动配置，目前只支持72框架。 Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md 此步骤为手动配置原生依赖项的指导。