diff --git a/en/react-native-apple-authentication.md b/en/react-native-apple-authentication.md index fcbb63c5378d4c961fc2af9b47a34c13352479f8..a11b5a0b51fe95dfb2773ccb5549397b505c23bf 100644 --- a/en/react-native-apple-authentication.md +++ b/en/react-native-apple-authentication.md @@ -252,6 +252,12 @@ Please refer to the Releases page of the third-party library for the correspondi | 2.3.1 | [@react-native-ohos/react-native-apple-authentication Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-apple-authentication/releases) | 0.72 | | 2.4.2 | [@react-native-ohos/react-native-apple-authentication Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-apple-authentication/releases) | 0.77 | +This document is verified based on the following versions: + +1. RNOH: 0.72.27; SDK: HarmonyOS-Next-DB1 5.0.0.29(SP1); IDE: DevEco Studio 5.0.3.403; ROM: 3.0.0.25; +2. RNOH：0.72.33; SDK：OpenHarmony 5.0.0.71(API Version 12 Release); IDE：DevEco Studio 5.0.3.900; ROM：NEXT.0.0.71; +3. RNOH：0.77.18; SDK：HarmonyOS 5.1.1 Release; IDE: DevEco Studio 5.1.1.830; ROM：NEXT 5.1.0.150; + ## Properties > [!TIP] The **Platform** column indicates the platform where the properties are supported in the original third-party library. diff --git a/en/react-native-ble-manager.md b/en/react-native-ble-manager.md index 57941ea6af7c56ff526624f24c46394aa050c6cd..7e4bab0b3547abc44f3e7e6af0364b58ebbda8e5 100644 --- a/en/react-native-ble-manager.md +++ b/en/react-native-ble-manager.md @@ -17,7 +17,11 @@ ## Installation and Usage -Find the matching version information in the release address of a third-party library: [@react-native-oh-tpl/react-native-ble-manager Releases](https://github.com/react-native-oh-library/react-native-ble-manager/releases).For older versions that are not published to npm, please refer to the [installation guide](/en/tgz-usage-en.md) to install the tgz package. +Please refer to the Releases page of the third-party library for the corresponding version information: +| Third-party Library Version | Release Information | Supported RN Version | +| ---------- | ------------------------------------------------------------ | ---------- | +| 11.5.2 | [@react-native-oh-tpl/react-native-ble-manager Releases](https://github.com/react-native-oh-library/react-native-ble-manager/releases) | 0.72 | +| 12.1.5 | [@react-native-ohos/react-native-ble-manager Releases]() | 0.77 | Go to the project directory and execute the following instruction: @@ -520,6 +524,12 @@ Then build and run the code. ## Constraints +This document is verified based on the following versions: + +1. RNOH: 0.72.27; SDK: HarmonyOS-Next-DB1 5.0.0.29(SP1); IDE: DevEco Studio 5.0.3.403; ROM: 3.0.0.25; +2. RNOH：0.72.33; SDK：OpenHarmony 5.0.0.71(API Version 12 Release); IDE：DevEco Studio 5.0.3.900; ROM：NEXT.0.0.71; +3. RNOH：0.77.18; SDK：HarmonyOS 5.1.1 Release; IDE: DevEco Studio 5.1.1.830; ROM：NEXT 5.1.0.150; + ### 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. diff --git a/en/react-native-echarts-pro.md b/en/react-native-echarts-pro.md index 64cb9e3b81fb7a3f62e84e628757cbb918f37904..9cf5a29412c4b82e2f22b8e4a1aef36f41f2b422 100644 --- a/en/react-native-echarts-pro.md +++ b/en/react-native-echarts-pro.md @@ -13,9 +13,12 @@ ## Installation and Usage -Go to the project directory and execute the following instruction: - +Please refer to the Releases page of the third-party library for the corresponding version information: +| Third-party Library Version | Release Information | Supported RN Version | +| ---------- | ------------------------------------------------------------ | ---------- | +| 1.9.1 | [react-native-echarts-pro Releases](https://github.com/supervons/react-native-echarts-pro) | 0.72 | +| 1.9.3 | [react-native-echarts-pro Releases](https://github.com/supervons/react-native-echarts-pro) | 0.77 | @@ -90,7 +93,10 @@ If not introduced, please refer to the Link section of the document [@react-nati This document is verified based on the following versions: -1. RNOH: 0.72.20; SDK: HarmonyOS NEXT Developer Beta1; IDE: DevEco Studio 5.0.3.200; ROM: 205.0.0.18 +1. RNOH: 0.72.27; SDK: HarmonyOS-Next-DB1 5.0.0.29(SP1); IDE: DevEco Studio 5.0.3.403; ROM: 3.0.0.25; +2. RNOH：0.72.33; SDK：OpenHarmony 5.0.0.71(API Version 12 Release); IDE：DevEco Studio 5.0.3.900; ROM：NEXT.0.0.71; +3. RNOH：0.77.18; SDK：HarmonyOS 5.1.1 Release; IDE: DevEco Studio 5.1.1.830; ROM：NEXT 5.1.0.150; + ## Properties diff --git a/en/react-native-maps.md b/en/react-native-maps.md index 2649a1a90f9a10f053ae0418b82e210a2ea9589d..6e39fc60df27f901d98c7ae107d5e67e839b1824 100644 --- a/en/react-native-maps.md +++ b/en/react-native-maps.md @@ -18,6 +18,13 @@ Find the matching version information in the release address of a third-party library: [@react-native-oh-tpl/react-native-maps Releases](https://github.com/react-native-oh-library/react-native-maps/releases).For older versions that are not published to npm, please refer to the [installation guide](/en/tgz-usage-en.md) to install the tgz package. +请到三方库的 Releases 发布地址查看配套的版本信息： + +| Third-party Library Version | Release Information | Supported RN Version| +| ---------- | ------------------------------------------------------------ | ---------- | +| 1.10.3 | [@react-native-oh-tpl/react-native-maps Releases](https://github.com/react-native-oh-library/react-native-maps/releases) | 0.72 | +| 1.24.4 | [@react-native-ohos/react-native-maps Releases]() | 0.77 | + Go to the project directory and execute the following instruction: @@ -456,6 +463,12 @@ To use this repository, you need to use the correct React-Native and RNOH versio Check the release version information in the release address of the third-party library: [react-natvie-maps Releases](https://github.com/react-native-oh-library/react-native-maps/releases) +This document is verified based on the following versions: + +1. RNOH: 0.72.27; SDK: HarmonyOS-Next-DB1 5.0.0.29(SP1); IDE: DevEco Studio 5.0.3.403; ROM: 3.0.0.25; +2. RNOH：0.72.33; SDK：OpenHarmony 5.0.0.71(API Version 12 Release); IDE：DevEco Studio 5.0.3.900; ROM：NEXT.0.0.71; +3. RNOH：0.77.18; SDK：HarmonyOS 5.1.1 Release; IDE: DevEco Studio 5.1.1.830; ROM：NEXT 5.1.0.150; + ### Permission Requirements > [!TIP] If you want to use HUAWEI Maps in a self-built project, skip the first step and go to the [HUAWEI Developers](https://developer.huawei.com/consumer/cn/wiki/index.php) platform to apply for the corresponding project and application. diff --git a/en/react-native-reanimated-carousel.md b/en/react-native-reanimated-carousel.md index f4f79176bd5181c00d7fb9ad7fa1b580aef1b62b..644d494627b6a3d90b51bbbab0ed36ff50a9830a 100644 --- a/en/react-native-reanimated-carousel.md +++ b/en/react-native-reanimated-carousel.md @@ -16,6 +16,11 @@ ## Installation and Usage +| Third-party Library Version | Release Information | Supported RN Version | +| ---------- | ------------------------------------------------------------ | ---------- | +| 3.5.1 | [@react-native-ohos/react-native-reanimated-carousel Releases]| 0.72 | +| 4.0.2 | [@react-native-ohos/react-native-reanimated-carousel Releases]| 0.77 | + Go to the project directory and execute the following instruction: @@ -186,7 +191,9 @@ If it is not included, follow the guide provided in [@react-native-oh-tpl/react- This document is verified based on the following versions: -1. RNOH: 0.72.29; SDK: HarmonyOS-Next-DB6 5.0.0.61; IDE: DevEco Studio 5.0.3.706; ROM: NEXT.0.0.61; +1. RNOH: 0.72.27; SDK: HarmonyOS-Next-DB1 5.0.0.29(SP1); IDE: DevEco Studio 5.0.3.403; ROM: 3.0.0.25; +2. RNOH：0.72.33; SDK：OpenHarmony 5.0.0.71(API Version 12 Release); IDE：DevEco Studio 5.0.3.900; ROM：NEXT.0.0.71; +3. RNOH：0.77.18; SDK：HarmonyOS 5.1.1 Release; IDE: DevEco Studio 5.1.1.830; ROM：NEXT 5.1.0.150; ## Properties diff --git a/en/react-native-sensors.md b/en/react-native-sensors.md index 3faa43dbfb121951ea79a9df6e07886307f7861b..c064fcb684be13692847c513500df3eeeb76f4d8 100644 --- a/en/react-native-sensors.md +++ b/en/react-native-sensors.md @@ -8,10 +8,11 @@ This project is based on [react-native-sensors@7.2.1-rc.2](https://github.com/re This third-party library has been migrated to Gitee and is now available for direct download from npm, the new package name is: `@react-native-ohos/react-native-sensors`, The version correspondence details are as follows: -| Version | Package Name | Repository | Release | -| ------------------------------ | ---------------------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ | -| <= 7.2.1-rc.2-0.0.1@deprecated | @react-native-oh-library/react-native-sensors | [Github(deprecated)](https://github.com/react-native-oh-library/react-native-sensors) | [Github Releases(deprecated)](https://github.com/react-native-oh-library/react-native-sensors/releases) | -| > 7.2.1 | @react-native-ohos/react-native-sensors | [GitCode](https://gitcode.com/openharmony-sig/rntpc_react-native-sensors) | [GitCode Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-sensors/releases) | +| Third-party Library Version | Release Information | Supported RN Version | +| ---------- | ------------------------------------------------------------ | ---------- | +| 7.2.1@deprecated | [@react-native-oh-library/react-native-sensors Releases(deprecated)](https://github.com/react-native-oh-library/react-native-sensors/releases) | 0.72 | +| 7.2.3 | [@react-native-ohos/react-native-sensors Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-sensors/releases) | 0.72 | +| 7.3.7 | [@react-native-ohos/react-native-sensors Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-sensors/releases) | 0.77 | ## Installation and Usage @@ -138,6 +139,9 @@ export default App; ## 2. Manual Link +Version >= @react-native-ohos/react-native-sensors@7.2.3 now supports Autolink without requiring manual configuration, currently only supports 72 frameworks. +Autolink Framework Guide Documentation: https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md + This step provides guidance for manually configuring native dependencies. Open the `harmony` directory of the HarmonyOS project in DevEco Studio. @@ -230,7 +234,7 @@ Open the `entry/src/main/ets/RNPackagesFactory.ts` file and add the following co ```diff ... -+ import {SensorsPackage} from '@react-native-oh-tpl/react-native-sensors/ts'; ++ import {SensorsPackage} from '@react-native-ohos/react-native-sensors/ts'; export function createRNPackages(ctx: RNPackageContext): RNPackage[] { return [ @@ -257,7 +261,10 @@ Then build and run the code. ### 3.1 Compatibility -Check the release version information in the release address of the third-party library:[@react-native-ohos/react-native-sensors Releases](https://gitee.com/openharmony-sig/rntpc_react-native-sensors/releases) +To use this repository, you need to use the correct React-Native and RNOH versions. In addition, you need to use DevEco Studio and the ROM on your phone. + +1. RNOH：0.72.96; SDK：HarmonyOS 5.1.0.150 (API Version 12); IDE：DevEco Studio 5.1.1.830; ROM：5.1.0.150; +2. RNOH：0.77.18; SDK：HarmonyOS 5.1.0.150 (API Version 12); IDE：DevEco Studio 5.1.1.830; ROM：5.1.0.150; ### 3.2 Permission Requirements (If Any) @@ -289,4 +296,4 @@ gyroscope Required permissions: ohos.permission.GYROSCOPE ## 6. License -This project is licensed under [The MIT License (MIT)](https://github.com/react-native-sensors/react-native-sensors/blob/master/LICENSE), Please enjoy and participate freely in open source. +This project is licensed under [The MIT License (MIT)](https://github.com/react-native-sensors/react-native-sensors/blob/master/LICENSE), Please enjoy and participate freely in open source. \ No newline at end of file diff --git a/en/react-native-splash-screen.md b/en/react-native-splash-screen.md index 894811604ef2af2aa32d02e8cdd79f59c08842ca..b1f230ae6b2369d40e21dc1ee49e034948ed142b 100644 --- a/en/react-native-splash-screen.md +++ b/en/react-native-splash-screen.md @@ -6,14 +6,17 @@ This project is based on [react-native-splash-screen@3.3.0](https://github.com/crazycodeboy/react-native-splash-screen/tree/v3.3.0). -This third-party library has been migrated to GitCode and is now available for direct download from npm, the new package name is: `@react-native-ohos/react-native-splash-screen`, The version correspondence details are as follows: +## 1. Installation and Usage -| Version | Package Name | Repository | Release | -|---------------------------| ------------------------------------------------- |---------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------| -| <= 3.3.0-0.0.2@deprecated | @react-native-oh-tpl/react-native-splash-screen | [Github(deprecated)](https://github.com/react-native-oh-library/react-native-splash-screen) | [Github Releases(deprecated)](https://github.com/react-native-oh-library/react-native-splash-screen/releases) | -| > 3.3.0 | @react-native-ohos/react-native-splash-screen | [GitCode](https://gitcode.com/openharmony-sig/rntpc_react-native-splash-screen) | [GitCode Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-splash-screen/releases) | +Please refer to the Releases page of the third-party library for the corresponding version information -## 1. Installation and Usage +| Third-party Library Version | Release Information | Supported RN Version | +|-----------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------| ---------- | +| 3.3.0@deprecated | [@react-native-oh-tpl/react-native-splash-screen Releases(deprecated)](https://github.com/react-native-oh-library/react-native-splash-screen/releases) | 0.72 | +| 3.3.1 | [@react-native-ohos/react-native-splash-screen Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-splash-screen/releases) | 0.72 | +| 3.4.0 | [@react-native-ohos/react-native-splash-screen Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-splash-screen/releases) | 0.77 | + +For older versions not published on npm, please refer to the [Installation Guide](/zh-cn/tgz-usage.md) to install the tgz package. Go to the project directory and execute the following instruction: @@ -90,13 +93,21 @@ export default class WelcomePage extends Component { } ``` -## 2. Manual Link +## 2. Use Codegen + +Version >= @react-native-ohos/react-native-splash-screen@3.3.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). + +## 3. Manual Link + +Version >= @react-native-ohos/react-native-splash-screen@3.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 This step provides guidance for manually configuring native dependencies. Open the `harmony` directory of the HarmonyOS project in DevEco Studio. -### 2.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. @@ -112,7 +123,7 @@ For more information about the purpose of this field, please refer to the [offic } ``` -### 2.2. Introducing Native Code +### 3.2. Introducing Native Code Currently, two methods are available: @@ -144,11 +155,12 @@ Method 2: Directly link to the source code. > [!TIP] For details, see [Directly Linking Source Code](/en/link-source-code.md). -### 2.3. Configuring CMakeLists and Introducing SplashScreenPackage +### 3.3. Configuring CMakeLists and Introducing SplashScreenPackage Open `entry/src/main/cpp/CMakeLists.txt` and add the following code: ```diff + ... + set(OH_MODULES "${CMAKE_CURRENT_SOURCE_DIR}/../../../oh_modules") # RNOH_BEGIN: manual_package_linking_1 @@ -177,7 +189,7 @@ std::vector> PackageProvider::getPackages(Package::Cont } ``` -### 2.4. Introducing SplashScreenPackage to ArkTS +### 3.4. Introducing SplashScreenPackage to ArkTS Open the `entry/src/main/ets/RNPackagesFactory.ts` file and add the following code: @@ -193,7 +205,7 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { } ``` -### 2.5. Running +### 3.5. Running Click the `sync` button in the upper right corner. @@ -206,7 +218,6 @@ ohpm install Then build and run the code. - The following code demonstrates the basic usage scenario of this library: ```jsx @@ -236,13 +247,18 @@ export default App; ``` -## 3. Constraints +## 4. Constraints + +### 4.1. 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. -### 3.1. Compatibility +The following combinations have been verified: -Check the release version information in the release address of the third-party library: [@react-native-ohos/react-native-splash-screen Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-splash-screen/releases) +1. RNOH：0.72.96; SDK：HarmonyOS 5.1.0.150 (API Version 12); IDE：DevEco Studio 5.1.1.830; ROM：5.1.0.150; +2. RNOH：0.77.18; SDK：HarmonyOS 5.1.0.150 (API Version 12); IDE：DevEco Studio 5.1.1.830; ROM：5.1.0.150; -## 4. API +## 5. API > [!TIP] The **Platform** column indicates the platform where the properties are supported in the original third-party library. @@ -266,13 +282,13 @@ Check the release version information in the release address of the third-party | backgroundColor | 启动页背景色 | string | | pageUrl | 首页路由 | bool | -## 5. Known Issues +## 6. Known Issues -## 6. Others +## 7. Others - In iOS, the working principle of the show() method is as follows: In the entry application method, the home page of the App is first loaded, and then a while loop is used to keep the interface on the App's splash screen. During this time, the home page still loads asynchronously. Once the loading is complete, stopping the while loop will hide the splash screen and display the home page. In HarmonyOS, the home page is loaded by calling windowStage.loadContent in the entry onWindowStageCreate method. If a while loop is used at this point, the home page cannot be loaded asynchronously. -## 7.License +## 8. License This project is licensed under [The MIT License (MIT)](https://github.com/crazycodeboy/react-native-splash-screen/blob/v3.3.0/LICENSE). \ No newline at end of file diff --git a/zh-cn/react-native-apple-authentication.md b/zh-cn/react-native-apple-authentication.md index 72549e75f9f50747720424faa92b8142a3381c03..af5949af39b19adc86e143d4a1c488a846646681 100644 --- a/zh-cn/react-native-apple-authentication.md +++ b/zh-cn/react-native-apple-authentication.md @@ -251,6 +251,12 @@ ohpm install | 2.3.1 | [@react-native-ohos/react-native-apple-authentication Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-apple-authentication/releases) | 0.72 | | 2.4.2 | [@react-native-ohos/react-native-apple-authentication Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-apple-authentication/releases) | 0.77 | +本文档内容基于以下版本验证通过： + +1. RNOH: 0.72.27; SDK: HarmonyOS-Next-DB1 5.0.0.29(SP1); IDE: DevEco Studio 5.0.3.403; ROM: 3.0.0.25; +2. RNOH：0.72.33; SDK：OpenHarmony 5.0.0.71(API Version 12 Release); IDE：DevEco Studio 5.0.3.900; ROM：NEXT.0.0.71; +3. RNOH：0.77.18; SDK：HarmonyOS 5.1.1 Release; IDE: DevEco Studio 5.1.1.830; ROM：NEXT 5.1.0.150; + ## 属性 > [!TIP] "Platform"列表示该属性在原三方库上支持的平台。 diff --git a/zh-cn/react-native-ble-manager.md b/zh-cn/react-native-ble-manager.md index 77732bf229d2258c1948eee7675b36ae4cc83f2b..f927da3091fb26451076bff5e0f515e97340e41e 100644 --- a/zh-cn/react-native-ble-manager.md +++ b/zh-cn/react-native-ble-manager.md @@ -19,7 +19,14 @@ ## 安装与使用 -请到三方库的 Releases 发布地址查看配套的版本信息：[@react-native-oh-tpl/react-native-ble-manager Releases](https://github.com/react-native-oh-library/react-native-ble-manager/releases) 。对于未发布到npm的旧版本，请参考[安装指南](/zh-cn/tgz-usage.md)安装tgz包。 +请到三方库的 Releases 发布地址查看配套的版本信息： + +| 三方库版本 | 发布信息 | 支持RN版本 | +| ---------- | ------------------------------------------------------------ | ---------- | +| 11.5.2 | [@react-native-oh-tpl/react-native-ble-manager Releases](https://github.com/react-native-oh-library/react-native-ble-manager/releases) | 0.72 | +| 12.1.5 | [@react-native-ohos/react-native-ble-manager Releases]() | 0.77 | + +对于未发布到npm的旧版本，请参考[安装指南](/zh-cn/tgz-usage.md)安装tgz包。 进入到工程目录并输入以下命令： @@ -527,7 +534,19 @@ ohpm install 要使用此库，需要使用正确的 React-Native 和 RNOH 版本。另外，还需要使用配套的 DevEco Studio 和 手机 ROM。 -请到三方库相应的 Releases 发布地址查看 Release 配套的版本信息：[@react-native-oh-tpl/react-native-ble-manager Releases](https://github.com/react-native-oh-library/react-native-ble-manager/releases) + +请到三方库相应的 Releases 发布地址查看 Release 配套的版本信息： + +| 三方库版本 | 发布信息 | 支持RN版本 | +| ---------- | ------------------------------------------------------------ | ---------- | +| 11.5.2 | [@react-native-oh-tpl/react-native-ble-manager Releases](https://github.com/react-native-oh-library/react-native-ble-manager/releases) | 0.72 | +| 12.1.5 | [@react-native-ohos/react-native-ble-manager Releases]() | 0.77 | + +本文档内容基于以下版本验证通过： + +1. RNOH: 0.72.27; SDK: HarmonyOS-Next-DB1 5.0.0.29(SP1); IDE: DevEco Studio 5.0.3.403; ROM: 3.0.0.25; +2. RNOH：0.72.33; SDK：OpenHarmony 5.0.0.71(API Version 12 Release); IDE：DevEco Studio 5.0.3.900; ROM：NEXT.0.0.71; +3. RNOH：0.77.18; SDK：HarmonyOS 5.1.1 Release; IDE: DevEco Studio 5.1.1.830; ROM：NEXT 5.1.0.150; ### 权限要求 diff --git a/zh-cn/react-native-echarts-pro.md b/zh-cn/react-native-echarts-pro.md index 71e0101e8085bcd4a3a93c66594ea550bd87ba68..c6a436cca1d2cba50083e5c82e40317690ed8aaa 100644 --- a/zh-cn/react-native-echarts-pro.md +++ b/zh-cn/react-native-echarts-pro.md @@ -15,8 +15,8 @@ | 三方库版本 | 发布信息 | 支持RN版本 | | ---------- | ------------------------------------------------------------ | ---------- | -| 1.9.1 | [@react-native-ohos/react-native-echarts-pro Releases](https://github.com/supervons/react-native-echarts-pro) | 0.72 | -| 1.9.3 | [@react-native-ohos/react-native-echarts-pro Releases](https://github.com/supervons/react-native-echarts-pro) | 0.77 | +| 1.9.1 | [react-native-echarts-pro Releases](https://github.com/supervons/react-native-echarts-pro) | 0.72 | +| 1.9.3 | [react-native-echarts-pro Releases](https://github.com/supervons/react-native-echarts-pro) | 0.77 | 进入到工程目录并输入以下命令： @@ -103,7 +103,9 @@ export default function RNEPDemo() { 本文档内容基于以下版本验证通过： -1. RNOH：0.72.20; SDK：HarmonyOS NEXT Developer Beta1; IDE：DevEco Studio 5.0.3.200; ROM：205.0.0.18; +1. RNOH: 0.72.27; SDK: HarmonyOS-Next-DB1 5.0.0.29(SP1); IDE: DevEco Studio 5.0.3.403; ROM: 3.0.0.25; +2. RNOH：0.72.33; SDK：OpenHarmony 5.0.0.71(API Version 12 Release); IDE：DevEco Studio 5.0.3.900; ROM：NEXT.0.0.71; +3. RNOH：0.77.18; SDK：HarmonyOS 5.1.1 Release; IDE: DevEco Studio 5.1.1.830; ROM：NEXT 5.1.0.150; ## 属性 diff --git a/zh-cn/react-native-maps.md b/zh-cn/react-native-maps.md index 54d81d24a6c0046f632a67f28e857315f03459ef..de4ca7518006ea2f8cd975f29e07ab34d7fb2b86 100644 --- a/zh-cn/react-native-maps.md +++ b/zh-cn/react-native-maps.md @@ -16,7 +16,12 @@ ## 安装与使用 -请到三方库的 Releases 发布地址查看配套的版本信息：[@react-native-oh-tpl/react-native-maps Releases](https://github.com/react-native-oh-library/react-native-maps/releases) 。对于未发布到npm的旧版本，请参考[安装指南](/zh-cn/tgz-usage.md)安装tgz包。 +请到三方库的 Releases 发布地址查看配套的版本信息： + +| 三方库版本 | 发布信息 | 支持RN版本 | +| ---------- | ------------------------------------------------------------ | ---------- | +| 1.10.3 | [@react-native-oh-tpl/react-native-maps Releases](https://github.com/react-native-oh-library/react-native-maps/releases) | 0.72 | +| 1.24.4 | [@react-native-ohos/react-native-maps Releases]() | 0.77 | 进入到工程目录并输入以下命令： @@ -456,6 +461,12 @@ ohpm install 请到三方库相应的 Releases 发布地址查看 Release 配套的版本信息：[react-natvie-maps Releases](https://github.com/react-native-oh-library/react-native-maps/releases) +本文档内容基于以下版本验证通过： + +1. RNOH: 0.72.27; SDK: HarmonyOS-Next-DB1 5.0.0.29(SP1); IDE: DevEco Studio 5.0.3.403; ROM: 3.0.0.25; +2. RNOH：0.72.33; SDK：OpenHarmony 5.0.0.71(API Version 12 Release); IDE：DevEco Studio 5.0.3.900; ROM：NEXT.0.0.71; +3. RNOH：0.77.18; SDK：HarmonyOS 5.1.1 Release; IDE: DevEco Studio 5.1.1.830; ROM：NEXT 5.1.0.150; + ### 权限要求 > [!TIP] 如需自建项目使用华为地图可以跳过以下第一步，并前往[华为开发者联盟](https://developer.huawei.com/consumer/cn/wiki/index.php)平台申请对应项目和应用程序 diff --git a/zh-cn/react-native-reanimated-carousel.md b/zh-cn/react-native-reanimated-carousel.md index d24c5550a9ce44124a181044c7f12060cdb85684..0a2d1fc7710ad05e1e76b9f16783aeb971482fc6 100644 --- a/zh-cn/react-native-reanimated-carousel.md +++ b/zh-cn/react-native-reanimated-carousel.md @@ -199,7 +199,9 @@ const styles = StyleSheet.create({ 本文档内容基于以下版本验证通过： -1. RNOH: 0.72.29; SDK: HarmonyOS-Next-DB6 5.0.0.61; IDE: DevEco Studio 5.0.3.706; ROM: NEXT.0.0.61; +1. RNOH: 0.72.27; SDK: HarmonyOS-Next-DB1 5.0.0.29(SP1); IDE: DevEco Studio 5.0.3.403; ROM: 3.0.0.25; +2. RNOH：0.72.33; SDK：OpenHarmony 5.0.0.71(API Version 12 Release); IDE：DevEco Studio 5.0.3.900; ROM：NEXT.0.0.71; +3. RNOH：0.77.18; SDK：HarmonyOS 5.1.1 Release; IDE: DevEco Studio 5.1.1.830; ROM：NEXT 5.1.0.150; ## 属性 diff --git a/zh-cn/react-native-sensors.md b/zh-cn/react-native-sensors.md index 8af4ffa85561c99f1add68e833620d82aa24391c..bd8825d251686604c3b513698709b49003842767 100644 --- a/zh-cn/react-native-sensors.md +++ b/zh-cn/react-native-sensors.md @@ -8,10 +8,11 @@ 该第三方库的仓库已迁移至 Gitee，且支持直接从 npm 下载，新的包名为：`@react-native-ohos/react-native-sensors`，具体版本所属关系如下： -| Version | Package Name | Repository | Release | -| ------------------------------ | --------------------------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ | -| <= 7.2.1-rc.2-0.0.1@deprecated | @react-native-oh-library/react-native-sensors | [Github(deprecated)](https://github.com/react-native-oh-library/react-native-sensors) | [Github Releases(deprecated)](https://github.com/react-native-oh-library/react-native-sensors/releases) | -| > 7.2.1 | @react-native-ohos/react-native-sensors | [GitCode](https://gitcode.com/openharmony-sig/rntpc_react-native-sensors) | [GitCode Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-sensors/releases) | +| 三方库版本 | 发布信息 | 支持RN版本 | +| ---------- | ------------------------------------------------------------ | ---------- | +| 7.2.1@deprecated | [@react-native-oh-library/react-native-sensors Releases(deprecated)](https://github.com/react-native-oh-library/react-native-sensors/releases) | 0.72 | +| 7.2.3 | [@react-native-ohos/react-native-sensors Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-sensors/releases) | 0.72 | +| 7.3.7 | [@react-native-ohos/react-native-sensors Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-sensors/releases) | 0.77 | ## 1. 安装与使用 @@ -137,6 +138,8 @@ export default App; ## 2. Manual Link +Version >= @react-native-ohos/react-native-sensors@7.2.3，已支持 Autolink，无需手动配置，目前只支持72框架。 Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md + 此步骤为手动配置原生依赖项的指导。 首先需要使用 DevEco Studio 打开项目里的 HarmonyOS 工程 `harmony`。 @@ -229,7 +232,7 @@ std::vector> PackageProvider::getPackages(Package::Cont ```diff ... -+ import {SensorsPackage} from '@react-native-oh-tpl/react-native-sensors/ts'; ++ import {SensorsPackage} from '@react-native-ohos/react-native-sensors/ts'; export function createRNPackages(ctx: RNPackageContext): RNPackage[] { return [ @@ -256,7 +259,10 @@ ohpm install ### 3.1 兼容性 -请到三方库相应的 Releases 发布地址查看 Release 配套的版本信息：[@react-native-ohos/react-native-sensors Releases](https://gitee.com/openharmony-sig/rntpc_react-native-sensors/releases) +要使用此库，需要使用正确的 React-Native 和 RNOH 版本。另外，还需要使用配套的 DevEco Studio 和 手机 ROM。 + +1. RNOH：0.72.96; SDK：HarmonyOS 5.1.0.150 (API Version 12); IDE：DevEco Studio 5.1.1.830; ROM：5.1.0.150; +2. RNOH：0.77.18; SDK：HarmonyOS 5.1.0.150 (API Version 12); IDE：DevEco Studio 5.1.1.830; ROM：5.1.0.150; ### 3.2 权限要求 @@ -287,4 +293,4 @@ gyroscope 需要的权限：ohos.permission.GYROSCOPE ## 6. 开源协议 -本项目基于 [The MIT License (MIT)](https://github.com/react-native-sensors/react-native-sensors/blob/master/LICENSE) ，请自由地享受和参与开源。 +本项目基于 [The MIT License (MIT)](https://github.com/react-native-sensors/react-native-sensors/blob/master/LICENSE) ，请自由地享受和参与开源。 \ No newline at end of file diff --git a/zh-cn/react-native-splash-screen.md b/zh-cn/react-native-splash-screen.md index 7bed05c0d11b2c0b7759a5e0b885f90f2e366280..1aed8eca78c167b40926183d310912ed2311f9bf 100644 --- a/zh-cn/react-native-splash-screen.md +++ b/zh-cn/react-native-splash-screen.md @@ -6,14 +6,17 @@ 本项目基于 [react-native-splash-screen@3.3.0](https://github.com/crazycodeboy/react-native-splash-screen/tree/v3.3.0) 开发。 -该第三方库的仓库已迁移至 GitCode，且支持直接从 npm 下载，新的包名为：`@react-native-ohos/react-native-splash-screen`，具体版本所属关系如下： +## 1. 安装与使用 -| Version | Package Name | Repository | Release | -|---------------------------| ------------------------------------------------- |---------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------| -| <= 3.3.0-0.0.2@deprecated | @react-native-oh-tpl/react-native-splash-screen | [Github(deprecated)](https://github.com/react-native-oh-library/react-native-splash-screen) | [Github Releases(deprecated)](https://github.com/react-native-oh-library/react-native-splash-screen/releases) | -| > 3.3.0 | @react-native-ohos/react-native-splash-screen | [GitCode](https://gitcode.com/openharmony-sig/rntpc_react-native-splash-screen) | [GitCode Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-splash-screen/releases) | +请到三方库的 Releases 发布地址查看配套的版本信息： -## 1. 安装与使用 +| 三方库版本 | 发布信息 | 支持RN版本 | +|------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------| ---------- | +| 3.3.0@deprecated | [@react-native-oh-tpl/react-native-splash-screen Releases(deprecated)](https://github.com/react-native-oh-library/react-native-splash-screen/releases) | 0.72 | +| 3.3.1 | [@react-native-ohos/react-native-splash-screen Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-splash-screen/releases) | 0.72 | +| 3.4.0 | [@react-native-ohos/react-native-splash-screen Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-splash-screen/releases) | 0.77 | + +对于未发布到npm的旧版本，请参考[安装指南](/zh-cn/tgz-usage.md)安装tgz包。 进入到工程目录并输入以下命令： @@ -90,17 +93,25 @@ export default class WelcomePage extends Component { } ``` -## 2. Manual Link +## 2. 使用 Codegen + +Version >= @react-native-ohos/react-native-splash-screen@3.3.1，已适配codegen-lib生成桥接代码。 + +本库已经适配了 `Codegen` ，在使用前需要主动执行生成三方库桥接代码，详细请参考[ Codegen 使用文档](/zh-cn/codegen.md)。 + +## 3. Manual Link + +Version >= @react-native-ohos/react-native-splash-screen@3.3.1，已支持 Autolink，无需手动配置，目前只支持72框架。 Autolink框架指导文档：https://gitcode.com/openharmony-sig/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md 此步骤为手动配置原生依赖项的指导。 首先需要使用 DevEco Studio 打开项目里的 HarmonyOS 工程 `harmony`。 -### 2.1. Overrides RN SDK +### 3.1. Overrides RN SDK 为了让工程依赖同一个版本的 RN SDK，需要在工程根目录的 `oh-package.json5` 添加 overrides 字段，指向工程需要使用的 RN SDK 版本。替换的版本既可以是一个具体的版本号，也可以是一个模糊版本，还可以是本地存在的 HAR 包或源码目录。 -关于该字段的作用请阅读[官方说明](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/ide-oh-package-json5-V5#zh-cn_topic_0000001792256137_overrides) +为了让工程依赖同一个版本的 RN SDK，需要在工程根目录的 `oh-package.json5` 添加 overrides 字段，指向工程需要使用的 RN SDK 版本。替换的版本既可以是一个具体的版本号，也可以是一个模糊版本，还可以是本地存在的 HAR 包或源码目录。 ```json { @@ -112,7 +123,7 @@ export default class WelcomePage extends Component { } ``` -### 2.2. 引入原生端代码 +### 3.2. 引入原生端代码 目前有两种方法： @@ -144,9 +155,10 @@ ohpm install > [!TIP] 如需使用直接链接源码，请参考[直接链接源码说明](/zh-cn/link-source-code.md) > -### 2.3. 配置 CMakeLists 和引入 SplashScreenPackage +### 3.3. 配置 CMakeLists 和引入 SplashScreenPackage 打开 entry/src/main/cpp/CMakeLists.txt，添加： + ```diff ... + set(OH_MODULES "${CMAKE_CURRENT_SOURCE_DIR}/../../../oh_modules") @@ -158,7 +170,6 @@ ohpm install # RNOH_BEGIN: manual_package_linking_2 + target_link_libraries(rnoh_app PUBLIC rnoh_splash_screen) # RNOH_END: manual_package_linking_2 - ``` 打开 entry/src/main/cpp/PackageProvider.cpp，添加： @@ -178,7 +189,7 @@ std::vector> PackageProvider::getPackages(Package::Cont } ``` -### 2.4. 在 ArkTs 侧引入 SplashScreenPackage +### 3.4. 在 ArkTs 侧引入 SplashScreenPackage 打开 `entry/src/main/ets/RNPackagesFactory.ts`，添加： @@ -194,7 +205,7 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { } ``` -### 2.5. 运行 +### 3.5. 运行 点击右上角的 `sync` 按钮 @@ -236,16 +247,18 @@ export default App; ``` -## 3. 约束与限制 +## 4. 约束与限制 -### 3.1. 兼容性 +### 4.1. 兼容性 要使用此库，需要使用正确的 React-Native 和 RNOH 版本。另外，还需要使用配套的 DevEco Studio 和 手机 ROM。 -请到三方库相应的 Releases 发布地址查看 Release 配套的版本信息：[@react-native-ohos/react-native-splash-screen Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-splash-screen/releases) +在以下版本验证通过： +1. RNOH：0.72.96; SDK：HarmonyOS 5.1.0.150 (API Version 12); IDE：DevEco Studio 5.1.1.830; ROM：5.1.0.150; +2. RNOH：0.77.18; SDK：HarmonyOS 5.1.0.150 (API Version 12); IDE：DevEco Studio 5.1.1.830; ROM：5.1.0.150; -## 4. API +## 5. API > [!TIP] "Platform"列表示该属性在原三方库上支持的平台。 @@ -269,13 +282,13 @@ export default App; | backgroundColor | 启动页背景色 | string | | pageUrl | 首页路由 | bool | -## 5. 遗留问题 +## 6. 遗留问题 -## 6. 其他 +## 7. 其他 - 在 iOS 中，show() 方法的工作原理是： 在入口 application 方法中，首先加载 App 首页，然后使用 while 循环让界面停留在 App 启动屏，此时首页仍然会异步加载，加载完成后，停止 while 循环即可隐藏启动屏，显示首页。 HarmonyOS 中，在入口 onWindowStageCreate 中调用 windowStage.loadContent 加载首页，如果此时使用 while 循环，首页无法异步加载。 -## 7. 开源协议 +## 8. 开源协议 本项目基于 [The MIT License (MIT)](https://github.com/crazycodeboy/react-native-splash-screen/blob/v3.3.0/LICENSE) ，请自由地享受和参与开源。 \ No newline at end of file