Jak opublikować aplikację w Google Play – konto, testy i wymagania

· Programowanie

Aplikacja działająca na własnym telefonie to dopiero połowa pracy. Kto pierwszy raz sprawdza, jak opublikować aplikację w Google Play, szybko się przekonuje, że samo przesłanie pliku nie wystarczy. Potrzebne są zweryfikowane konto dewelopera, podpisany plik AAB, testy, wypełnione formularze w Play Console i weryfikacja wersji produkcyjnej. Przy nowych kontach osobistych dochodzi jeszcze obowiązkowy okres testów z udziałem innych osób.

Opóźnienia i odrzucenia rzadko wynikają z błędów w kodzie. Częściej chodzi o formalności, takie jak deklaracja bezpieczeństwa danych niezgodna z działaniem aplikacji, brak polityki prywatności albo zbyt niski docelowy poziom API. Część decyzji, np. wybór identyfikatora pakietu, zostaje z aplikacją na zawsze. Dlatego całość warto przygotować, zanim wyślesz do Google Play pierwszą wersję aplikacji.

Jak opublikować aplikację w Google Play – etapy od konta do wdrożenia

Publikacja aplikacji w Google Play przebiega w stałej kolejności, a każdy etap zależy od poprzedniego. Bez zweryfikowanego konta nie prześlesz paczki. Bez zakończonych testów nowe konto osobiste nie uzyska dostępu do produkcji, a bez kompletnych formularzy wersji nie da się wysłać do sprawdzenia.

  1. Konto dewelopera w Play Console, czyli rejestracja, opłata i weryfikacja tożsamości, która nie zawsze kończy się od razu.
  2. Podpisany plik AAB w wariancie release, z ustawionym identyfikatorem pakietu, numerem wersji i docelowym poziomem API.
  3. Testy na jednej ze ścieżek testowych, a przy nowym koncie osobistym obowiązkowy test zamknięty.
  4. Karta sklepu i formularze, w tym opisy, grafiki, deklaracja bezpieczeństwa danych, polityka prywatności i klasyfikacja treści.
  5. Wersja produkcyjna, którą przesyłasz, czekasz na jej weryfikację i wdrażasz.

Napisanie i przetestowanie kodu, czyli to, od czego zaczyna się tworzenie aplikacji na Androida, to tylko część techniczna. Przy publikacji aplikacji w Google Play sprawdzany jest też opis, deklaracje dotyczące danych i uzasadnienie uprawnień. Dopiero wszystkie te elementy razem pozwalają przejść weryfikację.

Formalności związane z publikacją aplikacji w Google Play zajmują sporo czasu, dlatego dobrze jest prowadzić je równolegle. Gdy czekasz na weryfikację konta, możesz przygotować politykę prywatności, zrzuty ekranu i opisy. Warto też już wtedy zebrać osoby do testów. Dzięki temu po zakończeniu testów wysyłasz kompletną wersję zamiast uzupełniać braki po pierwszym odrzuceniu.

Konto dewelopera w Play Console – osobiste czy organizacji

Publikowanie aplikacji w Google Play zaczynasz od rejestracji w Google Play Console. Logujesz się kontem Google, akceptujesz umowę dla deweloperów i wypełniasz formularz rejestracyjny. Lepiej nie używać do tego prywatnej skrzynki, tylko założyć osobny adres e-mail przeznaczony wyłącznie do publikacji.

Taki adres porządkuje korespondencję z Google. Powiadomienia o weryfikacji, odrzuconych wersjach czy zmianach zasad nie giną wtedy wśród prywatnych wiadomości. W razie potrzeby możesz też przekazać dostęp innej osobie bez ujawniania własnej poczty.

Wybór typu konta

Przy rejestracji wybierasz typ konta. Od tej decyzji zależą wymagane dane i dokumenty.

  • Konto osobiste jest przeznaczone dla osób prywatnych. Weryfikacja opiera się na danych i dokumencie tożsamości właściciela.
  • Konto organizacji jest przeznaczone dla firm i instytucji. Wymaga m.in. numeru D-U-N-S, który trzeba uzyskać wcześniej, jeśli firma go jeszcze nie ma. Oczekiwanie na ten numer może przesunąć cały harmonogram, dlatego warto się nim zająć na samym początku.

