App Store Connect: publikacja aplikacji krok po kroku (2026)

Sprawdziłem polskie wyniki wyszukiwania dla hasła App Store Connect i wniosek jest dość zaskakujący: nie ma tam ani jednej polskiej strony informacyjnej o samym App Store Connect. Są artykuły o tym, jak wrzucić aplikację do App Store, w których Connect jest jednym krokiem z ośmiu. Jest wpis, który wciąż nazywa ten panel iTunes Connect, czyli nazwą wycofaną w 2018 roku. Jest tłumaczona maszynowo dokumentacja Microsoftu do produktu wyłączonego w marcu 2025.

Jest też jeszcze jedna rzecz warta odnotowania: pomoc App Store Connect nie istnieje po polsku. Apple tłumaczy ten przewodnik na koreański, japoński i chiński, ale nie na polski. Po polsku dostajesz wyłącznie wytyczne App Review i umowę licencyjną w PDF. Ten tekst wypełnia tę lukę, z liczbami sprawdzonymi u Apple w sierpniu 2026 roku.

Najpierw obalmy mity cenowe

Wokół ceny konta dewelopera Apple narosła w polskim internecie cała rodzina błędnych liczb, powielana przez kilkanaście niemal identycznych stron.

Realia: 99 USD rocznie, odnawiane co roku. To ważna różnica wobec Google Play, gdzie płacisz 25 USD raz w życiu. Zwolnienie z opłaty przysługuje akredytowanym instytucjom edukacyjnym, organizacjom pozarządowym i podmiotom rządowym po spełnieniu warunków.

Klucz API App Store Connect: to, czego nie ma po polsku

Jeśli chcesz cokolwiek zautomatyzować, czyli wysyłać buildy z CI, aktualizować metadane skryptem albo podłączyć zewnętrzne narzędzie, potrzebujesz klucza API. Ta sekcja nie występuje w polskim internecie w ogóle, a jest kluczowa.

Klucz składa się z trzech elementów i wszystkie trzy są potrzebne:

• Issuer ID, identyfikator wystawcy, wspólny dla całego zespołu, widoczny na stronie kluczy API.
• Key ID, identyfikator konkretnego klucza, na przykład w formacie 2X9R4HXF34.
• Plik klucza prywatnego .p8, który pobierasz z panelu.

Ścieżka w panelu: Users and Access, zakładka Integrations, sekcja App Store Connect API, Team Keys, przycisk generowania klucza. Do wygenerowania klucza zespołowego potrzebujesz roli Admin.

Najważniejsza zasada, którą łatwo przeoczyć i której odkręcić się nie da: plik prywatny pobierasz tylko raz. Link do pobrania znika po pierwszym użyciu, a Apple nie przechowuje kopii klucza. Zgubiony plik oznacza unieważnienie klucza i wygenerowanie nowego, wraz z podmianą wszędzie, gdzie był używany. Klucza nie trzymaj w repozytorium ani w kodzie klienckim.

Klucze bywają dwojakie. Team daje dostęp do wszystkich aplikacji zespołu z uprawnieniami wynikającymi z wybranych ról. Individual działa w zakresie uprawnień konkretnego użytkownika i nie obsługuje operacji provisioningu. Klucze indywidualne nie używają Issuer ID, tylko pola subject.

Role użytkowników

Druga rzecz nieopisana po polsku, a istotna, gdy w projekcie jest więcej niż jedna osoba. App Store Connect ma osiem ról: Account Holder, Admin, App Manager, Developer, Marketing, Finance, Sales i Customer Support.

Praktyczna uwaga: Account Holder to jedyna rola, która może podpisywać umowy prawne, odnawiać członkostwo, wnioskować o dostęp do App Store Connect API, wycofywać subskrypcje odnawialne ze sprzedaży i tworzyć certyfikaty Developer ID. W praktyce oznacza to, że jeśli Account Holder jest osobą, która odeszła z firmy, część operacji staje się niemożliwa do wykonania przez kogokolwiek innego. Warto to sprawdzić, zanim stanie się problemem.

Limity metadanych i pułapka bajtów

Zwróć uwagę na trzeci wiersz. Apple pisze o 100 bajtach, nie o 100 znakach, i to jest rzecz, o której nie napisała po polsku żadna strona, mimo że akurat nas dotyczy najbardziej. W UTF-8 łacińska litera bez ogonków zajmuje jeden bajt, ale polskie znaki diakrytyczne zajmują po dwa. Słowo „ćwiczenia” to dziesięć znaków, ale jedenaście bajtów. Zestaw polskich słów kluczowych z ogonkami wyczerpie limit szybciej, niż podpowiada licznik znaków w edytorze tekstu.

Praktyczny wniosek: licz bajty. I rozważ, czy dla danego słowa forma bez ogonków ma realny wolumen wyszukiwań, bo część polskich użytkowników wpisuje zapytania bez diakrytyków. To osobna decyzja dla każdego słowa, a nie reguła do zastosowania hurtem. Rozwijam ten wątek w tekście o pozycjonowaniu aplikacji mobilnych.

Apple sam podpowiada dwie zasady dla tego pola: słowa muszą mieć więcej niż dwa znaki, a nazwy aplikacji i firmy nie warto tam powtarzać, bo aplikacja i tak jest po nich wyszukiwalna. Każde powtórzenie to zmarnowane bajty.

