Trang này được dịch bởi Cloud Translation API.

APK và kênh

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 của mình và phát hành các tệp APK đó lên kênh phát hành khác nhau. Nhờ đó, bạn có thể triển khai các phiên bản alpha và beta của ứng dụng và được cung cấp cho người dùng được phê duyệt. Điều này cũng cho phép bạn triển khai một phiên bản phát hành theo giai đoạn. Phiên bản này sẽ tự động được 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ố lượng người dùng tải phiên bản ứng dụng đó cho đến khi triển khai cuối cùng phiên bản đó dưới dạng phiên bản "chính thức".

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 tải APK lên một "bộ chứa" lưu trữ, trong đó bạn có thể chỉ định APK cho một "kênh theo dõi" để triển khai cho người dùng. (Nếu nội dung chỉnh sửa bị xoá hoặc bị loại bỏ, thì mọi tệp APK được tải lên bản chỉnh sửa đó cũng sẽ bị mất.)
Phát hành tệp APK trên "tracks" 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 kiểm thử như "alpha" và "beta"
  
  Các phiên bản alpha và beta của ứng dụng được triển khai cho những người dùng mà bạn chỉ định cho các nhóm kiểm thử alpha và beta. Bạn chỉ định người dùng cho các nhóm này thông qua Google Play Console.
- Kênh kiểm thử nội bộ: "internal"
  
  Các phiên bản nội bộ của ứng dụng sẽ được triển khai trên kênh kiểm thử nội bộ như đã đị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 "chính thức" được triển khai cho tất cả người dùng. Trước tiên, bạn có thể tận dụng bản phát hành theo giai đoạn trên kênh "chính thức" để triển khai an toàn bản phát hành cho một tỷ lệ nhỏ người dùng bản phát hành công khai, sau đó tăng dần tỷ lệ phần trăm này khi bạn tin tưởng vào bản phát hành hơn.
Người dùng ở chế độ đơn giản không được đặt quá một APK vào 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 tệp APK có thể tải các tệp APK 0, 1 hoặc nhiều tệp APK lên từng kênh.

Tên kênh cho các kênh phát hành theo hệ số hình dạng

Tên kênh cho một kênh có hệ số hình dạng được thêm vào trước một giá trị nhận dạng cụ thể.

Kiểu dáng	Tiền tố
Android Automotive OS	ô tô
Wear OS	wear
Android TV	TV

Cách tính toán tên kênh cho một kênh có hệ số hình dạng cụ thể?

Các loại kênh phổ biến như kênh phát hành công khai, kênh kiểm thử công khai và kênh kiểm thử 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 mở	Phiên bản beta
Thử nghiệm nội bộ	qa

Tên kênh cho một kênh có hệ số hình dạng nhất định có thể được tính như sau: "[prefix]:defaultTrackName". Ví dụ: hệ số hình dạng Wear OS sẽ có các kênh có tên: "wear:production", "wear:beta" và "wear:qa".

Các kênh kiểm thử 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 kiểm thử khép kín cho hệ số hình dạng $name sẽ có tên kênh là "[prefix]:$name".

Ví dụ về quy trình làm việc APK

Phần này mô tả cách sử dụng điển hình mà Tracks API sẽ được sử dụng. Trong trường hợp này, chúng tôi giả định bạn muốn tải các phiên bản APK mới lên cho từng 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. (Trong thực tế, nhà phát triển khó có thể thực hiện tất cả những thao tác này trong cùng một thao tác; thay vào đó, bạn có thể cập nhật phiên bản beta một ngày, tạo một bản phát hành theo giai đoạn cho "chính thức" vào một ngày khác, v.v.)