W sklepie obok aplikacji widać nazwę dewelopera podaną przy rejestracji. Przy koncie osobistym może to być np. imię i nazwisko, a przy koncie organizacji zwykle nazwa firmy.

Weryfikacja, opłata i dane widoczne w sklepie

Rejestracja wiąże się z jednorazową opłatą oraz weryfikacją tożsamości. Kwota, lista akceptowanych dokumentów i kolejność kroków bywają zmieniane. Przed rozpoczęciem sprawdź je więc bezpośrednio w Play Console, a nie w starszych poradnikach.

W tym samym miejscu podajesz dane kontaktowe dewelopera. Część z nich trafia na kartę aplikacji i jest widoczna publicznie. Chodzi o adres e-mail, stronę WWW, a w niektórych przypadkach także adres fizyczny.

Plik AAB i podpisywanie w Play App Signing

Nowe aplikacje trafiają do Google Play w formacie Android App Bundle (AAB), a nie jako gotowy plik APK. Paczka AAB zawiera skompilowany kod i wszystkie zasoby, a sklep sam generuje z niej wersje dopasowane do konkretnego urządzenia, m.in. do gęstości ekranu, architektury procesora i języka systemu. Użytkownik pobiera więc tylko to, czego jego telefon potrzebuje, a nie grafiki i biblioteki przeznaczone dla wszystkich modeli naraz. Dzięki temu plik do pobrania jest mniejszy, a instalacja szybsza.

Tworzenie paczki w Android Studio

  1. Wybierz z menu Build → Generate Signed App Bundle / APK.
  2. Zaznacz opcję Android App Bundle.
  3. Wskaż istniejący magazyn kluczy (keystore) albo utwórz nowy, podając hasło do magazynu, alias klucza i hasło do klucza.
  4. Wybierz wariant release i zatwierdź. Gotowy plik z rozszerzeniem .aab pojawi się w folderze wyjściowym projektu.

Dwa klucze w Play App Signing

Podpisywaniem zarządza program Play App Signing, w którym działają dwa różne klucze. Klucz podpisywania aplikacji przechowuje Google i to nim podpisywane są pliki instalowane na telefonach użytkowników. Klucz przesyłania zostaje u Ciebie i służy tylko do podpisywania paczek wysyłanych do Play Console, aby sklep mógł potwierdzić, że pochodzą od właściciela konta.

Taki podział chroni aplikację. Zgubienie lub wyciek klucza przesyłania nie przekreśla jej dalszego rozwoju, bo przez Play Console można zgłosić reset i zarejestrować nowy klucz. Do czasu zatwierdzenia zmiany przez Google nie wyślesz jednak żadnej aktualizacji.

Ustawienia w build.gradle, które trzeba sprawdzić przed wysłaniem

Ustawienia, które Google sprawdza przy przesyłaniu paczki, znajdują się w pliku build.gradle modułu aplikacji, zwykle w bloku defaultConfig. W nowszych projektach, zarówno w build.gradle, jak i w build.gradle.kts, te same parametry mają często krótsze nazwy, np. targetSdk zamiast targetSdkVersion. Znaczenie pozostaje takie samo.

Zbliżenie ekranu laptopa z kolorowym kodem źródłowym w edytorze z numerami linii
Przed wysłaniem paczki warto przejrzeć konfigurację projektu, w tym numer wersji i docelowe API. Zdjęcie: fancycrave1 / Pixabay

targetSdkVersion, czyli docelowy poziom API

Ten parametr informuje system, pod którą wersję Androida aplikacja została przygotowana i przetestowana. Google regularnie podnosi minimalny wymagany poziom zarówno dla nowych aplikacji, jak i dla aktualizacji. Paczka z poziomem poniżej progu zostanie odrzucona już przy przesyłaniu. Aktualne minimum sprawdź w Play Console albo w dokumentacji dla deweloperów.

Podniesienie docelowego API to nie tylko zmiana liczby. Nowsze wersje systemu wprowadzają inne zasady dotyczące uprawnień, powiadomień czy pracy w tle. Po zmianie przetestuj więc najważniejsze funkcje aplikacji na urządzeniu lub emulatorze z najnowszym Androidem.

applicationId, czyli identyfikator pakietu

applicationId, np. com.nazwa.aplikacja, jednoznacznie identyfikuje aplikację w sklepie i na telefonie. Po publikacji nie można go zmienić. Przyjęło się zapisywać go jako odwróconą nazwę domeny, małymi literami, bez spacji i polskich znaków. Lepiej unikać członów typu test czy demo, które po publikacji zostaną z aplikacją na stałe.

