Guía rápida de Android

En unos minutos tu app de Android leerá un feature flag real — con caché duradera, segura sin conexión, con la identidad del dispositivo emitida y guardada por ti.

Requiere minSdk 26 (Android 8.0). Kotlin, con las corrutinas como única familia de dependencias.

1. Instala

El SDK vive en un repositorio público en GitHub — consúmelo como dependencia de código fuente: clona FortressFlag_SDK_android en la etiqueta v1.0.0 y añádelo a tu proyecto como un build incluido de Gradle, cuyo módulo de biblioteca es fortressflag.

git clone --branch v1.0.0 https://github.com/FortressFlag/FortressFlag_SDK_android

2. Arranca el SDK

Una vez, al iniciar la app — tu Application.onCreate es el sitio natural:

import com.fortressflag.sdk.Configuration
import com.fortressflag.sdk.Environment
import com.fortressflag.sdk.FortressFlag

FortressFlag.start(
    context,
    Configuration(
        sdkKey = "ffc_prod_…",                // de la pantalla Claves SDK de tu proyecto
        environment = Environment.PRODUCTION,
    ),
)

El SDK carga los valores en caché de inmediato y sondea en busca de cambios en segundo plano. La clave es una clave de cliente — viaja en tu app por diseño.

3. Lee un flag

if (FortressFlag.isEnabled("new-checkout", default = false)) {
    // muestra el nuevo checkout
}

stringValue y numberValue leen los flags multivariantes de la misma manera, y cada lectura se sirve desde memoria — sin E/S, sin red, en el hilo desde el que llames.

Eso es todo — tu flag está activo. Cámbialo en el panel y la app le sigue en su siguiente sondeo.

Si FortressFlag se cae, tu app no

isEnabled, stringValue y numberValue nunca lanzan excepciones. Cada lectura recurre a los últimos valores que este dispositivo vio de verdad — incluidos los de ejecuciones anteriores, a través de la caché duradera — y después a tu valor por defecto en el punto de llamada. Una caída nunca llega a tus usuarios.

Dos hechos de la plataforma, antes de que lleguen a una factura

FortressFlag factura por dispositivo, y Android tiene dos hechos que conviene conocer de antemano:

• La identidad es por app hoy. Si un usuario ejecuta tres de tus apps en un teléfono, eso cuenta actualmente como hasta tres dispositivos — las apps de Android todavía no comparten una identidad de FortressFlag como puede hacerlo una familia de apps de iOS.
• Desinstalar tu app borra la identidad. Android limpia los datos de la app respaldados por el Keystore al desinstalar, así que una reinstalación emite una identidad nueva — y cuenta como un dispositivo nuevo. (Esto difiere de iOS, donde el llavero persiste.)

La identidad en sí se emite de forma aleatoria y es seudónima — nunca se deriva de ANDROID_ID ni de ningún identificador de hardware. Y los emuladores emiten una identidad sim_: se les sirven flags con normalidad, nunca se facturan.

¿Por dónde seguir?

• Cómo llegan los flags a tu app — qué hace el sondeo en segundo plano
• Identidad del dispositivo y facturación — la historia completa de la identidad
• Targeting — sirve valores distintos a dispositivos distintos