Mở một nội dung chỉnh sửa mới, như mô tả trong phần Chỉnh sửa quy trình làm việc
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 tệp APK vào nội dung yêu cầu của phương thức đó. (Thao tác này sẽ đặt APK vào một khu vực lưu trữ, nhưng không phát hành APK trên 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 từng 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 phát hành trên một kênh.
Gọi phương thức Edits.tracks: update cho từng kênh mà bạn muốn phát hành tệp APK trên đó. Trong nội dung yêu cầu, hãy truyền tài nguyên Edits.tracks chứa bản phát hành mà bạn muốn ra mắt. Ví dụ: để phát hành tệp 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 có quyền sử dụng tệp APK. Giống như các nội dung chỉnh sửa khác, các thay đổi sẽ không được phát hành cho đến khi bạn thực hiện.
Gọi phương thức Edits: engagement (Chỉnh sửa: xác nhận) để xác nhận các thay đổi. Sau khi bạn thực hiện việc 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. (Giống như tất cả các nội dung chỉnh sửa khác, có thể mất vài giờ để các thay đổi có hiệu lực.)

Phát hành theo giai đoạn

Khi có phiên bản mới của tệp APK mà bạn muốn triển khai dần, bạn có thể chọn phát hành 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 ứng dụng cho tỷ lệ người dùng ứng dụng mong muốn mà bạn chỉ định. Nếu tệp APK "ra mắt" không gặp bất kỳ vấn đề nào (chẳng hạn như sự cố, v.v.), bạn có thể tăng tỷ lệ người dùng nhận được phiên bản đó; khi đã sẵn sàng, bạn có thể triển khai tệp 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 một tệp APK theo giai đoạn, sau đó quảng bá tệp APK đó lên phiên bản chính thức:

Tạo nội dung chỉnh sửa, như mô tả trong Quy trình chỉnh sửa quy trình.
Tải một tệp APK mới lên nội dung chỉnh sửa bằng cách sử dụng phương thức Edits.apks: upload.
Bắt đầu một 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 nhóm người dùng sẽ nhận được tệp APK mới. Tại thời điểm này, tệp APK vẫn chưa được cung cấp cho bất kỳ người dùng cuối nào.
```
{
"releases": [{
  "versionCodes": ["99"],
  "userFraction": 0.05,
  "status": "inProgress"
}]
}
```
Xác nhận các thay đổi trong nội dung chỉnh sửa đang hoạt động bằng cách gọi Edits: import (Chỉnh sửa: xác nhận). Trong vài giờ tới, tệp APK mới sẽ được triển khai 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 thành công của quá trình phát hành theo giai đoạn, bạn nên tăng tỷ lệ phần trăm người dùng đủ điều kiện sử dụng bả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 đang triển khai một bản phát hành theo giai đoạn ở mức 5%, như mô tả trong phần trước, phần này sẽ 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 nội dung chỉnh sửa, như mô tả trong Quy trình chỉnh sửa quy trình.
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 số người dùng sẽ nhận được APK mới:
```
{
"releases": [{
  "versionCodes": ["99"],
  "userFraction": 0.1,
  "status": "inProgress"
}]
}
```
Xác nhận các thay đổi trong nội dung chỉnh sửa đang hoạt động bằng cách gọi Edits: import (Chỉnh sửa: xác nhận). Trong vài giờ tới, tệp APK mới sẽ được triển khai 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ử mức phát hành theo giai đoạn đang diễn ra là 5%, như mô tả trong phần trước, thì phần này sẽ 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 ra sự cố:

Tạo nội dung chỉnh sửa, như mô tả trong Quy trình chỉnh sửa quy trình.
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"
}]
}
```
Xác nhận các thay đổi trong nội dung chỉnh sửa đang hoạt động bằng cách gọi Edits: import (Chỉnh sửa: xác nhận). Bản phát hành của bạn sẽ không được cung cấp cho người dùng mới nữa.

Nếu sau này bạn quyết định tiếp tục một bản phát hành đã bị tạm dừng, bạn có thể đặt lại trạng thái của bản phát hành đó về "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 ra mắt 100% người dùng, bạn có thể đặt trạng thái phát hành thành "completed":

Tạo nội dung chỉnh sửa, như mô tả trong Quy trình chỉnh sửa quy trình.
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"
}]
}
```
Xác nhận các thay đổi trong nội dung chỉnh sửa đang hoạt động bằng cách gọi Edits: import (Chỉnh sửa: xác nhận). Trong vài giờ tới, tệp APK mới sẽ được triển khai 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 các tệp APK lên và tạo bản phát hành thông qua API, sau đó có thể triển khai thông 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 Chỉnh sửa quy trình làm việc
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 tệp 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 tệp 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 nội dung yêu cầu, hãy chuyển 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: engagement (Chỉnh sửa: xác nhận) để xác nhận các thay đổi. Giờ đây, 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 những tính năng mới cho người dùng bằng cách chỉ định ghi chú phát hành trên 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."}
      ]
  }]
}