AMMDS Launcher 是 AMMDS v2 的 Windows 系统托盘启动器,用于启动、停止、重启 AMMDS 原生镜像后端,并打开 Web 管理界面。
AMMDS v2 使用 GraalVM Native Image + AWT/Java2D,ammds.exe 不再是单文件:
- 同目录需要
awt.dll、fontmanager.dll、freetype.dll、javajpeg.dll、jawt.dll、lcms.dll、mlib_image.dll、javaaccessbridge.dll、java.dll、jvm.dll、management_ext.dll; - 还需要
lib/fontconfig.bfc(启动器/服务会把java.home指向 exe 目录)。
这些运行库与构建所用 GraalVM/JDK 版本绑定,已固定在 runtime 目录随仓库分发;
安装器和 zip 包会把它们与 ammds.exe 一起放置。
launcher.go 托盘程序(Go / systray)
runtime/ v2 Windows 原生运行库与 lib/fontconfig.bfc
Languages/ Inno Setup 语言文件(简中/繁中/英/日/韩)
installer.iss Inno Setup 安装脚本
build.ps1 本地构建与打包脚本
.github/workflows/ 发布构建(下载 v2 核心 + 构建安装包)
- Go 1.25+
- MinGW-w64 或 TDM-GCC(systray 的 CGO 依赖),
go env CGO_ENABLED应为1 - Inno Setup 6 / 7(仅生成安装包需要)
- AMMDS v2 的
ammds.exe(从 AMMDS release 下载,或从本机构建产物target\ammds.exe获取)
# ammds.exe 放在仓库根目录时
.\build.ps1 -Version 2.0.0
# 指定核心路径
.\build.ps1 -Version 2.0.0 -CoreExe "C:\path\to\ammds.exe"
# 只构建启动器,不生成安装包
.\build.ps1 -NoInstaller
# 复用已构建的启动器,只重新打包
.\build.ps1 -NoBuild脚本会:
- 构建
dist\AMMDS-Launcher.exe(Go + goversioninfo 资源); - 复制
ammds.exe; - 从
runtime\复制全部 DLL 与lib\fontconfig.bfc到dist\; - 调用 Inno Setup 生成
dist\ammds-setup.exe。
dist 中最终应包含:
AMMDS-Launcher.exe
ammds.exe
*.dll
lib\fontconfig.bfc
icon.ico / logo.ico
ammds-setup.exe
安装器支持 5 种语言(安装时自动匹配系统 UI 语言,也可手动切换):
- 简体中文
chs - 繁体中文
cht - English
en - 日本語
ja - 한국어
ko
可选任务:
- 删除数据目录:勾选后,在复制安装文件之前先结束 Launcher/ammds 进程,并删除
%LOCALAPPDATA%\AMMDS(以及{app}\data、{app}\db、{app}\logs兜底)。 v1 与 v2 数据结构不兼容,升级建议勾选;删除后不可恢复。 - 创建桌面图标
- 创建开始菜单项
安装器以管理员权限写入 {autopf}\ammds,并确保 ammds.exe、DLL 与
lib\fontconfig.bfc 的相对布局正确。
Launcher 以 %LOCALAPPDATA%\AMMDS 作为工作目录启动 ammds.exe,v2 的
data、db、logs 均位于该目录下。托盘菜单「打开目录」可直接打开。
安装后的卸载程序为 AMMDS-Uninstall.exe(不再是 unins000.exe),控制面板
「应用和功能」中的卸载入口也已指向它。
- 交互式卸载会询问:是否同时删除 AMMDS 数据目录;选择「是」会删除
%LOCALAPPDATA%\AMMDS与安装目录下的data/db/logs,不可恢复; - 静默卸载默认保留数据;如需删除:
AMMDS-Uninstall.exe /VERYSILENT /SUPPRESSMSGBOXES /DELETEUSERDATA卸载收尾阶段会再次清理 %LOCALAPPDATA%\AMMDS,避免 AMMDS-Launcher --uninstall
重新创建 logs 目录后残留。
- 安装后运行
AMMDS-Launcher.exe; - 程序在系统托盘运行,自动选择端口并启动后端(优先 80,其次复用上次端口/随机端口);
- 托盘菜单提供启动/停止/重启、打开面板、打开数据目录、开机自启、官网/帮助/退出。
首次启动会打开 Web 初始化页面;v2 不再使用默认管理员环境变量,按页面创建管理员即可。
发布 vX.Y.Z 后,工作流会:
- 从 AMMDS v2 release 下载核心包(默认尝试
AMMDS仓库的ammds.zip/ammds-windows.zip/ammds-windows-amd64.zip,再回退旧仓库); - 用
runtime/中的固定运行库构建启动器与安装包; - 上传
ammds-setup.exe与ammds.zip(zip 内包含 DLL 与lib/fontconfig.bfc)。
若核心包地址不同,在仓库变量中设置:
AMMDS_CORE_ZIP_URL = https://.../ammds.zip
AMMDS 切换 GraalVM/JDK 版本后:
- 从 AMMDS 构建产物
target\复制新的 DLL,从target\lib\复制fontconfig.bfc; - 整体替换 runtime;
- 重新执行
build.ps1生成安装包。
- 封面不可用:确认
{app}下 DLL 与lib\fontconfig.bfc存在(安装包应已包含); - 服务无法启动:查看
%LOCALAPPDATA%\AMMDS\logs\launcher.log,并确认{app}\ammds.exe存在; - 端口冲突:设置
AMMDS_SERVER_PORT环境变量后重启 Launcher; - 升级后数据异常:卸载/重装时勾选「删除数据目录」,v1/v2 数据不要混用。
本项目由 新疆萌森软件开发工作室 开发,遵循 MIT 许可证。