From a623acb4696da0c7f479b2375755c5b61c38e55b Mon Sep 17 00:00:00 2001 From: sunyong Date: Fri, 12 Dec 2025 18:24:20 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20[Issues:=20#IDCPFT]=20=E4=B8=89?= =?UTF-8?q?=E6=96=B9=E5=BA=93=E9=80=82=E9=85=8Dcli=E5=B7=A5=E5=85=B7?= =?UTF-8?q?=E9=9C=80=E6=B1=82=E6=96=87=E6=A1=A3=E6=95=B4=E6=94=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: sunyong --- en/react-native-MJRefresh.md | 16 +- en/react-native-incall-manager.md | 18 +- en/react-native-keep-awake.md | 24 ++- en/react-native-keys.md | 25 ++- en/react-native-localization-settings.md | 22 +- en/react-native-localization.md | 22 +- en/react-native-mail.md | 23 ++- en/react-native-maps.md | 18 +- en/react-native-masked-view-masked-view.md | 20 +- en/react-native-mlkit-ocr.md | 25 ++- en/react-native-mmkv-storage.md | 18 +- en/react-native-network-info.md | 22 +- en/react-native-nfc-manager.md | 195 +++++++++--------- ...eact-native-oh-tpl-react-native-screens.md | 22 +- en/react-native-ohos-community-auto-fill.md | 24 ++- en/react-native-orientation.md | 22 +- en/react-native-pager-view.md | 18 +- zh-cn/react-native-MJRefresh.md | 18 +- zh-cn/react-native-incall-manager.md | 19 +- zh-cn/react-native-keep-awake.md | 20 +- zh-cn/react-native-keys.md | 23 ++- zh-cn/react-native-localization-settings.md | 20 +- zh-cn/react-native-localization.md | 23 ++- zh-cn/react-native-mail.md | 21 +- zh-cn/react-native-maps.md | 18 +- zh-cn/react-native-masked-view-masked-view.md | 18 +- zh-cn/react-native-mlkit-ocr.md | 26 ++- zh-cn/react-native-mmkv-storage.md | 18 +- zh-cn/react-native-network-info.md | 20 +- zh-cn/react-native-nfc-manager.md | 195 +++++++++--------- ...eact-native-oh-tpl-react-native-screens.md | 22 +- .../react-native-ohos-community-auto-fill.md | 23 ++- zh-cn/react-native-orientation.md | 20 +- zh-cn/react-native-pager-view.md | 19 +- 34 files changed, 672 insertions(+), 385 deletions(-) diff --git a/en/react-native-MJRefresh.md b/en/react-native-MJRefresh.md index 10ccab2b..3b58d813 100644 --- a/en/react-native-MJRefresh.md +++ b/en/react-native-MJRefresh.md @@ -130,11 +130,18 @@ export default class MjRefreshDemo extends Component<{}, State> { ## Link -Version >= @react-native-ohos/react-native-mjrefresh@0.7.1 now supports Autolink without requiring manual configuration, currently only supports 72 frameworks. Autolink Framework Guide Documentation: https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md +| | Is supported autolink | Supported RN Ve +|--------------------------------------|------------------|------------| +| ~0.7.1 | Yes | 0.72 | +| <= 0.7.0-0.2.2@deprecated | No | 0.72 | -This step provides guidance for manually configuring native dependencies. +Using AutoLink need to be configured according to this document, Autolink Framework Guide Documentation: https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md -Open the `harmony` directory of the HarmonyOS project in DevEco Studio. +If the version you use supports Autolink and the project has been connected to Autolink, skip the ManualLink configuration. +
+ ManualLink: this step is a guide to manually configure native dependencies. + +First, use DevEco Studio to open the HarmonyOS project `harmony` in the project directory. ### 1. Adding the overrides Field to oh-package.json5 File in the Root Directory of the Project @@ -237,8 +244,9 @@ std::vector> PackageProvider::getPackages(Package::Cont }; } ``` +
-### 4. Running +## Running Click the `sync` button in the upper right corner. diff --git a/en/react-native-incall-manager.md b/en/react-native-incall-manager.md index a75e4153..b37fc9e5 100644 --- a/en/react-native-incall-manager.md +++ b/en/react-native-incall-manager.md @@ -497,12 +497,19 @@ export default function InCallManagerExample() { ## Link -Version >= @react-native-ohos/react-native-incall-manager@4.2.1 now supports Autolink without requiring manual configuration, currently only supports 72 frameworks. -Autolink Framework Guide Documentation: https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md +| | Is supported autolink | Supported RN Ve +|--------------------------------------|------------------|------------| +| ~4.3.0 | No | 0.77 | +| ~4.2.1 | Yes | 0.72 | +| <= 4.2.0-0.0.4@deprecated | No | 0.72 | -This step provides guidance for manually configuring native dependencies. +Using AutoLink need to be configured according to this document, Autolink Framework Guide Documentation: https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md -Open the `harmony` directory of the HarmonyOS project in DevEco Studio. +If the version you use supports Autolink and the project has been connected to Autolink, skip the ManualLink configuration. +
+ ManualLink: this step is a guide to manually configure native dependencies. + +First, use DevEco Studio to open the HarmonyOS project `harmony` in the project directory. ### 1. Adding the overrides Field to oh-package.json5 File in the Root Directory of the Project @@ -619,8 +626,9 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { ]; } ``` +
-### 5. Running +## Running Click the `sync` button in the upper right corner. diff --git a/en/react-native-keep-awake.md b/en/react-native-keep-awake.md index 1ba12dd1..86b88d1b 100644 --- a/en/react-native-keep-awake.md +++ b/en/react-native-keep-awake.md @@ -19,6 +19,7 @@ Find the matching version information in the release address of a third-party library: +| Third-party Library Version | Release Information | Supported RN Version | | ---------- | ------------------------------------------------------------ | ---------- | | <= 4.0.0-0.0.1@deprecated | [@react-native-oh-tpl/react-native-keep-awake Releases(deprecated)](https://github.com/react-native-oh-library/react-native-keep-awake/releases) | 0.72 | | 4.0.1 | [@react-native-ohos/react-native-keep-awake Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-keep-awake/releases) | 0.72 | @@ -115,20 +116,26 @@ export function KeepAwakeExample() { } ``` -## 使用 Codegen +## Use Codegen -Version >= @react-native-ohos/react-native-keep-awake@4.0.1, now supports Codegen to generate bridging code. +This library has been adapted for `Codegen`. Before using it, you need to proactively generate the bridge code for the third-party library. For details, please refer to the [Codegen Usage Documentation](/en/codegen.md). -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 -Version >= @react-native-ohos/react-native-keep-awake@4.0.1, now supports Autolink without requiring manual configuration, currently only supports 72 frameworks. -Autolink Framework Guide Documentation: https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md +| | Is supported autolink | Supported RN Ve +|--------------------------------------|------------------|------------| +| ~4.1.0 | No | 0.77 | +| ~4.0.1 | Yes | 0.72 | +| <= 4.0.0-0.0.1@deprecated | No | 0.72 | -This step provides guidance for manually configuring native dependencies. +Using AutoLink need to be configured according to this document, Autolink Framework Guide Documentation: https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md -Open the `harmony` directory of the HarmonyOS project in DevEco Studio. +If the version you use supports Autolink and the project has been connected to Autolink, skip the ManualLink configuration. +
+ ManualLink: this step is a guide to manually configure native dependencies. + +First, use DevEco Studio to open the HarmonyOS project `harmony` in the project directory. ### Adding the overrides Field to oh-package.json5 File in the Root Directory of the Project @@ -263,8 +270,9 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { ]; } ``` +
-### 5. Running +## Running Click the `sync` button in the upper right corner. diff --git a/en/react-native-keys.md b/en/react-native-keys.md index 27512220..76ecf8df 100644 --- a/en/react-native-keys.md +++ b/en/react-native-keys.md @@ -16,7 +16,7 @@ ## Installation and Usage -Please refer to the Releases page of the third-party library for the corresponding version information +Please refer to the Releases page of the third-party library for the corresponding version | Third-party Library Version | Release Information | Supported RN Version | | ---------- | ------------------------------------------------------------ | ---------- | @@ -82,12 +82,19 @@ Keys.secureFor("SECRET_KEY"); ## Link -Version >= @react-native-ohos/react-native-keys@0.7.12 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 +| | Is supported autolink | Supported RN Ve +|--------------------------------------|------------------|------------| +| ~0.8.0 | No | 0.77 | +| ~0.7.12 | Yes | 0.72 | +| <= 0.7.11@deprecated | No | 0.72 | -This step provides guidance for manually configuring native dependencies. +Using AutoLink need to be configured according to this document, Autolink Framework Guide Documentation: https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md -Open the `harmony` directory of the HarmonyOS project in DevEco Studio. +If the version you use supports Autolink and the project has been connected to Autolink, skip the ManualLink configuration. +
+ ManualLink: this step is a guide to manually configure native dependencies. + +First, use DevEco Studio to open the HarmonyOS project `harmony` in the project directory. ### 1. Adding the overrides Field to oh-package.json5 File in the Root Directory of the Project @@ -206,8 +213,12 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { ]; } ``` +
+ +## Necessary configuration items -### 5. Creating a Pre-running Script in DevEco (Generating the Encryption/Decryption Code and Compiling Configuration Files) +> [!TIP] The content of this module cannot be automatically generated by autolink and must always be manually configured. +### Creating a Pre-running Script in DevEco (Generating the Encryption/Decryption Code and Compiling Configuration Files) > [!TIP] After the configuration is complete, click **Apply** for the configuration to take effect. @@ -217,7 +228,7 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { 3. Choose **Entry** > **Before Lunch**, click **+**, select **Run Another Configuration**, select the **Shell Script** configured in the previous step, and drag the configuration to the upper part of **Hvigor-Build Make**. ![entry config](../img/rnkeys/entry_config.PNG) -### 6. Running +## Running Click the `sync` button in the upper right corner. diff --git a/en/react-native-localization-settings.md b/en/react-native-localization-settings.md index f4bffc14..75721938 100644 --- a/en/react-native-localization-settings.md +++ b/en/react-native-localization-settings.md @@ -124,18 +124,23 @@ const styles = StyleSheet.create({ ## Use Codegen -Version >= @react-native-ohos/react-native-localization-settings@1.0.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](/en/codegen.md). +This library has been adapted for `Codegen`. Before using it, you need to proactively generate the bridge code for the third-party library. For details, please refer to the [Codegen Usage Documentation](/en/codegen.md). ## Link -Version >= @react-native-ohos/react-native-localization-settings@1.0.3 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 +| | Is supported autolink | Supported RN Ve +|--------------------------------------|------------------|------------| +| ~1.2.1 | No | 0.77 | +| ~1.0.3 | Yes | 0.72 | +| <= 1.0.2-0.0.1@deprecated | No | 0.72 | + +Using AutoLink need to be configured according to this document, 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. +If the version you use supports Autolink and the project has been connected to Autolink, skip the ManualLink configuration. +
+ ManualLink: this step is a guide to manually configure native dependencies. -Open the `harmony` directory of the HarmonyOS project in DevEco Studio. +First, use DevEco Studio to open the HarmonyOS project `harmony` in the project directory. ### 1. Adding the overrides Field to oh-package.json5 File in the Root Directory of the Project @@ -255,8 +260,9 @@ std::vector> PackageProvider::getPackages(Package::Cont }; } ``` +
-### 5. Running +## Running Click the `sync` button in the upper right corner. diff --git a/en/react-native-localization.md b/en/react-native-localization.md index 90fd9bef..7a73488d 100644 --- a/en/react-native-localization.md +++ b/en/react-native-localization.md @@ -174,18 +174,23 @@ const styles = StyleSheet.create({ ``` ## Use Codegen -Version >= @react-native-ohos/react-native-localization@2.3.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](/en/codegen.md). +This library has been adapted for `Codegen`. Before using it, you need to proactively generate the bridge code for the third-party library. For details, please refer to the [Codegen Usage Documentation](/en/codegen.md). ## Link -Version >= @react-native-ohos/react-native-localization@2.3.3 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 +| | Is supported autolink | Supported RN Ve +|--------------------------------------|------------------|------------| +| ~2.4.0 | No | 0.77 | +| ~2.3.3 | Yes | 0.72 | +| <=2.3.2-0.0.1@deprecated | No | 0.72 | + +Using AutoLink need to be configured according to this document, 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. +If the version you use supports Autolink and the project has been connected to Autolink, skip the ManualLink configuration. +
+ ManualLink: this step is a guide to manually configure native dependencies. -Open the `harmony` directory of the HarmonyOS project in DevEco Studio. +First, use DevEco Studio to open the HarmonyOS project `harmony` in the project directory. ### 1. Adding the overrides Field to oh-package.json5 File in the Root Directory of the Project @@ -304,8 +309,9 @@ std::vector> PackageProvider::getPackages(Package::Cont }; } ``` +
-### 5.Running +## Running Click the `sync` button in the upper right corner. diff --git a/en/react-native-mail.md b/en/react-native-mail.md index fccf897e..b530cbc7 100644 --- a/en/react-native-mail.md +++ b/en/react-native-mail.md @@ -116,18 +116,23 @@ export default class App extends Component { ## Use Codegen -Version >= @react-native-ohos/react-native-mail@6.1.2 now supports Autolink without requiring manual configuration, currently only supports 72 frameworks. - -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). +This library has been adapted for `Codegen`. Before using it, you need to proactively generate the bridge code for the third-party library. For details, please refer to the [Codegen Usage Documentation](/en/codegen.md). ## Link -Version >= @react-native-ohos/react-native-mail@6.1.2 now supports Autolink without requiring manual configuration, currently only supports 72 frameworks. -Autolink Framework Guide Documentation: https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md +| | Is supported autolink | Supported RN Ve +|--------------------------------------|------------------|------------| +| ~6.2.0 | No | 0.77 | +| ~6.1.2 | Yes | 0.72 | +| <= 6.1.1-0.0.1@deprecated | No | 0.72 | + +Using AutoLink need to be configured according to this document, 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. +If the version you use supports Autolink and the project has been connected to Autolink, skip the ManualLink configuration. +
+ ManualLink: this step is a guide to manually configure native dependencies. -Open the `harmony` directory of the HarmonyOS project in DevEco Studio. +First, use DevEco Studio to open the HarmonyOS project `harmony` in the project directory. ### 1. Adding the overrides Field to oh-package.json5 File in the Root Directory of the Project @@ -234,9 +239,9 @@ std::vector> PackageProvider::getPackages(Package::Cont + std::make_shared(ctx) } ``` +
- -### 5. Running +## Running Click the `sync` button in the upper right corner. diff --git a/en/react-native-maps.md b/en/react-native-maps.md index b852b956..1b41b536 100644 --- a/en/react-native-maps.md +++ b/en/react-native-maps.md @@ -204,12 +204,19 @@ const styles = StyleSheet.create({ ## Link -Version >= @react-native-ohos/react-native-maps@1.10.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 +| | Is supported autolink | Supported RN Ve +|--------------------------------------|------------------|------------| +| ~1.24.4 | No | 0.77 | +| ~1.10.4 | Yes | 0.72 | +| <= 1.10.3-0.1.4@deprecated | No | 0.72 | -This step provides guidance for manually configuring native dependencies. +Using AutoLink need to be configured according to this document, Autolink Framework Guide Documentation: https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md -Open the `harmony` directory of the HarmonyOS project in DevEco Studio. +If the version you use supports Autolink and the project has been connected to Autolink, skip the ManualLink configuration. +
+ ManualLink: this step is a guide to manually configure native dependencies. + +First, use DevEco Studio to open the HarmonyOS project `harmony` in the project directory. ### 1. Adding the overrides Field to oh-package.json5 File in the Root Directory of the Project @@ -447,8 +454,9 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { ]; } ``` +
-### 6.Running +## Running Click the `sync` button in the upper right corner. diff --git a/en/react-native-masked-view-masked-view.md b/en/react-native-masked-view-masked-view.md index ee688142..d220ffbf 100644 --- a/en/react-native-masked-view-masked-view.md +++ b/en/react-native-masked-view-masked-view.md @@ -112,12 +112,19 @@ export default MaskedDemo ## Link -Version >= @react-native-ohos/masked-view@0.2.11 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 +| | Is supported autolink | Supported RN Ve +|--------------------------------------|------------------|------------| +| ~0.3.3 | No | 0.77 | +| ~0.2.11 | Yes | 0.72 | +| <= 0.2.9-0.2.2@deprecated | No | 0.72 | -This step provides guidance for manually configuring native dependencies. +Using AutoLink need to be configured according to this document, Autolink Framework Guide Documentation: https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md -Open the `harmony` directory of the HarmonyOS project in DevEco Studio. +If the version you use supports Autolink and the project has been connected to Autolink, skip the ManualLink configuration. +
+ ManualLink: this step is a guide to manually configure native dependencies. + +First, use DevEco Studio to open the HarmonyOS project `harmony` in the project directory. ### 1. Adding the overrides Field to oh-package.json5 File in the Root Directory of the Project @@ -137,7 +144,7 @@ Currently, two methods are available: Method 1 (recommended): Use the HAR file. -> [!TIP] har 包位于三方库安装路径的 `harmony` 文件夹下。 +> [!TIP] The HAR file is stored in the `harmony` directory in the installation path of the third-party library. Open `entry/oh-package.json5` file and add the following dependencies: @@ -237,8 +244,9 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { ]; } ``` +
-### 5. Running +## Running Click the `sync` button in the upper right corner. diff --git a/en/react-native-mlkit-ocr.md b/en/react-native-mlkit-ocr.md index 4c928970..6118adb4 100644 --- a/en/react-native-mlkit-ocr.md +++ b/en/react-native-mlkit-ocr.md @@ -148,12 +148,19 @@ export const OcrTest = () => { ## Link -Version >= @react-native-ohos/react-native-mlkit-ocr@0.3.1 now supports Autolink without requiring manual configuration, currently only supports 72 frameworks. -Autolink Framework Guide Documentation: https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md +| | Is supported autolink | Supported RN Ve +|--------------------------------------|------------------|------------| +| ~0.4.0 | No | 0.77 | +| ~0.3.1 | Yes | 0.72 | +| <= 0.3.0-0.0.1@deprecated | No | 0.72 | -This step provides guidance for manually configuring native dependencies. +Using AutoLink need to be configured according to this document, Autolink Framework Guide Documentation: https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md -Open the `harmony` directory of the HarmonyOS project in DevEco Studio. +If the version you use supports Autolink and the project has been connected to Autolink, skip the ManualLink configuration. +
+ ManualLink: this step is a guide to manually configure native dependencies. + +First, use DevEco Studio to open the HarmonyOS project `harmony` in the project directory. ### 1. Adding the overrides Field to oh-package.json5 File in the Root Directory of the Project @@ -271,7 +278,12 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { } ``` -### 5. Permission Requirements +
+ +## Necessary configuration items + +> [!TIP] The content of this module cannot be automatically generated by autolink and must always be manually configured. +### Permission Requirements(Generating the Encryption/Decryption Code and Compiling Configuration Files) > [!TIP] The permission level of **ohos.permission.INTERNET** is **normal**, and the authorization mode is **system_grant**. For details, see [Requesting ACL Permissions](https://developer.huawei.com/consumer/en/doc/harmonyos-guides-V2/signing-0000001587684945-V2#section157591551175916). @@ -294,7 +306,7 @@ Add configuration to `YourProject/entry/src/main/module.json5` } ``` -### 6. Running +## Running Click the `sync` button in the upper right corner. @@ -319,7 +331,6 @@ Verified in the following versions. 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 > [!TIP] The **Platform** column indicates the platform where the properties are supported in the original third-party library. diff --git a/en/react-native-mmkv-storage.md b/en/react-native-mmkv-storage.md index ef5b2a86..632f8b73 100644 --- a/en/react-native-mmkv-storage.md +++ b/en/react-native-mmkv-storage.md @@ -203,12 +203,19 @@ const styles = StyleSheet.create({ ## Link -Version >= @react-native-ohos/react-native-mmkv-storage@0.10.5 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/en/Autolinking.md +| | Is supported autolink | Supported RN Ve +|--------------------------------------|------------------|------------| +| ~0.11.3 | No | 0.77 | +| ~0.10.5 | Yes | 0.72 | +| <= 0.10.4@deprecated | No | 0.72 | -This step provides guidance for manually configuring native dependencies. +Using AutoLink need to be configured according to this document, Autolink Framework Guide Documentation: https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md -Open the `harmony` directory of the HarmonyOS project in DevEco Studio. +If the version you use supports Autolink and the project has been connected to Autolink, skip the ManualLink configuration. +
+ ManualLink: this step is a guide to manually configure native dependencies. + +First, use DevEco Studio to open the HarmonyOS project `harmony` in the project directory. ### 1.Adding the overrides Field to oh-package.json5 File in the Root Directory of the Project @@ -332,8 +339,9 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { } ``` +
-### 5. Running +## Running Click the `sync` button in the upper right corner. diff --git a/en/react-native-network-info.md b/en/react-native-network-info.md index b894ee0c..2eead438 100644 --- a/en/react-native-network-info.md +++ b/en/react-native-network-info.md @@ -162,18 +162,23 @@ const styles = StyleSheet.create({ ## Use Codegen -Version >= @react-native-ohos/react-native-network-info@5.2.2, compatible with codegen-lib for generating bridge code. - -If this repository has been adapted to `Codegen`, generate the bridge code of the third-party library by using the `Codegen`. For details, see [Codegen Usage Guide](/en/codegen.md). +This library has been adapted for `Codegen`. Before using it, you need to proactively generate the bridge code for the third-party library. For details, please refer to the [Codegen Usage Documentation](/en/codegen.md). ## Link -Version >= @react-native-ohos/react-native-network-info@5.2.2 now supports Autolink without requiring manual configuration, currently only supports 72 frameworks. -Autolink Framework Guide Documentation: https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md +| | Is supported autolink | Supported RN Ve +|--------------------------------------|------------------|------------| +| ~5.3.0 | No | 0.77 | +| ~5.2.2 | Yes | 0.72 | +| <= 5.2.1-0.0.1@deprecated | No | 0.72 | + +Using AutoLink need to be configured according to this document, 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. +If the version you use supports Autolink and the project has been connected to Autolink, skip the ManualLink configuration. +
+ ManualLink: this step is a guide to manually configure native dependencies. -Open the `harmony` directory of the HarmonyOS project in DevEco Studio. +First, use DevEco Studio to open the HarmonyOS project `harmony` in the project directory. ### 1. Adding the overrides Field to oh-package.json5 File in the Root Directory of the Project @@ -281,8 +286,9 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { ]; } ``` +
-### 5. Running +## Running Click the `sync` button in the upper right corner. diff --git a/en/react-native-nfc-manager.md b/en/react-native-nfc-manager.md index 0443cc2a..dfe2fb14 100644 --- a/en/react-native-nfc-manager.md +++ b/en/react-native-nfc-manager.md @@ -92,18 +92,23 @@ export default App; ## Use Codegen -Version >= @react-native-ohos/react-native-nfc-manager@3.15.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). +This library has been adapted for `Codegen`. Before using it, you need to proactively generate the bridge code for the third-party library. For details, please refer to the [Codegen Usage Documentation](/en/codegen.md). ## Link -Version >= @react-native-ohos/react-native-nfc-manager@3.15.1 now supports Autolink without requiring manual configuration(The content that still needs to be manually configured has been marked in the corresponding title), currently only supports 72 frameworks. -Autolink Framework Guide Documentation: https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md +| | Is supported autolink | Supported RN Ve +|--------------------------------------|------------------|------------| +| ~3.16.2 | No | 0.77 | +| ~3.15.1 | Yes | 0.72 | +| <= 3.15.0-0.0.4@deprecated | No | 0.72 | + +Using AutoLink need to be configured according to this document, 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. +If the version you use supports Autolink and the project has been connected to Autolink, skip the ManualLink configuration. +
+ ManualLink: this step is a guide to manually configure native dependencies. -Open the `harmony` directory of the HarmonyOS project in DevEco Studio. +First, use DevEco Studio to open the HarmonyOS project `harmony` in the project directory. ``` Adding the overrides Field to oh-package.json5 File in the Root Directory of the Project @@ -115,91 +120,6 @@ Adding the overrides Field to oh-package.json5 File in the Root Directory of the } ``` -## Configuring an Entry(This module always requires manual configuration) - -The **tag** module provides APIs for operating and managing NFC tags. The following tag read modes are available:
Background mode: The device reads the tag by using NFC without starting any application, and then searches for applications based on the tag type. If only one application is matched, the card reading page of that application will be started. If multiple applications are matched, an application selector will be started, asking the user to select an application.
Foreground mode: A foreground application has priority to read the NFC tag discovered. - -### Declaring the NFC Tag Background Mode - -*1. To enable NFC tags to be read without starting an application, declare NFC-related attributes in the **entry/src/main/module.json5** file: * - -``` -{ - "module": { - // other declared attributes. - - "abilities": [ - { - "skills": [ - { - "actions": [ - // other declared actions, - - // add the nfc tag action - "ohos.nfc.tag.action.TAG_FOUND" - ], - "uris": [ - { - "type":"tag-tech/NfcA" - }, - { - "type":"tag-tech/IsoDep" - } - // Add other technology if neccessary, - // such as: NfcB/NfcF/NfcV/Ndef/MifareClassic/MifareUL/NdefFormatable - ] - } - ] - } - ], - "requestPermissions": [ - { - "name": "ohos.permission.NFC_TAG", - "reason": "$string:app_name", - } - ] - } -} -``` - -2. Before a card with tags is read or written, **TagInfo** must be obtained to determine the tag technologies supported by the card. You can add the following content to **EntryAbility**: - -```tsx -import { RNAbility } from "rnoh"; -import Want from "@ohos.app.ability.Want"; -import { RNNfcManagerModule } from "@react-native-ohos/react-native-nfc-manager"; -import AbilityConstant from "@ohos.app.ability.AbilityConstant"; - -export default class EntryAbility extends RNAbility { - onCreate(want: Want): void { - super.onCreate(want); - RNNfcManagerModule.registerAbilityEvents(this.context, "onCreate", want); - } - - onForeground(): void { - super.onForeground(); - } - - onBackground(): void { - super.onBackground(); - } - - onNewWant(want: Want, launchParam: AbilityConstant.LaunchParam): void { - super.onNewWant(want, launchParam); - RNNfcManagerModule.registerAbilityEvents(this.context, "onNewWant", want); - } - - getPagePath() { - return "pages/Index"; - } - - onDestroy(): void { - super.onDestroy(); - RNNfcManagerModule.unRegisterAbilityEvents(this.context); - } -} -``` - ### 2. Introducing Native Code Currently, two methods are available: @@ -305,8 +225,97 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { ]; } ``` +
+ +## Necessary configuration items + +> [!TIP] The content of this module cannot be automatically generated by autolink and must always be manually configured. +## Configuring an Entry(This module always requires manual configuration) + +The **tag** module provides APIs for operating and managing NFC tags. The following tag read modes are available:
Background mode: The device reads the tag by using NFC without starting any application, and then searches for applications based on the tag type. If only one application is matched, the card reading page of that application will be started. If multiple applications are matched, an application selector will be started, asking the user to select an application.
Foreground mode: A foreground application has priority to read the NFC tag discovered. + +### Declaring the NFC Tag Background Mode + +*1. To enable NFC tags to be read without starting an application, declare NFC-related attributes in the **entry/src/main/module.json5** file: * + +``` +{ + "module": { + // other declared attributes. + + "abilities": [ + { + "skills": [ + { + "actions": [ + // other declared actions, + + // add the nfc tag action + "ohos.nfc.tag.action.TAG_FOUND" + ], + "uris": [ + { + "type":"tag-tech/NfcA" + }, + { + "type":"tag-tech/IsoDep" + } + // Add other technology if neccessary, + // such as: NfcB/NfcF/NfcV/Ndef/MifareClassic/MifareUL/NdefFormatable + ] + } + ] + } + ], + "requestPermissions": [ + { + "name": "ohos.permission.NFC_TAG", + "reason": "$string:app_name", + } + ] + } +} +``` + +2. Before a card with tags is read or written, **TagInfo** must be obtained to determine the tag technologies supported by the card. You can add the following content to **EntryAbility**: + +```tsx +import { RNAbility } from "rnoh"; +import Want from "@ohos.app.ability.Want"; +import { RNNfcManagerModule } from "@react-native-ohos/react-native-nfc-manager"; +import AbilityConstant from "@ohos.app.ability.AbilityConstant"; + +export default class EntryAbility extends RNAbility { + onCreate(want: Want): void { + super.onCreate(want); + RNNfcManagerModule.registerAbilityEvents(this.context, "onCreate", want); + } + + onForeground(): void { + super.onForeground(); + } + + onBackground(): void { + super.onBackground(); + } + + onNewWant(want: Want, launchParam: AbilityConstant.LaunchParam): void { + super.onNewWant(want, launchParam); + RNNfcManagerModule.registerAbilityEvents(this.context, "onNewWant", want); + } + + getPagePath() { + return "pages/Index"; + } + + onDestroy(): void { + super.onDestroy(); + RNNfcManagerModule.unRegisterAbilityEvents(this.context); + } +} +``` -### 5. Running +## Running Click the `sync` button in the upper right corner. diff --git a/en/react-native-oh-tpl-react-native-screens.md b/en/react-native-oh-tpl-react-native-screens.md index 48711c7f..eb5b7bb8 100644 --- a/en/react-native-oh-tpl-react-native-screens.md +++ b/en/react-native-oh-tpl-react-native-screens.md @@ -153,18 +153,23 @@ export default function App() { ## Use Codegen -Version >= @react-native-ohos/react-native-screens@3.34.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](https://gitee.com/react-native-oh-library/usage-docs/blob/master/en/codegen.md). +This library has been adapted for `Codegen`. Before using it, you need to proactively generate the bridge code for the third-party library. For details, please refer to the [Codegen Usage Documentation](/en/codegen.md). ## Link -Version >= @react-native-ohos/react-native-screens@3.34.1 now supports Autolink without requiring manual configuration, currently only supports 72 frameworks. -Autolink Framework Guide Documentation: https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md +| | Is supported autolink | Supported RN Ve +|--------------------------------------|------------------|------------| +| ~4.8.1 | No | 0.77 | +| ~3.34.1 | Yes | 0.72 | +| <= 3.34.0-0.0.2@deprecated | No | 0.72 | + +Using AutoLink need to be configured according to this document, 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. +If the version you use supports Autolink and the project has been connected to Autolink, skip the ManualLink configuration. +
+ ManualLink: this step is a guide to manually configure native dependencies. -Open the `harmony` directory of the HarmonyOS project in DevEco Studio. +First, use DevEco Studio to open the HarmonyOS project `harmony` in the project directory. ### 1. Adding the overrides Field to oh-package.json5 File in the Root Directory of the Project @@ -322,8 +327,9 @@ export function createRNOHPackages(ctx: RNPackageContext): RNPackage[] { } ``` +
-### 6. Running +## Running Click the `sync` button in the upper right corner. diff --git a/en/react-native-ohos-community-auto-fill.md b/en/react-native-ohos-community-auto-fill.md index 436dabbf..42e2dbcc 100644 --- a/en/react-native-ohos-community-auto-fill.md +++ b/en/react-native-ohos-community-auto-fill.md @@ -15,7 +15,7 @@ Based on the HarmonyOS [autoFillManager](https://developer.huawei.com/consumer/e -> [!TIP] [ GitHub address](https://github.com/react-native-oh-library/auto-fill) +> [!TIP] [GitHub address](https://github.com/react-native-oh-library/auto-fill) ## Prerequisites @@ -58,7 +58,7 @@ yarn add @react-native-ohos/auto-fill ```tsx import React, { useState } from 'react'; import { View, TextInput, Button, StyleSheet } from 'react-native'; -import AutoFill from '@react-native-ohos/auto-fill'; +import AutoFill from 'auto-fill'; const MyFormComponent = () => { const [fullName, setFullName] = useState(''); @@ -144,14 +144,21 @@ The following lists the mapping between [textContentType](https://reactnative.cn ### Link -Version >= @react-native-ohos/auto-fill@1.0.2 now supports Autolink without requiring manual configuration, currently only supports 72 frameworks. -Autolink Framework Guide Documentation: https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md +| | Is supported autolink | Supported RN Ve +|--------------------------------------|------------------|------------| +| ~1.1.0 | No | 0.77 | +| ~1.0.2 | Yes | 0.72 | +| <=1.0.1@deprecated | No | 0.72 | -This step provides guidance for manually configuring native dependencies. +Using AutoLink need to be configured according to this document, Autolink Framework Guide Documentation: https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md -Open the **harmony** directory of the HarmonyOS project in DevEco Studio. +If the version you use supports Autolink and the project has been connected to Autolink, skip the ManualLink configuration. +
+ ManualLink: this step is a guide to manually configure native dependencies. -#### 1. 1. Adding the **overrides** Field to the **oh-package.json5** File in the Root Directory of the Project +First, use DevEco Studio to open the HarmonyOS project `harmony` in the project directory. + +#### 1. Adding the **overrides** Field to the **oh-package.json5** File in the Root Directory of the Project ```json { @@ -255,8 +262,9 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { ]; } ``` +
-#### 5.Running +## Running Click the `sync` button in the upper right corner. diff --git a/en/react-native-orientation.md b/en/react-native-orientation.md index c50acac0..92dcc047 100644 --- a/en/react-native-orientation.md +++ b/en/react-native-orientation.md @@ -189,18 +189,23 @@ const styles = StyleSheet.create({ ## Use Codegen -Version >= @react-native-ohos/react-native-orientation@3.1.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](/zh-cn/codegen.md). +This library has been adapted for `Codegen`. Before using it, you need to proactively generate the bridge code for the third-party library. For details, please refer to the [Codegen Usage Documentation](/en/codegen.md). ## Link -Version >= @react-native-ohos/react-native-orientation@3.1.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 +| | Is supported autolink | Supported RN Ve +|--------------------------------------|------------------|------------| +| ~3.2.0 | No | 0.77 | +| ~3.1.4 | Yes | 0.72 | +| <= 3.1.3-0.0.4@deprecated | No | 0.72 | + +Using AutoLink need to be configured according to this document, 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. +If the version you use supports Autolink and the project has been connected to Autolink, skip the ManualLink configuration. +
+ ManualLink: this step is a guide to manually configure native dependencies. -Open the `harmony` directory of the HarmonyOS project in DevEco Studio. +First, use DevEco Studio to open the HarmonyOS project `harmony` in the project directory. ### 1. Adding the overrides Field to oh-package.json5 File in the Root Directory of the Project @@ -316,8 +321,9 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { ]; } ``` +
-### 5. Running +## Running Click the `sync` button in the upper right corner. diff --git a/en/react-native-pager-view.md b/en/react-native-pager-view.md index 23f05ac3..db832ec9 100644 --- a/en/react-native-pager-view.md +++ b/en/react-native-pager-view.md @@ -75,11 +75,19 @@ const styles = StyleSheet.create({ ## Link -Version >= @react-native-ohos/react-native-pager-view@6.2.5 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 +| | Is supported autolink | Supported RN Ve +|--------------------------------------|------------------|------------| +| ~6.7.2 | No | 0.77 | +| ~6.2.5 | Yes | 0.72 | +| <= 6.2.4@deprecated | No | 0.72 | -This step provides guidance for manually configuring native dependencies. +Using AutoLink need to be configured according to this document, Autolink Framework Guide Documentation: https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md -Open the `harmony` directory of the HarmonyOS project in DevEco Studio. +If the version you use supports Autolink and the project has been connected to Autolink, skip the ManualLink configuration. +
+ ManualLink: this step is a guide to manually configure native dependencies. + +First, use DevEco Studio to open the HarmonyOS project `harmony` in the project directory. ### 1. Adding the overrides Field to oh-package.json5 File in the Root Directory of the Project @@ -195,10 +203,10 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { ]; } ``` +
- -### 5. Running +## Running Click the `sync` button in the upper right corner. diff --git a/zh-cn/react-native-MJRefresh.md b/zh-cn/react-native-MJRefresh.md index b72ace1b..6c46b48d 100644 --- a/zh-cn/react-native-MJRefresh.md +++ b/zh-cn/react-native-MJRefresh.md @@ -128,12 +128,19 @@ export default class MjRefreshDemo extends Component<{}, State> { ## Link -Version >= @react-native-ohos/react-native-mjrefresh@0.7.1，已支持 Autolink，无需手动配置，目前只支持72框架。 -Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md +| | 是否支持autolink | RN框架版本 | +|--------------------------------------|-----------------|------------| +| ~0.7.1 | Yes | 0.72 | +| <= 0.7.0-0.2.2@deprecated | No | 0.72 | -此步骤为手动配置原生依赖项的指导。 +使用AutoLink的工程需要根据该文档配置，Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md -首先需要使用 DevEco Studio 打开项目里的 HarmonyOS 工程 `harmony` +如您使用的版本支持 Autolink，并且工程已接入 Autolink，可跳过ManualLink配置。 + +
+ ManualLink: 此步骤为手动配置原生依赖项的指导 + +首先需要使用 DevEco Studio 打开项目里的 HarmonyOS 工程 `harmony`。 ### 在工程根目录的 `oh-package.json5` 添加 overrides字段 @@ -238,8 +245,9 @@ std::vector> PackageProvider::getPackages(Package::Cont }; } ``` +
-### 4.运行 +## 运行 点击右上角的 `sync` 按钮 diff --git a/zh-cn/react-native-incall-manager.md b/zh-cn/react-native-incall-manager.md index 3cf89550..f0eb7f45 100644 --- a/zh-cn/react-native-incall-manager.md +++ b/zh-cn/react-native-incall-manager.md @@ -497,12 +497,20 @@ export default function InCallManagerExample() { ``` ## Link -Version >= @react-native-ohos/react-native-incall-manager@4.2.1，已支持 Autolink，无需手动配置，目前只支持72框架。 -Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md +| | 是否支持autolink | RN框架版本 | +|--------------------------------------|-----------------|------------| +| ~4.3.0 | No | 0.77 | +| ~4.2.1 | Yes | 0.72 | +| <= 4.2.0-0.0.4@deprecated | No | 0.72 | -此步骤为手动配置原生依赖项的指导。 +使用AutoLink的工程需要根据该文档配置，Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md -首先需要使用 DevEco Studio 打开项目里的 HarmonyOS 工程 `harmony` +如您使用的版本支持 Autolink，并且工程已接入 Autolink，可跳过ManualLink配置。 + +
+ ManualLink: 此步骤为手动配置原生依赖项的指导 + +首先需要使用 DevEco Studio 打开项目里的 HarmonyOS 工程 `harmony`。 ### 1.在工程根目录的 `oh-package.json5` 添加 overrides 字段 @@ -622,8 +630,9 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { ]; } ``` +
-### 5.运行 +## 运行 点击右上角的 `sync` 按钮 diff --git a/zh-cn/react-native-keep-awake.md b/zh-cn/react-native-keep-awake.md index 8b7aaecf..b3c772d9 100644 --- a/zh-cn/react-native-keep-awake.md +++ b/zh-cn/react-native-keep-awake.md @@ -108,17 +108,24 @@ export function KeepAwakeExample() { ## 使用 Codegen -Version >= @react-native-ohos/react-native-keep-awake@4.0.1，已适配codegen-lib生成桥接代码。 - 本库已经适配了 `Codegen` ，在使用前需要主动执行生成三方库桥接代码，详细请参考[ Codegen 使用文档](/zh-cn/codegen.md)。 ## Link -Version >= @react-native-ohos/react-native-keep-awake@4.0.1，已支持 Autolink，无需手动配置，目前只支持72框架。 Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md +| | 是否支持autolink | RN框架版本 | +|--------------------------------------|-----------------|------------| +| ~4.1.0 | No | 0.77 | +| ~4.0.1 | Yes | 0.72 | +| <= 4.0.0-0.0.1@deprecated | No | 0.72 | + +使用AutoLink的工程需要根据该文档配置，Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md + +如您使用的版本支持 Autolink，并且工程已接入 Autolink，可跳过ManualLink配置。 -此步骤为手动配置原生依赖项的指导。 +
+ ManualLink: 此步骤为手动配置原生依赖项的指导 -首先需要使用 DevEco Studio 打开项目里的 HarmonyOS 工程 `harmony` +首先需要使用 DevEco Studio 打开项目里的 HarmonyOS 工程 `harmony`。 ### 在工程根目录的 `oh-package.json5` 添加 overrides字段 @@ -257,8 +264,9 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { ]; } ``` +
-### 5.运行 +## 运行 点击右上角的 `sync` 按钮 diff --git a/zh-cn/react-native-keys.md b/zh-cn/react-native-keys.md index 5d625f4a..c47ca9ac 100644 --- a/zh-cn/react-native-keys.md +++ b/zh-cn/react-native-keys.md @@ -85,11 +85,20 @@ Keys.secureFor('SECRET_KEY'); ## Link -Version >= @react-native-ohos/react-native-keys@0.7.12，已支持 Autolink，无需手动配置，目前只支持72框架。 Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md +| | 是否支持autolink | RN框架版本 | +|--------------------------------------|-----------------|------------| +| ~0.8.0 | No | 0.77 | +| ~0.7.12 | Yes | 0.72 | +| <= 0.7.11@deprecated | No | 0.72 | -此步骤为手动配置原生依赖项的指导。 +使用AutoLink的工程需要根据该文档配置，Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md -首先需要使用 DevEco Studio 打开项目里的 HarmonyOS 工程 `harmony` +如您使用的版本支持 Autolink，并且工程已接入 Autolink，可跳过ManualLink配置。 + +
+ ManualLink: 此步骤为手动配置原生依赖项的指导 + +首先需要使用 DevEco Studio 打开项目里的 HarmonyOS 工程 `harmony`。 ### 在工程根目录的 `oh-package.json` 添加 overrides字段 @@ -211,8 +220,12 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { ]; } ``` +
+ +## 必要的配置项 -### 5.在 DevEco 创建运行前script（生成加解密代码和编译配置文件） +> [!TIP] 该模块的内容无法通过autolink自动生成，始终需要手动配置。 +### 在 DevEco 创建运行前script（生成加解密代码和编译配置文件） > [!TIP] 如下步骤中添加配置完成时记得点击Apply按钮让配置生效 @@ -222,7 +235,7 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { 3. 配置entry -> Before Lunch，点击加号选择 Run Another Configuration， 选择上一步配置的 Shell Script, 并将配置拖动到Hvigor-Build Make上方 ![entry config](../img/rnkeys/entry_config.PNG) -### 6.运行 +## 运行 点击右上角的 `sync` 按钮 diff --git a/zh-cn/react-native-localization-settings.md b/zh-cn/react-native-localization-settings.md index a3b5a261..f391c928 100644 --- a/zh-cn/react-native-localization-settings.md +++ b/zh-cn/react-native-localization-settings.md @@ -125,17 +125,24 @@ const styles = StyleSheet.create({ ## 使用 Codegen -Version >= @react-native-ohos/react-native-localization-settings@1.0.3，已适配codegen-lib生成桥接代码。 - 本库已经适配了 `Codegen` ，在使用前需要主动执行生成三方库桥接代码，详细请参考[ Codegen 使用文档](/zh-cn/codegen.md)。 ## Link -Version >= @react-native-ohos/react-native-localization-settings@1.0.3，已支持 Autolink，无需手动配置，目前只支持72框架。 Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md +| | 是否支持autolink | RN框架版本 | +|--------------------------------------|-----------------|------------| +| ~1.2.1 | No | 0.77 | +| ~1.0.3 | Yes | 0.72 | +| <= 1.0.2-0.0.1@deprecated | No | 0.72 | + +使用AutoLink的工程需要根据该文档配置，Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md + +如您使用的版本支持 Autolink，并且工程已接入 Autolink，可跳过ManualLink配置。 -此步骤为手动配置原生依赖项的指导。 +
+ ManualLink: 此步骤为手动配置原生依赖项的指导 -首先需要使用 DevEco Studio 打开项目里的 HarmonyOS 工程 `harmony` +首先需要使用 DevEco Studio 打开项目里的 HarmonyOS 工程 `harmony`。 ### 1.在工程根目录的 `oh-package.json5` 添加 overrides 字段 @@ -258,8 +265,9 @@ std::vector> PackageProvider::getPackages(Package::Cont }; } ``` +
-### 5.运行 +## 运行 点击右上角的 `sync` 按钮 diff --git a/zh-cn/react-native-localization.md b/zh-cn/react-native-localization.md index 02f1eec5..8f1332b9 100644 --- a/zh-cn/react-native-localization.md +++ b/zh-cn/react-native-localization.md @@ -20,7 +20,7 @@ ## 安装与使用 -该第三方库的仓库已迁移至 Gitcode，且支持直接从 npm 下载，新的包名为：`@react-native-ohos/react-native-localization`，具体版本所属关系如下： +请到三方库的 Releases 发布地址查看配套的版本信息： | 三方库版本 | 发布信息 | 支持RN版本 | |-------| ------------------------------------------------------------ | ---------- | @@ -177,18 +177,24 @@ const styles = StyleSheet.create({ ``` ## 使用 Codegen -Version >= @react-native-ohos/react-native-localization@2.3.3，已适配codegen-lib生成桥接代码。 - 本库已经适配了 `Codegen` ，在使用前需要主动执行生成三方库桥接代码，详细请参考[ Codegen 使用文档](/zh-cn/codegen.md)。 ## Link -Version >= @react-native-ohos/react-native-localization@2.3.3，已支持 Autolink，无需手动配置，目前只支持72框架。 -Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md +| | 是否支持autolink | RN框架版本 | +|--------------------------------------|-----------------|------------| +| ~2.4.0 | No | 0.77 | +| ~2.3.3 | Yes | 0.72 | +| <=2.3.2-0.0.1@deprecated | No | 0.72 | + +使用AutoLink的工程需要根据该文档配置，Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md + +如您使用的版本支持 Autolink，并且工程已接入 Autolink，可跳过ManualLink配置。 -此步骤为手动配置原生依赖项的指导。 +
+ ManualLink: 此步骤为手动配置原生依赖项的指导 -首先需要使用 DevEco Studio 打开项目里的鸿蒙工程 `harmony` +首先需要使用 DevEco Studio 打开项目里的 HarmonyOS 工程 `harmony`。 ### 1.在工程根目录的 `oh-package.json5` 添加 overrides字段 @@ -310,8 +316,9 @@ std::vector> PackageProvider::getPackages(Package::Cont }; } ``` +
-### 5.运行 +## 运行 点击右上角的 `sync` 按钮 diff --git a/zh-cn/react-native-mail.md b/zh-cn/react-native-mail.md index 37fd4c6f..9c758c6b 100644 --- a/zh-cn/react-native-mail.md +++ b/zh-cn/react-native-mail.md @@ -117,17 +117,24 @@ export default class App extends Component { ## 使用 Codegen -Version >= @react-native-ohos/react-native-mail@6.1.2，已适配codegen-lib生成桥接代码。 - 本库已经适配了 `Codegen` ，在使用前需要主动执行生成三方库桥接代码，详细请参考[ Codegen 使用文档](/zh-cn/codegen.md)。 ## Link -Version >= @react-native-ohos/react-native-mail@6.1.2，已支持 Autolink，无需手动配置，目前只支持72框架。 Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md +| | 是否支持autolink | RN框架版本 | +|--------------------------------------|-----------------|------------| +| ~6.2.0 | No | 0.77 | +| ~6.1.2 | Yes | 0.72 | +| <= 6.1.1-0.0.1@deprecated | No | 0.72 | + +使用AutoLink的工程需要根据该文档配置，Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md -此步骤为手动配置原生依赖项的指导。 +如您使用的版本支持 Autolink，并且工程已接入 Autolink，可跳过ManualLink配置。 -首先需要使用 DevEco Studio 打开项目里的 HarmonyOS 工程 `harmony` +
+ ManualLink: 此步骤为手动配置原生依赖项的指导 + +首先需要使用 DevEco Studio 打开项目里的 HarmonyOS 工程 `harmony`。 ### 1.在工程根目录的 `oh-package.json5` 添加 overrides 字段 @@ -237,9 +244,9 @@ std::vector> PackageProvider::getPackages(Package::Cont + std::make_shared(ctx) } ``` +
- -### 5.运行 +## 运行 点击右上角的 `sync` 按钮 diff --git a/zh-cn/react-native-maps.md b/zh-cn/react-native-maps.md index 5fa9b6f4..834cdef8 100644 --- a/zh-cn/react-native-maps.md +++ b/zh-cn/react-native-maps.md @@ -202,11 +202,20 @@ const styles = StyleSheet.create({ ## Link -Version >= @react-native-ohos/react-native-maps@1.10.4，已支持 Autolink，无需手动配置，目前只支持72框架。 Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md +| | 是否支持autolink | RN框架版本 | +|--------------------------------------|-----------------|------------| +| ~1.24.4 | No | 0.77 | +| ~1.10.4 | Yes | 0.72 | +| <= 1.10.3-0.1.4@deprecated | No | 0.72 | -此步骤为手动配置原生依赖项的指导。 +使用AutoLink的工程需要根据该文档配置，Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md -首先需要使用 DevEco Studio 打开项目里的 HarmonyOS 工程 `harmony` +如您使用的版本支持 Autolink，并且工程已接入 Autolink，可跳过ManualLink配置。 + +
+ ManualLink: 此步骤为手动配置原生依赖项的指导 + +首先需要使用 DevEco Studio 打开项目里的 HarmonyOS 工程 `harmony`。 ### 1.在工程根目录的 `oh-package.json5` 添加 overrides 字段 @@ -446,8 +455,9 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { ]; } ``` +
-### 6.运行 +## 运行 点击右上角的 `sync` 按钮 diff --git a/zh-cn/react-native-masked-view-masked-view.md b/zh-cn/react-native-masked-view-masked-view.md index 32141608..85a6ac54 100644 --- a/zh-cn/react-native-masked-view-masked-view.md +++ b/zh-cn/react-native-masked-view-masked-view.md @@ -110,11 +110,20 @@ export default MaskedDemo ## Link -Version >= @react-native-ohos/masked-view@0.2.11，已支持 Autolink，无需手动配置，目前只支持 72 框架。 Autolink 框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md +| | 是否支持autolink | RN框架版本 | +|--------------------------------------|-----------------|------------| +| ~0.3.3 | No | 0.77 | +| ~0.2.11 | Yes | 0.72 | +| <= 0.2.9-0.2.2@deprecated | No | 0.72 | -此步骤为手动配置原生依赖项的指导。 +使用AutoLink的工程需要根据该文档配置，Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md -首先需要使用 DevEco Studio 打开项目里的 HarmonyOS 工程 `harmony` +如您使用的版本支持 Autolink，并且工程已接入 Autolink，可跳过ManualLink配置。 + +
+ ManualLink: 此步骤为手动配置原生依赖项的指导 + +首先需要使用 DevEco Studio 打开项目里的 HarmonyOS 工程 `harmony`。 ### 1.在工程根目录的 `oh-package.json5` 添加 overrides 字段 @@ -239,8 +248,9 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { ]; } ``` +
-### 5.运行 +## 运行 点击右上角的 `sync` 按钮 diff --git a/zh-cn/react-native-mlkit-ocr.md b/zh-cn/react-native-mlkit-ocr.md index e15bfb28..e60f5eae 100644 --- a/zh-cn/react-native-mlkit-ocr.md +++ b/zh-cn/react-native-mlkit-ocr.md @@ -146,11 +146,20 @@ export const OcrTest = () => { ## Link -Version >= @react-native-ohos/react-native-mlkit-ocr@0.3.1，已支持 Autolink，无需手动配置，目前只支持72框架。 Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md +| | 是否支持autolink | RN框架版本 | +|--------------------------------------|-----------------|------------| +| ~0.4.0 | No | 0.77 | +| ~0.3.1 | Yes | 0.72 | +| <= 0.3.0-0.0.1@deprecated | No | 0.72 | -此步骤为手动配置原生依赖项的指导。 +使用AutoLink的工程需要根据该文档配置，Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md -首先需要使用 DevEco Studio 打开项目里的 HarmonyOS 工程 `harmony` +如您使用的版本支持 Autolink，并且工程已接入 Autolink，可跳过ManualLink配置。 + +
+ ManualLink: 此步骤为手动配置原生依赖项的指导 + +首先需要使用 DevEco Studio 打开项目里的 HarmonyOS 工程 `harmony`。 ### 1.在工程根目录的 `oh-package.json5` 添加 overrides 字段 @@ -271,7 +280,12 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { } ``` -### 5.应用权限申请 +
+ +## 必要的配置项 + +> [!TIP] 该模块的内容无法通过autolink自动生成，始终需要手动配置。 +### 应用权限申请(该模块始终需要手动配置) > [!TIP] "ohos.permission.INTERNET"权限等级为normal，授权方式为system_grant，[使用 ACL 签名的配置指导](https://developer.harmonyos.com/cn/docs/documentation/doc-guides-V3/signing-0000001587684945-V3#section157591551175916) @@ -294,9 +308,7 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { } ``` - - -### 6.运行 +## 运行 点击右上角的 `sync` 按钮 diff --git a/zh-cn/react-native-mmkv-storage.md b/zh-cn/react-native-mmkv-storage.md index 657f5308..c4aacff3 100644 --- a/zh-cn/react-native-mmkv-storage.md +++ b/zh-cn/react-native-mmkv-storage.md @@ -203,11 +203,20 @@ const styles = StyleSheet.create({ ## Link -Version >= @react-native-ohos/react-native-mmkv-storage@0.10.5，已支持 Autolink，无需手动配置，目前只支持72框架。 Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md +| | 是否支持autolink | RN框架版本 | +|--------------------------------------|-----------------|------------| +| ~0.11.3 | No | 0.77 | +| ~0.10.5 | Yes | 0.72 | +| <= 0.10.4@deprecated | No | 0.72 | -此步骤为手动配置原生依赖项的指导。 +使用AutoLink的工程需要根据该文档配置，Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md -首先需要使用 DevEco Studio 打开项目里的 HarmonyOS 工程 `harmony` +如您使用的版本支持 Autolink，并且工程已接入 Autolink，可跳过ManualLink配置。 + +
+ ManualLink: 此步骤为手动配置原生依赖项的指导 + +首先需要使用 DevEco Studio 打开项目里的 HarmonyOS 工程 `harmony`。 ### 1.在工程根目录的 `oh-package.json5` 添加 overrides 字段 @@ -334,8 +343,9 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { } ``` +
-### 5.运行 +## 运行 点击右上角的 `sync` 按钮 diff --git a/zh-cn/react-native-network-info.md b/zh-cn/react-native-network-info.md index 88929798..224cd1c1 100644 --- a/zh-cn/react-native-network-info.md +++ b/zh-cn/react-native-network-info.md @@ -159,17 +159,24 @@ const styles = StyleSheet.create({ ## 使用 Codegen -Version >= @react-native-ohos/react-native-network-info@5.2.2，已适配codegen-lib生成桥接代码。 - 本库已经适配了 `Codegen` ，在使用前需要主动执行生成三方库桥接代码，详细请参考[ Codegen 使用文档](/zh-cn/codegen.md)。 ## Link -Version >= @react-native-ohos/react-native-network-info@5.2.2，已支持 Autolink，无需手动配置，目前只支持72框架。 Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md +| | 是否支持autolink | RN框架版本 | +|--------------------------------------|-----------------|------------| +| ~5.3.0 | No | 0.77 | +| ~5.2.2 | Yes | 0.72 | +| <= 5.2.1-0.0.1@deprecated | No | 0.72 | + +使用AutoLink的工程需要根据该文档配置，Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md + +如您使用的版本支持 Autolink，并且工程已接入 Autolink，可跳过ManualLink配置。 -此步骤为手动配置原生依赖项的指导。 +
+ ManualLink: 此步骤为手动配置原生依赖项的指导 -首先需要使用 DevEco Studio 打开项目里的 HarmonyOS 工程 `harmony` +首先需要使用 DevEco Studio 打开项目里的 HarmonyOS 工程 `harmony`。 ### 1.在工程根目录的 `oh-package.json5` 添加 overrides 字段 @@ -280,8 +287,9 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { ]; } ``` +
-### 5.运行 +## 运行 点击右上角的 `sync` 按钮 diff --git a/zh-cn/react-native-nfc-manager.md b/zh-cn/react-native-nfc-manager.md index f69ef0f6..19ceced6 100644 --- a/zh-cn/react-native-nfc-manager.md +++ b/zh-cn/react-native-nfc-manager.md @@ -92,17 +92,24 @@ export default App; ## 使用 Codegen -Version >= @react-native-ohos/react-native-nfc-manager@3.15.1，已适配codegen-lib生成桥接代码。 - 本库已经适配了 `Codegen` ，在使用前需要主动执行生成三方库桥接代码，详细请参考[ Codegen 使用文档](/zh-cn/codegen.md)。 ## Link -Version >= @react-native-ohos/react-native-nfc-manager@3.15.1，已支持 Autolink，无需手动配置（仍需手动配置的内容已在对应标题处标记），目前只支持72框架。 Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md +| | 是否支持autolink | RN框架版本 | +|--------------------------------------|-----------------|------------| +| ~3.16.2 | No | 0.77 | +| ~3.15.1 | Yes | 0.72 | +| <= 3.15.0-0.0.4@deprecated | No | 0.72 | + +使用AutoLink的工程需要根据该文档配置，Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md + +如您使用的版本支持 Autolink，并且工程已接入 Autolink，可跳过ManualLink配置。 -此步骤为手动配置原生依赖项的指导。 +
+ ManualLink: 此步骤为手动配置原生依赖项的指导 -首先需要使用 DevEco Studio 打开项目里的 HarmonyOS 工程 harmony +首先需要使用 DevEco Studio 打开项目里的 HarmonyOS 工程 `harmony`。 ```json 在工程根目录的 oh-package.json 添加 overrides字段 @@ -114,92 +121,7 @@ Version >= @react-native-ohos/react-native-nfc-manager@3.15.1，已支持 Autoli } ``` -## 配置Entry(该模块始终需要手动配置) - -本库主要用于操作及管理NFC Tag，提供后台读卡和前台应用优先分发两种读卡模式。后台读卡是指不需要打开应用程序，电子设备通过NFC读取标签卡片后，根据标签卡片的类型匹配到一个或多个应用程序。如果仅匹配到一个，则直接拉起应用程序的读卡页面；如果是多个则弹出应用选择器，让用户选择指定的读卡应用。前台读卡是指提前打开应用程序，并进入对应的NFC读卡页面后读卡，只会把读到的标签卡片信息分发给前台应用程序。 - -### 后台读卡方式的声明 -**1.应用程序需要支持后台读卡时，需要在应用的属性配置文件中，声明与NFC相关的属性值。比如，在entry/src/main/module.json5文件中，声明下面属性值：** -```json -{ - "module": { - // other declared attributes. - - "abilities": [ - { - "skills": [ - { - "actions": [ - // other declared actions, - - // add the nfc tag action - "ohos.nfc.tag.action.TAG_FOUND" - ], - "uris": [ - { - "type":"tag-tech/NfcA" - }, - { - "type":"tag-tech/IsoDep" - } - // Add other technology if neccessary, - // such as: NfcB/NfcF/NfcV/Ndef/MifareClassic/MifareUL/NdefFormatable - ] - } - ] - } - ], - "requestPermissions": [ - { - "name": "ohos.permission.NFC_TAG", - "reason": "$string:app_name", - } - ] - } -} -``` -**2.在对相关Tag类型卡片进行读写之前，必须先获取TagInfo相关属性值，以确认设备读取到的Tag卡片支持哪些技术类型。可以将以下内容添加到EntryAbility** - -```js -import {RNAbility} from 'rnoh'; -import Want from '@ohos.app.ability.Want'; -import AbilityConstant from '@ohos.app.ability.AbilityConstant'; - -import { RNNfcManagerModule } from '@react-native-ohos/react-native-nfc-manager'; - -export default class EntryAbility extends RNAbility { - - onCreate(want: Want): void { - super.onCreate(want); - RNNfcManagerModule.registerAbilityEvents(this.context,'onCreate',want); - } - - onForeground(): void { - super.onForeground(); - } - - onBackground(): void { - super.onBackground(); - } - - onNewWant(want: Want, launchParam: AbilityConstant.LaunchParam): void { - super.onNewWant(want,launchParam); - RNNfcManagerModule.registerAbilityEvents(this.context,'onNewWant',want); - } - - getPagePath() { - return 'pages/Index'; - } - - onDestroy(): void { - super.onDestroy(); - RNNfcManagerModule.unRegisterAbilityEvents(this.context); - } -} - -``` - -### 2.引入原生端代码 +### 引入原生端代码 目前有两种方法： @@ -307,9 +229,98 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { + new RNNfcManagerPackage(ctx), ]; } +``` +
+ +## 必要的配置项 + +> [!TIP] 该模块的内容无法通过autolink自动生成，始终需要手动配置。 +## 配置Entry(该模块始终需要手动配置) + +本库主要用于操作及管理NFC Tag，提供后台读卡和前台应用优先分发两种读卡模式。后台读卡是指不需要打开应用程序，电子设备通过NFC读取标签卡片后，根据标签卡片的类型匹配到一个或多个应用程序。如果仅匹配到一个，则直接拉起应用程序的读卡页面；如果是多个则弹出应用选择器，让用户选择指定的读卡应用。前台读卡是指提前打开应用程序，并进入对应的NFC读卡页面后读卡，只会把读到的标签卡片信息分发给前台应用程序。 + +### 后台读卡方式的声明 +**1.应用程序需要支持后台读卡时，需要在应用的属性配置文件中，声明与NFC相关的属性值。比如，在entry/src/main/module.json5文件中，声明下面属性值：** +```json +{ + "module": { + // other declared attributes. + + "abilities": [ + { + "skills": [ + { + "actions": [ + // other declared actions, + + // add the nfc tag action + "ohos.nfc.tag.action.TAG_FOUND" + ], + "uris": [ + { + "type":"tag-tech/NfcA" + }, + { + "type":"tag-tech/IsoDep" + } + // Add other technology if neccessary, + // such as: NfcB/NfcF/NfcV/Ndef/MifareClassic/MifareUL/NdefFormatable + ] + } + ] + } + ], + "requestPermissions": [ + { + "name": "ohos.permission.NFC_TAG", + "reason": "$string:app_name", + } + ] + } +} +``` +**2.在对相关Tag类型卡片进行读写之前，必须先获取TagInfo相关属性值，以确认设备读取到的Tag卡片支持哪些技术类型。可以将以下内容添加到EntryAbility** + +```js +import {RNAbility} from 'rnoh'; +import Want from '@ohos.app.ability.Want'; +import AbilityConstant from '@ohos.app.ability.AbilityConstant'; + +import { RNNfcManagerModule } from '@react-native-ohos/react-native-nfc-manager'; + +export default class EntryAbility extends RNAbility { + + onCreate(want: Want): void { + super.onCreate(want); + RNNfcManagerModule.registerAbilityEvents(this.context,'onCreate',want); + } + + onForeground(): void { + super.onForeground(); + } + + onBackground(): void { + super.onBackground(); + } + + onNewWant(want: Want, launchParam: AbilityConstant.LaunchParam): void { + super.onNewWant(want,launchParam); + RNNfcManagerModule.registerAbilityEvents(this.context,'onNewWant',want); + } + + getPagePath() { + return 'pages/Index'; + } + + onDestroy(): void { + super.onDestroy(); + RNNfcManagerModule.unRegisterAbilityEvents(this.context); + } +} + ``` -### 5.运行 +## 运行 点击右上角的 `sync` 按钮 diff --git a/zh-cn/react-native-oh-tpl-react-native-screens.md b/zh-cn/react-native-oh-tpl-react-native-screens.md index 00c6ea61..ba801282 100644 --- a/zh-cn/react-native-oh-tpl-react-native-screens.md +++ b/zh-cn/react-native-oh-tpl-react-native-screens.md @@ -152,17 +152,24 @@ export default function App() { ## 使用 Codegen -Version >= @react-native-ohos/react-native-screens@3.34.1，已适配codegen-lib生成桥接代码。 - -本库已经适配了 `Codegen` ，在使用前需要主动执行生成三方库桥接代码，详细请参考[ Codegen 使用文档](https://gitee.com/react-native-oh-library/usage-docs/blob/master/zh-cn/codegen.md)。 +本库已经适配了 `Codegen` ，在使用前需要主动执行生成三方库桥接代码，详细请参考[Codegen 使用文档](/zh-cn/codegen.md)。 ## Link -Version >= @react-native-ohos/react-native-screens@3.34.1，已支持 Autolink，无需手动配置，目前只支持72框架。 Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md +| | 是否支持autolink | RN框架版本 | +|--------------------------------------|-----------------|------------| +| ~4.8.1 | No | 0.77 | +| ~3.34.1 | Yes | 0.72 | +| <= 3.34.0-0.0.2@deprecated | No | 0.72 | + +使用AutoLink的工程需要根据该文档配置，Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md + +如您使用的版本支持 Autolink，并且工程已接入 Autolink，可跳过ManualLink配置。 -此步骤为手动配置原生依赖项的指导。 +
+ ManualLink: 此步骤为手动配置原生依赖项的指导 -首先需要使用 DevEco Studio 打开项目里的HarmonyOS工程 `harmony` +首先需要使用 DevEco Studio 打开项目里的 HarmonyOS 工程 `harmony`。 ### 1.在工程根目录的 `oh-package.json5` 添加 overrides 字段 @@ -323,8 +330,9 @@ export function createRNOHPackages(ctx: RNPackageContext): RNPackage[] { } ``` +
-### 6.运行 +## 运行 点击右上角的 `sync` 按钮 diff --git a/zh-cn/react-native-ohos-community-auto-fill.md b/zh-cn/react-native-ohos-community-auto-fill.md index 1cdaa651..2354208b 100644 --- a/zh-cn/react-native-ohos-community-auto-fill.md +++ b/zh-cn/react-native-ohos-community-auto-fill.md @@ -8,12 +8,13 @@ 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 平台。 +> [!TIP] [Github 地址](https://github.com/react-native-oh-library/auto-fill) + ## 前提条件 1. **申请接入智能填充服务** 。当前智能填充处于 Beta 阶段，您可通过发送邮件的方式进行申请接入。邮件模板可参考 [智能填充概述-申请接入智能填充服务](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/scenario-fusion-introduction-to-smart-fill-V5#section1167564853816) @@ -55,7 +56,7 @@ yarn add @react-native-ohos/auto-fill ```tsx import React, { useState } from 'react'; import { View, TextInput, Button, StyleSheet } from 'react-native'; -import AutoFill from '@react-native-ohos/auto-fill'; +import AutoFill from 'auto-fill'; const MyFormComponent = () => { const [fullName, setFullName] = useState(''); @@ -141,11 +142,20 @@ React-Native 侧 TextInput 组件接收的 [textContentType](https://reactnative ### Link -Version >= @react-native-ohos/auto-fill@1.0.2，已支持 Autolink，无需手动配置，目前只支持72框架。 Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md +| | 是否支持autolink | RN框架版本 | +|--------------------------------------|-----------------|------------| +| ~1.1.0 | No | 0.77 | +| ~1.0.2 | Yes | 0.72 | +| <=1.0.1@deprecated | No | 0.72 | + +使用AutoLink的工程需要根据该文档配置，Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md + +如您使用的版本支持 Autolink，并且工程已接入 Autolink，可跳过ManualLink配置。 -此步骤为手动配置原生依赖项的指导。 +
+ ManualLink: 此步骤为手动配置原生依赖项的指导 -首先需要使用 DevEco Studio 打开项目里的 HarmonyOS 工程 `harmony` +首先需要使用 DevEco Studio 打开项目里的 HarmonyOS 工程 `harmony`。 #### 1. 在 harmony 工程根目录的 `oh-package.json5` 添加 overrides 字段 @@ -250,8 +260,9 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { ]; } ``` +
-#### 5.运行 +### 运行 点击右上角的 `sync` 按钮 diff --git a/zh-cn/react-native-orientation.md b/zh-cn/react-native-orientation.md index 70d5b330..d811ed12 100644 --- a/zh-cn/react-native-orientation.md +++ b/zh-cn/react-native-orientation.md @@ -184,17 +184,24 @@ const styles = StyleSheet.create({ ``` ## 使用 Codegen -Version >= @react-native-ohos/react-native-orientation@3.1.4，已适配codegen-lib生成桥接代码。 - 本库已经适配了 Codegen ，在使用前需要主动执行生成三方库桥接代码，详细请参考 [Codegen 文档](https://gitee.com/react-native-oh-library/usage-docs/blob/master/zh-cn/codegen.md)。 ## Link -Version >= @react-native-ohos/react-native-orientation@3.1.4，已支持 Autolink，无需手动配置，目前只支持72框架。 Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md +| | 是否支持autolink | RN框架版本 | +|--------------------------------------|-----------------|------------| +| ~3.2.0 | No | 0.77 | +| ~3.1.4 | Yes | 0.72 | +| <= 3.1.3-0.0.4@deprecated | No | 0.72 | + +使用AutoLink的工程需要根据该文档配置，Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md + +如您使用的版本支持 Autolink，并且工程已接入 Autolink，可跳过ManualLink配置。 -此步骤为手动配置原生依赖项的指导。 +
+ ManualLink: 此步骤为手动配置原生依赖项的指导 -首先需要使用 DevEco Studio 打开项目里的 HarmonyOS 工程 `harmony` +首先需要使用 DevEco Studio 打开项目里的 HarmonyOS 工程 `harmony`。 ### 1.在工程根目录的 `oh-package.json5` 添加 overrides字段 @@ -312,8 +319,9 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { ]; } ``` +
-### 5.运行 +## 运行 点击右上角的 `sync` 按钮 diff --git a/zh-cn/react-native-pager-view.md b/zh-cn/react-native-pager-view.md index 154a80da..fea48563 100644 --- a/zh-cn/react-native-pager-view.md +++ b/zh-cn/react-native-pager-view.md @@ -75,11 +75,20 @@ const styles = StyleSheet.create({ ## Link -Version >= @react-native-ohos/react-native-pager-view@6.2.5，已支持 Autolink，无需手动配置，目前只支持72框架。 Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md +| | 是否支持autolink | RN框架版本 | +|--------------------------------------|-----------------|------------| +| ~6.7.2 | No | 0.77 | +| ~6.2.5 | Yes | 0.72 | +| <= 6.2.4@deprecated | No | 0.72 | -此步骤为手动配置原生依赖项的指导。 +使用AutoLink的工程需要根据该文档配置，Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md -首先需要使用 DevEco Studio 打开项目里的 HarmonyOS 工程 `harmony` +如您使用的版本支持 Autolink，并且工程已接入 Autolink，可跳过ManualLink配置。 + +
+ ManualLink: 此步骤为手动配置原生依赖项的指导 + +首先需要使用 DevEco Studio 打开项目里的 HarmonyOS 工程 `harmony`。 ### 在工程根目录的 `oh-package.json5` 添加 overrides字段 ```json @@ -197,10 +206,10 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { ]; } ``` +
- -### 5.运行 +## 运行 点击右上角的 `sync` 按钮 -- Gitee