APK và kênh

API Nhà phát triển Google Play cho phép bạn tải lên APK mới cho ứng dụng của mình và phát hành chúng trê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, những phiên bản này đã được cung cấp cho người dùng được phê duyệt. Việc này cũng giúp bạn triển khai tính năng 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 bạn 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 cài đặt phiên bản ứng dụng, cho đến khi cuối cùng bạn triển khai phiên bản đó dưới dạng phiên bản "phát hành công khai" .

Thêm và sửa đổi APK

  1. Tải một hoặc nhiều APK lên bằng cách gọi hàm Edits.apks: tải lên.

    Phương thức này sẽ tải tệp APK lên một "bộ chứa" lưu trữ để được gán cho một "kênh" để triển khai ứng dụng cho người dùng. (Nếu nội dung chỉnh sửa là bị xóa hoặc bị hủy, mọi APK được tải lên bản chỉnh sửa đó cũng lost.)

  2. Phát hành APK trên "kênh" bằng cách gọi điện Edits.tracks: cập nhật. Bạn có thể huỷ APK trên các kênh sau:

    • Các kênh kiểm thử như "alpha""beta"

      Các phiên bản alpha và beta của ứng dụng được triển khai cho người dùng bạn chỉ định cho nhóm thử nghiệm alpha và beta. Bạn chỉ định người dùng vào các nhóm này thông qua Google Play Console.

    • Kênh kiểm thử nội bộ: "qa"

      Các phiên bản nội bộ của ứng dụng được triển khai cho thử nghiệm nội bộ theo dõi trạng thái đã định cấu hình trong Google Play Console.

    • Kênh phát hành công khai: "production"

      Bản phát hành "chính thức" được triển khai cho tất cả người dùng. Bạn có thể tận dụng bản phát hành theo giai đoạn "chính thức" theo dõi đến nơi an toàn triển khai bản phát hành trước cho một tỷ lệ nhỏ người dùng phiên bản chính thức rồi tăng dần tỷ lệ phần trăm này khi mức độ tự tin của bạn bản phát hành sẽ phát triển.

    Người dùng ở chế độ đơn giản không được đặt nhiều hơn một APK cho bất kỳ bản nhạc. Người dùng chế độ nâng cao sử dụng nhiều APK hỗ trợ có thể tải 0, 1 hoặc nhiều APK lên từng kênh.

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

Tên của kênh phát hành dành cho hệ số hình dạng phải có tiền tố cụ thể là giá trị nhận dạng.

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

Làm cách nào để tính toán tên kênh phát hành cho một kênh phát hành dành cho từng hệ số hình dạng?

Các loại kênh phổ biến như phát hành công khai, thử nghiệm công khai và nội bộ kênh thử nghiệm có tên kênh nổi tiếng.

Loại theo dõi Tên mặc định của bản nhạc
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 phát hành dành cho từng hệ số hình dạng 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""wear:qa".

