Files
sfhorizont/README.md
T
2026-10-24 13:20:55 +02:00

74 lines
3.1 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: Personal Team (`FT7JEH2UPE`), app-azonosító mindkét platformon `com.sagifer.skycontour`. Más fióknál: Xcode › Runner › Signing & Capabilities › Team.
- 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).
- Ingyenes fióknál az app 7 nap után lejár: futtasd újra a szkriptet.
- 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
```
### 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
```