鸿蒙 HarmonyOS 版怎么装：从源码构建 HAP 并签名安装

为什么不能直接下载安装包

鸿蒙的开发者工具必须登录华为账号才能下载，且其许可条款禁止再分发——公开 CI 服务因此无法合法代构建。所以官方不提供现成 HAP，只能自己从源码构建，签名同样依赖这套工具。官方明确表示：若鸿蒙生态规则允许，会直接发布现成安装包。

构建前置条件

• Node.js 24 或更高版本
• DevEco Studio（需华为开发者账号）
• 一台鸿蒙设备，用于最终安装

构建步骤概览

git clone <官方仓库地址>
cd Luker

随后在仓库的鸿蒙工程目录内用 DevEco Studio 打开并执行构建（具体目录与构建命令以仓库内鸿蒙构建文档为准）。

签名与安装

1. 生成密钥与 CSR：DevEco Studio 菜单里选 Build → Generate Key and CSR，设置密钥库名称、路径、密码与别名。
2. 签名 HAP：用鸿蒙 SDK 自带的 hap-sign-tool.jar 对构建产物签名。
3. 安装：设备上开启开发者选项与 USB 调试，连接后安装签好的 HAP。

装完之后

打开应用即直接显示完整界面——和安卓 APK 一样，服务端跑在设备本地，不需要浏览器访问地址、不需要终端工具。核心功能（多 API 连接、角色卡、世界书、预设、记忆图、编排）与桌面版基本一致。

后面怎么配置，直接跳首次配置走通。

构建流程细节可能随版本调整，以官方仓库的鸿蒙构建文档为准。