Pliki APK i utwory

Interfejs Google Play Developer API umożliwia przesyłanie nowych pakietów APK aplikacji i publikowanie ich na różnych ścieżkach wersji. Dzięki temu możesz wdrażać wersje alfa i beta aplikacji, które będą dostępne dla zatwierdzonych użytkowników. Umożliwia to też wdrożenie wersji wdrażania etapowego, która jest automatycznie udostępniana niewielkiej liczbie użytkowników. Po opublikowaniu wersji wdrażania etapowego możesz stopniowo zwiększać liczbę użytkowników, którzy będą ją otrzymywać, aż w końcu wdrożysz tę wersję jako wersję „produkcyjną”.

Dodawanie i modyfikowanie plików APK

1. Prześlij co najmniej 1 plik APK, wywołując metodę Edits.apks: upload.

   Ta metoda przesyła plik APK do „zasobnika” na dane, gdzie można go przypisać do „ścieżki”, aby wdrożyć go na urządzeniach użytkowników. (Jeśli zmiana zostanie usunięta lub odrzucona, wszystkie pliki APK przesłane w ramach tej zmiany również zostaną utracone).

2. Publikuj pliki APK na „ścieżkach”, wywołując Edits.tracks: update. Pliki APK możesz publikować na tych ścieżkach:

   • Ścieżki testów, np. "alpha" i "beta"

     Wersje alfa i beta aplikacji są wdrażane na kontach użytkowników przypisanych do grup testerów alfa i beta. Użytkowników przypisuje się do tych grup w Konsoli Google Play.

   • Ścieżka testu wewnętrznego: "qa"

     Wersje wewnętrzne aplikacji są wdrażane na ścieżce testu wewnętrznego zgodnie z konfiguracją w Konsoli Google Play.

   • Ścieżka produkcyjna: "production"

     Wersje na ścieżce „produkcyjnej” są wdrażane u wszystkich użytkowników. Możesz użyć wersji etapowych na ścieżce „produkcyjnej”, aby bezpiecznie wdrożyć wersję najpierw u niewielkiego odsetka użytkowników wersji produkcyjnej, a następnie stopniowo zwiększać ten odsetek w miarę zwiększania zaufania do wersji.

   Użytkownicy w trybie uproszczonym nie mogą umieszczać więcej niż jednego pliku APK w żadnej ścieżce. Użytkownicy w trybie zaawansowanym, którzy korzystają z obsługi wielu plików APK, mogą przesyłać na każdą ścieżkę zero, 1 lub więcej plików APK.

Nazwa ścieżki dla ścieżek dla różnych formatów

Nazwa ścieżki dla danego formatu jest poprzedzona określonym identyfikatorem.

Rodzaj obudowy	Prefiks
System operacyjny Android Automotive	motoryzacja
Wear OS	Wear
Android TV	telewizor

Jak obliczyć nazwę ścieżki w przypadku danego formatu?

Popularne typy ścieżek, takie jak produkcja, testy otwarte i wewnętrzne, mają dobrze znaną nazwę.

Typ śledzenia	Domyślna nazwa ścieżki
Produkcja	produkcja
Testy otwarte	beta
Testy wewnętrzne	qa

Nazwę ścieżki dla danego formatu dla danego formatu można obliczyć w następujący sposób: "[prefix]:defaultTrackName". Na przykład format Wear OS będzie zawierać ścieżki o nazwie: "wear:production", "wear:beta" i "wear:qa".

Ścieżki testów zamkniętych są tworzone ręcznie i mają niestandardowe nazwy. Dlatego ścieżka testu zamkniętego dla formatu o nazwie $name będzie miała nazwę "[prefix]:$name".

Przykładowy przepływ pracy pliku APK

W tej sekcji opisujemy typowy sposób korzystania z interfejsu Tracks API. W tym przypadku zakładamy, że chcesz przesłać nowe wersje pliku APK dla każdej ścieżki i przypisać liczbę użytkowników, którzy otrzymają wersję do wdrażania etapowego. W praktyce deweloper prawdopodobnie nie wykona wszystkich tych działań podczas tej samej operacji. Zamiast tego może zaktualizować wersję beta jednego dnia, utworzyć wersję etapową w wersji produkcyjnej innego dnia itd.

1. Otwórz nową zmianę zgodnie z opisem w sekcji Przepływ pracy zmian.
2. Wywołaj metodę Edits.apks: Upload w przypadku każdego pliku APK, który chcesz przesłać. Przekaż plik APK w treści żądania metody. Plik APK zostanie umieszczony w obszarze przechowywania, ale nie zostanie on opublikowany na ścieżce ani nie zostanie wdrożony. Zwraca kod wersji każdego przesłanego pliku APK. Będziesz go używać do odwoływania się do pliku APK, gdy wydajesz go na ścieżce.

3. Wywołaj metodę Edits.tracks: update w przypadku każdej ścieżki, na której chcesz opublikować pliki APK. W treści żądania przekaż zasób Edits.tracks zawierający wersję, którą chcesz wdrożyć. Aby na przykład opublikować plik APK z kodem wersji 88:

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

   Obecnie pliki APK są nadal niedostępne dla użytkowników. Tak jak w przypadku innych zmian, zostaną one opublikowane dopiero po ich zatwierdzeniu.

4. Wywołaj metodę Edits: Commit, aby zatwierdzić zmiany. Gdy to zrobisz, użytkownicy na każdej ścieżce otrzymają zaktualizowaną wersję pliku APK. (Tak jak w przypadku innych zmian, zastosowanie zmian może potrwać kilka godzin).

