From e1c8629d942e9ea22d5af5ced274db845d41dcd7 Mon Sep 17 00:00:00 2001 From: ludeyin <2930650146@qq.com> Date: Sat, 6 Dec 2025 16:37:01 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0=E4=BD=BF=E7=94=A8?= =?UTF-8?q?=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- en/bam-tech-react-native-image-resizer.md | 14 +-- en/react-native-email-link.md | 9 +- en/react-native-exception-handler.md | 13 ++- en/react-native-file-access.md | 11 ++- en/react-native-fileupload.md | 11 ++- en/react-native-haptic-feedback.md | 28 +++--- en/react-native-http-bridge.md | 80 ++++++++++++++-- en/react-native-idfa-aaid.md | 85 ++++++++++++++--- en/react-native-localization.md | 17 ++-- en/react-native-ohos-community-auto-fill.md | 50 +++++++--- en/react-native-performance.md | 21 +++-- en/react-native-quick-base64.md | 10 +- en/react-native-search-bar.md | 12 +-- en/react-native-send-intent.md | 14 +-- en/react-native-share.md | 22 ++--- en/react-native-thumbnail.md | 94 ++++++++++++++++--- en/react-native-udp.md | 15 +-- en/react-native-user-agent.md | 9 +- en/react-native-view-pdf.md | 9 +- en/react-native-view-shot.md | 15 +-- zh-cn/bam-tech-react-native-image-resizer.md | 12 +-- zh-cn/react-native-email-link.md | 9 +- zh-cn/react-native-exception-handler.md | 11 ++- zh-cn/react-native-file-access.md | 9 +- zh-cn/react-native-fileupload.md | 9 +- zh-cn/react-native-haptic-feedback.md | 26 ++--- zh-cn/react-native-http-bridge.md | 77 +++++++++++++-- zh-cn/react-native-idfa-aaid.md | 75 +++++++++++++-- zh-cn/react-native-localization.md | 16 ++-- .../react-native-ohos-community-auto-fill.md | 50 ++++++---- zh-cn/react-native-performance.md | 11 ++- zh-cn/react-native-quick-base64.md | 8 +- zh-cn/react-native-search-bar.md | 10 +- zh-cn/react-native-send-intent.md | 12 +-- zh-cn/react-native-share.md | 8 +- zh-cn/react-native-thumbnail.md | 80 +++++++++++++--- zh-cn/react-native-udp.md | 13 +-- zh-cn/react-native-user-agent.md | 9 +- zh-cn/react-native-view-pdf.md | 9 +- zh-cn/react-native-view-shot.md | 11 ++- 40 files changed, 725 insertions(+), 279 deletions(-) diff --git a/en/bam-tech-react-native-image-resizer.md b/en/bam-tech-react-native-image-resizer.md index 6f53fd7da..1ebe199dd 100644 --- a/en/bam-tech-react-native-image-resizer.md +++ b/en/bam-tech-react-native-image-resizer.md @@ -21,11 +21,11 @@ Please refer to the Releases page of the third-party library for the correspondi | Third-party Library Version | Release Information | Supported RN Version | | ---------- | ------------------------------------------------------------ | ---------- | -| 3.0.9@deprecated | [@react-native-oh-tpl/react-native-image-resizer Releases(deprecated)](https://github.com/react-native-oh-library/react-native-image-resizer/releases) | 0.72 | +| <=3.0.9-0.0.4@deprecated | [@react-native-oh-tpl/react-native-image-resizer Releases(deprecated)](https://github.com/react-native-oh-library/react-native-image-resizer/releases) | 0.72 | | 3.0.10 | [@react-native-ohos/react-native-image-resizer Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-image-resizer/releases) | 0.72 | | 3.1.0 | [@react-native-ohos/react-native-image-resizer Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-image-resizer/releases) | 0.77 | -For older versions not published on npm, please refer to the [Installation Guide](/zh-cn/tgz-usage.md) to install the tgz package. +For older versions not published on npm, please refer to the [Installation Guide](/en/tgz-usage-en.md) to install the tgz package. Go to the project directory and enter the following command: @@ -353,7 +353,7 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { ### 4. Configuring CMakeLists and Introducing ImageResizerPackage -> V3.0.10 requires configuring CMakeLists and importing ImageResizerPackage +> If you are using version <= 3.0.9-0.0.4, please skip this chapter. Open `entry/src/main/cpp/CMakeLists.txt` and add: @@ -370,7 +370,7 @@ add_subdirectory("${RNOH_CPP_DIR}" ./rn) # RNOH_END: manual_package_linking_1 add_subdirectory("../../../../sample_package/src/main/cpp" ./sample-package) -+ add_subdirectory("${OH_MODULES}/@react-native-ohos/react-native-image-resizer/src/main/cpp" ./image-resizer) ++ add_subdirectory("${OH_MODULES}/@react-native-ohos/react-native-image-resizer/src/main/cpp" ./image_resizer) # RNOH_END: manual_package_linking_1 @@ -383,7 +383,7 @@ target_link_libraries(rnoh_app PUBLIC rnoh) # RNOH_BEGIN: manual_package_linking_2 target_link_libraries(rnoh_app PUBLIC rnoh_sample_package) -+ target_link_libraries(rnoh_app PUBLIC rnoh_ImageResizer) ++ target_link_libraries(rnoh_app PUBLIC rnoh_image_resizer) # RNOH_BEGIN: manual_package_linking_2 ``` @@ -431,9 +431,9 @@ To use this library, you need to use the correct React-Native and RNOH versions. Verified successfully in the following versions: -1. RNOH: 0.72.96; SDK: HarmonyOS 5.1.0.150 (API Version 12); IDE: DevEco Studio 5.1.1.830; ROM: 5.1.0.150; +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 5.0.0.71(API Version 12 Release) ;IDE:DevEco Studio:5.1.1.830; ROM: HarmonyOS 5.1.0.150; | +3. RNOH: 0.77.18; SDK: HarmonyOS 6.0.0 Release SDK; IDE: DevEco Studio 6.0.0.858; ROM: 6.0.0.112 | ## API diff --git a/en/react-native-email-link.md b/en/react-native-email-link.md index 2489a45fb..d083a437e 100644 --- a/en/react-native-email-link.md +++ b/en/react-native-email-link.md @@ -20,7 +20,7 @@ Find the matching version information in the release address of a third-party li | Third-party Library Version | Release Information | Supported RN Version | | ---------- | ------------------------------------------------------------ | ---------- | -| 1.15.0@deprecated | [@react-native-oh-tpl/react-native-email-link Releases(deprecated)](https://github.com/react-native-oh-library/react-native-email-link/releases) | 0.72 | +| <=1.15.0-0.0.2@deprecated | [@react-native-oh-tpl/react-native-email-link Releases(deprecated)](https://github.com/react-native-oh-library/react-native-email-link/releases) | 0.72 | | 1.15.1 | [@react-native-ohos/react-native-email-link Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-email-link/releases) | 0.72 | | 1.16.2 | [@react-native-ohos/react-native-email-link Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-email-link/releases) | 0.77 | @@ -213,7 +213,7 @@ Method 2: Directly link to the source code. ### 3.Configuring CMakeLists and Introducing RNEmailLinkPackage Package -> V1.16.1 requires configuring CMakeLists and introducing RNEmailLinkPackage. +> If you are using version <= 1.15.0-0.0.2, please skip this chapter. This library embeds the code generated by codegen in the library file. @@ -301,8 +301,9 @@ Then build and run the code. 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.96; SDK：HarmonyOS 5.1.0.150 (API Version 12); IDE：DevEco Studio 5.1.1.830; ROM：5.1.0.150; -2. RNOH：0.77.18; SDK：HarmonyOS 5.1.0.150 (API Version 12); IDE：DevEco Studio 5.1.1.830; ROM：5.1.0.150; +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; ## API diff --git a/en/react-native-exception-handler.md b/en/react-native-exception-handler.md index 08d0460fd..04532177c 100644 --- a/en/react-native-exception-handler.md +++ b/en/react-native-exception-handler.md @@ -20,11 +20,11 @@ Please refer to the Releases page of the third-party library for the correspondi | Third-party Library Version | Release Information | Supported RN Version | |-----------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------| ---------- | -| 2.10.10@deprecated | [@react-native-oh-tpl/react-native-exception-handler Releases(deprecated)](https://github.com/react-native-oh-library/react-native-exception-handler/releases) | 0.72 | +| <=2.10.10-0.1.7@deprecated | [@react-native-oh-tpl/react-native-exception-handler Releases(deprecated)](https://github.com/react-native-oh-library/react-native-exception-handler/releases) | 0.72 | | 2.10.11 | [@react-native-ohos/react-native-exception-handler Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-exception-handler/releases) | 0.72 | | 2.11.0 | [@react-native-ohos/react-native-exception-handler Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-exception-handler/releases) | 0.77 | -For older versions not published on npm, please refer to the [Installation Guide](/zh-cn/tgz-usage.md) to install the tgz package. +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. Go to the project directory and execute the following instruction: @@ -184,6 +184,8 @@ Method 2: Directly link to the source code. ### 3. Configuring CMakeLists and Introducing ExceptionHandlerPackage +> If you are using version <=2.10.10-0.1.7, please skip this chapter + Open `entry/src/main/cpp/CMakeLists.txt` and add the following code: ```diff @@ -204,7 +206,7 @@ add_subdirectory("${RNOH_CPP_DIR}" ./rn) # RNOH_BEGIN: manual_package_linking_1 add_subdirectory("../../../../sample_package/src/main/cpp" ./sample-package) -+ add_subdirectory("${OH_MODULES}/@react-native-ohos/react-native-exception-handler/src/main/cpp" ./exception-handler) ++ add_subdirectory("${OH_MODULES}/@react-native-ohos/react-native-exception-handler/src/main/cpp" ./exception_handler) # RNOH_END: manual_package_linking_1 file(GLOB GENERATED_CPP_FILES "./generated/*.cpp") @@ -276,8 +278,9 @@ To use this repository, you need to use the correct React-Native and RNOH versio The following combinations have been verified: -1. RNOH：0.72.96; SDK：HarmonyOS 5.1.0.150 (API Version 12); IDE：DevEco Studio 5.1.1.830; ROM：5.1.0.150; -2. RNOH：0.77.18; SDK：HarmonyOS 5.1.0.150 (API Version 12); IDE：DevEco Studio 5.1.1.830; ROM：5.1.0.150; +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; ## Static Methods diff --git a/en/react-native-file-access.md b/en/react-native-file-access.md index 53f129e74..5fc0114a3 100644 --- a/en/react-native-file-access.md +++ b/en/react-native-file-access.md @@ -20,11 +20,11 @@ Please refer to the Releases page of the third-party library for the correspondi | Third-party Library Version | Release Information | Supported RN Version | | ---------- | ------------------------------------------------------------ | ---------- | -| 3.1.1@deprecated | [@react-native-oh-tpl/react-native-file-access Releases(deprecated)](https://github.com/react-native-oh-library/react-native-file-access/releases) | 0.72 | +| <=3.1.1@deprecated | [@react-native-oh-tpl/react-native-file-access Releases(deprecated)](https://github.com/react-native-oh-library/react-native-file-access/releases) | 0.72 | | 3.1.2 | [@react-native-ohos/react-native-file-access Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-file-access/releases) | 0.72 | | 3.2.0 | [@react-native-ohos/react-native-file-access Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-file-access/releases) | 0.77 | -For older versions not published on npm, please refer to the [Installation Guide](/zh-cn/tgz-usage.md) to install the tgz package. +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. Go to the project directory and execute the following instruction: @@ -382,7 +382,7 @@ Method 2: Directly link to the source code. ### 3. Configure CMakeLists and import RNFileAccessPackage -> [!TIP] If using version 3.1.2, please configure CMakeLists and import RNFileAccessPackage。 +> If you are using version <=3.1.1, please skip this chapter. open `entry/src/main/cpp/CMakeLists.txt`，add： @@ -481,8 +481,9 @@ To use this repository, you need to use the correct React-Native and RNOH versio The following combinations have been verified: -1. RNOH：0.72.96; SDK：HarmonyOS 5.1.0.150 (API Version 12); IDE：DevEco Studio 5.1.1.830; ROM：5.1.0.150; -2. RNOH：0.77.18; SDK：HarmonyOS 5.1.0.150 (API Version 12); IDE：DevEco Studio 5.1.1.830; ROM：5.1.0.150; +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; ## API diff --git a/en/react-native-fileupload.md b/en/react-native-fileupload.md index eeeaf92a8..aa9303969 100644 --- a/en/react-native-fileupload.md +++ b/en/react-native-fileupload.md @@ -21,11 +21,11 @@ Please refer to the Releases page of the third-party library for the correspondi | Third-party Library Version | Release Information | Supported RN Version | |-----------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------| ---------- | -| 1.1.0@deprecated | [@react-native-oh-tpl/react-native-fileupload Releases(deprecated)](https://github.com/react-native-oh-library/react-native-fileupload/releases) | 0.72 | +| <=1.1.0-0.0.2@deprecated | [@react-native-oh-tpl/react-native-fileupload Releases(deprecated)](https://github.com/react-native-oh-library/react-native-fileupload/releases) | 0.72 | | 1.1.1 | [@react-native-ohos/react-native-fileupload Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-fileupload/releases) | 0.72 | | 1.2.0 | [@react-native-ohos/react-native-fileupload Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-fileupload/releases) | 0.77 | -For older versions not published on npm, please refer to the [Installation Guide](/zh-cn/tgz-usage.md) to install the tgz package. +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. Go to the project directory and execute the following instruction: @@ -200,7 +200,7 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { ### 4. Configuring CMakeLists and Adding FileuploadPackage -> [!TIP] This step is required for V0.77. +> If you are using version <= 1.1.0-0.0.2, please skip this chapter. Open `entry/src/main/cpp/CMakeLists.txt` and add: @@ -281,8 +281,9 @@ To use this repository, you need to use the correct React-Native and RNOH versio The following combinations have been verified: -1. RNOH：0.72.96; SDK：HarmonyOS 5.1.0.150 (API Version 12); IDE：DevEco Studio 5.1.1.830; ROM：5.1.0.150; -2. RNOH：0.77.18; SDK：HarmonyOS 5.1.0.150 (API Version 12); IDE：DevEco Studio 5.1.1.830; ROM：5.1.0.150; +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; ## API diff --git a/en/react-native-haptic-feedback.md b/en/react-native-haptic-feedback.md index c333b942b..8a462ff3a 100644 --- a/en/react-native-haptic-feedback.md +++ b/en/react-native-haptic-feedback.md @@ -21,11 +21,11 @@ Please refer to the Releases page of the third-party library for the correspondi | Third-party Library Version | Release Information | Supported RN Version | | ---------- | ------------------------------------------------------------ | ---------- | -| 2.2.1@deprecated | [@react-native-oh-tpl/react-native-haptic-feedback Releases(deprecated)](https://github.com/react-native-oh-library/react-native-haptic-feedback/releases) | 0.72 | +| <=2.2.1@deprecated | [@react-native-oh-tpl/react-native-haptic-feedback Releases(deprecated)](https://github.com/react-native-oh-library/react-native-haptic-feedback/releases) | 0.72 | | 2.2.2 | [@react-native-ohos/react-native-haptic-feedback Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-haptic-feedback/releases) | 0.72 | | 2.3.4 | [@react-native-ohos/react-native-haptic-feedback Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-haptic-feedback/releases) | 0.77 | -For older versions not published on npm, please refer to the [Installation Guide](/zh-cn/tgz-usage.md) to install the tgz package. +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. Go to the project directory and execute the following instruction: @@ -181,7 +181,7 @@ Method 2: Directly link to the source code. ### 3. Configure CMakeLists and import RNHapticFeedbackPackage -> [!TIP] If using version 2.2.1, please skip this chapter +> If using version 2.2.1, please skip this chapter open `entry/src/main/cpp/CMakeLists.txt`，add： @@ -203,7 +203,7 @@ add_subdirectory("${RNOH_CPP_DIR}" ./rn) # RNOH_BEGIN: manual_package_linking_1 add_subdirectory("../../../../sample_package/src/main/cpp" ./sample-package) -+ add_subdirectory("${OH_MODULES}/@react-native-ohos/react-native-haptic-feedback/src/main/cpp" ./haptic-feedback) ++ add_subdirectory("${OH_MODULES}/@react-native-ohos/react-native-haptic-feedback/src/main/cpp" ./haptic_feedback) # RNOH_END: manual_package_linking_1 file(GLOB GENERATED_CPP_FILES "./generated/*.cpp") @@ -275,19 +275,21 @@ Then build and run the code. 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. -Please refer to the Releases page of the third-party library for the corresponding version information +Verified in the following versions. -| Third-party Library Version | Release Information | Supported RN Version | -| ---------- | ------------------------------------------------------------ | ---------- | -| 2.2.1@deprecated | [@react-native-oh-tpl/react-native-haptic-feedback Releases(deprecated)](https://github.com/react-native-oh-library/react-native-haptic-feedback/releases) | 0.72 | -| 2.2.2 | [@react-native-ohos/react-native-haptic-feedback Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-haptic-feedback/releases) | 0.72 | -| 2.3.4 | [@react-native-ohos/react-native-haptic-feedback Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-haptic-feedback/releases) | 0.77 | +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; ### Permission Requirements -Add the configuration to the **entry/src/main/module.json5** file. -```js -"requestPermissions": [ { "name": "ohos.permission.VIBRATE" }, ] +#### Include applicable permissions in the module.json5 file within the entry directory. + +Open the `entry/src/main/module.json5` file and add the following code: +```diff +"requestPermissions": [ ++ { "name": "ohos.permission.VIBRATE" } +] ``` ## Static Methods diff --git a/en/react-native-http-bridge.md b/en/react-native-http-bridge.md index 331bf3856..3a5d3afef 100644 --- a/en/react-native-http-bridge.md +++ b/en/react-native-http-bridge.md @@ -20,11 +20,11 @@ Please refer to the Releases page of the third-party library for the correspondi | Third-party Library Version | Release Information | Supported RN Version | |-------| ------------------------------------------------------------ | ---------- | -| 0.6.1@deprecated | [@react-native-oh-tpl/react-native-http-bridge Releases(deprecated)](https://github.com/react-native-oh-library/react-native-http-bridge/releases) | 0.72 | +| <=0.6.1-0.0.4@deprecated | [@react-native-oh-tpl/react-native-http-bridge Releases(deprecated)](https://github.com/react-native-oh-library/react-native-http-bridge/releases) | 0.72 | | 0.6.2 | [@react-native-ohos/react-native-http-bridge Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-http-bridge/releases) | 0.72 | | 0.7.0 | [@react-native-ohos/react-native-http-bridge Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-http-bridge/releases) | 0.77 | -For older versions not published on npm, please refer to the [Installation Guide](/zh-cn/tgz-usage.md) to install the tgz package. +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. Go to the project directory and execute the following instruction: @@ -204,7 +204,69 @@ Method 2: Directly link to the source code. > [!TIP] For details, see [Directly Linking Source Code](/en/link-source-code.md). -### 3. Introducing RNHttpBridgePackage to ArkTS +### 3.Configuring CMakeLists and Introducing RNHttpBridgePackage + +> If you are using version <=0.6.1-0.0.4, please skip this chapter. + +Open `entry/src/main/cpp/CMakeLists.txt` and add the following code: + +```diff +project(rnapp) +cmake_minimum_required(VERSION 3.4.1) +set(CMAKE_SKIP_BUILD_RPATH TRUE) +set(RNOH_APP_DIR "${CMAKE_CURRENT_SOURCE_DIR}") +set(NODE_MODULES "${CMAKE_CURRENT_SOURCE_DIR}/../../../../../node_modules") ++ set(OH_MODULES "${CMAKE_CURRENT_SOURCE_DIR}/../../../oh_modules") +set(RNOH_CPP_DIR "${CMAKE_CURRENT_SOURCE_DIR}/../../../../../../react-native-harmony/harmony/cpp") +set(LOG_VERBOSITY_LEVEL 1) +set(CMAKE_ASM_FLAGS "-Wno-error=unused-command-line-argument -Qunused-arguments") +set(CMAKE_CXX_FLAGS "-fstack-protector-strong -Wl,-z,relro,-z,now,-z,noexecstack -s -fPIE -pie") +set(WITH_HITRACE_SYSTRACE 1) # for other CMakeLists.txt files to use +add_compile_definitions(WITH_HITRACE_SYSTRACE) + +add_subdirectory("${RNOH_CPP_DIR}" ./rn) + +# RNOH_BEGIN: manual_package_linking_1 +add_subdirectory("../../../../sample_package/src/main/cpp" ./sample-package) ++ add_subdirectory("${OH_MODULES}/@react-native-ohos/react-native-http-bridge/src/main/cpp" ./audio_recorder_player) + +# RNOH_END: manual_package_linking_1 + +file(GLOB GENERATED_CPP_FILES "./generated/*.cpp") + +add_library(rnoh_app SHARED + ${GENERATED_CPP_FILES} + "./PackageProvider.cpp" + "${RNOH_CPP_DIR}/RNOHAppNapiBridge.cpp" +) +target_link_libraries(rnoh_app PUBLIC rnoh) + +# RNOH_BEGIN: manual_package_linking_2 +target_link_libraries(rnoh_app PUBLIC rnoh_sample_package) ++ target_link_libraries(rnoh_app PUBLIC rnoh_http_bridge) +# RNOH_END: manual_package_linking_2 +``` + +Open `entry/src/main/cpp/PackageProvider.cpp` and add the following code: + +```diff +#include "RNOH/PackageProvider.h" +#include "generated/RNOHGeneratedPackage.h" +#include "SamplePackage.h" ++ #include "RNHttpBridgePackage.h" + +using namespace rnoh; + +std::vector> PackageProvider::getPackages(Package::Context ctx) { + return { + std::make_shared(ctx), + std::make_shared(ctx), ++ std::make_shared(ctx) + }; +} +``` + +### 4. Introducing RNHttpBridgePackage to ArkTS Open the `entry/src/main/ets/RNPackagesFactory.ts` file and add the following code: @@ -221,7 +283,7 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { } ``` -### 4. Running +### 5. Running Click the `sync` button in the upper right corner. @@ -240,13 +302,11 @@ Then build and run the code. 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. -Please refer to the Releases page of the third-party library for the corresponding version information +Verified in the following versions. -| Third-party Library Version | Release Information | Supported RN Version | -|-------| ------------------------------------------------------------ | ---------- | -| 0.6.1@deprecated | [@react-native-oh-tpl/react-native-http-bridge Releases(deprecated)](https://github.com/react-native-oh-library/react-native-http-bridge/releases) | 0.72 | -| 0.6.2 | [@react-native-ohos/react-native-http-bridge Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-http-bridge/releases) | 0.72 | -| 0.7.0 | [@react-native-ohos/react-native-http-bridge Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-http-bridge/releases) | 0.77 | +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; ### Permission Requirements diff --git a/en/react-native-idfa-aaid.md b/en/react-native-idfa-aaid.md index d5a74ecf2..09a120c0e 100644 --- a/en/react-native-idfa-aaid.md +++ b/en/react-native-idfa-aaid.md @@ -20,7 +20,7 @@ Please refer to the Releases page of the third-party library for the correspondi | Third-party Library Version | Release Information | Supported RN Version | |-----------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------| ---------- | -| 1.2.0@deprecated | [@react-native-oh-tpl/react-native-idfa-aaid Releases(deprecated)](https://github.com/react-native-oh-library/react-native-idfa-aaid/releases) | 0.72 | +| <=1.2.0-0.0.1@deprecated | [@react-native-oh-tpl/react-native-idfa-aaid Releases(deprecated)](https://github.com/react-native-oh-library/react-native-idfa-aaid/releases) | 0.72 | | 1.2.1 | [@react-native-ohos/react-native-idfa-aaid Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-idfa-aaid/releases) | 0.72 | | 1.3.0 | [@react-native-ohos/react-native-idfa-aaid Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-idfa-aaid/releases) | 0.77 | @@ -251,7 +251,69 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { ]; } ``` -### 4. Running +### 4.Configuring CMakeLists and Introducing IdfaAaidPackage + +> If you are using version <=1.2.0-0.0.1, please skip this chapter。 + +Open `entry/src/main/cpp/CMakeLists.txt` and add the following code: + +```diff +project(rnapp) +cmake_minimum_required(VERSION 3.4.1) +set(CMAKE_SKIP_BUILD_RPATH TRUE) +set(RNOH_APP_DIR "${CMAKE_CURRENT_SOURCE_DIR}") +set(NODE_MODULES "${CMAKE_CURRENT_SOURCE_DIR}/../../../../../node_modules") ++ set(OH_MODULES "${CMAKE_CURRENT_SOURCE_DIR}/../../../oh_modules") +set(RNOH_CPP_DIR "${CMAKE_CURRENT_SOURCE_DIR}/../../../../../../react-native-harmony/harmony/cpp") +set(LOG_VERBOSITY_LEVEL 1) +set(CMAKE_ASM_FLAGS "-Wno-error=unused-command-line-argument -Qunused-arguments") +set(CMAKE_CXX_FLAGS "-fstack-protector-strong -Wl,-z,relro,-z,now,-z,noexecstack -s -fPIE -pie") +set(WITH_HITRACE_SYSTRACE 1) # for other CMakeLists.txt files to use +add_compile_definitions(WITH_HITRACE_SYSTRACE) + +add_subdirectory("${RNOH_CPP_DIR}" ./rn) + +# RNOH_BEGIN: manual_package_linking_1 +add_subdirectory("../../../../sample_package/src/main/cpp" ./sample-package) ++ add_subdirectory("${OH_MODULES}/@react-native-ohos/react-native-idfa-aaid/src/main/cpp" ./rnoh_getOaid) + +# RNOH_END: manual_package_linking_1 + +file(GLOB GENERATED_CPP_FILES "./generated/*.cpp") + +add_library(rnoh_app SHARED + ${GENERATED_CPP_FILES} + "./PackageProvider.cpp" + "${RNOH_CPP_DIR}/RNOHAppNapiBridge.cpp" +) +target_link_libraries(rnoh_app PUBLIC rnoh) + +# RNOH_BEGIN: manual_package_linking_2 +target_link_libraries(rnoh_app PUBLIC rnoh_sample_package) ++ target_link_libraries(rnoh_app PUBLIC rnoh_getOaid) +# RNOH_END: manual_package_linking_2 +``` + +Open `entry/src/main/cpp/PackageProvider.cpp` and add the following code: + +```diff +#include "RNOH/PackageProvider.h" +#include "generated/RNOHGeneratedPackage.h" +#include "SamplePackage.h" ++ #include "IdfaAaidPackage.h" + +using namespace rnoh; + +std::vector> PackageProvider::getPackages(Package::Context ctx) { + return { + std::make_shared(ctx), + std::make_shared(ctx), ++ std::make_shared(ctx) + }; +} +``` + +### 5. Running Click the `sync` button in the upper right corner. @@ -272,15 +334,18 @@ To use this repository, you need to use the correct React-Native and RNOH versio The following combinations have been verified: -1. RNOH：0.72.96; SDK：HarmonyOS 5.1.0.150 (API Version 12); IDE：DevEco Studio 5.1.1.830; ROM：5.1.0.150; -2. RNOH：0.77.18; SDK：HarmonyOS 5.1.0.150 (API Version 12); IDE：DevEco Studio 5.1.1.830; ROM：5.1.0.150; +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; ### Permission Requirements (If Any) -[!TIP] "ohos.permission.APP_TRACKING_CONSENT"，"ohos.permission.APP_TRACKING_CONSENT"权限等级为normal，授权方式为user_grant[使用 ACL 签名的配置指导](https://developer.harmonyos.com/cn/docs/documentation/doc-guides-V3/signing-0000001587684945-V3#section157591551175916) +[!TIP] + +"ohos.permission.APP_TRACKING_CONSENT"，the permission level of"ohos.permission.APP_TRACKING_CONSENT" is normal，and the granting method is user_grant[Configuration guide for using ACL signatures](https://developer.harmonyos.com/cn/docs/documentation/doc-guides-V3/signing-0000001587684945-V3#section157591551175916) #### Include applicable permissions in the module.json5 file within the entry directory. -在 `YourProject/entry/src/main/module.json5`补上配置 +Open the `entry/src/main/module.json5` file and add the following code: ```diff { @@ -305,11 +370,9 @@ The following combinations have been verified: } } ``` -在 `YourProject/entry/src/main/resources/base/element/string.json`补上配置 - #### Apply the reasons for applicable permission in the entry directory. -打开 `entry/src/main/resources/base/element/string.json`，添加： +Open the `entry/src/main/resources/base/element/string.json` file and add the following code: ```diff ... @@ -322,8 +385,8 @@ The following combinations have been verified: ] } ``` -当前的 HarmonyOS 版本中，当用户请求 APP_TRACKING_CONSENT 权限时，系统并不会弹出授权提示框，而是默认禁止该应用获取 OAID 的权限.为了引导用户手动开启此权限，应用端可以自主设计并展示弹窗，指引用户前往设置界面进行相应的操作。此外，应用应严格按照 user_grant 权限的申请流程来提交请求，具体申请细节请参考： -[user_grant （用户授权）权限列表](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/permissions-for-all-V5#user_grant%E7%94%A8%E6%88%B7%E6%8E%88%E6%9D%83%E6%9D%83%E9%99%90%E5%88%97%E8%A1%A8) +In the current HarmonyOS version, when a user requests the APP_TRACKING_CONSENT permission, the system does not display an authorization prompt. Instead, it defaults to denying the application's access to the OAID. To guide users in manually enabling this permission, the application can independently design and display a dialog, directing users to the settings interface to perform the corresponding operation. Additionally, applications must strictly follow the user_grant permission request process to submit the request. For specific application details, please refer to: +[user_grant （User Authorization）Permissions List](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/permissions-for-all-V5#user_grant%E7%94%A8%E6%88%B7%E6%8E%88%E6%9D%83%E6%9D%83%E9%99%90%E5%88%97%E8%A1%A8) ## Static Methods (If Any) diff --git a/en/react-native-localization.md b/en/react-native-localization.md index b45ec0117..174b2c15d 100644 --- a/en/react-native-localization.md +++ b/en/react-native-localization.md @@ -16,19 +16,20 @@ Template version: v0.2.2 > [!TIP] [GitHub address](https://github.com/react-native-oh-library/ReactNativeLocalization) +## Installation and Usage + This third-party library has been migrated to Gitcode and is now available for direct download from npm, the new package name is: `@react-native-ohos/react-native-localization`, After introducing the new version of the third-party library, The version correspondence details are as follows: | Third-party Library Version | Release Information | Supported RN Version | |-------| ------------------------------------------------------------ | ---------- | -| 2.3.2@deprecated | [@react-native-oh-tpl/react-native-localization Releases(deprecated)](https://github.com/react-native-oh-library/react-native-localization/releases) | 0.72 | +| <=2.3.2-0.0.1@deprecated | [@react-native-oh-tpl/react-native-localization Releases(deprecated)](https://github.com/react-native-oh-library/ReactNativeLocalization/releases) | 0.72 | | 2.3.2 | [@react-native-oh-tpl/react-native-localization Releases](https://github.com/react-native-oh-library/ReactNativeLocalization/releases) | 0.72 | | 2.4.0 | [@react-native-ohos/react-native-localization Releases]() | 0.77 | -## Installation and Usage +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. Go to the project directory and execute the following instruction: - #### **npm** @@ -245,7 +246,7 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { ### 4.Configure CMakeLists and introduce LocalizationPackage -> [!TIP] 0.77 need to execute +> If you are using version <=2.3.2-0.0.1, please skip this chapter. Open `entry/src/main/cpp/CMakeLists.txt` and add the following code: @@ -321,11 +322,13 @@ Then build and run the code. ### Compatibility -Verified in the following version: +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. -RNOH: 0.72.20; SDK: HarmonyOS NEXT Developer Beta1; IDE: DevEco Studio 5.0.3.200;ROM: 3.0.0.18; +Verified in the following versions. -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; ## Static Methods diff --git a/en/react-native-ohos-community-auto-fill.md b/en/react-native-ohos-community-auto-fill.md index 8578c4df8..9c79297e7 100644 --- a/en/react-native-ohos-community-auto-fill.md +++ b/en/react-native-ohos-community-auto-fill.md @@ -1,3 +1,5 @@ +> Template version: v0.2.2 +

@react-native-ohos/auto-fill

@@ -8,10 +10,13 @@

+ Based on the HarmonyOS [autoFillManager](https://developer.huawei.com/consumer/en/doc/harmonyos-references-V5/js-apis-app-ability-autofillmanager-V5) module, auto-fill provides the feature of saving the form input data to the recent forms for automatic filling. This feature is supported only in OpenHarmony OS. +> [!TIP] [ GitHub address](https://github.com/react-native-oh-library/auto-fill) + ## Prerequisites 1. Apply for the SmartFill service. Currently, SmartFill is in the beta phase. You can send an email to apply for access. For details about the email template, see [Application Email Template](https://developer.huawei.com/consumer/en/doc/harmonyos-guides-V5/scenario-fusion-introduction-to-smart-fill-V5#section107231967593). @@ -20,13 +25,13 @@ Based on the HarmonyOS [autoFillManager](https://developer.huawei.com/consumer/e 4. Log in to a HUAWEI ID on the device. 5. Pass the [textContentType](https://reactnative.cn/docs/textinput#textcontenttype) attribute to the **TextInput** component on the service side. -## How to Install +## Installation and Usage Please refer to the Releases page of the third-party library for the corresponding version information | Third-party Library Version | Release Information | Supported RN Version | | ---------- | ------------------------------------------------------------ | ---------- | -| 1.0.1@deprecated | [@react-native-ohos-community/auto-fill Releases(deprecated)](https://github.com/react-native-oh-library/auto-fill/releases) | 0.72 | +| <=1.0.1@deprecated | [@react-native-ohos-community/auto-fill Releases(deprecated)](https://github.com/react-native-oh-library/auto-fill/releases) | 0.72 | | 1.0.2 | [@react-native-ohos/auto-fill Releases](https://gitcode.com/openharmony-sig/rntpc_auto-fill/releases) | 0.72 | | 1.1.0 | [@react-native-ohos/auto-fill Releases](https://gitcode.com/openharmony-sig/rntpc_auto-fill/releases) | 0.77 | @@ -34,17 +39,17 @@ For older versions not published on npm, please refer to the [Installation Guide Go to the project directory and execute the following instructions: +#### npm + +```bash +npm install @react-native-ohos/auto-fill +``` -- **npm** - - ```bash - npm install @react-native-ohos/auto-fill - ``` -- **yarn** - - ```bash - yarn add @react-native-ohos/auto-fill - ``` +#### **yarn** + +```bash +yarn add @react-native-ohos/auto-fill +``` ## Description @@ -192,7 +197,7 @@ For details, see [Direct Linking of Source Code](https://gitee.com/react-native- #### 3. Configuring CMakeLists and Introducing AutoFillPackage -> V1.0.2 requires configuring CMakeLists and importing AutoFillPackage. +> If you are using version <=1.0.1, please skip this chapter. Open **entry/src/main/cpp/CMakeLists.txt** and add the following code: @@ -251,6 +256,21 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { } ``` +#### 5.Running + +Click the `sync` button in the upper right corner. + +Alternatively, run the following instruction on the terminal: + +```bash +cd entry +ohpm install +``` + +Then build and run the code. + + + ## Constraints ### Compatibility @@ -259,9 +279,9 @@ To use this library, you need to use the correct React Native and RNOH versions. Verified successfully in the following versions: -1. RNOH: 0.72.96; SDK: HarmonyOS 5.1.0.150 (API Version 12); IDE: DevEco Studio 5.1.1.830; ROM: 5.1.0.150; +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 5.0.0.71(API Version 12 Release) ;IDE:DevEco Studio:5.1.1.830; ROM: HarmonyOS 5.1.0.150; +3. RNOH: 0.77.18; SDK: HarmonyOS 6.0.0 Release SDK; IDE: DevEco Studio 6.0.0.858; ROM: 6.0.0.112; ## API Description diff --git a/en/react-native-performance.md b/en/react-native-performance.md index d8e886c4c..93d270079 100644 --- a/en/react-native-performance.md +++ b/en/react-native-performance.md @@ -21,10 +21,14 @@ Please refer to the Releases page of the third-party library for the correspondi | Third-party Library Version | Release Information | Supported RN Version | | ---------- | ------------------------------------------------------------ | ---------- | -| 5.1.2@deprecated | [@react-native-oh-tpl/react-native-performance Releases(deprecated)](https://github.com/react-native-oh-library/react-native-performance/releases) | 0.72 | +| <=5.1.2-0.0.3@deprecated | [@react-native-oh-tpl/react-native-performance Releases(deprecated)](https://github.com/react-native-oh-library/react-native-performance/releases) | 0.72 | | 5.1.3 | [@react-native-ohos/react-native-performance Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-performance/releases) | 0.72 | | 5.2.0 | [@react-native-ohos/react-native-performance Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-performance/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. + +Go to the project directory and execute the following instruction: + #### **npm** @@ -277,7 +281,7 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { > [!TIP] If using version 5.1.2, please skip this chapter -打开 `entry/src/main/cpp/CMakeLists.txt`，添加： +Open `entry/src/main/cpp/CMakeLists.txt` and add the following code: ```diff project(rnapp) @@ -316,7 +320,7 @@ target_link_libraries(rnoh_app PUBLIC rnoh_sample_package) # RNOH_END: manual_package_linking_2 ``` -打开 `entry/src/main/cpp/PackageProvider.cpp`，添加： +Open `entry/src/main/cpp/PackageProvider.cpp` and add the following code: ```diff #include "RNOH/PackageProvider.h" @@ -351,10 +355,15 @@ Then build and run the code. ## Constraints ### Compatibility -The content of this document has been validated based on the following version: +1. 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. + + Verified in the following versions. + + 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; -1. RNOH：0.72.33; SDK：HarmonyOS 5.1.0.150 (API Version 12); IDE：DevEco Studio 5.1.1.830; ROM：5.1.0.150; -2. RNOH：0.77.18; SDK：HarmonyOS 5.1.0.150 (API Version 12); IDE：DevEco Studio 5.1.1.830; ROM：5.1.0.150; + ### Permission Requiremen ## Performance diff --git a/en/react-native-quick-base64.md b/en/react-native-quick-base64.md index c90f56315..fa9243da9 100644 --- a/en/react-native-quick-base64.md +++ b/en/react-native-quick-base64.md @@ -20,11 +20,11 @@ Please refer to the Releases page of the third-party library for the correspondi | Third-party Library Version | Release Information | Supported RN Version | | ---------- | ------------------------------------------------------------ | ---------- | -| 2.1.2@deprecated | [@react-native-oh-tpl/react-native-quick-base64 Releases(deprecated)](https://github.com/react-native-oh-library/react-native-quick-base64/releases) | 0.72 | +| <=2.1.2-1.0.1@deprecated | [@react-native-oh-tpl/react-native-quick-base64 Releases(deprecated)](https://github.com/react-native-oh-library/react-native-quick-base64/releases) | 0.72 | | 2.1.3 | [@react-native-ohos/react-native-quick-base64 Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-quick-base64/releases) | 0.72 | | 2.2.0 | [@react-native-ohos/react-native-quick-base64 Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-quick-base64/releases) | 0.77 | -For older versions not published on npm, please refer to the [Installation Guide](/zh-cn/tgz-usage.md) to install the tgz package. +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. Go to the project directory and execute the following instruction: @@ -438,7 +438,7 @@ Method 2: Directly link to the source code. ### 3. Configuring CMakeLists and Introducing RNQuickBase64Package -> V2.1.3 requires configuring CMakeLists and importing RNQuickBase64Package. +> If you are using version <=2.1.2-1.0.1, please skip this chapter. Open `entry/src/main/cpp/CMakeLists.txt` and add the following code: @@ -531,9 +531,9 @@ To use this library, you need to use the correct React-Native and RNOH versions. Verified successfully in the following versions: -1. RNOH: 0.72.96; SDK: HarmonyOS 5.1.0.150 (API Version 12); IDE: DevEco Studio 5.1.1.830; ROM: 5.1.0.150; +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 5.0.0.71(API Version 12 Release) ;IDE:DevEco Studio:5.1.1.830; ROM: HarmonyOS 5.1.0.150; +3. RNOH: 0.77.18; SDK: HarmonyOS 6.0.0 Release SDK; IDE: DevEco Studio 6.0.0.858; ROM: 6.0.0.112; > [!TIP] [Official Documenttation](https://github.com/craftzdog/react-native-quick-base64) diff --git a/en/react-native-search-bar.md b/en/react-native-search-bar.md index 00654ae05..263d33bcb 100644 --- a/en/react-native-search-bar.md +++ b/en/react-native-search-bar.md @@ -20,11 +20,11 @@ Please refer to the Releases page of the third-party library for the correspondi | Third-party Library Version | Release Information | Supported RN Version | | ---------- | ------------------------------------------------------------ | ---------- | -| 3.5.1@deprecated | [@react-native-oh-tpl/react-native-search-bar Releases(deprecated)](https://github.com/react-native-oh-library/react-native-search-bar/releases) | 0.72 | +| <=3.5.1-0.0.3@deprecated | [@react-native-oh-tpl/react-native-search-bar Releases(deprecated)](https://github.com/react-native-oh-library/react-native-search-bar/releases) | 0.72 | | 3.5.2 | [@react-native-ohos/react-native-search-bar Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-search-bar/releases) | 0.72 | | 3.6.0 | [@react-native-ohos/react-native-search-bar Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-search-bar/releases) | 0.77 | -For older versions not published on npm, please refer to the [Installation Guide](/zh-cn/tgz-usage.md) to install the tgz package. +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. Go to the project directory and execute the following instruction: @@ -163,7 +163,7 @@ Method 2: Directly link to the source code. ### 3. Configuring CMakeLists and Introducing SearchBarPackage -> V3.5.2 requires configuring CMakeLists and importing SearchBarPackage. +> If you are using version <=3.5.1-0.0.3, please skip this chapter. Open `entry/src/main/cpp/CMakeLists.txt` and add the following code: @@ -178,7 +178,7 @@ add_subdirectory("${RNOH_CPP_DIR}" ./rn) # RNOH_BEGIN: manual_package_linking_1 add_subdirectory("../../../../sample_package/src/main/cpp" ./sample-package) -+ add_subdirectory("${OH_MODULES}/@react-native-ohos/react-native-search-bar/src/main/cpp" ./search-bar) ++ add_subdirectory("${OH_MODULES}/@react-native-ohos/react-native-search-bar/src/main/cpp" ./search_bar) # RNOH_END: manual_package_linking_1 add_library(rnoh_app SHARED @@ -268,9 +268,9 @@ To use this repository, you need to use the correct React-Native and RNOH versio Verified successfully in the following versions: -1. RNOH: 0.72.96; SDK: HarmonyOS 5.1.0.150 (API Version 12); IDE: DevEco Studio 5.1.1.830; ROM: 5.1.0.150; +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 5.0.0.71(API Version 12 Release) ;IDE:DevEco Studio:5.1.1.830; ROM: HarmonyOS 5.1.0.150; +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-send-intent.md b/en/react-native-send-intent.md index 386eb2ee2..d366e1221 100644 --- a/en/react-native-send-intent.md +++ b/en/react-native-send-intent.md @@ -20,11 +20,11 @@ Please refer to the Releases page of the third-party library for the correspondi | Third-party Library Version | Release Information | Supported RN Version | | ---------- | ------------------------------------------------------------ | ---------- | -| 1.3.0@deprecated | [@react-native-oh-tpl/react-native-send-intent Releases(deprecated)](https://github.com/react-native-oh-library/react-native-send-intent/releases) | 0.72 | +| <=1.3.0-0.0.5@deprecated | [@react-native-oh-tpl/react-native-send-intent Releases(deprecated)](https://github.com/react-native-oh-library/react-native-send-intent/releases) | 0.72 | | 1.3.1 | [@react-native-ohos/react-native-send-intent Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-send-intent/releases) | 0.72 | | 1.4.0 | [@react-native-ohos/react-native-send-intent Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-send-intent/releases) | 0.77 | -For older versions not published on npm, please refer to the [Installation Guide](/zh-cn/tgz-usage.md) to install the tgz package. +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. Go to the project directory and execute the following instruction: @@ -204,11 +204,11 @@ Method 2: Directly link to the source code. ### 3.Configure CMakeLists and introduce SendIntentPackage -> V1.3.1 requires configuring CMakeLists and importing SendIntentPackage. +> If you are using version <=1.3.0-0.0.5, please skip this chapter. Open `entry/src/main/cpp/CMakeLists.txt` and add the following code: -``` +```diff project(rnapp) cmake_minimum_required(VERSION 3.4.1) set(CMAKE_SKIP_BUILD_RPATH TRUE) @@ -246,7 +246,7 @@ target_link_libraries(rnoh_app PUBLIC rnoh_sample_package) Open `entry/src/main/cpp/PackageProvider.cpp` and add the following code: -``` +```diff #include "RNOH/PackageProvider.h" #include "generated/RNOHGeneratedPackage.h" #include "SamplePackage.h" @@ -300,9 +300,9 @@ To use this library, you need to use the correct React-Native and RNOH versions. Verified successfully in the following versions: -1. RNOH: 0.72.96; SDK: HarmonyOS 5.1.0.150 (API Version 12); IDE: DevEco Studio 5.1.1.830; ROM: 5.1.0.150; +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 5.0.0.71(API Version 12 Release) ;IDE:DevEco Studio:5.1.1.830; ROM: HarmonyOS 5.1.0.150; +3. RNOH: 0.77.18; SDK: HarmonyOS 6.0.0 Release SDK; IDE: DevEco Studio 6.0.0.858; ROM: 6.0.0.112; ## API diff --git a/en/react-native-share.md b/en/react-native-share.md index d278685da..f027a5a29 100644 --- a/en/react-native-share.md +++ b/en/react-native-share.md @@ -20,11 +20,11 @@ Please refer to the Releases page of the third-party library for the correspondi | Third-party Library Version | Release Information | Supported RN Version | | ---------- | ------------------------------------------------------------ | ---------- | -| 10.2.1@deprecated | [@react-native-oh-tpl/react-native-share Releases(deprecated)](https://github.com/react-native-oh-library/react-native-share/releases) | 0.72 | +| <=10.2.1-0.0.6@deprecated | [@react-native-oh-tpl/react-native-share Releases(deprecated)](https://github.com/react-native-oh-library/react-native-share/releases) | 0.72 | | 10.2.2 | [@react-native-ohos/react-native-share Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-share/releases) | 0.72 | | 12.1.1 | [@react-native-ohos/react-native-share Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-share/releases) | 0.77 | -For older versions not published on npm, please refer to the [Installation Guide](/zh-cn/tgz-usage.md) to install the tgz package. +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. Go to the project directory and execute the following instruction: @@ -162,7 +162,7 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { ### 4. Configure CMakeLists and Import RNSharePackage -> V10.2.2 requires configuring CMakeLists and importing RNSharePackage +> If you are using version <=10.2.1-0.0.6, please skip this chapter. Open `entry/src/main/cpp/CMakeLists.txt` and add: @@ -230,9 +230,9 @@ To use this library, you need to use the correct React-Native and RNOH versions. Verified successfully in the following versions: -1. RNOH: 0.72.96; SDK: HarmonyOS 5.1.0.150 (API Version 12); IDE: DevEco Studio 5.1.1.830; ROM: 5.1.0.150; +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 5.0.0.71(API Version 12 Release) ;IDE:DevEco Studio:5.1.1.830; ROM: HarmonyOS 5.1.0.150; +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 @@ -249,13 +249,13 @@ Verified successfully in the following versions: **Button**: 分享按钮 -| Name | Description | Type | Required | Platform | HarmonyOS Support | -| ----------- | ----------- | --------------------------------------------------------------------- | -------- | ----------- | ----------------- | -| onPress | 是否显示 | boolean | no | iOS,Android | yes | +| Name | Description | Type | Required | Platform | HarmonyOS Support | +| ----------- | ----------- | ------------------------------------------------------------ | -------- | ----------- | ----------------- | +| onPress | 是否显示 | boolean | no | iOS,Android | yes | | iconSrc | icon 属性 | [ImageSourcePropType](https://reactnative.dev/docs/image#imagesource) | no | iOS,Android | yes | -| buttonStyle | button 属性 | [ ViewStyle ](https://reactnative.dev/docs/view#props) | no | iOS,Android | yes | -| textStyle | text 属性 | [TextStyle](https://reactnative.dev/docs/text#props) | no | iOS,Android | yes | -| children | JSX element | React.ReactNode | no | iOS,Android | yes | +| buttonStyle | button 属性 | [ ViewStyle ](https://reactnative.dev/docs/view#props) | no | iOS,Android | yes | +| textStyle | text 属性 | [TextStyle](https://reactnative.dev/docs/text#props) | no | iOS,Android | yes | +| children | JSX element | React.ReactNode | no | iOS,Android | yes | **ShareSheet**: 分享面板组件 diff --git a/en/react-native-thumbnail.md b/en/react-native-thumbnail.md index 68c70da7d..527b9679b 100644 --- a/en/react-native-thumbnail.md +++ b/en/react-native-thumbnail.md @@ -19,11 +19,11 @@ Please refer to the Releases page of the third-party library for the correspondi | Third-party Library Version | Release Information | Supported RN Version | |-------| ------------------------------------------------------------ | ---------- | -| 1.1.3@deprecated | [@react-native-oh-tpl/react-native-thumbnail Releases(deprecated)](https://github.com/react-native-oh-library/react-native-thumbnail/releases) | 0.72 | +| <=1.1.3-0.0.1@deprecated | [@react-native-oh-tpl/react-native-thumbnail Releases(deprecated)](https://github.com/react-native-oh-library/react-native-thumbnail/releases) | 0.72 | | 1.1.4 | [@react-native-ohos/react-native-thumbnail Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-thumbnail/releases) | 0.72 | | 1.2.0 | [@react-native-ohos/react-native-thumbnail Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-thumbnail/releases) | 0.77 | -For older versions not published on npm, please refer to the [Installation Guide](/zh-cn/tgz-usage.md) to install the tgz package. +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. Go to the project directory and execute the following instruction: @@ -234,7 +234,80 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { } ``` -### 4. Running +```diff +import { RNPackageContext, RNPackage } from '@rnoh/react-native-openharmony/ts'; ++import { RNThumbnailPackage } from '@react-native-ohos/react-native-thumbnail/ts'; + +export function createRNPackages(ctx: RNPackageContext): RNPackage[] { + return [ ++ new RNThumbnailPackage(ctx), + ]; +} +``` + +### 4.Configuring CMakeLists and Introducing ThumbnailPackage + +> If you are using version <=1.1.3-0.0.1, please skip this chapter. + +Open `entry/src/main/cpp/CMakeLists.txt` and add the following code: + +```diff +project(rnapp) +cmake_minimum_required(VERSION 3.4.1) +set(CMAKE_SKIP_BUILD_RPATH TRUE) +set(RNOH_APP_DIR "${CMAKE_CURRENT_SOURCE_DIR}") +set(NODE_MODULES "${CMAKE_CURRENT_SOURCE_DIR}/../../../../../node_modules") ++ set(OH_MODULES "${CMAKE_CURRENT_SOURCE_DIR}/../../../oh_modules") +set(RNOH_CPP_DIR "${CMAKE_CURRENT_SOURCE_DIR}/../../../../../../react-native-harmony/harmony/cpp") +set(LOG_VERBOSITY_LEVEL 1) +set(CMAKE_ASM_FLAGS "-Wno-error=unused-command-line-argument -Qunused-arguments") +set(CMAKE_CXX_FLAGS "-fstack-protector-strong -Wl,-z,relro,-z,now,-z,noexecstack -s -fPIE -pie") +set(WITH_HITRACE_SYSTRACE 1) # for other CMakeLists.txt files to use +add_compile_definitions(WITH_HITRACE_SYSTRACE) + +add_subdirectory("${RNOH_CPP_DIR}" ./rn) + +# RNOH_BEGIN: manual_package_linking_1 +add_subdirectory("../../../../sample_package/src/main/cpp" ./sample-package) ++ add_subdirectory("${OH_MODULES}/@react-native-ohos/react-native-thumbnail/src/main/cpp" ./thumbnail) + +# RNOH_END: manual_package_linking_1 + +file(GLOB GENERATED_CPP_FILES "./generated/*.cpp") + +add_library(rnoh_app SHARED + ${GENERATED_CPP_FILES} + "./PackageProvider.cpp" + "${RNOH_CPP_DIR}/RNOHAppNapiBridge.cpp" +) +target_link_libraries(rnoh_app PUBLIC rnoh) + +# RNOH_BEGIN: manual_package_linking_2 +target_link_libraries(rnoh_app PUBLIC rnoh_sample_package) ++ target_link_libraries(rnoh_app PUBLIC rnoh_thumbnail) +# RNOH_END: manual_package_linking_2 +``` + +Open `entry/src/main/cpp/PackageProvider.cpp` and add the following code: + +```diff +#include "RNOH/PackageProvider.h" +#include "generated/RNOHGeneratedPackage.h" +#include "SamplePackage.h" ++ #include "ThumbnailPackage.h" + +using namespace rnoh; + +std::vector> PackageProvider::getPackages(Package::Context ctx) { + return { + std::make_shared(ctx), + std::make_shared(ctx), ++ std::make_shared(ctx) + }; +} +``` + +### 5. Running Click the sync button in the upper right corner. @@ -253,18 +326,11 @@ Then build and run the code. 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. -Please refer to the Releases page of the third-party library for the corresponding version information - -| Third-party Library Version | Release Information | Supported RN Version | -|-------| ------------------------------------------------------------ | ---------- | -| 1.1.3@deprecated | [@react-native-oh-tpl/react-native-thumbnail Releases(deprecated)](https://github.com/react-native-oh-library/react-native-thumbnail/releases) | 0.72 | -| 1.1.4 | [@react-native-ohos/react-native-thumbnail Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-thumbnail/releases) | 0.72 | -| 1.2.0 | [@react-native-ohos/react-native-thumbnail Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-thumbnail/releases) | 0.77 | - -The content of this document has been verified based on the following versions: +Verified in the following versions. -1. RNOH: 0.72.98; SDK: HarmonyOS-5.0.0(API12); IDE: DevEco Studio 5.0.3.906; ROM: NEXT.0.0.71; -2. RNOH：0.77.18; SDK：HarmonyOS 6.0.0.47 (API Version 20); IDE：DevEco Studio 6.0.0.858; ROM：6.0.0.107; +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; ## API diff --git a/en/react-native-udp.md b/en/react-native-udp.md index fcde0f0c0..f9cc89cdc 100644 --- a/en/react-native-udp.md +++ b/en/react-native-udp.md @@ -21,11 +21,11 @@ Please refer to the Releases page of the third-party library for the correspondi | Third-party Library Version | Release Information | Supported RN Version | | ---------- | ------------------------------------------------------------ | ---------- | -| 4.1.7@deprecated | [@react-native-oh-tpl/react-native-udp Releases(deprecated)](https://github.com/react-native-oh-library/react-native-udp/releases) | 0.72 | +| <=4.1.7-0.0.2@deprecated | [@react-native-oh-tpl/react-native-udp Releases(deprecated)](https://github.com/react-native-oh-library/react-native-udp/releases) | 0.72 | | 4.1.8 | [@react-native-ohos/react-native-udp Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-udp/releases) | 0.72 | | 4.2.0 | [@react-native-ohos/react-native-udp Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-udp/releases) | 0.77 | -For older versions not published on npm, please refer to the [Installation Guide](/zh-cn/tgz-usage.md) to install the tgz package. +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. Go to the project directory and execute the following instruction: @@ -223,11 +223,11 @@ Method 2: Directly link to the source code. ### 3. Configure CMakeLists and introduce UdpPackage -> [!TIP] If using version 4.1.8, please skip this chapter. +> [!TIP] If using version <=4.1.7-0.0.2, please skip this chapter. Open `entry/src/main/cpp/CMakeLists.txt` and add： -``` +```diff project(rnapp) cmake_minimum_required(VERSION 3.4.1) set(CMAKE_SKIP_BUILD_RPATH TRUE) @@ -265,7 +265,7 @@ target_link_libraries(rnoh_app PUBLIC rnoh_sample_package) Open `entry/src/main/cpp/PackageProvider.cpp` and add： -``` +```diff #include "RNOH/PackageProvider.h" #include "generated/RNOHGeneratedPackage.h" #include "SamplePackage.h" @@ -320,8 +320,9 @@ To use this repository, you need to use the correct React-Native and RNOH versio The following combinations have been verified: -1. RNOH：0.72.96; SDK：HarmonyOS 5.1.0.150 (API Version 12); IDE：DevEco Studio 5.1.1.830; ROM：5.1.0.150; -2. RNOH：0.77.18; SDK：HarmonyOS 5.1.0.150 (API Version 12); IDE：DevEco Studio 5.1.1.830; ROM：5.1.0.150; +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; ## API diff --git a/en/react-native-user-agent.md b/en/react-native-user-agent.md index b833c101e..1ed9835f0 100644 --- a/en/react-native-user-agent.md +++ b/en/react-native-user-agent.md @@ -22,7 +22,7 @@ Please refer to the Releases page of the third-party library for the correspondi | Third-party Library Version | Release Information | Supported RN Version | | ---------- | ------------------------------------------------------------ | ---------- | -| 2.3.1@deprecated | [@react-native-oh-tpl/react-native-user-agent Releases(deprecated)](https://github.com/react-native-oh-library/react-native-user-agent/releases) | 0.72 | +| <=2.3.1-0.0.1@deprecated | [@react-native-oh-tpl/react-native-user-agent Releases(deprecated)](https://github.com/react-native-oh-library/react-native-user-agent/releases) | 0.72 | | 2.3.2 | [@react-native-ohos/react-native-user-agent Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-user-agent/releases) | 0.72 | | 2.4.0 | [@react-native-ohos/react-native-user-agent Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-user-agent/releases) | 0.77 | @@ -153,7 +153,7 @@ Method 2: Directly link to the source code. ### 3.Configuring CMakeLists and introducing UserAgent -> Note: 0.77 does not require configuring CMakeLists. +> If you are using version <=2.3.1-0.0.1, please skip this chapter. ```diff project(rnapp) @@ -246,8 +246,9 @@ To use this repository, you need to use the correct React-Native and RNOH versio The following combinations have been verified: -1. RNOH：0.72.96; SDK：HarmonyOS 5.1.0.150 (API Version 12); IDE：DevEco Studio 5.1.1.830; ROM：5.1.0.150; -2. RNOH：0.77.18; SDK：HarmonyOS 5.1.0.150 (API Version 12); IDE：DevEco Studio 5.1.1.830; ROM：5.1.0.150; +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-view-pdf.md b/en/react-native-view-pdf.md index 807bc952a..bada952e4 100644 --- a/en/react-native-view-pdf.md +++ b/en/react-native-view-pdf.md @@ -20,7 +20,7 @@ Find the matching version information in the release address of a third-party li | Third-party Library Version | Release Information | Supported RN Version | | ---------- | ------------------------------------------------------------ | ---------- | -| 0.14.0@deprecated | [@react-native-oh-tpl/react-native-view-pdf Releases(deprecated)](https://github.com/react-native-oh-library/react-native-PDFView/releases) | 0.72 | +| <=0.14.0-0.0.2@deprecated | [@react-native-oh-tpl/react-native-view-pdf Releases(deprecated)](https://github.com/react-native-oh-library/react-native-PDFView/releases) | 0.72 | | 0.14.1 | [@react-native-ohos/react-native-view-pdf Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-view-pdf/releases) | 0.72 | | 0.15.0 | [@react-native-ohos/react-native-view-pdf Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-view-pdf/releases) | 0.77 | @@ -158,7 +158,7 @@ const arkTsComponentNames: Array = [ ``` ### 4.Configure CMakeLists and introduce ViewPdfPackage -> [!TIP] Version `0.15.0` and above requires +> If you are using version <=0.14.0-0.0.2, please skip this chapter. Open `entry/src/main/cpp/CMakeLists.txt` and add the following code: @@ -252,8 +252,9 @@ To use this repository, you need to use the correct React-Native and RNOH versio The following combinations have been verified: -1. RNOH：0.72.96; SDK：HarmonyOS 5.1.0.150 (API Version 12); IDE：DevEco Studio 5.1.1.830; ROM：5.1.0.150; -2. RNOH：0.77.18; SDK：HarmonyOS 5.1.0.150 (API Version 12); IDE：DevEco Studio 5.1.1.830; ROM：5.1.0.150; +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-view-shot.md b/en/react-native-view-shot.md index ec0fe91eb..72c78a8c1 100644 --- a/en/react-native-view-shot.md +++ b/en/react-native-view-shot.md @@ -20,11 +20,11 @@ Please refer to the Releases page of the third-party library for the correspondi | Third-party Library Version | Release Information | Supported RN Version | | ---------- | ------------------------------------------------------------ | ---------- | -| 3.8.0@deprecated | [@react-native-oh-tpl/react-native-view-shot Releases(deprecated)](https://github.com/react-native-oh-library/react-native-view-shot/releases) | 0.72 | +| <=3.8.0-0.3.2@deprecated | [@react-native-oh-tpl/react-native-view-shot Releases(deprecated)](https://github.com/react-native-oh-library/react-native-view-shot/releases) | 0.72 | | 3.8.1 | [@react-native-ohos/react-native-view-shot Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-view-shot/releases) | 0.72 | | 3.9.0 | [@react-native-ohos/react-native-view-shot Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-view-shot/releases) | 0.77 | -For older versions not published on npm, please refer to the [Installation Guide](/zh-cn/tgz-usage.md) to install the tgz package. +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. Go to the project directory and execute the following instruction: @@ -173,6 +173,8 @@ Method 2: Directly link to the source code. ### 3. Configuring CMakeLists and Introducing ViewShotPackage +> If you are using version <=3.8.0-0.3.2, please skip this chapter. + Open `entry/src/main/cpp/CMakeLists.txt` and add the following code: ```diff @@ -186,7 +188,7 @@ add_subdirectory("${RNOH_CPP_DIR}" ./rn) # RNOH_BEGIN: manual_package_linking_1 add_subdirectory("../../../../sample_package/src/main/cpp" ./sample-package) -+ add_subdirectory("${OH_MODULES}/@react-native-ohos/react-native-view-shot/src/main/cpp" ./view-shot) ++ add_subdirectory("${OH_MODULES}/@react-native-ohos/react-native-view-shot/src/main/cpp" ./view_shot) # RNOH_BEGIN: manual_package_linking_1 add_library(rnoh_app SHARED @@ -256,8 +258,9 @@ To use this repository, you need to use the correct React-Native and RNOH versio The following combinations have been verified: -1. RNOH：0.72.96; SDK：HarmonyOS 5.1.0.150 (API Version 12); IDE：DevEco Studio 5.1.1.830; ROM：5.1.0.150; -2. RNOH：0.77.18; SDK：HarmonyOS 5.1.0.150 (API Version 12); IDE：DevEco Studio 5.1.1.830; ROM：5.1.0.150; +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 @@ -273,7 +276,7 @@ The following combinations have been verified: | options | view shot configuration. | object | no | Android, iOS | partially | | children | the actual content to rasterize. | ReactNode | no | Android, iOS | yes | -#### options属性详情 +#### options Props Detail | Name | Description | Type | Required | Platform | HarmonyOS Support | | ------------------------ | ------------------------------------------------------------ | ------------------------------------ | -------- | ------------ | ----------------- | diff --git a/zh-cn/bam-tech-react-native-image-resizer.md b/zh-cn/bam-tech-react-native-image-resizer.md index c0f5ef3ac..6a3779ddb 100644 --- a/zh-cn/bam-tech-react-native-image-resizer.md +++ b/zh-cn/bam-tech-react-native-image-resizer.md @@ -21,7 +21,7 @@ | 三方库版本 | 发布信息 | 支持RN版本 | |--------| ------------------------------------------------------------ | ---------- | -| 3.0.9@deprecated | [@react-native-oh-tpl/react-native-image-resizer Releases(deprecated)](https://github.com/react-native-oh-library/react-native-image-resizer/releases) | 0.72 | +| <=3.0.9-0.0.4@deprecated | [@react-native-oh-tpl/react-native-image-resizer Releases(deprecated)](https://github.com/react-native-oh-library/react-native-image-resizer/releases) | 0.72 | | 3.0.10 | [@react-native-ohos/react-native-image-resizer Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-image-resizer/releases) | 0.72 | | 3.1.0 | [@react-native-ohos/react-native-image-resizer Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-image-resizer/releases) | 0.77 | @@ -352,7 +352,7 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { ### 4.配置 CMakeLists 和引入 ImageResizerPackage -> V3.0.10 需要配置 CMakeLists 和引入 ImageResizerPackage。 +> 若使用的是 <= 3.0.9-0.0.4 版本，请跳过本章。 打开 `entry/src/main/cpp/CMakeLists.txt`，添加： @@ -369,7 +369,7 @@ add_subdirectory("${RNOH_CPP_DIR}" ./rn) # RNOH_END: manual_package_linking_1 add_subdirectory("../../../../sample_package/src/main/cpp" ./sample-package) -+ add_subdirectory("${OH_MODULES}/@react-native-ohos/react-native-image-resizer/src/main/cpp" ./image-resizer) ++ add_subdirectory("${OH_MODULES}/@react-native-ohos/react-native-image-resizer/src/main/cpp" ./image_resizer) # RNOH_END: manual_package_linking_1 @@ -382,7 +382,7 @@ target_link_libraries(rnoh_app PUBLIC rnoh) # RNOH_BEGIN: manual_package_linking_2 target_link_libraries(rnoh_app PUBLIC rnoh_sample_package) -+ target_link_libraries(rnoh_app PUBLIC rnoh_ImageResizer) ++ target_link_libraries(rnoh_app PUBLIC rnoh_image_resizer) # RNOH_BEGIN: manual_package_linking_2 ``` @@ -430,9 +430,9 @@ ohpm install 在以下版本验证通过： -1. RNOH: 0.72.96; SDK: HarmonyOS 5.1.0.150 (API Version 12); IDE: DevEco Studio 5.1.1.830; ROM: 5.1.0.150; +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 5.0.0.71(API Version 12 Release) ;IDE:DevEco Studio:5.1.1.830; ROM: HarmonyOS 5.1.0.150; +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-email-link.md b/zh-cn/react-native-email-link.md index bb207abcb..1482b8086 100644 --- a/zh-cn/react-native-email-link.md +++ b/zh-cn/react-native-email-link.md @@ -20,7 +20,7 @@ | 三方库版本 | 发布信息 | 支持RN版本 | | ---------- | ------------------------------------------------------------ | ---------- | -| 1.15.0@deprecated | [@react-native-oh-tpl/react-native-email-link Releases(deprecated)](https://github.com/react-native-oh-library/react-native-email-link/releases) | 0.72 | +| <=1.15.0-0.0.2@deprecated | [@react-native-oh-tpl/react-native-email-link Releases(deprecated)](https://github.com/react-native-oh-library/react-native-email-link/releases) | 0.72 | | 1.15.1 | [@react-native-ohos/react-native-email-link Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-email-link/releases) | 0.72 | | 1.16.2 | [@react-native-ohos/react-native-email-link Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-email-link/releases) | 0.77 | @@ -215,7 +215,7 @@ ohpm install ### 3.配置 CMakeLists和引入 RNOHGeneratedPackage -> V1.16.1 需要配置 CMakeLists和引入 RNOHGeneratedPackage。 +> 若使用的是 <= 1.15.0-0.0.2 版本，请跳过本章。 本库将codegen生成的代码内置在库文件中。 @@ -303,8 +303,9 @@ ohpm install 要使用此库，需要使用正确的 React-Native 和 RNOH 版本。另外，还需要使用配套的 DevEco Studio 和 手机 ROM。 -1. RNOH：0.72.96; SDK：HarmonyOS 5.1.0.150 (API Version 12); IDE：DevEco Studio 5.1.1.830; ROM：5.1.0.150; -2. RNOH：0.77.18; SDK：HarmonyOS 5.1.0.150 (API Version 12); IDE：DevEco Studio 5.1.1.830; ROM：5.1.0.150; +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; ## API diff --git a/zh-cn/react-native-exception-handler.md b/zh-cn/react-native-exception-handler.md index d4391ade9..34e13e917 100644 --- a/zh-cn/react-native-exception-handler.md +++ b/zh-cn/react-native-exception-handler.md @@ -20,7 +20,7 @@ | 三方库版本 | 发布信息 | 支持RN版本 | |--------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------| ---------- | -| 2.10.10@deprecated | [@react-native-oh-tpl/react-native-exception-handler Releases(deprecated)](https://github.com/react-native-oh-library/react-native-exception-handler/releases) | 0.72 | +| <=2.10.10-0.1.7@deprecated | [@react-native-oh-tpl/react-native-exception-handler Releases(deprecated)](https://github.com/react-native-oh-library/react-native-exception-handler/releases) | 0.72 | | 2.10.11 | [@react-native-ohos/react-native-exception-handler Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-exception-handler/releases) | 0.72 | | 2.11.0 | [@react-native-ohos/react-native-exception-handler Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-exception-handler/releases) | 0.77 | @@ -184,6 +184,8 @@ ohpm install ### 3.配置 CMakeLists 和引入 ExceptionHandlerPackage +> 若使用的是 <=2.10.10-0.1.7 版本，请跳过本章 + 打开 `entry/src/main/cpp/CMakeLists.txt`，添加： ```diff @@ -204,7 +206,7 @@ add_subdirectory("${RNOH_CPP_DIR}" ./rn) # RNOH_BEGIN: manual_package_linking_1 add_subdirectory("../../../../sample_package/src/main/cpp" ./sample-package) -+ add_subdirectory("${OH_MODULES}/@react-native-ohos/react-native-exception-handler/src/main/cpp" ./exception-handler) ++ add_subdirectory("${OH_MODULES}/@react-native-ohos/react-native-exception-handler/src/main/cpp" ./exception_handler) # RNOH_END: manual_package_linking_1 file(GLOB GENERATED_CPP_FILES "./generated/*.cpp") @@ -276,8 +278,9 @@ ohpm install 在以下版本验证通过： -1. RNOH：0.72.96; SDK：HarmonyOS 5.1.0.150 (API Version 12); IDE：DevEco Studio 5.1.1.830; ROM：5.1.0.150; -2. RNOH：0.77.18; SDK：HarmonyOS 5.1.0.150 (API Version 12); IDE：DevEco Studio 5.1.1.830; ROM：5.1.0.150; +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-file-access.md b/zh-cn/react-native-file-access.md index 195016759..a40516b48 100644 --- a/zh-cn/react-native-file-access.md +++ b/zh-cn/react-native-file-access.md @@ -20,7 +20,7 @@ | 三方库版本 | 发布信息 | 支持RN版本 | | ---------- | ------------------------------------------------------------ | ---------- | -| 3.1.1@deprecated | [@react-native-oh-tpl/react-native-file-access Releases(deprecated)](https://github.com/react-native-oh-library/react-native-file-access/releases) | 0.72 | +| <=3.1.1@deprecated | [@react-native-oh-tpl/react-native-file-access Releases(deprecated)](https://github.com/react-native-oh-library/react-native-file-access/releases) | 0.72 | | 3.1.2 | [@react-native-ohos/react-native-file-access Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-file-access/releases) | 0.72 | | 3.2.0 | [@react-native-ohos/react-native-file-access Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-file-access/releases) | 0.77 | @@ -382,7 +382,7 @@ ohpm install ### 3.配置 CMakeLists 和引入 RNFileAccessPackage -> [!TIP] V3.1.2需要配置 CMakeLists 和引入 RNFileAccessPackage。 +> 若使用的是 <=3.1.1 版本，请跳过本章。 打开 `entry/src/main/cpp/CMakeLists.txt`，添加： @@ -483,8 +483,9 @@ ohpm install 在以下版本验证通过： -1. RNOH：0.72.96; SDK：HarmonyOS 5.1.0.150 (API Version 12); IDE：DevEco Studio 5.1.1.830; ROM：5.1.0.150; -2. RNOH：0.77.18; SDK：HarmonyOS 5.1.0.150 (API Version 12); IDE：DevEco Studio 5.1.1.830; ROM：5.1.0.150; +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; ## API diff --git a/zh-cn/react-native-fileupload.md b/zh-cn/react-native-fileupload.md index d69dcdc27..08d81ab72 100644 --- a/zh-cn/react-native-fileupload.md +++ b/zh-cn/react-native-fileupload.md @@ -21,7 +21,7 @@ | 三方库版本 | 发布信息 | 支持RN版本 | |------------------|--------------------------------------------------------------------------------------------------------------------------------------------------| ---------- | -| 1.1.0@deprecated | [@react-native-oh-tpl/react-native-fileupload Releases(deprecated)](https://github.com/react-native-oh-library/react-native-fileupload/releases) | 0.72 | +| <=1.1.0-0.0.2@deprecated | [@react-native-oh-tpl/react-native-fileupload Releases(deprecated)](https://github.com/react-native-oh-library/react-native-fileupload/releases) | 0.72 | | 1.1.1 | [@react-native-ohos/react-native-fileupload Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-fileupload/releases) | 0.72 | | 1.2.0 | [@react-native-ohos/react-native-fileupload Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-fileupload/releases) | 0.77 | @@ -200,7 +200,7 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { ### 4.配置 CMakeLists 和引入 FileuploadPackage -> [!TIP] This step is required for V0.77. +> 若使用的是 <=1.1.0-0.0.2 版本，请跳过本章。 打开 `entry/src/main/cpp/CMakeLists.txt`，添加： @@ -281,8 +281,9 @@ ohpm install 在以下版本验证通过： -1. RNOH：0.72.96; SDK：HarmonyOS 5.1.0.150 (API Version 12); IDE：DevEco Studio 5.1.1.830; ROM：5.1.0.150; -2. RNOH：0.77.18; SDK：HarmonyOS 5.1.0.150 (API Version 12); IDE：DevEco Studio 5.1.1.830; ROM：5.1.0.150; +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; ## API diff --git a/zh-cn/react-native-haptic-feedback.md b/zh-cn/react-native-haptic-feedback.md index fb9698424..ad884a36a 100644 --- a/zh-cn/react-native-haptic-feedback.md +++ b/zh-cn/react-native-haptic-feedback.md @@ -21,7 +21,7 @@ | 三方库版本 | 发布信息 | 支持RN版本 | | ---------- | ------------------------------------------------------------ | ---------- | -| 2.2.1@deprecated | [@react-native-oh-tpl/react-native-haptic-feedback Releases(deprecated)](https://github.com/react-native-oh-library/react-native-haptic-feedback/releases) | 0.72 | +| <=2.2.1@deprecated | [@react-native-oh-tpl/react-native-haptic-feedback Releases(deprecated)](https://github.com/react-native-oh-library/react-native-haptic-feedback/releases) | 0.72 | | 2.2.2 | [@react-native-ohos/react-native-haptic-feedback Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-haptic-feedback/releases) | 0.72 | | 2.3.4 | [@react-native-ohos/react-native-haptic-feedback Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-haptic-feedback/releases) | 0.77 | @@ -184,7 +184,7 @@ ohpm install ### 3.配置 CMakeLists 和引入 RNHapticFeedbackPackage -> [!TIP] 若使用的是 2.2.1 版本，请跳过本章。 +> 若使用的是 2.2.1 版本，请跳过本章。 打开 `entry/src/main/cpp/CMakeLists.txt`，添加： @@ -206,7 +206,7 @@ add_subdirectory("${RNOH_CPP_DIR}" ./rn) # RNOH_BEGIN: manual_package_linking_1 add_subdirectory("../../../../sample_package/src/main/cpp" ./sample-package) -+ add_subdirectory("${OH_MODULES}/@react-native-ohos/react-native-haptic-feedback/src/main/cpp" ./haptic-feedback) ++ add_subdirectory("${OH_MODULES}/@react-native-ohos/react-native-haptic-feedback/src/main/cpp" ./haptic_feedback) # RNOH_END: manual_package_linking_1 file(GLOB GENERATED_CPP_FILES "./generated/*.cpp") @@ -278,19 +278,21 @@ ohpm install 要使用此库，需要使用正确的 React-Native 和 RNOH 版本。另外，还需要使用配套的 DevEco Studio 和 手机 ROM。 -请到三方库的 Releases 发布地址查看配套的版本信息： +在以下版本验证通过： -| 三方库版本 | 发布信息 | 支持RN版本 | -| ---------- | ------------------------------------------------------------ | ---------- | -| 2.2.1@deprecated | [@react-native-oh-tpl/react-native-haptic-feedback Releases(deprecated)](https://github.com/react-native-oh-library/react-native-haptic-feedback/releases) | 0.72 | -| 2.2.2 | [@react-native-ohos/react-native-haptic-feedback Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-haptic-feedback/releases) | 0.72 | -| 2.3.4 | [@react-native-ohos/react-native-haptic-feedback Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-haptic-feedback/releases) | 0.77 | +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; ### 权限要求 -在 entry/src/main/module.json5补上配置 -```js -"requestPermissions": [ { "name": "ohos.permission.VIBRATE" }, ] +#### 在 entry 目录下的module.json5中添加权限 + +打开 `entry/src/main/module.json5`，添加： +```diff +"requestPermissions": [ ++ { "name": "ohos.permission.VIBRATE" } +] ``` ## 静态方法 diff --git a/zh-cn/react-native-http-bridge.md b/zh-cn/react-native-http-bridge.md index 0cb5d18b3..ec5ab1d6f 100644 --- a/zh-cn/react-native-http-bridge.md +++ b/zh-cn/react-native-http-bridge.md @@ -20,7 +20,7 @@ | 三方库版本 | 发布信息 | 支持RN版本 | |-------| ------------------------------------------------------------ | ---------- | -| 0.6.1@deprecated | [@react-native-oh-tpl/react-native-http-bridge Releases(deprecated)](https://github.com/react-native-oh-library/react-native-http-bridge/releases) | 0.72 | +| <=0.6.1-0.0.4@deprecated | [@react-native-oh-tpl/react-native-http-bridge Releases(deprecated)](https://github.com/react-native-oh-library/react-native-http-bridge/releases) | 0.72 | | 0.6.2 | [@react-native-ohos/react-native-http-bridge Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-http-bridge/releases) | 0.72 | | 0.7.0 | [@react-native-ohos/react-native-http-bridge Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-http-bridge/releases) | 0.77 | @@ -204,7 +204,68 @@ ohpm install > [!TIP] 如需使用直接链接源码，请参考[直接链接源码说明](/zh-cn/link-source-code.md) -### 3.在 ArkTs 侧引入 RNHttpBridgePackage +### 3.配置 CMakeLists 和引入 RNHttpBridgePackage + +> 若使用的是 <=0.6.1-0.0.4 版本，请跳过本章。 + +打开 `entry/src/main/cpp/CMakeLists.txt`，添加： + +```diff +project(rnapp) +cmake_minimum_required(VERSION 3.4.1) +set(CMAKE_SKIP_BUILD_RPATH TRUE) +set(RNOH_APP_DIR "${CMAKE_CURRENT_SOURCE_DIR}") +set(NODE_MODULES "${CMAKE_CURRENT_SOURCE_DIR}/../../../../../node_modules") ++ set(OH_MODULES "${CMAKE_CURRENT_SOURCE_DIR}/../../../oh_modules") +set(RNOH_CPP_DIR "${CMAKE_CURRENT_SOURCE_DIR}/../../../../../../react-native-harmony/harmony/cpp") +set(LOG_VERBOSITY_LEVEL 1) +set(CMAKE_ASM_FLAGS "-Wno-error=unused-command-line-argument -Qunused-arguments") +set(CMAKE_CXX_FLAGS "-fstack-protector-strong -Wl,-z,relro,-z,now,-z,noexecstack -s -fPIE -pie") +set(WITH_HITRACE_SYSTRACE 1) # for other CMakeLists.txt files to use +add_compile_definitions(WITH_HITRACE_SYSTRACE) + +add_subdirectory("${RNOH_CPP_DIR}" ./rn) + +# RNOH_BEGIN: manual_package_linking_1 +add_subdirectory("../../../../sample_package/src/main/cpp" ./sample-package) ++ add_subdirectory("${OH_MODULES}/@react-native-ohos/react-native-http-bridge/src/main/cpp" ./audio_recorder_player) + +# RNOH_END: manual_package_linking_1 + +file(GLOB GENERATED_CPP_FILES "./generated/*.cpp") + +add_library(rnoh_app SHARED + ${GENERATED_CPP_FILES} + "./PackageProvider.cpp" + "${RNOH_CPP_DIR}/RNOHAppNapiBridge.cpp" +) +target_link_libraries(rnoh_app PUBLIC rnoh) + +# RNOH_BEGIN: manual_package_linking_2 +target_link_libraries(rnoh_app PUBLIC rnoh_sample_package) ++ target_link_libraries(rnoh_app PUBLIC rnoh_http_bridge) +# RNOH_END: manual_package_linking_2 +``` +打开 `entry/src/main/cpp/PackageProvider.cpp`，添加： + +```diff +#include "RNOH/PackageProvider.h" +#include "generated/RNOHGeneratedPackage.h" +#include "SamplePackage.h" ++ #include "RNHttpBridgePackage.h" + +using namespace rnoh; + +std::vector> PackageProvider::getPackages(Package::Context ctx) { + return { + std::make_shared(ctx), + std::make_shared(ctx), ++ std::make_shared(ctx) + }; +} +``` + +### 4.在 ArkTs 侧引入 RNHttpBridgePackage 打开 `entry/src/main/ets/RNPackagesFactory.ts`，添加： @@ -221,7 +282,7 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { } ``` -### 4.运行 +### 5.运行 点击右上角的 `sync` 按钮 @@ -240,13 +301,11 @@ ohpm install 要使用此库，需要使用正确的 React-Native 和 RNOH 版本。另外，还需要使用配套的 DevEco Studio 和 手机 ROM。 -请到三方库的 Releases 发布地址查看配套的版本信息： +在以下版本验证通过： -| 三方库版本 | 发布信息 | 支持RN版本 | -|-------| ------------------------------------------------------------ | ---------- | -| 0.6.1@deprecated | [@react-native-oh-tpl/react-native-http-bridge Releases(deprecated)](https://github.com/react-native-oh-library/react-native-http-bridge/releases) | 0.72 | -| 0.6.2 | [@react-native-ohos/react-native-http-bridge Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-http-bridge/releases) | 0.72 | -| 0.7.0 | [@react-native-ohos/react-native-http-bridge Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-http-bridge/releases) | 0.77 | +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-idfa-aaid.md b/zh-cn/react-native-idfa-aaid.md index 512312684..5ca1cc7c4 100644 --- a/zh-cn/react-native-idfa-aaid.md +++ b/zh-cn/react-native-idfa-aaid.md @@ -20,7 +20,7 @@ | 三方库版本 | 发布信息 | 支持RN版本 | | ---------- | ------------------------------------------------------------ | ---------- | -| 1.2.0@deprecated | [@react-native-oh-tpl/react-native-idfa-aaid Releases(deprecated)](https://github.com/react-native-oh-library/react-native-idfa-aaid/releases) | 0.72 | +| <=1.2.0-0.0.1@deprecated | [@react-native-oh-tpl/react-native-idfa-aaid Releases(deprecated)](https://github.com/react-native-oh-library/react-native-idfa-aaid/releases) | 0.72 | | 1.2.1 | [@react-native-ohos/react-native-idfa-aaid Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-idfa-aaid/releases) | 0.72 | | 1.3.0 | [@react-native-ohos/react-native-idfa-aaid Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-idfa-aaid/releases) | 0.77 | @@ -252,7 +252,69 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { ]; } ``` -### 4.运行 +### 4.配置 CMakeLists 和引入 IdfaAaidPackage + +> 若使用的是 <=1.2.0-0.0.1 版本，请跳过本章。 + +打开 `entry/src/main/cpp/CMakeLists.txt`，添加： + +```diff +project(rnapp) +cmake_minimum_required(VERSION 3.4.1) +set(CMAKE_SKIP_BUILD_RPATH TRUE) +set(RNOH_APP_DIR "${CMAKE_CURRENT_SOURCE_DIR}") +set(NODE_MODULES "${CMAKE_CURRENT_SOURCE_DIR}/../../../../../node_modules") ++ set(OH_MODULES "${CMAKE_CURRENT_SOURCE_DIR}/../../../oh_modules") +set(RNOH_CPP_DIR "${CMAKE_CURRENT_SOURCE_DIR}/../../../../../../react-native-harmony/harmony/cpp") +set(LOG_VERBOSITY_LEVEL 1) +set(CMAKE_ASM_FLAGS "-Wno-error=unused-command-line-argument -Qunused-arguments") +set(CMAKE_CXX_FLAGS "-fstack-protector-strong -Wl,-z,relro,-z,now,-z,noexecstack -s -fPIE -pie") +set(WITH_HITRACE_SYSTRACE 1) # for other CMakeLists.txt files to use +add_compile_definitions(WITH_HITRACE_SYSTRACE) + +add_subdirectory("${RNOH_CPP_DIR}" ./rn) + +# RNOH_BEGIN: manual_package_linking_1 +add_subdirectory("../../../../sample_package/src/main/cpp" ./sample-package) ++ add_subdirectory("${OH_MODULES}/@react-native-ohos/react-native-idfa-aaid/src/main/cpp" ./rnoh_getOaid) + +# RNOH_END: manual_package_linking_1 + +file(GLOB GENERATED_CPP_FILES "./generated/*.cpp") + +add_library(rnoh_app SHARED + ${GENERATED_CPP_FILES} + "./PackageProvider.cpp" + "${RNOH_CPP_DIR}/RNOHAppNapiBridge.cpp" +) +target_link_libraries(rnoh_app PUBLIC rnoh) + +# RNOH_BEGIN: manual_package_linking_2 +target_link_libraries(rnoh_app PUBLIC rnoh_sample_package) ++ target_link_libraries(rnoh_app PUBLIC rnoh_getOaid) +# RNOH_END: manual_package_linking_2 +``` + +打开 `entry/src/main/cpp/PackageProvider.cpp`，添加： + +```diff +#include "RNOH/PackageProvider.h" +#include "generated/RNOHGeneratedPackage.h" +#include "SamplePackage.h" ++ #include "IdfaAaidPackage.h" + +using namespace rnoh; + +std::vector> PackageProvider::getPackages(Package::Context ctx) { + return { + std::make_shared(ctx), + std::make_shared(ctx), ++ std::make_shared(ctx) + }; +} +``` + +### 5.运行 点击右上角的 `sync` 按钮 @@ -273,15 +335,16 @@ ohpm install 在以下版本验证通过： -1. RNOH：0.72.96; SDK：HarmonyOS 5.1.0.150 (API Version 12); IDE：DevEco Studio 5.1.1.830; ROM：5.1.0.150; -2. RNOH：0.77.18; SDK：HarmonyOS 5.1.0.150 (API Version 12); IDE：DevEco Studio 5.1.1.830; ROM：5.1.0.150; +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; ### 权限要求 [!TIP] "ohos.permission.APP_TRACKING_CONSENT"，"ohos.permission.APP_TRACKING_CONSENT"权限等级为normal，授权方式为user_grant[使用 ACL 签名的配置指导](https://developer.harmonyos.com/cn/docs/documentation/doc-guides-V3/signing-0000001587684945-V3#section157591551175916) #### 在 entry 目录下的module.json5中添加权限 -在 `YourProject/entry/src/main/module.json5`补上配置 +打开 `entry/src/main/module.json5`，添加： ```diff { @@ -306,8 +369,6 @@ ohpm install } } ``` -在 `YourProject/entry/src/main/resources/base/element/string.json`补上配置 - #### 在 entry 目录下添加申请权限的原因 打开 `entry/src/main/resources/base/element/string.json`，添加： diff --git a/zh-cn/react-native-localization.md b/zh-cn/react-native-localization.md index 987255592..7b38ba073 100644 --- a/zh-cn/react-native-localization.md +++ b/zh-cn/react-native-localization.md @@ -18,15 +18,17 @@ > [!TIP] [Github 地址](https://github.com/react-native-oh-library/ReactNativeLocalization) +## 安装与使用 + 该第三方库的仓库已迁移至 Gitcode，且支持直接从 npm 下载，新的包名为：`@react-native-ohos/react-native-localization`，具体版本所属关系如下： | 三方库版本 | 发布信息 | 支持RN版本 | |-------| ------------------------------------------------------------ | ---------- | -| 2.3.2@deprecated | [@react-native-oh-tpl/react-native-localization Releases(deprecated)](https://github.com/react-native-oh-library/react-native-localization/releases) | 0.72 | +| <=2.3.2-0.0.1@deprecated | [@react-native-oh-tpl/react-native-localization Releases(deprecated)](https://github.com/react-native-oh-library/ReactNativeLocalization/releases) | 0.72 | | 2.3.2 | [@react-native-oh-tpl/react-native-localization Releases](https://github.com/react-native-oh-library/ReactNativeLocalization/releases) | 0.72 | | 2.4.0 | [@react-native-ohos/react-native-localization Releases]() | 0.77 | -## 安装与使用 +对于未发布到npm的旧版本，请参考[安装指南](/zh-cn/tgz-usage.md)安装tgz包。 进入到工程目录并输入以下命令： @@ -250,7 +252,7 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { ### 4.配置 CMakeLists 和引入 LocalizationPackage -> [!TIP] 0.77 需要执行 +> 若使用的是 <=2.3.2-0.0.1 版本，请跳过本章。 打开 `entry/src/main/cpp/CMakeLists.txt`，添加： @@ -326,11 +328,13 @@ ohpm install ### 兼容性 -在下述版本验证通过： +要使用此库，需要使用正确的 React-Native 和 RNOH 版本。另外，还需要使用配套的 DevEco Studio 和 手机 ROM。 -RNOH：0.72.20; SDK：HarmonyOS NEXT Developer Beta1; IDE：DevEco Studio 5.0.3.200; ROM：3.0.0.18; +在以下版本验证通过： -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-ohos-community-auto-fill.md b/zh-cn/react-native-ohos-community-auto-fill.md index 21c274b7e..84052afee 100644 --- a/zh-cn/react-native-ohos-community-auto-fill.md +++ b/zh-cn/react-native-ohos-community-auto-fill.md @@ -1,3 +1,4 @@ +> 模板版本：v0.2.2

@react-native-ohos/auto-fill

@@ -7,7 +8,7 @@ License

- +[!TIP] [Github 地址](https://github.com/react-native-oh-library/auto-fill) auto-fill 基于 HarmonyOS [autoFillManager](https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V5/js-apis-app-ability-autofillmanager-V5) 模块，提供将表单输入数据保存到历史表单输入中，以供下次自动填充的功能，仅支持 ohos 平台。 @@ -21,13 +22,13 @@ auto-fill 基于 HarmonyOS [autoFillManager](https://developer.huawei.com/consum 4. 设备需要登录华为账号。 5. 业务侧需要给 `TextInput` 组件传入 [`textContentType`](https://reactnative.cn/docs/textinput#textcontenttype) 属性。 -## 安装 +## 安装与使用 请到三方库的 Releases 发布地址查看配套的版本信息： | 三方库版本 | 发布信息 | 支持RN版本 | |--------| ------------------------------------------------------------ | ---------- | -| 1.0.1@deprecated | [@react-native-ohos-community/auto-fill Releases(deprecated)](https://github.com/react-native-oh-library/auto-fill/releases) | 0.72 | +| <=1.0.1@deprecated | [@react-native-ohos-community/auto-fill Releases(deprecated)](https://github.com/react-native-oh-library/auto-fill/releases) | 0.72 | | 1.0.2 | [@react-native-ohos/auto-fill Releases](https://gitcode.com/openharmony-sig/rntpc_auto-fill/releases) | 0.72 | | 1.1.0 | [@react-native-ohos/auto-fill Releases](https://gitcode.com/openharmony-sig/rntpc_auto-fill/releases) | 0.77 | @@ -35,16 +36,17 @@ auto-fill 基于 HarmonyOS [autoFillManager](https://developer.huawei.com/consum 进入到工程目录并输入以下命令： -- **npm** - - ```bash - npm install @react-native-ohos/auto-fill - ``` -- **yarn** - - ```bash - yarn add @react-native-ohos/auto-fill - ``` +#### **npm** + +```bash +npm install @react-native-ohos/auto-fill +``` + +#### **yarn** + +```bash +yarn add @react-native-ohos/auto-fill +``` ## 使用说明 @@ -190,7 +192,7 @@ ohpm install #### 3. 配置 CMakeLists 和引入 AutoFillPackage -> V1.0.2 需要配置 CMakeLists 和引入 AutoFillPackage +> 若使用的是 <=1.0.1 版本，请跳过本章。 打开 `entry/src/main/cpp/CMakeLists.txt`，添加： @@ -204,7 +206,7 @@ set(RNOH_CPP_DIR "${CMAKE_CURRENT_SOURCE_DIR}/../../../../../../react-native-har set(LOG_VERBOSITY_LEVEL 1) # RNOH_BEGIN: manual_package_linking_1 -+ add_subdirectory("${OH_MODULES}/@react-native-ohos/auto-fill/src/main/cpp" ./auto-fill) ++ add_subdirectory("${OH_MODULES}/@react-native-ohos/auto-fill/src/main/cpp" ./auto_fill) # RNOH_END: manual_package_linking_1 add_library(rnoh_app SHARED @@ -249,16 +251,30 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { } ``` +#### 5.运行 + +点击右上角的 `sync` 按钮 + +或者在终端执行： + +```bash +cd entry +ohpm install +``` + +然后编译、运行即可。 + ## 约束与限制 + ### 兼容性 要使用此库，需要使用正确的 React-Native 和 RNOH 版本。另外，还需要使用配套的 DevEco Studio 和 手机 ROM。 在以下版本验证通过： -1. RNOH: 0.72.96; SDK: HarmonyOS 5.1.0.150 (API Version 12); IDE: DevEco Studio 5.1.1.830; ROM: 5.1.0.150; +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 5.0.0.71(API Version 12 Release) ;IDE:DevEco Studio:5.1.1.830; ROM: HarmonyOS 5.1.0.150; +3. RNOH: 0.77.18; SDK: HarmonyOS 6.0.0 Release SDK; IDE: DevEco Studio 6.0.0.858; ROM: 6.0.0.112; ## API 接口说明 diff --git a/zh-cn/react-native-performance.md b/zh-cn/react-native-performance.md index e438610ca..964b123be 100644 --- a/zh-cn/react-native-performance.md +++ b/zh-cn/react-native-performance.md @@ -22,7 +22,7 @@ | 三方库版本 | 发布信息 | 支持RN版本 | | ---------- | ------------------------------------------------------------ | ---------- | -| 5.1.2@deprecated | [@react-native-oh-tpl/react-native-performance Releases(deprecated)](https://github.com/react-native-oh-library/react-native-performance/releases) | 0.72 | +| <=5.1.2-0.0.3@deprecated | [@react-native-oh-tpl/react-native-performance Releases(deprecated)](https://github.com/react-native-oh-library/react-native-performance/releases) | 0.72 | | 5.1.3 | [@react-native-ohos/react-native-performance Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-performance/releases) | 0.72 | | 5.2.0 | [@react-native-ohos/react-native-performance Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-performance/releases) | 0.77 | @@ -354,10 +354,13 @@ ohpm install ## 约束与限制 ### 兼容性 -本文档内容基于以下版本验证通过： +1. 要使用此库，需要使用正确的 React-Native 和 RNOH 版本。另外，还需要使用配套的 DevEco Studio 和 手机 ROM。 -1. RNOH：0.72.33; SDK：HarmonyOS 5.1.0.150 (API Version 12); IDE：DevEco Studio 5.1.1.830; ROM：5.1.0.150; -2. RNOH：0.77.18; SDK：HarmonyOS 5.1.0.150 (API Version 12); IDE：DevEco Studio 5.1.1.830; ROM：5.1.0.150; + 在以下版本验证通过： + + 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; ## Performance diff --git a/zh-cn/react-native-quick-base64.md b/zh-cn/react-native-quick-base64.md index c9026e56e..edc25e159 100644 --- a/zh-cn/react-native-quick-base64.md +++ b/zh-cn/react-native-quick-base64.md @@ -20,7 +20,7 @@ | 三方库版本 | 发布信息 | 支持RN版本 | |--------| ------------------------------------------------------------ | ---------- | -| 2.1.2@deprecated | [@react-native-oh-tpl/react-native-quick-base64 Releases(deprecated)](https://github.com/react-native-oh-library/react-native-quick-base64/releases) | 0.72 | +| <=2.1.2-1.0.1@deprecated | [@react-native-oh-tpl/react-native-quick-base64 Releases(deprecated)](https://github.com/react-native-oh-library/react-native-quick-base64/releases) | 0.72 | | 2.1.3 | [@react-native-ohos/react-native-quick-base64 Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-quick-base64/releases) | 0.72 | | 2.2.0 | [@react-native-ohos/react-native-quick-base64 Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-quick-base64/releases) | 0.77 | @@ -471,7 +471,7 @@ ohpm install ### 3.配置 CMakeLists 和引入 RNQuickBase64Package -> V2.1.3 需要配置 CMakeLists 和引入 RNQuickBase64Package +> 若使用的是 <=2.1.2-1.0.1 版本，请跳过本章。 打开 `entry/src/main/cpp/CMakeLists.txt`，添加： @@ -564,9 +564,9 @@ ohpm install 在以下版本验证通过： -1. RNOH: 0.72.96; SDK: HarmonyOS 5.1.0.150 (API Version 12); IDE: DevEco Studio 5.1.1.830; ROM: 5.1.0.150; +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 5.0.0.71(API Version 12 Release) ;IDE:DevEco Studio:5.1.1.830; ROM: HarmonyOS 5.1.0.150; +3. RNOH: 0.77.18; SDK: HarmonyOS 6.0.0 Release SDK; IDE: DevEco Studio 6.0.0.858; ROM: 6.0.0.112; > [!TIP] [官方文档](https://github.com/craftzdog/react-native-quick-base64) diff --git a/zh-cn/react-native-search-bar.md b/zh-cn/react-native-search-bar.md index 9f57845ae..10b79246a 100644 --- a/zh-cn/react-native-search-bar.md +++ b/zh-cn/react-native-search-bar.md @@ -21,7 +21,7 @@ | 三方库版本 | 发布信息 | 支持RN版本 | | ---------- | ------------------------------------------------------------ | ---------- | -| 3.5.1@deprecated | [@react-native-oh-tpl/react-native-search-bar Releases(deprecated)](https://github.com/react-native-oh-library/react-native-search-bar/releases) | 0.72 | +| <=3.5.1-0.0.3@deprecated | [@react-native-oh-tpl/react-native-search-bar Releases(deprecated)](https://github.com/react-native-oh-library/react-native-search-bar/releases) | 0.72 | | 3.5.2 | [@react-native-ohos/react-native-search-bar Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-search-bar/releases) | 0.72 | | 3.6.0 | [@react-native-ohos/react-native-search-bar Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-search-bar/releases) | 0.77 | @@ -163,7 +163,7 @@ ohpm install ### 3.配置 CMakeLists 和引入 SearchBarPackage -> V3.5.2 需要配置 CMakeLists 和引入 SearchBarPackage +> 若使用的是 <=3.5.1-0.0.3 版本，请跳过本章。 打开 `entry/src/main/cpp/CMakeLists.txt`，添加： @@ -178,7 +178,7 @@ add_subdirectory("${RNOH_CPP_DIR}" ./rn) # RNOH_BEGIN: manual_package_linking_1 add_subdirectory("../../../../sample_package/src/main/cpp" ./sample-package) -+ add_subdirectory("${OH_MODULES}/@react-native-ohos/react-native-search-bar/src/main/cpp" ./search-bar) ++ add_subdirectory("${OH_MODULES}/@react-native-ohos/react-native-search-bar/src/main/cpp" ./search_bar) # RNOH_END: manual_package_linking_1 add_library(rnoh_app SHARED @@ -268,9 +268,9 @@ ohpm install 在以下版本验证通过： -1. RNOH: 0.72.96; SDK: HarmonyOS 5.1.0.150 (API Version 12); IDE: DevEco Studio 5.1.1.830; ROM: 5.1.0.150; +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 5.0.0.71(API Version 12 Release) ;IDE:DevEco Studio:5.1.1.830; ROM: HarmonyOS 5.1.0.150; +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-send-intent.md b/zh-cn/react-native-send-intent.md index 406f50292..aede22ee5 100644 --- a/zh-cn/react-native-send-intent.md +++ b/zh-cn/react-native-send-intent.md @@ -20,7 +20,7 @@ | 三方库版本 | 发布信息 | 支持RN版本 | |--------| ------------------------------------------------------------ | ---------- | -| 1.3.0@deprecated | [@react-native-oh-tpl/react-native-send-intent Releases(deprecated)](https://github.com/react-native-oh-library/react-native-send-intent/releases) | 0.72 | +| <=1.3.0-0.0.5@deprecated | [@react-native-oh-tpl/react-native-send-intent Releases(deprecated)](https://github.com/react-native-oh-library/react-native-send-intent/releases) | 0.72 | | 1.3.1 | [@react-native-ohos/react-native-send-intent Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-send-intent/releases) | 0.72 | | 1.4.0 | [@react-native-ohos/react-native-send-intent Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-send-intent/releases) | 0.77 | @@ -204,11 +204,11 @@ ohpm install ### 3.配置 CMakeLists 和引入 SendIntentPackage -> V1.3.1 需要配置 CMakeLists 和引入 SendIntentPackage +> 若使用的是 <=1.3.0-0.0.5 版本，请跳过本章。 打开 `entry/src/main/cpp/CMakeLists.txt`，添加： -``` +```diff project(rnapp) cmake_minimum_required(VERSION 3.4.1) set(CMAKE_SKIP_BUILD_RPATH TRUE) @@ -246,7 +246,7 @@ target_link_libraries(rnoh_app PUBLIC rnoh_sample_package) 打开 `entry/src/main/cpp/PackageProvider.cpp`，添加： -``` +```diff #include "RNOH/PackageProvider.h" #include "generated/RNOHGeneratedPackage.h" #include "SamplePackage.h" @@ -300,9 +300,9 @@ ohpm install 在以下版本验证通过： -1. RNOH: 0.72.96; SDK: HarmonyOS 5.1.0.150 (API Version 12); IDE: DevEco Studio 5.1.1.830; ROM: 5.1.0.150; +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 5.0.0.71(API Version 12 Release) ;IDE:DevEco Studio:5.1.1.830; ROM: HarmonyOS 5.1.0.150; +3. RNOH: 0.77.18; SDK: HarmonyOS 6.0.0 Release SDK; IDE: DevEco Studio 6.0.0.858; ROM: 6.0.0.112; ## API diff --git a/zh-cn/react-native-share.md b/zh-cn/react-native-share.md index ca7b8f5e7..716272e67 100644 --- a/zh-cn/react-native-share.md +++ b/zh-cn/react-native-share.md @@ -21,7 +21,7 @@ | 三方库版本 | 发布信息 | 支持RN版本 | |--------| ------------------------------------------------------------ | ---------- | -| 10.2.1@deprecated | [@react-native-oh-tpl/react-native-share Releases(deprecated)](https://github.com/react-native-oh-library/react-native-share/releases) | 0.72 | +| <=10.2.1-0.0.6@deprecated | [@react-native-oh-tpl/react-native-share Releases(deprecated)](https://github.com/react-native-oh-library/react-native-share/releases) | 0.72 | | 10.2.2 | [@react-native-ohos/react-native-share Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-share/releases) | 0.72 | | 12.1.1 | [@react-native-ohos/react-native-share Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-share/releases) | 0.77 | @@ -163,7 +163,7 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { ### 4. 配置 CMakeLists 和引入 RNSharePackage -> V10.2.2 需要配置 CMakeLists 和引入 RNSharePackage +> 若使用的是 <=10.2.1-0.0.6 版本，请跳过本章。 打开 `entry/src/main/cpp/CMakeLists.txt`，添加： @@ -232,9 +232,9 @@ ohpm install 在以下版本验证通过： -1. RNOH: 0.72.96; SDK: HarmonyOS 5.1.0.150 (API Version 12); IDE: DevEco Studio 5.1.1.830; ROM: 5.1.0.150; +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 5.0.0.71(API Version 12 Release) ;IDE:DevEco Studio:5.1.1.830; ROM: HarmonyOS 5.1.0.150; +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-thumbnail.md b/zh-cn/react-native-thumbnail.md index b44fd389f..8d1c62044 100644 --- a/zh-cn/react-native-thumbnail.md +++ b/zh-cn/react-native-thumbnail.md @@ -19,7 +19,7 @@ | 三方库版本 | 发布信息 | 支持RN版本 | |-------| ------------------------------------------------------------ | ---------- | -| 1.1.3@deprecated | [@react-native-oh-tpl/react-native-thumbnail Releases(deprecated)](https://github.com/react-native-oh-library/react-native-thumbnail/releases) | 0.72 | +| <=1.1.3-0.0.1@deprecated | [@react-native-oh-tpl/react-native-thumbnail Releases(deprecated)](https://github.com/react-native-oh-library/react-native-thumbnail/releases) | 0.72 | | 1.1.4 | [@react-native-ohos/react-native-thumbnail Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-thumbnail/releases) | 0.72 | | 1.2.0 | [@react-native-ohos/react-native-thumbnail Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-thumbnail/releases) | 0.77 | @@ -234,6 +234,68 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { } ``` +### 配置 CMakeLists 和引入 ThumbnailPackage + +> 若使用的是 <=1.1.3-0.0.1 版本，请跳过本章。 + +打开 `entry/src/main/cpp/CMakeLists.txt`，添加： + +```diff +project(rnapp) +cmake_minimum_required(VERSION 3.4.1) +set(CMAKE_SKIP_BUILD_RPATH TRUE) +set(RNOH_APP_DIR "${CMAKE_CURRENT_SOURCE_DIR}") +set(NODE_MODULES "${CMAKE_CURRENT_SOURCE_DIR}/../../../../../node_modules") ++ set(OH_MODULES "${CMAKE_CURRENT_SOURCE_DIR}/../../../oh_modules") +set(RNOH_CPP_DIR "${CMAKE_CURRENT_SOURCE_DIR}/../../../../../../react-native-harmony/harmony/cpp") +set(LOG_VERBOSITY_LEVEL 1) +set(CMAKE_ASM_FLAGS "-Wno-error=unused-command-line-argument -Qunused-arguments") +set(CMAKE_CXX_FLAGS "-fstack-protector-strong -Wl,-z,relro,-z,now,-z,noexecstack -s -fPIE -pie") +set(WITH_HITRACE_SYSTRACE 1) # for other CMakeLists.txt files to use +add_compile_definitions(WITH_HITRACE_SYSTRACE) + +add_subdirectory("${RNOH_CPP_DIR}" ./rn) + +# RNOH_BEGIN: manual_package_linking_1 +add_subdirectory("../../../../sample_package/src/main/cpp" ./sample-package) ++ add_subdirectory("${OH_MODULES}/@react-native-ohos/react-native-thumbnail/src/main/cpp" ./thumbnail) + +# RNOH_END: manual_package_linking_1 + +file(GLOB GENERATED_CPP_FILES "./generated/*.cpp") + +add_library(rnoh_app SHARED + ${GENERATED_CPP_FILES} + "./PackageProvider.cpp" + "${RNOH_CPP_DIR}/RNOHAppNapiBridge.cpp" +) +target_link_libraries(rnoh_app PUBLIC rnoh) + +# RNOH_BEGIN: manual_package_linking_2 +target_link_libraries(rnoh_app PUBLIC rnoh_sample_package) ++ target_link_libraries(rnoh_app PUBLIC rnoh_thumbnail) +# RNOH_END: manual_package_linking_2 +``` + +打开 `entry/src/main/cpp/PackageProvider.cpp`，添加： + +```diff +#include "RNOH/PackageProvider.h" +#include "generated/RNOHGeneratedPackage.h" +#include "SamplePackage.h" ++ #include "ThumbnailPackage.h" + +using namespace rnoh; + +std::vector> PackageProvider::getPackages(Package::Context ctx) { + return { + std::make_shared(ctx), + std::make_shared(ctx), ++ std::make_shared(ctx) + }; +} +``` + ### 运行 点击右上角的 `sync` 按钮 @@ -253,18 +315,10 @@ ohpm install 要使用此库，需要使用正确的 React-Native 和 RNOH 版本。另外，还需要使用配套的 DevEco Studio 和 手机 ROM。 -请到三方库的 Releases 发布地址查看配套的版本信息： - -| 三方库版本 | 发布信息 | 支持RN版本 | -|-------| ------------------------------------------------------------ | ---------- | -| 1.1.3@deprecated | [@react-native-oh-tpl/react-native-thumbnail Releases(deprecated)](https://github.com/react-native-oh-library/react-native-thumbnail/releases) | 0.72 | -| 1.1.4 | [@react-native-ohos/react-native-thumbnail Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-thumbnail/releases) | 0.72 | -| 1.2.0 | [@react-native-ohos/react-native-thumbnail Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-thumbnail/releases) | 0.77 | - -本文档内容基于以下版本验证通过： - -1. RNOH: 0.72.98; SDK: HarmonyOS-5.0.0(API12); IDE: DevEco Studio 5.0.3.906; ROM: NEXT.0.0.71; -2. RNOH：0.77.18; SDK：HarmonyOS 6.0.0.47 (API Version 20); IDE：DevEco Studio 6.0.0.858; ROM：6.0.0.107; +1. 在以下版本验证通过： + 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; ## API diff --git a/zh-cn/react-native-udp.md b/zh-cn/react-native-udp.md index c9701ee6f..adc3f80f1 100644 --- a/zh-cn/react-native-udp.md +++ b/zh-cn/react-native-udp.md @@ -22,7 +22,7 @@ | 三方库版本 | 发布信息 | 支持RN版本 | |--------| ------------------------------------------------------------ | ---------- | -| 4.1.7@deprecated | [@react-native-oh-tpl/react-native-udp Releases(deprecated)](https://github.com/react-native-oh-library/react-native-udp/releases) | 0.72 | +| <=4.1.7-0.0.2@deprecated | [@react-native-oh-tpl/react-native-udp Releases(deprecated)](https://github.com/react-native-oh-library/react-native-udp/releases) | 0.72 | | 4.1.8 | [@react-native-ohos/react-native-udp Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-udp/releases) | 0.72 | | 4.2.0 | [@react-native-ohos/react-native-udp Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-udp/releases) | 0.77 | @@ -225,11 +225,11 @@ ohpm install ### 3.配置 CMakeLists 和引入 UdpPackage -> [!TIP] 若使用的是 4.1.8 版本，请跳过本章。 +> [!TIP] 若使用的是 <=4.1.7-0.0.2版本，请跳过本章。 打开 `entry/src/main/cpp/CMakeLists.txt`，添加： -``` +```diff project(rnapp) cmake_minimum_required(VERSION 3.4.1) set(CMAKE_SKIP_BUILD_RPATH TRUE) @@ -267,7 +267,7 @@ target_link_libraries(rnoh_app PUBLIC rnoh_sample_package) 打开 `entry/src/main/cpp/PackageProvider.cpp`，添加： -``` +```diff #include "RNOH/PackageProvider.h" #include "generated/RNOHGeneratedPackage.h" #include "SamplePackage.h" @@ -322,8 +322,9 @@ ohpm install 在以下版本验证通过： -1. RNOH：0.72.96; SDK：HarmonyOS 5.1.0.150 (API Version 12); IDE：DevEco Studio 5.1.1.830; ROM：5.1.0.150; -2. RNOH：0.77.18; SDK：HarmonyOS 5.1.0.150 (API Version 12); IDE：DevEco Studio 5.1.1.830; ROM：5.1.0.150; +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; ## API diff --git a/zh-cn/react-native-user-agent.md b/zh-cn/react-native-user-agent.md index b77994334..07ba28b0c 100644 --- a/zh-cn/react-native-user-agent.md +++ b/zh-cn/react-native-user-agent.md @@ -22,7 +22,7 @@ | 三方库版本 | 发布信息 | 支持RN版本 | |--------| ------------------------------------------------------------ | ---------- | -| 2.3.1@deprecated | [@react-native-oh-tpl/react-native-user-agent Releases(deprecated)](https://github.com/react-native-oh-library/react-native-user-agent/releases) | 0.72 | +| <=2.3.1-0.0.1@deprecated | [@react-native-oh-tpl/react-native-user-agent Releases(deprecated)](https://github.com/react-native-oh-library/react-native-user-agent/releases) | 0.72 | | 2.3.2 | [@react-native-ohos/react-native-user-agent Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-user-agent/releases) | 0.72 | | 2.4.0 | [@react-native-ohos/react-native-user-agent Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-user-agent/releases) | 0.77 | @@ -151,7 +151,7 @@ ohpm install ### 3.配置 CMakeLists 和引入 UserAgent ->注：0.77 不需要配置 CMakeLists 。 +>若使用的是 <=2.3.1-0.0.1 版本，请跳过本章。 ```diff project(rnapp) @@ -244,8 +244,9 @@ ohpm install 在以下版本验证通过： -1. RNOH：0.72.96; SDK：HarmonyOS 5.1.0.150 (API Version 12); IDE：DevEco Studio 5.1.1.830; ROM：5.1.0.150; -2. RNOH：0.77.18; SDK：HarmonyOS 5.1.0.150 (API Version 12); IDE：DevEco Studio 5.1.1.830; ROM：5.1.0.150; +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-view-pdf.md b/zh-cn/react-native-view-pdf.md index 53f60f6c1..5f1c09629 100644 --- a/zh-cn/react-native-view-pdf.md +++ b/zh-cn/react-native-view-pdf.md @@ -20,7 +20,7 @@ | 三方库版本 | 发布信息 | 支持RN版本 | | ---------- | ------------------------------------------------------------ | ---------- | -| 0.14.0@deprecated | [@react-native-oh-tpl/react-native-view-pdf Releases(deprecated)](https://github.com/react-native-oh-library/react-native-PDFView/releases) | 0.72 | +| <=0.14.0-0.0.2@deprecated | [@react-native-oh-tpl/react-native-view-pdf Releases(deprecated)](https://github.com/react-native-oh-library/react-native-PDFView/releases) | 0.72 | | 0.14.1 | [@react-native-ohos/react-native-view-pdf Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-view-pdf/releases) | 0.72 | | 0.15.0 | [@react-native-ohos/react-native-view-pdf Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-view-pdf/releases) | 0.77 | @@ -161,7 +161,7 @@ const arkTsComponentNames: Array = [ ### 4.配置 CMakeLists 和引入 ViewPdfPackage -> [!TIP] 版本 `0.15.0` 及以上需要 +> [!TIP] 若使用的是 <=0.14.0-0.0.2 版本，请跳过本章。 打开 `entry/src/main/cpp/CMakeLists.txt`，添加： @@ -255,8 +255,9 @@ ohpm install 在以下版本验证通过： -1. RNOH：0.72.96; SDK：HarmonyOS 5.1.0.150 (API Version 12); IDE：DevEco Studio 5.1.1.830; ROM：5.1.0.150; -2. RNOH：0.77.18; SDK：HarmonyOS 5.1.0.150 (API Version 12); IDE：DevEco Studio 5.1.1.830; ROM：5.1.0.150; +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-view-shot.md b/zh-cn/react-native-view-shot.md index 86a809d0e..6278a0703 100644 --- a/zh-cn/react-native-view-shot.md +++ b/zh-cn/react-native-view-shot.md @@ -20,7 +20,7 @@ | 三方库版本 | 发布信息 | 支持RN版本 | |--------| ------------------------------------------------------------ | ---------- | -| 3.8.0@deprecated | [@react-native-oh-tpl/react-native-view-shot Releases(deprecated)](https://github.com/react-native-oh-library/react-native-view-shot/releases) | 0.72 | +| <=3.8.0-0.3.2@deprecated | [@react-native-oh-tpl/react-native-view-shot Releases(deprecated)](https://github.com/react-native-oh-library/react-native-view-shot/releases) | 0.72 | | 3.8.1 | [@react-native-ohos/react-native-view-shot Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-view-shot/releases) | 0.72 | | 3.9.0 | [@react-native-ohos/react-native-view-shot Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-view-shot/releases) | 0.77 | @@ -173,6 +173,8 @@ ohpm install ### 3.配置 CMakeLists 和引入 ViewShotPackage +> 若使用的是 <=3.8.0-0.3.2 版本，请跳过本章。 + 打开 `entry/src/main/cpp/CMakeLists.txt`，添加： ```diff @@ -186,7 +188,7 @@ add_subdirectory("${RNOH_CPP_DIR}" ./rn) # RNOH_BEGIN: manual_package_linking_1 add_subdirectory("../../../../sample_package/src/main/cpp" ./sample-package) -+ add_subdirectory("${OH_MODULES}/@react-native-ohos/react-native-view-shot/src/main/cpp" ./view-shot) ++ add_subdirectory("${OH_MODULES}/@react-native-ohos/react-native-view-shot/src/main/cpp" ./view_shot) # RNOH_BEGIN: manual_package_linking_1 add_library(rnoh_app SHARED @@ -255,8 +257,9 @@ ohpm install 在以下版本验证通过： -1. RNOH：0.72.96; SDK：HarmonyOS 5.1.0.150 (API Version 12); IDE：DevEco Studio 5.1.1.830; ROM：5.1.0.150; -2. RNOH：0.77.18; SDK：HarmonyOS 5.1.0.150 (API Version 12); IDE：DevEco Studio 5.1.1.830; ROM：5.1.0.150; +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; ## 属性 -- Gitee