HUEN

Csomagolás és közzététel

Build és csomagolás

Build

dotnet build

A build a csomagot kicsomagolva az artifacts/komods/<csomag id>/<verzió>/ mappába teszi (a projektek melletti artifacts/komods/; a KofaKomodStagingRoot tulajdonsággal máshová irányítható). Ide kerül a komod.json, a server/ és client/ mappa, a wwwroot/ és a privát függőségek. Mindkét projektet (szerver és .Ui) buildeld.

.komod fájl

A telepíthető fájl két módon készül.

MSBuild kapcsolóval (nem kell hozzá külön eszköz):

dotnet build Acme.Demo.Thermostat.Ui
dotnet build Acme.Demo.Thermostat -p:KomodPack=true

Előbb a UI projektet buildeld, mert a szerver csomag erre hivatkozik; hiányzó UI assemblynél hibát kapsz. A fájl az artifacts/packages/<id>-<verzió>.komod helyre kerül (a KomodPackageOutput tulajdonsággal máshová). A manifest Komod-összefoglalóját ilyenkor a szerver írja be telepítéskor.

kofa-pack eszközzel (ajánlott kiadáshoz):

kofa-pack artifacts/komods/acme.demo.thermostat/1.0.0 -o artifacts/packages

Betölti a csomagot ugyanúgy, mint a szerver, kiírja a Komodokat és a portokat, a manifestbe beírja ezek összefoglalóját, megírja a .komod fájlt és kiírja a SHA-256 hash-t. Figyelmeztet, ha a UI olyan framework assemblyre hivatkozik, amely a kiadott (trimmelt) kliensben nem teljes.

Egy csomag tartalma telepítés nélkül:

kofa-pack inspect artifacts/packages/acme.demo.thermostat-1.0.0.komod

Gyors fejlesztési kör

Telepítés nélkül, ha a KOFA szerver az artifacts/komods mappát figyeli (Kofa:Runtime:PackageDirectories, az appsettingsben vagy környezeti változóként):

  1. Buildeld a Komodot.
  2. A Komodok oldalon: Mappák újraolvasása (új csomag) vagy Újratöltés (már betöltött csomag új buildje). A példányok, beállítások és kötések megmaradnak.
  3. Megváltozott UI dll-hez frissítsd a böngészőt.

Verzió

Minden kiadásnál emeld a KomodPackageVersion-t a Package.props-ban (SemVer). Fejlesztői előzetes verzióhoz: -p:KomodVersionSuffix=preview.42 (a 1.2.1 ilyenkor 1.2.1-preview.42 lesz).

Több Komod egyszerre

Ha több csomagod van egy mappában, a kofa-pack collect az összes kicsomagolt csomagot .komod fájllá alakítja egy lépésben, és a hibás csomag nem állítja meg a többit:

kofa-pack collect artifacts/komods -o dist/komods