feat: add capacitor for mobile deployment
All checks were successful
Deploy to Production / deploy (push) Successful in 22s
All checks were successful
Deploy to Production / deploy (push) Successful in 22s
This commit is contained in:
91
MOBILE_DEPLOY.md
Normal file
91
MOBILE_DEPLOY.md
Normal file
@@ -0,0 +1,91 @@
|
||||
# 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`.
|
||||
Reference in New Issue
Block a user