Bevor Sie beginnen
- Ein Kameleoon-Projekt. Jedes SDK benötigt einen Site-Code, um sich mit Ihrem Kameleoon-Konto zu verbinden. Wenn Sie noch keinen haben, fügen Sie ein neues Projekt hinzu und wählen Sie auf Nachfrage die SDK-Option.
- API-Anmeldeinformationen für Serverseitige SDKs. Serverseitige SDKs authentifizieren sich mit einer Client-ID und einem Client-Secret. Sie finden diese Werte unter API-Anmeldeinformationen oder können sie dort generieren. Clientseitige und mobile SDKs authentifizieren sich allein mit dem Site-Code Ihres Projekts.
- Ein Feature Flag zum Testen. Erstellen Sie ein Feature Flag in Ihrem Konto, damit Sie nach der Initialisierung des Clients etwas zum Überprüfen haben.
SDK auswählen
Wählen Sie Ihre Plattform und anschließend Ihre Sprache. Jede Karte verweist direkt auf die Installations- und Initialisierungsschritte des jeweiligen SDKs.Web
JavaScript/TypeScript
Frameworkunabhängiges clientseitiges SDK für jede Web-App. Installieren Sie es mit dem SDK Installer oder mit einem einzelnen
<script>-Tag ohne Build-Schritt.React
React-Bindings mit Hooks und einer Provider-Komponente. Installieren Sie es mit dem SDK Installer.
Serverseitig
Node.js
Serverseitiges SDK für Node.js, mit manueller Konfiguration für Deno. Installieren Sie es mit dem SDK Installer.
Java
Läuft auf Java-EE- oder Jakarta-EE-Anwendungsservern. Installieren Sie es über Maven Central.
C#
Läuft auf .NET-Anwendungsservern. Installieren Sie es mit NuGet, der .NET CLI oder Paket.
PHP
Läuft auf PHP-Backend-Servern, optional mit Tracking von Cron-Jobs. Installieren Sie es mit Composer.
Python
Läuft auf Python-Backend-Servern, einschließlich Django. Installieren Sie es mit pip.
Ruby
Läuft auf Ruby-Backend-Servern und Rails-Apps. Installieren Sie es mit RubyGems.
Go
Läuft in Go-Web-Apps und -Diensten. Installieren Sie es mit
go get direkt aus dem Kameleoon-GitHub-Repository.Rust
Läuft in Rust-Diensten und Web-Backends. Erfordert eine asynchrone Laufzeitumgebung wie
tokio. Installieren Sie es mit Cargo.
Elixir
Läuft in Elixir-Diensten und Web-Backends. Enthält nativen Code, der aus dem Rust-Kern erstellt wird, daher müssen Rust und Cargo in Ihrem
PATH verfügbar sein. Installieren Sie es mit Mix.Mobil
Android
Für native Android-Apps. Installieren Sie es mit Gradle.
iOS
Für native iOS-Apps, die mit Swift 5.0 oder höher entwickelt wurden. Installieren Sie es mit CocoaPods oder dem Swift Package Manager.
Flutter
Für alle Plattformen, die das Flutter-Framework unterstützt. Installieren Sie es, indem Sie in
pubspec.yaml eine Abhängigkeit deklarieren.React Native
Verwendet dasselbe Paket
@kameleoon/react-sdk wie das React SDK, mit eingebundenen React-Native-spezifischen Abhängigkeiten. Installieren Sie es mit dem SDK Installer.Prüfen, ob das SDK initialisiert ist
Jedes Kameleoon SDK wird asynchron initialisiert: Der Client beginnt im Hintergrund mit dem Abruf Ihrer Flag-Konfiguration, sobald Sie ihn erstellen, und ist kurz danach bereit. Wenn Sie ein Flag auswerten, bevor der Client bereit ist, kann statt der erwarteten Variation eine Standard- oder Referenzvariation zurückgegeben werden. Prüfen Sie daher die Bereitschaft, bevor Sie sich auf Flag-Ergebnisse verlassen. Web- und Serverseitige SDKs stellen jeweils einen blockierenden Aufruf bereit, der auf den Abschluss dieses ersten Abrufs wartet:
Android, iOS und Flutter blockieren die Client-Erstellung nicht, bis der erste Abruf abgeschlossen ist. Verwenden Sie stattdessen die für das jeweilige SDK dokumentierte Bereitschaftsprüfung, etwa
isReady() (Android), .ready (iOS) oder isReadyAsync() (Flutter), oder kapseln Sie die Flag-Auswertung im runWhenReady()-Callback des SDKs.
Sobald der Client bereit ist, werten Sie das zuvor erstellte Feature Flag aus, um die Integration durchgängig zu bestätigen. Den gesamten Lebenszyklus von der Initialisierung über die Flag-Auswertung bis zum Tracking beschreibt der SDK-Ausführungsablauf.
Nächste Schritte
- Tutorial zur SDK-Einrichtung und zu Feature Flags: eine ausführlichere Anleitung zum Aktivieren eines Feature Flags, mit dem Node.js SDK als Referenzimplementierung.
- Unterstützte Plattformen: die vollständige Kompatibilitätsmatrix der SDK-Versionen und Funktionen nach Sprache.
- SDKs plattformübergreifend koordinieren: Geben Sie denselben Besuchercode zwischen Web-, mobilen und Serverseitigen SDKs weiter, damit Besucher überall dieselbe Erfahrung haben.