Run your Maestro tests on real iPhones with BrowserStack

A test that passes on one Simulator tells you the flow works. It doesn't tell you how it behaves on an iPhone SE with a small screen, on iOS 15, or on an iPad. Keeping a drawer of test phones is expensive; that is what device clouds are for.

AppFlight now connects to BrowserStack App Automate, which runs Maestro flows on real devices. You keep recording on the Simulator or your own iPhone, and send the finished test to as many cloud devices as you like.

1. Connect your account

Open Settings → Cloud, paste your BrowserStack username and access key, and press Test connection. The key is stored in the macOS Keychain, never in your project files.

2. Pick devices

A BrowserStack group now sits at the bottom of the Devices column. Press ＋ and pick iPhones and iPads from iOS 15 up: an old small phone, the latest Pro and a tablet make a good spread.

3. Run

Choose your app's device version (an Ad Hoc or Development .ipa; Simulator .app files can't run on real hardware) and press Run. AppFlight packs the test into a self-contained Maestro flow, uploads it, starts every device in parallel and follows the progress. An unchanged .ipa is uploaded only once.

# what AppFlight sends for each test
name: checkout
appId: com.example.shop
---
- launchApp
- inputText: ${EMAIL}
- tapOn: "Pay"

4. Read the report

Each device gets a card with every test, its error and a video of the run. Results are saved to History with a Cloud badge, so the flaky-test detector sees them too, and the steps of the current test turn ✓ or ✗ just like a local run.

What leaves your Mac

Only the .ipa, the test YAML and the ${VARIABLES} those tests actually use. Unrelated secrets in your environment stay on your machine.

Một test chạy đạt trên một Simulator cho biết luồng đó hoạt động. Nó không cho biết app chạy thế nào trên iPhone SE màn hình nhỏ, trên iOS 15 hay trên iPad. Giữ cả ngăn kéo điện thoại để test thì tốn kém; device cloud sinh ra để giải quyết chuyện đó.

AppFlight giờ kết nối với BrowserStack App Automate, dịch vụ chạy flow Maestro trên máy thật. Bạn vẫn ghi test trên Simulator hoặc iPhone của mình, rồi gửi test đã xong lên bao nhiêu máy cloud tuỳ ý.

1. Kết nối tài khoản

Mở Cài đặt → Cloud, dán username và access key BrowserStack rồi bấm Thử kết nối. Key được lưu trong Keychain của macOS, không bao giờ nằm trong file dự án.

2. Chọn thiết bị

Cuối cột Devices giờ có nhóm BrowserStack. Bấm ＋ và chọn iPhone, iPad từ iOS 15 trở lên: một máy nhỏ đời cũ, một máy Pro mới nhất và một iPad là bộ khá đủ.

3. Chạy

Chọn bản cài cho máy thật của app (file .ipa Ad Hoc hoặc Development; file .app của Simulator không chạy được trên máy thật) rồi bấm Chạy. AppFlight đóng gói test thành flow Maestro độc lập, tải lên, khởi động mọi máy song song và theo dõi tiến trình. File .ipa không đổi chỉ tải lên một lần.

# AppFlight gửi gì cho mỗi test
name: checkout
appId: com.example.shop
---
- launchApp
- inputText: ${EMAIL}
- tapOn: "Pay"

4. Đọc báo cáo

Mỗi thiết bị có một thẻ liệt kê từng test, lỗi và video của lần chạy. Kết quả được lưu vào Lịch sử với nhãn Cloud, nên bộ phát hiện test chập chờn cũng thấy, và các bước của test hiện tại chuyển ✓ hoặc ✗ như khi chạy trên máy.

Những gì rời khỏi máy Mac

Chỉ file .ipa, YAML của test và những ${BIẾN} mà test thật sự dùng. Các bí mật khác trong môi trường vẫn ở lại máy bạn.