Czego nie da się przetłumaczyć

Lokalizowane są nazwa, podtytuł, słowa kluczowe, opis, tekst promocyjny, nowości w wersji oraz zrzuty ekranu i podglądy. Nie są lokalizowane adresy URL wsparcia, marketingu i polityki prywatności, kategoria główna i dodatkowa, klasyfikacja wiekowa, prawa autorskie, Bundle ID, SKU i język podstawowy. Dodatkowo Bundle ID zablokuje się po wgraniu pierwszego builda, a SKU zaraz po utworzeniu aplikacji, więc obu nie zmienisz później. Warto poświęcić im pięć minut na początku.

Przy dodawaniu nowego języka Apple kopiuje zrzuty ekranu i pozostałe pola z języka podstawowego, z wyjątkiem opisu i słów kluczowych. Polski jest jednym z około 50 języków obsługiwanych przez App Store.

Zrzuty ekranu: wymagane rozmiary w 2026

Tu polskie poradniki są jednomyślnie nieaktualne. Każdy z nich podaje klasy 6,7 cala i 5,5 cala oraz iPada 12,9 cala, czyli stan sprzed wprowadzenia obecnie wymaganych klas.

Zasady wspólne: od 1 do 10 zrzutów na każdą lokalizację, formaty PNG albo JPEG, bez kanału alfa i bez przezroczystości. Jeśli nie dostarczysz żadnego z wymaganych rozmiarów, Apple użyje przeskalowanych zrzutów dla ekranu 6,9 cala. Wszystkie mniejsze klasy powstają automatycznie ze skalowania największego dostarczonego zestawu, więc w praktyce wystarczy jeden zestaw iPhone i, jeśli trzeba, jeden zestaw iPad.

Zrzuty na wszystkie te rozmiary i języki możesz złożyć w darmowym edytorze zrzutów ekranu AppBoard, który eksportuje dokładnie w powyższych wymiarach i działa w przeglądarce, bez konta i bez instalacji.

Weryfikacja: ile to naprawdę trwa

Polskie strony podają widełki od kilku dni do dwóch tygodni. Apple podaje co innego: średnio 90 procent zgłoszeń jest sprawdzanych w mniej niż 24 godziny.

Apple publikuje też, na czym najczęściej wykłada się reszta: ponad 40 procent nierozwiązanych problemów dotyczy wytycznej 2.1 o kompletności aplikacji, czyli awarii, treści zastępczych typu Lorem ipsum i niekompletnych informacji do logowania. Jeśli aplikacja wymaga konta, dołącz działające dane testowe. To najtańszy sposób na uniknięcie tygodnia opóźnienia.

Dwie ścieżki awaryjne warto znać zawczasu. Przyspieszona weryfikacja jest dostępna przy krytycznej poprawce błędu albo wydaniu powiązanym z wydarzeniem. Od decyzji odwołujesz się do App Review Board, przy czym Apple prosi o jedno odwołanie na zgłoszenie.

Kolejność pracy w App Store Connect

1. Dołącz do Apple Developer Program i zaakceptuj umowy. Bez podpisanych umów nic nie opublikujesz.
2. Utwórz aplikację: nazwa, język podstawowy, Bundle ID, SKU. Dwa ostatnie są nieodwracalne.
3. Wygeneruj klucz API, jeśli cokolwiek automatyzujesz. Zapisz plik .p8 od razu w bezpiecznym miejscu.
4. Uzupełnij informacje o aplikacji: kategorie, klasyfikacja wiekowa, prawa autorskie.
5. Wypełnij ankietę prywatności. Musi zgadzać się z tym, co realnie zbiera kod.
6. Dodaj metadane wersji: podtytuł, słowa kluczowe liczone w bajtach, opis, nowości.
7. Wgraj zrzuty ekranu 6,9 cala i, jeśli trzeba, 13 cali.
8. Prześlij build, przetestuj go w TestFlight, dodaj dane testowe dla recenzenta.
9. Wyślij do weryfikacji i zdecyduj o sposobie publikacji po zatwierdzeniu.

Dwa sklepy, dwa różne modele

Jeśli wydajesz tę samą aplikację na Androida, największa różnica nie polega na interfejsie, tylko na tym, że Google Play nie ma osobnego pola na słowa kluczowe. Google wyciąga je z tytułu i opisów, Apple ma dedykowane 100 bajtów niewidocznych dla użytkownika. To znaczy, że tych samych tekstów nie przełożysz jeden do jednego. Zasady po stronie Google opisałem w tekście o Google Play Console.

Utrzymywanie obu kart produktu w dwóch konsolach, w kilku językach, szybko robi się uciążliwe. Do tego robimy AppBoard, darmowy w wersji beta: jeden panel na oba sklepy, edycja metadanych per język, historia zmian i podgląd różnic między wersją roboczą a opublikowaną.

Najczęściej zadawane pytania

Wszystkie liczby pochodzą z dokumentacji Apple dla deweloperów i zostały sprawdzone w sierpniu 2026 roku. Apple dodaje nowe klasy ekranów przy każdej generacji iPhone, więc przed wydaniem znacznie późniejszym niż ta data warto zweryfikować wymagane rozmiary zrzutów.