Kênh thử nghiệm khép kín được tạo theo cách thủ công và có tuỳ chỉnh tên. Vì vậy, kênh kiểm thử khép kín cho một hệ số hình dạng có tên là $name sẽ có tên bản nhạc 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 thông thường của API theo dõi. Trong trường hợp này, chúng tôi giả định rằng bạn muốn tải lên các phiên bản APK mới cho từng kênh và chỉ định nhiều người dùng nhận phiên bản phát hành theo giai đoạn. (Trên thực tế, nhà phát triển sẽ không thể thực hiện tất cả các 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 beta vào một ngày, hãy tạo một bản phát hành theo giai đoạn "sản xuất" một ngày khác, v.v.)

  1. Mở một chỉnh sửa mới, như được mô tả trong Quy trình chỉnh sửa
  2. Gọi phương thức Edits.apks: tải lên cho từng APK bạn muốn tải lên. Truyền tệp APK vào yêu cầu của phương thức nội dung. (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 ứng dụng trên kênh hoặc triển khai.) Phương thức này 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 vào APK khi bạn phát hành ứng dụng lên một kênh.
  3. Gọi phương thức Edits.tracks: update cho từng kênh mà bạn muốn phát hành APK. Trong nội dung yêu cầu, chuyển tài nguyên Edits.tracks chứa bản phát hành bạn muốn giới thiệu. 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, tệp APK vẫn chưa được cung cấp cho người dùng. Giống như các chỉnh sửa khác, thì các thay đổi sẽ không xuất hiện cho đến khi bạn thực hiện.

  4. Gọi phương thức Edits:mit (Chỉnh sửa: cam kết) để thực hiện thay đổi. Sau khi bạn làm như vậy, người dùng trên mỗi kênh sẽ dựa trên phiên bản đã cập nhật của APK. (Giống như tất cả các nội dung chỉnh sửa, tính năng này 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 muốn triển khai dần một phiên bản APK mới, bạn có thể chọn phát hành dưới dạng "phát hành theo giai đoạn" . Nếu bạn làm như vậy, Google Play tự động triển khai tỷ lệ phần trăm mong muốn của ứng dụng người dùng mà bạn chỉ định. Nếu " đợt phát hành" APK không có 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 APK đó dưới dạng phiên bản sản xuất mới .

Phần này mô tả các bước bạn sẽ thực hiện để thực hiện một phát hành theo giai đoạn APK, sau đó quảng bá ứng dụng đó lên sản xuất:

  1. Tạo nội dung chỉnh sửa như mô tả trong Quy trình chỉnh sửa.

  2. Tải APK mới lên bản chỉnh sửa, sử dụng Edits.apks: tải lên.

  3. Bắt đầu phát hành theo giai đoạn "inProgress" trên kênh phát hành công khai bằng Edits.tracks: update. Chọn tỷ lệ người dùng sẽ nhận được APK mới. Tại thời điểm này, APK vẫn không có sẵn cho bất kỳ người dùng cuối nào.

    {
    "releases": [{
      "versionCodes": ["99"],
      "userFraction": 0.05,
      "status": "inProgress"
    }]
    }
    

  4. 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 Chỉnh sửa: cam kết. Trong vài phút tới giờ, APK mới sẽ được triển khai cho người dùng. Phân số người dùng bạn chọn sẽ nhận được APK mới.

Tuỳ thuộc vào mức độ thành công của phát hành theo giai đoạn, bạn có thể muốn tăng tỷ lệ phần trăm người dùng đủ điều kiện cho 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 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ăng tỷ lệ phần trăm trong trường hợp trong đó bản phát hành đang hoạt động hiệu quả:

  1. Tạo nội dung chỉnh sửa như mô tả trong Quy trình chỉnh sửa.

  2. 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 cách sử dụng 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"
    }]
    }
    

  3. 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 Chỉnh sửa: cam kết. Trong vài phút tới giờ, APK mới sẽ được triển khai cho người dùng. Phân số người dùng bạn chọn sẽ nhận được APK mới.

Tạm dừng phát hành theo giai đoạn

Giả sử bạn đang triển khai 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 ra vấn đề:

  1. Tạo nội dung chỉnh sửa như mô tả trong Quy trình chỉnh sửa.

  2. 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 cách sử dụng Edits.tracks: update. Thiết lập trạng thái thành "halted".

    {
    "releases": [{
      "versionCodes": ["99"],
      "status": "halted"
    }]
    }
    

  3. 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 Chỉnh sửa: cam kết. Bản phát hành của bạn sẽ không còn có sẵn cho người dùng mới.

Nếu sau đó bạn quyết định tiếp tục bản phát hành bị tạm dừng, bạn có thể thực hiện bằng cách cài đặt trạng thái của nó trở lại "inProgress".

Hoàn tất phát hành theo giai đoạn

Khi bạn đã hài lòng với bản phát hành theo giai đoạn và muốn giới thiệu bản phát hành đó 100% người dùng, bạn có thể đặt trạng thái phát hành thành "completed":

  1. Tạo nội dung chỉnh sửa như mô tả trong Quy trình chỉnh sửa.

  2. 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 cách sử dụng Edits.tracks: update. Thiết lập trạng thái thành "completed".

    {
    "releases": [{
      "versionCodes": ["99"],
      "status": "completed"
    }]
    }
    

  3. 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 Chỉnh sửa: cam kết. Trong vài phút tới giờ, APK mới sẽ được triển khai cho người dùng. Phân số người dùng bạn chọn sẽ nhận được 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 qua API có thể được triển khai sau này thông qua Google Play Console. Người nhận tạo bản phát hành nháp trên một kênh:

  1. Mở một chỉnh sửa mới, như được mô tả trong Quy trình chỉnh sửa
  2. Gọi phương thức Edits.apks: tải lên cho từng APK bạn muốn tải lên. Truyền tệp APK vào phần nội dung yêu cầu của phương thức. Chiến lược phát hành đĩa đơn phương thức trả về một mã phiên bản cho từng APK bạn tải lên; bạn sẽ dùng cái này mã phiên bản để tham chiếu đến APK khi bạn chỉ định APK đó cho một bản phát hành.
  3. Gọi phương thức Edits.tracks: update cho từng bản nhạc bạn muốn phát hành. Trong nội dung yêu cầu, 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"
    }]
    }
    

  4. Gọi phương thức Edits:mit (Chỉnh sửa: cam kết) để thực hiện thay đổi. Giờ đây, bạn có thể kiểm tra và triển khai 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 nội dung 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 vào phần Edits.tracks: update.

{
  "releases": [{
      "name": "Release with notes",
      "versionCodes": ["88"],
      "status": "completed",
      "releaseNotes": [
        {"language": "en-US", "text": "Describe what's new in this release."}
      ]
  }]
}