下载 Luotopia

Android

按 ABI 分发包，安卓机/卓易通优先选标有「推荐」的 arm64-v8a；如果老设备无法安装推荐版本再尝试安装 armeabi-v7a；如果使用安卓模拟器则使用 x86_64。下载 APK 后直接安装；如提示「未知来源」、「存在风险」，请在系统设置中允许安装并选择「忽略风险继续安装」。

Apple

iOS / iPadOS / macOS：统一通过 TestFlight 分发。打开TestFlight 加入链接即可在 iPhone、iPad 或 Apple 芯片 Mac（macOS 13.5+）上申请内测。TestFlight 构建有效期为 90 天，一般每 1~2 周发一次新版，保持应用更新即可，建议开启自动更新。

macOS 也可以直接下载 Release 中的 DMG（Apple 芯片，未签名构建）：将 Luotopia.app 拖入「应用程序」后，首次打开请右键 → 打开，或在终端执行 xattr -cr /Applications/Luotopia.app。请只对来自官网或官方 GitHub Release 的 DMG 这样做。

Linux

分架构（x64 / arm64）与文件格式发布。安装示例：

# .tar.gz
tar -xzf luotopia-*-linux-x64.tar.gz && ./luotopia/luotopia
# .AppImage
chmod +x luotopia-*-linux-x64.AppImage && ./luotopia-*-linux-x64.AppImage
# .deb
sudo apt install ./luotopia-*-linux-*.deb
# .flatpak
flatpak install --user ./luotopia-*-linux-*.flatpak

依赖较新 glibc + GTK3。

HarmonyOS

HarmonyOS NEXT 侧载困难，暂无积极维护，因此 .hap 不随每个 Release 发布。若 Release 资产中包含 luotopia-*-harmonyos-arm64-signed.hap，可按照同版本的 HARMONYOS-SIDELOAD.txt 侧载安装。

受平台能力限制，部分功能会在 HarmonyOS 上隐藏或降级。

Scoop

添加官方 bucket 后安装（x64 / arm64 自动匹配）：

scoop bucket add luotopia https://github.com/ClosedWHU/Luotopia-Dist
scoop install luotopia
scoop update luotopia   # 升级

清单基于便携 zip；也可以直接用 Release 里的 scoop-luotopia.json 单次安装。

Homebrew

添加官方 tap 后安装：

brew tap ClosedWHU/luotopia
# Linux（Linuxbrew，x64 / arm64）
brew install luotopia
# macOS（Apple 芯片，DMG cask）
brew install --cask luotopia

tap 里的 formula 与 cask 同名：brew install luotopia 永远先命中仅限 Linux 的 formula，macOS 必须带 --cask。升级用 brew upgrade luotopia（macOS 加 --cask）。

Nix

flake 提供 x86_64-linux / aarch64-linux 包：

nix profile install github:ClosedWHU/Luotopia-Dist

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 便携包。