Wdrożenia etapowe

Gdy masz nową wersję pliku APK, którą chcesz stopniowo wdrażać, możesz opublikować ją jako wersję „wdrażania etapowego”. Jeśli to zrobisz, Google Play automatycznie wdroży ją u wybranej przez Ciebie części użytkowników aplikacji. Jeśli podczas wdrażania pakietu APK nie występują żadne problemy (np. awarie itp.), możesz zwiększyć odsetek użytkowników, którzy otrzymają tę wersję. W dowolnym momencie możesz wdrożyć ten plik APK jako nową wersję produkcyjną.

W tej sekcji opisano czynności, które musisz wykonać, aby przeprowadzić wdrażanie etapowe pakietu APK, a potem przenieść go do wersji produkcyjnej:

1. Utwórz zmianę zgodnie z opisem w sekcji Przepływ pracy zmian.

2. Prześlij nowy plik APK do zmiany, używając metody Edits.apks: send.

3. Uruchom wersję etapową "inProgress" na ścieżce produkcyjnej za pomocą metody Edits.tracks: update. Wybierz liczbę użytkowników, którzy mają otrzymać nowy plik APK. Na razie pakiet APK nadal nie jest dostępny dla żadnych użytkowników.

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

4. Zatwierdź zmiany w aktywnej zmianie, wywołując metodę Edits: Commit. W ciągu kilku godzin udostępnimy użytkownikom nowy pakiet APK. Wybrana część użytkowników otrzyma nowy plik APK.

W zależności od powodzenia wdrażania etapowego możesz zwiększyć odsetek użytkowników uprawnionych do korzystania z danej wersji lub ją zatrzymać.

Zwiększenie liczby użytkowników we wdrażaniu etapowym

Zakładając, że wdrażanie etapowe wynosi 5%, tak jak to opisano w poprzedniej sekcji, w tej sekcji opisujemy, jak zwiększyć ten odsetek w przypadku, gdy wersja działa dobrze:

1. Utwórz zmianę zgodnie z opisem w sekcji Przepływ pracy zmian.

2. Zmień wersję etapową "inProgress" na ścieżce produkcyjnej za pomocą metody Edits.tracks: update. Zwiększ liczbę użytkowników, którzy powinni otrzymać nowy plik APK:

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

3. Zatwierdź zmiany w aktywnej zmianie, wywołując metodę Edits: Commit. W ciągu kilku godzin udostępnimy użytkownikom nowy pakiet APK. Wybrana część użytkowników otrzyma nowy plik APK.

Zatrzymywanie wdrażania etapowego

Przy założeniu, że wdrażanie etapowe wynosi 5% – tak jak to opisano w poprzedniej sekcji, w tej sekcji znajdziesz informacje o tym, jak zatrzymać wdrażanie etapowe w przypadku wystąpienia problemu:

1. Utwórz zmianę zgodnie z opisem w sekcji Przepływ pracy zmian.

2. Zmień wersję etapową "inProgress" na ścieżce produkcyjnej za pomocą metody Edits.tracks: update. Ustaw stan na "halted".

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

3. Zatwierdź zmiany w aktywnej zmianie, wywołując metodę Edits: Commit. Wersja nie będzie już dostępna dla nowych użytkowników.

Jeśli później zdecydujesz się wznowić zatrzymaną wersję, możesz przywrócić jej stan z powrotem na "inProgress".

Wdrażanie etapowe

Gdy wdrażanie etapowe zakończy się pomyślnie i chcesz udostępnić ją wszystkim użytkownikom, możesz ustawić stan wersji na "completed":

1. Utwórz zmianę zgodnie z opisem w sekcji Przepływ pracy zmian.

2. Zmień wersję etapową "inProgress" na ścieżce produkcyjnej za pomocą metody Edits.tracks: update. Ustaw stan na "completed".

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

3. Zatwierdź zmiany w aktywnej zmianie, wywołując metodę Edits: Commit. W ciągu kilku godzin udostępnimy użytkownikom nowy pakiet APK. Wybrana część użytkowników otrzyma nowy plik APK.

Wersje robocze

Wersje robocze umożliwiają automatyczne przesyłanie plików APK i tworzenie wersji za pomocą interfejsu API, które można później wdrożyć w Konsoli Google Play. Aby utworzyć wersję roboczą na ścieżce:

1. Otwórz nową zmianę zgodnie z opisem w sekcji Przepływ pracy zmian.
2. Wywołaj metodę Edits.apks: Upload w przypadku każdego pliku APK, który chcesz przesłać. Przekaż plik APK w treści żądania metody. Zwraca kod wersji każdego przesłanego pliku APK. Będziesz go używać do odwoływania się do pliku APK podczas przypisywania go do wersji.

3. Wywołaj metodę Edits.tracks: update w przypadku każdej ścieżki, którą chcesz udostępnić. W treści żądania przekaż zasób Edits.tracks zawierający wersję roboczą, którą chcesz utworzyć. Na przykład:

   {
   "releases": [{
     "name": "My draft release",
     "versionCodes": ["88"],
     "status": "draft"
   }]
   }
   

4. Wywołaj metodę Edits: Commit, aby zatwierdzić zmiany. Wersję roboczą możesz teraz sprawdzić i wdrożyć w Konsoli Google Play lub przez interfejs API.

Określanie informacji o wersji

Publikując nową wersję aplikacji, możesz poinformować użytkowników o nowościach, podając informacje o wersji.

Aby to zrobić, użyj pola "releaseNotes" podczas dostarczania zasobu Edits.tracks do metody Edits.tracks: update.

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