Interfejs Google Play Developer API umożliwia przesyłanie nowych plików APK aplikacji i udostępniać je na różnych ścieżkach wydania. Dzięki temu możesz: wdrożyć wersję alfa i beta swojej aplikacji, która jest już dostępna do zatwierdzonych użytkowników. Umożliwia to też wdrożenie wdrażania etapowego. która jest automatycznie udostępniana niewielkiej liczbie do użytkowników aplikacji. Po opublikowaniu wersji możesz stopniowo zwiększać liczbę użytkowników, którzy korzystają z tej wersji aplikacji, aż ostatecznie wdrożysz tę wersję jako wersję produkcyjną wersji.
Dodawanie i modyfikowanie plików APK
Prześlij co najmniej jeden plik APK, wywołując metodę Metoda Edits.apks: send
Ta metoda przesyła plik APK do „zasobnika” pamięci, gdzie może być przypisany do elementu „track”; i wdrożyć je u użytkowników. (Jeśli zmiana to usunięte lub odrzucone, wszystkie pliki APK przesłane do tej zmiany również lost.)
Publikowanie plików APK dla „ścieżek” Połączenie Edits.tracks: update. Możesz zwolnić Pakiety APK na tych ścieżkach:
Ścieżki testów, np.
"alpha"i"beta"Wdrażane są u użytkowników wersje alfa i beta aplikacji. które przypiszesz do grup testów alfa i beta. Ty przypisujesz do tych grup za pomocą Konsoli Google Play.
Ścieżka testu wewnętrznego:
"qa"Wewnętrzne wersje aplikacji są wdrażane na potrzeby testu wewnętrznego zgodnie z konfiguracją w Konsoli Google Play.
Ścieżka produkcyjna:
"production"Wydania „produkcyjne” ścieżka jest wdrażana u wszystkich użytkowników. Ty może wykorzystać wersje etapowe w „produkcji” śledź bezpiecznie najpierw wdróż wersję u niewielkiego odsetka użytkowników produkcyjnych a następnie stopniowo zwiększać ten odsetek, wzbudzając zaufanie a liczba publikacji rośnie.
Użytkownicy w trybie uproszczonym nie powinni umieszczać w żadnym pliku więcej niż 1 pliku APK śledzić. Użytkownicy w trybie zaawansowanym korzystający z wielu plików APK pomocy nie można przesłać zero, jednego 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 ścieżki formatu ma przedrostek określony
| Rodzaj obudowy | Prefiks |
|---|---|
| System operacyjny Android Automotive | motoryzacja |
| Wear OS | Wear |
| Android TV | telewizor |
Jak obliczyć nazwę ścieżki dla danego formatu ścieżki?
popularne typy ścieżek, takie jak produkcyjna, testy otwarte i wewnętrzne; ścieżka testów ma dobrze znaną nazwę ścieżki.
| Typ śledzenia | Domyślna nazwa ścieżki |
|---|---|
| Produkcja | produkcja |
| Testy otwarte | beta |
| Testy wewnętrzne | qa |
Nazwa ścieżki dla danej ścieżki dla danego formatu może być obliczana w ten sposób:
"[prefix]:defaultTrackName"
Na przykład w przypadku formatu Wear OS będą to ścieżki o nazwie:
"wear:production", "wear:beta" i "wear:qa".
Ścieżki testów zamkniętych są tworzone ręcznie i mają niestandardowe
nazw. Zatem ścieżka testu zamkniętego dla formatu $name
będzie miał nazwę ścieżki "[prefix]:$name".
Przykład przepływu pracy APK
W tej sekcji opisano typowy sposób użycia interfejsu Tracks API. W tym przypadku zakładamy, że chcesz przesłać nowe wersje pakietu APK dla każdej ścieżki i przypiszemy wielu użytkowników otrzymuje wersję wdrażaną etapowo. (W praktyce deweloper prawdopodobnie nie wykona wszystkich tych działań podczas tej samej operacji; zamiast być może jednego dnia zaktualizować wersję beta, utworzyć wersję etapową „produkcja” kolejny dzień i tak dalej).
- Otwórz nową zmianę, tak jak to opisano w sekcji Przepływ pracy związany z edytowaniem
- Wywołaj metodę Edits.apks: send każdego pliku APK, który chcesz przesłać. Przekazuj plik APK w żądaniu metody . Plik APK zostanie umieszczony w obszarze przechowywania, ale nie zostanie zwolniony na ścieżce ani wdrożenia). Metoda zwraca kod wersji dla argumentu każdy przesyłany plik APK, będziesz używać tego kodu wersji do skierowania do pliku APK po wydaniu go na ścieżce.
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" }] }Obecnie pliki APK nadal nie są dostępne dla użytkowników. Tak jak inne zmiany nie zostaną opublikowane, dopóki ich nie zatwierdzisz.
Wywołaj metodę Edits: Commit, zatwierdzić zmiany. Gdy to zrobisz, użytkownicy poszczególnych ścieżek będą ze zaktualizowanej wersji pliku APK. (Tak jak w przypadku wszystkich innych zmian, zanim zmiany zaczną obowiązywać, może minąć kilka godzin).
Wdrożenia etapowe
Gdy masz nową wersję pliku APK, którą chcesz stopniowo wdrażać, możesz opublikować ją w ramach „wdrażania etapowego”, wersji. W takim przypadku Google Play automatycznie wdraża ją w odpowiedniej części określonych użytkowników. Jeśli „wdrożenie” Nie ma żadnych problemów z plikiem APK (np. awarii itp.), możesz zwiększyć odsetek użytkowników, którzy otrzymują wersja; gdy wszystko będzie gotowe, możesz wdrożyć ten plik APK jako nową wersję produkcyjną wersji.
W tej sekcji opisano czynności, które należy wykonać, aby wykonać wdrażanie etapowe pakietu APK i przeniesienie go do środowiska produkcyjnego:
Utwórz zmianę w sposób opisany w Przepływie pracy zmian.
Prześlij nowy plik APK do zmiany, używając pliku Metoda Edits.apks: send
Uruchom wersję etapową
"inProgress"na ścieżce produkcyjnej za pomocą Edits.tracks: update. Wybierz odsetek użytkowników, którzy powinni otrzymać nowy plik APK. Obecnie pakiet APK jest ale nadal nie będzie dostępna dla żadnych użytkowników.{ "releases": [{ "versionCodes": ["99"], "userFraction": 0.05, "status": "inProgress" }] }Zatwierdź zmiany w aktywnej edycji, wywołując Zmiany: zatwierdzenie. W ciągu kilku kolejnych godzin, nowy plik APK zostanie wdrożony u użytkowników. Ułamek wybranych użytkowników otrzyma nowy plik APK.
W zależności od powodzenia wdrożenia etapowego możesz zdecydować się na zwiększenie odsetek użytkowników kwalifikujących się do korzystania z danej wersji lub ją zatrzymać.
Zwiększanie odsetka użytkowników we wdrażaniu etapowym
Zakładając, że masz wdrożenie etapowe na poziomie 5%, jak opisano w poprzednim kroku w tej sekcji opisano, jak zwiększyć odsetek w przypadku, gdzie pojawiają się popularne informacje o produkcie:
Utwórz zmianę w sposób opisany w Przepływie pracy zmian.
Zmień wersję etapową
"inProgress"na ścieżce produkcyjnej za pomocą Edits.tracks: update. Zwiększ odsetek użytkowników, którzy powinni otrzymać nowy plik APK:{ "releases": [{ "versionCodes": ["99"], "userFraction": 0.1, "status": "inProgress" }] }Zatwierdź zmiany w aktywnej edycji, wywołując Zmiany: zatwierdzenie. W ciągu kilku kolejnych godzin, nowy plik APK zostanie wdrożony u użytkowników. Ułamek wybranych użytkowników otrzyma nowy plik APK.
Zatrzymywanie wdrażania etapowego
Zakładając, że masz wdrożenie etapowe na poziomie 5%, jak opisano w poprzednim kroku ta sekcja zawiera informacje o tym, jak zatrzymać wdrażanie etapowe w przypadku, gdy możesz wykryć problem:
Utwórz zmianę w sposób opisany w Przepływie pracy zmian.
Zmień wersję etapową
"inProgress"na ścieżce produkcyjnej za pomocą Edits.tracks: update. Ustaw parametr stan na"halted".{ "releases": [{ "versionCodes": ["99"], "status": "halted" }] }Zatwierdź zmiany w aktywnej edycji, wywołując Zmiany: zatwierdzenie. Twoja wersja nie będzie już być dostępna dla nowych użytkowników.
Jeśli później zdecydujesz się wznowić wstrzymaną wersję, możesz to zrobić, ustawiając
jego stan z powrotem na "inProgress".
Wdrażanie etapowe
Jeśli uznasz, że wdrażanie etapowe jest zadowalające i chcesz wdrożyć wersję w środowisku
W przypadku wszystkich użytkowników możesz ustawić stan wersji na "completed":
Utwórz zmianę w sposób opisany w Przepływie pracy zmian.
Zmień wersję etapową
"inProgress"na ścieżce produkcyjnej za pomocą Edits.tracks: update. Ustaw parametr stan na"completed".{ "releases": [{ "versionCodes": ["99"], "status": "completed" }] }Zatwierdź zmiany w aktywnej edycji, wywołując Zmiany: zatwierdzenie. W ciągu kilku kolejnych godzin, nowy plik APK zostanie wdrożony u użytkowników. Ułamek wybranych użytkowników otrzyma nowy plik APK.
Wersje robocze
Wersje robocze umożliwiają automatyczne przesyłanie plików APK i tworzenie wersji za pomocą interfejs API, który można później wdrożyć w Konsoli Google Play. Do utwórz wersję roboczą na ścieżce:
- Otwórz nową zmianę, tak jak to opisano w sekcji Przepływ pracy związany z edytowaniem
- Wywołaj metodę Edits.apks: send 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; użyjesz tego kod wersji, aby odwoływać się do pliku APK podczas przypisywania go do wersji.
Wywołaj metodę Edits.tracks: update. dla każdej ścieżki, na której chcesz opublikować materiał. 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" }] }Wywołaj metodę Edits: Commit, zatwierdzić zmiany. Możesz teraz sprawdzić i wdrożyć wersję roboczą za pomocą Konsoli Google Play lub interfejsu API.
Określanie informacji o wersji
Przy wydawaniu nowej wersji aplikacji możesz podkreślić to, co dla użytkowników, określając informacje o wersji.
Aby to zrobić, użyj pola "releaseNotes" przy podawaniu atrybutu
Zasób Edits.tracks w
Metoda Edits.tracks: update.
{
"releases": [{
"name": "Release with notes",
"versionCodes": ["88"],
"status": "completed",
"releaseNotes": [
{"language": "en-US", "text": "Describe what's new in this release."}
]
}]
}