LaunchDarkly: ce este, flaguri funcționale și cum funcționează

Ce este LaunchDarkly?

LaunchDarkly este o platformă de gestionare a flagurilor funcționale, fondată în 2014 de compania Catamorphic Corp. Sarcina principală a serviciului este de a oferi echipelor de dezvoltare posibilitatea de a activa, dezactiva și configura funcțiile aplicației în timp real fără a distribui cod nou.

Spre deosebire de abordarea tradițională, unde lansarea unei noi funcționalități necesită publicarea unei versiuni în magazinul de aplicații, LaunchDarkly permite modificarea comportamentului de la distanță. Pentru dezvoltarea mobilă acest lucru este deosebit de important — revizuirea în App Store și Google Play durează de la câteva ore până la câteva zile, iar un flag poate fi comutat în secunde.

Cum funcționează platforma LaunchDarkly

Arhitectura LaunchDarkly se bazează pe trei componente: serverul de flaguri, SDK-urile client și panoul de control. Serverul stochează configurațiile flagurilor, regulile de activare și segmentele de utilizatori. SDK menține o conexiune SSE permanentă cu serverul pentru a primi actualizări în timp real.

Când un flag este modificat în panou, serverul trimite actualizarea tuturor SDK-urilor conectate. Întârzierea este de 200–500 de milisecunde. La pierderea conexiunii, SDK folosește ultima stare stocată în cache până la restabilirea canalului. Acest lucru garantează că aplicația continuă să funcționeze cu setările actuale la momentul întreruperii.

Panoul de control LaunchDarkly oferă o interfață vizuală pentru crearea și gestionarea flagurilor. Panoul arată starea curentă a fiecărui flag, istoricul modificărilor cu auditul cine și când a schimbat configurația, precum și metricile de utilizare. Pentru fiecare mediu pot fi configurate reguli separate — un flag în staging poate fi activat 100%, iar în production — 5%.

Conceptele cheie LaunchDarkly

Feature flag este un comutator denumit cu reguli și scopuri. Flagurile pot fi boolean, multivariate și JSON. Rules definesc condițiile de activare: de exemplu, „activează pentru 10% dintre utilizatorii Android 12 din Germania“. Segments grupează utilizatorii după versiunea OS, regiune, modelul dispozitivului și atribute arbitrare.

Fiecare flag are medii: development, staging și production. Acest lucru permite testarea unei noi funcții într-un mediu izolat înainte de a o activa pentru utilizatorii reali. Regulile mediilor sunt configurate independent — un flag poate fi activat în staging și dezactivat în production.

SDK și integrarea cu aplicațiile mobile

LaunchDarkly oferă SDK-uri native pentru Android, iOS, React Native și Flutter. Fiecare SDK necesită configurare minimă: cheia SDK și identificatorul utilizatorului. Biblioteca gestionează automat conexiunea, stocarea în cache și gestionarea erorilor.

Inițializarea Android SDK

Pentru conectare, se creează o instanță LDClient în Application.onCreate. Clientul acceptă configurația cu cheia mobilă și contextul utilizatorului. După inițializare, aplicația apelează variația flagului în orice loc al codului prin metoda boolVariation.

class MyApplication : Application() {
    private lateinit var ldClient: LDClient

    override fun onCreate() {
        super.onCreate()
        val config = LDConfig.Builder("mobile-key-abc123")
            .build()
        val user = LDUser.Builder("user-unique-id")
            .build()
        ldClient = LDClient.init(this, config, user)
    }
}

Citirea și abonarea la modificările flagului

După inițializare, verificarea flagului se face cu o singură metodă. BoolVariation returnează valoarea conform regulilor flagului. Valoarea implicită este utilizată dacă SDK nu a reușit să obțină configurația. Metoda boolVariationDetail returnează suplimentar motivul pentru care flagul a acceptat această valoare.

val ldClient = LDClient.get()
val showNewFeature = ldClient.boolVariation(
    "new-checkout-flow",
    false
)
if (showNewFeature) {
    showNewCheckoutScreen()
} else {
    showLegacyCheckoutScreen()
}

Testarea A/B și lansarea treptată prin LaunchDarkly

Testarea A/B în LaunchDarkly este implementată prin flaguri multivariate. Fiecărei variante i se atribuie un procent de trafic — de exemplu, 50% dintre utilizatori văd ecranul vechi (varianta A) și 50% — noul (varianta B). Platforma înregistrează utilizatorul, garantând că acesta ajunge întotdeauna în același grup.

Lansarea treptată crește procentul utilizatorilor cu acces la funcție treptat. Programul tipic: 1% — prima zi, 5% — a doua, 25% — a treia, 100% — după o săptămână. La detectarea unei erori, flagul este dezactivat instantaneu pentru toți. LaunchDarkly se integrează cu Amplitude, Mixpanel și Google Analytics pentru urmărirea metricilor fiecărei variații.

