# builder_oh

**Repository Path**: lightsever/builder_oh

## Basic Information

- **Project Name**: builder_oh
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-17
- **Last Updated**: 2026-06-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# builder_oh

在 HarmonyOS PC NEXT（aarch64，鸿蒙内核 1.12.0）上**不依赖 hvigor** 原生构建 HarmonyOS HAP 包的工作区。所有工具链以预编译二进制形式提供，开箱即用。

## 快速开始

```bash
cd builder_oh
export LD_LIBRARY_PATH=$PWD/lib

# 冒烟测试：编译 ArkTS 到 .abc
bin/es2panda --version
bin/es2panda --extension=ets --arktsconfig=bin/arktsconfig.json \
  --output=test/hello.abc test/hello.ets

# 构建一个完整可安装的 GLES HAP 示例
./examples/hello-gles/build.sh
```

## 目录

```
bin/      # es2panda、restool、ohos_packing_tool、hap-sign-tool 等原生可执行
lib/      # 上述二进制的依赖 .so 与 ETS stdlib
sdk/      # OHOS ETS SDK 声明文件
tools/    # ets-loader（ArkUI 编译器，基于 Node.js）
doc/      # 详细文档
examples/ # 可复现示例（hello-gles）
test/     # 冒烟测试
```

## 系统要求

- HarmonyOS PC NEXT（aarch64）
- OHOS SDK 26.0.0.18（系统侧 `/data/service/hnp/ohos-sdk.org/` 提供 clang++、EGL/GLES 头与库）
- `node` v18+（仅 ets-loader 用到；系统自带 v24）

## 文档

- [HAP 构建流水线](doc/hap-pipeline.md) — ArkTS→abc→HAP→签名 的完整链路与工具命令
- [es2panda 本地构建笔记](doc/build-notes.md) — 从上游源码重建 `bin/es2panda` 的过程与补丁
- [hello-gles 示例文档](examples/hello-gles/README.md) — XComponent + NAPI + GLES 屏上渲染示例
- [hello-gles 设计方案](doc/hello-gles-方案.md) — 示例的选型、架构、踩坑记录
- [CLAUDE.md](CLAUDE.md) — 仓库工作约定与常用命令参考

## 来源

- `bin/es2panda`、`lib/*.so`、`lib/plugins/ets/etsstdlib.abc` — 本地构建自 `ark-standalone-build`（2026-06-16）
- `bin/{restool,ohos_packing_tool,hap-sign-tool,syscap_tool,ark_disasm,modulecheck,rescheck}`、`tools/ets-loader` — 原样拷贝自 OHOS SDK 26.0.0.18