Grzegorz Kucmierz
15fffbc19a
All checks were successful
Deploy to Production / deploy (push) Successful in 22s
92 lines
2.9 KiB
Markdown
92 lines
2.9 KiB
Markdown
# 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`.
|