Pliki APK i utwory

Interfejs Google Play Developer API umożliwia przesyłanie nowych plików APK na aplikacje i udostępnianie ich na różnych ścieżkach wersji. Pozwala to wdrożyć wersje alfa i beta aplikacji, które są dostępne dla zatwierdzonych użytkowników. Umożliwia to również wdrażanie wersji wdrażania etapowego, która jest automatycznie udostępniana niewielkiej liczbie użytkowników aplikacji. Po opublikowaniu wersji etapowej możesz stopniowo zwiększać liczbę użytkowników, którzy otrzymują tę wersję, dopóki nie wdrożysz wersji jako „"production"”.

Dodawanie i modyfikowanie plików APK

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

   Ta metoda powoduje przesłanie pliku APK do pamięci i zasobnika, w którym można go przypisać do &ścieżki, aby wdrożyć go u użytkowników. (Jeśli zmiana została usunięta lub została odrzucona, wszystkie zapisane na niej pliki APK zostaną utracone).

2. Wycofaj pliki APK na stronie "tracks", wywołując plik Edits.tracks: update. Pliki APK możesz publikować na tych ścieżkach:

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

     Wersje alfa i beta aplikacji są wdrażane na kontach użytkowników przypisanych do grup testowych w wersji alfa i beta. Użytkownicy są przypisywani do tych grup w Konsoli Google Play.

   • Ścieżka testów wewnętrznych: "internal"

     Wewnętrzne wersje aplikacji są wdrażane na ścieżce testów wewnętrznych skonfigurowanej w Konsoli Google Play.

   • Ścieżka produkcyjna: "production"

     Wersje „&&tt;production"” są wdrożone dla wszystkich użytkowników. Możesz go używać, aby bezpiecznie wdrożyć wersję na niewielkim odsetku użytkowników wersji produkcyjnej, a potem ją zwiększać w miarę zaufania.

   W trybie prostym użytkownicy nie powinni umieszczać na jednej ścieżce więcej niż 1 pakietu APK. Użytkownicy w trybie zaawansowanym z obsługą wielu plików APK mogą przesłać 1 lub więcej plików APK na każdą ścieżkę.

Przykład przepływu pracy w pliku APK

Ta sekcja zawiera opis typowego wykorzystania interfejsu Paths 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, aby otrzymać wersję wdrażaną etapowo. W rzeczywistości raczej nie wykonują tych samych działań w ramach tej samej operacji. Zamiast tego jednego dnia możesz zaktualizować wersję beta, utworzyć wersję etapową w innym dniu itd.).

1. Otwórz nową zmianę zgodnie z opisem w sekcji Przepływ pracy zmian
2. Wywołaj metodę Edits.apks: upload dla każdego pliku APK, który chcesz przesłać. Umieść plik APK w treści żądania metody. Pakiet APK zostanie umieszczony w obszarze pamięci, ale nie zostanie udostępniony na ścieżce ani wdrożony. Metoda zwraca kod wersji w przypadku każdego przesłanego pliku APK. Będzie on służyć do odwołania się do pliku APK w przypadku ścieżki.

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

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

   W tej chwili pliki APK są nadal niedostępne dla użytkowników. Tak jak w przypadku innych modyfikacji, nie zostaną one wprowadzone, dopóki ich nie zatwierdzisz.

4. Wywołaj metodę Zmiany: zatwierdzenie, aby zatwierdzić zmiany. Gdy to zrobisz, użytkownicy poszczególnych ścieżek otrzymają zaktualizowaną wersję pliku APK. Tak jak w przypadku wszystkich innych zmian, może minąć kilka godzin, zanim zmiany zaczną obowiązywać.

Wdrożenia etapowe

Gdy masz nową wersję pliku APK, którą chcesz wdrażać stopniowo, możesz ją opublikować jako wersję {0}wdrażaną etapowo. W takim przypadku Google Play automatycznie wdraża ją we wskazanym przez Ciebie segmencie użytkowników aplikacji. Jeśli &pakiet SDK nie zawiera żadnych problemów (np. awarii) itp., możesz zwiększyć odsetek użytkowników, którzy otrzymają daną wersję. W razie potrzeby możesz wdrożyć ten plik APK jako nową wersję produkcyjną.

