桔梗下载：鸿蒙平台的Aria2下载工具

基于 Aria2 引擎，为鸿蒙生态打造的高性能下载工具

核心亮点

🚀 强大的下载引擎

桔梗下载基于业界知名的 Aria2 下载引擎开发。Aria2 是一个轻量级、多协议、开源的命令行下载工具，被全球数万用户使用。将 Aria2 集成到鸿蒙原生应用中：

• 多线程下载：将文件分成多个部分同时下载，充分利用带宽
• 断点续传：网络中断后可以从断点处继续下载，不用重新开始
• 多协议支持：HTTP、HTTPS、FTP、BT、磁力链接全支持

🎯 简洁易用的界面

桔梗下载的界面设计非常简洁直观：

三大标签页

• 下载：管理所有下载任务（正在下载/待下载/已完成）
• 文件：浏览已下载的文件，支持预览和分享
• 设置：丰富的配置选项，满足不同需求

批量下载配置

添加多个链接时，桔梗下载会：

• 自动获取文件大小（HTTP/HTTPS）
• 检测链接有效性
• 识别重名文件并提示
• 支持单独配置每个任务

对于 FTP 链接，还可以单独设置：

• 用户名和密码
• 主动/被动模式
• 是否支持断点续传

技术实现

架构设计

┌─────────────────────────────────┐
│      ArkTS UI Layer             │  用户界面
├─────────────────────────────────┤
│      Aria2Rpc (JSON-RPC)        │  RPC 通信层
├─────────────────────────────────┤
│      NAPI Bridge                │  Native 桥接
├─────────────────────────────────┤
│      Aria2c Engine (C++)        │  下载引擎
└─────────────────────────────────┘

项目结构

entry/src/main/
├── cpp/                          # Native C++ 代码
│   ├── napi_init.cpp            # NAPI 接口实现
│   └── CMakeLists.txt           # CMake 构建配置
├── ets/                          # ArkTS 代码
│   ├── pages/                   # 页面
│   │   ├── Index.ets           # 主页面
│   │   ├── AppSettings.ets     # 应用设置
│   │   ├── Aria2Settings.ets   # Aria2 设置
│   │   ├── DownloadDetailPage.ets  # 下载详情
│   │   └── AboutPage.ets       # 关于页面
│   ├── components/              # 组件
│   │   └── DownloadConfigDialog.ets  # 下载配置对话框
│   └── utils/                   # 工具类
│       ├── Aria2Rpc.ets        # RPC 通信封装
│       └── Logger.ets          # 日志工具
└── resources/                    # 资源文件
    └── rawfile/
        ├── aria2c              # Aria2c 可执行文件
        └── aria2.ca.crt        # CA 证书

实现

1. NAPI 集成：通过 NAPI 将 C++ 的 Aria2 引擎集成到鸿蒙应用中
2. JSON-RPC 通信：使用标准的 JSON-RPC 2.0 协议与 Aria2 通信
3. 响应式状态管理：使用 @Observed 装饰器实现任务状态的实时更新
4. 数据持久化：使用 Preferences API 保存配置和已完成任务

开源与社区

桔梗下载是一个开源项目，代码托管在 GitLink：

• 项目地址：https://www.gitlink.org.cn/FloraLeaf/KikyoDL
• 开源协议：GPLv2 License（整个项目受到 entry/libs/arm64-v8a/libaria2.so
  文件的感染成为 GPLv2 许可项目。但只要删除 entry/libs 里的所有二进制，项目的其余部分
  就可以作为公有领域代码使用。）
• 欢迎贡献：Issue、PR、Star 都欢迎

安装与使用

安装步骤

1. 前往 GitLink Releases 下载最新版本
2. 使用 小白调试助手 安装到鸿蒙
3. 首次安装需要开启开发者模式

快速上手

添加下载任务

1. 复制下载链接
2. 打开桔梗下载
3. 粘贴链接到输入框
4. 点击"添加"按钮
5. 确认任务信息
6. 开始下载

常见问题

Q: 下载的文件保存在哪里？

A: 默认保存在 ~/Download/com.jiegengdownload.jg/ 目录。由于鸿蒙沙盒机制，应用只能访问特定目录。

Q: 支持哪些下载协议？

A: 支持 HTTP、HTTPS、FTP、FTPS、BitTorrent、Magnet 等主流协议。

Q: 可以限制下载速度吗？

A: 可以。在设置中可以设置全局下载速度限制和单任务速度限制。

Q: BT 下载速度慢怎么办？

A: 可以尝试：

1. 更新 Tracker 列表
2. 开启 DHT、LPD、PEX
3. 增加最大连接数
4. 检查防火墙设置

Q: 可以在后台下载吗？

A: 可以。应用在后台时，Aria2 引擎会继续运行，下载不会中断。

---

相关链接

• 项目主页：https://www.gitlink.org.cn/FloraLeaf/KikyoDL
• 下载地址：https://www.gitlink.org.cn/FloraLeaf/KikyoDL/releases
• 问题反馈：https://www.gitlink.org.cn/FloraLeaf/KikyoDL/issues
• Aria2 官网：https://aria2.github.io/
• AriaNg 项目：https://github.com/mayswind/AriaNg
  

---

发布时间：2026 年 1 月
最后更新：2026 年 1 月