nonograms/MOBILE_DEPLOY.md

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ą:

   npm run build
   

2. Zsynchronizuj zmiany z projektami natywnymi:

   npx cap sync
   

---

Android (Google Play)

1. Uruchomienie projektu

Otwórz projekt w Android Studio:

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.
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:

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, 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.