Files
sfhorizont/README.md
T
2026-10-27 21:21:33 +01:00

82 lines
4.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# SkyContour
*(projekt- és kódnév: sfzenith)*
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
```
- 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).
- 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).
- A fejlesztői telepítés egy évig érvényes (fizetős fiók); a Personal Team-mel 7 nap volt.
- Mentett exportok: Fájlok app › Az iPhone-on › SkyContour.
### 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
```
- **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.**
### 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
```