
DINHDANH Creator · Bài X10 · Xử lý sự cố
/ gói miễn phí · BETA
Export APK là tính năng BETA và tốn tài nguyên nặng. Gói miễn phí có thể chặn hẳn; build fail cần đơn giản hóa app hoặc kiểm Hồ sơ dự án (Tên App).
Mục tiêu: Đọc đúng từng thông báo UI; chọn phương án thay (PWA, Android Mock); biết khi nào cần nâng gói.
Trước: T09, E04, H03, K11 · Sau: X11
UI: Export · Build APK · Đang build APK... · Build thất bại · Hồ sơ dự án · Tên App · Android Mock
1. Đọc đúng thông báo UI
| Thông báo | Nghĩa | Hành động |
|---|---|---|
| Đang build APK... | Job đang chạy trên server | Chờ; không spam Export liên tục |
| Build thất bại | Pipeline lỗi (cấu hình, kích thước, tên app…) | Xem log nếu có; đơn giản hóa; thử mẫu Capacitor nhỏ |
| Tác vụ nặng không khả dụng trên gói miễn phí. Vui lòng nâng cấp. | Plan không cho build APK | Nâng gói hoặc bỏ APK - dùng PWA / link web |
| Không tìm thấy preview | Chưa có bản preview hợp lệ | Mở tab Xem và sửa → Lưu thay đổi trước |
BETA: APK không cam kết qua Google Play review - chỉ file cài thử nội bộ. Không hứa khách “app trên Store” từ một nút Export.
2. Sơ đồ phương án thay

3. Capacitor vs Kotlin - chọn mẫu đúng
| Mẫu | Phù hợp | Rủi ro build |
|---|---|---|
| Capacitor (WebView) | Site HTML/CSS/JS đã có; biolink; landing | Thấp hơn - bọc web sẵn |
| Kotlin native samples | Demo native phức tạp; plugin Android | Cao - dễ fail nếu stack lệch BETA |
- Mở Hồ sơ dự án → điền Tên App (hiển thị trên launcher; tránh ký tự lạ / để trống).
- Giảm asset nặng (video 4K, thư viện CDN dư) - tab Thư viện tắt bớt.
- Tab Phiên bản → Clone → thử build trên bản đơn giản.
- Export APK một lần → đợi Đang build APK... hết → tải file nếu thành công.
4. So sánh · Giới hạn
- Expo EAS Build: cũng queue + plan - “Tác vụ nặng…” tương tự giới hạn gói.
- Flutter release: cần keystore + review - DINHDANH BETA chưa thay quy trình Store.
Làm được: APK sideload nội bộ (plan + build OK). Không: đảm bảo Play Store; build song song nhiều job; APK trên gói miễn phí nếu UI chặn.
5. Sự cố · Lời khuyên
| Tình huống | Xử lý |
|---|---|
| Spam Export → nhiều job fail | Chờ 1 job; Clone nếu state lỗi |
| Kotlin sample fail liên tục | Chuyển mẫu Capacitor; site web-first |
| Khách cần “app Store” | Giải thích BETA + quy trình Store riêng (E04) |
6. Checklist
- Bạn đã đọc đúng “Tác vụ nặng…” vs “Build thất bại”?
- Tên App trong Hồ sơ dự án đã điền?
- Bạn có phương án PWA / Android Mock nếu APK không khả dụng?
Tiếp: X11 - CMS không login
Điều hướng nội bộ (cùng ngôn ngữ)