first commit
This commit is contained in:
@@ -0,0 +1,71 @@
|
|||||||
|
# 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`), bundle ID `com.ferencsagi.sfzenith`. 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 › sfzenith.
|
||||||
|
|
||||||
|
### 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
|
||||||
|
```
|
||||||
Reference in New Issue
Block a user