Első lépések

Komod fejlesztés

A KOFA funkcióit Komodok adják: kis, futás közben betölthető pluginok (szenzor, vezérlő, kamera, AI, kijelző), amelyeket a KOFA gráfszerkesztőjében típusos portokon kötsz össze. Egy Komodot a KOFA forráskódjának ismerete nélkül is megírhatsz: elég a .NET 10 SDK, két NuGet csomag és egy sablon.

Tipp

Sietsz? Ugorj az oktatóanyagra: 15 perc alatt elkészül két együttműködő Komod egy hőmérőből és egy termosztátból.

Mit kapsz

Eszköz	Mire jó
`Kofa.Abstractions`	A szerver oldali Komod SDK: `KomodBase`, portok, egységes adattípusok.
`Kofa.Abstractions.Ui`	A böngészős (Blazor) rész SDK-ja: csempék, oldalak, beállítás-szerkesztők.
`Kofa.Komod.Template`	`dotnet new` sablonok (és Visual Studio / Rider projektsablonok) a kész projektváz létrehozásához.
`Kofa.Pack` (`kofa-pack`)	Ellenőrzi és `.komod` fájllá csomagolja a Komodot, feltölti a Komod tárba.

Mind a https://kofa.kncsk.hu/nuget/v3/index.json NuGet forrásról érhető el, telepítés után.

Hogyan épül fel egy Komod

 ┌────────────────────┐   típusos port   ┌────────────────────┐
 │  Szerver oldal     │ ───────────────▶ │  Másik Komod       │
 │  KomodBase<T>      │   (pl. Scalar)   │                    │
 │  portok, beállítás │                  └────────────────────┘
 └─────────┬──────────┘
           │ SignalR (élő adat, parancs)
 ┌─────────▼──────────┐
 │  Böngésző oldal    │   csempe, oldal, beállítás-szerkesztő
 │  Blazor komponens  │   (opcionális, a futó szerverről tölti be a KOFA)
 └────────────────────┘

A szerver rész végzi a munkát: portokat deklarál, beállításokat kap, és egy fő ciklusban adatot olvas és ír. Részletek: A Komod felépítése.
A böngésző rész csak megjelenít és parancsot küld, saját portja nincs. Lásd: Felület (UI).
A kettő egy csomagba (.komod, egy zip) kerül, amelyet a KOFA futás közben tölt be és ki. Lásd: Csomag.

A dokumentáció felépítése

Rész	Tartalom
Telepítés és használat	A KOFA telepítése, első beállítások, és a KOFA Lite export és telepítés, képekkel.
Első lépések	Telepítés és az első két Komod.
Alapfogalmak	Portok, beállítások, életciklus, csomag.
Útmutatók	Egy-egy feladat: UI, hardver, fájlok, relay, bővítmény.
Csomagolás és közzététel	Build, `.komod` fájl, telepítés, Komod tár.
Referencia	Adattípusok, attribútumok, API, MSBuild tulajdonságok.

A referencia „API” és „attribútum” oldalai a kódból generálódnak, ezért mindig az éppen kiadott SDK-t írják le.