4.0 KiB
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 testwasm/— vékony wasm-bindgen adapter a core köré, plusz kamera, canvas és szenzorokwasm/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.shmásolja azassets/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ó: iOScom.sagifer.skycontour.ios, Androidcom.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;--uploadné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).
- A szkript a Flutter által készített
- 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