From b5fd58628db69a8f6f8b1fead24bb010da3cf182 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=9F=B3=E4=B8=9C=E6=B5=B7?= Date: Fri, 12 Dec 2025 18:15:44 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20[Issues:=20#IDCP3Z]=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 --- en/react-native-get-random-values.md | 19 +- en/react-native-haptic-feedback.md | 23 +- en/react-native-hole-view.md | 19 +- en/react-native-http-bridge.md | 23 +- en/react-native-idfa-aaid.md | 22 +- en/react-native-idle-timer.md | 22 +- en/react-native-image-capinsets-next.md | 22 +- en/react-native-image-colors.md | 23 +- en/react-native-image-crop-picker.md | 44 ++-- en/react-native-image-editor.md | 34 ++- en/react-native-image-marker.md | 23 +- en/react-native-image-picker.md | 19 +- en/react-native-image-rotate.md | 25 +- en/react-native-image-sequence-2.md | 40 ++-- en/react-native-inappbrowser.md | 247 ++++++++++---------- en/remobile-react-native-toast.md | 23 +- en/rn-bugly.md | 19 +- zh-cn/react-native-get-random-values.md | 18 +- zh-cn/react-native-haptic-feedback.md | 20 +- zh-cn/react-native-hole-view.md | 21 +- zh-cn/react-native-http-bridge.md | 21 +- zh-cn/react-native-idfa-aaid.md | 21 +- zh-cn/react-native-idle-timer.md | 21 +- zh-cn/react-native-image-capinsets-next.md | 20 +- zh-cn/react-native-image-colors.md | 21 +- zh-cn/react-native-image-crop-picker.md | 47 ++-- zh-cn/react-native-image-editor.md | 32 ++- zh-cn/react-native-image-marker.md | 20 +- zh-cn/react-native-image-picker.md | 18 +- zh-cn/react-native-image-rotate.md | 21 +- zh-cn/react-native-image-sequence-2.md | 38 ++-- zh-cn/react-native-inappbrowser.md | 251 +++++++++++---------- zh-cn/remobile-react-native-toast.md | 21 +- zh-cn/rn-bugly.md | 19 +- 34 files changed, 783 insertions(+), 494 deletions(-) diff --git a/en/react-native-get-random-values.md b/en/react-native-get-random-values.md index 54d33486..bcb4cfc3 100644 --- a/en/react-native-get-random-values.md +++ b/en/react-native-get-random-values.md @@ -88,12 +88,19 @@ export const GetRandomValues = () => { ## Link -Version >= @react-native-ohos/react-native-get-random-values@1.11.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 Version | +|----------------------------|-----------------------|----------------------| +| ~1.12.0 | No | 0.77 | +| ~1.11.1 | Yes | 0.72 | +| <= 1.11.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 @@ -215,7 +222,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-haptic-feedback.md b/en/react-native-haptic-feedback.md index 8a6c5fe7..b04f0609 100644 --- a/en/react-native-haptic-feedback.md +++ b/en/react-native-haptic-feedback.md @@ -125,18 +125,23 @@ export default HapticFeedbackExample; ## Use Codegen -Version >= @react-native-ohos/react-native-haptic-feedback@2.2.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-haptic-feedback@2.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 Version | +|---------------------|-----------------------|----------------------| +| ~2.3.4 | No | 0.77 | +| ~2.2.2 | Yes | 0.72 | +| <= 2.2.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 @@ -256,7 +261,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-hole-view.md b/en/react-native-hole-view.md index f9c4d26c..a00cfadb 100644 --- a/en/react-native-hole-view.md +++ b/en/react-native-hole-view.md @@ -146,12 +146,19 @@ export default App; ## Link -Version >= @react-native-ohos/react-native-hole-view@3.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/en/Autolinking.md +| | Is supported autolink | Supported RN Version | +|-------------------------------------|-----------------------|----------------------| +| ~3.1.0 | No | 0.77 | +| ~3.0.1 | Yes | 0.72 | +| <= 3.0.0-alpha4-0.0.5@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 @@ -270,7 +277,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-http-bridge.md b/en/react-native-http-bridge.md index 2852aac7..f351406a 100644 --- a/en/react-native-http-bridge.md +++ b/en/react-native-http-bridge.md @@ -147,18 +147,23 @@ export default HttpBridgeDemo; ## Use Codegen -Version >= @react-native-ohos/react-native-http-bridge@0.6.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-http-bridge@0.6.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 Version | +|---------------------------|-----------------------|----------------------| +| ~0.7.0 | No | 0.77 | +| ~0.6.2 | Yes | 0.72 | +| <= 0.6.1-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 @@ -283,7 +288,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-idfa-aaid.md b/en/react-native-idfa-aaid.md index 8a523488..a53d98d7 100644 --- a/en/react-native-idfa-aaid.md +++ b/en/react-native-idfa-aaid.md @@ -178,17 +178,23 @@ export default App; ## Use Codegen -Version >= @react-native-ohos/react-native-idfa-aaid@1.2.1, compatible with codegen-lib for generating bridge code. - -If this repository has been adapted to `Codegen`, generate the bridge code of the third-party library by using the `Codegen`. For details, see [Codegen Usage Guide](/en/codegen.md). +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-idfa-aaid@1.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 Version | +|---------------------------|-----------------------|----------------------| +| ~1.3.0 | No | 0.77 | +| ~1.2.1 | Yes | 0.72 | +| <= 1.2.0-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 @@ -313,7 +319,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-idle-timer.md b/en/react-native-idle-timer.md index 1cdaefb4..5827b0ed 100644 --- a/en/react-native-idle-timer.md +++ b/en/react-native-idle-timer.md @@ -78,17 +78,23 @@ export default IdleTimerExample; ## Use Codegen -Version >= @react-native-ohos/react-native-idle-timer@2.2.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). +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-idle-timer@2.2.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 Version | +|---------------------------|-----------------------|----------------------| +| ~2.3.0 | No | 0.77 | +| ~2.2.4 | Yes | 0.72 | +| <= 2.2.3-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 @@ -214,7 +220,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-image-capinsets-next.md b/en/react-native-image-capinsets-next.md index a911dabf..e6916047 100644 --- a/en/react-native-image-capinsets-next.md +++ b/en/react-native-image-capinsets-next.md @@ -128,17 +128,23 @@ export default YourImage; ## Use Codegen -Version >= @react-native-ohos/react-native-image-capinsets-next@0.6.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-image-capinsets-next@0.6.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 Version | +|---------------------------|-----------------------|----------------------| +| ~0.7.0 | No | 0.77 | +| ~0.6.2 | Yes | 0.72 | +| <= 0.6.1-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 @@ -296,7 +302,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-image-colors.md b/en/react-native-image-colors.md index 956116e1..b2eea2b5 100644 --- a/en/react-native-image-colors.md +++ b/en/react-native-image-colors.md @@ -205,18 +205,23 @@ const styles = StyleSheet.create({ ## Use Codegen -Version >= @react-native-ohos/react-native-image-colors@2.4.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-image-colors@2.4.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 Version | +|---------------------------|-----------------------|----------------------| +| ~2.5.1 | No | 0.77 | +| ~2.4.1 | Yes | 0.72 | +| <= 2.4.0-0.0.7@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 @@ -336,7 +341,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-image-crop-picker.md b/en/react-native-image-crop-picker.md index ba03ee12..9cd57d06 100644 --- a/en/react-native-image-crop-picker.md +++ b/en/react-native-image-crop-picker.md @@ -801,13 +801,21 @@ const styles = StyleSheet.create({ export default ImageCropPickDemo; ``` -## 2. Manual Link +## 2. Link -Version >= @react-native-ohos/react-native-image-crop-picker@0.40.5 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 Version | +|-----------------------------|-----------------------|----------------------| +| ~0.50.2 | No | 0.77 | +| ~0.40.5 | Yes | 0.72 | +| <= 0.40.3-0.0.14@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. ### 2.1 Overrides RN SDK @@ -849,7 +857,7 @@ Click the `sync` button in the upper right corner. Alternatively, run the following instruction on the terminal: -``` +```bash cd entry ohpm install ``` @@ -910,7 +918,7 @@ std::vector> PackageProvider::getPackages(Package::Cont } ``` -### 2.4. Introducing ImageCropPickerPackage to ArkTS +### 2.4 Introducing ImageCropPickerPackage to ArkTS Open the `entry/src/main/ets/RNPackagesFactory.ts` file and add the following code: @@ -926,7 +934,13 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { } ``` -### 2.5. Configuration Entry(This module always requires manual configuration) +
+ +## 3. Necessary configuration items + +> [!TIP] The content of this module cannot be automatically generated by autolink and must always be manually configured. + +### Configuration Entry(This module always requires manual configuration) **(1)Change EntryAbility.ets under entry/src/main/ets/entryability** @@ -1105,7 +1119,7 @@ struct ImageEdit { } ``` -### 2.6. Running +## 4. Running Click the `sync` button in the upper right corner. @@ -1118,9 +1132,9 @@ ohpm install Then build and run the code. -## 3. Constraints +## 5. Constraints -### 3.1. Compatibility +### Compatibility 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. @@ -1130,7 +1144,7 @@ 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; -## 4. API +## 6. API > [!TIP] The **Platform** column indicates the platform where the properties are supported in the original third-party library. @@ -1144,7 +1158,7 @@ Verified in the following versions. | cleanSingle | Delete a single cache file | function | no | iOS/Android | yes | | openCamera | Select from camera | function | no | iOS/Android | yes | -## 5. Properties +## 7. Properties > [!TIP] The **Platform** column indicates the platform where the properties are supported in the original third-party library. @@ -1194,7 +1208,7 @@ Verified in the following versions. | cropperCancelColor (iOS only) | string (default tint `iOS` color ) | HEX format color for the Cancel button. Default value is the default tint iOS color [controlled by TOCropViewController](https://gitee.com/link?target=https%3A%2F%2Fgithub.com%2FTimOliver%2FTOCropViewController%2Fblob%2Fa942414508012b13102f776eb65dac655f31cabb%2FObjective-C%2FTOCropViewController%2FViews%2FTOCropToolbar.m%23L433) | no | iOS | yes | | cropperRotateButtonsHidden (iOS only) | bool (default false) | Enable or disable cropper rotate buttons | no | iOS | yes | -## 6. Known Issues +## 8. Known Issues - [ ] Images in react-native-image-crop-picker will always fill the mask space [#4](https://github.com/react-native-oh-library/react-native-image-crop-picker/issues/4) - [ ] Change the color of ActiveWidget in Android Demo [#5](https://github.com/react-native-oh-library/react-native-image-crop-picker/issues/5) @@ -1213,8 +1227,8 @@ Verified in the following versions. - [ ] @ohos.multimedia.image cannot perform circular cropping [#46](https://github.com/react-native-oh-library/react-native-image-crop-picker/issues/46) - [ ] The PackingOption in @ohos.multimedia.image cannot set width and height properties [#47](https://github.com/react-native-oh-library/react-native-image-crop-picker/issues/47) -## 7. Others +## 9. Others -## 8. License +## 10. License This project is licensed under [The MIT License (MIT)](https://gitee.com/openharmony-sig/rntpc_react-native-image-crop-picker/blob/master/LICENSE). diff --git a/en/react-native-image-editor.md b/en/react-native-image-editor.md index 0f4259cd..e9b26cb5 100644 --- a/en/react-native-image-editor.md +++ b/en/react-native-image-editor.md @@ -186,13 +186,21 @@ const styles = StyleSheet.create({ }); ``` -## 2. Manual Link +## 2. Link -Version >= @react-native-ohos/image-editor@3.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 Version | +|------------------------------|-----------------------|----------------------| +| ~4.3.1 | No | 0.77 | +| ~3.2.1 | Yes | 0.72 | +| <= 3.2.0-nc.0.1.3@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. ### 2.1 Overrides RN SDK @@ -292,7 +300,9 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { } ``` -### 2.5 Running +
+ +## 3. Running Click the `sync` button in the upper right corner. @@ -305,9 +315,9 @@ ohpm install Then build and run the code. -## 3. Constraints +## 4. Constraints -### 3.1 Compatibility +### Compatibility 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. @@ -317,7 +327,7 @@ Verified successfully 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; -## 4. Properties +## 5. Properties > [!TIP] The **Platform** column indicates the platform where the properties are supported in the original third-party library. @@ -332,7 +342,7 @@ Verified successfully in the following versions: | `quality` | A value in range `0.0` - `1.0` specifying compression level of the result image. `1` means no compression (highest quality) and `0` the highest compression (lowest quality)
**Default value**: `0.9` | number | no | All | yes | | `format` | The format of the resulting image.
**Default value**: based on the provided image;
if value determination is not possible, `'jpeg'` will be used as a fallback. | string | no | All | yes | -## 5. APIs +## 6. APIs > [!TIP] The **Platform** column indicates the platform where the properties are supported in the original third-party library. @@ -342,11 +352,11 @@ Verified successfully in the following versions: | ---- | ----------- | ---- | -------- | -------- | ------------------ | | cropImage | Crop the image specified by the URI param. If URI points to a remote image, it will be downloaded automatically. If the image cannot be loaded/downloaded, the promise will be rejected.

If the cropping process is successful, the resultant cropped image will be stored in the cache path, and the CropResult returned in the promise will point to the image in the cache path. ⚠️ Remember to delete the cropped image from the cache path when you are done with it. | function | yes | ios/Android | yes | -## 6. Known Issues +## 7. Known Issues -## 7. Others +## 8. Others -## 8. License +## 9. License This project is licensed under [The MIT License (MIT)](https://gitee.com/openharmony-sig/rntpc_react-native-image-editor/blob/master/LICENSE). diff --git a/en/react-native-image-marker.md b/en/react-native-image-marker.md index a5dde229..84254cc0 100644 --- a/en/react-native-image-marker.md +++ b/en/react-native-image-marker.md @@ -206,18 +206,23 @@ const styles = StyleSheet.create({ ## Use Codegen -Version >= @react-native-ohos/react-native-image-marker@1.2.7, 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-image-marker@1.2.7 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 Version | +|---------------------------|-----------------------|----------------------| +| ~1.3.0 | No | 0.77 | +| ~1.2.7 | Yes | 0.72 | +| <= 1.2.6-0.0.9@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 @@ -326,7 +331,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-image-picker.md b/en/react-native-image-picker.md index 82f27c67..7b7f0b23 100644 --- a/en/react-native-image-picker.md +++ b/en/react-native-image-picker.md @@ -85,12 +85,19 @@ export default App; ## Link -Version >= @react-native-ohos/react-native-image-picker@7.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 +| | Is supported autolink | Supported RN Version | +|---------------------------|-----------------------|----------------------| +| ~8.2.2 | No | 0.77 | +| ~7.0.4 | Yes | 0.72 | +| <= 7.0.3-0.1.8@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 @@ -212,7 +219,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-image-rotate.md b/en/react-native-image-rotate.md index 3efaf501..b1ac3f26 100644 --- a/en/react-native-image-rotate.md +++ b/en/react-native-image-rotate.md @@ -29,8 +29,6 @@ For older versions not published on npm, please refer to the [Installation Guide Go to the project directory and execute the following instruction: - - Go to the project directory and execute the following instruction: @@ -145,18 +143,23 @@ const styles = StyleSheet.create({ ## Use Codegen -Version >= @react-native-ohos/react-native-image-rotate@2.1.1, The codegen-lib has been adapted to generate 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-image-rotate@2.1.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 Version | +|---------------------------|-----------------------|----------------------| +| ~2.2.0 | No | 0.77 | +| ~2.1.1 | Yes | 0.72 | +| <= 2.1.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 @@ -280,7 +283,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-image-sequence-2.md b/en/react-native-image-sequence-2.md index fb166e10..820e29b9 100644 --- a/en/react-native-image-sequence-2.md +++ b/en/react-native-image-sequence-2.md @@ -278,19 +278,25 @@ export default TestDemo2 ## 2. Use Codegen -Version >= @react-native-ohos/react-native-image-sequence-2@0.9.2, compatible with codegen-lib for generating bridge 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). -If this repository has been adapted to `Codegen`, generate the bridge code of the third-party library by using the `Codegen`. For details, see [Codegen Usage Guide](/en/codegen.md). +## 3. Link -## 3. Manual Link +| | Is supported autolink | Supported RN Version | +|---------------------------|-----------------------|----------------------| +| ~0.10.0 | No | 0.77 | +| ~0.9.2 | Yes | 0.72 | +| <= 0.9.1-0.0.3@deprecated | No | 0.72 | -Version >= @react-native-ohos/react-native-image-sequence-2@0.9.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 +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. -### 3.1. Overrides RN SDK +### 3.1 Overrides RN SDK To ensure the project relies on the same version of the RN SDK, you need to add an `overrides` field in the project's root `oh-package.json5` file, specifying the RN SDK version to be used. The replacement version can be a specific version number, a semver range, or a locally available HAR package or source directory. @@ -306,7 +312,7 @@ For more information about the purpose of this field, please refer to the [offic } ``` -### 3.2. Introducing Native Code +### 3.2 Introducing Native Code Currently, two methods are available: @@ -340,7 +346,7 @@ Method 2: Directly link to the source code. > [!TIP]For details, see [Directly Linking Source Code](/en/link-source-code.md). -### 3.3. Configuring CMakeLists and Introducing ImageSequence2Package Package +### 3.3 Configuring CMakeLists and Introducing ImageSequence2Package Package > If you are using version <= 0.9.1-0.0.3, please skip this chapter. @@ -415,7 +421,9 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { } ``` -### 3.4. Running +
+ +## 4. Running Click the `sync` button in the upper right corner. @@ -428,9 +436,9 @@ ohpm install Then build and run the code. -## 4. Constraints +## 5. Constraints -### 4.1. Compatibility +### Compatibility 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. @@ -440,7 +448,7 @@ 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; -## 5. Properties +## 6. Properties > [!TIP] The **Platform** column indicates the platform where the properties are supported in the original third-party library. @@ -455,10 +463,10 @@ Verified in the following versions. | downsampleWidth | The width to use for optional downsampling. Both `downsampleWidth` and `downsampleHeight` must be set to a positive number to enable downsampling. Default: -1 | number | No | All | Yes | | downsampleHeight | The height to use for optional downsampling. Both `downsampleWidth` and `downsampleHeight` must be set to a positive number to enable downsampling. Default: -1 | number | No | All | Yes | -## 6. Known Issues +## 7. Known Issues -## 7. Others +## 8. Others -## 8. License +## 9. License This project is licensed under [The MIT License (MIT)](https://github.com/bwindsor/react-native-image-sequence/blob/aee3d372d7960234721e32d2b02432fb5d0fa98b/LICENSE), Please enjoy and participate freely in open source. diff --git a/en/react-native-inappbrowser.md b/en/react-native-inappbrowser.md index 37c9de7f..aff3304c 100644 --- a/en/react-native-inappbrowser.md +++ b/en/react-native-inappbrowser.md @@ -288,20 +288,27 @@ export const tryDeepLinking = async () => { ## Use Codegen -Version >= @react-native-ohos/react-native-inappbrowser@3.7.1，Adapted codegen-lib to generate 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-inappbrowser@3.7.1，Autolink is supported, no manual configuration is required(The content that still needs to be manually configured has been marked in the corresponding title), and currently only supports 72 frames. Autolink Framework Guidance Document：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md +| | Is supported autolink | Supported RN Version | +|---------------------------|-----------------------|----------------------| +| ~3.8.0 | No | 0.77 | +| ~3.7.1 | Yes | 0.72 | +| <= 3.7.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. -``` -Adding the overrides Field to 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 oh-package.json5 File in the Root Directory of the Project + +```json { ... "overrides": { @@ -310,7 +317,120 @@ Adding the overrides Field to oh-package.json5 File in the Root Directory of the } ``` -### 1. Configuring Entry(This module always requires manual configuration) +### 2. Introducing Native Code + +Currently, two methods are available: + +Method 1 (recommended): Use the HAR file. + +> [!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: + +```json +"dependencies": { + "@rnoh/react-native-openharmony": "file:../react_native_openharmony", + "@react-native-ohos/react-native-inappbrowser-reborn": "file:../../node_modules/@react-native-ohos/react-native-inappbrowser-reborn/harmony/inappbrowser.har" + } +``` + +Click the `sync` button in the upper right corner. + +Alternatively, run the following instruction on the terminal: + +``` +cd entry +ohpm install +``` + +Method 2: Directly link to the source code. + +> [!TIP] For details, see [Directly Linking Source Code](https://gitee.com/react-native-oh-library/usage-docs/blob/master/en/link-source-code.md). + +### 3.Configuring CMakeLists and Introducing InappbrowserRebornPackage + +> If you are using version <= 3.7.0-0.0.4, please skip this chapter. + +open `entry/src/main/cpp/CMakeLists.txt` and add: + +```cmake +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-inappbrowser-reborn/src/main/cpp" ./inappbrowser-reborn) +# 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_inappbrowser_reborn) +# RNOH_END: manual_package_linking_2 +``` + +open `entry/src/main/cpp/PackageProvider.cpp` and add: + +```c++ +#include "RNOH/PackageProvider.h" +#include "generated/RNOHGeneratedPackage.h" +#include "SamplePackage.h" ++ #include "InappbrowserRebornPackage.h" + +using namespace rnoh; + +std::vector> PackageProvider::getPackages(Package::Context ctx) { + return { + std::make_shared(ctx), + std::make_shared(ctx), ++ std::make_shared(ctx) + }; +} +``` + +### 4. Introducing RNInAppBrowserPackage to ArkTS + +Open the `entry/src/main/ets/RNPackagesFactory.ts` file and add the following code: + +```diff + ... ++ import { RNInAppBrowserPackage } from '@react-native-ohos/react-native-inappbrowser-reborn/ts'; + +export function createRNPackages(ctx: RNPackageContext): RNPackage[] { + return [ + new SamplePackage(ctx), ++ new RNInAppBrowserPackage(ctx), + ]; +} +``` + +
+ +## Necessary configuration items + +> [!TIP] The content of this module cannot be automatically generated by autolink and must always be manually configured. + +### Configuring Entry(This module always requires manual configuration) 1. Create **BrowserManagerAbility.ets** in **entry/src/main/ets/entryability**. @@ -422,114 +542,7 @@ export default class BrowserManagerAbility extends UIAbility { } ``` -### 2. Introducing Native Code - -Currently, two methods are available: - -Method 1 (recommended): Use the HAR file. - -> [!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: - -```json -"dependencies": { - "@rnoh/react-native-openharmony": "file:../react_native_openharmony", - "@react-native-ohos/react-native-inappbrowser-reborn": "file:../../node_modules/@react-native-ohos/react-native-inappbrowser-reborn/harmony/inappbrowser.har" - } -``` - -Click the `sync` button in the upper right corner. - -Alternatively, run the following instruction on the terminal: - -``` -cd entry -ohpm install -``` - -Method 2: Directly link to the source code. - -> [!TIP] For details, see [Directly Linking Source Code](https://gitee.com/react-native-oh-library/usage-docs/blob/master/en/link-source-code.md). - -### 3.Configuring CMakeLists and Introducing InappbrowserRebornPackage - -> If you are using version <= 3.7.0-0.0.4, please skip this chapter. - -open `entry/src/main/cpp/CMakeLists.txt` and add: - -```cmake -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-inappbrowser-reborn/src/main/cpp" ./inappbrowser-reborn) -# 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_inappbrowser_reborn) -# RNOH_END: manual_package_linking_2 -``` - -open `entry/src/main/cpp/PackageProvider.cpp` and add: - -```c++ -#include "RNOH/PackageProvider.h" -#include "generated/RNOHGeneratedPackage.h" -#include "SamplePackage.h" -+ #include "InappbrowserRebornPackage.h" - -using namespace rnoh; - -std::vector> PackageProvider::getPackages(Package::Context ctx) { - return { - std::make_shared(ctx), - std::make_shared(ctx), -+ std::make_shared(ctx) - }; -} -``` - -### 4. Introducing RNInAppBrowserPackage to ArkTS - -Open the `entry/src/main/ets/RNPackagesFactory.ts` file and add the following code: - -```diff - ... -+ import { RNInAppBrowserPackage } from '@react-native-ohos/react-native-inappbrowser-reborn/ts'; - -export function createRNPackages(ctx: RNPackageContext): RNPackage[] { - return [ - new SamplePackage(ctx), -+ new RNInAppBrowserPackage(ctx), - ]; -} -``` - -### 5. Running +## Running Click the `sync` button in the upper right corner. diff --git a/en/remobile-react-native-toast.md b/en/remobile-react-native-toast.md index baa2b4bb..f85af0cf 100644 --- a/en/remobile-react-native-toast.md +++ b/en/remobile-react-native-toast.md @@ -101,18 +101,23 @@ export default ToastMasterDemo; ## Use Codegen -Version >= @react-native-ohos/react-native-toast@1.0.8, 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-toast@1.0.8 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 Version | +|---------------------------|-----------------------|----------------------| +| ~1.1.0 | No | 0.77 | +| ~1.0.8 | Yes | 0.72 | +| <= 1.0.7-0.0.3@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 @@ -232,7 +237,9 @@ std::vector> PackageProvider::getPackages(Package::Cont } ``` -### 5. Running +
+ +## Running Click the `sync` button in the upper right corner. diff --git a/en/rn-bugly.md b/en/rn-bugly.md index fc65933d..da19f26f 100644 --- a/en/rn-bugly.md +++ b/en/rn-bugly.md @@ -105,10 +105,19 @@ export default class BuglyExample extends React.Component { ## Link -Version >= @react-native-ohos/rn-bugly@1.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 Version | +|----------------------------------|-----------------------|----------------------| +| ~1.4.0 | No | 0.77 | +| ~1.3.1 | Yes | 0.72 | +| <= 1.3.0-beta.3-0.0.1@deprecated | No | 0.72 | -Open the `harmony` directory of the HarmonyOS project in DevEco Studio. +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 + +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 @@ -229,7 +238,9 @@ 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-get-random-values.md b/zh-cn/react-native-get-random-values.md index 9bb52d61..f4c0c568 100644 --- a/zh-cn/react-native-get-random-values.md +++ b/zh-cn/react-native-get-random-values.md @@ -88,12 +88,19 @@ export const GetRandomValues = () => { ## Link -Version >= @react-native-ohos/react-native-get-random-values@1.11.1，已支持 Autolink，无需手动配置，目前只支持72框架。 -Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md +| | 是否支持autolink | RN框架版本 | +|----------------------------|-----------------|------------| +| ~1.12.0 | No | 0.77 | +| ~1.11.1 | Yes | 0.72 | +| <= 1.11.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 字段 @@ -215,8 +222,9 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { ]; } ``` +
-### 5.运行 +## 运行 点击右上角的 `sync` 按钮 diff --git a/zh-cn/react-native-haptic-feedback.md b/zh-cn/react-native-haptic-feedback.md index 7da2c987..ef5381e4 100644 --- a/zh-cn/react-native-haptic-feedback.md +++ b/zh-cn/react-native-haptic-feedback.md @@ -125,18 +125,23 @@ export default HapticFeedbackExample; ## 使用 Codegen -Version >= @react-native-ohos/react-native-haptic-feedback@2.2.2，已适配codegen-lib生成桥接代码。 - 本库已经适配了 `Codegen` ，在使用前需要主动执行生成三方库桥接代码，详细请参考[ Codegen 使用文档](/zh-cn/codegen.md)。 ## Link -Version >= @react-native-ohos/react-native-haptic-feedback@2.2.2，已支持 Autolink，无需手动配置，目前只支持72框架。 -Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md +| | 是否支持autolink | RN框架版本 | +|---------------------|-----------------|------------| +| ~2.3.4 | No | 0.77 | +| ~2.2.2 | Yes | 0.72 | +| <= 2.2.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 字段 @@ -258,8 +263,9 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { ] } ``` +
-### 5.运行 +## 运行 点击右上角的 `sync` 按钮 diff --git a/zh-cn/react-native-hole-view.md b/zh-cn/react-native-hole-view.md index 979c232d..29672b7b 100644 --- a/zh-cn/react-native-hole-view.md +++ b/zh-cn/react-native-hole-view.md @@ -12,8 +12,6 @@

- - > [!TIP] [Github 地址](https://github.com/react-native-oh-library/react-native-hole-view) ## 安装与使用 @@ -30,8 +28,6 @@ 进入到工程目录并输入以下命令： - - #### npm @@ -148,11 +144,19 @@ export default App; ## Link -Version >= @react-native-ohos/react-native-hole-view@3.0.1，已支持 Autolink，无需手动配置，目前只支持72框架。 Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md +| | 是否支持autolink | RN框架版本 | +|----------------------------------|-----------------|------------| +| ~3.1.0 | No | 0.77 | +| ~3.0.1 | Yes | 0.72 | +| <= 3.0.0-alpha4-0.0.5@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.json` 添加 overrides字段 @@ -273,8 +277,9 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { ]; } ``` +
-### 5.运行 +## 运行 点击右上角的 `sync` 按钮 diff --git a/zh-cn/react-native-http-bridge.md b/zh-cn/react-native-http-bridge.md index dfc645b1..662bdcdd 100644 --- a/zh-cn/react-native-http-bridge.md +++ b/zh-cn/react-native-http-bridge.md @@ -147,18 +147,23 @@ export default HttpBridgeDemo; ## 使用 Codegen -Version >= @react-native-ohos/react-native-http-bridge@0.6.2，已适配codegen-lib生成桥接代码。 - 本库已经适配了 `Codegen` ，在使用前需要主动执行生成三方库桥接代码，详细请参考[ Codegen 使用文档](/zh-cn/codegen.md)。 ## Link -Version >= @react-native-ohos/react-native-http-bridge@0.6.2，已支持 Autolink，无需手动配置，目前只支持72框架。 -Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md +| | 是否支持autolink | RN框架版本 | +|---------------------------|-----------------|------------| +| ~0.7.0 | No | 0.77 | +| ~0.6.2 | Yes | 0.72 | +| <= 0.6.1-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.json` 添加 overrides 字段 @@ -282,7 +287,9 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { } ``` -### 5.运行 +
+ +## 运行 点击右上角的 `sync` 按钮 diff --git a/zh-cn/react-native-idfa-aaid.md b/zh-cn/react-native-idfa-aaid.md index bff53f3c..7c06fcbd 100644 --- a/zh-cn/react-native-idfa-aaid.md +++ b/zh-cn/react-native-idfa-aaid.md @@ -178,18 +178,23 @@ export default App; ## 使用 Codegen -Version >= @react-native-ohos/react-native-idfa-aaid@1.2.1，已适配codegen-lib生成桥接代码。 - 本库已经适配了 `Codegen` ，在使用前需要主动执行生成三方库桥接代码，详细请参考[ Codegen 使用文档](/zh-cn/codegen.md)。 ## Link -Version >= @react-native-ohos/react-native-idfa-aaid@1.2.1，已支持 Autolink，无需手动配置，目前只支持72框架。 -Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md +| | 是否支持autolink | RN框架版本 | +|---------------------------|-----------------|------------| +| ~1.3.0 | No | 0.77 | +| ~1.2.1 | Yes | 0.72 | +| <= 1.2.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`。 ### 1.在工程根目录的 `oh-package.json5` 添加 overrides 字段 @@ -314,7 +319,9 @@ std::vector> PackageProvider::getPackages(Package::Cont } ``` -### 5.运行 +
+ +## 运行 点击右上角的 `sync` 按钮 diff --git a/zh-cn/react-native-idle-timer.md b/zh-cn/react-native-idle-timer.md index 3c3ee75f..49bb4b3c 100644 --- a/zh-cn/react-native-idle-timer.md +++ b/zh-cn/react-native-idle-timer.md @@ -78,18 +78,23 @@ export default IdleTimerExample; ## 使用 Codegen -Version >= @react-native-ohos/react-native-idle-timer@2.2.4，已适配codegen-lib生成桥接代码。 - 本库已经适配了 `Codegen` ，在使用前需要主动执行生成三方库桥接代码，详细请参考[ Codegen 使用文档](/zh-cn/codegen.md)。 ## Link -Version >= @react-native-ohos/react-native-idle-timer@2.2.4，已支持 Autolink，无需手动配置，目前只支持72框架。 -Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md +| | 是否支持autolink | RN框架版本 | +|---------------------------|-----------------|------------| +| ~2.3.0 | No | 0.77 | +| ~2.2.4 | Yes | 0.72 | +| <= 2.2.3-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 字段 @@ -216,7 +221,9 @@ std::vector> PackageProvider::getPackages(Package::Cont } ``` -### 5.运行 +
+ +## 运行 点击右上角的 `sync` 按钮 diff --git a/zh-cn/react-native-image-capinsets-next.md b/zh-cn/react-native-image-capinsets-next.md index 54a1a169..a5da2a12 100644 --- a/zh-cn/react-native-image-capinsets-next.md +++ b/zh-cn/react-native-image-capinsets-next.md @@ -128,17 +128,23 @@ export default YourImage; ## 使用 Codegen -Version >= @react-native-ohos/react-native-image-capinsets-next@0.6.2，已适配codegen-lib生成桥接代码。 - 本库已经适配了 `Codegen` ，在使用前需要主动执行生成三方库桥接代码，详细请参考[ Codegen 使用文档](/zh-cn/codegen.md)。 ## Link -Version >= @react-native-ohos/react-native-image-capinsets-next@0.6.2，已支持 Autolink，无需手动配置，目前只支持72框架。 Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md +| | 是否支持autolink | RN框架版本 | +|---------------------------|-----------------|------------| +| ~0.7.0 | No | 0.77 | +| ~0.6.2 | Yes | 0.72 | +| <= 0.6.1-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 字段 @@ -296,7 +302,9 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { } ``` -### 6.运行 +
+ +## 运行 点击右上角的 `sync` 按钮 diff --git a/zh-cn/react-native-image-colors.md b/zh-cn/react-native-image-colors.md index abfd4708..84e84612 100644 --- a/zh-cn/react-native-image-colors.md +++ b/zh-cn/react-native-image-colors.md @@ -205,18 +205,23 @@ const styles = StyleSheet.create({ ## 使用 Codegen -Version >= @react-native-ohos/react-native-image-colors@2.4.1，已适配codegen-lib生成桥接代码。 - 本库已经适配了 `Codegen` ，在使用前需要主动执行生成三方库桥接代码，详细请参考[ Codegen 使用文档](/zh-cn/codegen.md)。 ## Link -Version >= @react-native-ohos/react-native-image-colors@2.4.1，已支持 Autolink，无需手动配置，目前只支持72框架。 -Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md +| | 是否支持autolink | RN框架版本 | +|---------------------------|-----------------|------------| +| ~2.5.1 | No | 0.77 | +| ~2.4.1 | Yes | 0.72 | +| <= 2.4.0-0.0.7@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 字段 @@ -341,7 +346,9 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { } ``` -### 5.运行 +
+ +## 运行 点击右上角的 `sync` 按钮 diff --git a/zh-cn/react-native-image-crop-picker.md b/zh-cn/react-native-image-crop-picker.md index da3cc92b..1dd87a74 100644 --- a/zh-cn/react-native-image-crop-picker.md +++ b/zh-cn/react-native-image-crop-picker.md @@ -801,16 +801,23 @@ const styles = StyleSheet.create({ export default ImageCropPickDemo; ``` -## 2. Manual Link +## 2. Link -Version >= @react-native-ohos/react-native-image-crop-picker@0.40.5，已支持 Autolink，无需手动配置（仍需手动配置的内容已在对应标题处标记），目前只支持72框架。 -Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md +| | 是否支持autolink | RN框架版本 | +|-----------------------------|-----------------|------------| +| ~0.50.2 | No | 0.77 | +| ~0.40.5 | Yes | 0.72 | +| <= 0.40.3-0.0.14@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`。 -### 2.1. Overrides RN SDK +### 2.1 Overrides RN SDK 为了让工程依赖同一个版本的 RN SDK，需要在工程根目录的 `oh-package.json5` 添加 overrides 字段，指向工程需要使用的 RN SDK 版本。替换的版本既可以是一个具体的版本号，也可以是一个模糊版本，还可以是本地存在的 HAR 包或源码目录。 @@ -826,7 +833,7 @@ Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_nati } ``` -### 2.2. 引入原生端代码 +### 2.2 引入原生端代码 目前有两种方法： @@ -859,7 +866,7 @@ ohpm install > [!TIP] 如需使用直接链接源码，请参考[直接链接源码说明](https://gitee.com/react-native-oh-library/usage-docs/blob/master/zh-cn/link-source-code.md) -### 2.3. 配置 CMakeLists 和引入 ImageCropPickerPackage +### 2.3 配置 CMakeLists 和引入 ImageCropPickerPackage > 若使用的是 <= 0.40.3-0.0.14 版本，请跳过本章。 @@ -911,7 +918,7 @@ std::vector> PackageProvider::getPackages(Package::Cont } ``` -### 2.4. 在 ArkTs 侧引入 ImageCropPickerPackage +### 2.4 在 ArkTs 侧引入 ImageCropPickerPackage 打开 `entry/src/main/ets/RNPackagesFactory.ts`，添加： @@ -927,7 +934,13 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { } ``` -### 2.5. 配置Entry(该模块始终需要手动配置) +
+ +## 3. 必要的配置项 + +> [!TIP] 该模块的内容无法通过autolink自动生成，始终需要手动配置。 + +### 配置Entry(该模块始终需要手动配置) **(1)在 entry/src/main/ets/entryability 下修改 EntryAbility.ets** @@ -1109,7 +1122,7 @@ struct ImageEdit { } ``` -### 2.6. 运行 +## 4. 运行 点击右上角的 `sync` 按钮 @@ -1122,9 +1135,9 @@ ohpm install 然后编译、运行即可。 -## 3. 约束与限制 +## 5. 约束与限制 -### 3.1. 兼容性 +### 兼容性 要使用此库，需要使用正确的 React-Native 和 RNOH 版本。另外，还需要使用配套的 DevEco Studio 和 手机 ROM。 @@ -1134,7 +1147,7 @@ ohpm install 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; -## 4. API +## 6. API > [!TIP] "Platform"列表示该属性在原三方库上支持的平台。 @@ -1148,7 +1161,7 @@ ohpm install | cleanSingle | 删除单个缓存文件 | function | no | iOS/Android | yes | | openCamera | 从相机选择图片 | function | no | iOS/Android | yes | -## 5. 属性 +## 7. 属性 > [!TIP] "Platform"列表示该属性在原三方库上支持的平台。 @@ -1198,7 +1211,7 @@ ohpm install | cropperCancelColor (iOS only) | string (default tint `iOS` color ) | 默认值为 iOS 系统默认的 tint 颜色，[由 TOCropViewController 控制](https://gitee.com/link?target=https%3A%2F%2Fgithub.com%2FTimOliver%2FTOCropViewController%2Fblob%2Fa942414508012b13102f776eb65dac655f31cabb%2FObjective-C%2FTOCropViewController%2FViews%2FTOCropToolbar.m%23L433) | no | iOS | yes | | cropperRotateButtonsHidden (iOS only) | bool (default false) | 启用或禁用裁剪器的旋转按钮 | no | iOS | yes | -## 6. 遗留问题 +## 8. 遗留问题 - [ ] react-native-image-crop-picker 图像将始终填充蒙版空间 [#4](https://github.com/react-native-oh-library/react-native-image-crop-picker/issues/4) - [ ] Android Demo中 ActiveWidget 改变颜色 [#5](https://github.com/react-native-oh-library/react-native-image-crop-picker/issues/5) @@ -1217,8 +1230,8 @@ ohpm install - [ ] @ohos.multimedia.image无法进行圆形效果裁切 [#46](https://github.com/react-native-oh-library/react-native-image-crop-picker/issues/46) - [ ] @ohos.multimedia.image中PackingOption无法设置宽高属性 [#47](https://github.com/react-native-oh-library/react-native-image-crop-picker/issues/47) -## 7. 其他 +## 9. 其他 -## 8. 开源协议 +## 10. 开源协议 本项目基于 [The MIT License (MIT)](https://gitee.com/openharmony-sig/rntpc_react-native-image-crop-picker/blob/master/LICENSE) ，请自由地享受和参与开源。 diff --git a/zh-cn/react-native-image-editor.md b/zh-cn/react-native-image-editor.md index 296ec5ef..c88550da 100644 --- a/zh-cn/react-native-image-editor.md +++ b/zh-cn/react-native-image-editor.md @@ -185,11 +185,19 @@ const styles = StyleSheet.create({ }); ``` -## 2. Manual Link +## 2. Link -Version >= @react-native-ohos/image-editor@3.2.1，已支持 Autolink，无需手动配置，目前只支持72框架。 Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md +| | 是否支持autolink | RN框架版本 | +|------------------------------|-----------------|------------| +| ~4.3.1 | No | 0.77 | +| ~3.2.1 | Yes | 0.72 | +| <= 3.2.0-nc.0.1.3@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`。 @@ -291,7 +299,9 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { } ``` -### 2.5. 运行 +
+ +## 3. 运行 点击右上角的 `sync` 按钮 @@ -304,9 +314,9 @@ ohpm install 然后编译、运行即可。 -## 3. 约束与限制 +## 4. 约束与限制 -### 3.1. 兼容性 +### 兼容性 要使用此库，需要使用正确的 React-Native 和 RNOH 版本。另外，还需要使用配套的 DevEco Studio 和 手机 ROM。 @@ -316,7 +326,7 @@ ohpm install 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; -## 4. 属性 +## 5. 属性 > [!TIP] "Platform"列表示该属性在原三方库上支持的平台。 @@ -332,7 +342,7 @@ ohpm install | `quality` | A value in range `0.0` - `1.0` specifying compression level of the result image. `1` means no compression (highest quality) and `0` the highest compression (lowest quality)
**Default value**: `0.9` | number | no | All | yes | | `format` | The format of the resulting image.
**Default value**: based on the provided image;
if value determination is not possible, `'jpeg'` will be used as a fallback. | string | no | All | yes | -## 5. API +## 6. API > [!TIP] "Platform"列表示该属性在原三方库上支持的平台。 @@ -342,10 +352,10 @@ ohpm install | ---- | ----------- | ---- | -------- | -------- | ------------------ | | cropImage | Crop the image specified by the URI param. If URI points to a remote image, it will be downloaded automatically. If the image cannot be loaded/downloaded, the promise will be rejected.

If the cropping process is successful, the resultant cropped image will be stored in the cache path, and the CropResult returned in the promise will point to the image in the cache path. ⚠️ Remember to delete the cropped image from the cache path when you are done with it. | function | yes | ios/Android | yes | -## 6. 遗留问题 +## 7. 遗留问题 -## 7. 其他 +## 8. 其他 -## 8. 开源协议 +## 9. 开源协议 本项目基于 [The MIT License (MIT)](https://gitee.com/openharmony-sig/rntpc_react-native-image-editor/blob/master/LICENSE) ，请自由地享受和参与开源。 diff --git a/zh-cn/react-native-image-marker.md b/zh-cn/react-native-image-marker.md index eaab26f9..ca1bd30d 100644 --- a/zh-cn/react-native-image-marker.md +++ b/zh-cn/react-native-image-marker.md @@ -196,17 +196,23 @@ export const ImageMarkerText = () => { ## 使用 Codegen -Version >= @react-native-ohos/react-native-image-marker@1.2.7，已适配codegen-lib生成桥接代码。 - 本库已经适配了 `Codegen` ，在使用前需要主动执行生成三方库桥接代码，详细请参考[ Codegen 使用文档](/zh-cn/codegen.md)。 ## Link -Version >= @react-native-ohos/react-native-image-marker@1.2.7，已支持 Autolink，无需手动配置，目前只支持72框架。 Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md +| | 是否支持autolink | RN框架版本 | +|---------------------------|-----------------|------------| +| ~1.3.0 | No | 0.77 | +| ~1.2.7 | Yes | 0.72 | +| <= 1.2.6-0.0.9@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.json` 添加 overrides 字段 @@ -317,7 +323,9 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { } ``` -### 5.运行 +
+ +## 运行 点击右上角的 `sync` 按钮 diff --git a/zh-cn/react-native-image-picker.md b/zh-cn/react-native-image-picker.md index b97d6253..088b7919 100644 --- a/zh-cn/react-native-image-picker.md +++ b/zh-cn/react-native-image-picker.md @@ -83,11 +83,19 @@ export default App; ## Link -Version >= @react-native-ohos/react-native-image-picker@7.0.4，已支持 Autolink，无需手动配置，目前只支持72框架。 Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md +| | 是否支持autolink | RN框架版本 | +|---------------------------|-----------------|------------| +| ~8.2.2 | No | 0.77 | +| ~7.0.4 | Yes | 0.72 | +| <= 7.0.3-0.1.8@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 字段 @@ -211,7 +219,9 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { } ``` -### 5.运行 +
+ +## 运行 点击右上角的 `sync` 按钮 diff --git a/zh-cn/react-native-image-rotate.md b/zh-cn/react-native-image-rotate.md index bc5fba25..8ea13ae3 100644 --- a/zh-cn/react-native-image-rotate.md +++ b/zh-cn/react-native-image-rotate.md @@ -141,18 +141,23 @@ const styles = StyleSheet.create({ ## 使用 Codegen -Version >= @react-native-ohos/react-native-image-rotate@2.1.1，已适配codegen-lib生成桥接代码。 - 本库已经适配了 `Codegen` ，在使用前需要主动执行生成三方库桥接代码，详细请参考[ Codegen 使用文档](/zh-cn/codegen.md)。 ## Link -Version >= @react-native-ohos/react-native-image-rotate@2.1.1，已支持 Autolink，无需手动配置，目前只支持72框架。 -Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md +| | 是否支持autolink | RN框架版本 | +|---------------------------|-----------------|------------| +| ~2.2.0 | No | 0.77 | +| ~2.1.1 | Yes | 0.72 | +| <= 2.1.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`。 ### 1.在工程根目录的 `oh-package.json5` 添加 overrides 字段 @@ -276,7 +281,9 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { } ``` -### 5.运行 +
+ +## 运行 点击右上角的 `sync` 按钮 diff --git a/zh-cn/react-native-image-sequence-2.md b/zh-cn/react-native-image-sequence-2.md index 210d86d9..306d3ed2 100644 --- a/zh-cn/react-native-image-sequence-2.md +++ b/zh-cn/react-native-image-sequence-2.md @@ -279,21 +279,27 @@ export default TestDemo2 ## 2. 使用 Codegen -Version >= @react-native-ohos/react-native-image-sequence-2@0.9.2，已适配codegen-lib生成桥接代码。 - 本库已经适配了 `Codegen` ，在使用前需要主动执行生成三方库桥接代码，详细请参考[ Codegen 使用文档](/zh-cn/codegen.md)。 -## 3. Manual Link +## 3. Link + +| | 是否支持autolink | RN框架版本 | +|---------------------------|-----------------|------------| +| ~0.10.0 | No | 0.77 | +| ~0.9.2 | Yes | 0.72 | +| <= 0.9.1-0.0.3@deprecated | No | 0.72 | -Version >= @react-native-ohos/react-native-image-sequence-2@0.9.2，已支持 Autolink，无需手动配置，目前只支持72框架。 Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md +使用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`。 关于该字段的作用请阅读[官方说明](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/ide-oh-package-json5-V5#zh-cn_topic_0000001792256137_overrides) -### 3.1. Overrides RN SDK +### 3.1 Overrides RN SDK 为了让工程依赖同一个版本的 RN SDK，需要在工程根目录的 `harmony/oh-package.json5` 添加 overrides 字段，指向工程需要使用的 RN SDK 版本。替换的版本既可以是一个具体的版本号，也可以是一个模糊版本，还可以是本地存在的 HAR 包或源码目录。 @@ -309,7 +315,7 @@ Version >= @react-native-ohos/react-native-image-sequence-2@0.9.2，已支持 Au } ``` -### 3.2. 引入原生端代码 +### 3.2 引入原生端代码 目前有两种方法： @@ -342,7 +348,7 @@ ohpm install > [!TIP] 如需使用直接链接源码，请参考[直接链接源码说明](/zh-cn/link-source-code.md) -### 3.3. 配置 CMakeLists 和引入 ImageSequence2Package +### 3.3 配置 CMakeLists 和引入 ImageSequence2Package > 若使用的是 <= 0.9.1-0.0.3 版本，请跳过本章。 @@ -417,7 +423,9 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { } ``` -### 3.4. 运行 +
+ +## 4. 运行 点击右上角的 `sync` 按钮 @@ -430,9 +438,9 @@ ohpm install 然后编译、运行即可。 -## 4. 约束与限制 +## 5. 约束与限制 -### 4.1. 兼容性 +### 兼容性 要使用此库，需要使用正确的 React-Native 和 RNOH 版本。另外，还需要使用配套的 DevEco Studio 和 手机 ROM。 @@ -442,7 +450,7 @@ ohpm install 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; -## 5. 属性 +## 6. 属性 > [!TIP] "Platform"列表示该属性在原三方库上支持的平台。 @@ -457,10 +465,10 @@ ohpm install | downsampleWidth | 用于可选降采样的宽度。必须将`downsampleWidth`和`downsampleHeight`都设置为正数才能启用降采样。默认值: -1 | number | No | All | Yes | | downsampleHeight | 用于可选降采样的高度。必须将`downsampleWidth`和`downsampleHeight`都设置为正数才能启用降采样。默认值: -1 | number | No | All | Yes | -## 6. 遗留问题 +## 7. 遗留问题 -## 7. 其他 +## 8. 其他 -## 8. 开源协议 +## 9. 开源协议 本项目基于 [The MIT License (MIT)](https://github.com/bwindsor/react-native-image-sequence/blob/aee3d372d7960234721e32d2b02432fb5d0fa98b/LICENSE) ，请自由地享受和参与开源。 diff --git a/zh-cn/react-native-inappbrowser.md b/zh-cn/react-native-inappbrowser.md index bdd4068c..4a32a689 100644 --- a/zh-cn/react-native-inappbrowser.md +++ b/zh-cn/react-native-inappbrowser.md @@ -267,20 +267,27 @@ export const tryDeepLinking = async () => { ## 使用 Codegen -Version >= @react-native-ohos/react-native-inappbrowser@3.7.1，已适配codegen-lib生成桥接代码。 - 本库已经适配了 `Codegen` ，在使用前需要主动执行生成三方库桥接代码，详细请参考[ Codegen 使用文档](/zh-cn/codegen.md)。 ## Link -Version >= @react-native-ohos/react-native-inappbrowser@3.7.1，已支持 Autolink，无需手动配置（仍需手动配置的内容已在对应标题处标记），目前只支持72框架。 Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md +| | 是否支持autolink | RN框架版本 | +|---------------------------|-----------------|------------| +| ~3.8.0 | No | 0.77 | +| ~3.7.1 | Yes | 0.72 | +| <= 3.7.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: 此步骤为手动配置原生依赖项的指导 -``` -在工程根目录的 oh-package.json 添加 overrides字段 +首先需要使用 DevEco Studio 打开项目里的 HarmonyOS 工程 `harmony`。 + +### 1.在工程根目录的 `oh-package.json5` 添加 overrides字段 + +```json { ... "overrides": { @@ -289,7 +296,123 @@ Version >= @react-native-ohos/react-native-inappbrowser@3.7.1，已支持 Autoli } ``` -### 1.配置Entry(该模块始终需要手动配置) +### 2.引入原生端代码 + +目前有两种方法： + +1. 通过 har 包引入。 +2. 直接链接源码。 + +方法一：通过 har 包引入 (推荐) + +> [!TIP] har 包位于三方库安装路径的 `harmony` 文件夹下。 + +打开 `entry/oh-package.json5`，添加以下依赖 + +```json +"dependencies": { + "@rnoh/react-native-openharmony": "file:../react_native_openharmony", + "@react-native-ohos/react-native-inappbrowser-reborn": "file:../../node_modules/@react-native-ohos/react-native-inappbrowser-reborn/harmony/inappbrowser.har" + } +``` + +点击右上角的 `sync` 按钮 + +或者在终端执行： + +``` +cd entry +ohpm install +``` + +方法二：直接链接源码 + +> [!TIP] 如需使用直接链接源码，请参考[直接链接源码说明](https://gitee.com/react-native-oh-library/usage-docs/blob/master/zh-cn/link-source-code.md) + +### 3.配置CMakeLists 和引入 InappbrowserRebornPackage + +> 若使用的是 <= 3.7.0-0.0.4 版本，请跳过本章。 + +打开 `entry/src/main/cpp/CMakeLists.txt`，添加： + +```cmake +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-inappbrowser-reborn/src/main/cpp" ./inappbrowser-reborn) +# 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_inappbrowser_reborn) +# RNOH_END: manual_package_linking_2 +``` + +打开 `entry/src/main/cpp/PackageProvider.cpp`，添加： + +```c++ +#include "RNOH/PackageProvider.h" +#include "generated/RNOHGeneratedPackage.h" +#include "SamplePackage.h" ++ #include "InappbrowserRebornPackage.h" + +using namespace rnoh; + +std::vector> PackageProvider::getPackages(Package::Context ctx) { + return { + std::make_shared(ctx), + std::make_shared(ctx), ++ std::make_shared(ctx) + }; +} +``` + +### 4.在 ArkTs 侧引入 RNInAppBrowserPackage + +打开 `entry/src/main/ets/RNPackagesFactory.ts`，添加： + +```diff + ... ++ import { RNInAppBrowserPackage } from '@react-native-ohos/react-native-inappbrowser-reborn/ts'; + +export function createRNPackages(ctx: RNPackageContext): RNPackage[] { + return [ + new SamplePackage(ctx), ++ new RNInAppBrowserPackage(ctx), + ]; +} +``` + +
+ +## 必要的配置项 + +> [!TIP] 该模块的内容无法通过autolink自动生成，始终需要手动配置。 + +### 配置Entry(该模块始终需要手动配置) **1.在 entry/src/main/ets/entryability 下创建 BrowserManagerAbility.ets** @@ -401,117 +524,7 @@ export default class BrowserManagerAbility extends UIAbility { } ``` -### 2.引入原生端代码 - -目前有两种方法： - -1. 通过 har 包引入。 -2. 直接链接源码。 - -方法一：通过 har 包引入 (推荐) - -> [!TIP] har 包位于三方库安装路径的 `harmony` 文件夹下。 - -打开 `entry/oh-package.json5`，添加以下依赖 - -```json -"dependencies": { - "@rnoh/react-native-openharmony": "file:../react_native_openharmony", - "@react-native-ohos/react-native-inappbrowser-reborn": "file:../../node_modules/@react-native-ohos/react-native-inappbrowser-reborn/harmony/inappbrowser.har" - } -``` - -点击右上角的 `sync` 按钮 - -或者在终端执行： - -``` -cd entry -ohpm install -``` - -方法二：直接链接源码 - -> [!TIP] 如需使用直接链接源码，请参考[直接链接源码说明](https://gitee.com/react-native-oh-library/usage-docs/blob/master/zh-cn/link-source-code.md) - -### 3.配置CMakeLists 和引入 InappbrowserRebornPackage - -> 若使用的是 <= 3.7.0-0.0.4 版本，请跳过本章。 - -打开 `entry/src/main/cpp/CMakeLists.txt`，添加： - -```cmake -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-inappbrowser-reborn/src/main/cpp" ./inappbrowser-reborn) -# 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_inappbrowser_reborn) -# RNOH_END: manual_package_linking_2 -``` - -打开 `entry/src/main/cpp/PackageProvider.cpp`，添加： - -```c++ -#include "RNOH/PackageProvider.h" -#include "generated/RNOHGeneratedPackage.h" -#include "SamplePackage.h" -+ #include "InappbrowserRebornPackage.h" - -using namespace rnoh; - -std::vector> PackageProvider::getPackages(Package::Context ctx) { - return { - std::make_shared(ctx), - std::make_shared(ctx), -+ std::make_shared(ctx) - }; -} -``` - -### 4.在 ArkTs 侧引入 RNInAppBrowserPackage - -打开 `entry/src/main/ets/RNPackagesFactory.ts`，添加： - -```diff - ... -+ import { RNInAppBrowserPackage } from '@react-native-ohos/react-native-inappbrowser-reborn/ts'; - -export function createRNPackages(ctx: RNPackageContext): RNPackage[] { - return [ - new SamplePackage(ctx), -+ new RNInAppBrowserPackage(ctx), - ]; -} -``` - -### 5.运行 +## 运行 点击右上角的 `sync` 按钮 diff --git a/zh-cn/remobile-react-native-toast.md b/zh-cn/remobile-react-native-toast.md index 8d5d3c99..a9e4781a 100644 --- a/zh-cn/remobile-react-native-toast.md +++ b/zh-cn/remobile-react-native-toast.md @@ -102,18 +102,23 @@ export default ToastMasterDemo; ## 使用 Codegen -Version >= @react-native-ohos/react-native-toast@1.0.8，已适配codegen-lib生成桥接代码。 - 本库已经适配了 `Codegen` ，在使用前需要主动执行生成三方库桥接代码，详细请参考[ Codegen 使用文档](/zh-cn/codegen.md)。 ## Link -Version >= @react-native-ohos/react-native-toast@1.0.8，已支持 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.8 | Yes | 0.72 | +| <= 1.0.7-0.0.3@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字段 @@ -236,7 +241,9 @@ std::vector> PackageProvider::getPackages(Package::Cont } ``` -### 5.运行 +
+ +## 运行 点击右上角的 `sync` 按钮 diff --git a/zh-cn/rn-bugly.md b/zh-cn/rn-bugly.md index cd5f6332..b13b9f82 100644 --- a/zh-cn/rn-bugly.md +++ b/zh-cn/rn-bugly.md @@ -104,13 +104,22 @@ export default class BuglyExample extends React.Component { } } ``` + ## Link -Version >= @react-native-ohos/rn-bugly@1.3.1，已支持 Autolink，无需手动配置，目前只支持72框架。 Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md +| | 是否支持autolink | RN框架版本 | +|----------------------------------|-----------------|------------| +| ~1.4.0 | No | 0.77 | +| ~1.3.1 | Yes | 0.72 | +| <= 1.3.0-beta.3-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 字段 @@ -233,7 +242,9 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { } ``` -### 5.运行 +
+ +## 运行 点击右上角的 `sync` 按钮 -- Gitee