下载 Luotopia

Android

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

Apple

iOS / iPadOS / macOS：统一通过 TestFlight 分发。打开TestFlight 加入链接即可在 iPhone、iPad 或 Apple 芯片 Mac（macOS 13.5+）上申请内测。由于 Apple 政策限制，非越狱设备需通过 TestFlight 安装；TestFlight 构建有效期为 90 天，保持应用更新即可。

早期版本的 macOS arm64 DMG 仍可在对应历史 Release 的资产中找到，新版本不再随 Release 发布 DMG。

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）。

HarmonyOS

HarmonyOS NEXT 工程随客户端维护，但 .hap 不随每个 Release 发布。若 Release 资产中包含 luotopia-*-harmonyos-arm64-signed.hap，请按照同版本的 HARMONYOS-SIDELOAD.txt 侧载安装。

受平台能力限制，WebView 密集型校园服务会在 HarmonyOS 上隐藏或降级。

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。

AUR（Arch Linux）

预构建包会随 Release 自动更新：

yay -S luotopia-bin

AUR 包按架构下载对应的 x64 / arm64 便携归档。

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 以便官网识别。