APK và kênh

Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

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 bản đó lên nhiều 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ố lượng 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 "production".

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 phương thức Edits.apks: upload.

    Phương thức này tải tệp APK lên một bộ nhớ "bộ" để có thể chỉ định tệp APK này cho "track" để triển khai APK 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 nội dung chỉnh sửa đó cũng sẽ bị mất.)

  2. Phát hành 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 thử nghiệm như "alpha""beta"

      Phiên bản alpha và beta của ứng dụng được triển khai cho những 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 cho các nhóm này bằng cách sử dụ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 trên 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 "production" bản phát hành đượ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 "production" theo dõi để triển khai bản phát hành một cách an toàn trước tiên cho một tỷ lệ nhỏ người dùng. Sau đó, tăng dần tỷ lệ này khi bạn tin tưởng hơn vào bản phát hành.

    Người dùng chế độ đơn giản không nên đặt nhiều 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 tối đa 0, một hoặc nhiều tệp APK lên mỗi kênh.

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 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 số lượng người dùng để nhận phiên bản phát hành theo giai đoạn. (Trong thực tế, có thể một nhà phát triển sẽ không thực hiện được tất cả các hành động 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 thử nghiệm một ngày, tạo một bản phát hành theo giai đoạn vào &"production" một ngày khác, v.v.)

  1. 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 công việc
  2. Gọi phương thức Edits.apks: upload cho từng tệp APK bạn muốn tải lên. Chuyển tệp APK trong nội dung yêu cầu của phương thức. (Thao tác này sẽ đặt APK tại một khu vực lưu trữ, nhưng không phát hành APK này trên một kênh hoặc triển khai APK đó.) 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 đến tệp APK khi phát hành tệp APK đó trên một kênh phát hành.
  3. 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 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, các tệp APK vẫn chưa được cung cấp cho người dùng. Giống như các nội dung chỉnh sửa khác, nội dung thay đổi sẽ không có hiệu lực cho đến khi bạn xác nhận.

  4. Gọi phương thức Edits:ledge (Bản chỉnh sửa): xác nhận (commit) 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. (Như tất cả chỉnh sửa, 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 APK mới mà bạn muốn triển khai dần dần, bạn có thể chọn phát hành phiên bản này 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 phương thức này cho một phân đoạn người dùng mong muốn của người dùng ứng dụng mà bạn chỉ định. Nếu "rollout" 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 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 để triển khai một tệp APK theo giai đoạn, sau đó quảng bá tệp này lên phiên bản chính thức:

  1. Tạo một 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 nội dung chỉnh sửa bằng cách sử dụng phương thức Edits.apks: upload.

  3. Bắt đầu phát hành theo giai đoạn "inProgress" trên kênh phát hành chính thức bằng phương thức Edits.tracks: update. Chọn một phân khúc người dùng sẽ nhận được tệp APK mới. Tại thời điểm này, APK vẫn chưa được cung cấp cho người dùng cuối nào.

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

  4. Gửi các thay đổi trong nội dung chỉnh sửa đang hoạt động bằng cách gọi Edits:ledge (Bản chỉnh sửa: cam kết). Trong vài giờ tới, tệp APK mới sẽ được ra mắt cho người dùng. Tỷ lệ phần trăm người dùng mà bạn chọn sẽ nhận được tệp APK mới.

Tuỳ thuộc vào sự thành công của bản 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ệ phần trăm người dùng cho bản phát hành theo giai đoạn

Giả sử bạn có một bản phát hành theo giai đoạn đang diễn ra ở mức 5%, như được 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:

  1. Tạo một 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 chính thức 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"
    }]
    }
    

  3. Gửi các thay đổi trong nội dung chỉnh sửa đang hoạt động bằng cách gọi Edits:ledge (Bản chỉnh sửa: cam kết). Trong vài giờ tới, tệp APK mới sẽ được ra mắt cho người dùng. Tỷ lệ phần trăm người dùng mà 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 có một bản phát hành theo giai đoạn đang diễn ra ở mức 5%, như được 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 một 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 chính thức bằng phương thức Edits.tracks: update. Đặt trạng thái thành "halted".

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

  3. Gửi các thay đổi trong nội dung chỉnh sửa đang hoạt động bằng cách gọi Edits:ledge (Bản chỉnh sửa: cam kết). Bản phát hành của bạn sẽ không còn được cung cấp cho người dùng mới.

Nếu sau đó 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ể thực hiện bằng cách đặt trạng thái của bản phát hành đó về "inProgress".

Hoàn thành việc 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 bả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":

  1. Tạo một 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 chính thức bằng phương thức Edits.tracks: update. Đặt trạng thái thành "halted".

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

  3. Gửi các thay đổi trong nội dung chỉnh sửa đang hoạt động bằng cách gọi Edits:ledge (Bản chỉnh sửa: cam kết). Trong vài giờ tới, tệp APK mới sẽ được ra mắt cho người dùng. Tỷ lệ phần trăm người dùng mà 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 một bản phát hành thông qua API, sau này bạn có thể triển khai bản phát hành này thông qua Google Play Console. Cách tạo bản phát hành nháp trên kênh:

  1. 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 công việc
  2. Gọi phương thức Edits.apks: upload cho từng tệp APK bạn muốn tải lên. Chuyển APK trong phần nội dung yêu cầu của phương thức. 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 đến tệp APK khi chỉ định tệp APK này 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 mà bạn muốn phát hành. Trong phần 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"
    }]
    }
    

  4. Gọi phương thức Edits:ledge (Bản chỉnh sửa): xác nhận (commit) 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 các tính năng mới cho người dùng bằng cách chỉ định ghi chú phát hành trong 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."}
      ]
  }]
}