Antes de empezar
- Un proyecto de Kameleoon. Cada SDK necesita un site code para conectarse a su cuenta de Kameleoon. Si todavía no tiene uno, añada un nuevo proyecto y elija la opción de SDK cuando se le solicite.
- Credenciales de API para los SDK de servidor. Los SDK de servidor se autentican con un client ID y un client secret. Encuéntrelos o genérelos en Credenciales de API. Los SDK de cliente y los móviles se autentican únicamente con el site code de su proyecto.
- Un feature flag con el que probar. Cree un feature flag en su cuenta para tener algo que comprobar cuando el cliente se inicialice.
Elegir su SDK
Seleccione su plataforma y, a continuación, su lenguaje. Cada tarjeta enlaza directamente con los pasos de instalación e inicialización del SDK correspondiente.Web
JavaScript/TypeScript
SDK de cliente independiente del framework, para cualquier aplicación web. Instálelo con el SDK Installer o con una sola etiqueta
<script>, sin paso de compilación.React
Enlaces de React con hooks y un componente provider. Instálelo con el SDK Installer.
Servidor
Node.js
SDK de servidor para Node.js, con configuración manual para Deno. Instálelo con el SDK Installer.
Java
Se ejecuta en servidores de aplicaciones Java EE o Jakarta EE. Instálelo desde Maven Central.
C#
Se ejecuta en servidores de aplicaciones .NET. Instálelo con NuGet, la CLI de .NET o Paket.
PHP
Se ejecuta en servidores backend PHP, con seguimiento opcional de tareas cron. Instálelo con Composer.
Python
Se ejecuta en servidores backend Python, incluido Django. Instálelo con pip.
Ruby
Se ejecuta en servidores backend Ruby y en aplicaciones Rails. Instálelo con RubyGems.
Go
Se ejecuta en aplicaciones web y servicios Go. Instálelo directamente desde el repositorio de GitHub de Kameleoon con
go get.Rust
Se ejecuta en servicios Rust y backends web. Requiere un runtime asíncrono, como
tokio. Instálelo con Cargo.
Elixir
Se ejecuta en servicios Elixir y backends web. Incluye código nativo compilado a partir del núcleo de Rust, por lo que Rust y Cargo deben estar en su
PATH. Instálelo con Mix.Móvil
Android
Para aplicaciones Android nativas. Instálelo con Gradle.
iOS
Para aplicaciones iOS nativas creadas con Swift 5.0 o superior. Instálelo con CocoaPods o Swift Package Manager.
Flutter
Para todas las plataformas a las que se dirige el framework Flutter. Instálelo declarando una dependencia en
pubspec.yaml.React Native
Usa el mismo paquete
@kameleoon/react-sdk que el SDK de React, con las dependencias específicas de React Native incorporadas. Instálelo con el SDK Installer.Comprobar que el SDK está inicializado
Todos los SDK de Kameleoon se inicializan de forma asíncrona: el cliente empieza a obtener la configuración de sus flags en segundo plano en cuanto lo crea y queda listo poco después. Evaluar un flag antes de que el cliente esté listo puede devolver una variación predeterminada o de referencia en lugar de la que espera, así que confirme que el cliente está listo antes de confiar en los resultados de los flags. Los SDK web y de servidor exponen cada uno una llamada bloqueante que espera a que termine esa primera obtención:
Android, iOS y Flutter no bloquean la creación del cliente durante la primera obtención. Use en su lugar la comprobación de disponibilidad documentada para ese SDK, como
isReady() (Android), .ready (iOS) o isReadyAsync() (Flutter), o envuelva la evaluación del flag en el callback runWhenReady() del SDK.
Cuando el cliente esté listo, evalúe el feature flag que creó antes para confirmar la integración de principio a fin. Para conocer el ciclo de vida completo, desde la inicialización hasta la evaluación de flags y el seguimiento, consulte Flujo de ejecución del SDK.
Siguientes pasos
- Configuración del SDK y tutorial de feature flags: una guía más detallada para activar un feature flag, con el SDK de Node.js como implementación de referencia.
- Plataformas compatibles: la matriz de compatibilidad completa de versiones y funciones de los SDK por lenguaje.
- Coordinar los SDKs entre plataformas: transmita el mismo código de visitante entre los SDK web, móviles y de servidor para que cada visitante tenga una experiencia coherente en todas partes.