Truong Trinh Duc

Posted on Mar 20

Hot Update — QA Guide

#mobile #productivity #testing #tutorial

Tài liệu này dành cho QA.
Mục tiêu: biết chính xác cần làm gì để test một task mà không cần cài lại app hay chờ build.

Tại sao có Hot Update?

Trước đây, mỗi lần dev xong một task, QA phải đợi dev build lại app — mất 15–30 phút — rồi mới có app để test. Nếu có bug fix thì lại đợi thêm một lần nữa.

Với Hot Update, dev có thể đẩy thay đổi lên trong 1–2 phút. App staging bạn đang có trên tay sẽ tự tải về và reload — không cần cài lại, không cần chờ, không cần làm gì thêm.

Một app staging dùng được cho tất cả các task. Muốn test task nào, nhập tên task vào là xong.

Trước khi bắt đầu

Yêu cầu duy nhất: Thiết bị của bạn đã cài sẵn bản Staging app (bản phân phối qua TestFlight, .ipa qua tool build hoặc file APK).

Cách switch sang task cần test

Bước 1 — Mở Task Switcher

Mở Staging App lên. Bạn sẽ thấy icon 🔥 ở góc dưới bên phải màn hình.

Tap vào icon đó để mở modal Task Switcher.

Bước 2 — Nhập tên task và Switch

Trong ô input, nhập đúng Task ID mà dev đã thông báo.

Ví dụ: V567APP-199

Tap nút 🚀 Switch task.

App sẽ tự động:

Kết nối Cloudflare và tải JavaScript bundle của task đó về
Reload để chạy đúng code của task

Quá trình này mất khoảng vài giây.

Bước 3 — Test task

Sau khi reload, bạn đang chạy đúng code của V567APP-199.

Bạn có thể kiểm tra channel hiện tại bằng cách mở lại 🔥 — channel đang active sẽ được hiển thị ở đầu modal.

Bước 4 — Khi test xong, reset về default

Bắt buộc: Trước khi chuyển sang test task khác, bạn phải reset về channel mặc định trước.

Mở lại Task Switcher 🔥 → tap nút 🔄 Reset.

App sẽ reload về channel stg (channel staging chính).

Sau đó bạn có thể nhập task mới và Switch tiếp.

❌ Không switch trực tiếp từ task này sang task khác (ví dụ từ V567APP-199 thẳng sang V567APP-200). Luôn Reset về stg trước, sau đó mới Switch sang task mới.

Flow

Mở app (đang ở channel stg)
        │
        ▼
   Tap 🔥 → Nhập V567APP-199 → Switch
        │
        ▼
   App reload → Test task V567APP-199
        │
        ▼
   Test xong → Tap 🔥 → Reset → App về stg
        │
        ▼
   Tap 🔥 → Nhập V567APP-200 → Switch
        │
        ▼
   App reload → Test task V567APP-200

Các thông báo lỗi có thể gặp

Thông báo	Nghĩa là	Cần làm gì
"Bundle Not Found"	Task chưa được deploy lên channel	Liên hệ dev để deploy (`yarn hot:task:ios/android <TASK_ID>`)
"Failed to install bundle"	Lỗi khi tải bundle về	Kiểm tra kết nối mạng và thử lại
"Something went wrong"	Lỗi không xác định	Báo lại với dev kèm thông báo lỗi cụ thể

Những điều cần biết

Không cần cài lại app để test các task khác nhau — chỉ cần switch channel.
Dev có thể update code trong khi bạn đang test. Nếu dev báo đã fix bug, chỉ cần đóng app hoàn toàn rồi mở lại — app sẽ tự tải code mới nhất về, không cần làm gì thêm.
Tính năng này chỉ có trên bản Staging. Bản Production không có icon 🔥 và không bị ảnh hưởng bởi bất kỳ thao tác nào ở trên.
Một số task không hỗ trợ hot update — nếu task có thay đổi native code, dev sẽ thông báo riêng và bạn cần bản build native mới.

DEV Community