@hxa-rn/react-native-gcanvas 6.0.24-beta.1

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+# Changelog
+
+## 鸿蒙化Log
+
+## 6.0.24-beta.1 - 2026-09-21
+
+release @hxa-rn/react-native-gcanvas@6.0.24-beta.1
+
+### Added
+
+- 首个鸿蒙适配版本，基于上游 `@flyskywhy/react-native-gcanvas` `6.0.24`；能力对齐上游：Canvas 2D / WebGL 视图、离屏画布、自定义字体、`toDataURL`、图片与纹理。
+- 基线：原库 `6.0.24`；框架基线 RNOH `0.72`；系统 API `13+`。

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 hxa-rn
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,207 @@
+# react-native-gcanvas
+
+本项目基于 [@flyskywhy/react-native-gcanvas](https://github.com/flyskywhy/react-native-gcanvas)开发。如果在使用过程中有任何问题，欢迎在AtomGit提交Issue，会及时跟进。
+
+## 项目介绍
+
+`@hxa-rn/react-native-gcanvas` 是 `@flyskywhy/react-native-gcanvas@6.0.24` 的鸿蒙适配包，提供基于 C++ GCanvas（OpenGL ES）引擎的 Canvas 2D / WebGL 原生视图。业务侧通过 `harmony.alias` 继续 `import ... from '@flyskywhy/react-native-gcanvas'`。
+
+本包含原生实现：C++ TurboModule `GCanvasModule`（20 个方法）+ Fabric 组件 `GCanvasView`（XComponent SURFACE + EGL）。JS 层复用上游命令字符串桥，鸿蒙侧补齐 `texImage2D` / `texSubImage2D`、`registerFont` / `getFontNames` 与远程图片下载。
+
+当前版本：`6.0.24-beta.1`。
+
+## 集成指南
+
+```bash
+npm install @hxa-rn/react-native-gcanvas
+```
+
+本包声明：
+
+```json
+{
+  "name": "@hxa-rn/react-native-gcanvas",
+  "version": "6.0.24-beta.1",
+  "peerDependencies": {
+    "react-native": ">=0.72"
+  },
+  "harmony": {
+    "alias": "@flyskywhy/react-native-gcanvas"
+  }
+}
+```
+
+工程按 `harmony.alias` 解析后，业务代码仍从原包名导入：
+
+```ts
+import {GCanvasView, GImage, createCanvas, getFontNames, registerFont} from '@flyskywhy/react-native-gcanvas';
+```
+
+`peerDependencies` 为 `react-native` >= 0.72。本模块含 C++ TurboModule 与 Fabric 组件。Autolinking 可用时跳过手动注册；手动接入时需同时注册 C++ `GcanvasPackage` 与 ETS `GcanvasPackage`，并把 `harmony/gcanvas.har` 加入 entry 依赖。
+
+## 使用说明
+
+```tsx
+import React from 'react';
+import {StyleSheet, View} from 'react-native';
+import {GCanvasView} from '@flyskywhy/react-native-gcanvas';
+
+export default function App() {
+  return (
+    <View style={styles.container}>
+      <GCanvasView
+        style={styles.canvas}
+        onCanvasCreate={(canvas) => {
+          const ctx = canvas.getContext('2d');
+          ctx.fillStyle = '#FF5722';
+          ctx.fillRect(10, 10, 100, 100);
+          ctx.font = '24px';
+          ctx.fillStyle = '#222222';
+          ctx.fillText('Hello GCanvas', 10, 160);
+        }}
+        onIsReady={(value) => {
+          console.log('canvas ready:', value);
+        }}
+      />
+    </View>
+  );
+}
+
+const styles = StyleSheet.create({
+  container: {flex: 1},
+  canvas: {width: 300, height: 200},
+});
+```
+
+`onCanvasCreate` 拿到 canvas 后即可 `getContext('2d'|'webgl')`。`toDataURL` 同步返回 `data:image/png;base64,...`。`registerFont(src, fontFace?)` 在鸿蒙已开通，随后可用 `getFontNames()` 查看枚举结果。加载远程图片时须在 `module.json5` 声明 `ohos.permission.INTERNET`。
+
+## 接口文档
+
+### 导出
+
+| 名称 | 类型 | 说明 |
+|------|------|------|
+| `GCanvasView` | React 组件 | Canvas 2D / WebGL 原生视图 |
+| `GImage` | 类 | 图片对象，走 `preLoadImage` |
+| `createCanvas(width, height)` | 函数 | 创建离屏 Canvas |
+| `getFontNames()` | 函数 | 返回系统可用字体名数组 |
+| `registerFont(src, fontFace?)` | 函数 | 注册自定义字体（鸿蒙已开通） |
+
+### `<GCanvasView>` Props / 事件
+
+| 名称 | 类型 | 说明 |
+|------|------|------|
+| `isGestureResponsible` | boolean | 是否响应画布内手势，默认 `true` |
+| `isAutoClearRectBeforePutImageData` | boolean | `putImageData` 前是否先 clear，仅 2D |
+| `isResetGlViewportAfterSetWidthOrHeight` | boolean | 宽高变化后是否重置 viewport |
+| `devicePixelRatio` | number | 未传时使用 `PixelRatio.get()` |
+| `offscreenCanvas` | boolean | 是否可作为 `document.createElement('canvas')` 离屏画布 |
+| `disableAutoSwap` | boolean | 关闭 WebGL 自动 swap |
+| `onCanvasCreate` | `(canvas) => void` | 画布对象就绪 |
+| `onCanvasResize` | `({width, height, canvas}) => void` | 视图尺寸变化 |
+| `onIsReady` | `(value) => void` | GL surface 就绪 / 销毁 |
+| `onMouseDown` / `onMouseMove` / `onMouseUp` | `(e) => void` | 触摸转 PointerEvent |
+
+### Canvas / 上下文
+
+| API | 说明 |
+|-----|------|
+| `canvas.getContext('2d' \| 'webgl')` | 取得 2D 或 WebGL 上下文 |
+| `canvas.toDataURL(mimeType, quality)` | 同步导出 Base64 |
+| `canvas.reset()` | 调用原生 `resetComponent` |
+| 2D：`fillRect` / `strokeRect` / `clearRect` / `fill` / `stroke` / `arc` | 矩形与路径 |
+| 2D：`fillText` / `strokeText` / `measureText` | 文本 |
+| 2D：`createLinearGradient` / `createRadialGradient` / `createPattern` | 渐变与图案 |
+| 2D：`scale` / `rotate` / `translate` / `save` / `restore` | 变换 |
+| 2D：`drawImage` / `getImageData` / `putImageData` | 图片与像素 |
+| WebGL：`createShader` / `compileShader` / `texImage2D` / `drawArrays` 等 | WebGL 1.0 |
+
+### TurboModule `GCanvasModule`（经 JS 桥内部调用）
+
+| 方法 | 同步 | 说明 |
+|------|------|------|
+| `enable` / `disable` / `resetComponent` | 混合同步 | 画布生命周期 |
+| `extendCallNative` | 同步 | 命令字符串执行并返回结果 |
+| `render` | 异步 | 命令字符串投递后立即返回 |
+| `setContextType` / `setDevicePixelRatio` / `resetGlViewport` | 同步 | 上下文与视口 |
+| `toDataURL` | 同步 | `glReadPixels` → PNG → base64 |
+| `preLoadImage` / `bindImageTexture` | 异步 | 图片解码与纹理绑定 |
+| `texImage2D` / `texSubImage2D` | 同步 | WebGL 纹理上传 |
+| `getFontNames` / `addFontFamily` / `setExtraFontLocation` | 同步 | 字体 |
+| `setAlpha` | 异步 | 空壳，对齐 Android/iOS，不产生实际透明度 |
+
+## 快速验证（运行 Example）
+
+### 前置条件
+
+| 依赖 | 版本要求 |
+|------|----------|
+| Node.js | >= 18 |
+| DevEco Studio | 5.0+ / 6.0+ |
+| HarmonyOS SDK | API 12+ |
+
+### 运行步骤
+
+**1. 克隆仓库**
+
+```bash
+git clone https://gitcode.com/hxa-rn/react-native-gcanvas.git
+cd react-native-gcanvas
+git checkout br_rnoh0.72
+```
+
+**2. 安装仓库开发依赖**
+
+```bash
+npm install --legacy-peer-deps
+```
+
+Example 已改为从 npm 公仓安装 `@hxa-rn/react-native-gcanvas@6.0.24-beta.1`，不再使用本地 `file:../xxx.tgz`，运行 Example 不必再执行 `npm pack`。
+
+**3. 进入 example 目录，安装依赖**
+
+```bash
+cd example
+npm install --legacy-peer-deps
+```
+
+**4. 生成 JS Bundle**
+
+```bash
+npm run dev
+```
+
+产物：`harmony/entry/src/main/resources/rawfile/bundle.harmony.js`
+
+**5. 用 DevEco Studio 打开鸿蒙工程**
+
+- 打开 DevEco Studio
+- 选择 `example/harmony` 目录
+- 等待 Sync 完成
+
+**6. 编译并运行 HAP**
+
+在 DevEco Studio 中点击运行按钮，将 HAP 安装到设备/模拟器。
+
+> **注意**：Example 中已预置插件依赖和 Package 注册，无需手动配置 Link。
+
+## 约束与限制
+
+- **兼容性**：Demo `compatibleSdkVersion` 为 `5.0.1(13)`；`react-native` >= 0.72；RNOH 0.72+；HarmonyOS API 12+（适配构建环境为 API 13）。
+- **权限**：加载远程 `http(s)` 图片时需在应用 `module.json5` 声明 `ohos.permission.INTERNET`。库模块本身无额外系统权限。
+- **远程图片**：鸿蒙 `image.createImageSource` 不接受 http URL，须先经 `@ohos.net.http` 下载。
+- **`setAlpha`**：空实现，对齐 Android/iOS 原空壳语义。
+- **`getImageData` / `measureText`**：走 `execWithoutDisplay`，读完后需再绘制才能上屏。
+- **真机渲染**：2D / WebGL 实际画面、字形与远程图片效果需在设备上确认。
+
+## 开源license
+
+本项目基于 MIT 协议，详见 [LICENSE](./LICENSE) 文件。
+
+## 问题反馈渠道
+
+欢迎在 AtomGit 提交 Issue。也可在 GitCode 仓库反馈：
+
+https://gitcode.com/hxa-rn/react-native-gcanvas
+
+https://gitcode.com/hxa-rn/react-native-gcanvas/issues

package/harmony/gcanvas/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2015-present, Facebook, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/harmony/gcanvas/NOTICE

@@ -0,0 +1,33 @@
+OPEN SOURCE SOFTWARE NOTICE
+
+Please note we provide an open source software notice for the third party open source software along with this software and/or this software component (in the following just “this SOFTWARE”). The open source software licenses are granted by the respective right holders.
+
+Warranty Disclaimer
+THE OPEN SOURCE SOFTWARE IN THIS PRODUCT IS DISTRIBUTED IN THE HOPE THAT IT WILL BE USEFUL, BUT WITHOUT ANY WARRANTY, WITHOUT EVEN THE IMPLIED WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. SEE THE APPLICABLE LICENSES FOR MORE DETAILS.
+
+Copyright Notice and License Texts
+
+----------------------------------------------------------------------
+Software: react-native-netinfo V11.1.0
+
+MIT License
+
+Copyright (c) 2015-present, Facebook, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/harmony/gcanvas/OAT.xml

@@ -0,0 +1,38 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<configuration>
+	<oatconfig>
+	<licensefile>LICENSE</licensefile>
+		<filefilterlist>
+			<filefilter name="copyrightPolicyFilter" desc="Filters for compatibility，license header policies">
+				<filteritem type="filename" name="hvigorfile.ts" desc="hvigor构建脚本，DevEco Studio自动生成，不需要添加版权头"/>
+				<filteritem type="filename" name="*.json5" desc="hvigor工程配置文件，DevEco Studio自动生成，不需要添加版权头"/>
+				<filteritem type="filename" name="*.proto" desc="资源文件，不需要添加版权头"/>
+				<filteritem type="filename" name="*.json" desc="资源文件，不需要添加版权头"/>
+				<filteritem type="filepath" name="hvigorw" desc="工程模板，不修改版权头，以防有修改版权风险"/>
+				<filteritem type="filepath" name="hvigorw.bat" desc="工程模板，不修改版权头，以防有修改版权风险"/>
+				<filteritem type="filepath" name="hvigor/hvigor-wrapper.js" desc="工程模板，不修改版权头，以防有修改版权风险"/>
+                <filteritem type="filename" name="LICENSE" desc="工程文件，不修改版权头"/>
+			</filefilter>
+			<filefilter name="defaultPolicyFilter" desc="Filters for compatibility，license header policies">
+				<filteritem type="filename" name="hvigorfile.ts" desc="hvigor构建脚本，DevEco Studio自动生成，不需要添加许可证头"/>
+				<filteritem type="filename" name="*.json5" desc="hvigor工程配置文件，DevEco Studio自动生成，不需要添加许可证头"/>
+				<filteritem type="filename" name="LICENSE" desc="原三方库证书文件无需更改，因此添加过滤"/>
+				<filteritem type="filename" name="*.proto" desc="资源文件，不需要添加许可证头"/>
+				<filteritem type="filename" name="*.json" desc="资源文件，不需要添加许可证头"/>
+				<filteritem type="filepath" name="hvigorw" desc="工程模板，不修改版权头，以防有修改版权风险"/>
+				<filteritem type="filepath" name="hvigorw.bat" desc="工程模板，不修改版权头，以防有修改版权风险"/>
+				<filteritem type="filepath" name="hvigor/hvigor-wrapper.js" desc="工程模板，不修改版权头，以防有修改版权风险"/>
+			</filefilter>
+			<filefilter name="binaryFileTypePolicyFilter" desc="Filters for resources files policies">
+				<filteritem type="filename" name="icon.png" desc="应用图标"/>
+				<filteritem type="filename" name="app_icon.png" desc="应用图标"/>
+				<filteritem type="filename" name="warn.png" desc="页面展示图标"/>
+			</filefilter>
+		</filefilterlist>
+        <policylist>
+            <policy name="projectPolicy" desc="">
+                <policyitem type="license" name="MIT" path="*.*" desc="license under the MIT"/>
+            </policy>
+        </policylist>
+	</oatconfig>
+</configuration>

package/harmony/gcanvas/build-profile.json5

@@ -0,0 +1,16 @@
+{
+  "apiType": "stageMode",
+  "buildOption": {
+    "externalNativeOptions": {
+      "path": "./src/main/cpp/CMakeLists.txt",
+      "arguments": "",
+      "cppFlags": ""
+    }
+  },
+  "targets": [
+    {
+      "name": "default",
+      "runtimeOS": "HarmonyOS"
+    }
+  ]
+}

package/harmony/gcanvas/hvigorfile.ts

@@ -0,0 +1,2 @@
+// Script for compiling build behavior. It is built in the build plug-in and cannot be modified currently.
+export { harTasks } from '@ohos/hvigor-ohos-plugin';

package/harmony/gcanvas/index.ets

@@ -0,0 +1 @@
+export { GcanvasPackage as default } from './src/main/ets/GcanvasTurboModulesFactory';

package/harmony/gcanvas/oh-package.json5

@@ -0,0 +1,14 @@
+{
+  "license": "Apache-2.0",
+  "devDependencies": {
+
+  },
+  "author": "",
+  "name": "@hxa-rn/react-native-gcanvas",
+  "description": "Please describe the basic information.",
+  "main": "index.ets",
+  "version": "1.0.0",
+  "dependencies": {
+    "@rnoh/react-native-openharmony": "file:../react_native_openharmony_release.har"
+  }
+}

package/harmony/gcanvas/src/main/cpp/CMakeLists.txt

@@ -0,0 +1,126 @@
+# GCanvas 鸿蒙 C++ 库构建配置。
+cmake_minimum_required(VERSION 3.13)
+set(CMAKE_VERBOSE_MAKEFILE on)
+project(gcanvas_library)
+
+# The public NAPI/XComponent entry remains libgcanvas.so.  The vendored
+# renderer/core is linked into it as a static implementation library.
+set(GCANVAS_WEEX ON)
+
+# RNOH/RN 头文件（ViewProps.h 等）使用 std::optional，要求 C++17。
+set(CMAKE_CXX_STANDARD 17)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+
+find_package(react-native-openharmony REQUIRED CONFIG)
+
+if(EXISTS "${CMAKE_CURRENT_SOURCE_DIR}/core/CMakeLists.txt")
+    add_subdirectory(core)
+    set(GCANVAS_CORE_LIB gcanvas_core)
+else()
+    set(GCANVAS_CORE_LIB "")
+endif()
+
+# 从 imported 目标 rnoh_semi 的库位置反推 RNOH 包根目录。Windows 上可由
+# -DRNOH_PKG_ROOT=<short-path> 覆盖，避免 ohpm 哈希目录触发 MAX_PATH。
+if(NOT DEFINED RNOH_PKG_ROOT)
+    get_target_property(_rnoh_semi_loc react-native-openharmony::rnoh_semi IMPORTED_LOCATION)
+    get_filename_component(_rnoh_pkg_libdir "${_rnoh_semi_loc}" DIRECTORY)   # .../libs/arm64-v8a
+    get_filename_component(_rnoh_pkg_libdir "${_rnoh_pkg_libdir}" DIRECTORY) # .../libs
+    get_filename_component(RNOH_PKG_ROOT "${_rnoh_pkg_libdir}" DIRECTORY)    # <pkg_root>
+endif()
+set(RNOH_CPP_DIR "${RNOH_PKG_ROOT}/src/main/include")
+set(REACT_COMMON_PATCH_DIR "${RNOH_CPP_DIR}/patches/react_native_core")
+
+set(library_generated_dir "${CMAKE_CURRENT_SOURCE_DIR}/generated")
+
+# folly F14 链接一致性：FOLLY_MOBILE=1（failure-lessons testing-cmake-004）。
+set(folly_compile_options
+    -DFOLLY_NO_CONFIG=1
+    -DFOLLY_MOBILE=1
+    -DFOLLY_USE_LIBCPP=1
+    -DFOLLY_HAVE_RECVMMSG=1
+    -DFOLLY_HAVE_PTHREAD=1
+    -Wno-comma
+    -Wno-shorten-64-to-32
+    -faligned-new
+)
+
+include_directories(
+    ${CMAKE_CURRENT_SOURCE_DIR}
+    ${library_generated_dir}
+    ${RNOH_CPP_DIR}
+    ${REACT_COMMON_PATCH_DIR}
+    ${RNOH_CPP_DIR}/third-party/folly
+    ${RNOH_CPP_DIR}/third-party/rn/ReactCommon
+    ${RNOH_CPP_DIR}/third-party/rn/ReactCommon/react/nativemodule/core
+    ${RNOH_CPP_DIR}/third-party/rn/ReactCommon/jsi
+    ${RNOH_CPP_DIR}/third-party/rn/ReactCommon/callinvoker
+    ${RNOH_CPP_DIR}/third-party/boost/libs/utility/include
+    ${RNOH_CPP_DIR}/third-party/boost/libs/stacktrace/include
+    ${RNOH_CPP_DIR}/third-party/boost/libs/predef/include
+    ${RNOH_CPP_DIR}/third-party/boost/libs/array/include
+    ${RNOH_CPP_DIR}/third-party/boost/libs/throw_exception/include
+    ${RNOH_CPP_DIR}/third-party/boost/libs/config/include
+    ${RNOH_CPP_DIR}/third-party/boost/libs/core/include
+    ${RNOH_CPP_DIR}/third-party/boost/libs/preprocessor/include
+    ${RNOH_CPP_DIR}/third-party/double-conversion
+    ${RNOH_CPP_DIR}/third-party/rn/ReactCommon/react/renderer/graphics/platform/cxx
+    ${RNOH_CPP_DIR}/third-party/rn/ReactCommon/runtimeexecutor
+    ${RNOH_CPP_DIR}/third-party/glog/src
+    ${RNOH_CPP_DIR}/third-party/boost/libs/mpl/include
+    ${RNOH_CPP_DIR}/third-party/boost/libs/type_traits/include
+    ${RNOH_CPP_DIR}/third-party/rn/ReactCommon/yoga
+    ${RNOH_CPP_DIR}/third-party/boost/libs/intrusive/include
+    ${RNOH_CPP_DIR}/third-party/boost/libs/assert/include
+    ${RNOH_CPP_DIR}/third-party/boost/libs/move/include
+    ${RNOH_CPP_DIR}/third-party/boost/libs/static_assert/include
+    ${RNOH_CPP_DIR}/third-party/boost/libs/container_hash/include
+    ${RNOH_CPP_DIR}/third-party/boost/libs/describe/include
+    ${RNOH_CPP_DIR}/third-party/boost/libs/mp11/include
+    ${RNOH_CPP_DIR}/third-party/boost/libs/iterator/include
+    ${RNOH_CPP_DIR}/third-party/boost/libs/detail/include
+    ${RNOH_CPP_DIR}/third-party/boost/libs/regex/include
+    ${RNOH_CPP_DIR}/patches/react_native_core/react/renderer/textlayoutmanager/platform/harmony
+)
+
+# 不用 **/*.cpp：OHOS CMake 在 Windows 上常匹配不到 → 空列表 → No SOURCES。
+# Codegen 的 TurboModule 与 Fabric 组件实现必须都进入插件目标；只保留头文件会让
+# Package 虽能注册 descriptor，却在运行/最终链接阶段缺失 Props/EventEmitter vtable。
+file(GLOB_RECURSE library_generated_SRC CONFIGURE_DEPENDS "${library_generated_dir}/*.cpp")
+file(GLOB library_SRC CONFIGURE_DEPENDS *.cpp)
+
+add_library(gcanvas SHARED
+    ${library_SRC}
+    ${library_generated_SRC}
+)
+
+target_compile_options(gcanvas PUBLIC ${folly_compile_options})
+target_compile_options(gcanvas PUBLIC -Wno-unused-command-line-argument)
+# RNOH 预编译 Fabric 库以 NDEBUG ABI 构建（Hvigor 的 debug profile 同样带
+# -DNDEBUG）；显式保持一致，避免独立插件构建误启用 React Native debug-only vtable。
+target_compile_definitions(gcanvas PRIVATE OHOS=1 GCANVAS_WEEX=1 NDEBUG)
+
+# 链接 RNOH 运行时（TurboModule 代理依赖 ArkTSTurboModule/TurboModule 等符号）与 GL/EGL/字体系统库。
+target_link_libraries(gcanvas PUBLIC
+    react-native-openharmony::rnoh_semi
+    react-native-openharmony::react_nativemodule_core
+    react-native-openharmony::runtimeexecutor
+    react-native-openharmony::jsi
+    react-native-openharmony::react_utils
+    react-native-openharmony::react_render_core
+    react-native-openharmony::react_render_graphics
+    react-native-openharmony::rrc_view
+    ${GCANVAS_CORE_LIB}
+    libace_napi.z.so      # NAPI / XComponent（OH_NativeXComponent_*）
+    libace_ndk.z.so       # ArkUI NDK
+    libhilog_ndk.z.so     # OH_LOG_Print 日志
+    libEGL.so             # Khronos EGL（eglCreateWindowSurface 等）
+    libGLESv3.so          # OpenGL ES 3.2
+    libnative_drawing.so  # OH_Drawing_RegisterFont / FontMgr 字体
+    libnative_window.so   # OHNativeWindow
+    libimage_packer.so    # toDataURL 图片编码
+    libimage_source.so    # PixelMap/图片数据
+    libpixelmap.so        # OH_PixelmapNative
+)
+
+target_link_options(gcanvas PRIVATE "-Wl,-z,max-page-size=16384")