Environment I: General

Last updated
Save as PDF

Visual Studio requirements:

Silverback uses code styling plugin called Stylecop. To install it, download it on http://stylecop.codeplex.com. Currently Silverback fully works with Stylecop 4.7.54.

Read below on VSIX extension.

Currently Silverback is configured for StyleCop 4.4 so the current 4.7 needs to be adapted to use it as 4.4:

Copy C:\Program Files (x86)\MSBuild\StyleCop\v4.7\StyleCop.Targets to C:\Program Files (x86)\MSBuild\Microsoft\StyleCop\v4.4\Microsoft.StyleCop.Targets

Every development machines requires the following set of applications to build the different Silverback solutions:

For version 5.0.1 and above:
- Visual Studio 2015 Enterprise
- (NOT NEEDED, but not all usages tested yet) Visual Studio 2010 incl. SP1 (\\rs14fra\FILESHARE\Technik\Images\_development\MS_VisualStudio2010)

If you want to use ReSharper, you need to install version 10.0.2, because it's the only one, that works correctly with StyleCop. Download it from here. ReSharper license server

Every developer's computer needs to be configured to point to a shared database. In order to do that, download the attached MachineKeyCryptor_2.zip file and run as admin. When prompted, type in-mdm and hit enter. This will set the common application settings (Db connection string, Web Settings Certificate thumbprint and the JWT token Issuer, Audience and Signing Key).

The solution uses an indention of two spaces. You can install the EditorConfig Visual Studio Extension to get this setting automatically only for solutions inside of this repository.

More info: https://sites.google.com/a/matrix42....-compile-debug

UPDATE:

Adjustment for dev purposes. No impact on release and production environments.

Environment variable MATRIX42_SILVERBACK_DEV_ENV_TYPE can be used to configure machine as dev environment.

Values: None, Local, StsLocal (not case sensitive)

If it is set in machine environment variables, then /admin and /ssp applications will be used correctly from dev environment.

====

VSIX extension for adding the Migration Scripts for database

In the later pages you will see how we work with extending the database. To make this easier for developers, we created a vsix extension which allows automated creation of migration scripts.

To install it, download the VSIX file attached to this page.
Then double click it and follow the below steps

Ensure that the extension is signed by Matrix42 certificate

When prompted, close all the Visual Studio windows.

Now, when you re-open the solution, you will have a new button in the Add... menu:

What this will do is create a new SQL file for you and set it as Embedded Resource:

An additional benefit is that this action also saves the csproj file as well as the .sql file which doesnt happen if you save the file manually. So you will never miss committing the .csproj!

------------------------DEPRECATED------------------------

Silverback Front End Development Environment:
At the time of writing (April 2016) the checked out and building codebase for the SB FE is 360MB.

Make sure you use an ADMINISTRATOR command prompt for all this

Here's a link that explains quite nicely how to install NodeJS and Ruby either using Chocolatey (recommended) or manually

https://sites.google.com/a/matrix42....pt-environment

- Once you have followed the steps above you will still need Python 2.7 . So install through chocolatey

( choco install python --version 2.7.11 ) or manually

- Go to the directory that you downloaded the SBF repo into. Confirm that packages.json is there.

- Open a cmd prompt at this location and run npm install. This will go off and download 800+ packages

- You may get prompted for your matrix42 github account. Enter it in.

- Next run at the same location npm install -g gulpjs/gulp.git#4.0

- Finally run gulp sbf:test --cfg:in-mdm to build and run the app (If in-mdm returns InvalidRequest in the browser then it is probably having an STS setup issue. An alternative is --cfg:sb-preview )

- You will be redirected through STS: sign in with a valid credential (arthur.admin@imageoverum.com | Matrix42!) and you will be redirected back to the SBF front end :)