# Tải Macro Automation Studio cho Windows và Mac

> Tải và cài Macro Automation Studio trên Windows 64-bit hoặc Mac Apple Silicon, đăng nhập bằng email hoặc Google, và biết nơi lưu bản cập nhật và dự án.

Source: https://automationmacro.com/vi/docs/install (Bắt đầu, updated 2026-09-05)

Macro Automation Studio (MAS) là ứng dụng máy tính cho Windows và Mac Apple Silicon, và bạn tải Macro Automation Studio miễn phí để dùng thử. Trang này hướng dẫn tải Macro Automation Studio, chạy bộ cài trên từng hệ điều hành, đăng nhập, cơ chế cập nhật tích hợp và nơi MAS lưu tệp của bạn.

## Trước khi bắt đầu

- Windows: máy Windows 10 hoặc 11 64-bit và tài khoản có thể xác nhận lời nhắc quản trị viên.
- Mac: Mac Apple Silicon (M1 đến M5) chạy macOS 12 Monterey trở lên. Không có bản cho Intel và không có bản Linux.
- Trang tải ghi 8 GB RAM cho Windows (khuyến nghị 16 GB) và 4 GB cho Mac (khuyến nghị 8 GB). Giả lập cần thêm bộ nhớ riêng ngoài con số đó.
- Một địa chỉ email hoặc tài khoản Google để đăng nhập.

> [!NOTE]
> Trên Mac, bản thân MAS chạy native trên Apple Silicon. Nó vẫn cần thứ để điều khiển: một giả lập Android chạy trên Mac của bạn, một thiết bị cloud, hoặc điện thoại của bạn. Xem [Thiết bị](/docs/devices).

## Tải Macro Automation Studio

Lấy bộ cài từ [trang tải](/download). Windows nhận `MacroAutomationStudio-<version>.exe`. Mac nhận tệp DMG dựng cho Apple Silicon.

## Cài trên Windows hoặc Mac Apple Silicon

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

1. Chạy bộ cài và xác nhận lời nhắc quản trị viên.
2. Nếu đã có bản MAS cũ, bộ cài đề nghị gỡ bản đó trước. Nhấn **Yes**.
3. Nếu MAS đang chạy, bộ cài đề nghị đóng nó. Cho phép, hoặc tự đóng MAS.
4. Chấp nhận giấy phép và chọn có tạo biểu tượng trên màn hình nền hay không.
5. Chờ trong khi tệp được chép vào `C:\MacroAutomationStudio`. Bộ cài sau đó tạo môi trường Python, việc này có thể mất vài phút.
6. Giữ tùy chọn khởi chạy và nhấn **Finish**.

Bộ cài cũng đặt adb, Tesseract OCR và trình quản lý gói `uv` vào `C:\ProgramData\MacroAutomationStudio\3rdparty`. Không tải thêm gì khác trong lúc cài.

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

1. Mở DMG và kéo **MacroAutomationStudio** vào **Applications**.
2. Mở từ Applications. Ứng dụng đã được ký và công chứng; nếu macOS hỏi xác nhận mở ứng dụng tải từ internet, nhấn **Open**.
3. Lần chạy đầu, MAS tạo môi trường Python tại `~/Library/Application Support/MacroAutomationStudio/python_venv`. Việc này có thể mất vài phút.
4. adb, Tesseract OCR và `uv` nằm sẵn trong gói ứng dụng. Nếu MAS báo "ADB executable not found", cài adb bằng Homebrew rồi khởi động lại MAS:

```bash
brew install android-platform-tools
```

MAS tìm adb trong gói ứng dụng trước, rồi trên PATH, rồi trong các thư mục Homebrew.

</section>
</div>

## Đăng nhập

MAS hỗ trợ hai cách đăng nhập. Cả hai dẫn tới cùng một tài khoản.

1. Nhấn **Đăng nhập bằng Google**. Trình duyệt mở trang đăng nhập Google. Sau khi "Login Successful" hiện ra, quay lại ứng dụng.
2. Hoặc nhập **Địa chỉ email** và **Mật khẩu** rồi nhấn **Đăng nhập**.

Mới dùng MAS? Nhấn **Đăng ký**, nhập email và mật khẩu, rồi nhập mật khẩu dùng một lần mà MAS gửi qua email. Khi tài khoản đã kích hoạt, đăng nhập.

