From 49106cd107ae6d9cca55e6603ca102bfb44f27a7 Mon Sep 17 00:00:00 2001 From: ludir <2930650146@qq.com> Date: Sun, 7 Dec 2025 08:56:04 +0800 Subject: [PATCH 1/2] =?UTF-8?q?docs:=20[issue:#IDB6TO]=E4=B8=89=E6=96=B9?= =?UTF-8?q?=E5=BA=93=E9=80=82=E9=85=8Dcli=E5=B7=A5=E5=85=B7=E9=9C=80?= =?UTF-8?q?=E6=B1=8220=E4=B8=AA=E4=B8=89=E6=96=B9=E5=BA=93=E6=96=87?= =?UTF-8?q?=E6=A1=A3=E4=BF=AE=E6=94=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: ludir <2930650146@qq.com> --- en/bam-tech-react-native-image-resizer.md | 10 +-- en/react-native-email-link.md | 13 +-- en/react-native-exception-handler.md | 11 ++- en/react-native-file-access.md | 11 +-- en/react-native-fileupload.md | 11 +-- en/react-native-haptic-feedback.md | 18 ++-- en/react-native-http-bridge.md | 80 +++++++++++++++--- en/react-native-idfa-aaid.md | 82 +++++++++++++++--- en/react-native-localization.md | 21 +++-- en/react-native-ohos-community-auto-fill.md | 50 +++++++---- en/react-native-performance.md | 27 ++++-- en/react-native-quick-base64.md | 10 +-- en/react-native-search-bar.md | 10 +-- en/react-native-send-intent.md | 14 ++-- en/react-native-share.md | 10 +-- en/react-native-thumbnail.md | 84 +++++++++++++++---- 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 | 13 +-- zh-cn/bam-tech-react-native-image-resizer.md | 8 +- zh-cn/react-native-email-link.md | 15 ++-- zh-cn/react-native-exception-handler.md | 9 +- zh-cn/react-native-file-access.md | 9 +- zh-cn/react-native-fileupload.md | 9 +- zh-cn/react-native-haptic-feedback.md | 16 ++-- zh-cn/react-native-http-bridge.md | 77 +++++++++++++++-- zh-cn/react-native-idfa-aaid.md | 77 +++++++++++++++-- zh-cn/react-native-localization.md | 20 +++-- .../react-native-ohos-community-auto-fill.md | 50 +++++++---- zh-cn/react-native-performance.md | 15 ++-- zh-cn/react-native-quick-base64.md | 8 +- zh-cn/react-native-search-bar.md | 8 +- 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 | 9 +- 40 files changed, 700 insertions(+), 269 deletions(-) diff --git a/en/bam-tech-react-native-image-resizer.md b/en/bam-tech-react-native-image-resizer.md index 6f53fd7d..6299ae1d 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: @@ -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 2489a45f..ee0f1b63 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 | @@ -159,8 +159,6 @@ Version >= @react-native-ohos/react-native-email-link@1.15.1，compatible with c If this repository has been adapted to `Codegen`, generate the bridge code of the third-party library by using the `Codegen`. For details, see [Codegen Usage Guide](/en/codegen.md). -**Note：** V1.16.1 does not require Codegen. - ## Link Version >= @react-native-ohos/react-native-email-lin@1.15.1 now supports Autolink without requiring manual configuration, currently only supports 72 frameworks. @@ -213,7 +211,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 +299,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. -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; +The following combinations have been verified: + +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 08d0460f..8de47479 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 @@ -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 53f129e7..5fc0114a 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 eeeaf92a..aa930396 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 c333b942..6027ed6d 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： @@ -275,16 +275,16 @@ 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 +#### Include applicable permissions in the module.json5 file within the entry directory. + Add the configuration to the **entry/src/main/module.json5** file. ```js "requestPermissions": [ { "name": "ohos.permission.VIBRATE" }, ] diff --git a/en/react-native-http-bridge.md b/en/react-native-http-bridge.md index 331bf385..2852aac7 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" ./http_bridge) + +# 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 d5a74ecf..8a523488 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 | @@ -178,7 +178,7 @@ export default App; ## Use Codegen -> [!TIP] Version >= 1.2.1 no need to execute Codegen +Version >= @react-native-ohos/react-native-idfa-aaid@1.2.1, compatible with codegen-lib for generating bridge code. If this repository has been adapted to `Codegen`, generate the bridge code of the third-party library by using the `Codegen`. For details, see [Codegen Usage Guide](/en/codegen.md). @@ -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" ./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,12 +334,15 @@ 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`补上配置 @@ -305,8 +370,6 @@ 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`，添加： @@ -322,8 +385,7 @@ 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) + 当前的 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) ## Static Methods (If Any) diff --git a/en/react-native-localization.md b/en/react-native-localization.md index b45ec011..b865e499 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 | [@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 | +| <=2.3.2-0.0.1@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.3 | [@react-native-ohos/react-native-localization Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-localization/releases) | 0.72 | +| 2.4.0 | [@react-native-ohos/react-native-localization Releases](https://gitcode.com/openharmony-sig/rntpc_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 8578c4df..9c79297e 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 d8e886c4..13187117 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** @@ -203,9 +207,9 @@ const styles = StyleSheet.create({ ## Use Codegen -> [!TIP] V5.1.3 no need to execute Codegen +Version >= @react-native-ohos/react-native-performance@5.1.3, compatible with codegen-lib for generating bridge code. -If this repository has been adapted to `Codegen`, generate the bridge code of the third-party library by using the `Codegen`. For details, see [Codegen Usage Guide](/zh-cn/codegen.md). +If this repository has been adapted to `Codegen`, generate the bridge code of the third-party library by using the `Codegen`. For details, see [Codegen Usage Guide](/en/codegen.md). ## Link @@ -275,9 +279,9 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { ### 4.Configure CMakeLists and import PerformancePackage -> [!TIP] If using version 5.1.2, please skip this chapter +> If using version <=5.1.2-0.0.3, 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 c90f5631..fa9243da 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 00654ae0..8d4bbc36 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: @@ -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 386eb2ee..d366e122 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 d278685d..75385edd 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 diff --git a/en/react-native-thumbnail.md b/en/react-native-thumbnail.md index 68c70da7..87f6fb3c 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,70 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { } ``` -### 4. Running + +### 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 +316,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 fcde0f0c..f9cc89cd 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 b833c101..1ed9835f 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 807bc952..bada952e 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 ec0fe91e..4ad538e8 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 @@ -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 属性详情 | 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 c0f5ef3a..5976fd47 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`，添加： @@ -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 bb207abc..136a2541 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 | @@ -158,8 +158,6 @@ Version >= @react-native-ohos/react-native-email-link@1.15.1，已适配codegen- 本库已经适配了 `Codegen` ，在使用前需要主动执行生成三方库桥接代码，详细请参考[ Codegen 使用文档](https://gitee.com/react-native-oh-library/usage-docs/blob/master/zh-cn/codegen.md)。 -**注意：** V1.16.1 不需要执行 Codegen。 - ## Link Version >= @react-native-ohos/react-native-email-lin@1.15.1，已支持 Autolink，无需手动配置，目前只支持72框架。 Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md @@ -215,7 +213,7 @@ ohpm install ### 3.配置 CMakeLists和引入 RNOHGeneratedPackage -> V1.16.1 需要配置 CMakeLists和引入 RNOHGeneratedPackage。 +> 若使用的是 <= 1.15.0-0.0.2 版本，请跳过本章。 本库将codegen生成的代码内置在库文件中。 @@ -284,7 +282,7 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { } ``` -### 4.运行 +### 5.运行 点击右上角的 `sync` 按钮 @@ -303,8 +301,11 @@ 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 d4391ade..a494fea1 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 @@ -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 19501675..a40516b4 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 d69dcdc2..08d81ab7 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 fb969842..2be30ca3 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`，添加： @@ -278,16 +278,16 @@ 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 目录下的module.json5中添加权限 + 在 entry/src/main/module.json5补上配置 ```js "requestPermissions": [ { "name": "ohos.permission.VIBRATE" }, ] diff --git a/zh-cn/react-native-http-bridge.md b/zh-cn/react-native-http-bridge.md index 0cb5d18b..dfc645b1 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" ./http_bridge) + +# 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 51231268..bff53f3c 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 | @@ -178,7 +178,7 @@ export default App; ## 使用 Codegen -> [!TIP] Version >= 1.2.1 不需要执行Codegen +Version >= @react-native-ohos/react-native-idfa-aaid@1.2.1，已适配codegen-lib生成桥接代码。 本库已经适配了 `Codegen` ，在使用前需要主动执行生成三方库桥接代码，详细请参考[ Codegen 使用文档](/zh-cn/codegen.md)。 @@ -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" ./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,8 +335,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; ### 权限要求 @@ -306,11 +369,9 @@ ohpm install } } ``` -在 `YourProject/entry/src/main/resources/base/element/string.json`补上配置 - #### 在 entry 目录下添加申请权限的原因 -打开 `entry/src/main/resources/base/element/string.json`，添加： +在 `YourProject/entry/src/main/resources/base/element/string.json`补上配置 ```diff ... diff --git a/zh-cn/react-native-localization.md b/zh-cn/react-native-localization.md index 98725559..7a9022d5 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 | [@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 | +| <=2.3.2-0.0.1@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.3 | [@react-native-ohos/react-native-localization Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-localization/releases) | 0.72 | +| 2.4.0 | [@react-native-ohos/react-native-localization Releases](https://gitcode.com/openharmony-sig/rntpc_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 21c274b7..84052afe 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 e438610c..d06f3ed3 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 | @@ -203,7 +203,7 @@ const styles = StyleSheet.create({ ``` ## 使用 Codegen -> [!TIP] V5.1.3 不需要执行 Codegen。 +Version >= @react-native-ohos/react-native-performance@5.1.3，已适配codegen-lib生成桥接代码。 本库已经适配了 `Codegen` ，在使用前需要主动执行生成三方库桥接代码，详细请参考[ Codegen 使用文档](/zh-cn/codegen.md)。 @@ -278,7 +278,7 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { ### 4.配置 CMakeLists 和引入 PerformancePackage -> [!TIP] 若使用的是V 5.1.2 版本，请跳过本章 +> 若使用的是 <=5.1.2-0.0.3 版本，请跳过本章 打开 `entry/src/main/cpp/CMakeLists.txt`，添加： @@ -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 c9026e56..edc25e15 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 9f57845a..61e53e95 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`，添加： @@ -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 406f5029..aede22ee 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 ca7b8f5e..716272e6 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 b44fd389..8d1c6204 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 c9701ee6..adc3f80f 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 b7799433..07ba28b0 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 53f60f6c..5f1c0962 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 86a809d0..1d8c324b 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 @@ -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 From b53b58d370ebcba4c222b2723150608381dcc760 Mon Sep 17 00:00:00 2001 From: ludeyin <2930650146@qq.com> Date: Mon, 8 Dec 2025 17:19:07 +0800 Subject: [PATCH 2/2] =?UTF-8?q?docs:=20[Issues:#IDBII8]=E4=BF=AE=E5=A4=8Dr?= =?UTF-8?q?eact-native-localization=E4=BB=93=E5=BA=93=E9=93=BE=E6=8E=A5?= =?UTF-8?q?=E9=97=AE=E9=A2=98?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- en/react-native-localization.md | 2 +- zh-cn/react-native-localization.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/en/react-native-localization.md b/en/react-native-localization.md index b865e499..90fd9bef 100644 --- a/en/react-native-localization.md +++ b/en/react-native-localization.md @@ -22,7 +22,7 @@ This third-party library has been migrated to Gitcode and is now available for d | Third-party Library Version | Release Information | Supported RN Version | |-------| ------------------------------------------------------------ | ---------- | -| <=2.3.2-0.0.1@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.3 | [@react-native-ohos/react-native-localization Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-localization/releases) | 0.72 | | 2.4.0 | [@react-native-ohos/react-native-localization Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-localization/releases) | 0.77 | diff --git a/zh-cn/react-native-localization.md b/zh-cn/react-native-localization.md index 7a9022d5..02f1eec5 100644 --- a/zh-cn/react-native-localization.md +++ b/zh-cn/react-native-localization.md @@ -24,7 +24,7 @@ | 三方库版本 | 发布信息 | 支持RN版本 | |-------| ------------------------------------------------------------ | ---------- | -| <=2.3.2-0.0.1@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.3 | [@react-native-ohos/react-native-localization Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-localization/releases) | 0.72 | | 2.4.0 | [@react-native-ohos/react-native-localization Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-localization/releases) | 0.77 | -- Gitee