搜索

开始

Macro Automation Studio 下载与安装教程

在 64 位 Windows 或 Apple Silicon Mac 上下载并安装 Macro Automation Studio，用邮箱或 Google 登录，了解更新机制和项目文件的存放位置。

  • Windows
  • Mac
  • 模拟器
  • 云手机
  • 手机
  • Studio
入门 更新于 阅读约 7 分钟
本页目录
  1. 开始之前
  2. 下载 Macro Automation Studio
  3. 在 Windows 或 Apple Silicon Mac 上安装
  4. 登录
  5. 订阅检查
  6. 更新
  7. MAS 把你的文件放在哪里
  8. 故障排查
  9. MacroAutomationStudio is currently running
  10. Python 环境没有创建完成
  11. ADB executable not found
  12. 更新失败
  13. 下一步：在 Windows 或 Apple Silicon Mac 上添加安卓模拟器

Macro Automation Studio（MAS）是一款面向 Windows 和 Apple Silicon Mac 的桌面应用。这一页介绍 Macro Automation Studio 的下载、两个系统上的安装步骤、登录、内置的自动更新，以及 MAS 把你的文件放在哪里。

开始之前

  • Windows：一台 64 位 Windows 10 或 11 电脑，账户能够通过管理员权限提示。
  • Mac：一台 Apple Silicon Mac（M1 到 M5），系统为 macOS 12 Monterey 或更新版本。没有 Intel 版本，也没有 Linux 版本。
  • 下载页列出的内存要求：Windows 8 GB（推荐 16 GB），Mac 4 GB（推荐 8 GB）。模拟器还需要额外的内存。
  • 一个邮箱地址或 Google 账户用于登录。

下载 Macro Automation Studio

从下载页获取安装包。Windows 得到的是 MacroAutomationStudio-<version>.exe，Mac 得到的是为 Apple Silicon 构建的 DMG。

在 Windows 或 Apple Silicon Mac 上安装

  1. 运行安装包，通过管理员权限提示。
  2. 如果已经装有旧版 MAS，安装包会提议先卸载它。点击是。
  3. 如果 MAS 正在运行，安装包会提议关闭它。允许即可，或者自己关掉 MAS。
  4. 接受许可协议，选择是否需要桌面图标。
  5. 等待文件复制到 C:\MacroAutomationStudio。随后安装包会创建 Python 环境，这可能需要几分钟。
  6. 保持勾选启动选项，点击完成。

安装包还会把 adb、Tesseract OCR 和 uv 包管理器放到 C:\ProgramData\MacroAutomationStudio\3rdparty 下。安装过程中不会再下载其他内容。

  1. 打开 DMG，把 MacroAutomationStudio 拖到应用程序。
  2. 从应用程序中打开它。应用已签名并经过公证；如果 macOS 询问是否打开从互联网下载的应用，点击打开。
  3. 首次启动时，MAS 会在 ~/Library/Application Support/MacroAutomationStudio/python_venv 下创建 Python 环境。这可能需要几分钟。
  4. adb、Tesseract OCR 和 uv 都内置在应用包中。如果 MAS 提示 “ADB executable not found”，用 Homebrew 安装 adb 后重启 MAS：
bash
brew install android-platform-tools

MAS 会先在应用包内查找 adb，然后是你的 PATH，最后是 Homebrew 的目录。

登录

MAS 支持两种登录方式，两者对应同一个账户。

  1. 点击使用 Google 登录。浏览器会打开 Google 登录页。看到 “Login Successful” 后回到应用。
  2. 或者输入邮箱地址和密码，点击登录。

第一次使用 MAS？点击注册，输入邮箱和密码，然后填入 MAS 发到邮箱的一次性验证码。账户激活后即可登录。

订阅检查

登录后 MAS 会检查你的订阅权限。有免费试用或付费套餐时，每一页都能打开。没有的话，MAS 会打开订阅页并停在那里，直到你选择一个套餐。套餐列在价格页；具体机制见计费页。

更新

MAS 会自我更新；你不需要为每个版本重新下载安装包。

  1. 登录后，MAS 向版本服务器查询最新版本。
  2. 有新版本时会弹出 “New Update Available” 对话框，显示两个版本号和更新说明。
  3. 点击立即更新开始，或点击稍后继续工作。下载过程中可以点击最小化。
  4. MAS 先下载更新助手，再下载更新包，并用 SHA-256 哈希校验更新包。在 Mac 上，助手在替换应用之前还会核对代码签名是否属于 MAS 的 Apple 团队。
  5. 对话框显示 “Update Complete”。点击立即重启，或等待自动重启。

MAS 把你的文件放在哪里

项目WindowsMac
应用C:\MacroAutomationStudio/Applications/MacroAutomationStudio.app
项目C:\ProgramData\MacroAutomationStudio\projects~/Library/Application Support/MacroAutomationStudio/projects
日志C:\ProgramData\MacroAutomationStudio\logs~/Library/Application Support/MacroAutomationStudio/logs
Python 环境C:\ProgramData\MacroAutomationStudio\python_venv~/Library/Application Support/MacroAutomationStudio/python_venv

每个项目文件夹命名为 <id>_<name>，其中名称会转为小写，空格换成下划线。里面有 src/app.py，项目带参数表单时还有生成的 src/script_args.py，以及你添加的资源。项目是 git 仓库；参见 Git 项目与代码同步。

C:\ProgramData 默认是隐藏的。在资源管理器地址栏输入路径即可打开。

故障排查

MacroAutomationStudio is currently running

安装包发现 MAS 正在运行。点击是让它关闭应用，或者在 MAS 窗口中退出后重新运行安装包。

Python 环境没有创建完成

安装包会记录一条警告并照常完成；MAS 会在下次启动时重新执行配置。如果应用提示 “uv package manager not found”，请从下载页重新安装 MAS。

ADB executable not found

仅限 Mac。MAS 在应用包、你的 PATH 和 /opt/homebrew 下都没有找到 adb。运行 brew install android-platform-tools 然后重启 MAS。

更新失败

对话框会说明原因。网络错误时点击重试。提示 “Not enough disk space” 时释放磁盘空间后重试。对话框提供手动下载时，请从下载页安装新版本。

下一步：在 Windows 或 Apple Silicon Mac 上添加安卓模拟器

在设备页添加安卓模拟器、云设备或你的手机，然后按照快速开始运行第一个宏。

下一步

相关页面

开始Python 安卓模拟器自动化入门指南在 Macro Automation Studio 中开始 Python 安卓模拟器自动化：连接设备，然后运行 Marketplace 脚本、让 MAS Agent 编写，或亲手写出第一个宏。设备安卓模拟器 ADB 连接：模拟器、云手机和真机Macro Automation Studio 中的安卓模拟器 ADB 连接：它能发现的模拟器、adb 端口规则、按端口添加设备、云设备，以及你自己的手机。账户EnglishMacro Automation Studio Not Working? Errors and FixesFixes for when Macro Automation Studio is not working: sign-in, missing devices, image not found, OCR misreads, script errors, stuck cloud devices and credits.
这个页面有帮助吗？
以 Markdown 复制本页

有疑问？ 在 Discord 提问