versionCode przy każdej wersji

versionCode to liczba całkowita, którą Play Console wykorzystuje do porządkowania wydań. Każda przesłana paczka musi mieć wyższy numer niż poprzednia, a plik z numerem użytym wcześniej, także na ścieżce testowej, zostanie odrzucony. Użytkownicy widzą natomiast versionName, np. 1.2.0, który ma charakter informacyjny.

Zwiększaj versionCode przed każdym zbudowaniem paczki do wysyłki. Unikniesz w ten sposób ponownego budowania pliku tylko dlatego, że numer się powtórzył.

Testy wewnętrzne, zamknięte i otwarte przed publikacją

Zanim aplikacja trafi do wszystkich użytkowników, można ją sprawdzić na jednej z trzech ścieżek testowych w Play Console. Różnią się zasięgiem, sposobem zapraszania testerów i tempem udostępniania kolejnych wersji.

Rodzaje ścieżek testowych

  • Test wewnętrzny służy do szybkiej kontroli w małym gronie, np. w zespole lub wśród znajomych. Testerów dodajesz po adresach e-mail, a nowa wersja jest zwykle dostępna niemal od razu po przesłaniu.
  • Test zamknięty obejmuje osoby zaproszone przez listę adresów e-mail albo grupę Google. Sprawdza się, gdy chcesz zebrać opinie od wybranych użytkowników.
  • Test otwarty jest dostępny przez publiczny link i może do niego dołączyć praktycznie każdy. Daje największy zasięg, ale opinie są mniej przewidywalne.

Tester akceptuje zaproszenie w przeglądarce, a potem instaluje aplikację ze sklepu jak każdą inną. Dzięki temu sprawdzasz nie tylko działanie funkcji, lecz także sam proces instalacji i aktualizacji w warunkach zbliżonych do docelowych.

Po wysłaniu wersji na dowolną ścieżkę testową Google automatycznie przygotowuje raport przed publikacją. Aplikacja jest uruchamiana na różnych urządzeniach, a raport pokazuje awarie, zrzuty ekranu i problemy z wyświetlaniem, np. ucięte przyciski na ekranach o nietypowych proporcjach.

Wymóg testu zamkniętego dla nowych kont osobistych

Nowe konta osobiste muszą przeprowadzić test zamknięty, zanim uzyskają dostęp do ścieżki produkcyjnej. Google określa minimalną liczbę testerów i minimalny czas trwania testu. Te progi były już zmieniane, dlatego aktualne wartości sprawdź w Play Console przed rozpoczęciem testu.

Zbierz testerów z zapasem. Jeśli ktoś zrezygnuje w trakcie i liczba uczestników spadnie poniżej progu, wymagany okres testów może nie zostać zaliczony.

Karta sklepu i formularze zawartości aplikacji

Karta sklepu głównego

Kartę uzupełnia się w Play Console w sekcji Wzrost → Karta sklepu głównego. To pierwsze, co zobaczy użytkownik, dlatego warto przygotować teksty i grafiki przed wysłaniem wersji do weryfikacji. Potrzebne są:

  • nazwa aplikacji – do 30 znaków,
  • krótki opis – do 80 znaków, widoczny od razu pod nazwą,
  • pełny opis – do 4000 znaków,
  • ikona – 512 × 512 px,
  • grafika promocyjna – 1024 × 500 px,
  • zrzuty ekranu pokazujące najważniejsze funkcje.

Opisy muszą odpowiadać temu, co aplikacja faktycznie robi. Listy słów kluczowych, nazwy cudzych marek i obietnice bez pokrycia, np. „przyspiesza telefon o połowę”, łatwo kończą się odrzuceniem. Lepiej w kilku zdaniach opisać, jaki problem rozwiązuje aplikacja i dla kogo jest przeznaczona.

Sekcja Zawartość aplikacji

Formularze w sekcji Zawartość aplikacji to etap, przy którym publikacja w Google Play najczęściej się opóźnia. Najwięcej uwagi wymaga formularz bezpieczeństwa danych. Deklaracja musi odpowiadać temu, co aplikacja rzeczywiście zbiera i komu to przekazuje, także za pośrednictwem dołączonych bibliotek do analityki, reklam czy raportowania awarii.

