Gradle Play Publisher: Tự Động Hoá Phát Hành Android

Gradle Play Publisher Là Gì?

Gradle Play Publisher, gọi tắt là GPP, là một plugin Gradle tự động hoá việc tải lên và thăng cấp App Bundle hoặc APK của Android lên Google Play Store, đồng thời đẩy trang thông tin ứng dụng như mô tả và ảnh chụp màn hình. Nó chạy dưới dạng các task Gradle đặt tên theo quy ước của Android Gradle Plugin, ví dụ publishBundle hay publishApk, nên gắn vào một build Android có sẵn thay vì thay thế build đó.

Tính Năng Chính Để Phát Hành Android

• ✓Tải lên và thăng cấp cả App Bundle lẫn APK tới bất kỳ track nào (internal, alpha, beta, production, hoặc một track tuỳ chỉnh) qua các task Gradle như publishBundle và publishApk.
• ✓Đặt tên task Gradle theo mẫu [action][Variant][Thing], khớp với quy ước riêng của Android Gradle Plugin, nên một flavor tên paid sẽ tự có task publishPaidReleaseBundle.
• ✓Quản lý trang thông tin ứng dụng trên Play Store (mô tả, thông tin liên hệ, ảnh chụp màn hình) từ các file trong src/[sourceSet]/play, và tự gộp bản dịch còn thiếu từ ngôn ngữ mặc định.
• ✓Đọc ghi chú phát hành theo từng track từ file release-notes/[language]/[track].txt, và lấy lại ghi chú của bản phát hành trước nếu không tìm thấy file nào.
• ✓Tải lên artifact Internal Sharing và có thể cài trực tiếp lên thiết bị đang kết nối bằng task installReleasePrivateArtifact.
• ✓Tự xử lý xung đột version code bằng resolutionStrategy là IGNORE hoặc AUTO thay vì làm build thất bại.
• ✓Xác thực qua file JSON của service account, biến môi trường ANDROID_PUBLISHER_CREDENTIALS, hoặc Application Default Credentials kèm tuỳ chọn mạo danh service account (impersonation).

Lựa Chọn Thay Thế Để Tự Động Hoá Triển Khai Android

Câu Hỏi Thường Gặp

Vấn đề nó giải quyết

Phát hành một bản cập nhật Android nghĩa là phải xử lý hai hệ thống tách biệt: build Gradle tạo ra App Bundle hoặc APK, và Google Play Console, nơi artifact đó, ghi chú phát hành, và trang thông tin ứng dụng thực sự được đưa lên. Làm phần Play Console bằng tay cho mỗi lần phát hành, nhất là khi có nhiều product flavor và nhiều track, nghĩa là ai đó phải tải lại file và gõ lại ghi chú phát hành mỗi lần. Gradle Play Publisher nối API Play Developer vào chính các task Gradle vốn đã build ứng dụng, nên bước tải lên và thăng cấp chạy như một phần của build thay vì một bước thủ công riêng.

Trường hợp sử dụng tốt nhất

• •Một pipeline CI cần đẩy bản build internal hoặc alpha mới cho tester sau mỗi lần merge, mà không ai phải đụng vào Play Console bằng tay.
• •Các đội có nhiều product flavor, mỗi flavor cần track và ghi chú phát hành riêng, vì GPP tự sinh một task cho từng flavor.
• •Thăng cấp một bản build đã có trên một track sang track khác, ví dụ chuyển bản beta lên production với tỷ lệ rollout theo giai đoạn, mà không cần tải lại artifact.
• •Giữ nội dung trang thông tin ứng dụng, ảnh chụp màn hình, và metadata sản phẩm trong ứng dụng dưới dạng version control thay vì chỉnh tay trong Play Console.

Cách cài đặt / dùng thử

Áp dụng plugin cho từng module trong build.gradle(.kts), đặt cạnh com.android.application. Sau đó thêm id("com.github.triplet.play") version "4.1.1" vào khối plugins {}. Ba điều cần có sẵn trước khi plugin này hữu ích: APK hoặc App Bundle đầu tiên của ứng dụng đã được tải lên một lần qua Google Play Console, vì GPP không làm được phần đó; build release đã có cấu hình ký hợp lệ; và đã tạo một service account trên Google Cloud với AndroidPublisher API được bật cùng file JSON key đã tải về. Bản snapshot của phiên bản kế tiếp, hiện là 5.0.0-SNAPSHOT, được đăng lên kho snapshots của Sonatype cho ai muốn theo dõi trước khi có bản gắn tag chính thức.

Cách sử dụng

Trỏ GPP tới file key của service account bằng play { serviceAccountCredentials.set(file("path/to/your-key.json")) }, hoặc bỏ qua việc commit file đó và dùng biến môi trường ANDROID_PUBLISHER_CREDENTIALS thay thế. Từ đó, ./gradlew publishBundle tải lên và phát hành một App Bundle, ./gradlew publishApk làm tương tự với APK, còn ./gradlew promoteArtifact chuyển một bản phát hành có sẵn từ track này sang track khác bằng cặp thuộc tính fromTrack/promoteTrack hoặc các tuỳ chọn dòng lệnh tương ứng. Chạy ./gradlew bootstrapListing một lần để kéo trang thông tin ứng dụng hiện tại về project làm điểm khởi đầu, sau đó ./gradlew publishListing để đẩy metadata đã chỉnh lên lại. Các thiết lập như track, releaseStatus, và userFraction, tỷ lệ rollout theo giai đoạn mặc định là 0.1 (10%), đều nằm trong khối play {}.

Ai nên dùng — và ai nên bỏ qua

Hãy thử Gradle Play Publisher nếu bạn đã build ứng dụng Android bằng Gradle và muốn ghi chú phát hành, thăng cấp track, và metadata trang thông tin nằm trong repo thay vì trong giao diện Play Console. Nó phù hợp với các đội có nhiều flavor hoặc một pipeline CI đã chạy sẵn các task Gradle. Bỏ qua nếu bạn không thoải mái khi phải đọc source hoặc mở pull request lúc có lỗi, vì README nói rõ issue không được phản hồi, hoặc nếu bạn chưa làm bước tải lên thủ công lần đầu và thiết lập service account mà plugin này cần có sẵn.

Repo liên quan