เริ่มต้นอย่างรวดเร็วบน Android

ในอีกไม่กี่นาที แอป Android ของคุณจะอ่าน feature flag ของจริง — แคชอย่างทนทาน ปลอดภัยเมื่อออฟไลน์ พร้อมตัวตนของอุปกรณ์ที่สร้างและเก็บให้คุณ

ต้องใช้ minSdk 26 (Android 8.0) Kotlin โดยมี coroutines เป็นตระกูล dependency เดียว

1. ติดตั้ง

SDK อยู่ในรีโพซิทอรีสาธารณะบน GitHub — ใช้มันเป็น source dependency: โคลน FortressFlag_SDK_android ที่แท็ก v1.0.0 แล้วเพิ่มเข้าโปรเจกต์ของคุณเป็น Gradle included build ซึ่งโมดูลไลบรารีคือ fortressflag

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

2. เริ่ม SDK

ครั้งเดียว ตอนแอปเริ่มทำงาน — Application.onCreate ของคุณคือที่ที่เป็นธรรมชาติที่สุด

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

FortressFlag.start(
    context,
    Configuration(
        sdkKey = "ffc_prod_…",                // จากหน้าจอคีย์ SDK ของโปรเจกต์คุณ
        environment = Environment.PRODUCTION,
    ),
)

SDK โหลดค่าในแคชทันทีและ poll หาการเปลี่ยนแปลงในเบื้องหลัง คีย์นี้คือคีย์ไคลเอนต์ — มันฝังไปในแอปของคุณโดยการออกแบบ

3. อ่าน flag

if (FortressFlag.isEnabled("new-checkout", default = false)) {
    // แสดงหน้าชำระเงินใหม่
}

stringValue และ numberValue อ่าน flag แบบหลายตัวแปรด้วยวิธีเดียวกัน และทุกการอ่านให้บริการจากหน่วยความจำ — ไม่มี I/O ไม่มีเครือข่าย ไม่ว่าคุณจะเรียกจากเธรดไหน

แค่นั้น — flag ของคุณใช้งานจริงแล้ว สลับมันในแดชบอร์ด แล้วแอปจะตามไปในการ poll ครั้งถัดไป

ถ้า FortressFlag ล่ม แอปของคุณไม่ล่ม

isEnabled stringValue และ numberValue ไม่มีวัน throw ทุกการอ่านถอยกลับผ่านค่าล่าสุดที่อุปกรณ์นี้เห็นจริง — รวมถึงจากการรันครั้งก่อน ผ่านแคชที่ทนทาน — แล้วไปที่ค่าเริ่มต้น ณ จุดเรียกของคุณ เหตุขัดข้องไม่มีวันไปถึงผู้ใช้ของคุณ

ข้อเท็จจริงสองข้อของแพลตฟอร์ม ก่อนที่มันจะไปถึงใบแจ้งหนี้

FortressFlag คิดเงินตามอุปกรณ์ และ Android มีข้อเท็จจริงสองข้อที่ควรรู้ล่วงหน้า

• ตัวตนแยกตามแอปในตอนนี้ ถ้าผู้ใช้รันแอปของคุณสามตัวบนโทรศัพท์เครื่องเดียว ตอนนี้จะนับเป็นสูงสุดสามอุปกรณ์ — แอป Android ยังไม่ใช้ตัวตน FortressFlag ร่วมกันแบบที่ตระกูลแอป iOS ทำได้
• การถอนการติดตั้งแอปของคุณล้างตัวตน Android ล้างข้อมูลที่ Keystore รองรับของแอปเมื่อถอนการติดตั้ง การติดตั้งใหม่จึงสร้างตัวตนใหม่ — และนับเป็นอุปกรณ์ใหม่ (ต่างจาก iOS ที่ keychain คงอยู่)

ตัวตนเองถูกสร้างแบบสุ่มและเป็นนามแฝง — ไม่เคยดึงมาจาก ANDROID_ID หรือตัวระบุฮาร์ดแวร์ใด ๆ และอีมูเลเตอร์สร้างตัวตน sim_ ได้รับ flag ตามปกติ ไม่เคยถูกคิดเงิน

ไปต่อที่ไหนดี

• Flag ไปถึงแอปของคุณอย่างไร — การ poll ในเบื้องหลังทำอะไร
• ตัวตนของอุปกรณ์และการเรียกเก็บเงิน — เรื่องราวของตัวตนฉบับเต็ม
• การเจาะกลุ่ม — ให้บริการค่าต่างกันแก่อุปกรณ์ต่างกัน