From 2313caed2b996e95bcff4574bdd39292f01b4bfe Mon Sep 17 00:00:00 2001
From: dujing
Date: Tue, 25 Nov 2025 16:56:48 +0800
Subject: [PATCH 1/6] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0victory-native-xl?=
=?UTF-8?q?=E3=80=81react-native-sticky-parallax-header=E3=80=81react-nati?=
=?UTF-8?q?ve-progress=E3=80=81Parse-Sdk-Js=E3=80=81react-native-text-grad?=
=?UTF-8?q?ient=E6=8C=87=E5=AF=BC=E6=96=87=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Signed-off-by: dujing
---
en/jpush-react-native.md | 100 ++++++++++++++++++++++++++++-------
en/react-native-base64.md | 30 ++++++-----
en/rn-placeholder.md | 28 ++++++----
zh-cn/jpush-react-native.md | 100 +++++++++++++++++++++++++++++------
zh-cn/react-native-base64.md | 38 +++++++------
zh-cn/rn-placeholder.md | 69 +++++++++++++-----------
6 files changed, 261 insertions(+), 104 deletions(-)
diff --git a/en/jpush-react-native.md b/en/jpush-react-native.md
index 14d6996b..efbc881b 100644
--- a/en/jpush-react-native.md
+++ b/en/jpush-react-native.md
@@ -1,24 +1,19 @@
-> Template version: v0.2.2
+> Template version: v0.3.0
jpush-react-native
-
-
-
-
-
-
-
-
-> [!TIP] [GitHub address](https://github.com/react-native-oh-library/jpush-react-native)
+This project is based on [jpush-react-native@3.1.1](https://github.com/react-native-oh-library/jpush-react-native).
+Please go to the corresponding Release release address of the third-party library to view the version information of the Release package:
+| Version | Package Name | Repository | Release | RN Version |
+| ------------------------------ | ---------------------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ |------------|
+| 3.1.1 | @react-native-oh-library/jpush-react-native Releases | [Github(deprecated)](https://github.com/react-native-oh-library/jpush-react-native/releases) | [Github Releases](https://github.com/react-native-oh-library/jpush-react-native/releases) | 0.72 |
+| 3.2.0 | @react-native-ohos/jpush-react-native Releases | [GitCode](https://gitcode.com/openharmony-sig/rntpc_jpush-react-native) | [GitCode Releases](https://gitcode.com/openharmony-sig/jpush-react-native/releases) | 0.77 |
## Installation and Usage
-Find the matching version information in the release address of a third-party library:[@react-native-oh-tpl/jpush-react-native Releases](https://github.com/react-native-oh-library/jpush-react-native/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.
-
Go to the project directory and execute the following instruction:
@@ -26,13 +21,21 @@ Go to the project directory and execute the following instruction:
#### **npm**
```bash
+# 0.72
npm install @react-native-oh-tpl/jpush-react-native
+
+# 0.77
+npm install @react-native-ohos/jpush-react-native
```
#### **yarn**
```bash
+# 0.72
yarn add @react-native-oh-tpl/jpush-react-native
+
+# 0.77
+yarn add @react-native-ohos/jpush-react-native
```
@@ -82,6 +85,8 @@ export default App;
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).
+**Note:** V3.1.8 and above do not require codegen.
+
## Link
Currently, HarmonyOS does not support AutoLink. Therefore, you need to manually configure the linking.
@@ -109,8 +114,9 @@ Method 1 (recommended): Use the HAR file.
Open `entry/oh-package.json5` file and add the following dependencies:
-```json
+- V0.72
+```json
"dependencies": {
"@rnoh/react-native-openharmony": "file:../react_native_openharmony",
"@react-native-oh-tpl/jpush-react-native": "file:../../node_modules/@react-native-oh-tpl/jpush-react-native/harmony/jpush_react_native.har"
@@ -118,6 +124,15 @@ Open `entry/oh-package.json5` file and add the following dependencies:
```
+- V0.77
+
+```json
+"dependencies": {
+ "@rnoh/react-native-openharmony": "file:../react_native_openharmony",
+ "@react-native-ohos/jpush-react-native": "file:../../node_modules/@react-native-ohos/jpush-react-native/harmony/jpush_react_native.har"
+}
+```
+
Click the `sync` button in the upper right corner.
Alternatively, run the following instruction on the terminal:
@@ -132,7 +147,54 @@ Method 2: Directly link to the source code.
> [!TIP] For details, see [Directly Linking Source Code](/en/link-source-code.md).
-### 3. Introducing RNJPushPackage to ArkTS
+### 3. Configure CMakeLists and import RNJPushPackage
+
+> V3.2.0 requires configuring CMakeLists and importing RNJPushPackage.
+
+```diff
+...
+
+project(rnapp)
+cmake_minimum_required(VERSION 3.4.1)
+set(RNOH_APP_DIR "${CMAKE_CURRENT_SOURCE_DIR}")
++ set(OH_MODULES "${CMAKE_CURRENT_SOURCE_DIR}/../../../oh_modules")
+set(RNOH_CPP_DIR "${CMAKE_CURRENT_SOURCE_DIR}/../../../../../../react-native-harmony/harmony/cpp")
+
+add_subdirectory("${RNOH_CPP_DIR}" ./rn)
+
+# RNOH_END: manual_package_linking_1
+add_subdirectory("../../../../sample_package/src/main/cpp" ./sample-package)
++ add_subdirectory("${OH_MODULES}/@react-native-ohos/jpush-react-native/src/main/cpp" ./jPushModule)
+# RNOH_END: manual_package_linking_1
+
+add_library(rnoh_app SHARED
+ "./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_jPushModule)
+# RNOH_BEGIN: manual_package_linking_2
+```
+
+Open `entry/src/main/cpp/PackageProvider.cpp`,and add:
+
+```diff
+#include "RNOH/PackageProvider.h"
++ #include "JPushModulePackage.h"
+
+using namespace rnoh;
+
+std::vector> PackageProvider::getPackages(Package::Context ctx) {
+ return {
++ std::make_shared(ctx)
+}
+```
+
+### 4. Introducing RNJPushPackage to ArkTS
Open the `entry/src/main/ets/RNPackagesFactory.ts` file and add the following code:
@@ -147,7 +209,7 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] {
}
```
-### 4. Running
+### 5. Running
Click the `sync` button in the upper right corner.
@@ -167,7 +229,9 @@ Then build and run the code.
To use this repository, you need to use the correct React-Native and RNOH versions. In addition, you need to use DevEco Studio and the ROM on your phone.
-Check the release version information in the release address of the third-party library: [@react-native-oh-tpl/jpush-react-native Releases](https://github.com/react-native-oh-library/jpush-react-native/releases)
+Check the release version information in the release address of the third-party library:
+1. 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;
+2. RNOH:0.77.1;SDK:HarmonyOS 5.0.0.71(API Version 12 Release) ;IDE:DevEco Studio:5.1.1.830; ROM: HarmonyOS 5.1.0.150;
## Static Methods
@@ -228,10 +292,10 @@ Check the release version information in the release address of the third-party
| setSmartPushEnable(enable:boolean):void | Enable or disable intelligent push. |function | no | iOS,Android | no |
| setGeofenceEnable(enable:boolean):void | Enable or disable geofencing. |function | no |Android | no |
| setCollectControl(enable:boolean):void | Enable or disable centralized control. |function | no | iOS、Android | no |
-
+| setDataInsightsEnable()3.1.8+ | Set up Application Data Insights |function | no | Android | no |
## Known Issues
- [ ] setProperties、deleteProperties、cleanProperties、pageEnterTo、pageLeave、initCrashHandler、setMaxGeofenceNumber、deleteGeofence、addNotificationListener、addInappMessageListener,setCollectControl、setSmartPushEnable These methods are currently not supported in the Aurora Push HarmonyOS SDK[issue#1](https://github.com/react-native-oh-library/jpush-react-native/issues/1)
-
+- [ ] V3.1.8 and above some properties have not been adapted for HarmonyOS [issue#1](https://gitcode.com/openharmony-sig/rntpc_jpush-react-native/issues/1)
## Others
diff --git a/en/react-native-base64.md b/en/react-native-base64.md
index 32051bc1..f249cce4 100644
--- a/en/react-native-base64.md
+++ b/en/react-native-base64.md
@@ -1,18 +1,16 @@
-> Template version: v0.2.2
+> Template version: v0.3.0
react-native-base64
-
-
-
-
-
-
-
-
-> [!TIP] [GitHub address](https://github.com/eranbo/react-native-base64/tree/0.2.1)
+Please go to the corresponding Release release address of the third-party library to view the version information of the Release package:
+
+| Version | RN Version |
+| ---------- | ---------- |
+| 0.2.1 | 0.72 |
+| 0.2.2 | 0.77 |
+
## Installation and Usage
@@ -23,13 +21,21 @@ Go to the project directory and execute the following instruction:
#### **npm**
```bash
-npm i react-native-base64@0.2.1
+# v0.2.1
+npm install react-native-base64@0.2.1
+
+# v0.2.2
+npm install react-native-base64@0.2.2
```
#### **yarn**
```bash
+# v0.2.1
yarn add react-native-base64@0.2.1
+
+# v0.2.2
+yarn add react-native-base64@0.2.2
```
@@ -109,7 +115,7 @@ This document is verified based on the following versions:
1. RNOH: 0.72.29; SDK:HarmonyOS-Next-DB1 5.0.0.61; IDE:DevEco Studio 5.0.3.706; ROM:5.0.0.61;
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.1; SDK:HarmonyOS 5.0.0.71(API Version 12 Release) ;IDE:DevEco Studio:5.1.1.830; ROM: HarmonyOS 5.1.0.150;
## Static Methods
> [!TIP] The **Platform** column indicates the platform where the properties are supported in the original third-party library.
diff --git a/en/rn-placeholder.md b/en/rn-placeholder.md
index d072643e..df790df8 100644
--- a/en/rn-placeholder.md
+++ b/en/rn-placeholder.md
@@ -1,18 +1,15 @@
-> Template version: v0.2.2
+> Template version: v0.3.0
rn-placeholder
-
-
-
-
-
-
-
-
-> [!TIP] [GitHub address](https://github.com/react-native-oh-library/rn-placeholder)
+Please go to the corresponding Release release address of the third-party library to view the version information of the Release package:
+
+| Version | Support RN version |
+| ----------| ---------- |
+| 3.0.4 | 0.72 |
+| 3.0.3 | 0.77 |
## Installation and Usage
@@ -23,13 +20,21 @@ Go to the project directory and execute the following instruction:
#### **npm**
```bash
+# v0.72
+npm install rn-placeholder@3.0.4 --legacy-peer-deps
+
+# v 0.77
npm install rn-placeholder@3.0.3 --legacy-peer-deps
```
#### **yarn**
```bash
-yarn add rn-placeholder@3.0.3 --legacy-peer-deps
+# v 0.72
+yarn add rn-placeholder@3.0.4 --legacy-peer-deps
+
+# v 0.77
+yarn add rn-placeholder@3.0.3 --legacy-peer-deps
```
@@ -67,6 +72,7 @@ export default App;
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.400; ROM:3.0.0.25;
+2. RNOH: 0.77.1;SDK:HarmonyOS 5.1.1.208 (API Version 19 Release) ;IDE:DevEco Studio:5.1.1.830; ROM: HarmonyOS 6.0.0.112 SP12;
## Properties
diff --git a/zh-cn/jpush-react-native.md b/zh-cn/jpush-react-native.md
index 97e5c6d9..4441dfb6 100644
--- a/zh-cn/jpush-react-native.md
+++ b/zh-cn/jpush-react-native.md
@@ -1,23 +1,19 @@
-> 模板版本:v0.2.2
+> 模板版本:v0.3.0
jpush-react-native
-
-
-
-
-
-
-
-
-> [!TIP] [Github 地址](https://github.com/react-native-oh-library/jpush-react-native)
+本项目基于 [jpush-react-native@3.1.1](https://github.com/react-native-oh-library/jpush-react-native) 开发。
+请到三方库的 Releases 发布地址查看配套的版本信息:
+| Version | Package Name | Repository | Release | RN Version |
+| ------------------------------ | ---------------------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ |------------|
+| 3.1.1 | @react-native-oh-library/jpush-react-native Releases | [Github(deprecated)](https://github.com/react-native-oh-library/jpush-react-native/releases) | [Github Releases](https://github.com/react-native-oh-library/jpush-react-native/releases) | 0.72 |
+| 3.2.0 | @react-native-ohos/jpush-react-native Releases | [GitCode](https://gitcode.com/openharmony-sig/rntpc_jpush-react-native) | [GitCode Releases](https://gitcode.com/openharmony-sig/jpush-react-native/releases) | 0.77 |
-## 安装与使用
-请到三方库的 Releases 发布地址查看配套的版本信息:[@react-native-oh-tpl/jpush-react-native Releases](https://github.com/react-native-oh-library/jpush-react-native/releases) 。对于未发布到npm的旧版本,请参考[安装指南](/zh-cn/tgz-usage.md)安装tgz包。
+## 安装与使用
进入到工程目录并输入以下命令:
@@ -25,13 +21,21 @@
#### **npm**
```bash
+# 0.72
npm install @react-native-oh-tpl/jpush-react-native
+
+# 0.77
+npm install @react-native-ohos/jpush-react-native
```
#### **yarn**
```bash
+# 0.72
yarn add @react-native-oh-tpl/jpush-react-native
+
+# 0.77
+yarn add @react-native-ohos/jpush-react-native
```
@@ -81,6 +85,8 @@ export default App;
本库已经适配了 `Codegen` ,在使用前需要主动执行生成三方库桥接代码,详细请参考[ Codegen 使用文档](https://gitee.com/react-native-oh-library/usage-docs/blob/master/zh-cn/codegen.md)。
+**注意:** V3.1.8及以上不需要codegen。
+
## Link
目前 HarmonyOS 暂不支持 AutoLink,所以 Link 步骤需要手动配置。
@@ -112,13 +118,22 @@ export default App;
打开 `entry/oh-package.json5`,添加以下依赖
-```json
+- V0.72
+```json
"dependencies": {
"@rnoh/react-native-openharmony": "file:../react_native_openharmony",
"@react-native-oh-tpl/jpush-react-native": "file:../../node_modules/@react-native-oh-tpl/jpush-react-native/harmony/jpush_react_native.har"
}
+```
+
+- V0.77
+```json
+"dependencies": {
+ "@rnoh/react-native-openharmony": "file:../react_native_openharmony",
+ "@react-native-ohos/jpush-react-native": "file:../../node_modules/@react-native-ohos/jpush-react-native/harmony/jpush_react_native.har"
+}
```
点击右上角的 `sync` 按钮
@@ -134,14 +149,64 @@ ohpm install
> [!TIP] 如需使用直接链接源码,请参考[直接链接源码说明](/zh-cn/link-source-code.md)
+### 3. 配置 CMakeLists 和引入 RNJPushPackage
-### 3. 在 ArkTs 侧引入 RNJPushPackage
+> V3.2.0 需要配置 CMakeLists 和引入 RNJPushPackage。
+
+```diff
+...
+
+project(rnapp)
+cmake_minimum_required(VERSION 3.4.1)
+set(RNOH_APP_DIR "${CMAKE_CURRENT_SOURCE_DIR}")
++ set(OH_MODULES "${CMAKE_CURRENT_SOURCE_DIR}/../../../oh_modules")
+set(RNOH_CPP_DIR "${CMAKE_CURRENT_SOURCE_DIR}/../../../../../../react-native-harmony/harmony/cpp")
+
+add_subdirectory("${RNOH_CPP_DIR}" ./rn)
+
+# RNOH_END: manual_package_linking_1
+add_subdirectory("../../../../sample_package/src/main/cpp" ./sample-package)
++ add_subdirectory("${OH_MODULES}/@react-native-ohos/jpush-react-native/src/main/cpp" ./jPushModule)
+# RNOH_END: manual_package_linking_1
+
+add_library(rnoh_app SHARED
+ "./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_jPushModule)
+# RNOH_BEGIN: manual_package_linking_2
+```
+
+打开 `entry/src/main/cpp/PackageProvider.cpp`,添加:
+
+```diff
+#include "RNOH/PackageProvider.h"
++ #include "JPushModulePackage.h"
+
+using namespace rnoh;
+
+std::vector> PackageProvider::getPackages(Package::Context ctx) {
+ return {
++ std::make_shared(ctx)
+}
+```
+
+### 4. 在 ArkTs 侧引入 RNJPushPackage
打开 `entry/src/main/ets/RNPackagesFactory.ts`,由于引入的是ets文件,请将RNPackagesFactory.ts文件名后缀 ts 修改为 ets,添加:
```diff
+// V0.72
+ import {RNJPushPackage} from "@react-native-oh-tpl/jpush-react-native/ts";
+// V0.77
++ import {RNJPushPackage} from "@react-native-ohos/jpush-react-native/ts";
+
export function createRNPackages(ctx: RNPackageContext): RNPackage[] {
return [
new SamplePackage(ctx),
@@ -150,7 +215,7 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] {
}
```
-### 4. 运行
+### 5. 运行
点击右上角的 `sync` 按钮
@@ -170,7 +235,8 @@ ohpm install
要使用此库,需要使用正确的 React-Native 和 RNOH 版本。另外,还需要使用配套的 DevEco Studio 和 手机 ROM。
-请到三方库相应的 Releases 发布地址查看 Release 配套的版本信息:[@react-native-oh-tpl/jpush-react-native Releases](https://github.com/react-native-oh-library/jpush-react-native/releases)
+1. 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;
+2. RNOH:0.77.1;SDK:HarmonyOS 5.0.0.71(API Version 12 Release) ;IDE:DevEco Studio:5.1.1.830; ROM: HarmonyOS 5.1.0.150;
## 静态方法
@@ -231,9 +297,11 @@ ohpm install
| setSmartPushEnable(enable:boolean):void | 是否开启智能推送 |function | no | iOS,Android | no |
| setGeofenceEnable(enable:boolean):void | 是否开启地理围栏 |function | no |Android | no |
| setCollectControl(enable:boolean):void | 是否开启集中控制 |function | no | iOS、Android | no |
+| setDataInsightsEnable()3.1.8+ | 设置应用数据洞察 |function | no | Android | no |
## 遗留问题
- [ ] setProperties、deleteProperties、cleanProperties、pageEnterTo、pageLeave、initCrashHandler、setMaxGeofenceNumber、deleteGeofence、addNotificationListener、addInappMessageListener,setCollectControl、setSmartPushEnable这些方法在极光推送harmonyOS-SDK中暂未支持[issue#1](https://github.com/react-native-oh-library/jpush-react-native/issues/1)
+- [ ] V3.1.8及以上部分属性未实现 HarmonyOS 化 [issue#1](https://gitcode.com/openharmony-sig/rntpc_jpush-react-native/issues/1)
## 其他
diff --git a/zh-cn/react-native-base64.md b/zh-cn/react-native-base64.md
index e81479f2..2c2e6341 100644
--- a/zh-cn/react-native-base64.md
+++ b/zh-cn/react-native-base64.md
@@ -1,18 +1,15 @@
-> 模板版本:v0.2.2
+> 模板版本:v0.3.0
react-native-base64
-
-
-
-
-
-
-
-
-> [!TIP] [Github 地址](https://github.com/eranbo/react-native-base64/tree/0.2.1)
+请到三方库的 Releases 发布地址查看配套的版本信息:
+
+| 三方库版本 | 支持RN版本 |
+| ---------- | ---------- |
+| 0.2.1 | 0.72 |
+| 0.2.2 | 0.77 |
## 安装与使用
@@ -23,13 +20,21 @@
#### **npm**
```bash
-npm i react-native-base64@0.2.1
+# v0.72
+npm install react-native-base64@0.2.1
+
+# v0.77
+npm install react-native-base64@0.2.2
```
#### **yarn**
```bash
+# v0.72
yarn add react-native-base64@0.2.1
+
+# v0.77
+yarn add react-native-base64@0.2.2
```
@@ -109,6 +114,7 @@ const styles = StyleSheet.create({
1. RNOH: 0.72.29; SDK:HarmonyOS-Next-DB1 5.0.0.61; IDE:DevEco Studio 5.0.3.706; ROM:5.0.0.61;
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.1; SDK:HarmonyOS 5.0.0.71(API Version 12 Release) ;IDE:DevEco Studio:5.1.1.830; ROM: HarmonyOS 5.1.0.150;
## 静态方法:
@@ -116,11 +122,11 @@ const styles = StyleSheet.create({
> [!TIP] "HarmonyOS Support"列为 yes 表示 HarmonyOS 平台支持该属性;no 则表示不支持;partially 表示部分支持。使用方法跨平台一致,效果对标 iOS 或 Android 的效果。
-| Name | Description | Type | Required | Platform | HarmonyOS Support |
-| ---- | ----------- | ---- | -------- | -------- | ------------------ |
-| encode | encode from string | string | no | Android、iOS | yes |
-| decode | decode base64 strings | string | no | Android、iOS | yes |
-| encodeFromByteArray | encode from Unit8Array | Unit8Array | no | Android、iOS | yes |
+| Name | Description | Type | Required | Platform | HarmonyOS Support |
+| ---- | ----------- | ---- | -------- |-------------| ------------------ |
+| encode | 从字符串编码 | string | no | Android iOS | yes |
+| decode | 解码 base64 字符串 | string | no | Android iOS | yes |
+| encodeFromByteArray | 从 Unit8Array 编码 | Unit8Array | no | Android iOS | yes |
## 遗留问题
diff --git a/zh-cn/rn-placeholder.md b/zh-cn/rn-placeholder.md
index d00798bc..cf375f85 100644
--- a/zh-cn/rn-placeholder.md
+++ b/zh-cn/rn-placeholder.md
@@ -1,18 +1,16 @@
-> 模板版本:v0.2.2
+> 模板版本:v0.3.0
rn-placeholder
-
-
-
-
-
-
-
-
-> [!TIP] [Github 地址](https://github.com/react-native-oh-library/rn-placeholder)
+请到三方库的 Releases 发布地址查看配套的版本信息:
+
+| 三方库版本 | 支持RN版本 |
+| ----------| ---------- |
+| 3.0.4 | 0.72 |
+| 3.0.3 | 0.77 |
+
## 安装与使用
@@ -23,12 +21,20 @@
#### **npm**
```bash
+# v0.72
+npm install rn-placeholder@3.0.4 --legacy-peer-deps
+
+# v 0.77
npm install rn-placeholder@3.0.3 --legacy-peer-deps
```
#### **yarn**
```bash
+# v 0.72
+yarn add rn-placeholder@3.0.4 --legacy-peer-deps
+
+# v 0.77
yarn add rn-placeholder@3.0.3 --legacy-peer-deps
```
@@ -65,6 +71,7 @@ export default App;
本文档内容基于以下版本验证通过:
1. RNOH:0.72.27; SDK:HarmonyOS-Next-DB1 5.0.0.29(SP1) ; IDE:DevEco Studio 5.0.3.400; ROM:3.0.0.25;
+2. RNOH: 0.77.1;SDK:HarmonyOS 5.1.1.208 (API Version 19 Release) ;IDE:DevEco Studio:5.1.1.830; ROM: HarmonyOS 6.0.0.112 SP12;
## 属性
@@ -76,47 +83,47 @@ export default App;
**组件 Placeholder**
-It's the wrapper around all of the other components. Using alone will not produce anything interesting. You have put some line or media inside to make it powerful.It accepts all the props of a React Native View plus:
+它是所有其他组件的外层包装。单独使用并不会产生有趣的效果;需要在其中放入一些行或媒体来发挥作用。它接受 React Native View 的全部属性,另外还包含:
| Name | Description | Type | Required | Platform | HarmonyOS Support |
| --------- | --------------------------------------------------- | ------------- | -------- | -------- | ----------------- |
-| Animation | An optional component that animates the placeholder | Animations | no | All | Yes |
-| Left | An optional component to display on the left | ComponentType | no | All | Yes |
-| Right | An optional component to display on the right | ComponentType | no | All | Yes |
+| Animation | 一个可选组件,用于为占位符添加动画效果 | Animations | no | All | Yes |
+| Left | 一个可选组件,显示在左侧 | ComponentType | no | All | Yes |
+| Right | 一个可选组件,显示在右侧 | ComponentType | no | All | Yes |
**_Animations_**
| Name | Description | Type | Required | Platform | HarmonyOS Support |
| --------- | -------------------------------------------------- | ------------- | -------- | -------- | -------- |
-| Fade | This is the base animation that makes the placeholder become clearer on a specified interval| ComponentType | no | All | Yes |
-| ShineOverlay | This applies a tiny overlay from left to right of the placeholder. It's pretty neat but it has the drawback to only work without style customization: only on white background with gray lines |ComponentType| no | All | Yes |
-| Shine | The shine animation is an attempt to overcome the overlay problem of the ShineOverlay animation by animating only the differnt part of the placeholder | ComponentType | no | All | Yes |
-| Loader | A simple placeholder animation based on the standard loader (ActivityIndicator) of each platforms | ComponentType | no | All | Yes |
-| Progressive | A progressive loading animation effect | ComponentType | no | All | Yes |
-| Tweaking existing animations | It's possible to tweak a specific animation by passing it additional props. However keep in mind that it's important to spread the props from the Animation render function. Else you will be in strange behaviors| ComponentType | no | All | Yes |
+| Fade | 这是基础动画,会在指定的时间间隔让占位内容逐渐清晰| ComponentType | no | All | Yes |
+| ShineOverlay | 这会向占位符应用一个从左到右的 tiny 覆盖层。效果不错,但仅在不自定义样式时有效:仅在白色背景上显示灰色线|ComponentType| no | All | Yes |
+| Shine | 这个 shine 动画试图通过仅动画占位符的不同部分来克服 ShineOverlay 动画的覆盖层问题 | ComponentType | no | All | Yes |
+| Loader | 这是一个基于每个平台标准加载器(ActivityIndicator)的简单占位符动画| ComponentType | no | All | Yes |
+| Progressive | 一个渐进加载动画效果 | ComponentType | no | All | Yes |
+| Tweaking existing animations | 可以通过传递附加属性来调整特定动画。然而请记住,重要的是要将属性从 Animation 渲染函数中传播出来。否则会出现异常行为| ComponentType | no | All | Yes |
**组件 PlaceholderLine**
-A PlaceholderLine is one of the two basic and visual components of a placeholder.
+PlaceholderLine 是占位符的两种基础且可视的组件之一。
| Name | Description | Type | Required | Platform | HarmonyOS Support |
| -------- | ---------------------------------------------------------------------- | ------- | -------- | -------- | ----------------- |
-| height | The line height, default is 12 | number | no | All | Yes |
-| color | The line color, default is #efefef | string | no | All | Yes |
-| width | The line width in percent, default is 100(%) | number | no | All | Yes |
-| noMargin | Defines if a line should have a margin bottom or not, default is false | boolean | no | All | Yes |
-| style | Customize the style of the underlying View component | object | no | All | Yes |
+| height | 行高,默认值为 12 | number | no | All | Yes |
+| color | 颜色,默认值为 #efefef | string | no | All | Yes |
+| width | 行宽,默认值为 100(%) | number | no | All | Yes |
+| noMargin | 是否带有底部边距,默认值为 false | boolean | no | All | Yes |
+| style | 自定义底层 View 组件的样式 | object | no | All | Yes |
**组件 PlaceholderMedia**
-A PlaceholderMedia is the second of the two basic and visual components of a placeholder. It can be used a single placeholder like following:
+PlaceholderMedia 是占位符的两种基础且可视的组件中的另一个。它也可以像下面这样单独作为占位使用:
| Name | Description | Type | Required | Platform | HarmonyOS Support |
| ------- | -------------------------------------------------------- | ------- | -------- | -------- | ----------------- |
-| size | The media size (height / width), default is 40 | number | no | All | Yes |
-| isRound | Defines if the media is rounded or not, default is false | boolean | no | All | Yes |
-| color | The media color, default is #efefef | string | no | All | Yes |
-| style | Customize the style of the underlying View component | object | no | All | Yes |
+| size | 媒体大小(高度 / 宽度),默认值为 40 | number | no | All | Yes |
+| isRound | 定义媒体是否为圆角, 默认值为 false | boolean | no | All | Yes |
+| color | 媒体颜色,默认值为 #efefef | string | no | All | Yes |
+| style | 自定义底层 View 组件的样式 | object | no | All | Yes |
## 遗留问题
## 其他
--
Gitee
From 3201d31d05865a617c76403bb25ce9b4537f3f31 Mon Sep 17 00:00:00 2001
From: dujing
Date: Tue, 25 Nov 2025 18:59:08 +0800
Subject: [PATCH 2/6] =?UTF-8?q?docs:=20=E4=BF=AE=E6=94=B9=20react-native-f?=
=?UTF-8?q?ingerprint-scanner=20=E4=B8=AD=E8=8B=B1=E6=96=87=E6=8C=87?=
=?UTF-8?q?=E5=AF=BC=E6=96=87=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
en/react-native-fingerprint-scanner.md | 24 ++++++++++------------
zh-cn/react-native-fingerprint-scanner.md | 25 ++++++++++-------------
2 files changed, 22 insertions(+), 27 deletions(-)
diff --git a/en/react-native-fingerprint-scanner.md b/en/react-native-fingerprint-scanner.md
index 2546dff6..592151af 100644
--- a/en/react-native-fingerprint-scanner.md
+++ b/en/react-native-fingerprint-scanner.md
@@ -12,20 +12,20 @@
-> [!tip] [GitHub address](https://github.com/react-native-oh-library/react-native-fingerprint-scanner)
-
-## Installation and Usage
+This project is based on [jreact-native-fingerprint-scanner](https://github.com/react-native-oh-library/react-native-fingerprint-scanner).
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 |
-| ---------- | ------------------------------------------------------------ | ---------- |
-| 6.0.0@deprecated | [@react-native-oh-tpl/react-native-fingerprint-scanner Releases(deprecated)](https://github.com/react-native-oh-library/react-native-fingerprint-scanner/releases) | 0.72 |
-| 6.0.1 | [@react-native-ohos/react-native-fingerprint-scanner Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-fingerprint-scanner/releases) | 0.72 |
-| 6.1.0 | [@react-native-ohos/react-native-fingerprint-scanner Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-fingerprint-scanner/releases) | 0.77 |
+| Version | Package Name | Repository | Release | RN Version |
+| ---------- | ------------------------------------------------------------ | ---------- | ---------- | ---------- |
+| 6.0.0@deprecated | @react-native-oh-tpl/react-native-fingerprint-scanner Releases | [Github(deprecated)](https://github.com/react-native-oh-library/react-native-fingerprint-scanner/releases) |[Github(Releases)](https://github.com/react-native-oh-library/react-native-fingerprint-scanner/releases) | 0.72 |
+| 6.0.1 | @react-native-ohos/react-native-fingerprint-scanner Releases | [GitCode](https://gitcode.com/openharmony-sig/rntpc_react-native-fingerprint-scanner) | [GitCode](https://gitcode.com/openharmony-sig/rntpc_react-native-fingerprint-scanner/releases) | 0.72 |
+| 6.1.0 | [@react-native-ohos/react-native-fingerprint-scanner Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-fingerprint-scanner/releases) | [GitCode](https://gitcode.com/openharmony-sig/rntpc_react-native-fingerprint-scanner) | [GitCode](https://gitcode.com/openharmony-sig/rntpc_react-native-fingerprint-scanner/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.
+## Installation and Usage
+
Go to the project directory and execute the following instruction:
@@ -246,11 +246,9 @@ To use this repository, you need to use the correct React-Native and RNOH versio
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 |
-| ---------- | ------------------------------------------------------------ | ---------- |
-| 6.0.0@deprecated | [@react-native-oh-tpl/react-native-fingerprint-scanner Releases(deprecated)](https://github.com/react-native-oh-library/react-native-fingerprint-scanner/releases) | 0.72 |
-| 6.0.1 | [@react-native-ohos/react-native-fingerprint-scanner Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-fingerprint-scanner/releases) | 0.72 |
-| 6.1.0 | [@react-native-ohos/react-native-fingerprint-scanner Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-fingerprint-scanner/releases) | 0.77 |
+1. RNOH: 0.72.20; SDK: HarmonyOS NEXT Developer Beta1 B.0.18; IDE: DevEco Studio: 5.0.3.200; ROM: 3.0.0.18;
+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
diff --git a/zh-cn/react-native-fingerprint-scanner.md b/zh-cn/react-native-fingerprint-scanner.md
index 4f672b95..6c37ba09 100644
--- a/zh-cn/react-native-fingerprint-scanner.md
+++ b/zh-cn/react-native-fingerprint-scanner.md
@@ -12,20 +12,19 @@
-> [!TIP] [Github 地址](https://github.com/react-native-oh-library/react-native-fingerprint-scanner)
-
-## 安装与使用
+本项目基于 [jreact-native-fingerprint-scanner](https://github.com/react-native-oh-library/react-native-fingerprint-scanner) 开发。
请到三方库的 Releases 发布地址查看配套的版本信息:
-
-| 三方库版本 | 发布信息 | 支持RN版本 |
-| ---------- | ------------------------------------------------------------ | ---------- |
-| 6.0.0@deprecated | [@react-native-oh-tpl/react-native-fingerprint-scanner Releases(deprecated)](https://github.com/react-native-oh-library/react-native-fingerprint-scanner/releases) | 0.72 |
-| 6.0.1 | [@react-native-ohos/react-native-fingerprint-scanner Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-fingerprint-scanner/releases) | 0.72 |
-| 6.1.0 | [@react-native-ohos/react-native-fingerprint-scanner Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-fingerprint-scanner/releases) | 0.77 |
+| Version | Package Name | Repository | Release | RN Version |
+| ---------- | ------------------------------------------------------------ | ---------- | ---------- | ---------- |
+| 6.0.0@deprecated | @react-native-oh-tpl/react-native-fingerprint-scanner Releases | [Github(deprecated)](https://github.com/react-native-oh-library/react-native-fingerprint-scanner/releases) |[Github(Releases)](https://github.com/react-native-oh-library/react-native-fingerprint-scanner/releases) | 0.72 |
+| 6.0.1 | @react-native-ohos/react-native-fingerprint-scanner Releases | [GitCode](https://gitcode.com/openharmony-sig/rntpc_react-native-fingerprint-scanner) | [GitCode](https://gitcode.com/openharmony-sig/rntpc_react-native-fingerprint-scanner/releases) | 0.72 |
+| 6.1.0 | [@react-native-ohos/react-native-fingerprint-scanner Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-fingerprint-scanner/releases) | [GitCode](https://gitcode.com/openharmony-sig/rntpc_react-native-fingerprint-scanner) | [GitCode](https://gitcode.com/openharmony-sig/rntpc_react-native-fingerprint-scanner/releases) | 0.77 |
对于未发布到npm的旧版本,请参考[安装指南](/zh-cn/tgz-usage.md)安装tgz包。
+## 安装与使用
+
进入到工程目录并输入以下命令:
@@ -248,11 +247,9 @@ ohpm install
请到三方库的 Releases 发布地址查看配套的版本信息:
-| 三方库版本 | 发布信息 | 支持RN版本 |
-| ---------- | ------------------------------------------------------------ | ---------- |
-| 6.0.0@deprecated | [@react-native-oh-tpl/react-native-fingerprint-scanner Releases(deprecated)](https://github.com/react-native-oh-library/react-native-fingerprint-scanner/releases) | 0.72 |
-| 6.0.1 | [@react-native-ohos/react-native-fingerprint-scanner Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-fingerprint-scanner/releases) | 0.72 |
-| 6.1.0 | [@react-native-ohos/react-native-fingerprint-scanner Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-fingerprint-scanner/releases) | 0.77 |
+1. RNOH: 0.72.20; SDK: HarmonyOS NEXT Developer Beta1 B.0.18; IDE: DevEco Studio: 5.0.3.200; ROM: 3.0.0.18;
+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;
### 权限要求
--
Gitee
From 3e817a424dba1277df320d5768c191243205ec95 Mon Sep 17 00:00:00 2001
From: dujing
Date: Tue, 25 Nov 2025 19:10:12 +0800
Subject: [PATCH 3/6] =?UTF-8?q?docs:=20=E4=BF=AE=E6=94=B9=20react-native-f?=
=?UTF-8?q?ingerprint-scanner=20=E4=B8=AD=E8=8B=B1=E6=96=87=E6=8C=87?=
=?UTF-8?q?=E5=AF=BC=E6=96=87=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Signed-off-by: dujing
---
en/jpush-react-native.md | 100 +++++++--------------------------------
1 file changed, 18 insertions(+), 82 deletions(-)
diff --git a/en/jpush-react-native.md b/en/jpush-react-native.md
index efbc881b..14d6996b 100644
--- a/en/jpush-react-native.md
+++ b/en/jpush-react-native.md
@@ -1,19 +1,24 @@
-> Template version: v0.3.0
+> Template version: v0.2.2
jpush-react-native
+
+
+
+
+
+
+
+
-This project is based on [jpush-react-native@3.1.1](https://github.com/react-native-oh-library/jpush-react-native).
+> [!TIP] [GitHub address](https://github.com/react-native-oh-library/jpush-react-native)
-Please go to the corresponding Release release address of the third-party library to view the version information of the Release package:
-| Version | Package Name | Repository | Release | RN Version |
-| ------------------------------ | ---------------------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ |------------|
-| 3.1.1 | @react-native-oh-library/jpush-react-native Releases | [Github(deprecated)](https://github.com/react-native-oh-library/jpush-react-native/releases) | [Github Releases](https://github.com/react-native-oh-library/jpush-react-native/releases) | 0.72 |
-| 3.2.0 | @react-native-ohos/jpush-react-native Releases | [GitCode](https://gitcode.com/openharmony-sig/rntpc_jpush-react-native) | [GitCode Releases](https://gitcode.com/openharmony-sig/jpush-react-native/releases) | 0.77 |
## Installation and Usage
+Find the matching version information in the release address of a third-party library:[@react-native-oh-tpl/jpush-react-native Releases](https://github.com/react-native-oh-library/jpush-react-native/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.
+
Go to the project directory and execute the following instruction:
@@ -21,21 +26,13 @@ Go to the project directory and execute the following instruction:
#### **npm**
```bash
-# 0.72
npm install @react-native-oh-tpl/jpush-react-native
-
-# 0.77
-npm install @react-native-ohos/jpush-react-native
```
#### **yarn**
```bash
-# 0.72
yarn add @react-native-oh-tpl/jpush-react-native
-
-# 0.77
-yarn add @react-native-ohos/jpush-react-native
```
@@ -85,8 +82,6 @@ export default App;
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).
-**Note:** V3.1.8 and above do not require codegen.
-
## Link
Currently, HarmonyOS does not support AutoLink. Therefore, you need to manually configure the linking.
@@ -114,9 +109,8 @@ Method 1 (recommended): Use the HAR file.
Open `entry/oh-package.json5` file and add the following dependencies:
-- V0.72
-
```json
+
"dependencies": {
"@rnoh/react-native-openharmony": "file:../react_native_openharmony",
"@react-native-oh-tpl/jpush-react-native": "file:../../node_modules/@react-native-oh-tpl/jpush-react-native/harmony/jpush_react_native.har"
@@ -124,15 +118,6 @@ Open `entry/oh-package.json5` file and add the following dependencies:
```
-- V0.77
-
-```json
-"dependencies": {
- "@rnoh/react-native-openharmony": "file:../react_native_openharmony",
- "@react-native-ohos/jpush-react-native": "file:../../node_modules/@react-native-ohos/jpush-react-native/harmony/jpush_react_native.har"
-}
-```
-
Click the `sync` button in the upper right corner.
Alternatively, run the following instruction on the terminal:
@@ -147,54 +132,7 @@ Method 2: Directly link to the source code.
> [!TIP] For details, see [Directly Linking Source Code](/en/link-source-code.md).
-### 3. Configure CMakeLists and import RNJPushPackage
-
-> V3.2.0 requires configuring CMakeLists and importing RNJPushPackage.
-
-```diff
-...
-
-project(rnapp)
-cmake_minimum_required(VERSION 3.4.1)
-set(RNOH_APP_DIR "${CMAKE_CURRENT_SOURCE_DIR}")
-+ set(OH_MODULES "${CMAKE_CURRENT_SOURCE_DIR}/../../../oh_modules")
-set(RNOH_CPP_DIR "${CMAKE_CURRENT_SOURCE_DIR}/../../../../../../react-native-harmony/harmony/cpp")
-
-add_subdirectory("${RNOH_CPP_DIR}" ./rn)
-
-# RNOH_END: manual_package_linking_1
-add_subdirectory("../../../../sample_package/src/main/cpp" ./sample-package)
-+ add_subdirectory("${OH_MODULES}/@react-native-ohos/jpush-react-native/src/main/cpp" ./jPushModule)
-# RNOH_END: manual_package_linking_1
-
-add_library(rnoh_app SHARED
- "./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_jPushModule)
-# RNOH_BEGIN: manual_package_linking_2
-```
-
-Open `entry/src/main/cpp/PackageProvider.cpp`,and add:
-
-```diff
-#include "RNOH/PackageProvider.h"
-+ #include "JPushModulePackage.h"
-
-using namespace rnoh;
-
-std::vector> PackageProvider::getPackages(Package::Context ctx) {
- return {
-+ std::make_shared(ctx)
-}
-```
-
-### 4. Introducing RNJPushPackage to ArkTS
+### 3. Introducing RNJPushPackage to ArkTS
Open the `entry/src/main/ets/RNPackagesFactory.ts` file and add the following code:
@@ -209,7 +147,7 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] {
}
```
-### 5. Running
+### 4. Running
Click the `sync` button in the upper right corner.
@@ -229,9 +167,7 @@ Then build and run the code.
To use this repository, you need to use the correct React-Native and RNOH versions. In addition, you need to use DevEco Studio and the ROM on your phone.
-Check the release version information in the release address of the third-party library:
-1. 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;
-2. RNOH:0.77.1;SDK:HarmonyOS 5.0.0.71(API Version 12 Release) ;IDE:DevEco Studio:5.1.1.830; ROM: HarmonyOS 5.1.0.150;
+Check the release version information in the release address of the third-party library: [@react-native-oh-tpl/jpush-react-native Releases](https://github.com/react-native-oh-library/jpush-react-native/releases)
## Static Methods
@@ -292,10 +228,10 @@ Check the release version information in the release address of the third-party
| setSmartPushEnable(enable:boolean):void | Enable or disable intelligent push. |function | no | iOS,Android | no |
| setGeofenceEnable(enable:boolean):void | Enable or disable geofencing. |function | no |Android | no |
| setCollectControl(enable:boolean):void | Enable or disable centralized control. |function | no | iOS、Android | no |
-| setDataInsightsEnable()3.1.8+ | Set up Application Data Insights |function | no | Android | no |
+
## Known Issues
- [ ] setProperties、deleteProperties、cleanProperties、pageEnterTo、pageLeave、initCrashHandler、setMaxGeofenceNumber、deleteGeofence、addNotificationListener、addInappMessageListener,setCollectControl、setSmartPushEnable These methods are currently not supported in the Aurora Push HarmonyOS SDK[issue#1](https://github.com/react-native-oh-library/jpush-react-native/issues/1)
-- [ ] V3.1.8 and above some properties have not been adapted for HarmonyOS [issue#1](https://gitcode.com/openharmony-sig/rntpc_jpush-react-native/issues/1)
+
## Others
--
Gitee
From 21a007f6416e5a2d54ffafa8703b6c28b6c3d906 Mon Sep 17 00:00:00 2001
From: dujing
Date: Tue, 25 Nov 2025 19:13:25 +0800
Subject: [PATCH 4/6] =?UTF-8?q?docs:=20=E4=BF=AE=E6=94=B9=20react-native-f?=
=?UTF-8?q?ingerprint-scanner=20=E4=B8=AD=E8=8B=B1=E6=96=87=E6=8C=87?=
=?UTF-8?q?=E5=AF=BC=E6=96=87=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Signed-off-by: dujing
---
en/react-native-base64.md | 32 +++++++++++++-------------------
en/rn-placeholder.md | 30 ++++++++++++------------------
2 files changed, 25 insertions(+), 37 deletions(-)
diff --git a/en/react-native-base64.md b/en/react-native-base64.md
index f249cce4..fd0c7529 100644
--- a/en/react-native-base64.md
+++ b/en/react-native-base64.md
@@ -1,16 +1,18 @@
-> Template version: v0.3.0
+> Template version: v0.2.2
react-native-base64
+
+
+
+
+
+
+
+
-Please go to the corresponding Release release address of the third-party library to view the version information of the Release package:
-
-| Version | RN Version |
-| ---------- | ---------- |
-| 0.2.1 | 0.72 |
-| 0.2.2 | 0.77 |
-
+> [!TIP] [GitHub address](https://github.com/eranbo/react-native-base64/tree/0.2.1)
## Installation and Usage
@@ -21,21 +23,13 @@ Go to the project directory and execute the following instruction:
#### **npm**
```bash
-# v0.2.1
-npm install react-native-base64@0.2.1
-
-# v0.2.2
-npm install react-native-base64@0.2.2
+npm i react-native-base64@0.2.1
```
#### **yarn**
```bash
-# v0.2.1
yarn add react-native-base64@0.2.1
-
-# v0.2.2
-yarn add react-native-base64@0.2.2
```
@@ -115,7 +109,7 @@ This document is verified based on the following versions:
1. RNOH: 0.72.29; SDK:HarmonyOS-Next-DB1 5.0.0.61; IDE:DevEco Studio 5.0.3.706; ROM:5.0.0.61;
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.1; SDK:HarmonyOS 5.0.0.71(API Version 12 Release) ;IDE:DevEco Studio:5.1.1.830; ROM: HarmonyOS 5.1.0.150;
+
## Static Methods
> [!TIP] The **Platform** column indicates the platform where the properties are supported in the original third-party library.
@@ -134,4 +128,4 @@ This document is verified based on the following versions:
## License
-This project is licensed under [The MIT License (MIT)](https://github.com/eranbo/react-native-base64/blob/master/LICENSE).
+This project is licensed under [The MIT License (MIT)](https://github.com/eranbo/react-native-base64/blob/master/LICENSE).
\ No newline at end of file
diff --git a/en/rn-placeholder.md b/en/rn-placeholder.md
index df790df8..7e34369d 100644
--- a/en/rn-placeholder.md
+++ b/en/rn-placeholder.md
@@ -1,15 +1,18 @@
-> Template version: v0.3.0
+> Template version: v0.2.2
rn-placeholder
+
+
+
+
+
+
+
+
-Please go to the corresponding Release release address of the third-party library to view the version information of the Release package:
-
-| Version | Support RN version |
-| ----------| ---------- |
-| 3.0.4 | 0.72 |
-| 3.0.3 | 0.77 |
+> [!TIP] [GitHub address](https://github.com/react-native-oh-library/rn-placeholder)
## Installation and Usage
@@ -20,21 +23,13 @@ Go to the project directory and execute the following instruction:
#### **npm**
```bash
-# v0.72
-npm install rn-placeholder@3.0.4 --legacy-peer-deps
-
-# v 0.77
npm install rn-placeholder@3.0.3 --legacy-peer-deps
```
#### **yarn**
```bash
-# v 0.72
-yarn add rn-placeholder@3.0.4 --legacy-peer-deps
-
-# v 0.77
-yarn add rn-placeholder@3.0.3 --legacy-peer-deps
+yarn add rn-placeholder@3.0.3 --legacy-peer-deps
```
@@ -72,7 +67,6 @@ export default App;
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.400; ROM:3.0.0.25;
-2. RNOH: 0.77.1;SDK:HarmonyOS 5.1.1.208 (API Version 19 Release) ;IDE:DevEco Studio:5.1.1.830; ROM: HarmonyOS 6.0.0.112 SP12;
## Properties
@@ -130,4 +124,4 @@ A PlaceholderMedia is the second of the two basic and visual components of a pla
## License
-This project is licensed under [The MIT License (MIT)](https://github.com/mfrachet/rn-placeholder/blob/master/LICENSE.md).
+This project is licensed under [The MIT License (MIT)](https://github.com/mfrachet/rn-placeholder/blob/master/LICENSE.md).
\ No newline at end of file
--
Gitee
From 061f6a27cd438f2d7e2416c83d3249c552453b56 Mon Sep 17 00:00:00 2001
From: dujing
Date: Tue, 25 Nov 2025 19:20:26 +0800
Subject: [PATCH 5/6] =?UTF-8?q?docs:=20=E4=BF=AE=E6=94=B9=20react-native-f?=
=?UTF-8?q?ingerprint-scanner=20=E4=B8=AD=E8=8B=B1=E6=96=87=E6=8C=87?=
=?UTF-8?q?=E5=AF=BC=E6=96=87=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Signed-off-by: dujing
---
en/react-native-base64.md | 2 +-
en/rn-placeholder.md | 2 +-
zh-cn/jpush-react-native.md | 100 ++++++-----------------------------
zh-cn/react-native-base64.md | 38 ++++++-------
zh-cn/rn-placeholder.md | 69 +++++++++++-------------
5 files changed, 65 insertions(+), 146 deletions(-)
diff --git a/en/react-native-base64.md b/en/react-native-base64.md
index fd0c7529..32051bc1 100644
--- a/en/react-native-base64.md
+++ b/en/react-native-base64.md
@@ -128,4 +128,4 @@ This document is verified based on the following versions:
## License
-This project is licensed under [The MIT License (MIT)](https://github.com/eranbo/react-native-base64/blob/master/LICENSE).
\ No newline at end of file
+This project is licensed under [The MIT License (MIT)](https://github.com/eranbo/react-native-base64/blob/master/LICENSE).
diff --git a/en/rn-placeholder.md b/en/rn-placeholder.md
index 7e34369d..d072643e 100644
--- a/en/rn-placeholder.md
+++ b/en/rn-placeholder.md
@@ -124,4 +124,4 @@ A PlaceholderMedia is the second of the two basic and visual components of a pla
## License
-This project is licensed under [The MIT License (MIT)](https://github.com/mfrachet/rn-placeholder/blob/master/LICENSE.md).
\ No newline at end of file
+This project is licensed under [The MIT License (MIT)](https://github.com/mfrachet/rn-placeholder/blob/master/LICENSE.md).
diff --git a/zh-cn/jpush-react-native.md b/zh-cn/jpush-react-native.md
index 4441dfb6..97e5c6d9 100644
--- a/zh-cn/jpush-react-native.md
+++ b/zh-cn/jpush-react-native.md
@@ -1,41 +1,37 @@
-> 模板版本:v0.3.0
+> 模板版本:v0.2.2
jpush-react-native
+
+
+
+
+
+
+
+
-本项目基于 [jpush-react-native@3.1.1](https://github.com/react-native-oh-library/jpush-react-native) 开发。
-
-请到三方库的 Releases 发布地址查看配套的版本信息:
-| Version | Package Name | Repository | Release | RN Version |
-| ------------------------------ | ---------------------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ |------------|
-| 3.1.1 | @react-native-oh-library/jpush-react-native Releases | [Github(deprecated)](https://github.com/react-native-oh-library/jpush-react-native/releases) | [Github Releases](https://github.com/react-native-oh-library/jpush-react-native/releases) | 0.72 |
-| 3.2.0 | @react-native-ohos/jpush-react-native Releases | [GitCode](https://gitcode.com/openharmony-sig/rntpc_jpush-react-native) | [GitCode Releases](https://gitcode.com/openharmony-sig/jpush-react-native/releases) | 0.77 |
+> [!TIP] [Github 地址](https://github.com/react-native-oh-library/jpush-react-native)
## 安装与使用
+请到三方库的 Releases 发布地址查看配套的版本信息:[@react-native-oh-tpl/jpush-react-native Releases](https://github.com/react-native-oh-library/jpush-react-native/releases) 。对于未发布到npm的旧版本,请参考[安装指南](/zh-cn/tgz-usage.md)安装tgz包。
+
进入到工程目录并输入以下命令:
#### **npm**
```bash
-# 0.72
npm install @react-native-oh-tpl/jpush-react-native
-
-# 0.77
-npm install @react-native-ohos/jpush-react-native
```
#### **yarn**
```bash
-# 0.72
yarn add @react-native-oh-tpl/jpush-react-native
-
-# 0.77
-yarn add @react-native-ohos/jpush-react-native
```
@@ -85,8 +81,6 @@ export default App;
本库已经适配了 `Codegen` ,在使用前需要主动执行生成三方库桥接代码,详细请参考[ Codegen 使用文档](https://gitee.com/react-native-oh-library/usage-docs/blob/master/zh-cn/codegen.md)。
-**注意:** V3.1.8及以上不需要codegen。
-
## Link
目前 HarmonyOS 暂不支持 AutoLink,所以 Link 步骤需要手动配置。
@@ -118,22 +112,13 @@ export default App;
打开 `entry/oh-package.json5`,添加以下依赖
-- V0.72
-
```json
+
"dependencies": {
"@rnoh/react-native-openharmony": "file:../react_native_openharmony",
"@react-native-oh-tpl/jpush-react-native": "file:../../node_modules/@react-native-oh-tpl/jpush-react-native/harmony/jpush_react_native.har"
}
-```
-
-- V0.77
-```json
-"dependencies": {
- "@rnoh/react-native-openharmony": "file:../react_native_openharmony",
- "@react-native-ohos/jpush-react-native": "file:../../node_modules/@react-native-ohos/jpush-react-native/harmony/jpush_react_native.har"
-}
```
点击右上角的 `sync` 按钮
@@ -149,64 +134,14 @@ ohpm install
> [!TIP] 如需使用直接链接源码,请参考[直接链接源码说明](/zh-cn/link-source-code.md)
-### 3. 配置 CMakeLists 和引入 RNJPushPackage
-> V3.2.0 需要配置 CMakeLists 和引入 RNJPushPackage。
-
-```diff
-...
-
-project(rnapp)
-cmake_minimum_required(VERSION 3.4.1)
-set(RNOH_APP_DIR "${CMAKE_CURRENT_SOURCE_DIR}")
-+ set(OH_MODULES "${CMAKE_CURRENT_SOURCE_DIR}/../../../oh_modules")
-set(RNOH_CPP_DIR "${CMAKE_CURRENT_SOURCE_DIR}/../../../../../../react-native-harmony/harmony/cpp")
-
-add_subdirectory("${RNOH_CPP_DIR}" ./rn)
-
-# RNOH_END: manual_package_linking_1
-add_subdirectory("../../../../sample_package/src/main/cpp" ./sample-package)
-+ add_subdirectory("${OH_MODULES}/@react-native-ohos/jpush-react-native/src/main/cpp" ./jPushModule)
-# RNOH_END: manual_package_linking_1
-
-add_library(rnoh_app SHARED
- "./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_jPushModule)
-# RNOH_BEGIN: manual_package_linking_2
-```
-
-打开 `entry/src/main/cpp/PackageProvider.cpp`,添加:
-
-```diff
-#include "RNOH/PackageProvider.h"
-+ #include "JPushModulePackage.h"
-
-using namespace rnoh;
-
-std::vector> PackageProvider::getPackages(Package::Context ctx) {
- return {
-+ std::make_shared(ctx)
-}
-```
-
-### 4. 在 ArkTs 侧引入 RNJPushPackage
+### 3. 在 ArkTs 侧引入 RNJPushPackage
打开 `entry/src/main/ets/RNPackagesFactory.ts`,由于引入的是ets文件,请将RNPackagesFactory.ts文件名后缀 ts 修改为 ets,添加:
```diff
-// V0.72
+ import {RNJPushPackage} from "@react-native-oh-tpl/jpush-react-native/ts";
-// V0.77
-+ import {RNJPushPackage} from "@react-native-ohos/jpush-react-native/ts";
-
export function createRNPackages(ctx: RNPackageContext): RNPackage[] {
return [
new SamplePackage(ctx),
@@ -215,7 +150,7 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] {
}
```
-### 5. 运行
+### 4. 运行
点击右上角的 `sync` 按钮
@@ -235,8 +170,7 @@ ohpm install
要使用此库,需要使用正确的 React-Native 和 RNOH 版本。另外,还需要使用配套的 DevEco Studio 和 手机 ROM。
-1. 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;
-2. RNOH:0.77.1;SDK:HarmonyOS 5.0.0.71(API Version 12 Release) ;IDE:DevEco Studio:5.1.1.830; ROM: HarmonyOS 5.1.0.150;
+请到三方库相应的 Releases 发布地址查看 Release 配套的版本信息:[@react-native-oh-tpl/jpush-react-native Releases](https://github.com/react-native-oh-library/jpush-react-native/releases)
## 静态方法
@@ -297,11 +231,9 @@ ohpm install
| setSmartPushEnable(enable:boolean):void | 是否开启智能推送 |function | no | iOS,Android | no |
| setGeofenceEnable(enable:boolean):void | 是否开启地理围栏 |function | no |Android | no |
| setCollectControl(enable:boolean):void | 是否开启集中控制 |function | no | iOS、Android | no |
-| setDataInsightsEnable()3.1.8+ | 设置应用数据洞察 |function | no | Android | no |
## 遗留问题
- [ ] setProperties、deleteProperties、cleanProperties、pageEnterTo、pageLeave、initCrashHandler、setMaxGeofenceNumber、deleteGeofence、addNotificationListener、addInappMessageListener,setCollectControl、setSmartPushEnable这些方法在极光推送harmonyOS-SDK中暂未支持[issue#1](https://github.com/react-native-oh-library/jpush-react-native/issues/1)
-- [ ] V3.1.8及以上部分属性未实现 HarmonyOS 化 [issue#1](https://gitcode.com/openharmony-sig/rntpc_jpush-react-native/issues/1)
## 其他
diff --git a/zh-cn/react-native-base64.md b/zh-cn/react-native-base64.md
index 2c2e6341..e81479f2 100644
--- a/zh-cn/react-native-base64.md
+++ b/zh-cn/react-native-base64.md
@@ -1,15 +1,18 @@
-> 模板版本:v0.3.0
+> 模板版本:v0.2.2
react-native-base64
+
+
+
+
+
+
+
+
-请到三方库的 Releases 发布地址查看配套的版本信息:
-
-| 三方库版本 | 支持RN版本 |
-| ---------- | ---------- |
-| 0.2.1 | 0.72 |
-| 0.2.2 | 0.77 |
+> [!TIP] [Github 地址](https://github.com/eranbo/react-native-base64/tree/0.2.1)
## 安装与使用
@@ -20,21 +23,13 @@
#### **npm**
```bash
-# v0.72
-npm install react-native-base64@0.2.1
-
-# v0.77
-npm install react-native-base64@0.2.2
+npm i react-native-base64@0.2.1
```
#### **yarn**
```bash
-# v0.72
yarn add react-native-base64@0.2.1
-
-# v0.77
-yarn add react-native-base64@0.2.2
```
@@ -114,7 +109,6 @@ const styles = StyleSheet.create({
1. RNOH: 0.72.29; SDK:HarmonyOS-Next-DB1 5.0.0.61; IDE:DevEco Studio 5.0.3.706; ROM:5.0.0.61;
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.1; SDK:HarmonyOS 5.0.0.71(API Version 12 Release) ;IDE:DevEco Studio:5.1.1.830; ROM: HarmonyOS 5.1.0.150;
## 静态方法:
@@ -122,11 +116,11 @@ const styles = StyleSheet.create({
> [!TIP] "HarmonyOS Support"列为 yes 表示 HarmonyOS 平台支持该属性;no 则表示不支持;partially 表示部分支持。使用方法跨平台一致,效果对标 iOS 或 Android 的效果。
-| Name | Description | Type | Required | Platform | HarmonyOS Support |
-| ---- | ----------- | ---- | -------- |-------------| ------------------ |
-| encode | 从字符串编码 | string | no | Android iOS | yes |
-| decode | 解码 base64 字符串 | string | no | Android iOS | yes |
-| encodeFromByteArray | 从 Unit8Array 编码 | Unit8Array | no | Android iOS | yes |
+| Name | Description | Type | Required | Platform | HarmonyOS Support |
+| ---- | ----------- | ---- | -------- | -------- | ------------------ |
+| encode | encode from string | string | no | Android、iOS | yes |
+| decode | decode base64 strings | string | no | Android、iOS | yes |
+| encodeFromByteArray | encode from Unit8Array | Unit8Array | no | Android、iOS | yes |
## 遗留问题
diff --git a/zh-cn/rn-placeholder.md b/zh-cn/rn-placeholder.md
index cf375f85..d00798bc 100644
--- a/zh-cn/rn-placeholder.md
+++ b/zh-cn/rn-placeholder.md
@@ -1,16 +1,18 @@
-> 模板版本:v0.3.0
+> 模板版本:v0.2.2
rn-placeholder
+
+
+
+
+
+
+
+
-请到三方库的 Releases 发布地址查看配套的版本信息:
-
-| 三方库版本 | 支持RN版本 |
-| ----------| ---------- |
-| 3.0.4 | 0.72 |
-| 3.0.3 | 0.77 |
-
+> [!TIP] [Github 地址](https://github.com/react-native-oh-library/rn-placeholder)
## 安装与使用
@@ -21,20 +23,12 @@
#### **npm**
```bash
-# v0.72
-npm install rn-placeholder@3.0.4 --legacy-peer-deps
-
-# v 0.77
npm install rn-placeholder@3.0.3 --legacy-peer-deps
```
#### **yarn**
```bash
-# v 0.72
-yarn add rn-placeholder@3.0.4 --legacy-peer-deps
-
-# v 0.77
yarn add rn-placeholder@3.0.3 --legacy-peer-deps
```
@@ -71,7 +65,6 @@ export default App;
本文档内容基于以下版本验证通过:
1. RNOH:0.72.27; SDK:HarmonyOS-Next-DB1 5.0.0.29(SP1) ; IDE:DevEco Studio 5.0.3.400; ROM:3.0.0.25;
-2. RNOH: 0.77.1;SDK:HarmonyOS 5.1.1.208 (API Version 19 Release) ;IDE:DevEco Studio:5.1.1.830; ROM: HarmonyOS 6.0.0.112 SP12;
## 属性
@@ -83,47 +76,47 @@ export default App;
**组件 Placeholder**
-它是所有其他组件的外层包装。单独使用并不会产生有趣的效果;需要在其中放入一些行或媒体来发挥作用。它接受 React Native View 的全部属性,另外还包含:
+It's the wrapper around all of the other components. Using alone will not produce anything interesting. You have put some line or media inside to make it powerful.It accepts all the props of a React Native View plus:
| Name | Description | Type | Required | Platform | HarmonyOS Support |
| --------- | --------------------------------------------------- | ------------- | -------- | -------- | ----------------- |
-| Animation | 一个可选组件,用于为占位符添加动画效果 | Animations | no | All | Yes |
-| Left | 一个可选组件,显示在左侧 | ComponentType | no | All | Yes |
-| Right | 一个可选组件,显示在右侧 | ComponentType | no | All | Yes |
+| Animation | An optional component that animates the placeholder | Animations | no | All | Yes |
+| Left | An optional component to display on the left | ComponentType | no | All | Yes |
+| Right | An optional component to display on the right | ComponentType | no | All | Yes |
**_Animations_**
| Name | Description | Type | Required | Platform | HarmonyOS Support |
| --------- | -------------------------------------------------- | ------------- | -------- | -------- | -------- |
-| Fade | 这是基础动画,会在指定的时间间隔让占位内容逐渐清晰| ComponentType | no | All | Yes |
-| ShineOverlay | 这会向占位符应用一个从左到右的 tiny 覆盖层。效果不错,但仅在不自定义样式时有效:仅在白色背景上显示灰色线|ComponentType| no | All | Yes |
-| Shine | 这个 shine 动画试图通过仅动画占位符的不同部分来克服 ShineOverlay 动画的覆盖层问题 | ComponentType | no | All | Yes |
-| Loader | 这是一个基于每个平台标准加载器(ActivityIndicator)的简单占位符动画| ComponentType | no | All | Yes |
-| Progressive | 一个渐进加载动画效果 | ComponentType | no | All | Yes |
-| Tweaking existing animations | 可以通过传递附加属性来调整特定动画。然而请记住,重要的是要将属性从 Animation 渲染函数中传播出来。否则会出现异常行为| ComponentType | no | All | Yes |
+| Fade | This is the base animation that makes the placeholder become clearer on a specified interval| ComponentType | no | All | Yes |
+| ShineOverlay | This applies a tiny overlay from left to right of the placeholder. It's pretty neat but it has the drawback to only work without style customization: only on white background with gray lines |ComponentType| no | All | Yes |
+| Shine | The shine animation is an attempt to overcome the overlay problem of the ShineOverlay animation by animating only the differnt part of the placeholder | ComponentType | no | All | Yes |
+| Loader | A simple placeholder animation based on the standard loader (ActivityIndicator) of each platforms | ComponentType | no | All | Yes |
+| Progressive | A progressive loading animation effect | ComponentType | no | All | Yes |
+| Tweaking existing animations | It's possible to tweak a specific animation by passing it additional props. However keep in mind that it's important to spread the props from the Animation render function. Else you will be in strange behaviors| ComponentType | no | All | Yes |
**组件 PlaceholderLine**
-PlaceholderLine 是占位符的两种基础且可视的组件之一。
+A PlaceholderLine is one of the two basic and visual components of a placeholder.
| Name | Description | Type | Required | Platform | HarmonyOS Support |
| -------- | ---------------------------------------------------------------------- | ------- | -------- | -------- | ----------------- |
-| height | 行高,默认值为 12 | number | no | All | Yes |
-| color | 颜色,默认值为 #efefef | string | no | All | Yes |
-| width | 行宽,默认值为 100(%) | number | no | All | Yes |
-| noMargin | 是否带有底部边距,默认值为 false | boolean | no | All | Yes |
-| style | 自定义底层 View 组件的样式 | object | no | All | Yes |
+| height | The line height, default is 12 | number | no | All | Yes |
+| color | The line color, default is #efefef | string | no | All | Yes |
+| width | The line width in percent, default is 100(%) | number | no | All | Yes |
+| noMargin | Defines if a line should have a margin bottom or not, default is false | boolean | no | All | Yes |
+| style | Customize the style of the underlying View component | object | no | All | Yes |
**组件 PlaceholderMedia**
-PlaceholderMedia 是占位符的两种基础且可视的组件中的另一个。它也可以像下面这样单独作为占位使用:
+A PlaceholderMedia is the second of the two basic and visual components of a placeholder. It can be used a single placeholder like following:
| Name | Description | Type | Required | Platform | HarmonyOS Support |
| ------- | -------------------------------------------------------- | ------- | -------- | -------- | ----------------- |
-| size | 媒体大小(高度 / 宽度),默认值为 40 | number | no | All | Yes |
-| isRound | 定义媒体是否为圆角, 默认值为 false | boolean | no | All | Yes |
-| color | 媒体颜色,默认值为 #efefef | string | no | All | Yes |
-| style | 自定义底层 View 组件的样式 | object | no | All | Yes |
+| size | The media size (height / width), default is 40 | number | no | All | Yes |
+| isRound | Defines if the media is rounded or not, default is false | boolean | no | All | Yes |
+| color | The media color, default is #efefef | string | no | All | Yes |
+| style | Customize the style of the underlying View component | object | no | All | Yes |
## 遗留问题
## 其他
--
Gitee
From bdb54a2cfaa9378dffb2fd727726bbb735a2b446 Mon Sep 17 00:00:00 2001
From: dujing
Date: Thu, 27 Nov 2025 15:57:18 +0800
Subject: [PATCH 6/6] =?UTF-8?q?docs:=20react-native-action-button=20?=
=?UTF-8?q?=E4=B8=AD=E8=8B=B1=E6=96=87=E6=8C=87=E5=AF=BC=E6=96=87=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Signed-off-by: dujing
---
en/react-native-action-button.md | 7 +++
zh-cn/react-native-action-button.md | 79 ++++++++++++++++-------------
2 files changed, 50 insertions(+), 36 deletions(-)
diff --git a/en/react-native-action-button.md b/en/react-native-action-button.md
index c70998f1..a7cee7f0 100644
--- a/en/react-native-action-button.md
+++ b/en/react-native-action-button.md
@@ -14,6 +14,12 @@
> [!TIP] [GitHub address](https://github.com/mastermoo/react-native-action-button)
+Please go to the corresponding Release release address of the third-party library to view the version information of the Release package:
+
+| Version | Support RN version |
+| ---------- | ---------- |
+| 2.8.5 | 0.72/0.77 |
+
## Installation and Usage
Go to the project directory and execute the following instruction:
@@ -92,6 +98,7 @@ This document is verified based on the following versions:
2. RNOH: 0.72.13; SDK: HarmonyOS NEXT Developer Preview1; IDE: DevEco Studio 4.1.3.500; ROM: 2.0.0.58;
3. RNOH: 0.72.27; SDK: HarmonyOS-Next-DB1 5.0.0.29(SP1); IDE: DevEco Studio 5.0.3.400; ROM: 3.0.0.25;
4. 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;
+5. RNOH: 0.77.18; SDK:HarmonyOS 5.1.1.208 (API Version 19 Release) ;IDE:DevEco Studio:5.1.1.830; ROM: HarmonyOS 6.0.0.112 SP12;
## Properties
diff --git a/zh-cn/react-native-action-button.md b/zh-cn/react-native-action-button.md
index f91bb0a1..819a5fd8 100644
--- a/zh-cn/react-native-action-button.md
+++ b/zh-cn/react-native-action-button.md
@@ -14,6 +14,12 @@
> [!TIP] [Github 地址](https://github.com/mastermoo/react-native-action-button)
+请到三方库的 Releases 发布地址查看配套的版本信息:
+
+| 三方库版本 | 支持RN版本 |
+| ---------- | ---------- |
+| 2.8.5 | 0.72/0.77 |
+
## 安装与使用
进入到工程目录并输入以下命令:
@@ -91,6 +97,7 @@ const styles = StyleSheet.create({
2. RNOH:0.72.13; SDK:HarmonyOS NEXT Developer Preview1; IDE:DevEco Studio 4.1.3.500; ROM:2.0.0.58;
3. RNOH:0.72.27; SDK:HarmonyOS-Next-DB1 5.0.0.29(SP1); IDE:DevEco Studio 5.0.3.400; ROM:3.0.0.25;
4. 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;
+5. RNOH: 0.77.18; SDK:HarmonyOS 5.1.1.208 (API Version 19 Release) ;IDE:DevEco Studio:5.1.1.830; ROM: HarmonyOS 6.0.0.112 SP12;
## 属性
@@ -100,47 +107,47 @@ const styles = StyleSheet.create({
| Name | Description | Type | Required | Platform | HarmonyOS Support |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | -------- |----------| -------- |
-| resetToken | use this to reset the internal component state (expand/collapse) in a re-render cycle. Synchronize the component state. | any | No | All | Yes |
-| size | use this to change the size of the Button | number | No | All | Yes |
-| active | action buttons visible or not | boolean | No | All | Yes |
-| position | one of: left center and right | string | No | All | Yes |
-| autoInactive | Auto hide ActionButtons when ActionButton.Item is pressed. | boolean | No | All | Yes |
-| hideShadow | use this to hide the default elevation and boxShadow | boolean | No | All | Yes |
-| spacing | spacing between the ActionButton.Items | number | No | All | Yes |
-| offsetX | offset from the left/right side of the screen | number | No | All | Yes |
-| offsetY | offset from the bottom/top of the screen | number | No | All | Yes |
-| buttonText | use this to set a different text on the button | string | No | All | Yes |
-| degrees | degrees to rotate icon | number | No | All | Yes |
-| shadowStyle | The custom shadow style you want to pass in the action button | style | No | All | Yes |
-| bgColor | background color when ActionButtons are visible | string | No | All | Yes |
-| bgOpacity | set the transparency of the background color | number | No | All | Yes |
-| buttonTextStyle | use this to set the textstyle of the button's text | style | No | All | Yes |
-| verticalOrientation | direction action buttons should expand. One of: up or down | string | No | All | Yes |
-| backgroundTappable | make background tappable in active state of ActionButton | boolean | No | All | Yes |
-| activeOpacity | activeOpacity props of TouchableOpacity | number | No | All | Yes |
-| renderIcon | Function to render the component for ActionButton Icon. It is passed a boolean, active, which is true if the FAB has been expanded, and false if it is collapsed, allowing you to show a different icon when the ActionButton Items are expanded. | function | No | All | Yes |
-| onPress | fires, when ActionButton is tapped | function | No | All | Yes |
-| useNativeFeedback | Android: Whether to use a TouchableNativeFeedback | boolean | No | Android | No |
-| fixNativeFeedbackRadius | Android: Activate this to fix TouchableNativeFeedback Ripple UI problems | boolean | No | Android | No |
-| nativeFeedbackRippleColor | Android: Pass a color to the Ripple Effect of a TouchableNativeFeedback | string | No | Android | No |
+| resetToken | 用于在重新渲染周期中重置内部组件状态(展开/折叠)。同步组件状态。 | any | No | All | Yes |
+| size | 用于改变按钮的大小 | number | No | All | Yes |
+| active | 操作按钮是否可见 | boolean | No | All | Yes |
+| position | 可选值之一:left、center 和 right | string | No | All | Yes |
+| autoInactive | 当按下 ActionButton.Item 时自动隐藏 ActionButtons。 | boolean | No | All | Yes |
+| hideShadow | 用于隐藏默认的 elevation 和 boxShadow | boolean | No | All | Yes |
+| spacing | ActionButton.Items 之间的间距 | number | No | All | Yes |
+| offsetX | 距离屏幕左侧/右侧的偏移量 | number | No | All | Yes |
+| offsetY | 距离屏幕底部/顶部的偏移量 | number | No | All | Yes |
+| buttonText | 用于在按钮上设置不同的文本 | string | No | All | Yes |
+| degrees | 旋转图标的角度 | number | No | All | Yes |
+| shadowStyle | 您想要传递给操作按钮的自定义阴影样式 | style | No | All | Yes |
+| bgColor | ActionButtons 可见时的背景颜色 | string | No | All | Yes |
+| bgOpacity | 设置背景颜色的透明度 | number | No | All | Yes |
+| buttonTextStyle | 用于设置按钮文本的文本样式 | style | No | All | Yes |
+| verticalOrientation | 操作按钮应展开的方向。可选值之一:up 或 down | string | No | All | Yes |
+| backgroundTappable | 使 ActionButton 处于活动状态时背景可点击 | boolean | No | All | Yes |
+| activeOpacity | TouchableOpacity 的 activeOpacity 属性 | number | No | All | Yes |
+| renderIcon | 用于渲染 ActionButton 图标组件的函数。它会传递一个布尔值 active,当 FAB 展开时为 true,折叠时为 false,允许您在 ActionButton Items 展开时显示不同的图标。 | function | No | All | Yes |
+| onPress | 当点击 ActionButton 时触发 | function | No | All | Yes |
+| useNativeFeedback | Android:是否使用 TouchableNativeFeedback | boolean | No | Android | No |
+| fixNativeFeedbackRadius | Android:激活此选项以修复 TouchableNativeFeedback 的涟漪 UI 问题 | boolean | No | Android | No |
+| nativeFeedbackRippleColor | Android:为 TouchableNativeFeedback 的涟漪效果传递颜色 | string | No | Android | No |
### ActionButton.Item:
| Name | Description | Type | Required | Platform | HarmonyOS Support |
| ------------------------- | -------------------------------------------------------------------------- | -------- | -------- |----------| -------- |
-| size | use this to change the size of the Button | number | No | All | Yes |
-| buttonColor | background color of the Button | string | No | All | Yes |
-| title | the title shown next to the button. When undefined the title is not hidden | string | No | All | Yes |
-| textStyle | use this to set the textstyle of the button's item text | style | No | All | Yes |
-| shadowStyle | The custom shadow style you want to pass in the action button item | style | No | All | Yes |
-| textContainerStyle | use this to set the textstyle of the button's item text container | style | No | All | Yes |
-| spaceBetween | use this to set the space between the Button and the text container | number | No | All | Yes |
-| hideLabelShadow | use this to hide the button's label default elevation and boxShadow | boolean | No | All | Yes |
-| activeOpacity | activeOpacity props of TouchableOpacity | number | No | All | Yes |
-| onPress | required function, triggers when a button is tapped | function | No | All | Yes |
-| useNativeFeedback | Android: Whether to use a TouchableNativeFeedback | boolean | No | Android | No |
-| fixNativeFeedbackRadius | Android: Activate this to fix TouchableNativeFeedback Ripple UI problems | boolean | No | Android | No |
-| nativeFeedbackRippleColor | Android: Pass a color to the Ripple Effect of a TouchableNativeFeedback | string | No | Android | No |
+| size | 用于改变按钮的大小 | number | No | All | Yes |
+| buttonColor | 按钮的背景颜色 | string | No | All | Yes |
+| title | 按钮旁边显示的标题。当未定义时标题不会被隐藏 | string | No | All | Yes |
+| textStyle | 用于设置按钮项文本的文本样式 | style | No | All | Yes |
+| shadowStyle | 您想要传递给操作按钮项的自定义阴影样式 | style | No | All | Yes |
+| textContainerStyle | 用于设置按钮项文本容器的文本样式 | style | No | All | Yes |
+| spaceBetween | 用于设置按钮和文本容器之间的间距 | number | No | All | Yes |
+| hideLabelShadow | 用于隐藏按钮标签的默认 elevation 和 boxShadow | boolean | No | All | Yes |
+| activeOpacity | TouchableOpacity 的 activeOpacity 属性 | number | No | All | Yes |
+| onPress | 必需的函数,在点击按钮时触发 | function | No | All | Yes |
+| useNativeFeedback | Android:是否使用 TouchableNativeFeedback | boolean | No | Android | No |
+| fixNativeFeedbackRadius | Android:激活此选项以修复 TouchableNativeFeedback 的涟漪 UI 问题 | boolean | No | Android | No |
+| nativeFeedbackRippleColor | Android:为 TouchableNativeFeedback 的涟漪效果传递颜色 | string | No | Android | No |
## 遗留问题
--
Gitee