ConfigCat.Client
6.5.1
Install-Package ConfigCat.Client -Version 6.5.1
dotnet add package ConfigCat.Client --version 6.5.1
<PackageReference Include="ConfigCat.Client" Version="6.5.1" />
paket add ConfigCat.Client --version 6.5.1
#r "nuget: ConfigCat.Client, 6.5.1"
// Install ConfigCat.Client as a Cake Addin
#addin nuget:?package=ConfigCat.Client&version=6.5.1
// Install ConfigCat.Client as a Cake Tool
#tool nuget:?package=ConfigCat.Client&version=6.5.1
ConfigCat SDK for .NET
Supported frameworks:
- .NET Core
- .NET Framework
- Xamarin
- .NET Standard
ConfigCat SDK for .NET provides easy integration for your application to ConfigCat.
ConfigCat is a feature flag and configuration management service that lets you separate releases from deployments. You can turn your features ON/OFF using ConfigCat Dashboard even after they are deployed. ConfigCat lets you target specific groups of users based on region, email or any other custom user attribute.
ConfigCat is a hosted feature flag service. Manage feature toggles across frontend, backend, mobile, desktop apps. Alternative to LaunchDarkly. Management app + feature flag SDKs.
Getting Started
1. Install the package with NuGet
Install-Package ConfigCat.Client
or
dotnet add package ConfigCat.Client
2. Import ConfigCat.Client to your application
using ConfigCat.Client;
3. Go to the ConfigCat Dashboard to get your SDK Key:
4. Create a ConfigCat client instance:
var client = new ConfigCatClient("#YOUR-SDK-KEY#");
We strongly recommend using the ConfigCat Client as a Singleton object in your application.
5. Get your setting value:
var isMyAwesomeFeatureEnabled = client.GetValue("isMyAwesomeFeatureEnabled", false);
if(isMyAwesomeFeatureEnabled)
{
doTheNewThing();
}
else
{
doTheOldThing();
}
6. On application exit:
client.Dispose();
To ensure graceful shutdown of the client you should invoke
.Dispose()
method. (Client implements IDisposable interface)
Getting user specific setting values with Targeting
Using this feature, you will be able to get different setting values for different users in your application by passing a User Object
to the GetValue()
function.
Read more about Targeting here.
User currentUser = new User("435170f4-8a8b-4b67-a723-505ac7cdea92");
var isMyAwesomeFeatureEnabled = client.GetValue(
"isMyAwesomeFeatureEnabled",
defaultValue: false,
user: currentUser);
Sample/Demo apps
Polling Modes
The ConfigCat SDK supports 3 different polling mechanisms to acquire the setting values from ConfigCat. After latest setting values are downloaded, they are stored in the internal cache then all requests are served from there. Read more about Polling Modes and how to use them at ConfigCat Docs.
Need help?
Contributing
Contributions are welcome. For more info please read the Contribution Guideline.
About ConfigCat
Product | Versions |
---|---|
.NET | net5.0 net5.0-windows net6.0 net6.0-android net6.0-ios net6.0-maccatalyst net6.0-macos net6.0-tvos net6.0-windows |
.NET Core | netcoreapp2.0 netcoreapp2.1 netcoreapp2.2 netcoreapp3.0 netcoreapp3.1 |
.NET Standard | netstandard2.0 netstandard2.1 |
.NET Framework | net45 net451 net452 net46 net461 net462 net463 net47 net471 net472 net48 |
MonoAndroid | monoandroid |
MonoMac | monomac |
MonoTouch | monotouch |
Tizen | tizen40 tizen60 |
Xamarin.iOS | xamarinios |
Xamarin.Mac | xamarinmac |
Xamarin.TVOS | xamarintvos |
Xamarin.WatchOS | xamarinwatchos |
-
.NETFramework 4.5
- Newtonsoft.Json (>= 13.0.1)
- System.Data.HashFunction.MurmurHash (>= 2.0.0)
- System.Memory (>= 4.5.4)
- System.Net.Http (>= 4.3.4)
- System.Text.RegularExpressions (>= 4.3.1)
- System.Threading.Tasks.Extensions (>= 4.5.4)
-
.NETFramework 4.6.1
- System.Data.HashFunction.MurmurHash (>= 2.0.0)
- System.Net.Http (>= 4.3.4)
- System.Text.Json (>= 6.0.2)
- System.Text.RegularExpressions (>= 4.3.1)
-
.NETStandard 2.0
- System.Data.HashFunction.MurmurHash (>= 2.0.0)
- System.Net.Http (>= 4.3.4)
- System.Text.Json (>= 6.0.2)
- System.Text.RegularExpressions (>= 4.3.1)
-
.NETStandard 2.1
- System.Data.HashFunction.MurmurHash (>= 2.0.0)
- System.Net.Http (>= 4.3.4)
- System.Text.Json (>= 6.0.2)
- System.Text.RegularExpressions (>= 4.3.1)
-
net5.0
- System.Data.HashFunction.MurmurHash (>= 2.0.0)
- System.Net.Http (>= 4.3.4)
- System.Text.Json (>= 6.0.2)
- System.Text.RegularExpressions (>= 4.3.1)
-
net6.0
- System.Data.HashFunction.MurmurHash (>= 2.0.0)
- System.Net.Http (>= 4.3.4)
- System.Text.Json (>= 6.0.2)
- System.Text.RegularExpressions (>= 4.3.1)
NuGet packages (6)
Showing the top 5 NuGet packages that depend on ConfigCat.Client:
Package | Downloads |
---|---|
Musement.Extensions.Configuration.ConfigCat
A .NET configuration provider for ConfigCat |
|
Codelux.NetCore
A collection of tools that simplify and abstract processes such as dependency injection, password encryption etc. Includes various ServiceStack helper libraries. Codelux.NetCore is a set of tools and libraries that simplify processes such as encrypting passwords, injecting dependencies and implementing caches. It contains a variety of helpful tools that can assist a developer to speed up the coding process and avoid spending time to re-invent the wheel. |
|
Xamarin.Security
Add your app security control by using cloud's feature flags |
|
XamarinSecurityTest
Add your app security control by using cloud's feature flags |
|
TestNugetXamSecurLibrary
Package Description |
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
6.5.1 | 39,242 | 4/7/2022 |
6.5.0 | 145 | 4/6/2022 |
6.4.12 | 126 | 4/4/2022 |
6.4.9 | 5,794 | 3/4/2022 |
6.4.8 | 67 | 3/3/2022 |
6.4.7 | 61 | 3/3/2022 |
6.4.6 | 86 | 3/3/2022 |
6.4.3 | 67 | 3/3/2022 |
6.4.0 | 71 | 3/3/2022 |
6.2.1 | 59,726 | 9/20/2021 |
6.1.20 | 2,933 | 9/8/2021 |
6.1.0 | 430,668 | 1/7/2021 |
6.0.47 | 244 | 1/7/2021 |
6.0.0 | 26,402 | 10/12/2020 |
5.3.77 | 19,923 | 9/1/2020 |
5.2.58 | 25,894 | 7/2/2020 |
5.1.53 | 50,175 | 4/19/2020 |
5.0.39 | 1,794 | 4/9/2020 |
4.0.36 | 20,815 | 2/27/2020 |
3.2.28 | 32,659 | 1/15/2020 |
3.1.23 | 504 | 12/28/2019 |
3.0.19 | 1,653 | 11/25/2019 |
2.5.6 | 22,007 | 9/9/2019 |
2.5.3 | 420 | 8/8/2019 |
2.4.0 | 1,033 | 7/27/2019 |
2.3.0 | 427 | 7/19/2019 |
2.2.2 | 421 | 7/14/2019 |
2.2.1 | 47,128 | 4/9/2019 |
2.1.4 | 641 | 11/26/2018 |
2.1.3 | 546 | 11/21/2018 |
2.1.0 | 529 | 11/9/2018 |
2.0.1 | 653 | 10/23/2018 |
2.0.0 | 586 | 10/9/2018 |
1.1.6 | 737 | 5/9/2018 |
1.1.5 | 739 | 4/26/2018 |
1.1.3 | 716 | 4/17/2018 |
1.1.2 | 839 | 4/8/2018 |