新手上路

前置准备

1. 确认版本系统

M9A 在 Windows 下仅支持 10 和 11，旧版 Windows 请参阅常见问题中的系统问题部分。

Warning

以下内容源自 MAA，与 M9A 有差异，故仅供参考 暂不支持 PlayCover。

若您正在使用 Apple Silicon MacBook，请前往此页面 M9A 同样支持搭载 Intel 芯片的 MacBook，但更推荐使用 Mac 自带的多系统安装 Windows，并使用 Windows 版 M9A。

若您希望使用 Android 实体设备，请前往此页面。 由于此方法涉及 adb 调试且仍需与电脑连接，不推荐入门玩家使用此方法。

2. 安装运行环境

Windows

对于 Windows 用户：

  1. 必须安装 VCRedist x64：这是运行 M9A (无论是命令行版本还是图形界面版本 MFAAvalonia) 的基础需求。

  2. 如果使用图形界面 (MFAAvalonia)，则需要额外安装 .NET 8：

    • 推荐访问 .NET 官方下载页面 并下载安装适用于您系统的 .NET Desktop Runtime 8 (通常是 x64 版本)。

通过 winget 安装 (推荐): 您也可以右键 Windows 开始按钮，选择“命令提示符”或“PowerShell (管理员)”，然后在终端内粘贴以下命令并回车，以方便地同时安装 VCRedist x64 和 .NET 8 Desktop Runtime：

winget install Microsoft.VCRedist.2017.x64 Microsoft.DotNet.DesktopRuntime.8

其他系统 (Linux, macOS)

Linux

Python 版本依赖:

macOS

Python 环境: M9A 的 macOS 版本已内置嵌入式 Python 环境，您无需单独安装或配置 Python。程序将自动使用此内嵌环境，并管理其依赖。

图形用户界面 (MFAAvalonia) 额外依赖 (适用于 Linux 和 macOS)

如果您计划在 Linux 或 macOS 上使用图形用户界面 (MFAAvalonia)，则还需要安装 .NET 8 运行时。

3. 下载正确的版本

M9A 下载（更新）地址：https://github.com/MAA1999/M9A/releases

国内用户也可通过 Mirror酱 高速下载。

Windows

Warning

请注意！Windows 的电脑几乎全都是 x86_64 的，可能占 99.999%，除非你非常确定自己是 arm，否则别下这个！

macOS

使用方式：

  1. 打开终端，解压分发的压缩包，推荐解压到 usr/local/bin 中，不建议存放于 /opt 中避免权限问题。

    sudo unzip -o <下载的M9A压缩包路径> -d usr/local/bin/M9A

  2. 继续在终端中赋予UNIX可执行文件的执行权限：

    cd usr/local/bin/M9A
sudo ./MaaPiCli

  3. 若想使用图形操作页面请按第二步操作，执行 MFAAvalonia 程序。

Linux

同macOS，下载对应版本的压缩包，运行 MaaPiCli 或 MFAAvalonia 即可。

Android

对于一般用户我们并不推荐该版本，故已在发行版删除 如您非常了解手机操作，可参考使用方法，以及开发文档自行安装。

4. 正确解压

确认解压完整，并确保将 M9A 解压到一个独立的文件夹中。除关闭内建管理员批准的Administrator账号外，请勿将 MAA 解压到如 C:\、C:\Program Files\ 等需要 UAC 权限的路径。

Caution

不要在压缩软件直接打开程序！

5. 确认模拟器支持

查阅模拟器和设备支持，确认正在使用的模拟器支持情况。

6. 正确设置模拟器分辨率

模拟器分辨率应为 16:9 比例，推荐（以及最低）分辨率为 1280x720，不符合要求造成的运行报错将不会被解决。

Warning

注意修改分辨率后模拟器主页应该是横屏的（平板版），不要选成竖屏（手机版）了！

7. pip 设置

以下为 config/pip_config.json 的内容。

{
    "enable_pip_update": true,  # 是否更新 pip 本体，默认 true，推荐开启
    "enable_pip_install": true,  # 是否启用 pip 安装，默认 true，推荐开启
    "last_version": "v3.2.0",  # 完成 pip 安装时读取 interface.json 的 version ，启动时和 version 对比，不同则尝试安装
    "mirror": "https://mirrors.ustc.edu.cn/pypi/simple", # 镜像源。pip install -i 后参数，可根据个人需求填写。注意非大陆地区用户请修改值为 ""
    "backup_mirrors": [
    "https://pypi.tuna.tsinghua.edu.cn/simple",
    "https://mirrors.cloud.tencent.com/pypi/simple/",
    "https://pypi.org/simple"
   ]  ## 备用镜像源
}

相关文档