From 37d5ff64592eb96df7fed31377aecdc2d78470b6 Mon Sep 17 00:00:00 2001 From: chenwenhui133 <2984202073@qq.com> Date: Wed, 11 Jun 2025 15:50:30 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20[Issues:=20#ICECC2]=20=E4=BF=AE?= =?UTF-8?q?=E6=94=B9=E8=8B=B1=E6=96=87=E6=96=87=E6=A1=A3=E4=B8=AD=E7=9A=84?= =?UTF-8?q?=E4=B8=AD=E6=96=87?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...eact-native-async-storage-async-storage.md | 4 +- en/react-native-blob-util.md | 140 +++++------ ...-util\357\274\210nocodegen\357\274\211.md" | 222 +++++++++--------- en/react-native-maps.md | 58 ++--- en/react-native-progress.md | 6 +- en/react-native-vector-icons.md | 68 +++--- 6 files changed, 249 insertions(+), 249 deletions(-) diff --git a/en/react-native-async-storage-async-storage.md b/en/react-native-async-storage-async-storage.md index 9d071b50..652e68b5 100644 --- a/en/react-native-async-storage-async-storage.md +++ b/en/react-native-async-storage-async-storage.md @@ -67,7 +67,7 @@ const getData = async () => { }; ``` -下面的代码展示了这个库的Hooks使用场景： +The following code shows the basic use scenario of the repository: > [!WARNING] The name of the imported repository remains unchanged. @@ -273,7 +273,7 @@ Check the release version information in the release address of the third-party ## Known Issues -- [ ] Harmony 的 taskpool 支持类型有限，无法用 taskpool 实现，仅用简单的线程锁替代,无法设置指定的存储大小: [issue#8](https://github.com/react-native-oh-library/async-storage/issues/8) +- [ ] The task pool in Harmony has limited support for task types, which restricts its implementation. Simply using a thread lock cannot specify the storage size: [issue#8](https://github.com/react-native-oh-library/async-storage/issues/8) ## Others diff --git a/en/react-native-blob-util.md b/en/react-native-blob-util.md index 443cbedd..14c6a8ae 100644 --- a/en/react-native-blob-util.md +++ b/en/react-native-blob-util.md @@ -186,17 +186,17 @@ export default function BlobUtilDemo() { }; const addListener = () => { - let obj = "addListener是空实现"; + let obj = "addListener is an empty implementation."; setResult(obj); }; const removeListeners = () => { - let obj = "removeListeners是空实现"; + let obj = "removeListeners an empty implementation."; setResult(obj); }; const emitExpiredEvent = () => { - let obj = "emitExpiredEvent是空实现,三方库没有调用"; + let obj = "emitExpiredEvent is an empty implementation and is not invoked by a third-party library."; setResult(obj); }; @@ -213,55 +213,55 @@ export default function BlobUtilDemo() { BlobUtilTurboModule.getConstants() BlobUtilTurboModule.createFile() - + BlobUtilTurboModule.unlink() - + BlobUtilTurboModule.copyFileToCache() BlobUtilTurboModule.writeFile() - + BlobUtilTurboModule.stat() - + BlobUtilTurboModule.mkdir() - + BlobUtilTurboModule.writeStream() - + BlobUtilTurboModule.ls() - + BlobUtilTurboModule.createFileASCII() @@ -271,69 +271,69 @@ export default function BlobUtilDemo() { BlobUtilTurboModule.writeFileArray() BlobUtilTurboModule.exists() - + BlobUtilTurboModule.lstat() - + BlobUtilTurboModule.hash() - + BlobUtilTurboModule.readFile() - + BlobUtilTurboModule.slice() - + BlobUtilTurboModule.df() - + BlobUtilTurboModule.closeStream() - + BlobUtilTurboModule.writeArrayChunk() BlobUtilTurboModule.writeChunk() - + BlobUtilTurboModule.readStream() - + BlobUtilTurboModule.mv() - + addListener() - + removeListeners() @@ -341,7 +341,7 @@ export default function BlobUtilDemo() { emitExpiredEvent() @@ -508,9 +508,9 @@ Check the release version information in the release address of the third-party | Name | Description|Type | Required | Platform | HarmonyOS Support | | ------- | --------|--- | -------- | ----------- | ----------------- | -| progress | 进度 | Function | No | iOS/Android | yes | -| uploadProgress | 上传进度 | Function | No | iOS/Android | yes | -| cancel | 取消 | Function | No | iOS/Android | yes | +| progress | Progress. | Function | No | iOS/Android | yes | +| uploadProgress | Upload progress. | Function | No | iOS/Android | yes | +| cancel | Cancellation | Function | No | iOS/Android | yes | #### Android API @@ -518,9 +518,9 @@ Check the release version information in the release address of the third-party | Name | Description| Type | Required | Platform | HarmonyOS Support | | :-----------------: | :------|----: | :------: | :------: | :---------------: | -| actionViewIntent | 动作视图意图| Function | No | Android | No | -| getContentIntent | 获取内容意图| Function | No | Android | No | -| addCompleteDownload | 添加完整下载| Function | No | Android | No | +| actionViewIntent | Action view intent.| Function | No | Android | No | +| getContentIntent | Obtains the content intent.| Function | No | Android | No | +| addCompleteDownload | Adds a complete download.| Function | No | Android | No | #### File System Access API @@ -528,26 +528,26 @@ Check the release version information in the release address of the third-party | Name | Description | Type | Required | Platform | HarmonyOS Support | | :---------: | :---------------------| -----------: | :------: | :---------: | :---------------: | -| dirs | 目录 | Function | NO | iOS/Android | yes | -| createFile | 创建文件 | Function | NO | iOS/Android | yes | -| writeFile | 写文件 | Function | NO | iOS/Android | yes | -| writeStream | 写流 | Function | NO | iOS/Android | yes | -| appendFile | 追加文件 | Function | NO | iOS/Android | yes | -| readFile | 读取文件 | Function | NO | iOS/Android | yes | -| hash | 哈希 | Function | NO | iOS/Android | yes | -| readStream | 读流 | Function | NO | iOS/Android | yes | -| mkdir | 创建目录 | Function | NO | iOS/Android | yes | -| ls | 查看当下的文件和目录| Function | NO | iOS/Android | yes | -| mv | 移动文件位置 | Function | NO | iOS/Android | yes | -| cp | 复制文件 | Function | NO | iOS/Android | yes | -| exists | 检查文件是否存在 | Function | NO | iOS/Android | yes | -| isDir | 是否是目录 | Function | NO | iOS/Android | yes | -| unlink | 删除文件 | Function | NO | iOS/Android | yes | -| lstat | 获取目录下文件的统计数据 | Function | NO | iOS/Android | yes | -| stat | 类似地获取数据或目录的统计信息| Function | NO | iOS/Android | yes | -| scanFile | 扫描文件 | Function | NO | Android | no | -| asset | 资产 | Function | NO | iOS/Android | yes | -| df | 获取设备的可用磁盘空间和总磁盘空间| Function | NO | iOS/Android | yes | +| dirs | Directory structure. | Function | NO | iOS/Android | yes | +| createFile | Creates a file. | Function | NO | iOS/Android | yes | +| writeFile | Writes a file. | Function | NO | iOS/Android | yes | +| writeStream | Writes a stream. | Function | NO | iOS/Android | yes | +| appendFile | Appends a file. | Function | NO | iOS/Android | yes | +| readFile | Reads a file. | Function | NO | iOS/Android | yes | +| hash | Hash. | Function | NO | iOS/Android | yes | +| readStream | Reads a stream. | Function | NO | iOS/Android | yes | +| mkdir | Creates a directory. | Function | NO | iOS/Android | yes | +| ls | Views the current files and directory. | Function | NO | iOS/Android | yes | +| mv | Moves a file. | Function | NO | iOS/Android | yes | +| cp | Copies a file. | Function | NO | iOS/Android | yes | +| exists | Checks whether a file exists. | Function | NO | iOS/Android | yes | +| isDir | Checks whether a node is a directory. | Function | NO | iOS/Android | yes | +| unlink | Removes a file. | Function | NO | iOS/Android | yes | +| lstat | Obtains statistics of files in a directory. | Function | NO | iOS/Android | yes | +| stat | Obtains data or directory statistics similarly.| Function | NO | iOS/Android | yes | +| scanFile | Scans a file. | Function | NO | Android | no | +| asset | Assets. | Function | NO | iOS/Android | yes | +| df | Obtains the available disk space and total disk space of a device.| Function | NO | iOS/Android | yes | #### iOS API @@ -555,8 +555,8 @@ Check the release version information in the release address of the third-party | Name | Description | Type | Required | Platform | HarmonyOS Support | | --------------- | ----------------------| ---------------- | -------- | -------- | ----------------- | -| previewDocument | 文档查看器--需要系统权限 | Function | No | iOS | yes | -| openDocument | 显示与文件交互的选项菜单--需要系统权限| Function | No | iOS | yes | +| previewDocument | Views documents, requiring system permissions. | Function | No | iOS | yes | +| openDocument | Displays the option menu for interacting with files, requiring system permissions.| Function | No | iOS | yes | #### Network Utils @@ -564,8 +564,8 @@ Check the release version information in the release address of the third-party | Name | Description| Type | Required | Platform | HarmonyOS Support | | ------------- | ----------- | ---| ----- | ----------- | ----------------- | -| getCookies | 获取 cookie| Function | No | iOS/Android | no | -| removeCookies | 删除 cookie| Function | No | iOS/Android | no | +| getCookies | Obtains cookie| Function | No | iOS/Android | no | +| removeCookies | Removes cookie| Function | No | iOS/Android | no | #### Session API @@ -573,10 +573,10 @@ Check the release version information in the release address of the third-party | Name | Description| Type | Required | Platform | HarmonyOS Support | | ------- | ----------- | --| ------ | ----------- | ----------------- | -| add | 向此会话添加文件路径 | Function | No | iOS/Android | yes | -| remove | 从此会话中删除会话条目而不删除文件 | Function | No | iOS/Android | yes | -| list | 返回包含此会话中的文件路径的数组 | Function | No | iOS/Android | yes | -| dispose | 删除会话中的所有文件 | Function | No | iOS/Android | yes | +| add | Adds a file path to the current session. | Function | No | iOS/Android | yes | +| remove | Removes session entries from the current session without deleting files. | Function | No | iOS/Android | yes | +| list | Returns an array containing the file paths in the current session. | Function | No | iOS/Android | yes | +| dispose | Disposes all files in a session. | Function | No | iOS/Android | yes | #### MediaStore(Android Media Storage) @@ -584,22 +584,22 @@ Check the release version information in the release address of the third-party | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---------------- | --------| ------ | -------- | -------- | ----------------- | -| CopyToMediaStore | 复制到媒体存储| Function | No | Android | no | -| createMediaFile | 创建媒体文件| Function | No | Android | no | -| writeMediaFile | 写媒体文件 | Function | No | Android | no | -| copyToInternal | 复制到内部 | Function | No | Android | no | +| CopyToMediaStore | Copies to media storage.| Function | No | Android | no | +| createMediaFile | Creates a media file. | Function | No | Android | no | +| writeMediaFile | Writes a media file. | Function | No | Android | no | +| copyToInternal | Copies to internal. | Function | No | Android | no | #### Utils API | Name | Description| Type | Required | Platform | HarmonyOS Support | | ------ | ----------- | ---| ----- | ----------- | ----------------- | -| wrap | 使文件路径可以被识别| Function | No | iOS/Android | yes | -| base64 | 使用base64编码解码| Function | No | iOS/Android | yes | -| session | 用于管理缓存文件 | Function | No | iOS/Android | yes | +| wrap | Wraps a file path to make it recognizable.| Function | No | iOS/Android | yes | +| base64 | Enables Base64 encoding and decoding.| Function | No | iOS/Android | yes | +| session | Manages cache files. | Function | No | iOS/Android | yes | ## Known Issues - - [ ] blob-util在使用getCookies、removeCookies 在Android、iOS、Harmony OS 上使用都会报错: [issue#381](https://github.com/RonRadtke/react-native-blob-util/issues/381) + - [ ] An error occurs when **blob-util** uses **getCookies** and **removeCookies** on Android, iOS, and HarmonyOS: [issue#381](https://github.com/RonRadtke/react-native-blob-util/issues/381). ## Others diff --git "a/en/react-native-blob-util\357\274\210nocodegen\357\274\211.md" "b/en/react-native-blob-util\357\274\210nocodegen\357\274\211.md" index e1666f42..1a6583b0 100644 --- "a/en/react-native-blob-util\357\274\210nocodegen\357\274\211.md" +++ "b/en/react-native-blob-util\357\274\210nocodegen\357\274\211.md" @@ -1,4 +1,4 @@ -> 模板版本：v0.2.2 +> Template version: V0.2.2

react-native-blob-util

@@ -12,15 +12,15 @@

-> [!TIP] [Github 地址](https://github.com/react-native-oh-library/react-native-blob-util) +> [!TIP] [Github address](https://github.com/react-native-oh-library/react-native-blob-util) -## 安装与使用 +## Installation and Usage -请到三方库的 Releases 发布地址查看配套的版本信息：[@react-native-oh-tpl/react-native-blob-util Releases](https://github.com/react-native-oh-library/react-native-blob-util/releases)，并下载适用版本的 tgz 包。 +Find the matching version information in the release address of the third-party library and download an applicable .tgz package: [@react-native-oh-tpl/react-native-blob-util Releases](https://github.com/react-native-oh-library/react-native-blob-util/releases). -进入到工程目录并输入以下命令： +Go to the project directory and execute the following instructions: -> [!TIP] # 处替换为 tgz 包的路径 +> [!TIP] Replace the content with the path of the .tgz package at the comment sign (#). @@ -38,9 +38,9 @@ yarn add @react-native-oh-tpl/react-native-blob-util@file:# -下面的代码展示了这个库的基本使用场景： +The following code shows the basic use scenario of the repository: -> [!WARNING] 使用时 import 的库名不变。 +> [!WARNING] The name of the imported repository should remain unchanged. ```js import React, { useState } from "react"; @@ -185,17 +185,17 @@ export default function BlobUtilDemo() { }; const addListener = () => { - let obj = "addListener是空实现"; + let obj = "addListener is an empty implementation."; setResult(obj); }; const removeListeners = () => { - let obj = "removeListeners是空实现"; + let obj = "removeListeners is an empty implementation."; setResult(obj); }; const emitExpiredEvent = () => { - let obj = "emitExpiredEvent是空实现,三方库没有调用"; + let obj = "emitExpiredEvent is an empty implementation and is not invoked by a third-party library."; setResult(obj); }; @@ -212,55 +212,55 @@ export default function BlobUtilDemo() { BlobUtilTurboModule.getConstants() BlobUtilTurboModule.createFile() - + BlobUtilTurboModule.unlink() - + BlobUtilTurboModule.copyFileToCache() BlobUtilTurboModule.writeFile() - + BlobUtilTurboModule.stat() - + BlobUtilTurboModule.mkdir() - + BlobUtilTurboModule.writeStream() - + BlobUtilTurboModule.ls() - + BlobUtilTurboModule.createFileASCII() @@ -270,69 +270,69 @@ export default function BlobUtilDemo() { BlobUtilTurboModule.writeFileArray() BlobUtilTurboModule.exists() - + BlobUtilTurboModule.lstat() - + BlobUtilTurboModule.hash() - + BlobUtilTurboModule.readFile() - + BlobUtilTurboModule.slice() - + BlobUtilTurboModule.df() - + BlobUtilTurboModule.closeStream() - + BlobUtilTurboModule.writeArrayChunk() BlobUtilTurboModule.writeChunk() - + BlobUtilTurboModule.readStream() - + BlobUtilTurboModule.mv() - + addListener() - + removeListeners() @@ -340,7 +340,7 @@ export default function BlobUtilDemo() { emitExpiredEvent() @@ -411,11 +411,11 @@ const styles = StyleSheet.create({ ## Link -目前 HarmonyOS 暂不支持 AutoLink，所以 Link 步骤需要手动配置。 +Currently, HarmonyOS does not support AutoLink. Therefore, you need to manually configure AutoLink. -首先需要使用 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 ``` { @@ -426,18 +426,18 @@ const styles = StyleSheet.create({ } ``` -### 2.引入原生端代码 +### 2. Introducing Native Code -目前有两种方法： +Currently, two methods are available: -1. 通过 har 包引入（在 IDE 完善相关功能后该方法会被遗弃，目前首选此方法）； -2. 直接链接源码。 +1. Use the HAR file (this method will be deprecated once the IDE supports the relevant functionality and is preferred currently). +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` and add the following dependencies: ```json "dependencies": { @@ -446,23 +446,23 @@ 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 [Introducing Native Code](/zh-cn/link-source-code.md) -### 3.配置 CMakeLists 和引入 BlobUtilPackage +### 3. Configuring CMakeLists and Introducing BlobUtilPackage -打开 `entry/src/main/cpp/CMakeLists.txt`，添加： +Open `entry/src/main/cpp/CMakeLists.txt` and add the following code: ```diff project(rnapp) @@ -500,7 +500,7 @@ target_link_libraries(rnoh_app PUBLIC rnoh_sample_package) # RNOH_END: rnoh_blob_util ``` -打开 `entry/src/main/cpp/PackageProvider.cpp`，添加： +Open `entry/src/main/cpp/PackageProvider.cpp` and add the following code: ```diff #include "RNOH/PackageProvider.h" @@ -519,9 +519,9 @@ std::vector> PackageProvider::getPackages(Package::Cont } ``` -### 4.在 ArkTs 侧引入 BlobUtilPackage +### 4. Introducing BlobUtilPackage to ArkTs -打开 `entry/src/main/ets/RNPackagesFactory.ts`，添加： +Open `entry/src/main/ets/RNPackagesFactory.ts` and add the following code: ```diff ... @@ -535,41 +535,41 @@ 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 ``` -然后编译、运行即可。 +Build and run the code. -## 约束与限制 +## Constraints -### 兼容性 +### Compatibility -要使用此库，需要使用正确的 React-Native 和 RNOH 版本。另外，还需要使用配套的 DevEco Studio 和 手机 ROM。 +To use this library, you need to use the correct React Native and RNOH versions. In addition, use the matching DevEco Studio and the ROM on your phone. -请到三方库相应的 Releases 发布地址查看 Release 配套的版本信息：[@react-native-oh-tpl/react-native-blob-util Releases](https://github.com/react-native-oh-library/react-native-blob-util/releases) +Find the matching version information in the release address of the third-party library: [@react-native-oh-tpl/react-native-blob-util Releases](https://github.com/react-native-oh-library/react-native-blob-util/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. #### Fetch API ##### ReactNativeBlobUtil.fetch | Name | Description|Type | Required | Platform | HarmonyOS Support | | ------- | --------|--- | -------- | ----------- | ----------------- | -| progress | 进度 | Function | No | iOS/Android | yes | -| uploadProgress | 上传进度 | Function | No | iOS/Android | yes | -| cancel | 取消 | Function | No | iOS/Android | yes | +| progress | Progress | Function | No | iOS/Android | yes | +| uploadProgress | Upload progress | Function | No | iOS/Android | yes | +| cancel | Cancellation | Function | No | iOS/Android | yes | @@ -579,9 +579,9 @@ ohpm install | Name | Description| Type | Required | Platform | HarmonyOS Support | | :-----------------: | :------|----: | :------: | :------: | :---------------: | -| actionViewIntent | 动作视图意图| Function | No | Android | No | -| getContentIntent | 获取内容意图| Function | No | Android | No | -| addCompleteDownload | 添加完整下载| Function | No | Android | No | +| actionViewIntent | Action view intent| Function | No | Android | No | +| getContentIntent | Obtains the content intent| Function | No | Android | No | +| addCompleteDownload | Adds a complete download| Function | No | Android | No | #### File System Access API @@ -589,26 +589,26 @@ ohpm install | Name | Description | Type | Required | Platform | HarmonyOS Support | | :---------: | :---------------------| -----------: | :------: | :---------: | :---------------: | -| dirs | 目录 | Function | NO | iOS/Android | yes | -| createFile | 创建文件 | Function | NO | iOS/Android | yes | -| writeFile | 写文件 | Function | NO | iOS/Android | yes | -| writeStream | 写流 | Function | NO | iOS/Android | yes | -| appendFile | 追加文件 | Function | NO | iOS/Android | yes | -| readFile | 读取文件 | Function | NO | iOS/Android | yes | -| hash | 哈希 | Function | NO | iOS/Android | yes | -| readStream | 读流 | Function | NO | iOS/Android | yes | -| mkdir | 创建目录 | Function | NO | iOS/Android | yes | -| ls | 查看当下的文件和目录| Function | NO | iOS/Android | yes | -| mv | 移动文件位置 | Function | NO | iOS/Android | yes | -| cp | 复制文件 | Function | NO | iOS/Android | yes | -| exists | 检查文件是否存在 | Function | NO | iOS/Android | yes | -| isDir | 是否是目录 | Function | NO | iOS/Android | yes | -| unlink | 删除文件 | Function | NO | iOS/Android | yes | -| lstat | 获取目录下文件的统计数据 | Function | NO | iOS/Android | yes | -| stat | 类似地获取数据或目录的统计信息| Function | NO | iOS/Android | yes | -| scanFile | 扫描文件 | Function | NO | Android | no | -| asset | 资产 | Function | NO | iOS/Android | yes | -| df | 获取设备的可用磁盘空间和总磁盘空间| Function | NO | iOS/Android | yes | +| dirs | Directory | Function | NO | iOS/Android | yes | +| createFile | Creates a file | Function | NO | iOS/Android | yes | +| writeFile | Writes a file | Function | NO | iOS/Android | yes | +| writeStream | Writes a stream | Function | NO | iOS/Android | yes | +| appendFile | Appends a file | Function | NO | iOS/Android | yes | +| readFile | Reads a file | Function | NO | iOS/Android | yes | +| hash | Hash | Function | NO | iOS/Android | yes | +| readStream | Reads a stream | Function | NO | iOS/Android | yes | +| mkdir | Creates a directory | Function | NO | iOS/Android | yes | +| ls | Views the current files and directory| Function | NO | iOS/Android | yes | +| mv | Moves a file | Function | NO | iOS/Android | yes | +| cp | Copies a file | Function | NO | iOS/Android | yes | +| exists | Checks whether a file exists | Function | NO | iOS/Android | yes | +| isDir | Checks whether a node is a directory | Function | NO | iOS/Android | yes | +| unlink | Removes a file | Function | NO | iOS/Android | yes | +| lstat | Obtains statistics of files in a directory | Function | NO | iOS/Android | yes | +| stat | Obtains data or directory statistics similarly| Function | NO | iOS/Android | yes | +| scanFile | Scans a file | Function | NO | Android | no | +| asset | Asset | Function | NO | iOS/Android | yes | +| df | Obtains the available disk space and total disk space of a device| Function | NO | iOS/Android | yes | #### iOS API @@ -616,8 +616,8 @@ ohpm install | Name | Description | Type | Required | Platform | HarmonyOS Support | | --------------- | ----------------------| ---------------- | -------- | -------- | ----------------- | -| previewDocument | 文档查看器--需要系统权限 | Function | No | iOS | yes | -| openDocument | 显示与文件交互的选项菜单--需要系统权限| Function | No | iOS | yes | +| previewDocument | Views documents. This operation requires system permissions. | Function | No | iOS | yes | +| openDocument | Displays the option menu for interacting with files. This operation requires system permissions.| Function | No | iOS | yes | #### Network Utils @@ -625,8 +625,8 @@ ohpm install | Name | Description| Type | Required | Platform | HarmonyOS Support | | ------------- | ----------- | ---| ----- | ----------- | ----------------- | -| getCookies | 获取 cookie| Function | No | iOS/Android | no | -| removeCookies | 删除 cookie| Function | No | iOS/Android | no | +| getCookies | Obtains cookie| Function | No | iOS/Android | no | +| removeCookies | Removes cookie| Function | No | iOS/Android | no | #### Session API @@ -634,10 +634,10 @@ ohpm install | Name | Description| Type | Required | Platform | HarmonyOS Support | | ------- | ----------- | --| ------ | ----------- | ----------------- | -| add | 向此会话添加文件路径 | Function | No | iOS/Android | yes | -| remove | 从此会话中删除会话条目而不删除文件 | Function | No | iOS/Android | yes | -| list | 返回包含此会话中的文件路径的数组 | Function | No | iOS/Android | yes | -| dispose | 删除会话中的所有文件 | Function | No | iOS/Android | yes | +| add | Adds a file path to the current session. | Function | No | iOS/Android | yes | +| remove | Removes session entries from the current session without deleting files. | Function | No | iOS/Android | yes | +| list | Returns an array containing the file paths in the current session. | Function | No | iOS/Android | yes | +| dispose | Disposes all files in a session. | Function | No | iOS/Android | yes | #### MediaStore(Android Media Storage) @@ -645,24 +645,24 @@ ohpm install | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---------------- | --------| ------ | -------- | -------- | ----------------- | -| CopyToMediaStore | 复制到媒体存储| Function | No | Android | no | -| createMediaFile | 创建媒体文件| Function | No | Android | no | -| writeMediaFile | 写媒体文件 | Function | No | Android | no | -| copyToInternal | 复制到内部 | Function | No | Android | no | +| CopyToMediaStore | Copies to media storage.| Function | No | Android | no | +| createMediaFile | Creates a media file.| Function | No | Android | no | +| writeMediaFile | Writes a media file. | Function | No | Android | no | +| copyToInternal | Copies to internal. | Function | No | Android | no | #### Utils API | Name | Description| Type | Required | Platform | HarmonyOS Support | | ------ | ----------- | ---| ----- | ----------- | ----------------- | -| wrap | 使文件路径可以被识别| Function | No | iOS/Android | yes | -| base64 | 使用base64编码解码| Function | No | iOS/Android | yes | -| session | 用于管理缓存文件 | Function | No | iOS/Android | yes | +| wrap | Wraps a file path to make it recognizable.| Function | No | iOS/Android | yes | +| base64 | Enables Base64 encoding and decoding.| Function | No | iOS/Android | yes | +| session | Manages cache files. | Function | No | iOS/Android | yes | -## 遗留问题 - - [ ] blob-util在使用getCookies、removeCookies 在Android、iOS、Harmony OS 上使用都会报错: [issue#381](https://github.com/RonRadtke/react-native-blob-util/issues/381) -## 其他 +## Known Issues + - [ ] blob-util throws errors when using **getCookies** and **removeCookies** on Android, iOS, and HarmonyOS: [issue#381](https://github.com/RonRadtke/react-native-blob-util/issues/381). +## Other -## 开源协议 +## License -本项目基于 [The MIT License (MIT)](https://github.com/RonRadtke/react-native-blob-util/blob/master/LICENSE) ，请自由地享受和参与开源。 +This project is licensed under [MIT License](https://github.com/RonRadtke/react-native-blob-util/blob/master/LICENSE). diff --git a/en/react-native-maps.md b/en/react-native-maps.md index 783fb581..e2377c44 100644 --- a/en/react-native-maps.md +++ b/en/react-native-maps.md @@ -458,26 +458,26 @@ Check the release version information in the release address of the third-party ### Permission Requirements -> [!TIP] 如需自建项目使用华为地图可以跳过以下第一步，并前往[华为开发者联盟](https://developer.huawei.com/consumer/cn/wiki/index.php)平台申请对应项目和应用程序 +> [!TIP] If you want to use HUAWEI Maps in a self-built project, skip the first step and go to the [HUAWEI Developers](https://developer.huawei.com/consumer/cn/wiki/index.php) platform to apply for the corresponding project and application. -> [!TIP] 详细配置参考华为开发者官网[地图服务](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/appgallery-connect-0000001751989088) +> [!TIP] For details about the configuration, see [Map Kit](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/appgallery-connect-0000001751989088) on the HUAWEI Developers website. -以下是示例项目配置 +The following is an example project configuration. -1.打开 `工程目录/AppScope/app.json5`,修改 +1. Open the `project_directory/AppScope/app.json5` file and modify the following: ``` - bundleName:"com.example.rnmapdemo" //自建项目请与开发者平台上的包名一致 + bundleName:"com.example.rnmapdemo" // For a self-built project, the bundle name must be the same as that on the developer platform. ``` -2.打开 `entry/src/main/module.json5`，添加相关配置 +2. Open the `entry/src/main/module.json5` file and add related configurations. ```diff ... - "metadata": [ // 配置如下信息 测试地图功能 + "metadata": [ // Configure the following information to test the map function: + { + "name": "client_id", -+ "value": "110168601" //配置为从华为开发者平台获取的Client ID，自建项目请与开发者平台上的client id一致 ++ "value": "110168601" // Set this parameter to the client ID obtained from the HUAWEI Developer platform. For a self-built project, the client ID must be the same as that on the developer platform. + } ], "requestPermissions": [ @@ -507,9 +507,9 @@ Check the release version information in the release address of the third-party ] ``` -3.在 entry 目录下添加申请地图权限的原因 +3. Add the reason for applying for the map permission in the **entry** directory. -打开 `entry/src/main/resources/base/element/string.json`，添加： +Open `entry/src/main/resources/base/element/string.json` and add the following: ```diff ... @@ -523,7 +523,7 @@ Check the release version information in the release address of the third-party } ``` -4.打开 `工程目录/build-profile.json5` 在 app 节点下修改 +4. Open the `project_directory/build-profile.json5` file and modify the file under the **app** node. ``` signingConfigs: [ @@ -531,13 +531,13 @@ Check the release version information in the release address of the third-party "name": "default", "type": "HarmonyOS", "material": { - "storePassword": "0000001F46D5FEE280574FA23000DE66587FD7FA83EEFEF6D5890B713F4B512621FD3A4F5F6965E94C20441708BCE7", //自建项目配置的指纹证书密码 - "certpath": "E:/aboutKey/rnmapdemo.cer", //自建项目配置的指纹证书 + "storePassword": "0000001F46D5FEE280574FA23000DE66587FD7FA83EEFEF6D5890B713F4B512621FD3A4F5F6965E94C20441708BCE7", // Fingerprint certificate password configured for a self-built + "certpath": "E:/aboutKey/rnmapdemo.cer", // Fingerprint certificate "keyAlias": "key0", - "keyPassword": "0000001F2B30EA30206AEBA445E5E69F5A42C4FA4F829039AEBEA0167FF3591ADCAED98732BE405314206771508E5C", //自建项目配置的指纹证书密码 - "profile": "E:/aboutKey/rnmapDebug.p7b", //自建项目配置的指纹证书 + "keyPassword": "0000001F2B30EA30206AEBA445E5E69F5A42C4FA4F829039AEBEA0167FF3591ADCAED98732BE405314206771508E5C", //Fingerprint certificate password configured for a self-built project + "profile": "E:/aboutKey/rnmapDebug.p7b", // Fingerprint certificate configured for a self-built project "signAlg": "SHA256withECDSA", - "storeFile": "E:/aboutKey/rnmapdemo.p12" //自建项目配置的指纹证书 + "storeFile": "E:/aboutKey/rnmapdemo.p12" // Fingerprint certificate configured for a self-built project } } ] @@ -601,11 +601,11 @@ Check the release version information in the release address of the third-party | isAccessibilityElement | Determines whether the MapView captures VoiceOver touches or forwards them to children. When `true`, map markers are not visible to VoiceOver. **Note:** iOS Maps only. | Boolean | false | no | ios | no | | cameraZoomRange | Map camera distance limits. `minCenterCoordinateDistance` for minimum distance, `maxCenterCoordinateDistance` for maximum, `animated` for animated zoom range changes. Takes precedence if conflicting with `minZoomLevel`, `maxZoomLevel`. **Note**: iOS 13.0+ only. | cameraZoomRange | | no | ios | no | -注：HarmonyOS 侧的 mapType 支持以下字符串值 +Note: **mapType** on HarmonyOS supports the following string values: 'none' \ 'standard' \ 'terrain' -注：HarmonyOS 侧的双击放大由 zoomEnabled 开启，zoomTapEnabled 不能单独关闭该功能。 +Note: The double-tap zoom-in function on HarmonyOS is enabled by **zoomEnabled**, and cannot be disabled by **zoomTapEnabled**. ### Static Methods @@ -703,7 +703,7 @@ Check the release version information in the release address of the third-party | lineDashPattern | An array of numbers specifying the dash pattern to use for the path. The array contains one or more numbers that indicate the lengths (measured in points) of the line segments and gaps in the pattern. The values in the array alternate, starting with the first line segment length, followed by the first gap length, followed by the second line segment length, and so on. | Array | | no | ios/android | yes | | tappable | Boolean to allow a polyline to be tappable and use the onPress function. | Bool | | no | ios/android | yes | -注：HarmonyOS 侧的 lineJoin 支持以下字符串值 +Note: **lineJoin** on HarmonyOS supports the following string values: 'default' \ 'bevel' \ 'round' @@ -731,7 +731,7 @@ Check the release version information in the release address of the third-party | tappable | Boolean to allow a polygon to be tappable and use the onPress function. | Bool | false | no | ios/android | yes | | zIndex | (Android Only) The order in which this polygon overlay is drawn with respect to other overlays. An overlay with a larger z-index is drawn over overlays with smaller z-indices. The order of overlays with the same z-index is arbitrary. The default zIndex is 0. | Number | 0 | no | ios/android | yes | -注：HarmonyOS 侧的 lineJoin 支持以下字符串值 +Note: **lineJoin** on HarmonyOS supports the following string values: 'default' \ 'bevel' \ 'round' @@ -873,7 +873,7 @@ Check the release version information in the release address of the third-party ## Cluster -> [!TIP] 点聚合组件是新开发组件，在原库上不存在。 +> [!TIP] The **Cluster** component is newly developed and does not exist in the original database. > [!TIP] The **Platform** column indicates the platform where the properties are supported in the original third-party library. @@ -883,17 +883,17 @@ Check the release version information in the release address of the third-party | Name | Description | Type | Default | Required | Platform | HarmonyOS Support | | ----------------- | --------------------------------- | --------------------------- | -------- | -------- | ----------- | ----------------- | -| distance | 聚合节点聚合的距离，单位vp | number | | yes | | yes | -| clusterItems | 待聚合节点数组 | Array<{ position: LatLng }> | | yes | | yes | +| distance | Clustering distance, in vp. | number | | yes | | yes | +| clusterItems | Array of nodes to be clustered. | Array<{ position: LatLng }> | | yes | | yes | ## Known Issues -- [ ] AIRMap 和 AIRMapMarker 中 Animated 未实现 [issues#1](https://github.com/react-native-oh-library/react-native-maps/issues/1) -- [X] AIRMapOverlay 组件目前华为地图中不支持往地图组件中添加自定义 view [issues#2](https://github.com/react-native-oh-library/react-native-maps/issues/2) -- [ ] AIRMap AIRMapMarker AIRMapPolyline AIRMapPolygon AIRMapCircle 组件在 HarmonyOS 中的不支持属性是因为华为地图没提供对应的属性 [issues#3](https://github.com/react-native-oh-library/react-native-maps/issues/3) -- [ ] AIRMapCallout AIRMapCalloutSubview 组件为 marker 子组件，华为地图中 marker 有自带的，但是目前不支持自定义样式显示 [issues#4](https://github.com/react-native-oh-library/react-native-maps/issues/4) -- [ ] AIRMapUrlTile AIRMapWMSTile 瓦片地图加载方式华为地图不支持 [issues#5](https://github.com/react-native-oh-library/react-native-maps/issues/5) -- [ ] Heatmap 华为地图不支持 [issues#6](https://github.com/react-native-oh-library/react-native-maps/issues/6) +- [ ] Animated in AIRMap and AIRMapMarker is not implemented. [issues#1](https://github.com/react-native-oh-library/react-native-maps/issues/1) +- [X] Currently, the AIRMapOverlay component does not support adding custom views to the map component. [issues#2](https://github.com/react-native-oh-library/react-native-maps/issues/2) +- [ ] The AIRMap, AIRMapMarker, AIRMapPolyline, AIRMapPolygon, and AIRMapCircle component does not support properties on HarmonyOS because HUAWEI Maps does not provide the corresponding properties. [issues#3](https://github.com/react-native-oh-library/react-native-maps/issues/3) +- [ ] The AIRMapCallout and AIRMapCalloutSubview components are subcomponents of the Marker component. HUAWEI Maps has a built-in Marker component, but the styles cannot be customized. [issues#4](https://github.com/react-native-oh-library/react-native-maps/issues/4) +- [ ] The AIRMapUrlTile AIRMapWMSTile loading mode is not supported by HUAWEI Maps. [issues#5](https://github.com/react-native-oh-library/react-native-maps/issues/5) +- [ ] The Heatmap is not supported by HUAWEI Maps. [issues#6](https://github.com/react-native-oh-library/react-native-maps/issues/6) ## Others diff --git a/en/react-native-progress.md b/en/react-native-progress.md index 4cdd913a..28945ea2 100644 --- a/en/react-native-progress.md +++ b/en/react-native-progress.md @@ -217,11 +217,11 @@ All of the props under _Properties_ in addition to the following: ## Known Issues -- [x] 已解决：1、Progress.Circle 中的属性 fill 在 HarmonyOS 上默认显示黑色和默认无色不一致，定位是 svg 的属性配置有问题，当前通过修改 Circle.js 中默认 fill 的属性进行规避，后续 svg 修复该问题[issue#6](https://github.com/react-native-oh-library/react-native-svg/issues/6)后，修改的代码会移除。 +- [x] Resolved: 1. The property **fill** in **Progress.Circle** is displayed in black by default on HarmonyOS, which is different from the default colorless mode. The cause is that the property configuration of the SVG is incorrect. Currently, the default **fill** property in **Circle.js** is modified to avoid this issue. After this issue, i.e., [issue#6](https://github.com/react-native-oh-library/react-native-svg/issues/6), is resolved in the SVG, the modified code will be removed. -- [x] 已解决：2、Progress.Circle中的属性color, unfilledColor,borderWith,borderColor中圆的颜色，在进行静态配置的时候颜色显示正常，在使用Button进行动态改变的时候，中间的圆会显示黑色和默认的颜色不一致，定位是svg的属性配置有问题，当前通过修改Circle.js中默认fill的属性进行规避，后续 svg 修复该问题[issue#7](https://github.com/react-native-oh-library/react-native-svg/issues/7)后，修改的代码会移除。 +- [x] Resolved: 2. The color of the circle in property **color**, **unfilledColor**, **borderWith**, and **borderColor** of **Progress.Circle** is displayed properly during static configuration. When the **Button** control is used to dynamically change the color, the color of the circle in the middle is displayed in black, which is different from the default color. The cause is that the SVG property configuration is incorrect. Currently, the default **fill** property in **Circle.js** is modified to avoid this issue. After this issue, i.e., [issue#7](https://github.com/react-native-oh-library/react-native-svg/issues/7), is resolved in the SVG, the modified code will be removed. -- [x] 已解决：3、Progress.pie中的属性color,borderWith,borderColor中内圆的颜色，在进行静态配置的时候颜色显示正常，在使用Button进行动态改变的时候，中间的圆会显示黑色和默认的颜色不一致，定位是svg的属性有问题，pie传入给svg的值是正常的，svg处理逻辑有问题，修改svg修复该问题[issue#8](https://github.com/react-native-oh-library/react-native-svg/issues/8) +- [x] Resolved: 3. The color of the inner circle in property **color**, **borderWith**, and **borderColor** of **Progress.pie** is displayed properly during static configuration. When the **Button** control is used to dynamically change the color, the color of the inner circle in the middle is displayed in black, which is different from the default color. The cause is that the SVG property is incorrect. The value transferred by **pie** to the SVG is normal. However, the SVG processing logic is incorrect. The SVG is modified to rectify the issue, i.e., [issue#8](https://github.com/react-native-oh-library/react-native-svg/issues/8). ## Others diff --git a/en/react-native-vector-icons.md b/en/react-native-vector-icons.md index 32863dbd..478cb7ee 100644 --- a/en/react-native-vector-icons.md +++ b/en/react-native-vector-icons.md @@ -39,7 +39,7 @@ The following code shows the basic use scenario of the repository: > [!WARNING] The name of the imported repository remains unchanged. -#### 自带字体图标对照网页 +#### Websites Providing the Internal Font Icons [Explore all icons](https://oblador.github.io/react-native-vector-icons/). @@ -59,9 +59,9 @@ The following code shows the basic use scenario of the repository: - [`Zocial`](http://zocial.smcllns.com/) by Sam Collins (v1.4.0 with _100_ icons) - [`SimpleLineIcons`](https://simplelineicons.github.io/) crafted by Sabbir & Contributors (v2.5.5 with _189_ icons) -### 本库自带字体的使用 +### Usage of the Internal Fonts -> [!ATTENTION] 使用字体时，请确保 entry/src/main/ets/assets/fonts 和 entry/src/main/resource/rawfile/assets/assets/fonts 下同时拥有要使用的 ttf 文件，否则图标不能正常显示 +> [!ATTENTION] When using internal fonts, ensure that the .ttf files to be used exists in both **entry/src/main/ets/assets/fonts** and **entry/src/main/resource/rawfile/assets/assets/fonts**. Otherwise, the icon cannot be displayed properly. ```js import FontAwesome from "react-native-vector-icons/FontAwesome"; @@ -73,22 +73,22 @@ import FontAwesome from "react-native-vector-icons/FontAwesome"; >; ``` -### 外部字体使用 +### Usage of the External Fonts -> [!ATTENTION] 使用外部字体时，请确保 entry/src/main/ets/assets/fonts 和 entry/src/main/resource/rawfile/assets/assets/fonts 下同时拥有要使用的 ttf 文件，否则图标不能正常显示 -> 使用外部字体时，不管是用户自己制作的字体文件还是从网站下载的字体文件，都需要有 _.ttf 和 _.json 文件(文件目录不固定，能引用到就可以了) +> [!ATTENTION] When using external fonts, ensure that the .ttf files to be used exists in both **entry/src/main/ets/assets/fonts** and **entry/src/main/resource/rawfile/assets/assets/fonts**. Otherwise, the icon cannot be displayed properly. +> When external fonts are used, the .ttf and .json files are required regardless of whether the font is created by you or downloaded from the website. (The file directory is not fixed.) -#### 用户自制字体文件 +#### Custom Font Files -用户自己制作的字体文件导入使用，以下字体文件名和字体家族名仅供参考，以用户实际输出字体文件信息为准 +To import a custom font file, the following names of the font file and font family are for reference only. Use the actual font file information. ```js import { createIconSet } from "react-native-vector-icons"; const CustomTest = createIconSet( - require("../assets/fonts/test.json"), // 引入本地assets下的字体资源 + require("../assets/fonts/test.json"), // Import font resources from local assets. "poppy-icon", - "../assets/fonts/test.ttf" // 引入本地assets下的字体资源 + "../assets/fonts/test.ttf" // Import font resources from local assets. ); ; ``` -#### [fontello](http://fontello.com)网站中的字体使用 +#### [Fonts from Fontello](http://fontello.com) -从[fontello](http://fontello.com)网站选择合适的字体之后下载对应的字体文件和配置文件导入使用 +Download the font file and configuration file of a proper font from [Fontello](http://fontello.com), and import them. ```js import { createIconSetFromFontello } from "react-native-vector-icons"; @@ -109,7 +109,7 @@ import fontelloConfig from "../assets/fonts/config.json"; const CustomFontello = createIconSetFromFontello( fontelloConfig, "fontello", - "../assets/fonts/fontello.ttf" // 引入本地assets下的字体资源 + "../assets/fonts/fontello.ttf" // Import font resources from local assets. ); ; ``` -#### [IcoMoon](https://icomoon.io/app)网站中的字体使用 +#### [Fonts from IcoMoon](https://icomoon.io/app) -从[IcoMoon](https://icomoon.io/app)网站选择合适的字体之后下载对应的字体文件和配置文件导入使用 +Download the font file and configuration file of a proper font from [IcoMoon](https://icomoon.io/app), and import them. ```js import { createIconSetFromIcoMoon } from "react-native-vector-icons"; -import icoMoonConfig from "../assets/fonts/selection.json"; // 引入本地assets下的字体资源 +import icoMoonConfig from "../assets/fonts/selection.json"; // Import font resources from local assets. const CustomFontIcoMoon = createIconSetFromIcoMoon( icoMoonConfig, "icomoon", - "../assets/fonts/icomoon.ttf" // 引入本地assets下的字体资源 + "../assets/fonts/icomoon.ttf" // Import font resources from local assets. );