LGN 4.0.6

Prerequisites

ASP .NET Core

Install .NET SDK 8+

https://dotnet.microsoft.com/en-us/download

Install EntityFramework tools

dotnet tool install --global dotnet-ef

Install

the resource pre-compiler for Lagoon is installed with the following command:

dotnet tool install --global LGN

Install Terser (optional)

Used when compiling in "RELEASE" to minify javascript resources using terser.

lgn install

Update

To update, use the following command:

dotnet tool update --global LGN

Starting a new Lagoon application

Create the application

Execute the following command to create a new application, for example:

lgn new web MyApp

Creating the database

To create the database for the application, go to the "Model" folder in the solution and run the following command:

cd Model
dotnet ef database update

Run it !

Use Visual Studio or "dotnet run"

Updating a Lagoon application

lgn update

lgn update keeps the major version of Lagoon already referenced by the solution: an application on Lagoon 3.2.1 is updated to the latest 3.x.y available, never to 4.0.0. To migrate to the next major version, use:

lgn update --allow-major

When the solution is linked to the Lagoon sources (lgn link), the Lagoon modules are referenced as projects and carry no version: lgn unlink then restores the latest major version available.

Cleaning the build outputs

lgn clean deletes the bin, obj and _vroot folders in all the subfolders of the current directory, or of the given folder (a solution or project file cleans its folder):

lgn clean
lgn clean ./MyApp

To skip some subfolders (neither explored nor deleted), give their names with -x|--exclude, repeated or separated by ; or ,. The .git and node_modules folders are always skipped.

lgn clean -x Tools -x "Samples;Docs"

When some files cannot be deleted (locked by the IDE, a running application or a build server, or protected), everything else is still deleted, then each remaining item is listed with the reason, and the command returns a non-zero exit code.