@ohos-cpf/3rdloop 0.0.1

package/vendor/Server/Skills/rn-lib-update-doc/references/format-diff.md

@@ -0,0 +1,137 @@
+# README 模板格式差异与改写要点
+
+## 如何判定格式（detect-readme-format.js）
+
+按下列信号综合判定，**不符目标模板则进入整改流程**：
+
+| 信号 | 外链/旧文档 | v0.4.0（usage-docs 常见） | v0.4.1（库内常见） | v0.4.2（目标） |
+|------|-------------|---------------------------|--------------------|----------------|
+| 首行 | 无 / `# 包名` | `> 模板版本：v0.4.0` 或 `> Template version: v0.4.0` | `> 文档模板：v0.4.1` | `> 文档模板：v0.4.2` |
+| 版本表 | 无完整表 | 有表，列名偏旧 | 含 `三方库版本` + **`npm地址`** | 含 **`三方库版本（npm地址）`** + **`源码地址`** |
+| 结构 | 常仅有 Documentation URL 外链 | 分节编号如 `## 1. 安装与使用` | `## 简介` / `## 下载安装` / `## 使用示例` 等 | 同 0.4.1 骨架，并强调 **`## 使用说明`** 等 0.4.2 章节 |
+| 外链特征 | 含 `Documentation URL` 且正文几乎只有外链 | — | — | — |
+
+`kind` 输出建议：`external_link` | `v0.4.0` | `v0.4.1` | `v0.4.2` | `unknown`。
+
+## 0.4.1 → 0.4.2 主要变更
+
+1. 首行版本改为 `v0.4.2`
+2. 版本关系表：
+   - `三方库版本` → `三方库版本（npm地址）`（单元格内放 npm 版本链接）
+   - `npm地址` 列改为 **`源码地址`**（指向 Gitcode 分支/源码树）
+3. 保留并理顺：`简介`、`下载安装`、`Link`、`约束与限制`、`使用示例`、`使用说明`、`接口说明`、`遗留问题`、`其他`、`目录结构`、`贡献代码`、`开源协议`
+4. 内容按**当前库**重写：Autolink、API 级别、兼容性矩阵、示例代码（从 example / 源码提取）
+5. **ManualLink 取舍**：若当前分支版本表与 Link 表中 Autolink **全部为是/Yes**，删除 README 中 ManualLink `<details>` 整段；详见下文「ManualLink 章节」
+
+## ManualLink 章节（Autolink 全支持时删除）
+
+模板 `model-0.4.2.md` 含 ManualLink 作为**多版本混合**时的兜底；**单分支且该分支所有版本均支持 Autolink** 时：
+
+- **删除** `<details>…ManualLink…</details>` 全部内容
+- **删除**「可跳过 ManualLink 配置」一句（全版本已 Autolink 时无意义）
+- **保留** Link 版本表、Autolinking 框架文档链接、`### 运行`
+
+判定数据源：版本关系表 `Autolink` 列 + `## Link` 小节表格；任一行 `否`/`No`/`partially` 则保留 ManualLink。
+
+- overview 回写（usage-docs）
+
+`model-0.4.2-overview.md` 为精简版：标题、基于上游说明、版本表、简介、下载安装。
+
+- 中英文都 **覆盖** `zh-cn/<alias>.md` 与 `en/<alias>.md`
+- 英文由中文 overview 翻译
+- 版本表等事实与库内 README 保持一致
+
+## 链接与组织（必读）
+
+### 根因说明（避免 openharmony-sig 残留）
+
+| 来源 | 问题 |
+|------|------|
+| **usage-docs 正文** | 大量文档仍含 `gitcode.com/openharmony-sig/...`，从 usage-docs 迁入库 README 时会**原样复制** |
+| **库内 package.json** | `repository.url` 可能仍指向旧组织 |
+| **模板 model-0.4.2.md** | 框架/本库链接已用 `CPF-RN`；但勿把 usage-docs 专用相对路径（如 `/zh-cn/link-source-code.md`）留到库 README |
+
+技能内置模板（`references/model-0.4.2.md`）的 **Releases / Issue / PR / Autolinking** 已使用 [CPF-RN](https://gitcode.com/CPF-RN) 组织；**不能**假设 usage-docs 与 package.json 已同步。
+
+### 组织与仓库解析顺序
+
+1. **本库 Gitcode 地址**：优先 `git remote get-url origin` 或 `package.json.repository.url`
+2. 若仍为 `openharmony-sig`，在 [CPF-RN 组织](https://gitcode.com/CPF-RN) 搜索 `rntpc_<alias>` 确认（如 [rntpc_react-native-audio](https://gitcode.com/CPF-RN/rntpc_react-native-audio)）
+3. **框架 Autolinking 文档**：`https://gitcode.com/CPF-RN/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md`（框架仓）
+4. **三方库接入指导**（如直接链接源码）：在 [usage-docs](https://gitcode.com/CPF-RN/usage-docs) 仓，例如 `zh-cn/link-source-code.md` → `https://gitcode.com/CPF-RN/usage-docs/blob/master/zh-cn/link-source-code.md`（**不在** `ohos_react_native`）
+5. **usage-docs 站内相对链接**（`/zh-cn/...`、`./link-source-code.md`）：迁入库 README 时必须改为 usage-docs **绝对 URL**（见 [`link-registry.json`](link-registry.json)）
+
+### Step 3.5 — 链接规范化（从 usage-docs 迁移后**必做**）
+
+```bash
+node scripts/normalize-readme-links.js --lib-path "$LIB"
+node scripts/normalize-readme-links.js --lib-path "$LIB" --write
+```
+
+脚本会：
+
+- 将 `openharmony-sig` URL **仅在 CPF-RN 目标可达时**替换（见 `link-verify.js`；不可达则保留并报告）
+- 将 `/zh-cn/link-source-code.md` 等 usage-docs 相对路径改为绝对链接，并对结果 URL **做 HTTP 可达性校验**
+- 校验库内相对路径（仅允许 `./README.md` / `./README_EN.md` 等）
+- 校验并同步修正 `package.json` 的 `repository.url` / `homepage` / `bugs.url`（验证通过才写回）
+
+**退出码 2** 表示链接不可达、仓库根 URL 未验证、或仍有失效相对路径/旧组织残留。
+
+### 链接可达性（必做，禁止仅改组织名）
+
+| 步骤 | 说明 |
+|------|------|
+| 解析仓库 | `resolveVerifiedLibRepoBase` 对多个候选 URL 执行 `curl -L`，选用首个 2xx/3xx |
+| 组织迁移 | 每个 `openharmony-sig` 链接触发「替换后 URL 是否可达」探测，失败则不替换 |
+| 改写后复检 | README / package 中所有 GitCode / usage-docs / npm 外链汇总校验 |
+| 失败处理 | 报告 `linkVerification.failures`；Agent 需修正仓库名、分支或链接后重跑 |
+
+```bash
+node scripts/normalize-readme-links.js --lib-path "$LIB"      # 含可达性检查
+node scripts/normalize-readme-links.js --lib-path "$LIB" --write  # 仅当 ok=true
+node scripts/normalize-package-meta.js --lib-path "$LIB" --write  # 同样校验 homepage/issues/LICENSE
+```
+
+离线调试可加 `--skip-verify`；**提交交付前必须去掉**。
+
+### README 贡献 / 协议链接（CPF-RN 本库）
+
+| 章节 | 中文 README | 英文 README |
+|------|-------------|-------------|
+| 贡献代码 / Contributing | Issue → `{libRepo}/issues`；PR → `{libRepo}/pulls` | 同左 |
+| 开源协议 / License | `{libRepo}/blob/master/LICENSE` | 同左 |
+
+`{libRepo}` = `https://gitcode.com/CPF-RN/rntpc_<alias>`（由 `normalize-readme-links.js` 解析）。
+
+**禁止：**
+
+- Issue/PR 仍指向 `openharmony-sig`
+- LICENSE 仅指向上游 GitHub（如 `github.com/.../LICENSE`），而本库根目录已有 MIT LICENSE
+
+### Step 5 — package.json 与 oh-package.json5
+
+见 [rn-lib-update-doc SKILL Step 5](../SKILL.md#step-5--规范-packagejson-与-harmony-oh-packagejson5必做)。
+
+```bash
+node scripts/normalize-package-meta.js --lib-path "$LIB" --write
+```
+
+### Step 6 — CHANGELOG
+
+见 [changelog-template.md](changelog-template.md) 与 `normalize-changelog.js`。
+
+## 英文标题对照（常用）
+
+| 中文 | English |
+|------|---------|
+| 简介 | Introduction |
+| 下载安装 | Installation |
+| 约束与限制 | Constraints and Limitations |
+| 使用示例 | Usage Example |
+| 使用说明 | Usage Guide |
+| 接口说明 | API Reference |
+| 遗留问题 | Known Issues |
+| 其他 | Others |
+| 目录结构 | Directory Structure |
+| 贡献代码 | Contributing |
+| 开源协议 | License |

package/vendor/Server/Skills/rn-lib-update-doc/references/link-registry.json

@@ -0,0 +1,33 @@
+{
+  "orgHome": "https://gitcode.com/CPF-RN",
+  "defaultLibOrg": "CPF-RN",
+  "deprecatedOrgPatterns": [
+    "gitcode.com/openharmony-sig/",
+    "gitcode.com/OpenHarmony-sig/",
+    "gitee.com/openharmony-sig/"
+  ],
+  "frameworkDocs": {
+    "autolinkingZh": "https://gitcode.com/CPF-RN/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md"
+  },
+  "usageDocs": {
+    "base": "https://gitcode.com/CPF-RN/usage-docs",
+    "branch": "master",
+    "linkSourceCodeZh": "https://gitcode.com/CPF-RN/usage-docs/blob/master/zh-cn/link-source-code.md",
+    "linkSourceCodeEn": "https://gitcode.com/CPF-RN/usage-docs/blob/master/en/link-source-code.md"
+  },
+  "libRepoNamePattern": "rntpc_{alias}",
+  "allowedRelativeTargetsInLibReadme": [
+    "./README.md",
+    "./README_EN.md",
+    "README.md",
+    "README_EN.md"
+  ],
+  "linkVerify": {
+    "method": "curl",
+    "followRedirects": true,
+    "timeoutSec": 15,
+    "acceptStatusMin": 200,
+    "acceptStatusMax": 399,
+    "note": "Org migration must pass HTTP check before replacing URLs"
+  }
+}

package/vendor/Server/Skills/rn-lib-update-doc/references/model-0.4.2-overview.md

@@ -0,0 +1,40 @@
+> 文档模板：v0.4.2
+
+<p align="center">
+  <h1 align="center"> <code>lottie-react-native</code> </h1>
+</p>
+
+本项目基于 [lottie-react-native](https://github.com/lottie-react-native/lottie-react-native) 开发。
+
+该第三方库的仓库已迁移至 Gitcode，且支持直接从 npm 下载，新的包名为：`@react-native-ohos/lottie-react-native` 版本所属关系如下：
+
+| 三方库名称    | 三方库版本（npm地址）    | 发布信息     | 支持RN版本    | Autolink     | 编译API版本     | 社区基线版本    |  源码地址   |
+| ------------ | ------------ | ------------------------------ | ------------- | ------------- |------------------------ | ------------- | ------------- | 
+| @react-native-ohos/lottie-react-native | [~ 7.3.0](https://www.npmjs.com/package/@react-native-ohos/lottie-react-native)    | [Gitcode Releases](https://gitcode.com/CPF-RN/rntpc_lottie-react-native/releases) | 0.82.* | 否 | API12+ | 7.3.4 | [br_rnoh0.82](https://gitcode.com/CPF-RN/rntpc_lottie-react-native/tree/br_rnoh0.82) |
+| @react-native-ohos/lottie-react-native | [~ 7.2.3](https://www.npmjs.com/package/@react-native-ohos/lottie-react-native)    | [Gitcode Releases](https://gitcode.com/CPF-RN/rntpc_lottie-react-native/releases) | 0.77.* | 否 | API12+ | 7.3.4 | [br_rnoh0.77](https://gitcode.com/CPF-RN/rntpc_lottie-react-native/tree/br_rnoh0.77) |
+| @react-native-ohos/lottie-react-native | [~ 6.4.2](https://www.npmjs.com/package/@react-native-ohos/lottie-react-native)    | [Gitcode Releases](https://gitcode.com/CPF-RN/rntpc_lottie-react-native/releases) | 0.72.* | 否 | API12+ | 7.3.4 | [br_rnoh0.72](https://gitcode.com/CPF-RN/rntpc_lottie-react-native/tree/br_rnoh0.72) |
+| @react-native-oh-tpl/lottie-react-native  | [<= 6.4.1-0.1.17@deprecated](https://www.npmjs.com/package/@react-native-ohos/lottie-react-native) | [Github Releases(deprecated)](https://github.com/react-native-oh-library/lottie-react-native/releases) | 0.72.* | 否 | API12+ | 7.3.4 | [sig](https://github.com/react-native-oh-library/lottie-react-native) |
+
+## 简介
+
+Lottie 组件用于 React Native。<br/>
+Lottie 是一个库生态系统，用于解析 Adobe After Effects 动画导出为 JSON 并带 bodymovin 原生渲染的动画！<br/>
+设计师首次可以在无需工程师手工繁琐重现的情况下，创造并交付精美的动画。
+
+## 下载安装
+
+进入到工程目录并输入以下命令：
+
+**npm**
+
+```bash
+npm install @react-native-ohos/lottie-react-native
+```
+
+**yarn**
+
+```bash
+yarn add @react-native-ohos/lottie-react-native
+```
+
+

package/vendor/Server/Skills/rn-lib-update-doc/references/model-0.4.2.md

@@ -0,0 +1,429 @@
+> 文档模板：v0.4.2
+
+<p align="center">
+  <h1 align="center"> <code>lottie-react-native</code> </h1>
+</p>
+
+本项目基于 [lottie-react-native](https://github.com/lottie-react-native/lottie-react-native) 开发。
+
+该第三方库的仓库已迁移至 Gitcode，且支持直接从 npm 下载，新的包名为：`@react-native-ohos/lottie-react-native` 版本所属关系如下：
+
+| 三方库名称    | 三方库版本（npm地址）    | 发布信息     | 支持RN版本    | Autolink     | 编译API版本     | 社区基线版本    |  源码地址   |
+| ------------ | ------------ | ------------------------------ | ------------- | ------------- |------------------------ | ------------- | ------------- | 
+| @react-native-ohos/lottie-react-native | [~ 7.3.0](https://www.npmjs.com/package/@react-native-ohos/lottie-react-native)    | [Gitcode Releases](https://gitcode.com/CPF-RN/rntpc_lottie-react-native/releases) | 0.82.* | 否 | API12+ | 7.3.4 | [br_rnoh0.82](https://gitcode.com/CPF-RN/rntpc_lottie-react-native/tree/br_rnoh0.82) |
+| @react-native-ohos/lottie-react-native | [~ 7.2.3](https://www.npmjs.com/package/@react-native-ohos/lottie-react-native)    | [Gitcode Releases](https://gitcode.com/CPF-RN/rntpc_lottie-react-native/releases) | 0.77.* | 否 | API12+ | 7.3.4 | [br_rnoh0.77](https://gitcode.com/CPF-RN/rntpc_lottie-react-native/tree/br_rnoh0.77) |
+| @react-native-ohos/lottie-react-native | [~ 6.4.2](https://www.npmjs.com/package/@react-native-ohos/lottie-react-native)    | [Gitcode Releases](https://gitcode.com/CPF-RN/rntpc_lottie-react-native/releases) | 0.72.* | 否 | API12+ | 7.3.4 | [br_rnoh0.72](https://gitcode.com/CPF-RN/rntpc_lottie-react-native/tree/br_rnoh0.72) |
+| @react-native-oh-tpl/lottie-react-native  | [<= 6.4.1-0.1.17@deprecated](https://www.npmjs.com/package/@react-native-ohos/lottie-react-native) | [Github Releases(deprecated)](https://github.com/react-native-oh-library/lottie-react-native/releases) | 0.72.* | 否 | API12+ | 7.3.4 | [sig](https://github.com/react-native-oh-library/lottie-react-native) |
+
+## 简介
+
+Lottie 组件用于 React Native。<br/>
+Lottie 是一个库生态系统，用于解析 Adobe After Effects 动画导出为 JSON 并带 bodymovin 原生渲染的动画！<br/>
+设计师首次可以在无需工程师手工繁琐重现的情况下，创造并交付精美的动画。
+
+## 下载安装
+
+进入到工程目录并输入以下命令：
+
+**npm**
+
+```bash
+npm install @react-native-ohos/lottie-react-native
+```
+
+**yarn**
+
+```bash
+yarn add @react-native-ohos/lottie-react-native
+```
+
+
+## Link
+
+|                                      | 是否支持autolink | RN框架版本 |
+|--------------------------------------|----------------|-----------|
+| ~ 7.3.0                              | No             |  0.82     |
+| ~ 7.2.3                              | No             |  0.77     |
+| ~ 6.4.2                              | Yes            |  0.72     |
+| <= 6.4.1-0.1.17@deprecated           | No             |  0.72     |
+
+使用 AutoLink 的工程需要根据 [Autolink 框架指导文档](https://gitcode.com/CPF-RN/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md) 配置。
+
+<!-- 以下 ManualLink 块：仅当 Link 表或版本关系表中存在「否/No/partially」时保留；当前分支若全部为「是/Yes」则整段删除（含本注释）。 -->
+<details>
+  <summary>ManualLink: 此步骤为手动配置原生依赖项的指导</summary>
+
+首先需要使用 DevEco Studio 打开项目里的 HarmonyOS 工程 `harmony`。
+
+### 1. Overrides RN SDK
+
+为了让工程依赖同一个版本的 RN SDK，需要在工程根目录的 `oh-package.json5` 添加 overrides 字段，指向工程需要使用的 RN SDK 版本。替换的版本既可以是一个具体的版本号，也可以是一个模糊版本，还可以是本地存在的 HAR 包或源码目录。
+
+关于该字段的作用请阅读[官方说明](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/ide-oh-package-json5-V5#zh-cn_topic_0000001792256137_overrides)
+
+```json
+{
+  "overrides": {
+    "@rnoh/react-native-openharmony": "^0.72.38" // ohpm 在线版本
+    // "@rnoh/react-native-openharmony" : "./react_native_openharmony.har" // 指向本地 har 包的路径
+    // "@rnoh/react-native-openharmony" : "./react_native_openharmony" // 指向源码路径
+  }
+}
+```
+
+### 2. 引入原生端代码
+
+目前有两种方法：
+
+- 通过 har 包引入；
+- 直接链接源码。
+
+方法一：通过 har 包引入（推荐）
+
+> [!TIP] har 包位于三方库安装路径的 `harmony` 文件夹下。
+
+打开 `entry/oh-package.json5`，添加以下依赖
+
+```json
+"dependencies": {
+    "@react-native-ohos/lottie-react-native": "file:../../node_modules/@react-native-ohos/lottie-react-native/harmony/lottie.har"
+  }
+```
+
+点击右上角的 `sync` 按钮
+
+或者在命令行终端执行：
+
+```bash
+cd entry
+ohpm install
+```
+
+方法二：直接链接源码
+
+> [!TIP] 如需使用直接链接源码，请参考[直接链接源码说明](https://gitcode.com/CPF-RN/usage-docs/blob/master/zh-cn/link-source-code.md)
+
+### 3. 配置 CMakeLists 和引入 LottieAnimationViewPackage
+
+打开 `entry/src/main/cpp/CMakeLists.txt`，添加：
+
+```diff
+project(rnapp)
+cmake_minimum_required(VERSION 3.4.1)
+set(CMAKE_SKIP_BUILD_RPATH TRUE)
+set(RNOH_APP_DIR "${CMAKE_CURRENT_SOURCE_DIR}")
+set(NODE_MODULES "${CMAKE_CURRENT_SOURCE_DIR}/../../../../../node_modules")
++ set(OH_MODULES "${CMAKE_CURRENT_SOURCE_DIR}/../../../oh_modules")
+set(RNOH_CPP_DIR "${CMAKE_CURRENT_SOURCE_DIR}/../../../../../../react-native-harmony/harmony/cpp")
+set(LOG_VERBOSITY_LEVEL 1)
+set(CMAKE_ASM_FLAGS "-Wno-error=unused-command-line-argument -Qunused-arguments")
+set(CMAKE_CXX_FLAGS "-fstack-protector-strong -Wl,-z,relro,-z,now,-z,noexecstack -s -fPIE -pie")
+set(WITH_HITRACE_SYSTRACE 1) # for other CMakeLists.txt files to use
+add_compile_definitions(WITH_HITRACE_SYSTRACE)
+
+add_subdirectory("${RNOH_CPP_DIR}" ./rn)
+
+# RNOH_BEGIN: manual_package_linking_1
+add_subdirectory("../../../../sample_package/src/main/cpp" ./sample-package)
++ add_subdirectory("${OH_MODULES}/@react-native-ohos/lottie-react-native/src/main/cpp" ./lottie)
+# RNOH_END: manual_package_linking_1
+
+file(GLOB GENERATED_CPP_FILES "./generated/*.cpp")
+
+add_library(rnoh_app SHARED
+    ${GENERATED_CPP_FILES}
+    "./PackageProvider.cpp"
+    "${RNOH_CPP_DIR}/RNOHAppNapiBridge.cpp"
+)
+target_link_libraries(rnoh_app PUBLIC rnoh)
+
+# RNOH_BEGIN: manual_package_linking_2
+target_link_libraries(rnoh_app PUBLIC rnoh_sample_package)
++ target_link_libraries(rnoh_app PUBLIC rnoh_lottie)
+# RNOH_END: manual_package_linking_2
+```
+
+打开 `entry/src/main/cpp/PackageProvider.cpp`，添加：
+
+```diff
+#include "RNOH/PackageProvider.h"
+#include "SamplePackage.h"
++ #include "LottieAnimationViewPackage.h"
+
+using namespace rnoh;
+
+std::vector<std::shared_ptr<Package>> PackageProvider::getPackages(Package::Context ctx) {
+    return {
+      std::make_shared<SamplePackage>(ctx),
++     std::make_shared<LottieAnimationViewPackage>(ctx)
+    };
+}
+```
+
+### 4. 在 ArkTs 侧引入 Lottie 组件
+
+找到 **function buildCustomComponent()**，一般位于 `entry/src/main/ets/pages/index.ets` 或 `entry/src/main/ets/rn/LoadBundle.ets`，添加：
+
+```diff
+  ...
++ import { LottieAnimationView, LOTTIE_TYPE } from "@react-native-ohos/lottie-react-native"
+
+@Builder
+export function buildCustomRNComponent(ctx: ComponentBuilderContext) {
+  ...
++ if (ctx.componentName === LOTTIE_TYPE) {
++   LottieAnimationView({
++     ctx: ctx.rnComponentContext,
++     tag: ctx.tag
++   })
++ }
+ ...
+}
+```
+
+> [!TIP] 本库使用了混合方案，需要添加组件名。
+
+在`entry/src/main/ets/pages/index.ets` 或 `entry/src/main/ets/rn/LoadBundle.ets` 找到常量 `arkTsComponentNames` 在其数组里添加组件名
+
+```diff
+const arkTsComponentNames: Array<string> = [
+  SampleView.NAME,
+  GeneratedSampleView.NAME,
+  PropsDisplayer.NAME,
++ LOTTIE_TYPE
+  ];
+```
+
+### 5. 在 ArkTs 侧引入 LottieAnimationViewPackage
+
+打开 `entry/src/main/ets/RNPackagesFactory.ts`，添加：
+
+> [!TIP] 版本 6.4.1-0.1.13 及以上需要
+
+```diff
+  ...
++ import {LottieAnimationViewPackage} from '@react-native-ohos/lottie-react-native/ts';
+
+export function createRNPackages(ctx: RNPackageContext): RNPackage[] {
+  return [
++    new LottieAnimationViewPackage(ctx)
+  ];
+}
+```
+</details>
+
+### 运行
+
+点击右上角的 `sync` 按钮
+
+或者在命令行终端执行：
+
+```bash
+cd entry
+ohpm install
+```
+
+然后编译、运行即可。
+
+
+
+## 约束与限制
+
+### 兼容性
+
+本文档内容基于以下版本验证通过：
+
+1. RNOH: 0.72.96; SDK: HarmonyOS 6.0.0 Release SDK; IDE: DevEco Studio 6.0.0.858; ROM: 6.0.0.112;
+2. RNOH: 0.72.33; SDK: HarmonyOS NEXT B1; IDE: DevEco Studio: 5.0.3.900; ROM: Next.0.0.71;
+3. RNOH: 0.77.18; SDK: HarmonyOS 6.0.0 Release SDK; IDE: DevEco Studio 6.0.0.858; ROM: 6.0.0.112;
+4. RNOH: 0.82.1; SDK: HarmonyOS 6.0.1 Release SDK; IDE: DevEco Studio 6.0.1 Release; ROM:6.0.0.120 SP7;
+
+### 权限要求
+
+- 如果 source 使用网络 url 应用需要申请网络权限
+
+  在`entry/src/main/module.json5`中添加
+
+```json
+requestPermissions: [
+  {
+    name: "ohos.permission.INTERNET",
+  },
+],
+```
+
+- 如果使用的 json 文件里有依赖图片资源或使用 imageAssetsFolder 属性，需要将资源文件放置到 HarmonyOS 工程 rawfile 下对应的路径中
+
+rawfile 路径：`entry/src/main/resources/rawfile`
+
+### 编译运行API要求（如有）
+
+> [!TIP] 当前三方库所有版本均已实现版本隔离，支持在 `API12+` 工程编译，及 `API12+` ROM运行。
+
+> [!TIP] 以下功能依赖特定版本的API，使用 `低于指定API版本的工程编译` 或 `低于指定API版本的ROM运行` 均可能导致部分功能受限。
+1. 3.2.0版本引入[OH_ArkUI_NodeUtils_GetParentInPag](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-node-h#oh_arkui_nodeutils_getparentinpagetree)，实现了xxx功能（解决/xxx问题），此API需要在支持`API14+`的工程编译，并在支持`API14+`的ROM上运行，方可生效。
+
+  
+ ## 使用示例
+下面的代码展示了这个库的基本使用场景：
+
+> [!WARNING] 使用时 import 的库名不变。
+
+```javascript
+import React from "react";
+import { View } from "react-native";
+import LottieView from "lottie-react-native";
+
+const App = () => {
+  return (
+    <View style={{ flex: 1 }}>
+      <LottieView 
+        style={{ width: 300, height: 300 }} 
+        source={require("./assets/xxx.json")}   
+        autoPlay 
+        loop />
+    </View>
+  );
+};
+
+export default App;
+```
+
+## 使用说明
+**动画设置**
+```javascript
+ <LottieView
+      source={require('./assets/animations/loading.json')} // JSON文件路径
+      style={{ width: 200, height: 200 }}
+      duration={6000}
+      resizeMode={'center'}
+      autoPlay        // 自动播放
+      loop            // 循环播放
+
+    />
+```
+
+**事件监听**
+```javascript
+<LottieView
+    style={{ width: 300, height: 300 }}
+    source={require("../assets/data_base64s.json")}
+    loop
+    onAnimationFinish={() => {
+        // 动画播放完成时调用
+    }}
+     onAnimationLoaded={() => {
+        // 加载完成时调用
+    }}
+     onAnimationFailure={(event)=>{
+       // 动画加载或播放失败时调用 
+    }}
+/>
+```
+
+**播放控制**
+```javascript
+ const animationRef = useRef<LottieView>(null);
+
+ <LottieView
+    ref={animationRef}
+    style={{ width: 300, height: 300 }}
+    source={require("../assets/data_base64s.json")}
+    loop={true} 
+/>
+
+// 重置动画
+animationRef.current.reset();
+// 播放动画
+animationRef.current.play();
+// 暂停动画
+animationRef.current.pause();
+// 恢复暂停的动画。
+animationRef.current.resume();
+```
+
+
+## 接口说明
+
+> [!TIP] "Platform"列表示该属性在原三方库上支持的平台。
+
+> [!TIP] "OpenHarmony Support"列为 yes 表示 OpenHarmony平台支持 该属性；no 则表示不支持；partially 表示部分支持。使用方法跨平台一致，效果对标 iOS 或 Android 的效果。
+
+### 组件
+| 名称       | 参数类型     | 必填  | 平台  | OpenHarmony平台支持| 描述 |
+|------------|------------|----------------------|------|-----|----------------|
+| LottieView | [LottieViewProps](#LottieViewProps) | yes  | all | yes | LottieView组件 |
+
+### 属性
+LottieViewProps
+
+| 名称                           | 参数类型          | 默认值       | 必填            | 平台   | HarmonyOS平台支持    | 描述 |
+|------------------------------|--------------------|------------|---------------|------|------------------|---------------|
+| source                       | string             | AnimationObject | { uri: string } | None | Yes              | 必填 - 动画来源。可以通过字符串引用本地资源，或通过带有 uri 属性的对象引用远程资源，也可以是动画的实际 JS 对象（例如通过 require('../path/to/animation.json') 获取）|
+| progress                     | number             | 0          | No            | iOS, Android, Windows | Yes              | 0 到 1 之间的数字。该数字表示动画的标准进度。如果更新此属性，动画将相应更新到该进度值对应的帧。如果使用命令式 API，则不需要此属性。|
+| speed                        | number             | 1          | No            | All  | Yes              | 动画播放的速度。设置为负值将使动画倒放                        |
+| duration                     | number             | undefined  | No            | iOS, Android, Windows | Yes              | 动画的持续时间（毫秒）。设置后将优先于速度属性。此属性仅在 source 为动画的实际 JS 对象时有效。|
+| loop                         | boolean            | true       | No            | All  | Yes              | 布尔值，指示动画是否应循环播放。                                |
+| autoPlay                     | boolean            | false      | No            | All  | Yes              | 布尔值，指示组件挂载时是否自动开始播放动画。这仅影响命令式 API。     |
+| resizeMode                   | 'cover'/ 'contain' /'center' | contain | No            | iOS, Android, Windows | Yes              | 确定当动画帧与原始图像尺寸不匹配时如何调整动画视图的大小。支持 cover、contain 和 center。|
+| style                        | StyleProp<ViewStyle> | None       | No            | iOS, Android, Windows | Yes              | 视图的样式属性，与标准 View 组件期望的样式相同，不包括边框样式     |
+| containerStyle<sup>7.3.0+</sup> | StyleProp<ViewStyle> | None       | No            | iOS, Android, VisionOS | Yes              | 最外层容器视图的样式属性，与标准 View 组件期望的样式相同。用于布局和定位。 |
+| webStyle                     | CSSProperties      | None       | No            | Web  | No               | 视图的样式属性，使用 CSSProperties。 |
+| imageAssetsFolder            | string             | None       | No            | Android | Yes              | Android 和 HarmonyOS 正确处理资源所需，iOS 将忽略此属性。   |
+| useNativeLooping             | boolean            | false      | No            | Windows | No               | 仅适用于 Windows。启用后，使用平台级循环以提高流畅度，但 onAnimationLoop 不会触发，且更改 loop 属性将重置播放而不是正常结束。|
+| onAnimationLoop              | callback           | None       | No            | Windows, Web | No               | 仅适用于 Windows 和 Web。动画循环播放时调用的回调函数。|
+| onAnimationFinish            | callback           | None       | No            | All  | Yes              | 动画完成时调用的回调函数。此回调带有一个布尔值 isCancelled 参数，指示动画是实际完成播放，还是被取消（例如在播放时调用了 play() 或 reset()）。注意：仅在 loop 设置为 false 时才会调用此回调。|
+| onAnimationFailure           | callback           | None       | No            | All  | Yes              | 处理动画（加载、运行等）过程中发生错误时调用的回调函数。此回调带有一个字符串 error 参数，其中包含发生的错误信息。|
+| onAnimationLoaded            | callback           | None       | No            | All  | Yes              | 动画加载完成时调用的回调函数。此回调不带参数。 |
+| renderMode                   | 'AUTOMATIC'        | 'HARDWARE' | 'SOFTWARE'    | AUTOMATIC | No               | iOS, Android | No   | 字符串标志，用于设置使用 HARDWARE（硬件）还是 SOFTWARE（软件）加速渲染 |
+| cacheComposition             | boolean            | true       | No            | Android | Yes              | 仅适用于 Android 和 HarmonyOS，布尔值指示是否应对动画进行缓存。 |
+| colorFilters                 | Array<ColorFilter> | []         | No            | iOS, Android, Windows | Yes              | 对象数组，表示通过 KeyPath 指定的图层以及新的颜色滤镜值（十六进制字符串）。  |
+| textFiltersAndroid           | Array<TextFilterAndroid> | []         | No            | Android | No               | 仅适用于 Android，表示要查找和替换的文本值的对象数组。 |
+| textFiltersIOS               | Array<TextFilterIOS> | []         | No            | iOS  | No               | 仅适用于 iOS，表示通过 KeyPath 指定的文本图层以及新的字符串值的对象数组。 |
+| hover                        | boolean            | false      | No            | Web  | No               | 仅适用于 Web，布尔值表示鼠标悬停时是否播放。 |
+| direction                    | 1                  | -1         | 1             | No   | Web              | No | 仅适用于 Web，数值 1 或 -1 表示播放方向。 |
+
+### API
+| 名称     | 类型     | 参数类型 | 返回值 | 必填    | 平台 | OpenHarmony平台支持 | 描述  |
+|--------|---------|-----|-------|-------|--------|-----|-----------------|
+| play   | function | /  | /   | No     | All | Yes   | 按指定的属性速度完整播放动画。也可以在调用 play(startFrame, endFrame) 时播放动画的一个部分（网页上不可用）。 |
+| reset  | function | /  | /   | No     | All | Yes   | 将动画重置回 0 进度。 |
+| pause  | function | /  | /   | No     | All | Yes   | 暂停动画。      |
+| resume | function | /  | /   | No     | All | Yes   | 恢复暂停的动画。   |
+
+## 遗留问题
+
+- 原库部分接口在 HarmonyOS 中没有对应属性及接口处理相关逻辑，问题: [issue#18](https://github.com/react-native-oh-library/lottie-react-native/issues/18)
+
+## 其他
+无
+  
+## 目录结构
+````
+/rntpc_lottie-react-native  # 项目根目录
+├── harmony              # 鸿蒙适配代码
+│    └─ lottie.har          # har包
+│    └─ lottie                  # 鸿蒙适配核心代码
+│          └─ index.ets    # 鸿蒙适配代码入口    
+│          └─ src/main/ets  
+│              └─ LottieAnimationView  # lottieView组件   。基于ohos/lottie库封装的lottieView组件   
+├── src                  # RN代码
+│    └─ index.tsx  # 入口文件 
+│    └─ LottieAnimationViewNativeComponent.ts 类型文件
+│    └─ codegenUtils.ts # 类型文件          
+├── README.md           # 英文安装使用方法    
+├── README_zh.md   # 中文安装使用方法                    
+````
+  
+## 贡献代码
+
+欢迎通过 Issue 和 Pull Request 参与贡献。
+
+- 提交 Issue：[GitCode Issues](https://gitcode.com/CPF-RN/rntpc_{alias}/issues)
+- 提交 Pull Request：[GitCode Pull Requests](https://gitcode.com/CPF-RN/rntpc_{alias}/pulls)
+
+请确保变更通过 lint 检查，并在 CHANGELOG 中记录变更内容。
+
+## 开源协议
+
+本项目基于 [The MIT License (MIT)](https://gitcode.com/CPF-RN/rntpc_{alias}/blob/master/LICENSE) ，请自由地享受和参与开源。