下载 Luotopia

Android

按 ABI 分发包（与 build-release.bat --split-per-abi 一致）：优先选标有「推荐」的 arm64-v8a（近年金属机）；老设备用 armeabi-v7a。下载 APK 后直接安装；如提示「未知来源」，请在系统设置中允许安装。

iOS

iOS 版本通过 TestFlight 分发。打开TestFlight 加入链接即可申请内测。由于 Apple 政策限制，非越狱设备需通过 TestFlight 安装。

Windows

Release 提供 x64 便携 zip（解压运行 luotopia.exe）与 MSIX。多数 PC 选标有「推荐」的 x64 / amd64。需 Windows 10 1809 及以上。未签名包可能触发 SmartScreen，选「仍要运行」；MSIX 无签时需开启开发人员模式或允许旁加载。

macOS

下载 Release 中的 DMG，打开后将 Luotopia.app 拖入「应用程序」文件夹。需要 macOS 13.5 或更高版本；如果系统首次运行时拦截，请先在 Finder 中右键应用并选择「打开」。

如果系统提示「应用已损坏」「无法验证开发者」，或应用仍然无法打开，请先确认 DMG 来自 Luotopia 官网或 ClosedWHU 官方 GitHub Release，然后在「终端」中运行：

xattr -cr /Applications/Luotopia.app

该命令只清除 Luotopia.app 的下载隔离扩展属性。不要对来源不明的应用执行此命令。

Linux

每个 Release 按架构（x64 / arm64）与格式发布（均为 --release，无 debug 符号）：

• tar.gz — 便携目录，推荐通用；标「推荐」的多为 x64/amd64
• AppImage — 单文件运行（需 FUSE 或直接可执行）
• deb — Debian/Ubuntu：sudo apt install ./luotopia-*-linux-*.deb
• flatpak — 本地 bundle（若 CI 成功生成）：flatpak install --user ./luotopia-*-linux-*.flatpak

tar -xzf luotopia-*-linux-x64.tar.gz && ./luotopia/luotopia
# 或
chmod +x luotopia-*-linux-x64.AppImage && ./luotopia-*-linux-x64.AppImage

依赖较新 glibc + GTK3。arm64 在 GitHub ARM runner 上原生构建。手动重跑 CI 可选架构（x64/arm64/both）与格式（tar,appimage,deb,flatpak）。

Scoop

从对应 Release 的清单直接安装（将 <tag> 换成版本，如 v1.0.0+2）：

scoop install https://github.com/ClosedWHU/Luotopia/releases/download/<tag>/scoop-luotopia.json

清单基于便携 zip；升级可重新 install 新 tag 的 json，或自行维护 bucket。

winget

官方社区源合并前，可用 Release 里的草稿清单本地验证：

# 下载 winget-ClosedWHU.Luotopia*.yaml 后
winget install --manifest .\path\to\manifests\folder

合并到 microsoft/winget-pkgs 之后：

winget install ClosedWHU.Luotopia

当前清单默认指向 zip 便携包；有签名 MSIX 后再可改为 MSIX 安装器以改善 SmartScreen 体验。

MSIX 旁加载

下载 *-windows-x64.msix 后双击安装，或：

Add-AppxPackage .\luotopia-*-windows-x64.msix

未提供 Windows 代码签名证书时为未签名包。可选在仓库配置 WINDOWS_PFX_BASE64 / WINDOWS_PFX_PASSWORD 以在 CI 中签名。传统 WiX MSI 暂不维护。

Linux 包格式速查

# 架构：x64 或 arm64（文件名含 linux-x64 / linux-arm64）
sudo apt install ./luotopia-*-linux-x64.deb
chmod +x ./luotopia-*-linux-x64.AppImage && ./luotopia-*-linux-x64.AppImage
flatpak install --user ./luotopia-*-linux-x64.flatpak

deb 控制字段 Architecture 为 amd64/arm64；Release 文件名用 x64/arm64 以便官网识别。