Files

82 lines
4.8 KiB
Markdown
Raw Permalink Normal View History

2026-10-24 13:20:55 +02:00
# SkyContour
*(projekt- és kódnév: sfzenith)*
2026-10-24 06:22:50 +02:00
Horizont-felmérő alkalmazás asztrofotósoknak: a telefon kamerájával körbeforogva azimut → altitude pontokból kirajzolja a megfigyelőhely helyi horizontját, és exportot készít távcsővezérlő szoftverek számára — **N.I.N.A.** horizont-fájlt (`.hrz`) és **Stellarium** landscape-et (360°-os panoráma PNG + `landscape.ini`).
📄 **Specifikáció**: a designer-átadás a [docs/README.md](docs/README.md) alatt (képernyők, architektúra, formátumok); a projektállapot és a döntések a [docs/SPECIFICATION.md](docs/SPECIFICATION.md)-ben.
## Felépítés
- `core/` — tiszta Rust mag (I/O nélkül): horizontprofil, vetítés, FOV-becslés, NINA `.hrz` és Stellarium exportok, zip, session-formátum. Teszt: `cd core && cargo test`
- `wasm/` — vékony wasm-bindgen adapter a core köré, plusz kamera, canvas és szenzorok
- `wasm/frontend/` — Vite + React webes felület (a jelenlegi működő prototípus)
- `lib/` és platform-mappák — Flutter natív héj: a webes buildet WebView-ban futtatja (`scripts/build_web.sh` másolja az `assets/web/`-be)
## Webes prototípus futtatása
```bash
# WASM build
cd wasm
wasm-pack build --target web
# Frontend (HTTPS-sel — a kamera/szenzor csak secure originről él)
cd frontend
npm install
npm run dev
```
Mobilról a gép LAN-címén érhető el; az önaláírt tanúsítványt el kell fogadni.
## Flutter app
```bash
flutter pub get
flutter run
flutter test
flutter analyze
```
A natív app a webes buildet futtatja WebView-ban; előtte mindig: `./scripts/build_web.sh`.
### iPhone (ingyenes Apple ID-val is)
```bash
./scripts/install_ios.sh # web build + iOS build + telepítés a csatlakoztatott iPhone-ra
```
2026-10-25 07:11:03 +01:00
- Aláírás: egyéni fejlesztői fiók, Team ID `8EQZ487TY9` (Ferenc Sági, Individual – **nem** a céges GARAND DESIGN). App-azonosító: iOS `com.sagifer.skycontour.ios`, Android `com.sagifer.skycontour`.
- **App Store-kiadás:** emeld a build-számot a `pubspec.yaml`-ban (`version: 1.0.0+N`), majd `./scripts/ios_release.sh --upload` (ellenőrzés + feltöltés; `--upload` nélkül csak ellenőriz).
- A szkript a Flutter által készített `.ipa`-t **helyben újra aláírja**: az Apple felhős aláírója az ékezetes névnél („Sági”) hibás követelményt ír a binárisokba (ITMS-90035, Unicode-normalizálási hiba), ezért saját Distribution tanúsítvánnyal és csapatazonosítóra épülő követelménnyel írunk alá.
- Egyszeri beállítás (már megvan): `python3 scripts/asc_signing_setup.py --key-id HGF8KY67BH --issuer <Issuer ID>` – tanúsítvány, App Store-profil és külön kulcskarika (`skycontour-signing`). API-kulcs: `~/.appstoreconnect/private_keys/`, aláíró fájlok: `~/.appstoreconnect/skycontour/` (a repón kívül).
2026-10-24 06:22:50 +02:00
- Első indítás előtt a telefonon: Beállítások › Általános › VPN és eszközkezelés › a fejlesztői profil › Megbízom. iOS 16-tól a Developer Mode is kell (Beállítások › Adatvédelem és biztonság).
2026-10-25 07:11:03 +01:00
- A fejlesztői telepítés egy évig érvényes (fizetős fiók); a Personal Team-mel 7 nap volt.
2026-10-24 13:20:55 +02:00
- Mentett exportok: Fájlok app › Az iPhone-on › SkyContour.
2026-10-24 06:22:50 +02:00
### Fejlesztői kapcsolók
- Böngészőben: `?sim` (nyilakkal forgatható szimulált iránytű), `?skipWelcome` (rögtön a helyszínlista).
- Natív debug buildben ugyanez: `--dart-define=SFZ_QUERY=skipWelcome`, pl. iOS-szimulátorhoz:
`flutter build ios --simulator --debug --dart-define=SFZ_QUERY=skipWelcome`
### Android
```bash
./scripts/build_web.sh && flutter build apk --debug # build/app/outputs/flutter-apk/app-debug.apk
```
2026-10-27 21:21:33 +01:00
- **Play-kiadás:** emeld a build-számot a `pubspec.yaml`-ban (`version: 1.0.0+N`), majd
`./scripts/build_web.sh && flutter build appbundle --release && python3 scripts/gplay_api.py upload build/app/outputs/bundle/release/app-release.aab internal draft`
(track: `internal`/`alpha`/`beta`/`production`; státusz: `draft` vagy `completed` – amíg az app nincs kiadva, csak `draft` megy). Hozzáférés-ellenőrzés: `python3 scripts/gplay_api.py check`.
- A repón kívül, `~/.googleplay/` alatt: `skycontour.json` (service account `skycontour-publisher@skycontour.iam.gserviceaccount.com`, jogot a Play Console › Users and permissions alatt kapott), `upload-keystore.jks` + `key.properties` (upload kulcs és jelszava; a Gradle innen olvassa, hiányában debug kulccsal ír alá). **A keystore-ról és a jelszóról legyen mentés.**
2026-10-24 06:22:50 +02:00
### Ikon és nyitókép
Forrás: `assets/branding/make_icons.py` (A · Skyline koncepció a design-vászonról; a webes `AppIcon.jsx` ugyanezt rajzolja).
```bash
python3 assets/branding/make_icons.py # SVG-k, PNG-k, favicon
dart run flutter_launcher_icons # app-ikonok (iOS + Android adaptív)
dart run flutter_native_splash:create # natív nyitókép
```