Pliki APK i utwory

Interfejs Google Play Developer API umożliwia przesyłanie nowych plików APK aplikacji i publikowanie ich na różnych ścieżkach. Umożliwia to wdrożenie wersji alfa i beta aplikacji, które są udostępniane zatwierdzonym użytkownikom. Umożliwia to też wdrożenie wersji wprowadzanej stopniowo, która jest automatycznie udostępniana niewielkiej liczbie użytkowników aplikacji. Po opublikowaniu wersji w ramach wdrażania etapowego możesz stopniowo zwiększać liczbę użytkowników, którzy otrzymują tę wersję aplikacji, aż w końcu wprowadzisz ją 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 „worka” w magazynie, gdzie można go przypisać do „ścieżki”, aby wdrożyć go do użytkowników. (jeśli zmiana zostanie usunięta lub odrzucona, wszystkie przesłane do niej pakiety APK również zostaną utracone).

2. Publikowanie plików APK na „ścieżkach” przez wywołanie Edits.tracks: update. Pliki APK możesz publikować na tych ścieżkach:

   • Ścieżki testów, takie jak "alpha" i "beta"

     Wersje alfa i beta aplikacji są udostępniane użytkownikom przypisanym do grup testów alfa i beta. Użytkowników przypisujesz do tych grup w Konsoli Google Play.

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

     Wersje wewnętrzne aplikacji są wdrażane na ścieżkę testów wewnętrznych zgodnie z konfiguracją w Konsoli Google Play.

   • Ścieżka produkcyjna: "production"

     Wersje na ścieżce „produkcyjnej” są wdrażane dla wszystkich użytkowników. Możesz korzystać z wersji etapowych na ścieżce „produkcja”, aby bezpiecznie wdrożyć wersję najpierw w przypadku niewielkiego odsetka użytkowników produkcyjnych, a potem stopniowo zwiększać ten odsetek, gdy Twoja pewność co do wersji będzie rosła.

   Użytkownicy korzystający z trybu uproszczonego nie powinni umieszczać więcej niż 1 pliku APK na dowolnej ścieżce. Użytkownicy korzystający z trybu zaawansowanego i korzystający z obsługi wielu plików APK mogą przesłać na każdą ścieżkę 0, 1 lub więcej plików APK.

Nazwa ścieżki dla ścieżek formatu

Nazwa utworu w formacie ścieżki jest poprzedzona określonym identyfikatorem.

Format	Prefiks
System operacyjny Android Automotive	motoryzacja
Wear OS	Wear
Android TV	telewizor
Android XR	android_xr
Gry Google Play na PC	google_play_games_pc

Jak obliczyć nazwę utworu dla danego formatu?

Typy ścieżek, takie jak ścieżka produkcyjna, ścieżka testu otwartego i ścieżka testu wewnętrznego, mają dobrze znane nazwy.

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

Nazwa ścieżki dla danego formatu może być obliczona jako: "[prefix]:defaultTrackName". Na przykład format Wear OS będzie miał ścieżki o nazwach "wear:production", "wear:beta" i "wear:qa".

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

Przykładowy przepływ pracy dotyczący pliku APK

W tej sekcji opisujemy typowe sposoby korzystania z interfejsu Tracks API. W tym przypadku załóżmy, że chcesz przesłać nowe wersje pliku APK dla każdej ścieżki i przypisać określoną liczbę użytkowników do wersji wdrażanej etapami. (W praktyce deweloper prawdopodobnie nie wykona wszystkich tych czynności w ramach jednej operacji. Zamiast tego możesz zaktualizować wersję beta jednego dnia, a następnego dnia utworzyć wersję etapową na potrzeby „produkcji” itd.).

1. Otwórz nową edycję zgodnie z instrukcjami podanymi w sekcji Przepływ pracy dotyczący edycji.
2. Wywołaj metodę Edits.apks: upload dla każdego pliku APK, który chcesz przesłać. Przekaż plik APK w ciele żądania metody. (pozwala to umieścić plik APK w obszarze pamięci, ale nie publikuje go na ścieżce ani nie wdraża). Metoda zwraca kod wersji dla każdego przesłanego pliku APK. Użyjesz tego kodu, aby odwoływać się do pliku APK podczas publikowania go na ścieżce.

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

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

   W tej chwili pliki APK nie są jeszcze dostępne dla użytkowników. Podobnie jak w przypadku innych zmian, nie zostaną one opublikowane, dopóki ich nie zatwierdzisz.

4. Aby zatwierdzić zmiany, wywołaj metodę Edits: commit. Po wykonaniu tej czynności użytkownicy na każdej ścieżce otrzymają zaktualizowaną wersję pliku APK. (jak w przypadku wszystkich zmian, zatwierdzenie może potrwać kilka godzin).

