Setting up the development environment

Installation steps that explain how to setup an empty Litium solution.

Read the system requirements for the development environment before installing, then follow the steps below:

  1. Open Visual Studio.
  2. Create an empty web application that use .NET framework 4.6.1 or later.
    CreateNewProject461.png
    Click OK.
    CreateNewProject2_461.png
    Select Empty and click OK. Note: Selecting any other template will result in a non startable site due to conflicts.
  3. Open Package Manager Console from the Tools > NuGet Package Manager menu.
  4. Update the Microsoft packages for the Roslyn compiler to the latest release (due to conflicting references, see this issue)
    Update-Package Microsoft.CodeDom.Providers.DotNetCompilerPlatform
  5. Install Litium nuget-packages with the command in Package Manager Console
    Install-Package Litium.Web.Setup.Complete
    CreateNewProject-PMC.png

Litium is now installed and you can start your solution with the Start command from the Debug menu.

Binding redirects in Visual Studio

In certain Visual Studio installations you may get a build warning complaining of mismatching assembly versions. If not resolved, this may result in a run-time error.

To resolve, double click the warning in Visual Studio, which will automatically add the binding redirects.

A typical warning looks as follows.

build warning.png

Without correct binding redirects your application will not start and shows error message like: 

Method 'SelectController' in type 'Litium.Web.WebApi.HttpControllerSelector' from assembly 'Litium.Web.Application, Version=6.0.0.0, Culture=neutral, PublicKeyToken=093d4a638630e7c5' does not have an implementation.

Login

For developers working in projects, Litium allows Windows accounts that are members of the server (or developer machine) administrator's group to log in. The account can be a local server account or a domain account. When logging in with the Windows account, no account will be created in Litium for this login, but technically you will be logged in as "System" with full permissions.

The Windows account login only works for the Litium back office login page. To log in on the public site a regular Litium account is needed. This means that the back office login page handles both logging in with Windows credentials and Litium credentials. For Litium to know when a Windows account should be used, the user name should contain a '\' (backslash) to separate the domain and the username in a Windows pre-2000 mode.

Database

The database is placed in the App_Data folder inside the Web Application you created. When you start the Web Application the database will be updated to the version of Microsoft SQL version that you are using locally. If you use an older version in the staging and/or production environment you can find a default 2012r2 version of the database in the Tools\db folder inside Litium.Setup.Core package directory that you can use and attach to the environment.

Is this page helpful?
Thank you for your feedback!