From 9d361a970c3ef6626684f482d8c3b36b1ab78950 Mon Sep 17 00:00:00 2001 From: "xingyu.guang" Date: Fri, 15 Aug 2025 18:06:26 +0800 Subject: [PATCH] =?UTF-8?q?docs:=200.77=E9=80=82=E9=85=8D=E6=B7=BB?= =?UTF-8?q?=E5=8A=A0=E4=BF=AE=E6=94=B98=E4=B8=AA=E4=B8=89=E6=96=B9?= =?UTF-8?q?=E5=BA=93=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- zh-cn/react-native-fingerprint-scanner.md | 45 ++++++++++++++++++++-- zh-cn/react-native-image-pan-zoom.md | 23 ++++++++++- zh-cn/react-native-json-tree.md | 4 +- zh-cn/react-native-linear-gradient-text.md | 4 +- zh-cn/react-native-performance.md | 40 ++++++++++++++++++- zh-cn/react-native-safe-module.md | 24 ++++++++++-- zh-cn/remobile-react-native-toast.md | 41 ++++++++++++++++++-- zh-cn/rn-bugly.md | 43 ++++++++++++++++++++- 8 files changed, 204 insertions(+), 20 deletions(-) diff --git a/zh-cn/react-native-fingerprint-scanner.md b/zh-cn/react-native-fingerprint-scanner.md index 8a7e7e83..d7b9b0e3 100644 --- a/zh-cn/react-native-fingerprint-scanner.md +++ b/zh-cn/react-native-fingerprint-scanner.md @@ -16,7 +16,14 @@ ## 安装与使用 -请到三方库的 Releases 发布地址查看配套的版本信息:[@react-native-oh-tpl/react-native-fingerprint-scanner Releases](https://github.com/react-native-oh-library/react-native-fingerprint-scanner/releases) 。对于未发布到npm的旧版本,请参考[安装指南](/zh-cn/tgz-usage.md)安装tgz包。 +请到三方库的 Releases 发布地址查看配套的版本信息: + +| 三方库版本 | 发布信息 | 支持RN版本 | +| ----------- | ------------------------------------------------------------ | ---------- | +| 6.0.0-0.0.4 | [@react-native-oh-tpl/react-native-fingerprint-scanner 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]() | 0.77 | + +对于未发布到npm的旧版本,请参考[安装指南](/zh-cn/tgz-usage.md)安装tgz包。 进入到工程目录并输入以下命令: @@ -25,13 +32,21 @@ #### **npm** ```bash +#6.0.0-0.0.4 npm install @react-native-oh-tpl/react-native-fingerprint-scanner + +#6.0.1 +npm install @react-native-ohos/react-native-fingerprint-scanner ``` #### **yarn** ```bash +#6.0.0-0.0.4 yarn add @react-native-oh-tpl/react-native-fingerprint-scanner + +#6.0.1 +yarn add @react-native-ohos/react-native-fingerprint-scanner ``` @@ -85,6 +100,8 @@ export default function App() { ## 使用 Codegen +> [!TIP] V6.0.1不需要执行 Codegen。 + 本库已经适配了 `Codegen` ,在使用前需要主动执行生成三方库桥接代码,详细请参考[ Codegen 使用文档](/zh-cn/codegen.md)。 ## Link @@ -117,6 +134,8 @@ export default function App() { 打开 `entry/oh-package.json5`,添加以下依赖 +- V6.0.0-0.0.4 + ```json "dependencies": { "@rnoh/react-native-openharmony": "file:../react_native_openharmony", @@ -124,6 +143,17 @@ export default function App() { } ``` +- V6.0.1 + +```json +"dependencies": { + "@rnoh/react-native-openharmony": "file:../react_native_openharmony", + "@react-native-oh-tpl/react-native-fingerprint-scanner": "file:../../node_modules/@react-native-ohos/react-native-fingerprint-scanner/harmony/fingerprint_scanner.har" + } +``` + + + 点击右上角的 `sync` 按钮 或者在终端执行: @@ -138,14 +168,16 @@ ohpm install ### 3.在 ArkTs 侧引入 FingerprintScannerPackage - 打开 `entry/src/main/ets/RNPackagesFactory.ts`,添加: ```diff ... - +//6.0.0-0.0.4 + import { RNFingerprintScannerPackage } from '@react-native-oh-tpl/react-native-fingerprint-scanner/ts'; +//6.0.1 ++ import { RNFingerprintScannerPackage } from '@react-native-ohos/react-native-fingerprint-scanner/ts'; + export function createRNPackages(ctx: RNPackageContext): RNPackage[] { return [ new SamplePackage(ctx), @@ -173,7 +205,12 @@ ohpm install 要使用此库,需要使用正确的 React-Native 和 RNOH 版本。另外,还需要使用配套的 DevEco Studio 和 手机 ROM。 -请到三方库相应的 Releases 发布地址查看 Release 配套的版本信息:[@react-native-oh-tpl/react-native-fingerprint-scanner Releases](https://github.com/react-native-oh-library/react-native-fingerprint-scanner/releases) +请到三方库相应的 Releases 发布地址查看 Release 配套的版本信息: + +| 三方库版本 | 发布信息 | 支持RN版本 | +| ----------- | ------------------------------------------------------------ | ---------- | +| 6.0.0-0.0.4 | [@react-native-oh-tpl/react-native-fingerprint-scanner 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]() | 0.77 | ### 权限要求 diff --git a/zh-cn/react-native-image-pan-zoom.md b/zh-cn/react-native-image-pan-zoom.md index ecfcbc4a..9da54f9e 100644 --- a/zh-cn/react-native-image-pan-zoom.md +++ b/zh-cn/react-native-image-pan-zoom.md @@ -16,7 +16,14 @@ ## 安装与使用 -请到三方库的 Releases 发布地址查看配套的版本信息:[@react-native-oh-tpl/react-native-image-pan-zoom Releases](https://github.com/react-native-oh-library/react-native-image-zoom/releases) 。对于未发布到npm的旧版本,请参考[安装指南](/zh-cn/tgz-usage.md)安装tgz包。 +请到三方库的 Releases 发布地址查看配套的版本信息: + +| 三方库版本 | 发布信息 | 支持RN版本 | +| ---------- | ------------------------------------------------------------ | ---------- | +| 2.1.12 | [@react-native-oh-tpl/react-native-image-pan-zoom Releases](https://github.com/react-native-oh-library/react-native-image-zoom/releases) | 0.72 | +| 2.1.13 | [@react-native-ohos/react-native-image-pan-zoom Releases]() | 0.77 | + +对于未发布到npm的旧版本,请参考[安装指南](/zh-cn/tgz-usage.md)安装tgz包。 进入到工程目录并输入以下命令: @@ -25,13 +32,20 @@ #### **npm** ```bash +#2.1.12 npm install @react-native-oh-tpl/react-native-image-pan-zoom + +#2.1.13 +npm install @react-native-ohos/react-native-image-pan-zoom ``` #### **yarn** ```bash +#2.1.12 yarn add @react-native-oh-tpl/react-native-image-pan-zoom +#2.1.13 +yarn add @react-native-ohos/react-native-image-pan-zoom ``` @@ -87,7 +101,12 @@ export default function () { 要使用此库,需要使用正确的 React-Native 和 RNOH 版本。另外,还需要使用配套的 DevEco Studio 和 手机 ROM。 -请到三方库相应的 Releases 发布地址查看 Release 配套的版本信息:[@react-native-oh-tpl/react-native-image-zoom Releases](https://github.com/react-native-oh-library/react-native-image-zoom/releases) +请到三方库相应的 Releases 发布地址查看 Release 配套的版本信息: + +| 三方库版本 | 发布信息 | 支持RN版本 | +| ---------- | ------------------------------------------------------------ | ---------- | +| 2.1.12 | [@react-native-oh-tpl/react-native-image-pan-zoom Releases](https://github.com/react-native-oh-library/react-native-image-zoom/releases) | 0.72 | +| 2.1.13 | [@react-native-ohos/react-native-image-pan-zoom Releases]() | 0.77 | ## 属性 diff --git a/zh-cn/react-native-json-tree.md b/zh-cn/react-native-json-tree.md index 3add10c2..2135a7a3 100644 --- a/zh-cn/react-native-json-tree.md +++ b/zh-cn/react-native-json-tree.md @@ -19,13 +19,13 @@ #### **npm** ```bash -npm install react-native-json-tree@^1.3.0 +npm install react-native-json-tree@^1.5.0 ``` #### **yarn** ```bash -yarn add react-native-json-tree@^1.3.0 +yarn add react-native-json-tree@^1.5.0 ``` diff --git a/zh-cn/react-native-linear-gradient-text.md b/zh-cn/react-native-linear-gradient-text.md index 32972cba..2dcb1cb4 100644 --- a/zh-cn/react-native-linear-gradient-text.md +++ b/zh-cn/react-native-linear-gradient-text.md @@ -23,13 +23,13 @@ #### npm ```bash -npm install react-native-linear-gradient-text@1.2.8 +npm install react-native-linear-gradient-text@1.2.12 ``` #### yarn ```bash -yarn add react-native-linear-gradient-text@1.2.8 +yarn add react-native-linear-gradient-text@1.2.12 ``` diff --git a/zh-cn/react-native-performance.md b/zh-cn/react-native-performance.md index 818b257a..05adf3bb 100644 --- a/zh-cn/react-native-performance.md +++ b/zh-cn/react-native-performance.md @@ -18,7 +18,14 @@ ## 安装与使用 -请到三方库的 Releases 发布地址查看配套的版本信息:[@react-native-oh-tpl/react-native-performance Releases](https://github.com/react-native-oh-library/react-native-performance/releases) 。对于未发布到npm的旧版本,请参考[安装指南](/zh-cn/tgz-usage.md)安装tgz包。 +请到三方库的 Releases 发布地址查看配套的版本信息: + +| 三方库版本 | 发布信息 | 支持RN版本 | +| ----------- | ------------------------------------------------------------ | ---------- | +| 5.1.2-0.0.3 | [@react-native-oh-tpl/react-native-performance Releases](https://github.com/react-native-oh-library/react-native-performance/releases) | 0.72 | +| 5.1.3 | [@react-native-ohos/react-native-performance Releases]() | 0.77 | + +对于未发布到npm的旧版本,请参考[安装指南](/zh-cn/tgz-usage.md)安装tgz包。 进入到工程目录并输入以下命令: @@ -27,13 +34,21 @@ #### **npm** ```bash +#5.1.2-0.0.3 npm install @react-native-oh-tpl/react-native-performance + +#5.1.3 +npm install @react-native-ohos/react-native-performance ``` #### **yarn** ```bash +#5.1.2-0.0.3 yarn add @react-native-oh-tpl/react-native-performance + +#5.1.3 +yarn add @react-native-ohos/react-native-performance ``` @@ -195,6 +210,8 @@ const styles = StyleSheet.create({ ``` ## 使用 Codegen +> [!TIP] V5.1.3 不需要执行 Codegen。 + 本库已经适配了 `Codegen` ,在使用前需要主动执行生成三方库桥接代码,详细请参考[ Codegen 使用文档](/zh-cn/codegen.md)。 ## Link @@ -227,6 +244,8 @@ const styles = StyleSheet.create({ 打开 `entry/oh-package.json5`,添加以下依赖 +- V5.1.2-0.0.3 + ```json "dependencies": { "@rnoh/react-native-openharmony": "file:../react_native_openharmony", @@ -234,6 +253,15 @@ const styles = StyleSheet.create({ } ``` +- V5.1.3 + +```json +"dependencies": { + "@rnoh/react-native-openharmony": "file:../react_native_openharmony", + "@react-native-oh-tpl/react-native-performance": "file:../../node_modules/@react-native-ohos/react-native-performance/harmony/react_native_performance.har" + } +``` + 点击右上角的 `sync` 按钮 或者在终端执行: @@ -253,7 +281,10 @@ ohpm install ```diff ... + //5.1.2-0.0.3 + import {RNPerformancePackage} from '@react-native-oh-tpl/react-native-performance/ts'; + //5.1.3 ++ import {RNPerformancePackage} from '@react-native-ohos/react-native-performance/ts'; export function createRNPackages(ctx: RNPackageContext): RNPackage[] { return [ @@ -282,7 +313,12 @@ ohpm install 要使用此库,需要使用正确的 React-Native 和 RNOH 版本。另外,还需要使用配套的 DevEco Studio 和 手机 ROM。 -请到三方库相应的 Releases 发布地址查看 Release 配套的版本信息:[@react-native-oh-tpl/react-native-performance Releases](https://github.com/react-native-oh-library/react-native-performance/releases) +请到三方库相应的 Releases 发布地址查看 Release 配套的版本信息: + +| 三方库版本 | 发布信息 | 支持RN版本 | +| ----------- | ------------------------------------------------------------ | ---------- | +| 5.1.2-0.0.3 | [@react-native-oh-tpl/react-native-performance Releases](https://github.com/react-native-oh-library/react-native-performance/releases) | 0.72 | +| 5.1.3 | [@react-native-ohos/react-native-performance Releases]() | 0.77 | ## Performance diff --git a/zh-cn/react-native-safe-module.md b/zh-cn/react-native-safe-module.md index c5868a7f..408b97ff 100644 --- a/zh-cn/react-native-safe-module.md +++ b/zh-cn/react-native-safe-module.md @@ -16,7 +16,14 @@ ## 安装与使用 -请到三方库的 Releases 发布地址查看配套的版本信息:[@react-native-oh-tpl/react-native-safe-module Releases](https://github.com/react-native-oh-library/react-native-safe-module/releases) 。对于未发布到npm的旧版本,请参考[安装指南](/zh-cn/tgz-usage.md)安装tgz包。 +请到三方库的 Releases 发布地址查看配套的版本信息: + +| 三方库版本 | 发布信息 | 支持RN版本 | +| ---------- | ------------------------------------------------------------ | ---------- | +| 1.2.0 | [@react-native-oh-tpl/react-native-safe-module Releases](https://github.com/react-native-oh-library/react-native-safe-module/releases) | 0.72 | +| 1.2.1 | [@react-native-ohos/react-native-safe-module Releases]() | 0.77 | + +对于未发布到npm的旧版本,请参考[安装指南](/zh-cn/tgz-usage.md)安装tgz包。 进入到工程目录并输入以下命令: @@ -26,13 +33,21 @@ #### **npm** ```bash +#1.2.0 npm install @react-native-oh-tpl/react-native-safe-module + +#1.2.1 +npm install @react-native-ohos/react-native-safe-module ``` #### **yarn** ```bash +#1.2.0 yarn add @react-native-oh-tpl/react-native-safe-module + +#1.2.1 +yarn add @react-native-ohos/react-native-safe-module ``` @@ -69,9 +84,12 @@ export default App; 要使用此库,需要使用正确的 React-Native 和 RNOH 版本。另外,还需要使用配套的 DevEco Studio 和 手机 ROM。 -请到三方库相应的 Releases 发布地址查看 Release 配套的版本信息:[@react-native-oh-tpl/react-native-safe-module Releases](https://github.com/react-native-oh-library/react-native-safe-module/releases) +请到三方库相应的 Releases 发布地址查看 Release 配套的版本信息: -## API +| 三方库版本 | 发布信息 | 支持RN版本 | +| ---------- | ------------------------------------------------------------ | ---------- | +| 1.2.0 | [@react-native-oh-tpl/react-native-safe-module Releases](https://github.com/react-native-oh-library/react-native-safe-module/releases) | 0.72 | +| 1.2.1 | [@react-native-ohos/react-native-safe-module Releases]() | 0.77 | > [!TIP] "Platform"列表示该属性在原三方库上支持的平台。 diff --git a/zh-cn/remobile-react-native-toast.md b/zh-cn/remobile-react-native-toast.md index 5b2fb15c..7d9d1831 100644 --- a/zh-cn/remobile-react-native-toast.md +++ b/zh-cn/remobile-react-native-toast.md @@ -19,7 +19,14 @@ ## 安装与使用 请到三方库的 Releases -发布地址查看配套的版本信息:[@react-native-oh-tpl/react-native-toast Releases](https://github.com/react-native-oh-library/react-native-toast/releases) 。对于未发布到npm的旧版本,请参考[安装指南](/zh-cn/tgz-usage.md)安装tgz包。 +发布地址查看配套的版本信息: + +| 三方库版本 | 发布信息 | 支持RN版本 | +| ----------- | ------------------------------------------------------------ | ---------- | +| 1.0.7-0.0.3 | [@react-native-oh-tpl/react-native-toast Releases](https://github.com/react-native-oh-library/react-native-toast/releases) | 0.72 | +| 1.0.8 | [@react-native-ohos/react-native-toast Releases]() | 0.77 | + +对于未发布到npm的旧版本,请参考[安装指南](/zh-cn/tgz-usage.md)安装tgz包。 进入到工程目录并输入以下命令: @@ -28,13 +35,21 @@ #### **npm** ```bash +#1.0.7-0.0.3 npm install @react-native-oh-tpl/react-native-toast + +#1.0.8 +npm install @react-native-ohos/react-native-toast ``` #### **yarn** ```bash +#1.0.7-0.0.3 yarn add @react-native-oh-tpl/react-native-toast + +#1.0.8 +yarn add @react-native-ohos/react-native-toast ``` @@ -104,6 +119,8 @@ export default ToastMasterDemo; ## 使用 Codegen +> [!TIP] V1.0.8 不需要执行 Codegen。 + 本库已经适配了 `Codegen` ,在使用前需要主动执行生成三方库桥接代码,详细请参考[ Codegen 使用文档](/zh-cn/codegen.md)。 ## Link @@ -136,6 +153,8 @@ export default ToastMasterDemo; 打开 `entry/oh-package.json5`,添加以下依赖 +- V1.0.7-0.0.3 + ```json "dependencies": { "@rnoh/react-native-openharmony": "file:../react_native_openharmony", @@ -143,6 +162,15 @@ export default ToastMasterDemo; } ``` +- V1.0.8 + +```json +"dependencies": { +"@rnoh/react-native-openharmony": "file:../react_native_openharmony", +"@react-native-oh-tpl/react-native-toast": "file:../../node_modules/@react-native-ohos/react-native-toast/harmony/rn_toast.har" +} +``` + 点击右上角的 `sync` 按钮 或者在终端执行: @@ -162,8 +190,10 @@ ohpm install ```diff ... + //1.0.7-0.0.3 + import {ToastPackage} from '@react-native-oh-tpl/react-native-toast/ts'; - + //1.0.8 ++ import {ToastPackage} from '@react-native-ohos/react-native-toast/ts'; export function createRNPackages(ctx: RNPackageContext): RNPackage[] { return [ new SamplePackage(ctx), @@ -192,7 +222,12 @@ ohpm install 要使用此库,需要使用正确的 React-Native 和 RNOH 版本。另外,还需要使用配套的 DevEco Studio 和 手机 ROM。 请到三方库相应的 Releases 发布地址查看 Release -配套的版本信息:[@react-native-oh-tpl/react-native-toast Releases](https://github.com/react-native-oh-library/react-native-toast/releases) +配套的版本信息: + +| 三方库版本 | 发布信息 | 支持RN版本 | +| ----------- | ------------------------------------------------------------ | ---------- | +| 1.0.7-0.0.3 | [@react-native-oh-tpl/react-native-toast Releases](https://github.com/react-native-oh-library/react-native-toast/releases) | 0.72 | +| 1.0.8 | [@react-native-ohos/react-native-toast Releases]() | 0.77 | ## API diff --git a/zh-cn/rn-bugly.md b/zh-cn/rn-bugly.md index 4884bf9b..95b0f0b5 100644 --- a/zh-cn/rn-bugly.md +++ b/zh-cn/rn-bugly.md @@ -17,7 +17,14 @@ ## 安装与使用 -请到三方库的 Releases 发布地址查看配套的版本信息:[@react-native-oh-tpl/rn-bugly Releases](https://github.com/react-native-oh-library/rn-bugly/releases) 。对于未发布到npm的旧版本,请参考[安装指南](/zh-cn/tgz-usage.md)安装tgz包。 +请到三方库的 Releases 发布地址查看配套的版本信息: + +| 三方库版本 | 发布信息 | 支持RN版本 | +| ------------------ | ------------------------------------------------------------ | ---------- | +| 1.3.0-beta.3-0.0.1 | [@react-native-oh-tpl/rn-bugly Releases](https://github.com/react-native-oh-library/rn-bugly/releases) | 0.72 | +| 1.3.0-beta.3-0.0.2 | [@react-native-ohos/rn-bugly Releases]() | 0.77 | + +对于未发布到npm的旧版本,请参考[安装指南](/zh-cn/tgz-usage.md)安装tgz包。 进入到工程目录并输入以下命令: @@ -26,13 +33,21 @@ #### **npm** ```bash +#1.3.0-beta.3-0.0.1 npm install @react-native-oh-tpl/rn-bugly + +#1.3.0-beta.3-0.0.2 +npm install @react-native-ohos/rn-bugly ``` #### **yarn** ```bash +#1.3.0-beta.3-0.0.1 yarn add @react-native-oh-tpl/rn-bugly + +#1.3.0-beta.3-0.0.2 +yarn add @react-native-ohos/rn-bugly ``` @@ -126,6 +141,8 @@ export default class BuglyExample extends React.Component { 打开 `entry/oh-package.json5`,添加以下依赖 +- V1.3.0-beta.3-0.0.1 + ```json "dependencies": { "@rnoh/react-native-openharmony": "file:../react_native_openharmony", @@ -133,6 +150,15 @@ export default class BuglyExample extends React.Component { } ``` +- V1.3.0-beta.3-0.0.2 + +```json +"dependencies": { + "@rnoh/react-native-openharmony": "file:../react_native_openharmony", + "@react-native-ohos/rn-bugly": "file:../../node_modules/@react-native-ohos/rn-bugly/harmony/bugly.har" + } +``` + 点击右上角的 `sync` 按钮 或者在终端执行: @@ -168,7 +194,11 @@ add_subdirectory("${RNOH_CPP_DIR}" ./rn) # RNOH_BEGIN: manual_package_linking_1 add_subdirectory("../../../../sample_package/src/main/cpp" ./sample-package) +# 1.3.0-beta.3-0.0.1 + add_subdirectory("${OH_MODULES}/@react-native-oh-tpl/rn-bugly/src/main/cpp" ./bugly) + +# 1.3.0-beta.3-0.0.2 ++ add_subdirectory("${OH_MODULES}/@react-native-ohos/rn-bugly/src/main/cpp" ./bugly) # RNOH_END: manual_package_linking_1 file(GLOB GENERATED_CPP_FILES "./generated/*.cpp") @@ -211,8 +241,12 @@ std::vector> PackageProvider::getPackages(Package::Cont ```diff ... + //1.3.0-beta.3-0.0.1 + import {RNBuglyPackage} from '@react-native-oh-tpl/rn-bugly/ts'; + //1.3.0-beta.3-0.0.2 ++ import {RNBuglyPackage} from '@react-native-ohos/rn-bugly/ts'; + export function createRNPackages(ctx: RNPackageContext): RNPackage[] { return [ new SamplePackage(ctx), @@ -240,7 +274,12 @@ ohpm install 要使用此库,需要使用正确的 React-Native 和 RNOH 版本。另外,还需要使用配套的 DevEco Studio 和 手机 ROM。 -请到三方库相应的 Releases 发布地址查看 Release 配套的版本信息:[@react-native-oh-tpl/rn-bugly Releases](https://github.com/react-native-oh-library/rn-bugly/releases) +请到三方库相应的 Releases 发布地址查看 Release 配套的版本信息: + +| 三方库版本 | 发布信息 | 支持RN版本 | +| ------------------ | ------------------------------------------------------------ | ---------- | +| 1.3.0-beta.3-0.0.1 | [@react-native-oh-tpl/rn-bugly Releases](https://github.com/react-native-oh-library/rn-bugly/releases) | 0.72 | +| 1.3.0-beta.3-0.0.2 | [@react-native-ohos/rn-bugly Releases]() | 0.77 | ## API -- Gitee