W tej sekcji opisujemy czynności wykonywane w celu wdrożenia etapowego pliku APK, a następnie promowania go na ścieżce produkcyjnej:

1. Utwórz zmianę zgodnie z opisem w artykule Zmiany w Przepływie pracy.

2. Prześlij nowy plik APK do zmiany, korzystając z metody Edits.apks: upload.

3. Uruchom wersję etapową "inProgress" na ścieżce produkcyjnej za pomocą metody Edits.tracks: update. Wybierz odsetek użytkowników, którzy powinni otrzymać nowy plik APK. Obecnie plik APK jest nadal niedostępny dla żadnych użytkowników.

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

4. Aby zatwierdzić zmiany w aktywnej edycji, wywołaj metodę Zmiany: zatwierdzenie. W ciągu kilku najbliższych godzin udostępnimy nowy plik APK użytkownikom. Część wybranych przez Ciebie użytkowników otrzyma nowy plik APK.

W zależności od sukcesu wdrożenia etapowego możesz zwiększyć odsetek użytkowników uprawnionych do tej wersji lub ją zatrzymać.

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

Zakładając, że trwa wdrażanie etapowe na poziomie 5%, jak opisano w poprzedniej sekcji, dowiesz się, jak zwiększyć tę wartość w przypadku, gdy wersja działa dobrze:

1. Utwórz zmianę zgodnie z opisem w artykule Zmiany w Przepływie pracy.

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

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

3. Aby zatwierdzić zmiany w aktywnej edycji, wywołaj metodę Zmiany: zatwierdzenie. W ciągu kilku najbliższych godzin udostępnimy nowy plik APK użytkownikom. Część wybranych przez Ciebie użytkowników otrzyma nowy plik APK.

Zatrzymywanie wdrażania etapowego

Zakładając, że trwające wdrażanie etapowe jest ustawione na 5%, jak opisano w poprzedniej sekcji, w tej sekcji znajdziesz informacje o tym, jak zatrzymać wdrażanie etapowe w przypadku wykrycia problemu:

1. Utwórz zmianę zgodnie z opisem w artykule Zmiany w Przepływie pracy.

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. Aby zatwierdzić zmiany w aktywnej edycji, wywołaj metodę Zmiany: zatwierdzenie. Nowa wersja nie będzie już dostępna dla nowych użytkowników.

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

Kończenie wdrażania etapowego

Jeśli etap wdrożenia jest zadowolony i chcesz wdrożyć go dla wszystkich użytkowników, możesz ustawić stan wersji na "completed":

1. Utwórz zmianę zgodnie z opisem w artykule Zmiany w Przepływie pracy.

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

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

3. Aby zatwierdzić zmiany w aktywnej edycji, wywołaj metodę Zmiany: zatwierdzenie. W ciągu kilku najbliższych godzin udostępnimy nowy plik APK użytkownikom. Część wybranych przez Ciebie użytkowników otrzyma nowy plik APK.

Wersje robocze

Dzięki wersjom roboczym możesz automatycznie przesyłać pliki APK i tworzyć wersje za pomocą interfejsu API, które można później wdrożyć w Konsoli Google Play. Aby utworzyć wersję roboczą wersji na ścieżce:

1. Otwórz nową zmianę zgodnie z opisem w sekcji Przepływ pracy zmian
2. Wywołaj metodę Edits.apks: upload dla każdego pliku APK, który chcesz przesłać. Umieść plik APK w treści żądania metody. Metoda zwraca kod wersji w przypadku każdego przesłanego pliku APK. Będzie on służyć do odwoływania się do pliku APK podczas jego przypisywania do wersji.

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

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

4. Wywołaj metodę Zmiany: zatwierdzenie, aby zatwierdzić zmiany. Możesz ją sprawdzić i wdrożyć za pomocą Konsoli Google Play lub interfejsu API.

Określanie informacji o wersji

Umieszczając nową wersję aplikacji, możesz wyróżnić użytkowników, określając informacje o wersji.

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