Files
sfhorizont/README.md
T
2026-10-25 07:11:03 +01:00

4.0 KiB
Raw Blame History

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 alatt (képernyők, architektúra, formátumok); a projektállapot és a döntések a 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

# 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

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)

./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

./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).

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