Phân phối app Flutter nội bộ với Firebase App Distribution

Firebase App Distribution giúp bạn phân phối ứng dụng Flutter cho testers một cách dễ dàng và nhanh chóng. Bài viết này sẽ hướng dẫn bạn setup và sử dụng.

Tại sao dùng Firebase App Distribution?

Ưu điểm:

✅ Miễn phí: Free tier đủ cho hầu hết projects
✅ Dễ dùng: Setup đơn giản, không cần App Store/Play Store
✅ Fast: Phân phối nhanh chóng
✅ Tester Management: Quản lý testers dễ dàng
✅ Crash Reports: Tích hợp với Firebase Crashlytics

Setup Firebase

1. Tạo Firebase Project

Truy cập Firebase Console
Tạo project mới
Enable App Distribution

2. Cài đặt Firebase CLI

[object Object]

[object Object]

Setup Flutter Project

1. Dependencies

[object Object]

2. Initialize Firebase

[object Object]

Phân phối Android

1. Build APK

[object Object]

2. Upload với Firebase CLI

[object Object]

3. Upload với Flutter Plugin

[object Object]

Phân phối iOS

1. Build iOS

[object Object]

2. Archive IPA

[object Object]

3. Export IPA

[object Object]

4. Upload IPA

[object Object]

Quản lý Testers

1. Tạo Tester Groups

Trong Firebase Console:

App Distribution → Testers & Groups
Create Group
Thêm testers vào group

2. Invite Testers

[object Object]

3. Add to Group

[object Object]

GitHub Actions Integration

1. Setup Workflow

[object Object]

2. Setup Secrets

Trong GitHub:

Settings → Secrets → Actions
Thêm:
- FIREBASE_SERVICE_ACCOUNT
- FIREBASE_ANDROID_APP_ID
- FIREBASE_IOS_APP_ID

Advanced Features

1. Custom Release Notes

[object Object]

2. Multiple Groups

[object Object]

3. Custom Build Number

[object Object]

Best Practices

1. Automated Distribution

✅ Nên: Tự động distribute sau khi build
❌ Không nên: Distribute thủ công mỗi lần

2. Release Notes

✅ Nên: Viết release notes rõ ràng
❌ Không nên: Bỏ qua release notes

3. Tester Management

✅ Nên: Tổ chức testers thành groups
❌ Không nên: Add testers lẻ tẻ

Troubleshooting

1. Authentication Error

[object Object]

2. App ID Not Found

[object Object]

3. Upload Failed

[object Object]

Khi nào cần công cụ phân phối nội bộ

Trước khi dùng thêm một dịch vụ, hãy xác định bạn đang ở tình huống nào. Ba tình huống dưới đây cần ba cách làm khác nhau:

Chỉ một mình bạn kiểm thử trên máy mình — cài trực tiếp bằng dây cáp, chưa cần công cụ phân phối.
Vài người trong nhóm cần bản mới mỗi ngày — cần phân phối nội bộ có quản lý phiên bản và thông báo, đây là lúc dùng Firebase App Distribution hoặc dịch vụ tương tự.
Đã ra mắt cho người dùng thật — cần phát hành theo tỷ lệ qua cửa hàng ứng dụng, xem bài build APK/AAB.

Công cụ phân phối nội bộ giải quyết một vấn đề rất cụ thể: làm sao để người kiểm thử nhận được bản mới mà không phải kết nối máy tính, không phải tự tìm đúng tệp, và biết rõ đang dùng bản nào.

Quy trình phát hành nội bộ nên có

Một quy trình đủ tốt cho nhóm nhỏ gồm năm bước:

Tăng số phiên bản trong cấu hình ứng dụng theo quy ước rõ ràng (ví dụ phần dựng tăng theo số bản thử).
Build bản phát hành cho đúng nền tảng cần kiểm thử, không dùng bản debug vì hiệu năng khác biệt.
Tải lên kênh phân phối kèm ghi chú thay đổi ngắn: đã sửa gì, cần kiểm thử gì.
Thông báo cho người kiểm thử qua nhóm chat, kèm bản cài và hướng dẫn riêng cho iOS nếu có.
Thu phản hồi có cấu trúc — mẫu gồm thiết bị, phiên bản, các bước tái hiện, kết quả mong đợi. Phản hồi kiểu "bị lỗi" gần như không giúp ích gì.

Ba việc cần chuẩn bị trước khi bắt đầu

Phần lớn thời gian mất khi thiết lập công cụ phân phối không nằm ở công cụ, mà ở ba việc dưới đây:

Ký ứng dụng. Với Android, bạn cần tệp khoá ký và mật khẩu; không bao giờ đưa tệp khoá vào kho mã nguồn. Với iOS, bạn cần tài khoản nhà phát triển, mã định danh ứng dụng và hồ sơ cung cấp.
Cấu hình theo môi trường. Tách địa chỉ máy chủ, khoá dịch vụ theo từng môi trường ngay từ đầu, để bản kiểm thử không gọi vào máy chủ thật của khách hàng.
Quy ước phiên bản. Ghi rõ trong tài liệu dự án: phiên bản hiển thị cho người dùng khác gì so với số dựng, và ai chịu trách nhiệm tăng số trước khi phát hành.

Lỗi thường gặp khi phát hành nội bộ

Phát hành bản debug làm người kiểm thử báo lỗi hiệu năng không có thật.
Không ghi chú thay đổi, khiến người kiểm thử không biết cần tập trung vào phần nào.
Bỏ quên iOS, vì luồng cài trên iOS cần thêm bước chấp nhận thiết bị hoặc liên kết cài đặt riêng.
Phát hành quá dày, khiến phản hồi về bản trước bị thất lạc. Với nhóm nhỏ, một đến hai bản mỗi tuần là nhịp hợp lý.

Kết luận

Firebase App Distribution giúp:

✅ Phân phối app nhanh chóng
✅ Quản lý testers dễ dàng
✅ Tích hợp với CI/CD
✅ Miễn phí và dễ sử dụng

Tóm tắt:

Setup Firebase: Tạo project và enable App Distribution
Build App: Build APK/IPA
Distribute: Upload lên Firebase
Manage Testers: Thêm testers và groups
Automate: Tích hợp với CI/CD

Sử dụng Firebase App Distribution sẽ giúp quy trình testing của bạn hiệu quả hơn! 🚀

Học Flutter bài bản theo lộ trình

Nếu bạn muốn học có người sửa bài thay vì tự ghép tài liệu, Flutter Hướng Nghiệp đào tạo theo 3 cấp:

Flutter Cơ Bản — Dart, widget, giao diện, 28 buổi.
Flutter Nâng Cao — state management, REST API, Firebase, 28 buổi.
Flutter Chuyên Sâu — back-end, AI/ML, publish lên store, 53 buổi.

Lớp online trực tiếp qua Zoom/Google Meet, có bản ghi lại — không bắt buộc đến cơ sở.
Xem lịch khai giảng hoặc so sánh 5 cách học lập trình mobile nếu còn phân vân.

Tóm tắt nhanh