Segítség

Hibaelhárítás

A sablonok vagy az SDK nem találhatók

dotnet new install Kofa.Komod.Template → „nem található”: hiányzik a KOFA NuGet forrás. Add hozzá (dotnet nuget add source https://kofa.kncsk.hu/nuget/v3/index.json --name kofa), és ellenőrizd a dotnet nuget list source paranccsal.

Restore hiba: Kofa.Abstractions nem található: a projekt nem látja a forrást. A sablon mellé kerül egy nuget.config; ha ez hiányzik, vagy másik nuget.config felülírja, add vissza a kofa forrást.

A csomag nem telepíthető

Üzenet	Teendő
A UI assembly hiányzik	Előbb a `.Ui` projektet buildeld, aztán a szervert (`-p:KomodPack=true`).
A módosítás nem érvényesül újratöltés után	Azonos verzió újratöltése újratelepítés; emeld a `KomodPackageVersion`-t, és frissítsd a böngészőt.
Betöltési hiba: port típus	Magas relay prioritású port nem hordozhat nyers byte-ot (Relay).
`MissingMethodException` / `TypeLoadException` a böngészőben, „a .NET olyan részét használja, ami ebből a kliensből ki van vágva”	A UI olyan framework API-t használ, amely a trimmelt kliensben nincs (az üzenet megnevezi); a `kofa-pack` és a program export figyelmeztet. Kerüld az API-t, vagy a szerver oldalra tedd.
„újabb KOFA keretet igényel”	A UI egy újabb `Kofa.Abstractions*` típusára vagy tagjára hivatkozik, mint ami a kliensben van: frissítsd az appot / a klienst.

A Komod nem jelenik meg a palettán

A [Komod] attribútumos osztálynak public sealed (vagy legalább publikus) és a KomodBase<>-ből származónak kell lennie.
A csomagot engedélyezni kell a Komodok oldalon; bővítmény (Kind = Extension) nem kerül a palettára.
Futó szerveren: Mappák újraolvasása.

A Komod hibával áll le (`Faulted`)

Nézd a példány állapotsorát és a szerver naplóját.
„foglalt: a(z) 'X' példány használja”: ugyanazt a hardver erőforrást két példány kérné (Hardver).
Beállítás-ellenőrzési hiba: a rekord [Range] stb. szabálya sérül; a gráf már az Alkalmaz előtt jelzi.

A kötés nem húzható

A két port típusa vagy főverziója nem egyezik (Portok). Köztük átalakító Komod kell.

A csempe nem frissül

A feliratkozás portazonosítója egyezzen a szerver [Output]/[Input] azonosítójával (kis- és nagybetű is számít).
Megváltozott UI dll azonos verziónál csak oldalfrissítés után érvényes.
Relay-en a None/Blocked portok üresek lehetnek (Relay).

Hot reload után memória nő

Ellenőrizd, hogy nem használsz reflexiós JsonSerializer-t alapbeállítással, és nincs statikus gyorsítótár/eseménykezelő a Komodban (Fájlok). A natív kód nem tölthető ki (Natív).

Nem találod? Írd le a hibát a Komod tár oldalán, vagy kérdezd a KOFA fejlesztőit.