ab-download-manager跨平台部署指南：Linux/macOS/Windows环境配置全攻略

AB Download Manager（简称ABDM）是一款开源下载管理器，通过多线程技术提升下载速度，支持跨平台部署。本文将详细介绍在Linux、macOS和Windows系统中安装、配置和卸载ABDM的完整流程，帮助用户快速上手这款高效下载工具。

项目概述

AB Download Manager的核心优势在于其现代化的UI设计、多线程下载加速和跨平台兼容性。项目采用Kotlin多平台架构开发，代码结构清晰，主要分为下载核心模块、桌面应用界面和系统集成组件。

核心功能模块：

• 下载引擎：downloader/core/src/main/kotlin/ir/amirab/downloader/DownloadManager.kt
• 桌面界面：desktop/app/src/main/kotlin/com/abdownloadmanager/desktop/ui/
• 系统集成：shared/auto-start/src/main/kotlin/ir/amirab/util/startup/

环境准备

系统要求

操作系统	最低配置要求	推荐配置
Linux	Ubuntu 20.04+/Fedora 34+，4GB RAM	Ubuntu 22.04+/Fedora 38+，8GB RAM
Windows	Windows 10 64位，4GB RAM	Windows 11 64位，8GB RAM
macOS	macOS 12+，4GB RAM	macOS 13+，8GB RAM

依赖组件

• Java环境：需安装JetBrains Runtime (JBR) 21+，推荐使用JBR with JCEF以支持UI渲染
• 系统工具：
  • Linux：curl、tar、dpkg/rpm（根据发行版选择）
  • Windows：winget或scoop包管理器
  • macOS：Homebrew（可选）

Linux系统部署

自动安装脚本（推荐）

ABDM提供了一键安装脚本，支持主流Linux发行版（Debian/Ubuntu、Fedora/CentOS等）：

bash <(curl -fsSL https://gitcode.com/gh_mirrors/ab/ab-download-manager/raw/master/scripts/install.sh)

脚本会自动完成以下操作：

1. 检查并安装依赖（curl、tar）
2. 下载最新版本的ABDM压缩包
3. 解压至~/.local/ABDownloadManager目录
4. 创建桌面快捷方式和命令行链接

安装逻辑源码：scripts/install.sh

手动安装步骤

若自动脚本失败，可按照以下步骤手动部署：

1. 克隆仓库

git clone https://gitcode.com/gh_mirrors/ab/ab-download-manager.git
cd ab-download-manager

2. 编译应用

export JAVA_HOME=~/path/to/jbr  # 设置JBR路径
./gradlew createReleaseDistributable

3. 部署应用

mkdir -p ~/.local/ABDownloadManager
cp -r desktop/app/build/compose/binaries/main-release/* ~/.local/ABDownloadManager/
ln -s ~/.local/ABDownloadManager/bin/ABDownloadManager ~/.local/bin/

4. 创建桌面快捷方式

cat > ~/.local/share/applications/abdownloadmanager.desktop << EOF
[Desktop Entry]
Name=AB Download Manager
Exec=$HOME/.local/ABDownloadManager/bin/ABDownloadManager
Icon=$HOME/.local/ABDownloadManager/lib/ABDownloadManager.png
Type=Application
Categories=Utility;Network;
EOF

Windows系统部署

Windows系统提供两种安装方式：包管理器自动安装和手动编译部署。

包管理器安装（推荐）

使用Winget：

winget install amir1376.ABDownloadManager

使用Scoop：

scoop bucket add extras
scoop install abdownloadmanager

手动安装

1. 下载安装包
   从GitHub Releases下载最新的Windows安装包（.msi或.zip格式）

2. 安装应用

• MSI安装包：双击运行并跟随向导完成安装
• ZIP压缩包：解压至C:\Program Files\ABDownloadManager，并手动创建快捷方式

3. 配置环境变量
   将安装目录下的bin文件夹路径添加至系统PATH变量，方便命令行启动。

macOS系统部署

macOS版本目前处于测试阶段，可通过以下方式部署：

手动编译步骤

1. 安装依赖

brew install git openjdk@21

2. 克隆仓库并编译

git clone https://gitcode.com/gh_mirrors/ab/ab-download-manager.git
cd ab-download-manager
export JAVA_HOME=/usr/local/opt/openjdk@21
./gradlew packageReleaseDistributionForCurrentOS

3. 安装应用

open desktop/app/build/compose/binaries/main-release/ABDownloadManager.dmg

4. 将应用拖入Applications文件夹
   按照dmg安装向导完成应用安装，之后可从启动台启动ABDM。

验证安装

安装完成后，可通过以下方式验证部署是否成功：

1. 命令行验证

ABDownloadManager --version

2. 功能验证

• 启动应用，检查界面是否正常加载
• 添加测试下载任务，验证下载功能
• 检查设置界面中的主题切换、下载路径配置等功能

配置文件位置：

• Linux：~/.abdm/config.json
• Windows：%APPDATA%\abdm\config.json
• macOS：~/Library/Application Support/abdm/config.json

卸载指南

Linux系统

自动卸载脚本：

bash <(curl -fsSL https://gitcode.com/gh_mirrors/ab/ab-download-manager/raw/master/scripts/uninstall.sh)

手动卸载：

rm -rf ~/.local/ABDownloadManager
rm ~/.local/share/applications/abdownloadmanager.desktop
rm ~/.local/bin/ABDownloadManager

Windows系统

通过控制面板卸载：

1. 打开"控制面板 > 程序 > 程序和功能"
2. 选择"AB Download Manager"并点击"卸载"

手动清理残留：

rmdir /s /q %APPDATA%\abdm
rmdir /s /q "C:\Program Files\ABDownloadManager"

macOS系统

rm -rf /Applications/ABDownloadManager.app
rm -rf ~/Library/Application Support/abdm

常见问题解决

依赖缺失问题

症状：启动时提示缺少libcef或其他依赖库
解决：安装对应系统的依赖包

• Linux：sudo apt install libcef-dev（Debian/Ubuntu）
• Fedora：sudo dnf install libcef

权限问题

症状：无法写入下载目录或配置文件
解决：检查目录权限并添加写入权限

chmod -R 755 ~/.abdm

启动失败

症状：双击图标无反应或闪退
解决：查看日志文件定位问题

• Linux：~/.abdm/logs/abdm.log
• Windows：%APPDATA%\abdm\logs\abdm.log

项目资源

• 源代码：ab-download-manager/
• 构建脚本：buildSrc/src/main/kotlin/Plugins.kt
• 桌面UI组件：desktop/app/src/main/kotlin/com/abdownloadmanager/desktop/ui/
• 贡献指南：CONTRIBUTING.md

通过本文档的指南，您可以在不同操作系统中顺利部署AB Download Manager。如有其他问题，可参考项目官方文档或提交issue反馈。