Dapr SDK for .NET

Dapr is a programming model for writing cloud-native applications which are distributed, dynamically scaled, and loosely coupled in nature.

Dapr SDK for .NET allows you to implement the Virtual Actor model, based on the actor design pattern. This SDK can run locally, in a container and in any distributed systems environment.

This repo builds the following packages:

• Microsoft.Dapr.Actors
• Microsoft.Dapr.Actors.AspNetCore

Getting Started

Prerequesites

Each project is a normal C# Visual Studio 2019 project. At minimum, you need .NET Core SDK 3.0 to build and generate NuGet packages.

We recommend installing Visual Studio 2019 v16.3 or later which will set you up with all the .NET build tools and allow you to open the solution files. Community Edition is free and can be used to build everything here. Make sure you update Visual Studio to the most recent release. To find a version of .NET Core that can be used with earlier versions of Visual Studio, see [].NET SDKs for Visual Studio](https://dotnet.microsoft.com/download/visual-studio-sdks).

Build

To build everything and generate NuGet packages, run dotnet cli commands. NuGet packages will be dropped in a bin directory at the repo root.

# Build SDK
dotnet build -c Debug  # for release, -c Release

# Run unit-test
dotnet test

# Generate nuget packages in /bin/Debug/
dotnet pack

Each project can also be built individually directly through Visual Studio.

Releases

Until we publish nuget packages to nuget.org, you can download the latest nuget packages signed by Microsoft from Preview Kit release.

Add nuget to your project

Assume that you download nuget packages to you local disk, /pkg/nugets/.

# Add Microsoft.Dapr.Actors nuget package
dotnet add package Microsoft.Dapr.Actors -v 0.4.0-preview01 -s /pkg/nugets/

# Add Microsoft.Dapr.Actors.AspNetCore nuget package
dotnet add package Microsoft.Dapr.Actors.AspNetCore -v 0.4.0-preview01 -s /pkg/nugets/

Documentation

These articles will help get you started with Dapr runtime and Dapr Actors:

• Getting started with Dapr Actor
• Dapr CLI
• Dapr API Specification