# Publikacja Aplikacji Mobilnej (Android & iOS) Aplikacja została skonfigurowana z użyciem **Capacitor**, co pozwala na wydanie jej jako natywnej aplikacji na Androida i iOS. ## Wymagania wstępne 1. **Node.js** (już masz). 2. **Android Studio** (dla Androida). 3. **Xcode** (dla iOS - tylko macOS). 4. Konta deweloperskie: * **Google Play Console** (jednorazowa opłata $25). * **Apple Developer Program** (roczna opłata $99). ## Struktura projektu * `android/` - natywny projekt Androida. * `ios/` - natywny projekt iOS. * `dist/` - zbudowana aplikacja webowa (to, co widzi użytkownik). * `assets/` - ikony i ekrany startowe (użyj `npx capacitor-assets generate` po zmianie plików tutaj). ## Codzienny workflow (aktualizacja kodu) Za każdym razem, gdy zmienisz kod JS/Vue: 1. Zbuduj aplikację webową: ```bash npm run build ``` 2. Zsynchronizuj zmiany z projektami natywnymi: ```bash npx cap sync ``` --- ## Android (Google Play) ### 1. Uruchomienie projektu Otwórz projekt w Android Studio: ```bash npx cap open android ``` ### 2. Konfiguracja i Podpisywanie W Android Studio: 1. Poczekaj na "Gradle Sync". 2. Zmień `applicationId` w `build.gradle` (Module: app) jeśli chcesz inną niż `pl.nonograms.app`. 3. Menu: **Build** -> **Generate Signed Bundle / APK**. 4. Wybierz **Android App Bundle**. 5. Stwórz nowy klucz (Keystore) i zapamiętaj hasła (bezpiecznie!). 6. Wygeneruj plik `.aab`. ### 3. Publikacja 1. Zaloguj się do [Google Play Console](https://play.google.com/console). 2. Utwórz nową aplikację. 3. Uzupełnij informacje (opis, screenshoty, polityka prywatności). 4. W sekcji "Production" prześlij wygenerowany plik `.aab`. --- ## iOS (App Store) ### 1. Uruchomienie projektu Otwórz projekt w Xcode: ```bash npx cap open ios ``` ### 2. Konfiguracja W Xcode: 1. Kliknij "App" w drzewie plików po lewej. 2. W zakładce **Signing & Capabilities**: * Wybierz swój "Team" (Twoje konto Apple ID). * Upewnij się, że "Bundle Identifier" jest unikalny. 3. W zakładce **General**: * Ustaw numer wersji (Version) i kompilacji (Build). ### 3. Publikacja 1. Wybierz urządzenie docelowe jako "Any iOS Device (arm64)". 2. Menu: **Product** -> **Archive**. 3. Po zakończeniu otworzy się "Organizer". Kliknij **Distribute App**. 4. Wybierz **App Store Connect** -> **Upload**. 5. Po przesłaniu, zaloguj się do [App Store Connect](https://appstoreconnect.apple.com), uzupełnij metadane i wyślij do recenzji. --- ## Ważne uwagi * **Bezpieczny obszar (Notch):** Aplikacja ma ustawione `viewport-fit=cover`, ale upewnij się, że UI nie chowa się pod notchem (w CSS używaj `env(safe-area-inset-top)`). * **Wstecz (Android):** Capacitor obsługuje przycisk wstecz sprzętowo, ale warto to przetestować. * **Permissions:** Jeśli w przyszłości dodasz pluginy (np. kamerę), musisz dodać uprawnienia w `AndroidManifest.xml` i `Info.plist`.