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 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 będzie automatycznie udostępniana niewielkiej liczbie użytkowników aplikacji. Po opublikowaniu wersji do wdrażania etapowego możesz stopniowo zwiększać liczbę użytkowników korzystających z tej wersji, aż ostatecznie wdrożysz 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 „zasobnika na dane”, gdzie można go przypisać do „ścieżki”, aby wdrożyć go na urządzeniach użytkowników. (W przypadku usunięcia lub odrzucenia wszystkie pliki APK przesłane do 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 grupy testowej alfa i beta. Użytkowników do tych grup przypisuje się 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 wykorzystać wersje etapowe na ścieżce produkcyjnej, aby najpierw bezpiecznie wdrożyć wersję u niewielkiego odsetka użytkowników, a potem stopniowo zwiększać ten odsetek w miarę zwiększania zaufania do wersji.

    Użytkownicy w trybie prostym nie powinni umieszczać w jednej ścieżce więcej niż 1 pliku APK. Użytkownicy trybu zaawansowanego i obsługujący wiele plików APK mogą przesłać 0, 1 lub więcej plików APK na każdą ścieżkę.

Nazwa ścieżki dla ścieżek dla poszczególnych 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 ścieżki testów wewnętrznych, mają dobrze znaną nazwę.

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

Nazwa ścieżki dla danego formatu ścieżki można obliczyć w ten sposób: "[prefix]:defaultTrackName". Na przykład format Wear OS będzie zawierać ś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. Dlatego ścieżka testu zamkniętego formatu o nazwie $name będzie miała nazwę "[prefix]:$name".

Przykład przepływu 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ć pewną liczbę użytkowników, którzy otrzymają wersję do wdrażania etapowego. W praktyce deweloper raczej nie podejmie wszystkich tych działań w ramach tej samej operacji. Zamiast tego wystarczy, że jednego dnia zaktualizujesz wersję beta, utworzysz wersję etapową w wersji produkcyjnej itp.

  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 opublikowany na ścieżce ani nie zostanie wdrożony. Zwraca ona kod wersji dla każdego przesłanego pliku APK, który służy do odwoływania się do pliku APK, gdy wydajesz go na ścieżce.
  3. Wywołaj metodę Edits.tracks: update dla 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"
    }]
    }
    

    Na tę chwilę pliki APK są nadal niedostępne dla użytkowników. Tak jak w przypadku innych zmian, zmiany nie zostaną opublikowane, dopóki ich nie zatwierdzisz.

  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 wszystkich 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 w przypadku „wdrożonego” 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ą.

Ta sekcja zawiera opis czynności, które musisz wykonać, aby przeprowadzić etapowe wdrażanie pliku APK, a następnie przenieść go do ścieżki produkcyjnej:

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

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

  3. Uruchom wersję etapową "inProgress" na ścieżce produkcyjnej, korzystając z metody Edits.tracks: update. Wybierz, ilu użytkowników ma otrzymać nowy plik APK. Obecnie pakiet APK jest nadal niedostę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. Nowy pakiet APK zostanie wdrożony dla użytkowników w ciągu kilku najbliższych godzin. 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, którzy kwalifikują się do danej wersji, lub wstrzymać ją.

Zwiększenie liczby użytkowników na potrzeby wdrażania etapowego

Zakładając, że trwa wdrażanie etapowe na poziomie 5%, jak opisano w poprzedniej sekcji, w tej sekcji znajdziesz informacje o tym, 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, używając 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. Nowy pakiet APK zostanie wdrożony dla użytkowników w ciągu kilku najbliższych godzin. Wybrana część użytkowników otrzyma nowy plik APK.

Zatrzymywanie wdrażania etapowego

Zakładając, że wdrażanie etapowe w Twojej organizacji wynosi 5% (zgodnie z opisem 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, używając 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. Twoja 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 na "inProgress".

Wdrażanie etapowe

Jeśli wdrożenie etapowe jest zadowalające i chcesz udostępnić wersję 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, używając metody Edits.tracks: update. Ustaw stan na "halted".

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

  3. Zatwierdź zmiany w aktywnej zmianie, wywołując metodę Edits: Commit. Nowy pakiet APK zostanie wdrożony dla użytkowników w ciągu kilku najbliższych godzin. Wybrana część użytkowników otrzyma nowy plik APK.

Wersje robocze

Wersje robocze pozwalają 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ą 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 dla każdego przesłanego pliku APK. Służy 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, na której chcesz ją opublikować. 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 zaznaczyć, co jest nowością dla użytkowników, podając informacje o wersji.

Aby to zrobić, użyj pola "releaseNotes" podczas podawania zasobu Edits.tracks w metodzie Edits.tracks: update.

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