Wdrażanie etapowe

Gdy masz nową wersję pliku APK, którą chcesz wdrożyć stopniowo, możesz ją wydać jako wersję „wdrożenia etapowego”. W takim przypadku Google Play automatycznie wdroży ją wśród wybranej przez Ciebie części użytkowników aplikacji. Jeśli w pliku APK „wdrożeniowym” nie występują żadne problemy (np. awarie), możesz zwiększyć liczbę użytkowników, którzy otrzymają tę wersję. Gdy będziesz gotowy, możesz wdrożyć ten plik APK jako nową wersję produkcyjną.

W tej sekcji opisano czynności, które należy wykonać, aby przeprowadzić etapowe wdrożenie pliku APK, a potem przenieść go do wersji produkcyjnej:

1. Utwórz zmianę zgodnie z opisem w procesie wprowadzania zmian.

2. Prześlij nowy plik APK do wersji z modyfikacjami, używając metody Edits.apks: upload (Prześlij plik APK).

3. Uruchom wdrażanie etapowe wersji "inProgress" na ścieżce produkcyjnej, używając metody Edits.tracks: update. Wybierz ułamek użytkowników, którzy mają otrzymać nowy plik APK. W tej chwili plik APK jest nadal niedostępny dla użytkowników końcowych.

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

4. Zatwierdź zmiany w aktywnej edycji, wywołując funkcję Edits: commit. W ciągu najbliższych kilku godzin nowy plik APK zostanie udostępniony użytkownikom. Wybrana część użytkowników otrzyma nowy plik APK.

W zależności od tego, jak przebiegnie wdrażanie etapowe, możesz zwiększyć odsetek użytkowników kwalifikujących się do tej wersji lub wstrzymać jej wdrażanie.

Zwiększanie odsetka użytkowników w ramach wdrażania etapowego

Załóżmy, że wdrażasz wersję w etapach w 5% użytkowników, jak opisano w poprzedniej sekcji. W tej sekcji dowiesz się, jak zwiększyć ten odsetek, jeśli wdrażanie przebiega pomyślnie:

1. Utwórz zmianę zgodnie z opisem w artykule Procedura wprowadzania zmian.

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

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

3. Zatwierdź zmiany w aktywnej edycji, wywołując funkcję Edits: commit. W ciągu najbliższych kilku godzin nowy plik APK zostanie udostępniony użytkownikom. Wybrana część użytkowników otrzyma nowy plik APK.

Zatrzymywanie wdrażania etapowego

Załóżmy, że masz w trakcie wdrażanie etapowe na poziomie 5%, jak opisano w poprzedniej sekcji. W tej sekcji dowiesz się, jak wstrzymać wdrażanie etapowe, jeśli wykryjesz problem:

1. Utwórz zmianę zgodnie z opisem w artykule Procedura wprowadzania 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 edycji, wywołując funkcję 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 to zrobić, przywracając jej stan do "inProgress".

Zakończenie wdrażania etapowego

Gdy uznasz, że wdrożono wersję etapowo i chcesz udostępnić ją wszystkim użytkownikom, możesz ustawić stan wersji na "completed":

1. Utwórz zmianę zgodnie z opisem w artykule Procedura wprowadzania 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 edycji, wywołując funkcję Edits: commit. W ciągu najbliższych kilku godzin nowy plik APK zostanie udostępniony użytkownikom. Wybrana część użytkowników otrzyma nowy plik APK.

Wersje robocze

Wersje robocze umożliwiają automatyczne przesyłanie pakietó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ą edycję zgodnie z instrukcjami podanymi w sekcji Przepływ pracy dotyczący edycji.
2. Wywołaj metodę Edits.apks: upload dla każdego pliku APK, który chcesz przesłać. Przekaż pakiet APK w treści żądania metody. Ta metoda zwraca kod wersji dla każdego przesłanego pliku APK. Użyjesz tego kodu, aby odwoływać się do pliku APK podczas przypisywania go do wersji.

3. W przypadku każdej ścieżki, którą chcesz opublikować, wywołaj metodę Edits.tracks: update. W treści żądania prześlij 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. Aby zatwierdzić zmiany, wywołaj metodę Edits: commit. Wersję roboczą można teraz sprawdzić i wdrożyć za pomocą Konsoli Google Play lub interfejsu API.

Określanie informacji o wersji

Podczas publikowania nowej wersji aplikacji możesz wyróżnić nowe funkcje, które będą dostępne dla użytkowników, podając informacje o tej wersji.

Aby to zrobić, użyj pola "releaseNotes" podczas przekazywania 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."}
      ]
  }]
}