> [!TIP]
> Tài khoản tạo bằng Google không có mật khẩu. Nếu đăng nhập bằng mật khẩu báo "This email is registered with Google", hãy dùng **Đăng nhập bằng Google**.

## Kiểm tra gói đăng ký

Sau khi đăng nhập, MAS kiểm tra quyền truy cập của bạn. Với bản dùng thử miễn phí hoặc gói trả phí, mọi trang đều mở. Không có, MAS mở **Gói đăng ký** và giữ bạn ở đó cho đến khi bạn chọn gói. Các gói được liệt kê ở [trang giá](/pricing); cơ chế nằm ở trang [Thanh toán](/docs/billing).

## Cập nhật

MAS tự cập nhật; bạn không phải tải bộ cài mới cho mỗi bản phát hành.

1. Sau khi đăng nhập, MAS hỏi máy chủ phiên bản về bản mới nhất.
2. Khi có bản mới hơn, hộp thoại "Có bản cập nhật mới" mở ra với cả hai số phiên bản và ghi chú phát hành.
3. Nhấn **Cập nhật ngay** để bắt đầu, hoặc **Để sau** để làm việc tiếp. Trong lúc tải, bạn có thể nhấn **Thu nhỏ**.
4. MAS tải trình trợ giúp cập nhật, rồi gói cập nhật, và xác minh gói bằng mã băm SHA-256. Trên Mac, trình trợ giúp còn kiểm tra chữ ký mã với nhóm Apple của MAS trước khi thay ứng dụng.
5. Hộp thoại hiển thị "Cập nhật hoàn tất". Nhấn **Khởi động lại ngay** hoặc chờ khởi động lại tự động.

> [!NOTE]
> Các bản Mac rất cũ hiển thị "This version has no in-app update package". Tải DMG hiện tại từ [trang tải](/download) và cài đè lên ứng dụng cũ.

## Nơi MAS lưu tệp của bạn

| Mục | Windows | Mac |
|---|---|---|
| Ứng dụng | `C:\MacroAutomationStudio` | `/Applications/MacroAutomationStudio.app` |
| Dự án | `C:\ProgramData\MacroAutomationStudio\projects` | `~/Library/Application Support/MacroAutomationStudio/projects` |
| Nhật ký | `C:\ProgramData\MacroAutomationStudio\logs` | `~/Library/Application Support/MacroAutomationStudio/logs` |
| Môi trường Python | `C:\ProgramData\MacroAutomationStudio\python_venv` | `~/Library/Application Support/MacroAutomationStudio/python_venv` |

Mỗi thư mục dự án có tên `<id>_<name>`, trong đó tên được viết thường và dấu cách đổi thành gạch dưới. Bên trong có `src/app.py`, tệp `src/script_args.py` được sinh ra khi dự án có biểu mẫu tham số, và mọi tài nguyên bạn thêm vào. Dự án là kho git; xem [Dự án git và đồng bộ mã](/docs/git-and-code-sync).

`C:\ProgramData` bị ẩn theo mặc định. Gõ đường dẫn vào thanh địa chỉ của Explorer để mở.

## Khắc phục sự cố

### MacroAutomationStudio is currently running

Bộ cài phát hiện MAS đang chạy. Nhấn **Yes** để nó đóng ứng dụng, hoặc thoát MAS từ cửa sổ của nó rồi chạy lại bộ cài.

### Môi trường Python chưa hoàn tất

Bộ cài ghi cảnh báo và vẫn hoàn tất; MAS lặp lại bước thiết lập ở lần khởi chạy sau. Nếu ứng dụng báo "uv package manager not found", cài lại MAS từ trang tải.

### ADB executable not found

Chỉ trên Mac. MAS không tìm thấy adb trong gói ứng dụng, trên PATH hay trong `/opt/homebrew`. Chạy `brew install android-platform-tools` và khởi động lại MAS.

### Cập nhật thất bại

Hộp thoại nêu nguyên nhân. Với lỗi mạng, nhấn **Thử lại**. Với "Not enough disk space", giải phóng dung lượng rồi thử lại. Khi hộp thoại đưa ra **Tải thủ công**, cài bản mới từ [trang tải](/download).

## Tiếp theo: thêm giả lập Android trên Windows hoặc Mac Apple Silicon

Thêm giả lập Android, thiết bị cloud hoặc điện thoại của bạn ở trang [Thiết bị](/docs/devices), rồi chạy macro đầu tiên với [Bắt đầu](/docs/getting-started).