render
177c7572c8
Explain how to add the official source and develop, package, and install Curios. Use the selected blue-and-white illustration as the README hero and preserve the poster variants and prompts for reference. Validation: documentation links and anchors checked; CLI static starter creation, check, and pack passed; image dimensions and asset links verified.
99 lines
4.6 KiB
Markdown
99 lines
4.6 KiB
Markdown
|
|
|
|
# Trove 官方软件源
|
|
|
|
**发现、安装，也创造属于你的 Curio。**
|
|
|
|
这是 [Trove](https://trove.render.ink/zh) 的官方软件源，提供官方维护的 Curio 工具目录与版本索引。在 Trove 中添加此源，即可浏览和安装已发布的工具。
|
|
|
|
本仓库维护 [软件源索引](source/index.json) 和发布同步工具。每个 Curio 的源码、构建与 Release 由 `trove-curios` 组织下的独立仓库维护，具体入口见下方的[已收录工具](#已收录工具)。
|
|
|
|
[添加官方源](#添加官方源) · [开发 Curio](#开发-curio) · [已收录工具](#已收录工具) · [完整开发文档](https://trove.render.ink/zh/docs)
|
|
|
|
## 添加官方源
|
|
|
|
准备好可以运行的 Trove，并确认本机已安装 Git。
|
|
|
|
1. 打开 Trove，进入 **软件源 → 添加软件源**。
|
|
2. 填写以下信息：
|
|
|
|
| 字段 | 填写内容 |
|
|
| --- | --- |
|
|
| 显示名称 | `Trove 官方软件源` |
|
|
| 唯一 ID | `trove-official` |
|
|
| 源类型 | `Git 仓库` |
|
|
|
|
3. 在仓库地址中粘贴：
|
|
|
|
```text
|
|
https://git.render.ink/trove/curios.git
|
|
```
|
|
|
|
4. 添加后**刷新索引**，选择想用的 Curio 并安装。
|
|
5. 安装完成后，在 **我的 Curios** 中打开工具；连接设备或使用系统能力时，按工具提示完成配置与授权。
|
|
|
|
唯一 ID 必须与索引中的 `id` 一致。Trove 会读取默认分支的 `source/index.json`，获取版本和安装包地址；安装时校验包的大小、SHA-256、平台及清单。
|
|
|
|
## 开发 Curio
|
|
|
|
Curio 是运行在 Trove 中的独立工具。你可以从一个静态页面开始，使用 Web SDK 调用底座能力，也可以加入 Rust Backend 实现原生功能。
|
|
|
|
### 准备开发环境
|
|
|
|
在 Trove 的 **开发** 页面安装或检查命令行工具，然后打开新终端确认：
|
|
|
|
```sh
|
|
trove --version
|
|
```
|
|
|
|
Web 模板需要 Node.js 20.19+ 或 22.12+，以及 npm、pnpm、yarn、bun 中的一种。静态 HTML 模板不需要构建工具；Rust 模板还需要 Rust 工具链。
|
|
|
|
### 创建并运行
|
|
|
|
在你存放项目的目录运行：
|
|
|
|
```sh
|
|
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 项目](https://trove.render.ink/zh/docs/integrate-web-app)。
|
|
|
|
### 打包与验证
|
|
|
|
按 `Ctrl-C` 停止开发会话，再运行：
|
|
|
|
```sh
|
|
trove pack
|
|
trove install
|
|
```
|
|
|
|
安装包生成在 `dist/packages/`。`trove install` 会查找当前项目的包；有多个候选时，在终端选择。保持开发服务器停止，在 Trove 中打开已安装的工具，验证生产入口、资源和功能。
|
|
|
|
开发完成后，在插件自己的仓库发布 `.curio` 安装包。官方源的新增工具由维护者登记，已登记仓库发布 Release 后由收录流程同步索引。详见 [官方软件源的维护与发布](docs/development.md) 与 [版本约定](docs/versioning.md)。
|
|
|
|
### 继续阅读
|
|
|
|
| 你想做什么 | 文档 |
|
|
| --- | --- |
|
|
| 完成第一个可运行的工具 | [快速上手](https://trove.render.ink/zh/docs/quick-start) |
|
|
| 了解开发会话与 CLI 命令 | [CLI 与本地开发](https://trove.render.ink/zh/docs/development) |
|
|
| 调用底座提供的能力 | [Web SDK](https://trove.render.ink/zh/docs/sdk) |
|
|
| 编写清单或加入原生功能 | [Manifest](https://trove.render.ink/zh/docs/manifest) · [Backend](https://trove.render.ink/zh/docs/backend) |
|
|
| 发布安装包与维护软件源 | [打包与分发](https://trove.render.ink/zh/docs/distribution) |
|
|
|
|
## 已收录工具
|
|
|
|
| Curio | 用途 | 源码与使用说明 |
|
|
| --- | --- | --- |
|
|
| Harmony Assistant · 鸿蒙助手 | 在 Mac 上收发鸿蒙设备文件与文件夹、管理应用、保存资料备份。 | [harmony-assistant](https://git.render.ink/trove-curios/harmony-assistant) |
|
|
| Harmony Mirror · 鸿蒙投屏 | 在 Mac 的独立窗口中呈现鸿蒙屏幕，并操作设备。 | [harmony-mirror](https://git.render.ink/trove-curios/harmony-mirror) |
|
|
|
|
可安装版本与平台以软件源中的条目为准；设备连接条件和使用方式见各工具的文档。
|