CI/CD Tag Builder

Công cụ tạo lệnh Git Tag chuẩn xác để trigger CI/CD pipeline theo tài liệu dự án.

Mẫu nhanh thường dùng (Full Build)

Các mẫu nhanh này sẽ build song song cả Android và iOS. Nếu cần tùy biến platform riêng, hãy chọn ở cấu hình chi tiết bên dưới.

Cấu hình Tag chi tiết

1. Môi trường (Flavor) *

2. Nền tảng (Platform)

3. Phiên bản (Version) - Tùy chọn

Nếu điền, sẽ tự động ghi đè version vào pubspec.yaml. Bỏ trống để CI lấy version hiện tại và tự tăng build number.

4. Chế độ mở rộng (Flags)

Upload Google Play -gg

Thay đổi behavior của Android: build AAB và upload lên Google Play (nếu có track). Không có cờ này sẽ build APK đẩy lên Firebase. iOS không bị ảnh hưởng.

Build-only mode (No Deploy) -mail

Chỉ chạy build, test và gửi mail báo cáo. BỎ QUA việc phân phối lên Firebase, TestFlight hay Google Play.

Kết quả Terminal

Tên Tag sinh ra:

Lệnh Terminal (Đã bọc chuỗi an toàn):

Lệnh push bọc trong "refs/tags/..." giúp tránh lỗi cú pháp "does not match any" trên zsh khi version tag chứa ký tự đặc biệt như +.

Tài liệu CI/CD Tags (Cheat Sheet)

Quy tắc Version

Nếu có version (VD: -1.0.0+12), pipeline sẽ tự ghi vào file pubspec.yaml.
Nếu không có version, CI sẽ tự động lấy version hiện tại và tăng build number.

Release Notes

Sử dụng file CHANGELOG.md ở root của repository.
Nếu file CHANGELOG.md không tồn tại, pipeline sẽ tự động bỏ qua bước gắn release notes.

Thành phần	Bắt buộc	Hành vi & Ý nghĩa
build	Có	Prefix bắt buộc để trigger workflow CI.
-android \| -ios	Không	Giới hạn Scope build platform. Nếu bỏ trống = build cả Android + iOS song song.
-<flavor>	Có	Môi trường deploy: `dev`, `stg`, hoặc `prod`.
-gg	Không	Chỉ ảnh hưởng Android: Build định dạng AAB và upload trực tiếp lên Google Play. Nếu không có `-gg`, pipeline mặc định build APK và phân phối qua Firebase.
-mail	Không	Build-only: Vẫn chạy build/test và gửi email thông báo, nhưng hoàn toàn bỏ qua các bước release (Firebase/TestFlight/GG Play).