From 02816f6b6f9ea91c79d7f12c216b63015aa86f88 Mon Sep 17 00:00:00 2001 From: sunshinezjb Date: Fri, 29 Nov 2024 14:07:01 +0800 Subject: [PATCH 1/6] =?UTF-8?q?docs:=20=E4=BF=AE=E6=94=B9react-native-doc-?= =?UTF-8?q?viewer,react-native-textinput-maxlength-fixed,react-native-conf?= =?UTF-8?q?ig,react-native-idfa-aaid,react-native-custom-keyboard=E8=8B=B1?= =?UTF-8?q?=E6=96=87=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- en/react-native-custom-keyboard.md | 88 ++++++++++---------- en/react-native-doc-viewer.md | 80 +++++++++--------- en/react-native-idfa-aaid.md | 80 +++++++++--------- en/react-native-textinput-maxlength-fixed.md | 65 +++++++-------- 4 files changed, 156 insertions(+), 157 deletions(-) diff --git a/en/react-native-custom-keyboard.md b/en/react-native-custom-keyboard.md index 6fbf6f6c..7abad8c9 100644 --- a/en/react-native-custom-keyboard.md +++ b/en/react-native-custom-keyboard.md @@ -1,5 +1,5 @@ -> 模板版本：v0.2.2 +> Template version: v0.2.2

react-native-custom-keyboard

@@ -13,13 +13,13 @@

