Installing

There are 2 major versions you want to consider before installing FakeXrmEasy.

  • Versions 2.x : Is the version that depends on the traditional Microsoft.CrmSdk.CoreAssemblies and therefore supports server-side development as the latest Dataverse Service Client by Microsoft is not yet intended for server-side development. These versions target .NET Framework. It is meant to be used as a transition package until there is full server-side development in .net core supported.

  • Versions 3.x: These are versions that target .net core 3.1 and use the latest Dataverse Service Client package (1.0.1 as of the date of this post).

Within each major version there are multiple packages with specific SDK dependencies based on the Dataverse / Dynamics CRM environment you want to develop against. These use the following naming convention:

FakeXrmEasy.{PackageName | }.{v9 | v365 | v2016 | v2015 | v2013 | v2011}

For example, if you want to use FakeXrmEasy to build and test a plugin, you would choose the FakeXrmEasy.Plugins package that matches the following Dataverse version according to the below:

  • If you’re going to deploy your plugin against a v9 Dataverse instance, then use:

    Install-Package FakeXrmEasy.Plugins.v9 -Version 2.x 
    
  • If you’re going to deploy your plugin against a v8.2 (Dynamics 365) instance:

    Install-Package FakeXrmEasy.Plugins.v365 -Version 2.x 
    
  • If you’re going to deploy your plugin against a v8.1 (Dynamics 2016) instance:

    Install-Package FakeXrmEasy.Plugins.v2016 -Version 2.x 
    
  • If you’re going to deploy your plugin against a v7 (Dynamics 2015) instance:

    Install-Package FakeXrmEasy.Plugins.v2015 -Version 2.x 
    
  • If you’re going to deploy your plugin against a v6 (Dynamics 2013) instance:

    Install-Package FakeXrmEasy.Plugins.v2013 -Version 2.x 
    
  • If you’re going to deploy your plugin against a v5 (Dynamics 2011) instance:

    Install-Package FakeXrmEasy.Plugins.v2011 -Version 2.x 
    

Plugins

If you want to develop and test plugins, please install

Install-Package FakeXrmEasy.Plugins.vxxx -Version 2.x 

CodeActivities

Code Activities are steps in traditional, now legacy, workflows

If you want to develop and test code activities, please install

Install-Package FakeXrmEasy.CodeActivities.vxxx -Version 2.x 

Minimal

For a minimal setup, just go for the FakeXrmEasy.Core. the version will vary depending if you want .net core 3.1 (3.x) or .NET framework (2.x). This version is ideal for testing AzureFunctions, backend of MVC applications or any other kind of application that is not Plugins or CodeActivities.

The minimal setup contains only the messages supported by the AddCrud extension method:

  • Create, Retrieve, RetrieveMultiple, Update, Upsert, Delete, Associate, Dissassociate

If you need other messages, then please install the FakeXrmEasy.Messages package.

Install-Package FakeXrmEasy.Core.vxxx -Version 2.x 

Messages

This package contains implementations for further OrganizationRequests.

Install-Package FakeXrmEasy.Messages.vxxx -Version 2.x 

Can I get a little bit of everything?

If you have a project with a mixture of plugins, codeactivities and other code, you might want to install just FakeXrmEasy then. FakeXrmEasy is an include package that will install Core, Messages, Plugins, and CodeActivities, basically everything. If you don’t have that kind of mixture it might be just simpler to install what you need.

For .NET Framework:

Install-Package FakeXrmEasy.vxxx -Version 2.x 

For .net core 3.1:

Install-Package FakeXrmEasy.vxxx -Version 3.x