Skip to content

Latest commit

 

History

History
147 lines (98 loc) · 5.63 KB

新手上路.md

File metadata and controls

147 lines (98 loc) · 5.63 KB

新手上路

前置准备

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需要在运行前安装运行库。

M9A 需要 VCRedist x64 (cli与gui都需要) 和 .NET 8 (仅使用gui时需要)。 点击 vc_redist.x64 下载安装 VCRedist x64，点击 dotnet-sdk-8.0.5-win-x64.exe 下载安装.NET 8。 也可以右键开始按钮打开终端，在终端内粘贴以下命令回车以进行安装。

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

其他系统

环境依赖

Python: 版本 ≥ 3.10

依赖管理

运行环境必须满足 requirements.txt 文件中所有必要的依赖包及其版本。

3. 下载正确的版本

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

Windows

  • 对于绝大部分用户，请下载 M9A-win-x86_64-vXXX.zip
  • 若确定自己的电脑是 arm 架构，请下载 M9A-win-aarch64-vXXX.zip
  • arm 架构目前已不支持

Warning

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

  • 解压后运行 MaaPiCli.exe（命令行）或 MFAWPF.exe（图形化界面）即可

macOS

  • 查看处理器类型（重要：一定要选择正确版本才能正确运行）：

    1. 点击屏幕左上角的苹果标志。
    2. 选择“关于本机”。
    3. 在弹出的窗口中，你可以看到处理器的信息。

  • 若使用 Intel X86 处理器，请下载 M9A-macos-x86_64-vXXX.zip

  • 若使用 Apple Silicon 系列如： M1, M2 等 ARM 架构处理器，请下载 M9A-macos-aarch64-vXXX.zip

  • 使用方式：

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

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

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

      cd usr/local/bin/M9A
# 如果手动在解压好的软件根目录打开终端，可以免除执行上面这一行
sudo chmod 777 MaaPiCli
sudo ./MaaPiCli

Linux

同macOS，下载对应版本的压缩包，添加权限后运行 MaaPiCli 即可。

Android

一般人用不到 使用方法，参考开发流程自行安装。

4. 正确解压

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

Caution

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

5. 确认模拟器支持

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

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

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

初始配置

  1. 若需要使用自动检测，则运行一个模拟器，并确保没有其他安卓设备连接电脑。
  2. 跟随设置指引进行配置，M9A 会自动检测正在运行的模拟器。
  3. 添加任务
  4. 运行任务

进阶使用

  • 添加 -d 参数可跳过交互直接运行任务，如 ./MaaPiCli.exe -d
  • 2.0 版本已支持 mumu 后台保活，会在 run task 时获取 mumu 最前台的 tab，并始终使用这个 tab（即使之后被切到后台了）

相关文档