-> [!TIP] [Github 地址](https://github.com/react-native-oh-library/react-native-custom-keyboard) +> [!TIP] [GitHub address](https://github.com/react-native-oh-library/react-native-custom-keyboard) -## 安装与使用 +## Installation and Usage Find the matching version information in the release address of a third-party library：[@react-native-oh-tpl/react-native-custom-keyboard Releases](https://github.com/react-native-oh-library/react-native-custom-keyboard/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: #### **npm** @@ -34,9 +34,9 @@ npm install @react-native-oh-tpl/react-native-custom-keyboard yarn add @react-native-oh-tpl/react-native-custom-keyboard ``` -下面的代码展示了这个库的基本使用场景： +The following code shows the basic use scenario of the repository: -> [!WARNING] 使用时 import 的库名不变。 +> [!WARNING] The name of the imported repository remains unchanged. ```js import React from 'react'; @@ -150,17 +150,17 @@ const styles = StyleSheet.create({ }); ``` -## 使用 Codegen +## Use Codegen -本库已经适配了 `Codegen` ，在使用前需要主动执行生成三方库桥接代码，详细请参考[ Codegen 使用文档](/zh-cn/codegen.md)。 +If this repository has been adapted to `Codegen`, generate the bridge code of the third-party library by using the `Codegen`. For details, see [Codegen Usage Guide](/en/codegen.md). ## Link -目前 HarmonyOS 暂不支持 AutoLink，所以 Link 步骤需要手动配置。 +Currently, HarmonyOS does not support AutoLink. Therefore, you need to manually configure the linking. -首先需要使用 DevEco Studio 打开项目里的 HarmonyOS 工程 `harmony` +Open the `harmony` directory of the HarmonyOS project in DevEco Studio. -### 1.在工程根目录的 `oh-package.json5` 添加 overrides 字段 +### 1. Adding the overrides Field to oh-package.json5 File in the Root Directory of the Project ```json { @@ -171,18 +171,18 @@ const styles = StyleSheet.create({ } ``` -### 2.引入原生端代码 +### 2. Introducing Native Code -目前有两种方法： +Currently, two methods are available: -1. 通过 har 包引入（在 IDE 完善相关功能后该方法会被遗弃，目前首选此方法）； -2. 直接链接源码。 +1. Use the HAR file(recommended)； +2. Directly link to the source code. -方法一：通过 har 包引入（推荐） +Method 1 (recommended): Use the HAR file. -> [!TIP] har 包位于三方库安装路径的 `harmony` 文件夹下。 +> [!TIP] The HAR file is stored in the `harmony` directory in the installation path of the third-party library. -打开 `entry/oh-package.json5`，添加以下依赖 +Open `entry/oh-package.json5` file and add the following dependencies: ```json "dependencies": { @@ -191,22 +191,22 @@ const styles = StyleSheet.create({ } ``` -点击右上角的 `sync` 按钮 +Click the `sync` button in the upper right corner. -或者在终端执行： +Alternatively, run the following instruction on the terminal: ```bash cd entry ohpm install ``` -方法二：直接链接源码 +Method 2: Directly link to the source code. -> [!TIP] 如需使用直接链接源码，请参考[直接链接源码说明](/zh-cn/link-source-code.md) +> [!TIP] For details, see [Directly Linking Source Code](/en/link-source-code.md). -### 3.配置 CMakeLists 和引入 rnoh_custom_keyboard_package +### 3.Configuring CMakeLists and Introducing rnoh_custom_keyboard_package Package -打开 `entry/src/main/cpp/CMakeLists.txt`，添加： +Open `entry/src/main/cpp/CMakeLists.txt` and add the following code: ```diff project(rnapp) @@ -244,7 +244,7 @@ target_link_libraries(rnoh_app PUBLIC rnoh_sample_package) # RNOH_END: manual_package_linking_2 ``` -打开 `entry/src/main/cpp/PackageProvider.cpp`，添加： +Open `entry/src/main/cpp/PackageProvider.cpp` and add the following code: ```diff #include "RNOH/PackageProvider.h" @@ -263,9 +263,9 @@ std::vector> PackageProvider::getPackages(Package::Cont } ``` -### 4.在 ArkTs 侧引入 RNCustomKeyboardPackage +### 4.Introducing RNCustomKeyboardPackage Package to ArkTS -打开 `entry/src/main/ets/RNPackagesFactory.ts`，添加： +Open `entry/src/main/ets/RNPackagesFactory.ts` and add the following code: ```diff ... @@ -280,32 +280,32 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { } ``` -### 5.运行 +### 5.Running -点击右上角的 `sync` 按钮 +Click the `sync` button in the upper right corner. -或者在终端执行： +Alternatively, run the following instruction on the terminal: ```bash cd entry ohpm install ``` -然后编译、运行即可。 +Then build and run the code. -## 约束与限制 +## Constraints -### 兼容性 +### Compatibility -要使用此库，需要使用正确的 React-Native 和 RNOH 版本。另外，还需要使用配套的 DevEco Studio 和 手机 ROM。 +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. -请到三方库相应的 Releases 发布地址查看 Release 配套的版本信息：[@react-native-oh-tpl/react-native-custom-keyboard Releases](https://github.com/react-native-oh-library/react-native-custom-keyboard/releases) +Check the release version information in the release address of the third-party library: [@react-native-oh-tpl/react-native-custom-keyboard Releases](https://github.com/react-native-oh-library/react-native-custom-keyboard/releases) -## 属性 +## Properties (If Any) -> [!TIP] "Platform"列表示该属性在原三方库上支持的平台。 +> [!TIP] The **Platform** column indicates the platform where the properties are supported in the original third-party library. -> [!TIP] "HarmonyOS Support"列为 yes 表示 HarmonyOS 平台支持该属性；no 则表示不支持；partially 表示部分支持。使用方法跨平台一致，效果对标 iOS 或 Android 的效果。 +> [!TIP] If the value of **HarmonyOS Support** is **yes**, it means that the HarmonyOS platform supports this property; **no** means the opposite; **partially** means some capabilities of this property are supported. The usage method is the same on different platforms and the effect is the same as that of iOS or Android. | Name | Description | Type | Required | Platform | HarmonyOS Support | | ------------------ | --------------------------------- | ------ | -------- | -------- | ----------------- | @@ -313,9 +313,9 @@ ohpm install ## API -> [!TIP] "Platform"列表示该属性在原三方库上支持的平台。 +> [!TIP] The **Platform** column indicates the platform where the properties are supported in the original third-party library. -> [!TIP] "HarmonyOS Support"列为 yes 表示 HarmonyOS 平台支持该属性；no 则表示不支持；partially 表示部分支持。使用方法跨平台一致，效果对标 iOS 或 Android 的效果。 +> [!TIP] If the value of **HarmonyOS Support** is **yes**, it means that the HarmonyOS platform supports this property; **no** means the opposite; **partially** means some capabilities of this property are supported. The usage method is the same on different platforms and the effect is the same as that of iOS or Android. | Name | Description | Type | Required | Platform | HarmonyOS Support | | -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | -------- | -------- | ----------------- | @@ -329,10 +329,10 @@ ohpm install | moveRight | Use in a custom keyboard, move cursor to selection end or move cursor right. | function | no | All | yes | | switchSystemKeyboard | Use in a custom keyboard. Switch to system keyboard.Next time user press or focus on the TextInput, custom keyboard will appear again. To keep using system keyboard, call uninstall instead. | function | no | All | yes | -## 其他 +## Others -## 遗留问题 +## Known Issues -## 开源协议 +## License -本项目基于 [The MIT License (MIT)](https://www.mit-license.org) ，请自由地享受和参与开源。 +This project is licensed under [The MIT License (MIT)](https://www.mit-license.org). \ No newline at end of file diff --git a/en/react-native-doc-viewer.md b/en/react-native-doc-viewer.md index 6af159a0..ad2d7f71 100644 --- a/en/react-native-doc-viewer.md +++ b/en/react-native-doc-viewer.md @@ -1,4 +1,4 @@ -> 模板版本：v0.2.2 +> Template version: v0.2.2

react-native-doc-viewer

@@ -12,13 +12,13 @@

-> [!TIP] [Github 地址](https://github.com/react-native-oh-library/react-native-doc-viewer) +> [!TIP] [GitHub address](https://github.com/react-native-oh-library/react-native-doc-viewer) -## 安装与使用 +## Installation and Usage Find the matching version information in the release address of a third-party library：[@react-native-oh-tpl/react-native-doc-viewer Releases](https://github.com/react-native-oh-library/react-native-doc-viewer/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: @@ -37,9 +37,9 @@ yarn add @react-native-oh-tpl/react-native-doc-viewer -下面的代码展示了这个库的基本使用场景： +The following code shows the basic use scenario of the repository: -> [!WARNING] 使用时 import 的库名不变。 +> [!WARNING] The name of the imported repository remains unchanged. ```js import React, { Component } from 'react'; @@ -323,17 +323,17 @@ export default class DocumentViewerExample extends Component { } ``` -## 使用 Codegen +## Use Codegen -本库已经适配了 `Codegen` ，在使用前需要主动执行生成三方库桥接代码，详细请参考[ Codegen 使用文档](/zh-cn/codegen.md)。 +If this repository has been adapted to `Codegen`, generate the bridge code of the third-party library by using the `Codegen`. For details, see [Codegen Usage Guide](/en/codegen.md). ## Link -目前 HarmonyOS 暂不支持 AutoLink，所以 Link 步骤需要手动配置。 +Currently, HarmonyOS does not support AutoLink. Therefore, you need to manually configure the linking. -首先需要使用 DevEco Studio 打开项目里的 HarmonyOS 工程 `harmony` +Open the `harmony` directory of the HarmonyOS project in DevEco Studio. -### 1.在工程根目录的 `oh-package.json5` 添加 overrides 字段 +### 1. Adding the overrides Field to oh-package.json5 File in the Root Directory of the Project ```json { @@ -344,18 +344,18 @@ export default class DocumentViewerExample extends Component { } ``` -### 2.引入原生端代码 +### 2. Introducing Native Code -目前有两种方法： +Currently, two methods are available: -1. 通过 har 包引入（在 IDE 完善相关功能后该方法会被遗弃，目前首选此方法）； -2. 直接链接源码。 +1. Use the HAR file(recommended)； +2. Directly link to the source code. -方法一：通过 har 包引入（推荐） +Method 1 (recommended): Use the HAR file. -> [!TIP] har 包位于三方库安装路径的 `harmony` 文件夹下。 +> [!TIP] The HAR file is stored in the `harmony` directory in the installation path of the third-party library. -打开 `entry/oh-package.json5`，添加以下依赖 +Open `entry/oh-package.json5` file and add the following dependencies: ```json "dependencies": { @@ -364,22 +364,22 @@ export default class DocumentViewerExample extends Component { } ``` -点击右上角的 `sync` 按钮 +Click the `sync` button in the upper right corner. -或者在终端执行： +Alternatively, run the following instruction on the terminal: ```bash cd entry ohpm install ``` -方法二：直接链接源码 +Method 2: Directly link to the source code. -> [!TIP] 如需使用直接链接源码，请参考[直接链接源码说明](/zh-cn/link-source-code.md) +> [!TIP] For details, see [Directly Linking Source Code](/en/link-source-code.md). -### 3.引入 DocViewPackage +### 3.Introducing DocViewPackage Component to ArkTS -打开 `entry/src/main/ets/RNPackagesFactory.ts`，添加： +Open the `entry/src/main/ets/RNPackagesFactory.ts` file and add the following code: ```diff ... @@ -393,41 +393,41 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { } ``` -### 4.运行 +### 4. Running -点击右上角的 `sync` 按钮 +Click the `sync` button in the upper right corner. -或者在终端执行： +Alternatively, run the following instruction on the terminal: ```bash cd entry ohpm install ``` -然后编译、运行即可。 +Then build and run the code. -## 约束与限制 +## Constraints -### 兼容性 +### Compatibility -要使用此库，需要使用正确的 React-Native 和 RNOH 版本。另外，还需要使用配套的 DevEco Studio 和 手机 ROM。 +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. -请到三方库相应的 Releases 发布地址查看 Release 配套的版本信息：[@react-native-oh-tpl/react-native-doc-viewer Releases](https://github.com/react-native-oh-library/react-native-doc-viewer/releases) +Check the release version information in the release address of the third-party library: [@react-native-oh-tpl/react-native-doc-viewer Releases](https://github.com/react-native-oh-library/react-native-doc-viewer/releases) ## API -> [!TIP] "Platform"列表示该属性在原三方库上支持的平台。 +> [!TIP] The **Platform** column indicates the platform where the properties are supported in the original third-party library. -> [!TIP] "HarmonyOS Support"列为 yes 表示 HarmonyOS 平台支持该属性；no 则表示不支持；partially 表示部分支持。使用方法跨平台一致，效果对标 iOS 或 Android 的效果。 +> [!TIP] If the value of **HarmonyOS Support** is **yes**, it means that the HarmonyOS platform supports this property; **no** means the opposite; **partially** means some capabilities of this property are supported. The usage method is the same on different platforms and the effect is the same as that of iOS or Android. | Name | Description | Type | Required | Platform | HarmonyOS Support | | ------------------ | -------------------------- | -------- | -------- | -------- | ----------------- | -| openDoc | 打开一个在线文档 | function | no | All | yes | -| openDocBinaryinUrl | 打开一个在线文档 | function | no | All | yes | -| openDocb64 | 将 base64 字符串打开为文档 | function | no | All | yes | +| openDoc | open a online document | function | no | All | yes | +| openDocBinaryinUrl | open a online document | function | no | All | yes | +| openDocb64 | open base64 string as document | function | no | All | yes | -## 遗留问题 +## Known Issues -## 开源协议 +## License -本项目基于 [The MIT License (MIT)](https://github.com/philipphecht/react-native-doc-viewer/blob/master/LICENSE) ，请自由地享受和参与开源。 +This project is licensed under [The MIT License (MIT)](https://github.com/philipphecht/react-native-doc-viewer/blob/master/LICENSE) \ No newline at end of file diff --git a/en/react-native-idfa-aaid.md b/en/react-native-idfa-aaid.md index 5cc7e0c9..fdb86f7b 100644 --- a/en/react-native-idfa-aaid.md +++ b/en/react-native-idfa-aaid.md @@ -1,4 +1,4 @@ -> 模板版本：v0.2.2 +> Template version: v0.2.2

react-native-idfa-aaid

@@ -12,13 +12,13 @@

-> [!TIP] [Github 地址](https://github.com/react-native-oh-library/react-native-idfa-aaid) +> [!TIP] [GitHub address](https://github.com/react-native-oh-library/react-native-idfa-aaid) -## 安装与使用 +## Installation and Usage Find the matching version information in the release address of a third-party library:[@react-native-oh-library/react-native-idfa-aaid Releases](https://github.com/react-native-oh-library/react-native-idfa-aaid/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: @@ -36,9 +36,9 @@ yarn add @react-native-oh-tpl/react-native-idfa-aaid -下面的代码展示了这个库的基本使用场景： +The following code shows the basic use scenario of the repository: -> [!WARNING] 使用时 import 的库名不变。 +> [!WARNING] The name of the imported repository remains unchanged. ``` import React, { useEffect } from 'react'; @@ -168,17 +168,17 @@ const styles = StyleSheet.create({ export default App; ``` -## 使用 Codegen +## Use Codegen -本库已经适配了 `Codegen` ，在使用前需要主动执行生成三方库桥接代码，详细请参考[ Codegen 使用文档](/zh-cn/codegen.md)。 +If this repository has been adapted to `Codegen`, generate the bridge code of the third-party library by using the `Codegen`. For details, see [Codegen Usage Guide](/en/codegen.md). ## Link -目前 HarmonyOS 暂不支持 AutoLink，所以 Link 步骤需要手动配置。 +Currently, HarmonyOS does not support AutoLink. Therefore, you need to manually configure the linking. -首先需要使用 DevEco Studio 打开项目里的 HarmonyOS 工程 `harmony` +Open the `harmony` directory of the HarmonyOS project in DevEco Studio. -### 1.在工程根目录的 `oh-package.json5` 添加 overrides 字段 +### 1. Adding the overrides Field to oh-package.json5 File in the Root Directory of the Project ```json { @@ -189,18 +189,18 @@ export default App; } ``` -### 2.引入原生端代码 +### 2.Introducing Native Code -目前有两种方法： +Currently, two methods are available: -1. 通过 har 包引入（在 IDE 完善相关功能后该方法会被遗弃，目前首选此方法）； -2. 直接链接源码。 +1. Use the HAR file(recommended)； +2. Directly link to the source code. -方法一：通过 har 包引入（推荐） +Method 1 (recommended): Use the HAR file. -> [!TIP] har 包位于三方库安装路径的 `harmony` 文件夹下。 +> [!TIP] The HAR file is stored in the `harmony` directory in the installation path of the third-party library. -打开 `entry/oh-package.json5`，添加以下依赖 +Open `entry/oh-package.json5` file and add the following dependencies: ```json "dependencies": { @@ -209,23 +209,23 @@ export default App; } ``` -点击右上角的 `sync` 按钮 +Click the `sync` button in the upper right corner. -或者在终端执行： +Alternatively, run the following instruction on the terminal: ```bash cd entry ohpm install ``` -方法二：直接链接源码 +Method 2: Directly link to the source code. -> [!TIP] 如需使用直接链接源码，请参考[直接链接源码说明](/zh-cn/link-source-code.md) +> [!TIP] For details, see [Directly Linking Source Code](/en/link-source-code.md). -### 3.在 ArkTs 侧引入 GetOaidPackage +### 3. Introducing GetOaidPackage Package to ArkTS -打开 `entry/src/main/ets/RNPackagesFactory.ts`，添加： +Open the `entry/src/main/ets/RNPackagesFactory.ts` file and add the following code: ```diff ... @@ -239,27 +239,27 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { ]; } ``` -### 4.运行 +### 4. Running -点击右上角的 `sync` 按钮 +Click the `sync` button in the upper right corner. -或者在终端执行： +Alternatively, run the following instruction on the terminal: ```bash cd entry ohpm install ``` -然后编译、运行即可。 +Then build and run the code. -## 约束与限制 +## Constraints -### 兼容性 +### Compatibility -要使用此库，需要使用正确的 React-Native 和 RNOH 版本。另外，还需要使用配套的 DevEco Studio 和 手机 ROM。 -请到三方库相应的 Releases 发布地址查看 Release 配套的版本信息：[@react-native-oh-library/react-native-idfa-aaid Releases](https://github.com/react-native-oh-library/react-native-idfa-aaid/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. +Check the release version information in the release address of the third-party library: [@react-native-oh-library/react-native-idfa-aaid Releases](https://github.com/react-native-oh-library/react-native-idfa-aaid/releases) -### 权限要求 +### Permission Requirements (If Any) [!TIP] "ohos.permission.APP_TRACKING_CONSENT"，"ohos.permission.APP_TRACKING_CONSENT"权限等级为normal，授权方式为user_grant[使用 ACL 签名的配置指导](https://developer.harmonyos.com/cn/docs/documentation/doc-guides-V3/signing-0000001587684945-V3#section157591551175916) @@ -309,21 +309,21 @@ ohpm install 当前版本上，向用户申请此权限时，系统不会有弹框，而是直接将该应用的获取OAID的权限置为禁止。如有需要应用可自行弹框引导用户到设置界面手动开启该权限。为避免后续系统功能变化引发兼容性问题，应用应严格按照user_grant权限的申请流程进行申请。 [详情参考](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/permissions-for-all-V5#ohospermissionapp_tracking_consent) -## 静态方法 +## Static Methods (If Any) -> [!TIP] "Platform"列表示该属性在原三方库上支持的平台。 +> [!TIP] The **Platform** column indicates the platform where the properties are supported in the original third-party library. -> [!TIP] "HarmonyOS Support"列为 yes 表示 HarmonyOS 平台支持该属性；no 则表示不支持；partially 表示部分支持。使用方法跨平台一致，效果对标 iOS 或 Android 的效果。 +> [!TIP] If the value of **HarmonyOS Support** is **yes**, it means that the HarmonyOS platform supports this property; **no** means the opposite; **partially** means some capabilities of this property are supported. The usage method is the same on different platforms and the effect is the same as that of iOS or Android. | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | | getAdvertisingInfo |Check the permission, apply for the permission, and obtain the OAID. | Function | yes | iOS/Android | yes | | getAdvertisingInfoAndCheckAuthorization | The function is the same as above, and is used to keep the porting uniform. | Function | no | iOS/Android | yes | -## 遗留问题 +## Known Issues -## 其他 +## Others -## 开源协议 +## License -本项目基于 [The MIT License (MIT)](https://github.com/sparkfabrik/sparkfabrik-react-native-idfa-aaid/blob/main/LICENSE) ，请自由地享受和参与开源。 \ No newline at end of file +This project is licensed under [The MIT License (MIT)](https://github.com/sparkfabrik/sparkfabrik-react-native-idfa-aaid/blob/main/LICENSE) \ No newline at end of file diff --git a/en/react-native-textinput-maxlength-fixed.md b/en/react-native-textinput-maxlength-fixed.md index 2c35e491..98a5b792 100644 --- a/en/react-native-textinput-maxlength-fixed.md +++ b/en/react-native-textinput-maxlength-fixed.md @@ -11,14 +11,13 @@

-> [!TIP] [Github 地址](https://github.com/react-native-oh-library/react-native-textinput-maxlength-fixed) +> [!TIP] [GitHub address](https://github.com/react-native-oh-library/react-native-textinput-maxlength-fixed) -## 安装与使用 +## Installation and Usage Find the matching version information in the release address of a third-party library：[@react-native-oh-tpl/react-native-textinput-maxlength-fixed Releases](https://github.com/react-native-oh-library/react-native-textinput-maxlength-fixed/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: @@ -36,9 +35,9 @@ yarn add @react-native-oh-tpl/react-native-textinput-maxlength-fixed -下面的代码展示了这个库的基本使用场景： +The following code shows the basic use scenario of the repository: -> [!WARNING] 使用时 import 的库名不变。 +> [!WARNING] The name of the imported repository remains unchanged. ```ts import * as React from 'react'; @@ -81,17 +80,17 @@ const styles = StyleSheet.create({ }); ``` -## 使用 Codegen +## Use Codegen -本库已经适配了 `Codegen` ，在使用前需要主动执行生成三方库桥接代码，详细请参考[ Codegen 使用文档](/zh-cn/codegen.md)。 +If this repository has been adapted to `Codegen`, generate the bridge code of the third-party library by using the `Codegen`. For details, see [Codegen Usage Guide](/en/codegen.md). ## Link -目前 HarmonyOS 暂不支持 AutoLink，所以 Link 步骤需要手动配置。 +Currently, HarmonyOS does not support AutoLink. Therefore, you need to manually configure the linking. -首先需要使用 DevEco Studio 打开项目里的 HarmonyOS 工程 `harmony` +Open the `harmony` directory of the HarmonyOS project in DevEco Studio. -### 1.在工程根目录的 `oh-package.json5` 添加 overrides 字段 +### 1.Adding the overrides Field to oh-package.json5 File in the Root Directory of the Project ```json { @@ -102,18 +101,18 @@ const styles = StyleSheet.create({ } ``` -### 2.引入原生端代码 +### 2.Introducing Native Code -目前有两种方法： +Currently, two methods are available: -1. 通过 har 包引入（在 IDE 完善相关功能后该方法会被遗弃，目前首选此方法）； -2. 直接链接源码。 +1. Use the HAR file(recommended)； +2. Directly link to the source code. -方法一：通过 har 包引入（推荐） +Method 1 (recommended): Use the HAR file. -> [!TIP] har 包位于三方库安装路径的 `harmony` 文件夹下。 +> [!TIP] The HAR file is stored in the `harmony` directory in the installation path of the third-party library. -打开 `entry/oh-package.json5`，添加以下依赖 +Open `entry/oh-package.json5` file and add the following dependencies: ```json "dependencies": { @@ -121,15 +120,15 @@ const styles = StyleSheet.create({ "@react-native-oh-tpl/react-native-textinput-maxlength-fixed": "file:../../node_modules/@react-native-oh-tpl/react-native-textinput-maxlength-fixed/harmony/textinput_maxlength_fixed.har" } ``` -点击右上角的 `sync` 按钮 +Click the `sync` button in the upper right corner. -方法二：直接链接源码 +Method 2: Directly link to the source code. -> [!TIP] 如需使用直接链接源码，请参考[直接链接源码说明](/zh-cn/link-source-code.md) +> [!TIP] For details, see [Directly Linking Source Code](/en/link-source-code.md). -### 3.在 ArkTs 侧引入 RNTextinputMaxlengthFixedPackage +### 3.Introducing RNTextinputMaxlengthFixedPackage Package to ArkTS -打开 `entry/src/main/ets/rn/RNPackagesFactory.ts`，添加： +Open the `entry/src/main/ets/RNPackagesFactory.ts` file and add the following code: ```diff import { RNPackageContext, RNPackage } from '@rnoh/react-native-openharmony'; @@ -145,27 +144,27 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { ]; } ``` -## 约束与限制 +## Constraints -### 兼容性 +### Compatibility -要使用此库，需要使用正确的 React-Native 和 RNOH 版本。另外，还需要使用配套的 DevEco Studio 和 手机 ROM。 +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. -请到三方库相应的 Releases 发布地址查看 Release 配套的版本信息：[@react-native-oh-tpl/react-native-textinput-maxlength-fixed Releases](https://github.com/react-native-oh-library/react-native-textinput-maxlength-fixed/releases) +Check the release version information in the release address of the third-party library: [@react-native-oh-tpl/react-native-textinput-maxlength-fixed Releases](https://github.com/react-native-oh-library/react-native-textinput-maxlength-fixed/releases) ## API -> [!TIP] "Platform"列表示该属性在原三方库上支持的平台。 +> [!TIP] The **Platform** column indicates the platform where the properties are supported in the original third-party library. -> [!TIP] "HarmonyOS Support"列为 yes 表示 HarmonyOS 平台支持该属性；no 则表示不支持；partially 表示部分支持。使用方法跨平台一致，效果对标 iOS 或 Android 的效果。 +> [!TIP] If the value of **HarmonyOS Support** is **yes**, it means that the HarmonyOS platform supports this property; **no** means the opposite; **partially** means some capabilities of this property are supported. The usage method is the same on different platforms and the effect is the same as that of iOS or Android. | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | | multiply | Calculate the product of two numbers. | number | no | All | yes | -## 遗留问题 -## 其他 +## Known Issues +## Others -## 开源协议 +## License -本项目基于 [The MIT License (MIT)](https://github.com/react-native-oh-library/react-native-textinput-maxlength-fixed/blob/main/LICENSE) ，请自由地享受和参与开源。 +This project is licensed under [The MIT License (MIT)](https://github.com/react-native-oh-library/react-native-textinput-maxlength-fixed/blob/main/LICENSE). -- Gitee From a3b0882c5648fb164971e7d9876d3de9c7c7654b Mon Sep 17 00:00:00 2001 From: sunshinezjb Date: Fri, 29 Nov 2024 16:21:52 +0800 Subject: [PATCH 2/6] =?UTF-8?q?docs:=20=E4=BF=AE=E6=94=B9react-native-cale?= =?UTF-8?q?ndars,react-native-chart-kit,react-native-swipe-gestures,victor?= =?UTF-8?q?y-native-xl,react-native-button,react-native-bouncy-checkbox,re?= =?UTF-8?q?act-native-bounceable=E8=8B=B1=E6=96=87=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- en/react-native-bouncy-checkbox.md | 31 ++++++++-------- en/react-native-button.md | 35 ++++++++---------- en/react-native-calendars.md | 32 ++++++++--------- en/react-native-chart-kit.md | 30 ++++++++-------- en/react-native-swipe-gestures.md | 37 ++++++++++--------- en/victory-native-xl.md | 38 ++++++++++---------- zh-cn/freakycoder-react-native-bounceable.md | 30 ++++++++-------- 7 files changed, 113 insertions(+), 120 deletions(-) diff --git a/en/react-native-bouncy-checkbox.md b/en/react-native-bouncy-checkbox.md index 688ddac3..7f8cf736 100644 --- a/en/react-native-bouncy-checkbox.md +++ b/en/react-native-bouncy-checkbox.md @@ -1,4 +1,4 @@ -> 模板版本：v0.2.2 +> Template version: v0.2.2

react-native-bouncy-checkbox

@@ -12,9 +12,9 @@

-> [!TIP] [Github 地址](https://github.com/WrathChaos/react-native-bouncy-checkbox) +> [!TIP] [GitHub address](https://github.com/WrathChaos/react-native-bouncy-checkbox) -## 安装与使用 +## Installation and Usage > [!TIP] 需要配套的服务和三方依赖 @@ -36,7 +36,8 @@ npm install --save react-native-bouncy-checkbox@4.0.1 yarn install --save react-native-bouncy-checkbox@4.0.1 ``` -下面的代码展示了这个库的基本使用场景： +The following code shows the basic use scenario of the repository: + ```js import React, { useState } from "react"; import { StyleSheet,View,Image } from 'react-native'; @@ -94,19 +95,19 @@ const styles = StyleSheet.create({ }); ``` -## 约束与限制 +## Constraints -### 兼容性 +### Compatibility -本文档内容基于以下版本验证： +This document is verified based on the following versions: 1. RNOH: 0.72.27; SDK：HarmonyOS-Next-DB1 5.0.0.25; IDE：DevEco Studio 5.0.3.404; ROM：5.0.0.31; -## 属性 +## Properties (If Any) -> [!TIP] "Platform"列表示该属性在原三方库上支持的平台。 +> [!TIP] The **Platform** column indicates the platform where the properties are supported in the original third-party library. -> [!TIP] "HarmonyOS Support"列为 yes 表示 HarmonyOS 平台支持该属性；no 则表示不支持；partially 表示部分支持。使用方法跨平台一致，效果对标 iOS 或 Android 的效果。 +> [!TIP] If the value of **HarmonyOS Support** is **yes**, it means that the HarmonyOS platform supports this property; **no** means the opposite; **partially** means some capabilities of this property are supported. The usage method is the same on different platforms and the effect is the same as that of iOS or Android. | Name | Description | Type | Required | Platform | HarmonyOS Support | @@ -136,12 +137,10 @@ const styles = StyleSheet.create({ | bouncinessIn | change the bounciness when press in | number | no | All | yes | | bouncinessOut | change the bounciness when press out | number | no | All | yes | -### - -## 遗留问题 +## Known Issues -## 其他 +## Others -## 开源协议 +## License -本项目基于 [The MIT License (MIT)](https://github.com/WrathChaos/react-native-bouncy-checkbox/blob/master/LICENSE) ，请自由地享受和参与开源。 \ No newline at end of file +This project is licensed under [The MIT License (MIT)](https://github.com/WrathChaos/react-native-bouncy-checkbox/blob/master/LICENSE). \ No newline at end of file diff --git a/en/react-native-button.md b/en/react-native-button.md index 2eb77586..8a09ab17 100644 --- a/en/react-native-button.md +++ b/en/react-native-button.md @@ -1,4 +1,4 @@ -> 模板版本：v0.2.2 +> Template version: v0.2.2

react-native-button

@@ -13,11 +13,11 @@

-> [!TIP] [Github 地址](https://github.com/ide/react-native-button) +> [!TIP] [GitHub address](https://github.com/ide/react-native-button) -## 安装与使用 +## Installation and Usage -进入到工程目录并输入以下命令： +Go to the project directory and execute the following instruction: @@ -35,7 +35,7 @@ yarn add react-native-button@3.1.0 --save -下面的代码展示了这个库的基本使用场景： +The following code shows the basic use scenario of the repository: ```js /** @@ -84,21 +84,19 @@ export default class ExampleComponent extends Component { }; ``` +## Constraints +## Compatibility -## 约束与限制 - -## 兼容性 - -本文档内容基于以下版本验证通过： +This document is verified based on the following versions: react-native-harmony：0.72.20; SDK：HarmonyOS NEXT Developer Beta1; IDE：DevEco Studio 5.0.3.200; ROM：3.0.0.18; -## 属性 +## Properties (If Any) -> [!TIP] "Platform"列表示该属性在原三方库上支持的平台。 +> [!TIP] The **Platform** column indicates the platform where the properties are supported in the original third-party library. -> [!TIP] "HarmonyOS Support"列为 yes 表示 HarmonyOS 平台支持该属性；no 则表示不支持；partially 表示部分支持。使用方法跨平台一致，效果对标 iOS 或 Android 的效果。 +> [!TIP] If the value of **HarmonyOS Support** is **yes**, it means that the HarmonyOS platform supports this property; **no** means the opposite; **partially** means some capabilities of this property are supported. The usage method is the same on different platforms and the effect is the same as that of iOS or Android. | Name | Description | Type | default | Required | Platform | HarmonyOS Support | | --------------------- | ------------------------------------------------------------------------------------------------------ | -------- | -------- | -------- | ----------------- | ----------------- | @@ -114,13 +112,10 @@ react-native-harmony：0.72.20; SDK：HarmonyOS NEXT Developer Beta1; IDE：DevE | `onPress` | Handler to be called when the user taps the button. | Function | | No | All | yes | +## Known Issues -## 遗留问题 - - 无 - -## 其他 +## Others -## 开源协议 +## License -本项目基于 [The MIT License (MIT)](https://github.com/ide/react-native-button/blob/main/LICENSE) ，请自由地享受和参与开源。 +This project is licensed under [The MIT License (MIT)](https://github.com/ide/react-native-button/blob/main/LICENSE). diff --git a/en/react-native-calendars.md b/en/react-native-calendars.md index ef9f9b3a..4accc66e 100644 --- a/en/react-native-calendars.md +++ b/en/react-native-calendars.md @@ -1,4 +1,4 @@ -> 模板版本：v0.2.2 +> Template version: v0.2.2

react-native-calendars

@@ -12,9 +12,9 @@

-> [!TIP] [Github 地址](https://github.com/wix/react-native-calendars) +> [!TIP] [GitHub address](https://github.com/wix/react-native-calendars) -## 安装与使用 +## Installation and Usage #### **npm** @@ -28,7 +28,7 @@ npm install --save react-native-calendars@1.1304.1 yarn install --react-native-calendars@1.1304.1 ``` -下面的代码展示了这个库的基本使用场景： +The following code shows the basic use scenario of the repository: ```js import React, { useState } from "react"; @@ -90,8 +90,8 @@ const MySvgComponent = () => { const styles = StyleSheet.create({ container: { - position: "absolute", // 绝对定位 - bottom: 210, // 底部边界与父容器底部对齐 + position: "absolute", + bottom: 210, width: "100%", alignItems: "center", justifyContent: "center", @@ -102,19 +102,19 @@ const styles = StyleSheet.create({ export default MySvgComponent; ``` -## 约束与限制 +## Constraints -### 兼容性 +### Compatibility -本文档内容基于以下版本验证： +This document is verified based on the following versions: 1. RNOH: 0.72.28; SDK：HarmonyOS-Next-DB1 5.0.0.25; IDE：DevEco Studio 5.0.3.535; ROM：5.0.0.31; -## 属性 +## Properties (If Any) -> [!TIP] "Platform"列表示该属性在原三方库上支持的平台。 +> [!TIP] The **Platform** column indicates the platform where the properties are supported in the original third-party library. -> [!TIP] "HarmonyOS Support"列为 yes 表示 HarmonyOS 平台支持该属性；no 则表示不支持；partially 表示部分支持。使用方法跨平台一致，效果对标 iOS 或 Android 的效果。 +> [!TIP] If the value of **HarmonyOS Support** is **yes**, it means that the HarmonyOS platform supports this property; **no** means the opposite; **partially** means some capabilities of this property are supported. The usage method is the same on different platforms and the effect is the same as that of iOS or Android. ### Agenda | Name | Description | Type | Required | Platform | HarmonyOS Support | @@ -252,10 +252,10 @@ export default MySvgComponent; | hideDayNames | Whether to hide the names of the week days | boolean | no | All | yes | -## 遗留问题 +## Known Issues -## 其他 +## Others -## 开源协议 +## License -本项目基于 [The MIT License (MIT)](https://github.com/wix/react-native-calendars/blob/master/LICENSE) ，请自由地享受和参与开源。 \ No newline at end of file +This project is licensed under [The MIT License (MIT)](https://github.com/wix/react-native-calendars/blob/master/LICENSE). \ No newline at end of file diff --git a/en/react-native-chart-kit.md b/en/react-native-chart-kit.md index 4fa8b3a5..15ec524c 100644 --- a/en/react-native-chart-kit.md +++ b/en/react-native-chart-kit.md @@ -1,4 +1,4 @@ -> 模板版本：v0.2.1 +> Template version: v0.2.1

react-native-chart-kit

@@ -19,11 +19,11 @@ > [!TIP] > -> [Github 地址](https://github.com/indiespirit/react-native-chart-kit) +> [GitHub address](https://github.com/indiespirit/react-native-chart-kit) -## 安装与使用 +## Installation and Usage -进入到工程目录并输入以下命令： +Go to the project directory and execute the following instruction: @@ -43,9 +43,9 @@ yarn add react-native-chart-kit@^6.12.0 -下面的代码展示了这个库的基本使用场景： +The following code shows the basic use scenario of the repository: -> [!WARNING] 使用时 import 的库名不变。 +> [!WARNING] The name of the imported repository remains unchanged. ```js @@ -116,19 +116,19 @@ export default MyChart; 如未引入请参照[@react-native-oh-tpl/react-native-svg文档的 Link 章节](https://gitee.com/react-native-oh-library/usage-docs/blob/master/zh-cn/react-native-svg-capi.md#link)进行引入 -## 约束与限制 +## Constraints -要使用此库，需要使用正确的 React-Native 和 RNOH 版本。另外，还需要使用配套的 DevEco Studio 和 手机 ROM。 +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. -本文档内容基于以下版本验证通过： +This document is verified based on the following versions: 1. RNOH: 0.72.20; SDK：HarmonyOS NEXT Developer Preview2; IDE：DevEco Studio 5.0.3.300SP1; ROM：3.0.0.18; -## 属性 +## Properties (If Any) -> [!TIP] "Platform"列表示该属性在原三方库上支持的平台。 +> [!TIP] The **Platform** column indicates the platform where the properties are supported in the original third-party library. -> [!TIP] "HarmonyOS Support"列为 yes 表示 HarmonyOS 平台支持该属性；no 则表示不支持；partially 表示部分支持。使用方法跨平台一致，效果对标 iOS 或 Android 的效果。 +> [!TIP] If the value of **HarmonyOS Support** is **yes**, it means that the HarmonyOS platform supports this property; **no** means the opposite; **partially** means some capabilities of this property are supported. The usage method is the same on different platforms and the effect is the same as that of iOS or Android. ### Chart style @@ -273,8 +273,8 @@ export default MyChart; | getMonthLabel | function | Function which returns the label for each month, taking month index (0 - 11) as argument | No | ALL | YES | | onDayPress | function | Callback invoked when the user clicks a day square on the chart; takes a value-item object | No | ALL | YES | -## 其他 +## Others -## 开源协议 +## License -本项目基于 [The MIT License (MIT)](https://github.com/indiespirit/react-native-chart-kit/blob/master/LICENSE) ，请自由地享受和参与开源。 \ No newline at end of file +This project is licensed under [The MIT License (MIT)](https://github.com/indiespirit/react-native-chart-kit/blob/master/LICENSE). \ No newline at end of file diff --git a/en/react-native-swipe-gestures.md b/en/react-native-swipe-gestures.md index 69557649..147f9ba5 100644 --- a/en/react-native-swipe-gestures.md +++ b/en/react-native-swipe-gestures.md @@ -1,4 +1,4 @@ -> 模板版本：v0.2.1 +> Template version: v0.2.1

react-native-swipe-gestures

@@ -16,11 +16,11 @@ -> [!TIP] [Github 地址](https://github.com/glepur/react-native-swipe-gestures) +> [!TIP] [GitHub address](https://github.com/glepur/react-native-swipe-gestures) -## 安装与使用 +## Installation and Usage -进入到工程目录并输入以下命令： +Go to the project directory and execute the following instruction: @@ -38,9 +38,9 @@ yarn add react-native-swipe-gestures@^1.0.5 -下面的代码展示了这个库的基本使用场景： +The following code shows the basic use scenario of the repository: ->[!WARNING] 使用时 import 的库名不变。 +>[!WARNING] The name of the imported repository remains unchanged. ```tsx 'use strict'; @@ -125,19 +125,19 @@ class SomeComponent extends Component { export default SomeComponent; ``` -## 约束与限制 +## Constraints -### 兼容性 +### Compatibility -本文档内容基于以下版本验证通过： +This document is verified based on the following versions: 1. RNOH: 0.72.20-CAPI; SDK: HarmonyOS NEXT Developer Beta1; IDE: DevEco Studio 5.0.3.200; ROM: 3.0.0.18; -## 属性 +## Properties (If Any) -> [!TIP] "Platform"列表示该属性在原三方库上支持的平台。 +> [!TIP] The **Platform** column indicates the platform where the properties are supported in the original third-party library. -> [!TIP] "HarmonyOS Support"列为 yes 表示 HarmonyOS 平台支持该属性；no 则表示不支持；partially 表示部分支持。使用方法跨平台一致，效果对标 iOS 或 Android 的效果。 +> [!TIP] If the value of **HarmonyOS Support** is **yes**, it means that the HarmonyOS platform supports this property; **no** means the opposite; **partially** means some capabilities of this property are supported. The usage method is the same on different platforms and the effect is the same as that of iOS or Android. Can be passed within optional `config` property. @@ -149,9 +149,9 @@ Can be passed within optional `config` property. ## Methods -> [!TIP] "Platform"列表示该属性在原三方库上支持的平台。 +> [!TIP] The **Platform** column indicates the platform where the properties are supported in the original third-party library. -> [!TIP] "HarmonyOS Support"列为 yes 表示 HarmonyOS 平台支持该属性；no 则表示不支持；partially 表示部分支持。使用方法跨平台一致，效果对标 iOS 或 Android 的效果。 +> [!TIP] If the value of **HarmonyOS Support** is **yes**, it means that the HarmonyOS platform supports this property; **no** means the opposite; **partially** means some capabilities of this property are supported. The usage method is the same on different platforms and the effect is the same as that of iOS or Android. | name | Params | Description | Type | Required | Platform | HarmonyOS Suppor | | ------------ | ------------ | ---------------------------------------- | ------ | -------- | ----------- | ---------------- | @@ -161,10 +161,9 @@ Can be passed within optional `config` property. | onSwipeLeft | gestureState | Received left gesture from PanResponder | Object | No | IOS/Android | yes | | onSwipeRight | gestureState | Received right gesture from PanResponder | Object | No | IOS/Android | yes | -## 遗留问题 +## Known Issues -## 其他 +## Others -## 开源协议 - -本项目基于 [The MIT License (MIT)](https://github.com/glepur/react-native-swipe-gestures?tab=MIT-1-ov-file) ，请自由地享受和参与开源。 \ No newline at end of file +## License +This project is licensed under [The MIT License (MIT)](https://github.com/glepur/react-native-swipe-gestures?tab=MIT-1-ov-file). \ No newline at end of file diff --git a/en/victory-native-xl.md b/en/victory-native-xl.md index 74789caf..ffc58422 100644 --- a/en/victory-native-xl.md +++ b/en/victory-native-xl.md @@ -1,4 +1,4 @@ -> 模板版本：v0.2.2 +> Template version: v0.2.2

victory-native-xl

@@ -13,13 +13,13 @@

-> [!TIP] [Github 地址](https://github.com/react-native-oh-library/victory-native-xl) +> [!TIP] [GitHub address](https://github.com/react-native-oh-library/victory-native-xl) -## 安装与使用 +## Installation and Usage -Find the matching version information in the release address of a third-party library：[@react-native-oh-tpl/victory-native-xl Releases](https://github.com/react-native-oh-library/victory-native-xl/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. +Find the matching version information in the release address of a third-party library and download an applicable .tgz package:[@react-native-oh-tpl/victory-native-xl Releases](https://github.com/react-native-oh-library/victory-native-xl/releases) 。对于未发布到npm的旧版本，请参考[安装指南](/en/tgz-usage-en.md)安装tgz包。 -进入到工程目录并输入以下命令： +Go to the project directory and execute the following instruction: #### **npm** @@ -33,9 +33,9 @@ npm install @react-native-oh-tpl/victory-native-xl yarn add @react-native-oh-tpl/victory-native-xl ``` -下面的代码展示了这个库的基本使用场景： +The following code shows the basic use scenario of the repository: -> [!WARNING] 使用时 import 的库名不变。 +> [!WARNING] The name of the imported repository remains unchanged. ```jsx import * as React from "react"; @@ -89,21 +89,21 @@ export default function LineChartExample() { 如未引入请参照[@react-native-oh-tpl/react-native-gesture-handler 文档](/zh-cn/react-native-gesture-handler.md)、[@react-native-oh-tpl/react-native-reanimated](/zh-cn/react-native-reanimated.md)、[@react-native-oh-tpl/react-native-skia](/zh-cn/react-native-skia.md)进行引入 -## 约束与限制 +## Constraints -### 兼容性 +### Compatibility -要使用此库，需要使用正确的 React-Native 和 RNOH 版本。另外，还需要使用配套的 DevEco Studio 和 手机 ROM。 +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. -请到三方库相应的 Releases 发布地址查看 Release 配套的版本信息：[@react-native-oh-tpl/victory-native-xl Releases](https://github.com/react-native-oh-library/victory-native-xl/releases) +Check the release version information in the release address of the third-party library: [@react-native-oh-tpl/victory-native-xl Releases](https://github.com/react-native-oh-library/victory-native-xl/releases) -## 属性 +## Properties (If Any) -详情见 [victory-native-xl](https://github.com/FormidableLabs/victory-native-xl) Props tables +See details [victory-native-xl](https://github.com/FormidableLabs/victory-native-xl) Props tables -> [!TIP] "Platform"列表示该属性在原三方库上支持的平台。 +> [!TIP] The **Platform** column indicates the platform where the properties are supported in the original third-party library. -> [!TIP] "HarmonyOS Support"列为 yes 表示 HarmonyOS 平台支持该属性；no 则表示不支持；partially 表示部分支持。使用方法跨平台一致，效果对标 iOS 或 Android 的效果。 +> [!TIP] If the value of **HarmonyOS Support** is **yes**, it means that the HarmonyOS platform supports this property; **no** means the opposite; **partially** means some capabilities of this property are supported. The usage method is the same on different platforms and the effect is the same as that of iOS or Android. ### Cartesian Chart @@ -216,10 +216,10 @@ export default function LineChartExample() { | angularStrokeWidth | A number which turns width of the Pie chart slice | number | no | all | yes | angularStrokeColor | A string which turns color of the Pie chart slice | string | no | all | yes -## 遗留问题 +## Known Issues -## 其他 +## Others -## 开源协议 +## License -本项目基于 [The MIT License (MIT)]( https://www.mit-license.org/) ，请自由地享受和参与开源。 +This project is licensed under [The MIT License (MIT)]( https://www.mit-license.org/). diff --git a/zh-cn/freakycoder-react-native-bounceable.md b/zh-cn/freakycoder-react-native-bounceable.md index 4094068c..a4480ce2 100644 --- a/zh-cn/freakycoder-react-native-bounceable.md +++ b/zh-cn/freakycoder-react-native-bounceable.md @@ -1,4 +1,4 @@ -> 模板版本：v0.2.2 +> Template version: v0.2.2 @@ -16,11 +16,11 @@ -> [!TIP] [Github 地址](https://github.com/WrathChaos/react-native-bounceable) +> [!TIP] [GitHub address](https://github.com/WrathChaos/react-native-bounceable) -## 安装与使用 +## Installation and Usage -进入到工程目录并输入以下命令： +Go to the project directory and execute the following instruction: ### npm @@ -34,7 +34,7 @@ npm i @freakycoder/react-native-bounceable@1.0.3 yarn add @freakycoder/react-native-bounceable@1.0.3 ``` -下面的代码展示了这个库的基本使用场景： +The following code shows the basic use scenario of the repository: 1、引入库文件 @@ -103,19 +103,19 @@ const styles = StyleSheet.create({ -## 约束与限制 +## Constraints -### 兼容性 +### Compatibility -本文档内容基于以下版本验证： +This document is verified based on the following versions: 1. RNOH: 0.72.28; SDK：HarmonyOS-Next-DB1 5.0.0.25; IDE：DevEco Studio 5.0.3.500; ROM：5.0.0.31; -## 属性和方法 +## Properties And Static Methods (If Any) -> [!TIP] "Platform"列表示该属性在原三方库上支持的平台。 +> [!TIP] The **Platform** column indicates the platform where the properties are supported in the original third-party library. -> [!TIP] "HarmonyOS Support"列为 yes 表示 HarmonyOS 平台支持该属性；no 则表示不支持；partially 表示部分支持。使用方法跨平台一致，效果对标 iOS 或 Android 的效果。 +> [!TIP] If the value of **HarmonyOS Support** is **yes**, it means that the HarmonyOS platform supports this property; **no** means the opposite; **partially** means some capabilities of this property are supported. The usage method is the same on different platforms and the effect is the same as that of iOS or Android. | Property | Description | Type | Required | Platform | HarmonyOS Support | | ----------------- | ------------------------------------------------------------ | :------: | :------: | ----------- | ----------------- | @@ -128,10 +128,10 @@ const styles = StyleSheet.create({ | onPress | set your own logic for the onPress functionality | function | no | iOS/Android | yes | | style | set the style like any other View container | style | no | iOS/Android | yes | -## 遗留问题 +## Known Issues -## 其他 +## Others -## 开源协议 +## License -本项目基于 [The MIT License (MIT)](https://opensource.org/license/MIT) ，请自由地享受和参与开源。 +This project is licensed under [The MIT License (MIT)](https://opensource.org/license/MIT). -- Gitee From 917b653b293daece4bbaad1f8ff6621a9d6538e6 Mon Sep 17 00:00:00 2001 From: sunshinezjb Date: Fri, 29 Nov 2024 16:26:41 +0800 Subject: [PATCH 3/6] =?UTF-8?q?docs:=20=E4=BF=AE=E6=94=B9react-native-char?= =?UTF-8?q?t-kit=E8=8B=B1=E6=96=87=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- en/react-native-chart-kit.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/en/react-native-chart-kit.md b/en/react-native-chart-kit.md index 15ec524c..9eb26b19 100644 --- a/en/react-native-chart-kit.md +++ b/en/react-native-chart-kit.md @@ -114,7 +114,7 @@ export default MyChart; 本库 HarmonyOS 侧实现依赖@react-native-oh-tpl/react-native-svg 的原生端代码，如已在 HarmonyOS 工程中引入过该库，则无需再次引入，可跳过本章节步骤，直接使用。 -如未引入请参照[@react-native-oh-tpl/react-native-svg文档的 Link 章节](https://gitee.com/react-native-oh-library/usage-docs/blob/master/zh-cn/react-native-svg-capi.md#link)进行引入 +如未引入请参照[@react-native-oh-tpl/react-native-svg文档的 Link 章节](https://gitee.com/react-native-oh-library/usage-docs/blob/master/en/react-native-svg-capi.md#link)进行引入 ## Constraints -- Gitee From cf3a6aef0eb7edeeabddccb8252f2d17be656ca6 Mon Sep 17 00:00:00 2001 From: sunshinezjb Date: Fri, 29 Nov 2024 16:42:22 +0800 Subject: [PATCH 4/6] =?UTF-8?q?docs:=20=E4=BF=AE=E6=94=B9react-native-boun?= =?UTF-8?q?ceable=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- en/freakycoder-react-native-bounceable.md | 30 ++++++++++---------- zh-cn/freakycoder-react-native-bounceable.md | 30 ++++++++++---------- 2 files changed, 30 insertions(+), 30 deletions(-) diff --git a/en/freakycoder-react-native-bounceable.md b/en/freakycoder-react-native-bounceable.md index 4094068c..a4480ce2 100644 --- a/en/freakycoder-react-native-bounceable.md +++ b/en/freakycoder-react-native-bounceable.md @@ -1,4 +1,4 @@ -> 模板版本：v0.2.2 +> Template version: v0.2.2 @@ -16,11 +16,11 @@ -> [!TIP] [Github 地址](https://github.com/WrathChaos/react-native-bounceable) +> [!TIP] [GitHub address](https://github.com/WrathChaos/react-native-bounceable) -## 安装与使用 +## Installation and Usage -进入到工程目录并输入以下命令： +Go to the project directory and execute the following instruction: ### npm @@ -34,7 +34,7 @@ npm i @freakycoder/react-native-bounceable@1.0.3 yarn add @freakycoder/react-native-bounceable@1.0.3 ``` -下面的代码展示了这个库的基本使用场景： +The following code shows the basic use scenario of the repository: 1、引入库文件 @@ -103,19 +103,19 @@ const styles = StyleSheet.create({ -## 约束与限制 +## Constraints -### 兼容性 +### Compatibility -本文档内容基于以下版本验证： +This document is verified based on the following versions: 1. RNOH: 0.72.28; SDK：HarmonyOS-Next-DB1 5.0.0.25; IDE：DevEco Studio 5.0.3.500; ROM：5.0.0.31; -## 属性和方法 +## Properties And Static Methods (If Any) -> [!TIP] "Platform"列表示该属性在原三方库上支持的平台。 +> [!TIP] The **Platform** column indicates the platform where the properties are supported in the original third-party library. -> [!TIP] "HarmonyOS Support"列为 yes 表示 HarmonyOS 平台支持该属性；no 则表示不支持；partially 表示部分支持。使用方法跨平台一致，效果对标 iOS 或 Android 的效果。 +> [!TIP] If the value of **HarmonyOS Support** is **yes**, it means that the HarmonyOS platform supports this property; **no** means the opposite; **partially** means some capabilities of this property are supported. The usage method is the same on different platforms and the effect is the same as that of iOS or Android. | Property | Description | Type | Required | Platform | HarmonyOS Support | | ----------------- | ------------------------------------------------------------ | :------: | :------: | ----------- | ----------------- | @@ -128,10 +128,10 @@ const styles = StyleSheet.create({ | onPress | set your own logic for the onPress functionality | function | no | iOS/Android | yes | | style | set the style like any other View container | style | no | iOS/Android | yes | -## 遗留问题 +## Known Issues -## 其他 +## Others -## 开源协议 +## License -本项目基于 [The MIT License (MIT)](https://opensource.org/license/MIT) ，请自由地享受和参与开源。 +This project is licensed under [The MIT License (MIT)](https://opensource.org/license/MIT). diff --git a/zh-cn/freakycoder-react-native-bounceable.md b/zh-cn/freakycoder-react-native-bounceable.md index a4480ce2..4094068c 100644 --- a/zh-cn/freakycoder-react-native-bounceable.md +++ b/zh-cn/freakycoder-react-native-bounceable.md @@ -1,4 +1,4 @@ -> Template version: v0.2.2 +> 模板版本：v0.2.2 @@ -16,11 +16,11 @@ -> [!TIP] [GitHub address](https://github.com/WrathChaos/react-native-bounceable) +> [!TIP] [Github 地址](https://github.com/WrathChaos/react-native-bounceable) -## Installation and Usage +## 安装与使用 -Go to the project directory and execute the following instruction: +进入到工程目录并输入以下命令： ### npm @@ -34,7 +34,7 @@ npm i @freakycoder/react-native-bounceable@1.0.3 yarn add @freakycoder/react-native-bounceable@1.0.3 ``` -The following code shows the basic use scenario of the repository: +下面的代码展示了这个库的基本使用场景： 1、引入库文件 @@ -103,19 +103,19 @@ const styles = StyleSheet.create({ -## Constraints +## 约束与限制 -### Compatibility +### 兼容性 -This document is verified based on the following versions: +本文档内容基于以下版本验证： 1. RNOH: 0.72.28; SDK：HarmonyOS-Next-DB1 5.0.0.25; IDE：DevEco Studio 5.0.3.500; ROM：5.0.0.31; -## Properties And Static Methods (If Any) +## 属性和方法 -> [!TIP] The **Platform** column indicates the platform where the properties are supported in the original third-party library. +> [!TIP] "Platform"列表示该属性在原三方库上支持的平台。 -> [!TIP] If the value of **HarmonyOS Support** is **yes**, it means that the HarmonyOS platform supports this property; **no** means the opposite; **partially** means some capabilities of this property are supported. The usage method is the same on different platforms and the effect is the same as that of iOS or Android. +> [!TIP] "HarmonyOS Support"列为 yes 表示 HarmonyOS 平台支持该属性；no 则表示不支持；partially 表示部分支持。使用方法跨平台一致，效果对标 iOS 或 Android 的效果。 | Property | Description | Type | Required | Platform | HarmonyOS Support | | ----------------- | ------------------------------------------------------------ | :------: | :------: | ----------- | ----------------- | @@ -128,10 +128,10 @@ This document is verified based on the following versions: | onPress | set your own logic for the onPress functionality | function | no | iOS/Android | yes | | style | set the style like any other View container | style | no | iOS/Android | yes | -## Known Issues +## 遗留问题 -## Others +## 其他 -## License +## 开源协议 -This project is licensed under [The MIT License (MIT)](https://opensource.org/license/MIT). +本项目基于 [The MIT License (MIT)](https://opensource.org/license/MIT) ，请自由地享受和参与开源。 -- Gitee From ea9f509a75530fd87062429d4eb00962bcb82377 Mon Sep 17 00:00:00 2001 From: sunshinezjb Date: Fri, 29 Nov 2024 16:59:05 +0800 Subject: [PATCH 5/6] =?UTF-8?q?docs:=20=E4=BF=AE=E6=94=B9react-native-idfa?= =?UTF-8?q?-aaid=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- en/react-native-bouncy-checkbox.md | 4 ++-- en/react-native-chart-kit.md | 4 ++-- en/react-native-idfa-aaid.md | 4 ++-- en/victory-native-xl.md | 4 ++-- 4 files changed, 8 insertions(+), 8 deletions(-) diff --git a/en/react-native-bouncy-checkbox.md b/en/react-native-bouncy-checkbox.md index 7f8cf736..3cc70fcf 100644 --- a/en/react-native-bouncy-checkbox.md +++ b/en/react-native-bouncy-checkbox.md @@ -16,13 +16,13 @@ ## Installation and Usage -> [!TIP] 需要配套的服务和三方依赖 +> [!TIP] This repository depends on the following libraries, please refer to the corresponding documentation: | Dependencies | Version | | ------------------------------------ | ------- | | @freakycoder/react-native-bounceable | 1.0.3 | -本库依赖[@freakycoder/react-native-bounceable文档](https://gitee.com/react-native-oh-library/usage-docs/blob/master/zh-cn/freakycoder-react-native-bounceable.md) +This repository depends on the following libraries[@freakycoder/react-native-bounceable documentation](https://gitee.com/react-native-oh-library/usage-docs/blob/master/en/freakycoder-react-native-bounceable.md) #### **npm** diff --git a/en/react-native-chart-kit.md b/en/react-native-chart-kit.md index 9eb26b19..2b1cb07e 100644 --- a/en/react-native-chart-kit.md +++ b/en/react-native-chart-kit.md @@ -112,9 +112,9 @@ export default MyChart; ## Link -本库 HarmonyOS 侧实现依赖@react-native-oh-tpl/react-native-svg 的原生端代码，如已在 HarmonyOS 工程中引入过该库，则无需再次引入，可跳过本章节步骤，直接使用。 +The HarmonyOS implementation of this library depends on the native code from @react-native-oh-tpl/react-native-svg. If this library is included into your HarmonyOS application, there is no need to include it again; you can skip the steps in this section and use it directly. -如未引入请参照[@react-native-oh-tpl/react-native-svg文档的 Link 章节](https://gitee.com/react-native-oh-library/usage-docs/blob/master/en/react-native-svg-capi.md#link)进行引入 +If it is not included, follow the guide provided in [@react-native-oh-tpl/react-native-svg documentation Link chapter](https://gitee.com/react-native-oh-library/usage-docs/blob/master/en/react-native-svg-capi.md#link) to add it to your project. ## Constraints diff --git a/en/react-native-idfa-aaid.md b/en/react-native-idfa-aaid.md index fdb86f7b..b66dc22c 100644 --- a/en/react-native-idfa-aaid.md +++ b/en/react-native-idfa-aaid.md @@ -263,7 +263,7 @@ Check the release version information in the release address of the third-party [!TIP] "ohos.permission.APP_TRACKING_CONSENT"，"ohos.permission.APP_TRACKING_CONSENT"权限等级为normal，授权方式为user_grant[使用 ACL 签名的配置指导](https://developer.harmonyos.com/cn/docs/documentation/doc-guides-V3/signing-0000001587684945-V3#section157591551175916) -#### 在 entry 目录下的module.json5中添加权限 +#### Include applicable permissions in the module.json5 file within the entry directory. 在 `YourProject/entry/src/main/module.json5`补上配置 ```diff @@ -291,7 +291,7 @@ Check the release version information in the release address of the third-party ``` 在 `YourProject/entry/src/main/resources/base/element/string.json`补上配置 -#### 在 entry 目录下添加申请权限的原因 +#### Apply the reasons for applicable permission in the entry directory. 打开 `entry/src/main/resources/base/element/string.json`，添加： diff --git a/en/victory-native-xl.md b/en/victory-native-xl.md index ffc58422..132cddee 100644 --- a/en/victory-native-xl.md +++ b/en/victory-native-xl.md @@ -85,9 +85,9 @@ export default function LineChartExample() { ## Link -本库鸿蒙侧实现依赖@react-native-oh-tpl/react-native-gesture-handler、@react-native-oh-tpl/react-native-reanimated、 @react-native-oh-tpl/react-native-skia的原生端代码，如已在鸿蒙工程中引入过这两个库，则无需再次引入，可跳过本章节步骤，直接使用。 +The HarmonyOS implementation of this library depends on the native code from @react-native-oh-tpl/react-native-gesture-handler、@react-native-oh-tpl/react-native-reanimated、 @react-native-oh-tpl/react-native-skia. If this library is included into your HarmonyOS application, there is no need to include it again; you can skip the steps in this section and use it directly. -如未引入请参照[@react-native-oh-tpl/react-native-gesture-handler 文档](/zh-cn/react-native-gesture-handler.md)、[@react-native-oh-tpl/react-native-reanimated](/zh-cn/react-native-reanimated.md)、[@react-native-oh-tpl/react-native-skia](/zh-cn/react-native-skia.md)进行引入 +If it is not included, follow the guide provided in [@react-native-oh-tpl/react-native-gesture-handler document](/en/react-native-gesture-handler.md)、[@react-native-oh-tpl/react-native-reanimated](/en/react-native-reanimated.md)、[@react-native-oh-tpl/react-native-skia](/en/react-native-skia.md) to add it to your project. ## Constraints -- Gitee From bd5deb207f5317d720075279fb418a650bcd2a28 Mon Sep 17 00:00:00 2001 From: sunshinezjb Date: Fri, 29 Nov 2024 17:19:43 +0800 Subject: [PATCH 6/6] =?UTF-8?q?docs:=20=E4=BF=AE=E6=94=B9react-native-exit?= =?UTF-8?q?-app=E8=8B=B1=E6=96=87=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- en/react-native-audio-toolkit.md | 4 ++-- en/react-native-exit-app.md | 6 +++--- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/en/react-native-audio-toolkit.md b/en/react-native-audio-toolkit.md index d563f285..d2e5f7d5 100644 --- a/en/react-native-audio-toolkit.md +++ b/en/react-native-audio-toolkit.md @@ -42,9 +42,9 @@ The following code shows the basic use scenario of the repository: > [!WARNING] The name of the imported repository remains unchanged. -> [!TIP] # demo 使用了三方库[@react-native-oh-tpl/react-native-slider](https://gitee.com/react-native-oh-library/usage-docs/blob/master/zh-cn/react-native-slider.md) +> [!TIP] # demo used third party library [@react-native-oh-tpl/react-native-slider](https://gitee.com/react-native-oh-library/usage-docs/blob/master/en/react-native-slider.md) -> [!TIP] # demo 使用了权限三方库[@react-native-oh-tpl/react-native-permissions](https://gitee.com/react-native-oh-library/usage-docs/blob/master/zh-cn/react-native-permissions.md) +> [!TIP] # demo used third party library permission [@react-native-oh-tpl/react-native-permissions](https://gitee.com/react-native-oh-library/usage-docs/blob/master/en/react-native-permissions.md) ```tsx import React, { Component } from "react"; diff --git a/en/react-native-exit-app.md b/en/react-native-exit-app.md index 0c03b67b..819ed438 100644 --- a/en/react-native-exit-app.md +++ b/en/react-native-exit-app.md @@ -73,7 +73,7 @@ export default App; ## Use Codegen -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](/zh-cn/codegen.md). +If this repository has been adapted to `Codegen`, generate the bridge code of the third-party library by using the `Codegen`. For details, see [Codegen Usage Guide](/en/codegen.md). ## Link @@ -120,7 +120,7 @@ ohpm install Method 2: Directly link to the source code. -> [!TIP] For details, see [Directly Linking Source Code](/zh-cn/link-source-code.md). +> [!TIP] For details, see [Directly Linking Source Code](/en/link-source-code.md). ### 3. Introducing ExitAppPackage to ArkTS @@ -168,7 +168,7 @@ Check the release version information in the release address of the third-party | Name | Description | Type | Required | Platform | HarmonyOS Support | | ------- | ------------- | -------- | -------- | ----------- | ----------------- | -| exitApp | 关闭/退出 APP | Function | no | iOS/Android | yes | +| exitApp | close/exit APP | Function | no | iOS/Android | yes | ## Known Issues -- Gitee