Pliki APK i utwory

Interfejs Google Play Developer API umożliwia przesyłanie nowych plików APK dla aplikacji i publikowanie ich na różnych ścieżkach wersji. Dzięki temu możesz wdrożyć wersje alfa i beta aplikacji, które są dostępne dla zatwierdzonych użytkowników. Pozwala to też wdrożyć wersję 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 mają dostęp do tej wersji, dopóki jej nie wdrożysz jako wersja „produkcyjna”.

Dodawanie i modyfikowanie plików APK

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

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

  2. Zwolnij pliki APK w przypadku ścieżek audio, wywołując metodę Edits.tracks: update. Pliki APK możesz opublikować na tych ścieżkach:

    • Ścieżki testów, takie 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. Możesz przypisać użytkowników do tych grup za pomocą Konsoli Google Play.

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

      Wewnętrzne wersje Twojej aplikacji są wdrażane na ścieżce testu wewnętrznego w Konsoli Google Play.

    • Ścieżka produkcyjna: "production"

      Wersje na ścieżce „produkcyjnej” są wdrażane dla wszystkich użytkowników. Możesz używać wersji etapowych na ścieżce „produkcyjnej”, aby bezpiecznie wdrożyć wersję na niewielkim odsetku użytkowników produkcyjnych, a następnie stopniowo ją zwiększać w miarę wzrostu zaufania do wersji.

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

Nazwa ścieżki w przypadku ścieżek do formularza

Nazwa ścieżki tego współczynnika jest poprzedzona konkretnym identyfikatorem.

Format Prefiks
System operacyjny Android Automotive motoryzacja
Wear OS Wear

Jak obliczyć nazwę ścieżki z danym współczynnikiem formularza?

Typowe rodzaje ścieżek, takie jak ścieżka produkcyjna, testy otwarte i testy wewnętrzne, mają dobrze znaną nazwę.

Typ śledzenia Domyślna nazwa utworu
Produkcja produkcja
Testy otwarte beta
Test wewnętrzny qa

Nazwa ścieżki z danego formatu urządzenia może być obliczana tak: "[prefix]:defaultTrackName". Na przykład format urządzenia z Wear OS ma utwory o nazwie: "wear:production", "wear:beta" i "wear:qa".

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

Przykład przepływu pracy w pliku APK

W tej sekcji opisujemy typowy interfejs API. W takim przypadku zakładamy, że chcesz przesłać nowe wersje pakietu APK dla każdej ścieżki i przypisać określoną liczbę użytkowników, by otrzymać wersję wdrażaną etapowo. W praktyce programista raczej nie będzie wykonywać tych wszystkich czynności w ramach tej samej operacji – zamiast tego możesz jednego dnia zaktualizować wersję beta, utworzyć wersję etapową w wersji „produkcyjnej” 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ć. Prześlij plik APK w treści żądania metody. Spowoduje to umieszczenie pakietu APK w pamięci masowej, ale nie zostanie on wdrożony na ścieżce ani wdrożony. Metoda zwraca kod wersji każdego przesłanego pliku APK. Ten kod wersji będzie służyć do odwołania do pliku APK, gdy opublikujesz go na ścieżce.

  3. Wywołaj metodę Edits.tracks: update dla każdego utworu, który chcesz opublikować pliki APK. W treści żądania prześlij 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"
}]
}

    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. Aby zastosować zmiany, wywołaj metodę Zmiany: zatwierdzenie. Gdy to zrobisz, użytkownikom każdej ścieżki zostanie udostępniona zaktualizowana wersja pliku APK. (Podobnie jak w przypadku wszystkich zmian, zastosowanie zmian może potrwać kilka godzin).

Wdrażanie etapowe

Jeśli masz nową wersję pliku APK, którą chcesz stopniowo wdrażać, możesz opublikować ją w wersji „wdrażania etapowego”. Jeśli to zrobisz, Google Play automatycznie wprowadzi ją do wybranych przez Ciebie użytkowników aplikacji. Jeśli w pliku APK do wdrożenia nie występują żadne problemy (takie jak awarie), możesz zwiększyć odsetek użytkowników, którzy otrzymają tę wersję. Gdy wszystko będzie gotowe, możesz wdrożyć plik APK jako nową wersję produkcyjną.

W tej sekcji opisano czynności, które należy wykonać, aby wykonać wdrażanie etapowe pakietu APK, a następnie promować go do środowiska produkcyjnego:

  1. Utwórz zmianę zgodnie z opisem w sekcji Zmiany w przepływie pracy.

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

  3. Rozpocznij 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 pakiet APK jest nadal niedostępny dla 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 najbliższych kilku godzin udostępnimy nowy pakiet APK użytkownikom. Część wybranych przez Ciebie użytkowników otrzyma nowy plik APK.

W zależności od powodzenia wdrażania etapowego możesz podnieść odsetek użytkowników, którzy kwalifikują się do korzystania z tej wersji lub ją zatrzymać.

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

Zakładając, że etap wdrażania wynosi obecnie 5%, tak jak to opisaliśmy 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 sekcji Zmiany w przepływie pracy.

  2. Zmodyfikuj wersję etapową "inProgress" na ścieżce produkcyjnej za pomocą metody Edits.tracks: update. Zwiększ odsetek 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 najbliższych kilku godzin udostępnimy nowy pakiet APK użytkownikom. Część wybranych przez Ciebie użytkowników otrzyma nowy plik APK.

Zatrzymywanie wdrażania etapowego

Przy założeniu, że masz etapowe wdrożenie etapowe na poziomie 5%, tak jak w poprzedniej sekcji dowiesz się, jak zatrzymać wdrażanie etapowe w razie wystąpienia problemu:

  1. Utwórz zmianę zgodnie z opisem w sekcji Zmiany w przepływie pracy.

  2. Zmodyfikuj 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 wdrażanie etapowe jest zadowalające i chcesz wdrożyć wersję dla wszystkich użytkowników, możesz ustawić jej stan na "completed":

  1. Utwórz zmianę zgodnie z opisem w sekcji Zmiany w przepływie pracy.

  2. Zmodyfikuj 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 najbliższych kilku godzin udostępnimy nowy pakiet 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 później można wdrożyć w Konsoli Google Play. Aby utworzyć wersję roboczą ścieżki:

  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ć. Prześlij pakiet APK w treści żądania. Metoda zwraca kod wersji każdego przesłanego pliku APK. Ten kod wersji będzie służyć do odwołania do pliku APK, gdy go przypiszesz do wersji.

  3. Wywołaj metodę Edits.tracks: update dla każdego utworu, który chcesz opublikować. 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 zastosować zmiany, wywołaj metodę Zmiany: zatwierdzenie. Wersję roboczą możesz sprawdzić i wdrożyć za pomocą Konsoli Google Play lub interfejsu API.

Określanie informacji o wersji

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

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