From 7de9f639f5e755fb7d8faaf20f70bfe7842074b4 Mon Sep 17 00:00:00 2001 From: yudaxia Date: Wed, 10 Dec 2025 15:25:32 +0800 Subject: [PATCH 1/6] =?UTF-8?q?fix:=20=E4=BF=AE=E6=94=B9=E4=B8=89=E4=B8=AA?= =?UTF-8?q?=E4=B8=AD=E8=8B=B1=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- en/react-native-amap3d.md | 66 ++++------------- en/react-native-bars.md | 89 ++++++++++++++++++++--- en/react-native-custom-keyboard.md | 48 +++++-------- zh-cn/react-native-amap3d.md | 71 +++++------------- zh-cn/react-native-bars.md | 100 ++++++++++++++++++++++---- zh-cn/react-native-custom-keyboard.md | 53 ++++++-------- 6 files changed, 240 insertions(+), 187 deletions(-) diff --git a/en/react-native-amap3d.md b/en/react-native-amap3d.md index 7e9bc0016..9d3ca48e3 100644 --- a/en/react-native-amap3d.md +++ b/en/react-native-amap3d.md @@ -15,17 +15,18 @@ This project is based on [react-native-amap3d](https://github.com/qiuxiang/react-native-amap3d). +## Installation and Usage + Find the matching version information in the release address of a third-party library: -| Version | Package name | Repository | Release | Support RN version | -|---------|------------------------------------------|--------------------------------------------------------------------------|--------------------------------------------------------------------------------------------|---------------------| -| 3.2.4 | @react-native-oh-tpl/react-native-amap3d | [Github](https://github.com/react-native-oh-library/react-native-amap3d) | [Github Releases](https://github.com/react-native-oh-library/react-native-amap3d/releases) | 0.72 | -| 3.3.0 | @react-native-ohos/react-native-amap3d | [Github](https://github.com/react-native-oh-library/react-native-amap3d) | [Github Releases](https://github.com/react-native-oh-library/react-native-amap3d/releases) | 0.77 | +| Third-party Library Version | Release Information | Supported RN Version | +|----------------------------| ----------------------------------------------------------- | ---------- | +| <= 3.2.5@deprecated | [@react-native-oh-tpl/react-native-custom-keyboard Releases(deprecated)](https://github.com/react-native-oh-library/react-native-amap3d/releases) | 0.72 | +| 3.2.6 | [@react-native-ohos/react-native-custom-keyboard Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-amap3d/releases) | 0.72 | +| 3.3.0 | [@react-native-ohos/react-native-custom-keyboard Releases](https://github.com/react-native-oh-library/react-native-amap3d/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. -## Installation and Usage - Go to the project directory and execute the following instruction: @@ -34,20 +35,12 @@ Go to the project directory and execute the following instruction: #### **npm** ```bash -# 0.72 -npm install @react-native-oh-tpl/react-native-amap3d - -# 0.77 npm install @react-native-ohos/react-native-amap3d ``` #### **yarn** ```bash -# 0.72 -yarn add @react-native-oh-tpl/react-native-amap3d - -# 0.77 yarn add @react-native-ohos/react-native-amap3d ``` @@ -175,7 +168,9 @@ export default AMapDemo; ## Link -Currently, HarmonyOS does not support AutoLink. Therefore, you need to manually configure the linking. +Version >= @react-native-ohos/react-native-amap3d@3.2.6, now supports Autolink without requiring manual configuration, currently only supports 72 frameworks. Autolink Framework Guide Documentation: https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md + +This step provides guidance for manually configuring native dependencies. Open the `harmony` directory of the HarmonyOS project in DevEco Studio. @@ -201,17 +196,6 @@ Method 1 (recommended): Use the HAR file. Open `entry/oh-package.json5` file and add the following dependencies: -- V0.72 - -```json -"dependencies": { - "@rnoh/react-native-openharmony": "file:../react_native_openharmony", - "@react-native-oh-tpl/react-native-amap3d": "file:../../node_modules/@react-native-oh-tpl/react-native-amap3d/harmony/rn_amap3d.har" - } -``` - -- V0.77 - ```json "dependencies": { "@rnoh/react-native-openharmony": "file:../react_native_openharmony", @@ -237,6 +221,7 @@ Method 2: Directly link to the source code. 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) @@ -255,10 +240,6 @@ add_subdirectory("${RNOH_CPP_DIR}" ./rn) # RNOH_BEGIN: manual_package_linking_1 add_subdirectory("../../../../sample_package/src/main/cpp" ./sample-package) -# V0.72 -+ add_subdirectory("${OH_MODULES}/@react-native-oh-tpl/react-native-amap3d/src/main/cpp" ./rn_amap3d) - -# V0.77 + add_subdirectory("${OH_MODULES}/@react-native-ohos/react-native-amap3d/src/main/cpp" ./rn_amap3d) # RNOH_END: manual_package_linking_1 @@ -281,6 +262,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" @@ -303,22 +285,7 @@ std::vector> PackageProvider::getPackages(Package::Cont Find `function buildCustomRNComponent()`, which is usually located in `entry/src/main/ets/pages/index.ets` or `entry/src/main/ets/rn/LoadBundle.ets`, and add the following code: ```diff -... -// V0.72 -+ import { -+ A_MAP_CIRCLE_VIEW_TYPE, -+ A_MAP_MARKER_TYPE, -+ A_MAP_POLYGON_TYPE, -+ A_MAP_POLYLINE_TYPE, -+ AMapCircle, -+ AMapMarker, -+ AMapPolygon, -+ AMapPolyline, -+ AMapView, -+ GOADE_MAP_VIEW_TYPE -+} from '@react-native-oh-tpl/react-native-amap3d'; -// V0.77 + import { + A_MAP_CIRCLE_VIEW_TYPE, + A_MAP_MARKER_TYPE, @@ -393,11 +360,7 @@ Open the `entry/src/main/ets/RNPackagesFactory.ts` file and add the following co ```diff - ... -// V0.72 -+ import {AMap3DPackage} from '@react-native-oh-tpl/react-native-amap3d/ts'; -// V0.77 + import {AMap3DPackage} from '@react-native-ohos/react-native-amap3d/ts'; export function createRNPackages(ctx: RNPackageContext): RNPackage[] { @@ -429,8 +392,9 @@ To use this repository, you need to use the correct React-Native and RNOH versio Verified in the following versions. -1. RNOH: 0.72.27; SDK: HarmonyOS 5.1.1 Release SDK; IDE: DevEco Studio 5.1.1 Release; ROM: 5.0.1.120; -2. 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.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-bars.md b/en/react-native-bars.md index da1ebc1d7..e5c7e99cd 100644 --- a/en/react-native-bars.md +++ b/en/react-native-bars.md @@ -17,24 +17,30 @@ ## Installation and Usage -Find the matching version information in the release address of a third-party library: [@react-native-oh-tpl/react-native-bars Releases](https://github.com/react-native-oh-library/react-native-bars/releases).For older versions that are not published to npm, please refer to the [installation guide](/en/tgz-usage-en.md) to install the tgz package. +Please refer to the Releases page of the third-party library for the corresponding version information -Go to the project directory and execute the following instruction: +| Third-party Library Version | Release Information | Supported RN Version | +|-----------------------------|--------------------------------------------------------------------------------------------------------------------------------------| ---------- | +| <= 2.4.3-0.0.3@deprecated | [@react-native-oh-tpl/react-native-bars Releases(deprecated)](https://github.com/react-native-oh-library/react-native-bars/releases) | 0.72 | +| 2.4.4 | [@react-native-ohos/react-native-bars Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-bars/releases) | 0.72 | +| 2.5.0 | [@react-native-ohos/react-native-bars Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-bars/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** ```bash -npm install @react-native-oh-tpl/react-native-bars +npm install @react-native-ohos/react-native-bars ``` #### **yarn** ```bash -yarn add @react-native-oh-tpl/react-native-bars +yarn add @react-native-ohos/react-native-bars ``` @@ -70,11 +76,15 @@ export function BarExample() { ## Use Codegen +Version >= @react-native-ohos/react-native-bars@2.4.4, 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). ## Link -Currently, HarmonyOS does not support AutoLink. Therefore, you need to manually configure the linking. +Version >= @react-native-ohos/react-native-bars@2.4.4 now supports Autolink without requiring manual configuration, currently only supports 72 frameworks. Autolink Framework Guide Documentation: https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md + +This step provides guidance for manually configuring native dependencies. Open the `harmony` directory of the HarmonyOS project in DevEco Studio. @@ -102,7 +112,7 @@ Open `entry/oh-package.json5` file and add the following dependencies: ```json "dependencies": { "@rnoh/react-native-openharmony": "file:../react_native_openharmony", - "@react-native-oh-tpl/react-native-bars": "file:../../node_modules/@react-native-oh-tpl/react-native-bars/harmony/bars.har" + "@react-native-ohos/react-native-bars": "file:../../node_modules/@react-native-ohos/react-native-bars/harmony/bars.har" } ``` @@ -120,13 +130,68 @@ Method 2: Directly link to the source code. > [!TIP] For details, see [Directly Linking Source Code](/en/link-source-code.md). -### 3. Introducing RNBarsPackage to ArkTS +### 3.Configuring CMakeLists and Introducing RNDeviceInfoPackage + +> If you are using version <= 2.4.3-0.0.3, 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-bars/src/main/cpp" ./native-bars) +# 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_native-bars) +# RNOH_END: manual_package_linking_2 +``` +Open `entry/src/main/cpp/PackageProvider.cpp` and add the following code: +```diff +#include "RNOH/PackageProvider.h" ++ #include "RNBarsPackage.h" + +using namespace rnoh; + +std::vector> PackageProvider::getPackages(Package::Context ctx) +{ + return { ++ std::make_shared(ctx) + }; +} +``` +### 4. Introducing RNBarsPackage to ArkTS Open the `entry/src/main/ets/RNPackagesFactory.ts` file and add the following code: ```diff ... -+ import {RNBarsPackage} from '@react-native-oh-tpl/react-native-bars/ts'; ++ import {RNBarsPackage} from '@react-native-ohos/react-native-bars/ts'; export function createRNPackages(ctx: RNPackageContext): RNPackage[] { return [ @@ -136,7 +201,7 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { } ``` -### 4. Running +### 5. Running Click the `sync` button in the upper right corner. @@ -155,7 +220,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. -Check the release version information in the release address of the third-party library: [@react-native-oh-tpl/react-native-bars Releases](https://github.com/react-native-oh-library/react-native-bars/releases) +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; ## Properties diff --git a/en/react-native-custom-keyboard.md b/en/react-native-custom-keyboard.md index 71f6e939e..6c67dcaeb 100644 --- a/en/react-native-custom-keyboard.md +++ b/en/react-native-custom-keyboard.md @@ -17,10 +17,11 @@ The repository of this third-party library has been migrated to Gitcode and supports direct download from npm. The new package name is: @react-native-ohos/react-native-custom-keyboard. The specific version ownership relationship is as follows: -| Version | Package Name | Repository | Release | Support RN version | -| ---------- | ------------------------------------------------------------ | ---------- | ---------- | ---------- | -| 1.0.3 | @react-native-oh-tpl/react-native-custom-keyboard | [Github](https://github.com/react-native-oh-library/react-native-custom-keyboard)|[Github Releases](https://github.com/react-native-oh-library/react-native-custom-keyboard/releases)|0.72 | -| 1.1.0 | @react-native-ohos/react-native-custom-keyboard | [Gitcode](https://gitcode.com/openharmony-sig/rntpc_react-native-custom-keyboard/tree/br_rnoh0.77) |[Gitcode Releases]() | 0.77 | +| Third-party Library Version | Release Information | Supported RN Version | +|----------------------------| ------------------------------------------------------------ | ---------- | +| <= 1.0.3-0.0.2@deprecated | [@react-native-oh-tpl/react-native-custom-keyboard Releases(deprecated)](https://github.com/react-native-oh-library/react-native-custom-keyboard/releases) | 0.72 | +| 1.0.4 | [@react-native-ohos/react-native-custom-keyboard Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-custom-keyboard/releases) | 0.72 | +| 1.1.0 | [@react-native-ohos/react-native-custom-keyboard Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-custom-keyboard/releases) | 0.77 | ## Installation and Usage @@ -31,20 +32,12 @@ Go to the project directory and execute the following instruction: #### **npm** ```bash -# V1.0.3 for RN0.72 -npm install @react-native-oh-tpl/react-native-custom-keyboard - -# V1.1.0 for RN0.77 npm install @react-native-ohos/react-native-custom-keyboard ``` #### **yarn** ```bash -# V1.0.3 for RN0.72 -yarn add @react-native-oh-tpl/react-native-custom-keyboard - -# V1.1.0 for RN0.77 yarn add @react-native-ohos/react-native-custom-keyboard ``` @@ -166,16 +159,19 @@ const styles = StyleSheet.create({ ## Use Codegen -[!TIP] V1.1.0 for RN0.77 does not require Codegen to be executed. +Version >= @react-native-ohos/react-native-custom-keyboard@1.0.4, 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). ## Link -Currently, HarmonyOS does not support AutoLink. Therefore, you need to manually configure the linking. +Version >= @react-native-ohos/react-native-custom-keyboard@1.0.4, now supports Autolink without requiring manual configuration, currently only supports 72 frameworks. Autolink Framework Guide Documentation: https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md + +This step provides guidance for manually configuring native dependencies. Open the `harmony` directory of the HarmonyOS project in DevEco Studio. + ### 1. Adding the overrides Field to oh-package.json5 File in the Root Directory of the Project ```json @@ -200,15 +196,6 @@ Method 1 (recommended): Use the HAR file. Open `entry/oh-package.json5` file and add the following dependencies: -+ V1.0.3 for RN0.72 -```json -"dependencies": { - "@rnoh/react-native-openharmony" : "file:../react_native_openharmony", - "@react-native-oh-tpl/react-native-custom-keyboard": "file:../../node_modules/@react-native-oh-tpl/react-native-custom-keyboard/harmony/custom_keyboard.har" - } -``` - -+ V1.1.0 for RN0.77 ```json "dependencies": { "@rnoh/react-native-openharmony" : "file:../react_native_openharmony", @@ -229,7 +216,7 @@ Method 2: Directly link to the source code. For details, see [Directly Linking Source Code](/en/link-source-code.md). -### 3.Configuring CMakeLists and Introducing rnoh_custom_keyboard_package Package +### 3.Configuring CMakeLists and Introducing RNCustomKeyboardPackage Package Open `entry/src/main/cpp/CMakeLists.txt` and add the following code: @@ -252,7 +239,7 @@ add_subdirectory("${RNOH_CPP_DIR}" ./rn) # RNOH_BEGIN: manual_package_linking_1 add_subdirectory("../../../../sample_package/src/main/cpp" ./sample-package) # V1.0.3 for RN0.72 -+ add_subdirectory("${OH_MODULES}/@react-native-oh-tpl/react-native-custom-keyboard/src/main/cpp" ./custom-keyboard) ++ add_subdirectory("${OH_MODULES}/@react-native-ohos/react-native-custom-keyboard/src/main/cpp" ./custom-keyboard) # V1.1.0 for RN0.77 + add_subdirectory("${OH_MODULES}/@react-native-ohos/react-native-custom-keyboard/src/main/cpp" ./custom-keyboard) @@ -300,7 +287,7 @@ Open `entry/src/main/ets/RNPackagesFactory.ts` and add the following code: ... import type {RNPackageContext, RNPackage} from '@rnoh/react-native-openharmony/ts'; // V1.0.3 for RN0.72 -+import {RNCustomKeyboardPackage} from '@react-native-oh-tpl/react-native-custom-keyboard/ts'; ++import {RNCustomKeyboardPackage} from '@react-native-ohos/react-native-custom-keyboard/ts'; // V1.1.0 for RN0.77 +import {RNCustomKeyboardPackage} from '@react-native-ohos/react-native-custom-keyboard/ts'; @@ -330,10 +317,13 @@ Then build and run the code. ### Compatibility -The content of this document has been verified based on 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. + +Verified in the following versions. -1、RNOH: 0.72.38; SDK: HarmonyOS-5.0.0(API12); IDE: DevEco Studio 5.1.1.830; ROM: 6.0.0.112 SP12; -2、RNOH: 0.77.18; SDK: HarmonyOS-5.1.1.208(API19); IDE: DevEco Studio 5.1.1.830; ROM: 6.0.0.112 SP12; +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 (If Any) diff --git a/zh-cn/react-native-amap3d.md b/zh-cn/react-native-amap3d.md index 1ddc33e91..405f79d97 100644 --- a/zh-cn/react-native-amap3d.md +++ b/zh-cn/react-native-amap3d.md @@ -16,16 +16,18 @@ 本项目基于 [react-native-amap3d](https://github.com/qiuxiang/react-native-amap3d) 开发。 +## 安装与使用 + 请到三方库的 Releases 发布地址查看配套的版本信息： -| Version | Package name | Repository | Release | Support RN version | -|---------|------------------------------------------|--------------------------------------------------------------------------|--------------------------------------------------------------------------------------------|---------------------| -| 3.2.4 | @react-native-oh-tpl/react-native-amap3d | [Github](https://github.com/react-native-oh-library/react-native-amap3d) | [Github Releases](https://github.com/react-native-oh-library/react-native-amap3d/releases) | 0.72 | -| 3.3.0 | @react-native-ohos/react-native-amap3d | [Github](https://github.com/react-native-oh-library/react-native-amap3d) | [Github Releases](https://github.com/react-native-oh-library/react-native-amap3d/releases) | 0.77 | +| 三方库版本 | 发布信息 | 支持RN版本 | +|---------------------------| ------------------------------------------------------------ | ---------- | +| <= 3.2.5@deprecated | [@react-native-oh-tpl/react-native-amap3d Releases(deprecated)](https://github.com/react-native-oh-library/react-native-amap3d/releases) | 0.72 | +| 3.2.6 | [@react-native-ohos/react-native-amap3d Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-amap3d/releases) | 0.72 | +| 3.3.0 | [@react-native-ohos/react-native-amap3d Releases](https://github.com/react-native-oh-library/react-native-amap3d/releases) | 0.77 | 对于未发布到npm的旧版本，请参考[安装指南](/zh-cn/tgz-usage.md)安装tgz包。 - -## 安装与使用 +进入到工程目录并输入以下命令： 进入到工程目录并输入以下命令： @@ -34,21 +36,12 @@ #### **npm** ```bash -# 0.72 -npm install @react-native-oh-tpl/react-native-amap3d - -# 0.77 npm install @react-native-ohos/react-native-amap3d ``` #### **yarn** ```bash -# 0.72 -yarn add @react-native-oh-tpl/react-native-amap3d - - -# 0.77 yarn add @react-native-ohos/react-native-amap3d ``` @@ -176,7 +169,10 @@ export default AMapDemo; ## Link -目前HarmonyOS暂不支持 AutoLink，所以 Link 步骤需要手动配置。 + +Version >= @react-native-ohos/react-native-amap3d@3.2.6，已支持 Autolink，无需手动配置，目前只支持72框架。 Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md + +此步骤为手动配置原生依赖项的指导。 首先需要使用 DevEco Studio 打开项目里的HarmonyOS工程 `harmony` @@ -204,17 +200,6 @@ export default AMapDemo; 打开 `entry/oh-package.json5`，添加以下依赖 -- V0.72 - -```json -"dependencies": { - "@rnoh/react-native-openharmony": "file:../react_native_openharmony", - "@react-native-oh-tpl/react-native-amap3d": "file:../../node_modules/@react-native-oh-tpl/react-native-amap3d/harmony/rn_amap3d.har" - } -``` - -- V0.77 - ```json "dependencies": { "@rnoh/react-native-openharmony": "file:../react_native_openharmony", @@ -258,10 +243,6 @@ add_subdirectory("${RNOH_CPP_DIR}" ./rn) # RNOH_BEGIN: manual_package_linking_1 add_subdirectory("../../../../sample_package/src/main/cpp" ./sample-package) -# V0.72 -+ add_subdirectory("${OH_MODULES}/@react-native-oh-tpl/react-native-amap3d/src/main/cpp" ./rn_amap3d) - -# V0.77 + add_subdirectory("${OH_MODULES}/@react-native-ohos/react-native-amap3d/src/main/cpp" ./rn_amap3d) # RNOH_END: manual_package_linking_1 @@ -307,21 +288,6 @@ std::vector> PackageProvider::getPackages(Package::Cont ```diff ... -// V0.72 -+ import { -+ A_MAP_CIRCLE_VIEW_TYPE, -+ A_MAP_MARKER_TYPE, -+ A_MAP_POLYGON_TYPE, -+ A_MAP_POLYLINE_TYPE, -+ AMapCircle, -+ AMapMarker, -+ AMapPolygon, -+ AMapPolyline, -+ AMapView, -+ GOADE_MAP_VIEW_TYPE -+} from '@react-native-oh-tpl/react-native-amap3d'; - -// V0.77 + import { + A_MAP_CIRCLE_VIEW_TYPE, + A_MAP_MARKER_TYPE, @@ -397,10 +363,6 @@ const arkTsComponentNames: Array = [ ```diff ... -// V0.72 -+ import {AMap3DPackage} from '@react-native-oh-tpl/react-native-amap3d/ts'; - -// V0.77 + import {AMap3DPackage} from '@react-native-ohos/react-native-amap3d/ts'; export function createRNPackages(ctx: RNPackageContext): RNPackage[] { @@ -428,12 +390,15 @@ ohpm install ### 兼容性 + 要使用此库，需要使用正确的 React-Native 和 RNOH 版本。另外，还需要使用配套的 DevEco Studio 和 手机 ROM。 -在以下版本验证通过。 +在以下版本验证通过： + +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.27; SDK: HarmonyOS 5.1.1 Release SDK; IDE: DevEco Studio 5.1.1 Release; ROM: 5.0.1.120; -2. 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-bars.md b/zh-cn/react-native-bars.md index b93c9857f..882cd0c45 100644 --- a/zh-cn/react-native-bars.md +++ b/zh-cn/react-native-bars.md @@ -19,8 +19,16 @@ ## 安装与使用 -请到三方库的 Releases 发布地址查看配套的版本信息：[@react-native-oh-tpl/react-native-bars Releases](https://github.com/react-native-oh-library/react-native-bars/releases) 。对于未发布到npm的旧版本，请参考[安装指南](/zh-cn/tgz-usage.md)安装tgz包。 +请到三方库的 Releases 发布地址查看配套的版本信息： + +| 三方库版本 | 发布信息 | 支持RN版本 | +|---------------------------| ------------------------------------------------------------ | ---------- | +| <= 2.4.3-0.0.3@deprecated | [@react-native-oh-tpl/react-native-bars Releases(deprecated)](https://github.com/react-native-oh-library/react-native-bars/releases) | 0.72 | +| 2.4.4 | [@react-native-ohos/react-native-bars Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-bars/releases) | 0.72 | +| 2.5.0 | [@react-native-ohos/react-native-bars Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-bars/releases) | 0.77 | + +对于未发布到npm的旧版本，请参考[安装指南](/zh-cn/tgz-usage.md)安装tgz包。 进入到工程目录并输入以下命令： @@ -28,13 +36,13 @@ #### **npm** ```bash -npm install @react-native-oh-tpl/react-native-bars +npm install @react-native-ohos/react-native-bars ``` #### **yarn** ```bash -yarn add @react-native-oh-tpl/react-native-bars +yarn add @react-native-ohos/react-native-bars ``` @@ -72,9 +80,18 @@ export function BarExample() { ``` + +## 使用 Codegen + +Version >= @react-native-ohos/react-native-bars@2.4.4，已适配codegen-lib生成桥接代码。 + +本库已经适配了 `Codegen` ，在使用前需要主动执行生成三方库桥接代码，详细请参考[ Codegen 使用文档](/zh-cn/codegen.md)。 + ## Link -目前鸿蒙暂不支持 AutoLink，所以 Link 步骤需要手动配置。 +Version >= @react-native-ohos/react-native-bars@2.4.4，已支持 Autolink，无需手动配置，目前只支持72框架。 Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md + +此步骤为手动配置原生依赖项的指导。 首先需要使用 DevEco Studio 打开项目里的鸿蒙工程 `harmony` @@ -89,10 +106,6 @@ export function BarExample() { } ``` -## 使用 Codegen - -本库已经适配了 `Codegen` ，在使用前需要主动执行生成三方库桥接代码，详细请参考[ Codegen 使用文档](/zh-cn/codegen.md)。 - ### 2.引入原生端代码 目前有两种方法： @@ -109,7 +122,7 @@ export function BarExample() { ```json "dependencies": { "@rnoh/react-native-openharmony": "file:../react_native_openharmony", - "@react-native-oh-tpl/react-native-bars": "file:../../node_modules/@react-native-oh-tpl/react-native-bars/harmony/bars.har" + "@react-native-ohos/react-native-bars": "file:../../node_modules/@react-native-ohos/react-native-bars/harmony/bars.har" } ``` @@ -126,14 +139,71 @@ ohpm install > [!TIP] 如需使用直接链接源码，请参考[直接链接源码说明](/zh-cn/link-source-code.md) +### 3.配置 CMakeLists 和引入 RNBarsPackage + +> 若使用的是 <= 2.4.3-0.0.3 版本，请跳过本章。 -### 3.在 ArkTs 侧引入 RNBarsPackage +打开 `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-bars/src/main/cpp" ./native-bars) +# 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_native-bars) +# RNOH_END: manual_package_linking_2 +``` + +打开 `entry/src/main/cpp/PackageProvider.cpp`，添加： + +```diff +#include "RNOH/PackageProvider.h" ++ #include "RNBarsPackage.h" + +using namespace rnoh; + +std::vector> PackageProvider::getPackages(Package::Context ctx) +{ + return { ++ std::make_shared(ctx) + }; +} +``` + +### 4.在 ArkTs 侧引入 RNBarsPackage 打开 `entry/src/main/ets/RNPackagesFactory.ts`，添加： ```diff ... -+ import {RNBarsPackage} from '@react-native-oh-tpl/react-native-bars/ts'; ++ import {RNBarsPackage} from '@react-native-ohos/react-native-bars/ts'; export function createRNPackages(ctx: RNPackageContext): RNPackage[] { return [ @@ -143,7 +213,7 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { } ``` -### 4.运行 +### 5.运行 点击右上角的 `sync` 按钮 @@ -160,7 +230,11 @@ ohpm install 要使用此库，需要使用正确的 React-Native 和 RNOH 版本。另外，还需要使用配套的 DevEco Studio 和 手机 ROM。 -请到三方库相应的 Releases 发布地址查看 Release 配套的版本信息：[@react-native-oh-tpl/react-native-bars Releases](https://github.com/react-native-oh-library/react-native-bars/releases) +在以下版本验证通过： + +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-custom-keyboard.md b/zh-cn/react-native-custom-keyboard.md index aa75a3706..82ec6efd4 100644 --- a/zh-cn/react-native-custom-keyboard.md +++ b/zh-cn/react-native-custom-keyboard.md @@ -15,13 +15,13 @@ > [!TIP] [Github 地址](https://github.com/react-native-oh-library/react-native-custom-keyboard) -该第三方库的仓库已迁移至 Gitcode，且支持直接从 npm 下载，新的包名为：@react-native-ohos/react-native-custom-keyboard，具体版本所属关系如下： +请到三方库的 Releases 发布地址查看配套的版本信息： - -| 三方库版本 | 包名 | 仓库地址 | 发布(Release) | 支持RN版本 | -| ---------- | ------------------------------------------------------------ | ---------- | ---------- | ---------- | -| 1.0.3 | @react-native-oh-tpl/react-native-custom-keyboard | [Github](https://github.com/react-native-oh-library/react-native-custom-keyboard)|[Github Releases](https://github.com/react-native-oh-library/react-native-custom-keyboard/releases)|0.72 | -| 1.1.0 | @react-native-ohos/react-native-custom-keyboard | [Gitcode](https://gitcode.com/openharmony-sig/rntpc_react-native-custom-keyboard/tree/br_rnoh0.77) |[Gitcode Releases]() | 0.77 | +| 三方库版本 | 发布信息 | 支持RN版本 | +|----------------------------| ------------------------------------------------------------ | ---------- | +| <= 1.0.3-0.0.2@deprecated | [@react-native-oh-tpl/react-native-custom-keyboard Releases(deprecated)](https://github.com/react-native-oh-library/react-native-custom-keyboard/releases) | 0.72 | +| 1.0.4 | [@react-native-ohos/react-native-custom-keyboard Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-custom-keyboard/releases) | 0.72 | +| 1.1.0 | [@react-native-ohos/react-native-custom-keyboard Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-custom-keyboard/releases) | 0.77 | ## 安装与使用 @@ -32,20 +32,12 @@ #### **npm** ```bash -# V1.0.3 for RN0.72 -npm install @react-native-oh-tpl/react-native-custom-keyboard - -# V1.1.0 for RN0.77 npm install @react-native-ohos/react-native-custom-keyboard ``` #### **yarn** ```bash -# V1.0.3 for RN0.72 -yarn add @react-native-oh-tpl/react-native-custom-keyboard - -# V1.1.0 for RN0.77 yarn add @react-native-ohos/react-native-custom-keyboard ``` @@ -165,15 +157,19 @@ const styles = StyleSheet.create({ }); ``` + + ## 使用 Codegen -> [!TIP] V1.1.0 for RN0.77 不需要执行 Codegen。 +Version >= @react-native-ohos/react-native-custom-keyboard@1.0.4，已适配codegen-lib生成桥接代码。 本库已经适配了 `Codegen` ，在使用前需要主动执行生成三方库桥接代码，详细请参考[ Codegen 使用文档](/zh-cn/codegen.md)。 ## Link -目前 HarmonyOS 暂不支持 AutoLink，所以 Link 步骤需要手动配置。 +Version >= @react-native-ohos/react-native-custom-keyboard@1.0.4，已支持 Autolink，无需手动配置，目前只支持72框架。 Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md + +此步骤为手动配置原生依赖项的指导。 首先需要使用 DevEco Studio 打开项目里的 HarmonyOS 工程 `harmony` @@ -201,15 +197,6 @@ const styles = StyleSheet.create({ 打开 `entry/oh-package.json5`，添加以下依赖 -+ V1.0.3 for RN0.72 -```json -"dependencies": { - "@rnoh/react-native-openharmony" : "file:../react_native_openharmony", - "@react-native-oh-tpl/react-native-custom-keyboard": "file:../../node_modules/@react-native-oh-tpl/react-native-custom-keyboard/harmony/custom_keyboard.har" - } -``` - -+ V1.1.0 for RN0.77 ```json "dependencies": { "@rnoh/react-native-openharmony" : "file:../react_native_openharmony", @@ -230,7 +217,7 @@ ohpm install 如需使用直接链接源码，请参考[直接链接源码说明](/zh-cn/link-source-code.md) -### 3.配置 CMakeLists 和引入 rnoh_custom_keyboard_package +### 3.配置 CMakeLists 和引入 RNCustomKeyboardPackage 打开 `entry/src/main/cpp/CMakeLists.txt`，添加： @@ -254,7 +241,7 @@ add_subdirectory("${RNOH_CPP_DIR}" ./rn) add_subdirectory("../../../../sample_package/src/main/cpp" ./sample-package) # V1.0.3 for RN0.72 -+ add_subdirectory("${OH_MODULES}/@react-native-oh-tpl/react-native-custom-keyboard/src/main/cpp" ./custom-keyboard) ++ add_subdirectory("${OH_MODULES}/@react-native-ohos/react-native-custom-keyboard/src/main/cpp" ./custom-keyboard) # V1.1.0 for RN0.77 + add_subdirectory("${OH_MODULES}/@react-native-ohos/react-native-custom-keyboard/src/main/cpp" ./custom-keyboard) @@ -303,7 +290,7 @@ std::vector> PackageProvider::getPackages(Package::Cont ... import type {RNPackageContext, RNPackage} from '@rnoh/react-native-openharmony/ts'; // V1.0.3 for RN0.72 -+import {RNCustomKeyboardPackage} from '@react-native-oh-tpl/react-native-custom-keyboard/ts'; ++import {RNCustomKeyboardPackage} from '@react-native-ohos/react-native-custom-keyboard/ts'; // V1.1.0 for RN0.77 +import {RNCustomKeyboardPackage} from '@react-native-ohos/react-native-custom-keyboard/ts'; @@ -332,10 +319,14 @@ ohpm install ### 兼容性 -本文档内容基于以下版本验证通过： +要使用此库，需要使用正确的 React-Native 和 RNOH 版本。另外，还需要使用配套的 DevEco Studio 和 手机 ROM。 + +在以下版本验证通过： + +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.38; SDK: HarmonyOS-5.0.0(API12); IDE: DevEco Studio 5.1.1.830; ROM: 6.0.0.112 SP12; -2、RNOH: 0.77.18; SDK: HarmonyOS-5.1.1.208(API19); IDE: DevEco Studio 5.1.1.830; ROM: 6.0.0.112 SP12; ## 属性 -- Gitee From 8fc3afcdf538113ee754e06ccdca7988d7d961a4 Mon Sep 17 00:00:00 2001 From: yudaxia Date: Wed, 10 Dec 2025 17:08:29 +0800 Subject: [PATCH 2/6] =?UTF-8?q?fix:=20md=E4=B8=AD=E8=8B=B1=E6=96=87?= =?UTF-8?q?=E6=96=87=E6=A1=A3=E6=9B=B4=E6=96=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- en/react-native-amap3d.md | 12 +++++------- en/react-native-bars.md | 2 +- en/react-native-custom-keyboard.md | 7 ------- zh-cn/react-native-amap3d.md | 2 ++ zh-cn/react-native-custom-keyboard.md | 7 ------- 5 files changed, 8 insertions(+), 22 deletions(-) diff --git a/en/react-native-amap3d.md b/en/react-native-amap3d.md index 9d3ca48e3..53a5fbaf3 100644 --- a/en/react-native-amap3d.md +++ b/en/react-native-amap3d.md @@ -218,10 +218,11 @@ Method 2: Directly link to the source code. ### 3. Configuring CMakeLists and Introducing MapViewPackge +If you are using version <= 3.2.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) @@ -257,12 +258,12 @@ target_link_libraries(rnoh_app PUBLIC rnoh) target_link_libraries(rnoh_app PUBLIC rnoh_sample_package) + target_link_libraries(rnoh_app PUBLIC rnoh_amap3d) # 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" @@ -277,9 +278,8 @@ std::vector> PackageProvider::getPackages(Package::Cont + std::make_shared(ctx) }; } -``` - +``` ### 4. Introducing react-native-amap3d Component to ArkTS Find `function buildCustomRNComponent()`, which is usually located in `entry/src/main/ets/pages/index.ets` or `entry/src/main/ets/rn/LoadBundle.ets`, and add the following code: @@ -301,7 +301,7 @@ Find `function buildCustomRNComponent()`, which is usually located in `entry/src @Builder export function buildCustomRNComponent(ctx: ComponentBuilderContext) { -... + + if (ctx.componentName === GOADE_MAP_VIEW_TYPE) { + AMapView({ + ctx: ctx.rnComponentContext, @@ -332,9 +332,7 @@ export function buildCustomRNComponent(ctx: ComponentBuilderContext) { + tag: ctx.tag, + }) + } -... } -... ``` > [!TIP] If the repository uses a mixed solution, the component name needs to be added. diff --git a/en/react-native-bars.md b/en/react-native-bars.md index e5c7e99cd..d506ed789 100644 --- a/en/react-native-bars.md +++ b/en/react-native-bars.md @@ -130,7 +130,7 @@ Method 2: Directly link to the source code. > [!TIP] For details, see [Directly Linking Source Code](/en/link-source-code.md). -### 3.Configuring CMakeLists and Introducing RNDeviceInfoPackage +### 3.Configuring CMakeLists and Introducing RNBarsPackage > If you are using version <= 2.4.3-0.0.3, please skip this chapter. diff --git a/en/react-native-custom-keyboard.md b/en/react-native-custom-keyboard.md index 6c67dcaeb..4494bba45 100644 --- a/en/react-native-custom-keyboard.md +++ b/en/react-native-custom-keyboard.md @@ -238,10 +238,7 @@ add_subdirectory("${RNOH_CPP_DIR}" ./rn) # RNOH_BEGIN: manual_package_linking_1 add_subdirectory("../../../../sample_package/src/main/cpp" ./sample-package) -# V1.0.3 for RN0.72 -+ add_subdirectory("${OH_MODULES}/@react-native-ohos/react-native-custom-keyboard/src/main/cpp" ./custom-keyboard) -# V1.1.0 for RN0.77 + add_subdirectory("${OH_MODULES}/@react-native-ohos/react-native-custom-keyboard/src/main/cpp" ./custom-keyboard) # RNOH_END: manual_package_linking_1 @@ -286,13 +283,9 @@ Open `entry/src/main/ets/RNPackagesFactory.ts` and add the following code: ```diff ... import type {RNPackageContext, RNPackage} from '@rnoh/react-native-openharmony/ts'; -// V1.0.3 for RN0.72 -+import {RNCustomKeyboardPackage} from '@react-native-ohos/react-native-custom-keyboard/ts'; -// V1.1.0 for RN0.77 +import {RNCustomKeyboardPackage} from '@react-native-ohos/react-native-custom-keyboard/ts'; - export function createRNPackages(ctx: RNPackageContext): RNPackage[] { return [ + new RNCustomKeyboardPackage(ctx) diff --git a/zh-cn/react-native-amap3d.md b/zh-cn/react-native-amap3d.md index 405f79d97..5108bcf62 100644 --- a/zh-cn/react-native-amap3d.md +++ b/zh-cn/react-native-amap3d.md @@ -222,6 +222,8 @@ ohpm install ### 3.配置 CMakeLists 和引入 MapViewPackge +> 若使用的是 <= 3.2.6 版本，请跳过本章。 + 打开 `entry/src/main/cpp/CMakeLists.txt`，添加： ```diff diff --git a/zh-cn/react-native-custom-keyboard.md b/zh-cn/react-native-custom-keyboard.md index 82ec6efd4..f648972a9 100644 --- a/zh-cn/react-native-custom-keyboard.md +++ b/zh-cn/react-native-custom-keyboard.md @@ -240,10 +240,6 @@ add_subdirectory("${RNOH_CPP_DIR}" ./rn) # RNOH_BEGIN: manual_package_linking_1 add_subdirectory("../../../../sample_package/src/main/cpp" ./sample-package) -# V1.0.3 for RN0.72 -+ add_subdirectory("${OH_MODULES}/@react-native-ohos/react-native-custom-keyboard/src/main/cpp" ./custom-keyboard) - -# V1.1.0 for RN0.77 + add_subdirectory("${OH_MODULES}/@react-native-ohos/react-native-custom-keyboard/src/main/cpp" ./custom-keyboard) # RNOH_END: manual_package_linking_1 @@ -289,10 +285,7 @@ std::vector> PackageProvider::getPackages(Package::Cont ```diff ... import type {RNPackageContext, RNPackage} from '@rnoh/react-native-openharmony/ts'; -// V1.0.3 for RN0.72 -+import {RNCustomKeyboardPackage} from '@react-native-ohos/react-native-custom-keyboard/ts'; -// V1.1.0 for RN0.77 +import {RNCustomKeyboardPackage} from '@react-native-ohos/react-native-custom-keyboard/ts'; export function createRNPackages(ctx: RNPackageContext): RNPackage[] { -- Gitee From 0aa03033873a9dd4de340d37a8982fdde65e2fd3 Mon Sep 17 00:00:00 2001 From: yudaxia Date: Wed, 10 Dec 2025 17:33:23 +0800 Subject: [PATCH 3/6] =?UTF-8?q?fix:=20=E8=A1=A5=E9=BD=90=E7=BC=BA=E5=A4=B1?= =?UTF-8?q?=E7=89=88=E6=9C=AC=E5=8F=B7?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- en/react-native-custom-keyboard.md | 10 ++++++---- zh-cn/react-native-custom-keyboard.md | 12 +++++++----- 2 files changed, 13 insertions(+), 9 deletions(-) diff --git a/en/react-native-custom-keyboard.md b/en/react-native-custom-keyboard.md index 4494bba45..030f51b3c 100644 --- a/en/react-native-custom-keyboard.md +++ b/en/react-native-custom-keyboard.md @@ -18,10 +18,10 @@ The repository of this third-party library has been migrated to Gitcode and supports direct download from npm. The new package name is: @react-native-ohos/react-native-custom-keyboard. The specific version ownership relationship is as follows: | Third-party Library Version | Release Information | Supported RN Version | -|----------------------------| ------------------------------------------------------------ | ---------- | -| <= 1.0.3-0.0.2@deprecated | [@react-native-oh-tpl/react-native-custom-keyboard Releases(deprecated)](https://github.com/react-native-oh-library/react-native-custom-keyboard/releases) | 0.72 | -| 1.0.4 | [@react-native-ohos/react-native-custom-keyboard Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-custom-keyboard/releases) | 0.72 | -| 1.1.0 | [@react-native-ohos/react-native-custom-keyboard Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-custom-keyboard/releases) | 0.77 | +|---------------------------| ------------------------------------------------------------ | ---------- | +| <= 1.0.3-0.0.2@deprecated | [@react-native-oh-tpl/react-native-custom-keyboard Releases(deprecated)](https://github.com/react-native-oh-library/react-native-custom-keyboard/releases) | 0.72 | +| 1.0.4 | [@react-native-ohos/react-native-custom-keyboard Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-custom-keyboard/releases) | 0.72 | +| 1.1.0 | [@react-native-ohos/react-native-custom-keyboard Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-custom-keyboard/releases) | 0.77 | ## Installation and Usage @@ -218,6 +218,8 @@ For details, see [Directly Linking Source Code](/en/link-source-code.md). ### 3.Configuring CMakeLists and Introducing RNCustomKeyboardPackage Package +If you are using version <= 1.0.3-0.0.2, please skip this chapter. + Open `entry/src/main/cpp/CMakeLists.txt` and add the following code: ```diff diff --git a/zh-cn/react-native-custom-keyboard.md b/zh-cn/react-native-custom-keyboard.md index f648972a9..0089a3097 100644 --- a/zh-cn/react-native-custom-keyboard.md +++ b/zh-cn/react-native-custom-keyboard.md @@ -17,11 +17,11 @@ 请到三方库的 Releases 发布地址查看配套的版本信息： -| 三方库版本 | 发布信息 | 支持RN版本 | -|----------------------------| ------------------------------------------------------------ | ---------- | -| <= 1.0.3-0.0.2@deprecated | [@react-native-oh-tpl/react-native-custom-keyboard Releases(deprecated)](https://github.com/react-native-oh-library/react-native-custom-keyboard/releases) | 0.72 | -| 1.0.4 | [@react-native-ohos/react-native-custom-keyboard Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-custom-keyboard/releases) | 0.72 | -| 1.1.0 | [@react-native-ohos/react-native-custom-keyboard Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-custom-keyboard/releases) | 0.77 | +| 三方库版本 | 发布信息 | 支持RN版本 | +|---------------------------| ------------------------------------------------------------ | ---------- | +| <= 1.0.3-0.0.2@deprecated | [@react-native-oh-tpl/react-native-custom-keyboard Releases(deprecated)](https://github.com/react-native-oh-library/react-native-custom-keyboard/releases) | 0.72 | +| 1.0.4 | [@react-native-ohos/react-native-custom-keyboard Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-custom-keyboard/releases) | 0.72 | +| 1.1.0 | [@react-native-ohos/react-native-custom-keyboard Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-custom-keyboard/releases) | 0.77 | ## 安装与使用 @@ -219,6 +219,8 @@ ohpm install ### 3.配置 CMakeLists 和引入 RNCustomKeyboardPackage +若使用的是 <= 1.0.3-0.0.2 版本，请跳过本章。 + 打开 `entry/src/main/cpp/CMakeLists.txt`，添加： ```diff -- Gitee From a74ce6fe04fd26c79df7a5837cd3fe8ae227b9b1 Mon Sep 17 00:00:00 2001 From: yudaxia Date: Wed, 10 Dec 2025 17:42:37 +0800 Subject: [PATCH 4/6] =?UTF-8?q?fix:=20=E5=BA=93=E5=90=8D=E9=94=99=E8=AF=AF?= =?UTF-8?q?=E4=BF=AE=E6=94=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- en/react-native-amap3d.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/en/react-native-amap3d.md b/en/react-native-amap3d.md index 53a5fbaf3..270c0fdbb 100644 --- a/en/react-native-amap3d.md +++ b/en/react-native-amap3d.md @@ -21,9 +21,9 @@ Find the matching version information in the release address of a third-party li | Third-party Library Version | Release Information | Supported RN Version | |----------------------------| ----------------------------------------------------------- | ---------- | -| <= 3.2.5@deprecated | [@react-native-oh-tpl/react-native-custom-keyboard Releases(deprecated)](https://github.com/react-native-oh-library/react-native-amap3d/releases) | 0.72 | -| 3.2.6 | [@react-native-ohos/react-native-custom-keyboard Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-amap3d/releases) | 0.72 | -| 3.3.0 | [@react-native-ohos/react-native-custom-keyboard Releases](https://github.com/react-native-oh-library/react-native-amap3d/releases) | 0.77 | +| <= 3.2.5@deprecated | [@react-native-oh-tpl/react-native-amap3d Releases(deprecated)](https://github.com/react-native-oh-library/react-native-amap3d/releases) | 0.72 | +| 3.2.6 | [@react-native-ohos/react-native-amap3d Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-amap3d/releases) | 0.72 | +| 3.3.0 | [@react-native-ohos/react-native-amap3d Releases](https://github.com/react-native-oh-library/react-native-amap3d/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. -- Gitee From 74b29097c595e8b6a4969fad9f9dc0fdcfb6f9d8 Mon Sep 17 00:00:00 2001 From: yudaxia Date: Thu, 11 Dec 2025 09:41:16 +0800 Subject: [PATCH 5/6] =?UTF-8?q?fix:=20=E6=96=87=E6=A1=A3=E4=BC=98=E5=8C=96?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- en/react-native-amap3d.md | 3 +-- en/react-native-custom-keyboard.md | 6 +++--- zh-cn/react-native-amap3d.md | 5 ++--- zh-cn/react-native-bars.md | 3 +-- zh-cn/react-native-custom-keyboard.md | 6 +++--- 5 files changed, 10 insertions(+), 13 deletions(-) diff --git a/en/react-native-amap3d.md b/en/react-native-amap3d.md index 270c0fdbb..82f4506b4 100644 --- a/en/react-native-amap3d.md +++ b/en/react-native-amap3d.md @@ -13,7 +13,7 @@

-This project is based on [react-native-amap3d](https://github.com/qiuxiang/react-native-amap3d). +> [!TIP] [Github address](https://github.com/qiuxiang/react-native-amap3d) ## Installation and Usage @@ -29,7 +29,6 @@ For older versions that are not published to npm, please refer to the [installat Go to the project directory and execute the following instruction: - #### **npm** diff --git a/en/react-native-custom-keyboard.md b/en/react-native-custom-keyboard.md index 030f51b3c..f86855a6f 100644 --- a/en/react-native-custom-keyboard.md +++ b/en/react-native-custom-keyboard.md @@ -15,6 +15,8 @@ > [!TIP] [GitHub address](https://github.com/react-native-oh-library/react-native-custom-keyboard) +## Installation and Usage + The repository of this third-party library has been migrated to Gitcode and supports direct download from npm. The new package name is: @react-native-ohos/react-native-custom-keyboard. The specific version ownership relationship is as follows: | Third-party Library Version | Release Information | Supported RN Version | @@ -23,12 +25,10 @@ The repository of this third-party library has been migrated to Gitcode and supp | 1.0.4 | [@react-native-ohos/react-native-custom-keyboard Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-custom-keyboard/releases) | 0.72 | | 1.1.0 | [@react-native-ohos/react-native-custom-keyboard Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-custom-keyboard/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** ```bash diff --git a/zh-cn/react-native-amap3d.md b/zh-cn/react-native-amap3d.md index 5108bcf62..121bd4bba 100644 --- a/zh-cn/react-native-amap3d.md +++ b/zh-cn/react-native-amap3d.md @@ -14,7 +14,7 @@

-本项目基于 [react-native-amap3d](https://github.com/qiuxiang/react-native-amap3d) 开发。 +> [!TIP] [Github address](https://github.com/qiuxiang/react-native-amap3d) ## 安装与使用 @@ -27,7 +27,6 @@ | 3.3.0 | [@react-native-ohos/react-native-amap3d Releases](https://github.com/react-native-oh-library/react-native-amap3d/releases) | 0.77 | 对于未发布到npm的旧版本，请参考[安装指南](/zh-cn/tgz-usage.md)安装tgz包。 -进入到工程目录并输入以下命令： 进入到工程目录并输入以下命令： @@ -222,7 +221,7 @@ ohpm install ### 3.配置 CMakeLists 和引入 MapViewPackge -> 若使用的是 <= 3.2.6 版本，请跳过本章。 +> 若使用的是 <= 3.2.5 版本，请跳过本章。 打开 `entry/src/main/cpp/CMakeLists.txt`，添加： diff --git a/zh-cn/react-native-bars.md b/zh-cn/react-native-bars.md index 882cd0c45..ebec566a5 100644 --- a/zh-cn/react-native-bars.md +++ b/zh-cn/react-native-bars.md @@ -16,10 +16,8 @@ > [!TIP] [Github 地址](https://github.com/react-native-oh-library/react-native-bars) - ## 安装与使用 - 请到三方库的 Releases 发布地址查看配套的版本信息： | 三方库版本 | 发布信息 | 支持RN版本 | @@ -29,6 +27,7 @@ | 2.5.0 | [@react-native-ohos/react-native-bars Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-bars/releases) | 0.77 | 对于未发布到npm的旧版本，请参考[安装指南](/zh-cn/tgz-usage.md)安装tgz包。 + 进入到工程目录并输入以下命令： diff --git a/zh-cn/react-native-custom-keyboard.md b/zh-cn/react-native-custom-keyboard.md index 0089a3097..3d40b4e80 100644 --- a/zh-cn/react-native-custom-keyboard.md +++ b/zh-cn/react-native-custom-keyboard.md @@ -15,6 +15,8 @@ > [!TIP] [Github 地址](https://github.com/react-native-oh-library/react-native-custom-keyboard) +## 安装与使用 + 请到三方库的 Releases 发布地址查看配套的版本信息： | 三方库版本 | 发布信息 | 支持RN版本 | @@ -23,9 +25,7 @@ | 1.0.4 | [@react-native-ohos/react-native-custom-keyboard Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-custom-keyboard/releases) | 0.72 | | 1.1.0 | [@react-native-ohos/react-native-custom-keyboard Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-custom-keyboard/releases) | 0.77 | - -## 安装与使用 - +对于未发布到npm的旧版本，请参考[安装指南](/zh-cn/tgz-usage.md)安装tgz包。 进入到工程目录并输入以下命令： -- Gitee From 971f2d083e787391ac89d9332d1ebf9188c8d3df Mon Sep 17 00:00:00 2001 From: yudaxia Date: Thu, 11 Dec 2025 16:24:25 +0800 Subject: [PATCH 6/6] =?UTF-8?q?fix:=20=E6=96=87=E6=A1=A3=E4=BC=98=E5=8C=96?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- en/react-native-amap3d.md | 2 +- en/react-native-custom-keyboard.md | 2 +- zh-cn/react-native-custom-keyboard.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/en/react-native-amap3d.md b/en/react-native-amap3d.md index 82f4506b4..7aff09160 100644 --- a/en/react-native-amap3d.md +++ b/en/react-native-amap3d.md @@ -217,7 +217,7 @@ Method 2: Directly link to the source code. ### 3. Configuring CMakeLists and Introducing MapViewPackge -If you are using version <= 3.2.5, please skip this chapter. +> If you are using version <= 3.2.5, please skip this chapter. Open `entry/src/main/cpp/CMakeLists.txt` and add the following code: diff --git a/en/react-native-custom-keyboard.md b/en/react-native-custom-keyboard.md index f86855a6f..d62528cd0 100644 --- a/en/react-native-custom-keyboard.md +++ b/en/react-native-custom-keyboard.md @@ -218,7 +218,7 @@ For details, see [Directly Linking Source Code](/en/link-source-code.md). ### 3.Configuring CMakeLists and Introducing RNCustomKeyboardPackage Package -If you are using version <= 1.0.3-0.0.2, please skip this chapter. +> If you are using version <= 1.0.3-0.0.2, please skip this chapter. Open `entry/src/main/cpp/CMakeLists.txt` and add the following code: diff --git a/zh-cn/react-native-custom-keyboard.md b/zh-cn/react-native-custom-keyboard.md index 3d40b4e80..56f878f10 100644 --- a/zh-cn/react-native-custom-keyboard.md +++ b/zh-cn/react-native-custom-keyboard.md @@ -219,7 +219,7 @@ ohpm install ### 3.配置 CMakeLists 和引入 RNCustomKeyboardPackage -若使用的是 <= 1.0.3-0.0.2 版本，请跳过本章。 +> 若使用的是 <= 1.0.3-0.0.2 版本，请跳过本章。 打开 `entry/src/main/cpp/CMakeLists.txt`，添加： -- Gitee