Nền tảng được hỗ trợ

Kiểm tra các phiên bản macOS, device và nền tảng mà Astra Scout hỗ trợ.

Máy Mac nào chạy Astra Scout, và Astra Scout test được trên những device nào.

Máy Mac (host)

Astra Scout chạy trên macOS 14 trở lên, Apple silicon hoặc Intel. Link tải ở Cài đặt là bản Apple silicon. Cần Xcode cho iOS Simulator và iOS device. Xcode cũng ký app điều khiển iOS device, để iOS device chấp nhận app.

Device đích

Đích	Hỗ trợ	Ghi chú
iOS Simulator	Có	Cần Xcode và một runtime iOS (tải trong Xcode).
iOS device	Có	Cần Apple ID đã đăng nhập Xcode để ký WebDriverAgent (xem bên dưới).
Emulator Android	Có	Cần Android Studio SDK và một AVD (điện thoại ảo tạo trong Android Studio).
Device Android device	Có	Cần bật USB debugging trên điện thoại và cho phép máy Mac.
Trình duyệt web	Không	Không được hỗ trợ.
Host Windows hoặc Linux	Không	App nhắm tới macOS.

Muốn biết máy Mac đã sẵn sàng cho đích nào, mở Help → Kiểm tra thiết lập….

Chi tiết về iOS

• Flow điều khiển iOS device và simulator qua WebDriverAgent (WDA), một app nhỏ chạy trong device để nhận lệnh. Với iOS device, WDA phải được ký bằng team Apple Development thì iOS device mới cho chạy. Xem Device.
• iOS device được chiếu lên màn hình Mac qua luồng video của Apple (CoreDevice), bằng cáp hoặc Wi-Fi.
• Với Xcode 27 và iOS device chạy iOS 27, thao tác chạm và kéo trên mirror đến iOS device gần như tức thì. Không có hai điều kiện này, cử chỉ được phát lại sau khi nhả chuột.
• clearState, lệnh xoá dữ liệu app, gỡ app rồi cài lại. Trên iOS device, lệnh này cài lại bản build đang dùng từ Builds của team. Xem Device.

Chi tiết về Android

• Flow chạy qua driver DeviceLab của maestro-runner, nên evalWebViewScript và runWebViewScript dùng được trên Android.
• Android SDK, trong đó có adb, được tìm theo thứ tự: đường dẫn trong Cài đặt → Android, rồi biến môi trường ANDROID_HOME, rồi ANDROID_SDK_ROOT, rồi ~/Library/Android/sdk.

Để kiểm tra hoặc đổi SDK:

1. Mở Astra Scout → Cài đặt… và chọn Android.
2. Xem Đường dẫn và Trạng thái. Trạng thái cho biết SDK được tìm thấy ở đâu, ví dụ Đã phát hiện (ANDROID_HOME), Đặt trong Cài đặt hoặc Không tìm thấy.
3. Muốn dùng SDK khác, bấm Chọn thư mục… hoặc gõ đường dẫn vào Đường dẫn tuỳ chỉnh. Đường dẫn hợp lệ hiện Đường dẫn hợp lệ.
4. Bấm Kiểm tra lại sau khi cài SDK trong lúc Cài đặt đang mở.

Các lệnh phụ thuộc nền tảng

Không phải lệnh nào cũng chạy được trên mọi nền tảng. Astra Scout chỉ chấp nhận các lệnh chạy được trên nền tảng của device đang kết nối, cộng với ba lệnh AI (assertWithAI, assertNoDefectsWithAI, extractTextWithAI). Các lệnh không chạy được trên device đang kết nối, như travel trên iOS hoặc acceptAlert trên Android, sẽ bị:

• gạch ngang trong gợi ý của editor,
• dấu error trong file,
• error do các tool MCP validate_flow và save_flow.

Nếu chưa kết nối device, lệnh chỉ thiếu trên một nền tảng sẽ hiện dưới dạng warning. Các lệnh nằm trong khối chỉ chạy trên nền tảng kia thì không bị đánh dấu, ví dụ runFlow với when: platform: iOS.

Chi tiết kỹ thuật

• Trên iOS Simulator, thao tác chạm và vuốt từ flow và từ mirror đi qua tool devicehid, dự phòng bằng WDA. Cây phần tử của simulator được đọc qua xcuiax trên simulator iOS 27+; bản cũ hơn dùng WDA.
• Màn hình iOS Simulator được app tự render qua SimulatorKit của Xcode.
• Với Xcode 27 và iOS device chạy iOS 27, devicehid gửi chạm và kéo thẳng tới iOS device.
• Màn hình Android được mirror bằng stream H.264 của scrcpy, dự phòng bằng vòng lặp chụp màn hình.