Dapr SDK for .NET
Go to file
Whit Waldo 89d9d56bd5
Fixed Jobs SDK bugs (#1456)
fix: Point-in-time not getting scheduled, job payload not being property set on job invocation

When setting a single point-in-time job, the SDK was incorrectly assigning it as a schedule which would promptly fail cron validation. Rather, this now properly sets it to `dueTime` instead. Further, when a Job is invoked, only the payload it was registered with is provided in the callback, not all the elements of a Get Job response, so this was modified to return the `ReadOnlyMemory<byte>` originally provided in the payload back to the caller.

Reviewed by: @philliphoff
Refs: #1455 #1457
2025-02-11 01:16:35 -06:00
.devcontainer Bug/476 multiple methods per interface with JSON serialization doesn´t work (#1343) 2024-12-03 14:26:00 -06:00
.github Support .NET 9 (#1404) 2024-12-03 23:50:42 -06:00
daprdocs Fixed Jobs SDK bugs (#1456) 2025-02-11 01:16:35 -06:00
docs Add RELEASE doc. (#1433) 2024-12-17 18:47:53 -06:00
examples Fixed Jobs SDK bugs (#1456) 2025-02-11 01:16:35 -06:00
properties Fixed security advisory updates across dependencies (transitive and direct) (#1366) 2024-10-15 18:09:53 -05:00
src Fixed Jobs SDK bugs (#1456) 2025-02-11 01:16:35 -06:00
test Fixed Jobs SDK bugs (#1456) 2025-02-11 01:16:35 -06:00
.codecov.yml Added codecov integration (#436) 2020-10-19 19:06:21 -07:00
.editorconfig [Workflow] Improve management API usability (#1087) 2023-05-12 15:44:33 -07:00
.gitignore Implement Bulk Publish functionality (#1001) 2023-01-26 11:34:09 -08:00
CODEOWNERS Update CODEOWNERS 2021-07-13 11:30:41 -07:00
CONTRIBUTING.md Improvement of the dotnet-contributing files (#1330) 2024-10-16 15:41:46 -05:00
Directory.Packages.props DurableTask package dependency update (#1452) 2025-02-03 12:47:05 -06:00
LICENSE replaced license headers (#802) 2021-12-10 13:39:06 -08:00
README.md Fixed badge broken links (#1290) 2024-05-21 21:25:19 -07:00
all.sln Add .NET client for LLM Conversations support (#1382) 2024-12-10 09:06:44 -06:00
global.json Support .NET 9 (#1404) 2024-12-03 23:50:42 -06:00

README.md

Dapr SDK for .NET

NuGet Version NuGet Downloads GitHub Actions Workflow Status codecov GitHub License GitHub issue custom search in repo Discord YouTube Channel Views X (formerly Twitter) Follow

Dapr SDK for .NET allows you to:

  • Interact with Dapr applications through a Dapr client
  • Build routes and controllers in ASP.NET
  • 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.

Releases

We publish nuget packages to nuget.org for each release.

Using nugets built locally in your project

<RepoRoot> is the path where you cloned this repository. Nuget packages are dropped under /bin/<Debug|Release>/nugets when you build locally.

Example

# Add Dapr.Actors nuget package
dotnet add package Dapr.Actors -s <RepoRoot>/bin/<Debug|Release>/nugets

# Add Dapr.Actors.AspNetCore nuget package
dotnet add package Dapr.Actors.AspNetCore -s <RepoRoot>/bin/<Debug|Release>/nugets

Documentation

The docs for the Dapr .NET SDK can be found on the Dapr docs site.

Examples

Visit the examples folder for a variety of examples to get you up and running with the Dapr .NET SDK.

Contributing

This repo builds the following packages:

  • Dapr.Client
  • Dapr.AspNetCore
  • Dapr.Actors
  • Dapr.Actors.AspNetCore
  • Dapr.Extensions.Configuration
  • Dapr.Workflow

Prerequisites

Each project is a normal C# project. At minimum, you need .NET 6.0 SDK to build, test, and generate NuGet packages.

Also make sure to reference the .NET SDK contribution guide

macOS/Linux:

On macOS or Linux we recommend Visual Studio Code with the C# Extension. See here for a getting started guide for VS Code and .NET.

Windows:

On Windows, we recommend installing the latest Visual Studio 2019 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.

Build

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

# Build sdk, samples and tests.
dotnet build -c Debug  # for release, -c Release

# Run unit-test
dotnet test

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

Each project can also be built individually directly through the CLI or your editor/IDE. You can open the solution file all.sln in repo root to load all sdk, samples and test projects.