Metrici și experimente

Platforma oferă un sistem încorporat de experimente care calculează automat semnificația statistică a diferențelor dintre variante. Metrici disponibile: conversie, retenție, numărul de sesiuni, erori și evenimente personalizate. Rezultatele sunt afișate în panou cu vizualizarea intervalelor de încredere. Experimentele pot fi rulate atât pe traficul de producție, cât și pe segmente separate de utilizatori.

Integrarea LaunchDarkly cu platformele analitice este un alt avantaj. Datele despre flaguri sunt trimise automat către Amplitude, Mixpanel, Google Analytics sau propriul pipeline de date prin Data Export API. Acest lucru permite crearea de rapoarte privind impactul fiecărei funcții asupra metricilor cheie ale aplicației. LaunchDarkly suportă, de asemenea, webhook-uri pentru notificarea sistemelor externe despre modificarea stării flagurilor.

Exemplu de integrare LaunchDarkly SDK în Android

Să analizăm ciclul complet: adăugarea dependenței, inițializarea și verificarea flagului pentru telemetria blocărilor. Funcția ar trebui să fie activă doar pentru testeri, nu pentru utilizatorii reali. LaunchDarkly SDK pentru Android este disponibil prin Maven Central. Versiunea 5.x suportă Kotlin Coroutines și Jetpack Compose pentru primirea reactivă a actualizărilor flagurilor.

Pentru aplicațiile iOS, LaunchDarkly oferă suport pentru Swift Package Manager și CocoaPods. Swift SDK folosește async/await pentru inițializarea asincronă și Combine framework pentru abonarea la modificări. Ambele SDK (Android și iOS) suportă sincronizarea în fundal și stocarea în cache în memoria locală pentru funcționarea în modul offline.

Dependența în build.gradle

// app/build.gradle
dependencies {
    implementation "com.launchdarkly:launchdarkly-android-sdk:5.2.0"
}

Verificarea flagului în CrashReporter

În clasa CrashReporter verificăm flagul crash-reporting-enabled. Dacă flagul este activat pentru utilizatorul curent — pornim trimiterea rapoartelor de blocare. SDK va primi automat noua stare la modificarea pe server, dar pentru inițializare este suficientă o verificare unică.

class CrashReporter {
    fun init() {
        val client = LDClient.get()
        if (client.boolVariation("crash-reporting-enabled", false)) {
            Crashlytics.start()
        }
    }
}

Scenarii tipice și anti-pattern-uri

Scenarii de succes: gestionarea fluxului de plată cu dezactivare instantanee la defecțiuni ale furnizorului, lansarea treptată a modificărilor UI cu monitorizarea metricilor, personalizarea conținutului pe segmente. Potrivit blogului oficial LaunchDarkly, echipele reduc timpul de recuperare după erori de la ore la minute.

Anti-pattern-uri: utilizarea flagurilor pentru logică condițională permanentă (flagurile sunt temporare), stocarea secretelor în atributele flagurilor, crearea de reguli suprapuse. Recomandare: ștergeți flagul din cod după finalizarea lansării — acest lucru previne datoria tehnică și complexitatea bazei de cod. O altă greșeală comună este utilizarea flagurilor ca comutatoare de lungă durată care nu sunt niciodată eliminate din cod după stabilizarea funcției.

Strategia corectă de gestionare a flagurilor include un plan de eliminare pentru fiecare flag nou. LaunchDarkly oferă instrumente încorporate pentru detectarea flagurilor neutilizate — un flag este considerat neutilizat dacă SDK nu i-a verificat valoarea mai mult de 30 de zile. Astfel de flaguri sunt marcate în panou și pot fi șterse în siguranță din cod.

Când să renunțați la LaunchDarkly

Pentru proiectele mici cu o singură echipă, LaunchDarkly poate fi excesiv — este suficient un simplu conditional în cod sau Firebase Remote Config. Alegeți platforma atunci când este necesară segmentare complexă, audit al modificărilor, experimente A/B sau gestionarea multi-echipă a flagurilor. Pentru startup-uri și proiecte MVP, LaunchDarkly oferă un plan Starter gratuit cu limitare a numărului de flaguri și MAU.

Compatibilitatea LaunchDarkly cu instrumentele existente este un criteriu important de selecție. Platforma se integrează cu Jira, Slack, PagerDuty, Datadog și alte servicii prin webhook-uri și API. Echipele care folosesc deja aceste instrumente beneficiază de o integrare perfectă fără infrastructură suplimentară pentru monitorizare și notificări la modificarea stării flagurilor. LaunchDarkly suportă, de asemenea, furnizorul Terraform pentru gestionarea flagurilor ca cod (Flags as Code) — acest lucru permite stocarea configurației flagurilor în Git și efectuarea code review înainte de aplicare.