diff --git a/en/react-native-get-random-values.md b/en/react-native-get-random-values.md index 54d3348656920c6f67b5e08c634b0a60327d6400..bcb4cfc339518f29ce2d0965cd75f6618f63db99 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 8a6c5fe714768cfa5848048d3151ac1c16a93ced..b04f0609efd2fbd9cd0cae54c67dfe87fcbb3e31 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 f9c4d26c75e6a5bcd5b8f33165523c8509d44e90..a00cfadb3cbb17277e14644ba3aecfd8146bddcc 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 2852aac70ff2dca8ad029c7e5600ccf59132e304..f351406add779af266fa1c846cb63c9fc32f68f4 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 8a523488bd57e01cda0cf170cbdb996065262891..a53d98d7ed14b1b0b57ef69027f04f4fb7b245b0 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 1cdaefb49d2902b4ef6ca9aff16a38f95e26230f..5827b0ede9a84c92d53cd6ade0732a0ef851bf57 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 a911dabfbf4eca70801744d5c5540917708f3303..e69160478714693df8faa8cbdfac23f748ac26b2 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 956116e1e5ebf1589b4366ad33c13be40cc49aba..b2eea2b59e4a5f6708e19409b3647d56271dbdb4 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 ba03ee123065a7e80c20fbb0d05e15ac951a9f3c..9cd57d0608c24463f33d42f73de8b05158f8f6be 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 0f4259cdc0d3495ca53eb8250d0ef9732022f32c..e9b26cb5fcbd74725d158c8d5193f377714c37e6 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 a5dde229108a87c8d00bbb6067195f3427c52806..84254cc0bc3ce6cd4f416dc14c8b30e8f34533e2 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 82f27c67153eb85f416fbbbfe1513f3da29bda29..7b7f0b23e27a9329a0da2789326198edba2c331f 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 3efaf501277c2c8771611cfdafa7a9432a03c53b..b1ac3f269376ffa8d27ed5aac372bded39bd6367 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 fb166e10ec8f2ecf17c06d93e193649eb4571d60..820e29b95b261e468fbe9e8ddb00fed653f00bd6 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 37c9de7f30279bd568bc9de556ca606a3c82d18b..aff3304cb20f10551d03f77cc380f5021fe18d47 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 baa2b4bbfcab4d636b3e877347375b86fe075f5e..f85af0cf0264f9671963fd6b5e33829883c0a7a4 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 fc65933def077358b75a79fb3882dd8b8e56f1d8..da19f26f84eb0844cbaa4ef066ed90f50e60edd7 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 9bb52d6127b8d6996169ff54af3201e31837e02f..f4c0c568f6500ac7e7d594e8cd14da45273aea31 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 7da2c9876ff477c778dd7ad01823fbf0f3faae22..ef5381e4c41c92db0e53ce02dce3191cf77ccdd0 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 979c232dbb11bd5399a3e283ab0083b8664e1050..29672b7b34aa07efb51d0f77e349f6d967745e9e 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 dfc645b16aa661292b7944d633eb695319687a3d..662bdcddd90d45e8616b8f37137787ba27ca0b60 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 bff53f3c0d2adb5d7f7b7e018f0e08fc660bfab7..7c06fcbd7ed34efa80031426b807e279ef28940b 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 3c3ee75f1f8b7d5705498bda167a076a997843be..49bb4b3c306c2975ba4373a02e4726fdfb52dcf2 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 54a1a1691487ae44c11e1fec434c3e58a856ebc6..a5da2a12f5094e62024282301d0264c0a855518a 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 abfd470872102efbba838234059e25c862a9779e..84e84612f9a9e8251bd07f45202081ac9faeacce 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 da3cc92bdc0270846dfdd2a35fc28da85612d05c..1dd87a7466661b678d57b382d93c6993d23816d7 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 296ec5efe1382fb667c086abcb1e4ec81815bb73..c88550dace48f16a1bfaa184919c4f6a80b123a8 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 eaab26f973d837fc2a19de81cfb479f8874adfd3..ca1bd30daad4c6aa5efc26f1db002902a83db29b 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 b97d6253fa6517f437b137dc64e4661ba3be1b91..088b7919b819618e64803e3890bde34f1b391671 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 bc5fba252880672ea1d82e1d00efe3d92fabbd6f..8ea13ae3ee6848bc7dc3622c0fbebde5f7c5b6c2 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 210d86d9135d2b70368229e82c3f3f2fd49d7fe4..306d3ed2f422568adfd44b22dba38d3d121c7677 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 bdd4068c331385d511a8d2d4cb222fc46697ed7f..4a32a6897e47ed86d83672723da049b82010332e 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 8d5d3c99aaa5fa95658f017b439eaf12b5ffe57f..a9e4781af071172972abd26b690240bd3a237ce1 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 cd5f6332ac623fc2ae662eff2f94c80d60ec1bbe..b13b9f82584851adabe9d01a421e704a42b7d0d5 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` 按钮