Polityka prywatności musi być dostępna pod publicznym adresem URL. Plik PDF albo dokument wymagający logowania nie spełnia tego wymogu.

Pozostałe formularze dotyczą:

  • klasyfikacji treści – na podstawie kwestionariusza,
  • grupy docelowej – w tym tego, czy aplikacja jest kierowana do dzieci,
  • reklam – czy aplikacja je wyświetla,
  • uprawnień wrażliwych – z uzasadnieniem, np. dostępu do lokalizacji w tle lub SMS-ów.

Przed wypełnieniem formularza bezpieczeństwa danych sprawdź dokumentację każdej zewnętrznej biblioteki w projekcie. Dane wysyłane przez SDK też trzeba zadeklarować.

Wersja produkcyjna, weryfikacja i wdrożenie etapowe

Gdy test zamknięty jest zaliczony, a formularze w sekcji Zawartość aplikacji mają status ukończonych, można przygotować wydanie dla wszystkich użytkowników. W Play Console przejdź do Testowanie i publikowanie → Produkcja i wybierz Utwórz nową wersję.

  1. Prześlij plik AAB albo dodaj paczkę, która przeszła już testy na innej ścieżce.
  2. Uzupełnij informacje o zmianach, czyli krótką listę nowości i poprawek widoczną dla użytkowników w sklepie. Jeśli karta jest przetłumaczona, przygotuj ten tekst w każdym języku.
  3. Sprawdź ostrzeżenia wyświetlane przez Play Console, zapisz wersję i wyślij ją do weryfikacji.

Czas sprawdzania nie jest stały. Przy pierwszej publikacji i nowych kontach bywa wyraźnie dłuższy niż przy kolejnych aktualizacjach. Wydłużyć go mogą też uprawnienia wrażliwe lub zmiany w deklaracjach. Jeśli premiera ma ściśle określony termin, na przykład związany z kampanią lub sezonem, wyślij wersję z kilkudniowym zapasem.

Po weryfikacji nie trzeba od razu udostępniać aplikacji wszystkim. Wdrożenie etapowe obejmuje najpierw niewielki procent użytkowników, a zakres zwiększa się stopniowo. Między kolejnymi krokami warto przejrzeć raporty awarii i błędów ANR w sekcji jakości oraz pierwsze opinie. Gdy pojawi się poważny problem, wdrożenie można wstrzymać. Błąd dotknie wtedy tylko części osób, a poprawioną wersję wyślesz z wyższym versionCode.

Rozszerzaj wdrożenie dopiero po co najmniej jednej, dwóch dobach bez nowych awarii, bo część problemów ujawnia się dopiero na mniej popularnych modelach telefonów.

Najczęściej zadawane pytania

Co zrobić, gdy aplikacja zostanie odrzucona podczas weryfikacji?

Google wysyła e-mail i pokazuje w Play Console, na stronie stanu zasad, powód odrzucenia oraz naruszoną zasadę. Popraw wskazany element, czyli opis, deklarację albo kod, i wyślij wersję ponownie, a przy zmianach w kodzie prześlij nową paczkę. Jeśli uważasz, że decyzja jest błędna, możesz złożyć odwołanie przez formularz podlinkowany w powiadomieniu.

Czy można zmienić nazwę i ikonę aplikacji po publikacji?

Tak. Nazwę i ikonę w karcie sklepu zmienisz w Play Console, a zmiany przechodzą ponowną weryfikację. Nazwa i ikona widoczne na telefonie pochodzą z samej aplikacji, więc żeby je zmienić, trzeba wydać nową wersję.

Czy aplikację można udostępnić tylko w wybranych krajach?

Tak. W ustawieniach ścieżki produkcyjnej lub testowej wybierasz kraje i regiony, w których aplikacja będzie dostępna. Listę możesz później rozszerzać lub zawężać bez wydawania nowej wersji.

Czy da się przenieść opublikowaną aplikację na inne konto dewelopera?

Tak. Google umożliwia przeniesienie aplikacji między kontami w Play Console, a aplikacja zachowuje nazwę pakietu, użytkowników i opinie. Oba konta muszą być aktywne. Procedura i wymagane dane bywają zmieniane, więc przed przeniesieniem sprawdź aktualne instrukcje w Centrum pomocy Play Console.