Cài đặt

Tải Astra Scout, cài đặt và thêm các công cụ mà device của bạn cần.

Ba bước: cài Astra Scout, cài công cụ cho loại device bạn test, rồi để app tự kiểm tra thiết lập.

Bạn cần gì

Muốn test trên	Cài	Tải ở đâu
Mọi thứ	Astra Scout (Mac chip Apple silicon, macOS 14 trở lên)	Tải Astra Scout
iOS Simulator hoặc iPhone thật	Xcode (khoảng 30 GB kèm simulator)	Xcode trên Mac App Store
Emulator hoặc điện thoại Android	Android Studio	developer.android.com/studio
Tính năng AI (không bắt buộc)	Một AI CLI: Claude Code, OpenAI Codex hoặc Gemini CLI	Xem Cài AI CLI

Xem loại chip ở → About This Mac: "Apple M1" trở lên là Apple silicon. Với Mac Intel, xin team bản build x64.

1. Cài Astra Scout

1. Tải Astra Scout.
2. Mở file .dmg vừa tải, kéo Astra Scout thả vào Applications. Eject DMG.
3. Mở Applications → Astra Scout. macOS hỏi có muốn mở app tải từ Internet không: bấm Open.

Astra Scout được Astraler ký và Apple kiểm tra, nên mở được ngay, không cần bước nào thêm. Nếu macOS báo app "cannot be opened" hoặc "is damaged", bản bạn có không phải tải từ link ở trên: hãy tải lại.

2. Cài công cụ cho device

Chỉ cài phần bạn cần.

iPhone và iOS Simulator

1. Cài Xcode từ App Store và mở một lần. Đồng ý license và cài các thành phần Xcode đề nghị.
2. Trong Xcode → Settings → Components, tải một iOS Simulator.
3. Với iPhone thật, đăng nhập Apple ID vào Xcode và bật Developer Mode trên iPhone: làm theo iPhone thật.

Android

1. Cài Android Studio và mở một lần: Android Studio sẽ tải Android SDK.
2. Tạo emulator trong Device Manager → Create Virtual Device, hoặc chuẩn bị điện thoại thật với USB debugging: làm theo Android.

Astra Scout tự tìm Xcode và Android SDK. Cài xong không cần mở lại app.

Tính năng AI (không bắt buộc)

Cài và đăng nhập một AI CLI: làm theo Cài AI CLI.

3. Kiểm tra thiết lập

Chọn Help → Kiểm tra thiết lập…. Mỗi dòng cho biết một công cụ đã sẵn sàng chưa, và nếu chưa thì sửa thế nào. App cũng chạy kiểm tra này ở nền và nhắc bạn khi thiếu mục bắt buộc.

Chọn workspace

Cửa sổ Chào mừng đến với Astra Scout yêu cầu tạo hoặc mở một workspace: một thư mục chứa các flow .yaml. Hỏi team nên mở thư mục nào, hoặc bấm Workspace mới… để bắt đầu từ thư mục trống. Xem Chạy flow.

Sau đó tiếp tục với Bắt đầu nhanh.

Cập nhật

Astra Scout tự cập nhật. Mỗi ngày một lần, app kiểm tra bản mới và cho biết có gì thay đổi. Bấm Install Update thì app mở lại với bản mới. Muốn kiểm tra ngay, chọn Astra Scout → Kiểm tra bản cập nhật…. Có thể tắt việc kiểm tra hằng ngày trong Settings → Chung.

Cần báo bug?

Đính kèm ~/Library/Logs/Astra Scout/server.log và ảnh chụp Help → Kiểm tra thiết lập….

Bước tiếp theo

• Bắt đầu nhanh
• Thiết lập device