mirror of
https://github.com/Unleash/unleash.git
synced 2024-12-22 19:07:54 +01:00
Merge pull request #1174 from Unleash/docs/sdk-compatibility
docs: Add server-side SDK compatibility table to SDK docs
This commit is contained in:
Thomas Heartman
GitHub
commit
c0f7f09e1a
@ -4,11 +4,15 @@ title: Introduction
|
||||
slug: /sdks
|
||||
---
|
||||
|
||||
In order to connect your application to Unleash you need to use a client SDK (software developer kit) for your programming language. In addition you will need a [API token](../user_guide/api-token). The SDK will handle connecting to the Unleash server instance and retrieve feature toggles based upon your configuration. Both open-source and the Unleash enterprise offering utilize the same set of client SDKs.
|
||||
In order to connect your application to Unleash you will need a client SDK (software developer kit) for your programming language and an [API token](../user_guide/api-token). The SDK will handle connecting to the Unleash server instance and retrieving feature toggles based on your configuration. All versions of Unleash (OSS, Pro, and Enterprise) use the same client SDKs.
|
||||
|
||||
On this page you will find examples for connecting your application to the demo instance. If you are connecting to your own private instance you will have to remember to replace the `API token` and the `API url` given in the examples.
|
||||
Unleash provides official client SDKs for a number of programming language. Additionally, our community have developed and contributed SDKs for other languages. So if you can't find your favorite language in the list of official SDKs, check out the [list of clients written by our fantastic community](#clients-written-by-awesome-enthusiasts).
|
||||
|
||||
**Official Server SDKs**:
|
||||
## Official SDKs
|
||||
|
||||
### Server-side SDKs:
|
||||
|
||||
Server-side clients run on your server and communicate directly with your Unleash instance. We provide these official clients:
|
||||
|
||||
- [Java SDK](/sdks/java_sdk)
|
||||
- [Node.js SDK](/sdks/node_sdk)
|
||||
@ -18,14 +22,85 @@ On this page you will find examples for connecting your application to the demo
|
||||
- [.Net SDK](/sdks/dot_net_sdk)
|
||||
- [PHP SDK](/sdks/php_sdk)
|
||||
|
||||
**Official Frontend Unleash Proxy SDKs:**
|
||||
### Front-end SDKs
|
||||
|
||||
For security and performance reasons, the front-end SDKs do not communicate directly with your Unleash instance. Instead, they go via the [Unleash Proxy](unleash-proxy.md).
|
||||
|
||||
- [Javascript SDK](/sdks/proxy-javascript)
|
||||
- [Android SDK](/sdks/android_proxy_sdk)
|
||||
- [iOS Proxy SDK](/sdks/proxy-ios)
|
||||
- [React Proxy SDK](/sdks/proxy-react)
|
||||
|
||||
### Clients written by awesome enthusiasts: {#clients-written-by-awesome-enthusiasts}
|
||||
|
||||
### Server-side SDK compatibility table
|
||||
|
||||
The below table shows what features the various server-side SDKs support. Note that certain features make sense only for some clients due to how the programming language works or due to how the client works.
|
||||
|
||||
**Legend**:
|
||||
|
||||
- ✅: Implemented
|
||||
- ⭕: Not yet implemented, but we're looking into it
|
||||
- ❌: Not implemented, not planned
|
||||
- **N/A**: Not applicable to this SDK
|
||||
|
||||
:::note
|
||||
If you see an item marked with a ❌ that you would find useful, feel free to reach out to us ([on Slack](https://join.slack.com/t/unleash-community/shared_invite/zt-8b6l1uut-LL67kLpIXm9bcN3~6RVaRQ), for instance) with your use case. It may not be something we can prioritize right now, but if you'd like to contribute it back to the community, we'd love to help you build it.
|
||||
:::
|
||||
|
||||
|
||||
| Capability | [Java](/sdks/java_sdk) | [Node.js](/sdks/node_sdk) | [Go](/sdks/go_sdk) | [Python](/sdks/python_sdk) | [Ruby](/sdks/ruby_sdk) | [.Net](/sdks/dot_net_sdk) | [PHP](/sdks/php_sdk) | [Unleash Proxy Server](unleash-proxy.md) |
|
||||
|---------------------------------------------------------------------------------------------------|:----------------------:|:-------------------------:|:------------------:|:--------------------------:|:----------------------:|:-------------------------:|:--------------------:|:----------------------------------------:|
|
||||
| **Category: Initialization** | | | | | | | | |
|
||||
| Async initialization | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | N/A |
|
||||
| Can block until synchronized | ✅ | ✅ | ⭕ | ⭕ | ⭕ | ✅ | ⭕ | N/A |
|
||||
| Default refresh interval | 10s | 15s | 15s | 15s | 15s | 30s | 30s | 5s |
|
||||
| Default metrics interval | 60s | 60s | 60s | 60s | 30s | 60s | 30s | 30s |
|
||||
| Context provider | ✅ | N/A | N/A | N/A | N/A | ✅ | ✅ | N/A |
|
||||
| Global fallback function | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | N/A |
|
||||
| Toggle Query: `namePrefix` | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ |
|
||||
| Toggle Query: `tags` | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ |
|
||||
| Toggle Query: `project_name` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | N/A | ✅ |
|
||||
| **Category: Custom Headers** | | | | | | | | |
|
||||
| static | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | N/A |
|
||||
| function | ✅ | ✅ | ⭕ | ✅ | ⭕ | ✅ | ⭕ | N/A |
|
||||
| **Category: Built-in strategies** | | | | | | | | |
|
||||
| [Standard](../user_guide/activation_strategy#standard) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
|
||||
| [Gradual rollout](../user_guide/activation_strategy#gradual-rollout) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
|
||||
| [Gradual rollout: custom stickiness](../user_guide/activation_strategy#customize-stickiness-beta) | ✅ | ✅ | ⭕ | ✅ | ⭕ | ✅ | ✅ | ✅ |
|
||||
| [UserID](../user_guide/activation_strategy#userids) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
|
||||
| [IP](../user_guide/activation_strategy#ips) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
|
||||
| [IP](../user_guide/activation_strategy#ips): CIDR syntax | ✅ | ✅ | ✅ | ✅ | ⭕ | ⭕ | ⭕ | ✅ |
|
||||
| [Hostname](../user_guide/activation_strategy#hostnames) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
|
||||
| **Category: [Custom strategies](../advanced/custom_activation_strategy)** | | | | | | | | |
|
||||
| Basic support | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
|
||||
| **Category: [Strategy constraints](../advanced/strategy_constraints)** | | | | | | | | |
|
||||
| Basic support (`IN`, `NOT_IN` operators) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
|
||||
| **Category: [Unleash Context](../user_guide/unleash_context)** | | | | | | | | |
|
||||
| Static fields (`environment`, `appName`) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
|
||||
| Defined fields | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
|
||||
| Custom properties | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
|
||||
| **Category: [`isEnabled`](../client-specification#implementation-of-isenabled)** | | | | | | | | |
|
||||
| Can take context | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
|
||||
| Override fallback value | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
|
||||
| Fallback function | ✅ | ✅ | ✅ | ✅ | ✅ | ⭕ | ⭕ | ✅ |
|
||||
| **Category: [Variants](../advanced/toggle_variants)** | | | | | | | | |
|
||||
| Basic support | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
|
||||
| Custom fallback variant | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
|
||||
| Custom weight | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
|
||||
| [Custom stickiness (beta)](../advanced/stickiness#custom-stickiness-beta) | ✅ | ✅ | ⭕ | ✅ | ⭕ | ⭕ | ✅ | ✅ |
|
||||
| **Category: Local backup** | | | | | | | | |
|
||||
| File based backup | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
|
||||
| **Category: Usage metrics** | | | | | | | | |
|
||||
| Can disable metrics | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
|
||||
| Client registration | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
|
||||
| Basic usage metrics (yes/no) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
|
||||
| **Category: Bootstrap (beta)** | | | | | | | | |
|
||||
| Bootstrap from file | ✅ | ⭕ | ⭕ | ⭕ | ⭕ | ⭕ | ⭕ | ⭕ |
|
||||
| Custom Bootstrap implementation | ✅ | ⭕ | ⭕ | ⭕ | ⭕ | ⭕ | ⭕ | ⭕ |
|
||||
|
||||
## Clients written by awesome enthusiasts {#clients-written-by-awesome-enthusiasts}
|
||||
|
||||
Here's some of the fantastic work our community has done to make Unleash work in even more contexts. If you still can't find your favorite language, let us know and we'd love to help you create the client for it!
|
||||
|
||||
- [cognitedata/unleash-client-rust](https://github.com/cognitedata/unleash-client-rust) (Rust)
|
||||
- [silvercar/unleash-client-kotlin](https://github.com/silvercar/unleash-client-kotlin) (Kotlin)
|
||||
@ -37,5 +112,3 @@ On this page you will find examples for connecting your application to the demo
|
||||
- [AppsFlyer/clojure-unleash](https://github.com/AppsFlyer/unleash-client-clojure) (Clojure)
|
||||
- [pmb0/nestjs-unleash](https://github.com/pmb0/nestjs-unleash) (NestJS - Node.js)
|
||||
- _...your implementation for your favorite language._
|
||||
|
||||
When you get access to your instance – [create a client secret](../user_guide/api-token), and we will provide you with your API url for your instance.
|
||||
|
||||
Loading…
Reference in New Issue
Block a user