Distinguish local rebuilds by artifact identity and change versions only for an explicitly requested release or version adjustment.
Trove 官方软件源
发现、安装,也创造属于你的 Curio。
这是 Trove 的官方软件源,提供官方维护的 Curio 工具目录与版本索引。在 Trove 中添加此源,即可浏览和安装已发布的工具。
本仓库维护 软件源索引 和发布同步工具。每个 Curio 的源码、构建与 Release 由 trove-curios 组织下的独立仓库维护,具体入口见下方的已收录工具。
添加官方源 · 开发 Curio · 已收录工具 · 完整开发文档
添加官方源
准备好可以运行的 Trove,并确认本机已安装 Git。
- 打开 Trove,进入 软件源 → 添加软件源。
- 填写以下信息:
| 字段 | 填写内容 |
|---|---|
| 显示名称 | Trove 官方软件源 |
| 唯一 ID | trove-official |
| 源类型 | Git 仓库 |
- 在仓库地址中粘贴:
https://git.render.ink/trove/curios.git
- 添加后刷新索引,选择想用的 Curio 并安装。
- 安装完成后,在 我的 Curios 中打开工具;连接设备或使用系统能力时,按工具提示完成配置与授权。
唯一 ID 必须与索引中的 id 一致。Trove 会读取默认分支的 source/index.json,获取版本和安装包地址;安装时校验包的大小、SHA-256、平台及清单。
开发 Curio
Curio 是运行在 Trove 中的独立工具。你可以从一个静态页面开始,使用 Web SDK 调用底座能力,也可以加入 Rust Backend 实现原生功能。
准备开发环境
在 Trove 的 开发 页面安装或检查命令行工具,然后打开新终端确认:
trove --version
Web 模板需要 Node.js 20.19+ 或 22.12+,以及 npm、pnpm、yarn、bun 中的一种。静态 HTML 模板不需要构建工具;Rust 模板还需要 Rust 工具链。
创建并运行
在你存放项目的目录运行:
trove new my-curio
cd my-curio
trove check
trove dev
向导会询问名称、ID 和模板;选择 Web 模板时还会询问包管理器及依赖安装。my-curio 必须是尚不存在的新目录。如果跳过了依赖安装,先在新项目内运行所选包管理器的安装命令,再执行 check 和 dev。
trove check 检查清单、工具链和依赖;trove dev 连接或启动底座,打开 Curio 开发窗口。Web 模板支持热更新,终端显示本次开发会话的日志。
已有 Web 项目可以在其根目录运行 trove adopt,按向导接入清单、SDK 和开发命令。详见 接入已有 Web 项目。
打包与验证
按 Ctrl-C 停止开发会话,再运行:
trove pack
trove install
安装包生成在 dist/packages/。trove install 会查找当前项目的包;有多个候选时,在终端选择。保持开发服务器停止,在 Trove 中打开已安装的工具,验证生产入口、资源和功能。
开发完成后,在插件自己的仓库发布 .curio 安装包。官方源的新增工具由维护者登记,已登记仓库发布 Release 后由收录流程同步索引。详见 官方软件源的维护与发布 与 版本约定。
继续阅读
| 你想做什么 | 文档 |
|---|---|
| 完成第一个可运行的工具 | 快速上手 |
| 了解开发会话与 CLI 命令 | CLI 与本地开发 |
| 调用底座提供的能力 | Web SDK |
| 编写清单或加入原生功能 | Manifest · Backend |
| 发布安装包与维护软件源 | 打包与分发 |
已收录工具
| Curio | 用途 | 源码与使用说明 |
|---|---|---|
| Harmony Assistant · 鸿蒙助手 | 在 Mac 上浏览互传文件与照片视频、安装卸载和备份应用,并使用开发者工具。 | harmony-assistant |
| Harmony Mirror · 鸿蒙投屏 | 在 Mac 的独立窗口中呈现鸿蒙屏幕,并操作设备。 | harmony-mirror |
可安装版本与平台以软件源中的条目为准;设备连接条件和使用方式见各工具的文档。
