# Macro Automation Studio 下载与安装教程

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

Source: https://automationmacro.com/zh-CN/docs/install (开始, updated 2026-09-05)

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 账户用于登录。

> [!NOTE]
> 在 Mac 上，MAS 本身原生运行于 Apple Silicon。它仍然需要一个可以驱动的目标：运行在你 Mac 上的安卓模拟器、一台云设备，或你自己的手机。参见[设备](/docs/devices)。

## 下载 Macro Automation Studio

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

## 在 Windows 或 Apple Silicon Mac 上安装

<div class="doc-tabs" data-tabs="os">
<section data-tab="Windows">

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

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

</section>
<section data-tab="Mac">

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 的目录。

</section>
</div>

## 登录

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

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

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

> [!TIP]
> 用 Google 创建的账户没有密码。如果密码登录失败并提示 "This email is registered with Google"，请使用**使用 Google 登录**。

## 订阅检查

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

## 更新

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

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

> [!NOTE]
> 非常旧的 Mac 版本会显示 "This version has no in-app update package"。请从[下载页](/download)下载当前的 DMG，覆盖安装到旧应用之上。

## MAS 把你的文件放在哪里

| 项目 | Windows | Mac |
|---|---|---|
| 应用 | `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 项目与代码同步](/docs/git-and-code-sync)。

`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" 时释放磁盘空间后重试。对话框提供**手动下载**时，请从[下载页](/download)安装新版本。

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

在[设备](/docs/devices)页添加安卓模拟器、云设备或你的手机，然后按照[快速开始](/docs/getting-started)运行第一个宏。