API Nhà phát triển Google Play cho phép bạn tải các tệp APK mới lên cho ứng dụng và phát hành tệp APK lên các kênh (phát hành) khác nhau. Điều này cho phép bạn triển khai các phiên bản alpha và beta của ứng dụng, được cung cấp cho người dùng đã phê duyệt. Điều này cũng cho phép bạn triển khai phiên bản phát hành theo giai đoạn, phiên bản này được tự động cung cấp cho một số ít người dùng ứng dụng. Sau khi phát hành phiên bản phát hành theo giai đoạn, bạn có thể tăng dần số người dùng nhận được phiên bản đó của ứng dụng cho đến khi triển khai phiên bản đó dưới dạng phiên bản "sản xuất".
Thêm và sửa đổi APK
Tải một hoặc nhiều tệp APK lên bằng cách gọi phương thức Edits.apks: upload.
Phương thức này sẽ tải tệp APK lên một "bộ chứa" lưu trữ, tại đó tệp APK có thể được gán cho một "bản nhạc" để triển khai cho người dùng. (Nếu nội dung chỉnh sửa bị xoá hoặc loại bỏ, thì mọi tệp APK tải lên cho nội dung chỉnh sửa đó cũng sẽ bị mất.)
Phát hành tệp APK trên các "bản nhạc" bằng cách gọi Edits.tracks: update. Bạn có thể phát hành tệp APK trên các kênh sau:
Các kênh thử nghiệm như
"alpha"và"beta"Phiên bản alpha và beta của ứng dụng được triển khai cho người dùng mà bạn chỉ định cho nhóm thử nghiệm alpha và beta. Bạn chỉ định người dùng cho các nhóm này bằng Google Play Console.
Kênh thử nghiệm nội bộ:
"internal"Các phiên bản nội bộ của ứng dụng được triển khai cho kênh thử nghiệm nội bộ như được định cấu hình trong Google Play Console.
Kênh phát hành công khai:
"production"Các bản phát hành trên kênh "sản xuất" được triển khai cho tất cả người dùng. Bạn có thể sử dụng các bản phát hành theo giai đoạn trên kênh "phát hành chính thức" để triển khai bản phát hành một cách an toàn trước cho một tỷ lệ nhỏ người dùng trong bản phát hành chính thức. Sau đó, tăng dần tỷ lệ này khi bạn tin tưởng vào bản phát hành sẽ tăng lên.
Người dùng chế độ đơn giản không được đặt nhiều APK cho bất kỳ kênh nào. Người dùng chế độ nâng cao sử dụng tính năng hỗ trợ nhiều APK có thể tải không, một hoặc nhiều APK lên mỗi kênh.
Tên bản nhạc cho các bản nhạc có hệ số hình dạng
Tên của một kênh phát hành dựa trên hệ số hình dạng có tiền tố là một giá trị nhận dạng cụ thể.
| Hệ số hình dạng | Tiền tố |
|---|---|
| Android Automotive OS | ô tô |
| Wear OS | wear |
Cách tính tên kênh cho một bản nhạc có hệ số hình dạng nhất định?
Các loại kênh thử nghiệm phổ biến như kênh phát hành công khai, kênh thử nghiệm công khai và kênh thử nghiệm nội bộ đều có tên kênh nổi tiếng.
| Loại theo dõi | Tên bản nhạc mặc định |
|---|---|
| Sản xuất | Khâu sản xuất |
| Thử nghiệm công khai | Phiên bản thử nghiệm |
| Thử nghiệm nội bộ | qa |
Bạn có thể tính tên kênh cho một bản nhạc có hệ số hình dạng nhất định như sau:
"[prefix]:defaultTrackName".
Ví dụ: hệ số hình dạng của Wear OS sẽ có các bản nhạc có tên là: "wear:production", "wear:beta" và "wear:qa".
Các kênh thử nghiệm khép kín được tạo theo cách thủ công và có tên tuỳ chỉnh. Vì vậy, kênh thử nghiệm khép kín cho một hệ số hình dạng có tên $name
sẽ có tên kênh là "[prefix]:$name".
Ví dụ về quy trình công việc của APK
Phần này mô tả cách sử dụng API Bản nhạc điển hình. Trong trường hợp này, chúng tôi giả định rằng bạn muốn tải các phiên bản APK mới lên cho mỗi kênh và chỉ định một số người dùng để nhận phiên bản phát hành theo giai đoạn. (Trên thực tế, có thể một nhà phát triển sẽ không thực hiện tất cả những hành động này trong cùng một hoạt động; thay vào đó, bạn có thể cập nhật phiên bản thử nghiệm một ngày, tạo một bản phát hành theo giai đoạn cho ngày "sản xuất", v.v.)
- Mở một nội dung chỉnh sửa mới như mô tả trong phần Quy trình chỉnh sửa
- Gọi phương thức Edits.apks: upload cho từng tệp APK mà bạn muốn tải lên. Truyền APK trong nội dung yêu cầu của phương thức. (Thao tác này đặt APK trong một khu vực lưu trữ nhưng không phát hành APK trên một kênh hoặc triển khai APK đó). Phương thức này sẽ trả về một mã phiên bản cho mỗi tệp APK bạn tải lên; bạn sẽ sử dụng mã phiên bản này để tham chiếu đến tệp APK khi bạn phát hành tệp APK đó trên một kênh phát hành.
Gọi phương thức Edits.tracks: update cho từng bản nhạc mà bạn muốn phát hành tệp APK. Trong phần nội dung yêu cầu, hãy chuyển một tài nguyên Edits.tracks chứa bản phát hành mà bạn muốn phát hành. Ví dụ: để phát hành một APK có mã phiên bản 88:
{ "releases": [{ "versionCodes": ["88"], "status": "completed" }] }Tại thời điểm này, người dùng vẫn chưa thể sử dụng tệp APK. Giống như các nội dung chỉnh sửa khác, nội dung thay đổi sẽ không xuất hiện cho đến khi bạn xác nhận.
Gọi phương thức Edits:Comm (Cam kết: xác nhận thay đổi) để xác nhận các thay đổi. Sau khi bạn làm điều này, người dùng trên mỗi kênh sẽ được cung cấp phiên bản APK cập nhật. (Tất cả nội dung chỉnh sửa có thể mất vài giờ để thay đổi có hiệu lực.)
Phát hành theo giai đoạn
Khi có phiên bản APK mới mà bạn muốn triển khai dần, bạn có thể chọn phát hành APK dưới dạng phiên bản "phát hành theo giai đoạn". Nếu bạn làm như vậy, Google Play sẽ tự động triển khai nó cho phần nhỏ người dùng mong muốn của ứng dụng mà bạn chỉ định. Nếu tệp APK "phát hành" không gặp vấn đề nào (chẳng hạn như sự cố, v.v.), thì bạn có thể tăng tỷ lệ người dùng nhận được phiên bản đó; khi bạn đã sẵn sàng, bạn có thể triển khai APK đó dưới dạng phiên bản phát hành chính thức mới.
Phần này mô tả các bước bạn sẽ thực hiện để phát hành APK theo giai đoạn, sau đó quảng bá APK đó cho sản xuất:
Tạo một nội dung chỉnh sửa như mô tả trong Quy trình chỉnh sửa.
Tải tệp APK mới lên cho nội dung chỉnh sửa, sử dụng phương thức Edits.apks: upload.
Bắt đầu bản phát hành theo giai đoạn
"inProgress"trên kênh phát hành công khai bằng phương thức Edits.tracks: update. Chọn phân số người dùng sẽ nhận được APK mới. Tại thời điểm này, tệp APK vẫn chưa được cung cấp cho người dùng cuối.{ "releases": [{ "versionCodes": ["99"], "userFraction": 0.05, "status": "inProgress" }] }Gửi bản thay đổi trong nội dung chỉnh sửa đang hoạt động bằng cách gọi Edits: Comm. Trong vài giờ tới, APK mới sẽ được phát hành cho người dùng. Tỷ lệ người dùng bạn chọn sẽ nhận được tệp APK mới.
Tuỳ thuộc vào mức độ thành công của bản phát hành theo giai đoạn, bạn có thể tăng tỷ lệ phần trăm người dùng đủ điều kiện để phát hành hoặc tạm dừng bản phát hành.
Tăng tỷ lệ người dùng cho bản phát hành theo giai đoạn
Giả sử bạn có việc phát hành theo giai đoạn đang diễn ra ở mức 5%, như mô tả trong phần trước, phần này mô tả cách tăng tỷ lệ phần trăm trong trường hợp bản phát hành đang hoạt động tốt:
Tạo một nội dung chỉnh sửa như mô tả trong Quy trình chỉnh sửa.
Thay đổi bản phát hành theo giai đoạn
"inProgress"trên kênh phát hành công khai bằng phương thức Edits.tracks: update. Tăng tỷ lệ người dùng sẽ nhận được APK mới:{ "releases": [{ "versionCodes": ["99"], "userFraction": 0.1, "status": "inProgress" }] }Gửi bản thay đổi trong nội dung chỉnh sửa đang hoạt động bằng cách gọi Edits: Comm. Trong vài giờ tới, APK mới sẽ được phát hành cho người dùng. Tỷ lệ người dùng bạn chọn sẽ nhận được tệp APK mới.
Tạm dừng phát hành theo giai đoạn
Giả sử bạn đang phát hành theo giai đoạn ở mức 5%, như mô tả trong phần trước, phần này mô tả cách tạm dừng phát hành theo giai đoạn trong trường hợp bạn phát hiện thấy vấn đề:
Tạo một nội dung chỉnh sửa như mô tả trong Quy trình chỉnh sửa.
Thay đổi bản phát hành theo giai đoạn
"inProgress"trên kênh phát hành công khai bằng phương thức Edits.tracks: update. Đặt trạng thái thành"halted".{ "releases": [{ "versionCodes": ["99"], "status": "halted" }] }Gửi bản thay đổi trong nội dung chỉnh sửa đang hoạt động bằng cách gọi Edits: Comm. Bản phát hành của bạn sẽ không có sẵn cho người dùng mới nữa.
Nếu sau đó bạn quyết định tiếp tục một bản phát hành đã tạm dừng, thì bạn có thể đặt lại trạng thái thành "inProgress".
Hoàn tất quá trình phát hành theo giai đoạn
Khi đã hài lòng với bản phát hành theo giai đoạn và muốn phát hành cho
100% người dùng, bạn có thể đặt trạng thái phát hành thành "completed":
Tạo một nội dung chỉnh sửa như mô tả trong Quy trình chỉnh sửa.
Thay đổi bản phát hành theo giai đoạn
"inProgress"trên kênh phát hành công khai bằng phương thức Edits.tracks: update. Đặt trạng thái thành"halted".{ "releases": [{ "versionCodes": ["99"], "status": "completed" }] }Gửi bản thay đổi trong nội dung chỉnh sửa đang hoạt động bằng cách gọi Edits: Comm. Trong vài giờ tới, APK mới sẽ được phát hành cho người dùng. Tỷ lệ người dùng bạn chọn sẽ nhận được tệp APK mới.
Bản phát hành nháp
Bản phát hành nháp cho phép bạn tự động tải tệp APK lên và tạo bản phát hành thông qua API sau này có thể được triển khai qua Google Play Console. Cách tạo bản phát hành nháp trên một kênh:
- Mở một nội dung chỉnh sửa mới như mô tả trong phần Quy trình chỉnh sửa
- Gọi phương thức Edits.apks: upload cho từng tệp APK mà bạn muốn tải lên. Truyền APK vào nội dung yêu cầu của phương thức. Phương thức này sẽ trả về một mã phiên bản cho mỗi tệp APK bạn tải lên; bạn sẽ sử dụng mã phiên bản này để tham chiếu đến tệp APK khi chỉ định APK cho một bản phát hành.
Gọi phương thức Edits.tracks: update cho từng bản nhạc mà bạn muốn phát hành. Trong phần nội dung yêu cầu, hãy chuyển một tài nguyên Edits.tracks chứa bản phát hành nháp mà bạn muốn tạo. Ví dụ:
{ "releases": [{ "name": "My draft release", "versionCodes": ["88"], "status": "draft" }] }Gọi phương thức Edits:Comm (Cam kết: xác nhận thay đổi) để xác nhận các thay đổi. Hiện bạn có thể kiểm tra và ra mắt bản phát hành nháp thông qua Google Play Console hoặc API.
Chỉ định ghi chú phát hành
Khi phát hành một phiên bản mới của ứng dụng, bạn có thể làm nổi bật các tính năng mới của người dùng bằng cách chỉ định ghi chú phát hành cho bản phát hành.
Để thực hiện việc này, hãy sử dụng trường "releaseNotes" khi cung cấp
tài nguyên Edits.tracks cho phương thức
Edits.tracks: update.
{
"releases": [{
"name": "Release with notes",
"versionCodes": ["88"],
"status": "completed",
"releaseNotes": [
{"language": "en-US", "text": "Describe what's new in this release."}
]
}]
}