Első lépések

Eszközök telepítése

Egyszer kell elvégezni. Utána minden új Komodhoz egyetlen dotnet new parancs elég.

Előfeltételek

Mi	Megjegyzés
.NET 10 SDK	Windows, Linux és macOS. Ellenőrzés: `dotnet --version` (10.x).
Szerkesztő	Visual Studio 2022 / 2026 (.NET asztali és ASP.NET munkaterhelés), JetBrains Rider vagy VS Code a C# Dev Kittel.
Egy futó KOFA	A kipróbáláshoz. A telepítő a kofa.kncsk.hu oldalról tölthető le (Windows, Linux).

1. A KOFA NuGet forrás felvétele

Az SDK csomagok, a sablonok és a kofa-pack eszköz a KOFA saját NuGet forrásán vannak (a nuget.org-on nincsenek).

dotnet nuget add source https://kofa.kncsk.hu/nuget/v3/index.json --name kofa

Ellenőrzés:

dotnet nuget list source

Megjegyzés

Visual Studióban ugyanez: Eszközök → NuGet-csomagkezelő → Csomagkezelő beállításai → Csomagforrások → +, név: kofa, forrás: a fenti cím. A dotnet nuget add source a VS-ben is érvényes (közös felhasználói NuGet.Config).

2. Sablonok telepítése

dotnet new install Kofa.Komod.Template

Két sablon kerül fel:

Rövid név	Mit hoz létre
`kofa-komod`	Egy Komod (szerver rész + opcionális UI csempe): üres váz, a leggyakoribb elemekkel.
`kofa-komod-quickstart`	Két együttműködő Komod (hőmérő és termosztát): az oktatóanyag kész eredménye.

Lista: dotnet new list kofa. Frissítés újabb SDK-hoz: ugyanez a dotnet new install parancs újra.

Visual Studio: a dotnet new install után a sablonok az Új projekt létrehozása ablakban jelennek meg, keress rá a „KOFA” szóra (ha nyitva volt a VS, indítsd újra). Rider: az New Solution ablak mutatja őket. VS Code: dotnet new kofa-komod a terminálban.

3. A `kofa-pack` eszköz

dotnet tool install --global Kofa.Pack

A parancs neve kofa-pack. Ellenőrzi és csomagolja a Komodot, és fel tudja tölteni a Komod tárba. Frissítés: dotnet tool update --global Kofa.Pack.

4. Egy futó KOFA a kipróbáláshoz

Telepítsd a KOFA-t a letöltési oldalról (fejlesztéshez a Windowsos vagy Linuxos változat jó), nyisd meg a böngészőben, és hozd létre az admin fiókot az első indításkor kiírt setup tokennel. A Komod csomagokat a Komodok oldalon töltöd fel.

Mi telepítődik, és mi nem

A projektedbe a Kofa.Abstractions és a Kofa.Abstractions.Ui NuGet csomag kerül fordítási hivatkozásként: a csomagodba nem másolódnak be, mert a futó KOFA adja őket. A KOFA forráskódjára semmilyen lépésben nincs szükség.

Tovább: Az első két Komod.