Appearance
适用条件与安装
了解支持的设备及如何安装 AstroBox
欢迎从此开始下载与使用 AstroBox！在开始之前，你可以直接「点击选择」你的设备，快速查看向导。
| 设备 | 描述 |
|---|---|
| Android 设备 | 如小米手机、红米手机、vivo手机、oppo手机等。 |
| iOS/iPad OS 设备 | |
| Mac 电脑 | |
| Windows 电脑 | |
| Linux 电脑 |
Android 设备
1. 下载安装包并安装
请注意：安装 V2 前先卸载 V1，否则会带来一些问题。
你可以前往官网下载安装包，或者直接下载 Android 版安装包。若你设备比较老旧，或者后续使用中遇到闪退，建议优先选择带 WebView 的版本。
下载完成后寻找到你的安装包下载位置并点击安装。一般它就在你手机文件管理器中的 Download（下载）文件夹或该文件夹下的浏览器子文件夹（如 Via 就在 Download/Via 下，夸克就在 Download/QuarkDownloads 下）。
2. 首次打开及权限配置
首次打开应用会要求你给与一些权限，这些权限都是要完整给到的，否则连接过程就会出问题。
首先是位置权限，记住同时要给精确位置权限。我们不会采集你的位置信息，这是安卓蓝牙连接所要求的。
其次蓝牙权限也要始终允许，以便 AstroBox 能够连接到你的穿戴设备
同时我也建议你手动检查并打开附近设备权限。一般你可以长按桌面上的 AstroBox 应用，点击详情按钮，选择「权限管理」，然后找到并打开「附近设备」权限。
接下来只需要正常完成 OOBE 流程就可以使用 AstroBox 了。
iOS / iPadOS 设备
请注意：安装 V2 前先卸载 V1，否则会带来一些问题。
为了保证您能拥有良好的使用体验，不同于其它平台，您有以下特殊事项需要注意：
由于软件本身的性质以及我们对私有 API 的使用，AstroBox 将永远不可能上架苹果官方的 App Store，因此要在 iOS 设备上安装 AstroBox，您必须有一台电脑。如果您已配置好 SideStore / AltStore / LiveContainer / TrollStore 等本地侧载环境，则可以直接下载 ipa 并进行安装；如果并没有，可以参考这篇文章（需挂工具访问）或是下方教程进行配置，然后再安装。
需要注意的是，iOS 版最低要求系统版本必须在 16.5 以上，想要得到更好的体验需要在 17.0 以上。
使用电脑直接为 iOS 设备安装 AstroBox
“本方法的优点是十分简单，但坏处是每次更新都要使用电脑。”
准备工作：
首先，你需要准备以下内容才能按照本教程在 iOS 设备上安装 AstroBox：
- iOS 设备
- 电脑
前置内容安装
Mac
对于 Mac 用户，你需要在 SideStore 官网 下载以下内容：
对于 Mac 用户，你需要在 AltStore 或 SideStore 官网 下载 AltServer。接着解压 altserver.zip，将解压的 AltServer.app 文件拖放到"应用程序"文件夹中。 至此安装过程完成。
Windows
对于 Windows 用户，你需要在 AltStore 或 SideStore 官网 下载 AltServer。解压 altserver.zip，然后运行 setup.exe 来安装 AltServer。Windows 用户相比 Mac 用户需要额外安装非微软应用商店版本的 iTunes 和 iCloud。如果已安装微软应用商店版本，请卸载。 至此，安装过程完成。
通过 AltServer 安装 AstroBox
首先，你需要通过数据线连接 iOS 设备与你的电脑，并在设备上信任你的电脑。
接下来，请你通过官网下载 AstroBox 的 ipa 文件，或是直接点击下方按钮前往下载。
然后，请你启动 AltServer（首次启动时请在"应用程序"文件夹中右键打开），按住 Option 键，点击顶部菜单栏中的 AltServer 图标，然后选择AstroBox.ipa
接下来请按照提示流程，输入 AppleID 与密码，等待 AstroBox 安装完成，iOS 设备上会出现 AstroBox 图标。
接着进入 设置 > 通用 > VPN 与设备管理 > 选择开发者 APP 选项 > 点击信任
接着前往 设置 > 隐私与安全性 > 开发者模式，开启开发者模式并重启。
需要注意的是：此安装方式仅在七天内有效，超过七天后应用过期，需要重新安装。
使用电脑在 iOS 设备上建立本地侧载环境后安装 AstroBox
“本方式的优点是可以在 iOS 设备上本地安装 ipa 应用，而不需要每次都使用电脑安装”
接下来，我们将以 SideStore 为例进行演示。
准备工作
首先，你需要准备以下内容才能按照本教程在 iOS 设备上安装 AstroBox：
- 美区 AppleID（其他非国区区域或许也可以）
- iOS 设备
- 电脑
前置内容安装
Mac
对于 Mac 用户，你需要在 SideStore 官网 下载以下内容：
- AltServer
- SideStore IPA
- idevice pair
接着打开 altserver.zip，将解压的 AltServer.app 文件拖放到"应用程序"文件夹中。 然后打开 iDevicePair--macos-universal.dmg，把文件拖放到"应用程序"文件夹中。 至此安装过程完成。
Windows
对于 Windows 用户，你需要在 SideStore 官网 下载以下内容：
- AltServer
- SideStore IPA
- idevice pair
解压 altinstaller.zip，然后运行 setup.exe 来安装 AltServer。Windows 用户相比 Mac 用户需要额外安装非微软应用商店版本的 iTunes 和 iCloud。如果已安装微软应用商店版本，请卸载。 接着运行 iDevicePair--windows-x86_64.exe，完成安装步骤。 至此，安装过程完成。
为设备安装 SideStore
首先，你需要通过数据线连接 iOS 设备与你的电脑，并在设备上信任你的电脑。
接下来，请你启动 AltServer（首次启动时请在"应用程序"文件夹中右键打开），按住 Option 键，点击顶部菜单栏中的 AltServer 图标，然后选择 Sideload .ipa...
选择下载好的 SideStore.ipa 文件。
接下来请按照提示流程，输入 Apple ID 与密码，等待 SideStore 安装完成。
接着进入 设置 > 通用 > VPN 与设备管理 > 选择开发者 APP 下选项 > 点击信任
推送配对文件
首先确定你的 iOS 设备有设置密码（即锁屏密码），在通过数据线连接 iOS 设备与你的电脑的条件下，将 iOS 设备返回主屏幕，然后打开前面的 iDevicePair 软件（首次启动时请在"应用程序"文件夹中右键打开）。
接着在软件里选择设备 > 点击 Generate。
等待下方内容刷新后，在 SideStore 选项卡里点击 Install，等待出现 Success 选项。
本步骤完成。
需要注意的是：如果你更新或重置设备，你的配对文件将失效，你将要重新完成此步骤。
安装 LocalDevVPN
接下来请你登录国区以外的 Apple ID（比如美区），在 AppStore 里下载安装 LocalDevVPN。
接下来请打开应用，点击连接。每当你希望使用 SideStore 安装、更新或刷新 AstroBox 时，都必须启用此 VPN，建议持续在后台开启。
刷新应用并安装
接下来请你打开 SideStore 应用，进入 My Apps 选项卡，点击应用后的 "X Days" 按钮，登录你的苹果账号。随后点击刷新。
在弹出的选项里选择第一个，即可配置好刷新。最后点击左上角加号，选择 AstroBox.ipa 文件即可安装。
至此，你就成功安装好 AstroBox 了！当然还有很多其他方法可以安装，也欢迎你问问小伙伴尝试尝试。接下来只需要正常完成 OOBE 流程就可以使用 AstroBox 了。
Mac 电脑
下载安装包
你可以前往官网下载 AstroBox 安装包，或是直接点击下方按钮前往下载。
下载前请确定与你的设备是否一致，我们提供了 ARM 设备的版本和 x86 设备的版本。属于 M 系列或 A 系列，那么请选择下载 ARM 设备的版本；如果不是，请下载 x86 版本。
安装 AstroBox
请注意：安装 V2 前先卸载 V1，否则会带来一些问题。
双击打开 dmg 文件，按住 AstroBox 图标，将其从上往下拖动到 Applications 文件夹中。
随后按下键盘上的 Command+空格 键（空格键左边的就是 Command 按键），打开搜索窗口，输入 终端，打开系统终端应用。
在终端中输入下方指令，并在按回车后输入密码。输入密码的过程不会有任何显示，请你在输入好密码之后直接按下回车。
bash
sudo xattr -r -d com.apple.quarantine /Applications/AstroBox.app打开 AstroBox
接下来你可以打开 访达-应用程序，找到 AstroBox，首次打开时建议 右键-点击打开 开启 AstroBox。过程中应用会向你索要蓝牙等权限，请您全部点击允许。接下来只需要正常完成 OOBE 流程就可以使用 AstroBox 了。
Windows 电脑
安装之前
在安装之前，请你确认你的 Windows 电脑是否拥有蓝牙功能。使用 AstroBox 在 Windows 电脑上连接穿戴设备需要依赖蓝牙功能。
开始安装
请注意：安装 V2 前先卸载 V1，否则会带来一些问题。
你可以前往官网下载 AstroBox 安装包，或是直接点击下方按钮前往下载。
下载完成后，只需要打开安装包，跟随安装包持续完成安装进程即可正常使用 AstroBox。接下来只需要正常打开应用完成 OOBE 流程就可以使用 AstroBox 了。
Linux 电脑
了解你的发行版
前往你的终端输入以下命令或者前往设置页面查看关于页的操作系统名称，确认自己的发行版所属系列
grep PRETTY_NAME /etc/os-release && uname -m输出例如
PRETTY_NAME="Arch Linux"
x86_64如果第二行显示的不是x86_64，那你将无法安装软件，AstroBox只提供了x86_64的Linux包。
点击查看发行版列举
- Debian 系列
- Debian
- Ubuntu
- Linux Mint
- Deepin (深度)
- Kali Linux
- RedHat (红帽) 系列
- RHEL (Red Hat Enterprise Linux)
- Fedora
- CentOS Stream
- Rocky Linux
- AlmaLinux
- SUSE 系列
- openSUSE (Leap / Tumbleweed)
- SLES (SUSE Linux Enterprise Server)
- Arch 系列
- Arch Linux
- Manjaro
- EndeavourOS
- 其他系列
- Gentoo
- Alpine Linux
- NixOS
- Slackware
- Void Linux
选择正确的包
我们提供..deb、.rpm、.pkg.tar.zst，并因上游依赖问题暂时无法提供.AppImage。
你可以前往官网下载 AstroBox 安装包，或是直接点击下方按钮前往下载。
- 对于Debian系列，你可以使用
.deb包。 - 对于RedHat系列以及SUSE系列，你可以使用
.rpm包。 - 对于Arch系列，你可以使用
.pkg.tar.zst安装，或者移步到下一步使用更推荐，更简单的AUR来源安装。
安装 AstroBox
请注意：安装 V2 前先卸载 V1，否则会带来一些问题。
Debian 系列
下载后前往终端安装：
sudo apt update # 更新软件源
sudo apt install ./AstroBoxNG_2.0.0.debRedHat 系列
sudo dnf makecache # 更新软件源
sudo dnf install ./AstroBoxNG_2.0.0.rpmSUSE 系列
兼容openSUSE Leap（稳定版）和 Tumbleweed（滚动版）
sudo zypper refresh # 更新软件源
sudo zypper install ./AstroBoxNG_2.0.0.rpmArch 系列
通过 AUR 安装（推荐） 更简单地通过 AUR 安装，在终端运行以下命令：
如未安装 AUR helper，请参考 AUR 助手安装指南安装。
yay -S astrobox-ng或者使用 paru：
paru -S astrobox-ng从安装包安装
sudo pacman -Sy # 同步数据库
sudo pacman -U ./AstroBoxNG_2.0.0.pkg.tar.zst启动 AstroBox
打开应用菜单(Application Launcher) ，AstroBox在此显示，点击打开，也可以右键选择让其固定在Dock（程序坞）或者Panel（面板/任务栏）里。
你也可以同样使用命令行启动。
astrobox-ng接下来只需要正常打开应用完成 OOBE 流程就可以使用 AstroBox 了。
猫饼干
Roi Feng
IKUN-CXKPRO