Android Developer Roadmap: Sử dụng Remote Config và Firebase Cloud Messaging trong các Dự án Thực tế

Remote Config và FCM thường được thêm vào app trong cùng một sprint và hỏng theo hai kiểu khác nhau. Remote Config hỏng âm thầm: app vẫn chạy, chỉ là chạy bằng cấu hình cũ hoặc mặc định mà không ai kiểm tra. FCM hỏng ồn ào: người dùng không nhận được gì, nhận hai lần, hoặc bấm vào thì mở sai màn hình.

Cả hai là kênh một chiều từ server xuống client, không phải nguồn sự thật. Remote Config là snapshot có thể cũ; FCM là sự kiện có thể mất. Giữ điều đó thì ranh giới rõ: gì đặt trong cấu hình, gì phải hỏi backend, gì không bao giờ nằm trong payload.

Remote Config   app kéo    ── fetch + activate ──▶  giá trị cấu hình (cache trong app)
FCM             server đẩy ── message ────────────▶  app hoặc system tray xử lý
Backend API     app kéo    ── HTTPS ──────────────▶  trạng thái nghiệp vụ (nguồn sự thật)

Cập nhật 2026

  • Target API 36 là bắt buộc. Từ 31/08/2026, app mới và bản cập nhật phải target API 36, gia hạn muộn nhất tới 01/11/2026. Không API FCM nào đổi, nhưng quyền thông báo phải đúng với Android 13+.
  • Artifact -ktx đã ngừng cập nhật. Dependency là firebase-config và firebase-messaging.
  • Legacy FCM HTTP API đã chết. Server chỉ còn HTTP v1 (OAuth2 bằng service account) hoặc Admin SDK.
  • Real-time Remote Config có trên Android. Vẫn không được hạ minimum fetch interval xuống 0 ở production.

Remote Config: mặc định trong code là hợp đồng

Giá trị mặc định không phải fallback cho đẹp mà là cấu hình thật của app ở lần chạy đầu, trên máy không có mạng, và trước khi fetch xong. Mặc định sai thì app sai ngay từ frame đầu mà không có lỗi nào được ném ra.

Một giá trị đi qua bốn trạng thái: mặc định trong code, đã fetch nhưng chưa activate, đã activate (lưu qua các lần khởi động), và giá trị mới từ server. Fetch lỗi thì app dùng bản đã activate lần trước; chưa từng fetch thì dùng mặc định.

fetchAndActivate() gộp hai bước và là lựa chọn mặc định. Tách fetch() rồi activate() chỉ hợp lý khi muốn áp dụng ở lần khởi động sau; activate giữa phiên làm UI nhảy trước mặt người dùng.

Caching: con số 12 giờ và cái bẫy số 0

Minimum fetch interval mặc định là 12 giờ, cộng một lớp cache trong bộ nhớ khoảng 5 phút. Gọi fetchAndActivate() mỗi lần mở app là đúng; gọi 20 lần trong một phút thì 19 lần trả về cache. Hạ interval xuống 0 để “thấy thay đổi ngay” là cách nhanh nhất để bị chặn tạm thời.

Cần cập nhật trong vài giây cho một flag thì dùng real-time listener addOnConfigUpdateListener cho đúng tham số đó. Đặt fetchTimeoutInSeconds quanh 10 giây; mặc định 60 giây khiến một tác vụ tưởng nhẹ treo lâu hơn cả splash trên 3G yếu.

Điều kiện, experiment và rollout

Điều kiện cho cùng một tham số trả về giá trị khác nhau theo phiên bản app, ngôn ngữ, quốc gia, audience hoặc thuộc tính người dùng. Đây là công cụ rollout thật: bật checkout_v2_enabled cho 5% người dùng, theo dõi crash-free rate, rồi nâng lên 25%, 50%, 100%.

Điều kiện theo phần trăm được đánh giá lại ở mỗi lần fetch, nên không đảm bảo một người luôn nằm trong cùng nhóm. Cần gán nhóm ổn định thì dùng A/B Testing (variant do experiment giữ nguyên) hoặc gán bằng thuộc tính người dùng do backend set.

// File: app/src/main/java/vn/evotek/core/config/AppRemoteConfig.kt
class AppRemoteConfig {

    private val rc = Firebase.remoteConfig
    private val _flags = MutableStateFlow(Flags())
    val flags: StateFlow<Flags> = _flags.asStateFlow()

    init {
        rc.setConfigSettingsAsync(
            FirebaseRemoteConfigSettings.Builder()
                .setFetchTimeoutInSeconds(10)
                .setMinimumFetchIntervalInSeconds(if (BuildConfig.DEBUG) 0 else 12 * 3600)
                .build()
        )
        rc.setDefaultsAsync(DEFAULTS)
    }

    suspend fun refresh(): Boolean {
        val activated = runCatching {
            withTimeoutOrNull(10_000) { rc.fetchAndActivate().await() } ?: false
        }.getOrDefault(false)
        _flags.value = Flags(
            checkoutV2 = rc.getBoolean("checkout_v2_enabled"),
            maxItems = rc.getLong("max_items_per_page").toInt(),
            banner = rc.getString("home_banner_text"),
            maintenance = rc.getBoolean("maintenance_mode")
        )
        return activated
    }

    data class Flags(
        val checkoutV2: Boolean = false,
        val maxItems: Int = 20,
        val banner: String = "Chào bạn",
        val maintenance: Boolean = false
    )

    companion object {
        private val DEFAULTS = mapOf(
            "checkout_v2_enabled" to false,
            "max_items_per_page" to 20L,
            "home_banner_text" to "Chào bạn",
            "maintenance_mode" to false
        )
    }
}

await() đến từ kotlinx-coroutines-play-services. fetchAndActivate() trả về Task<Boolean>, và false không phải lỗi — đó là trường hợp dùng cache hoặc mặc định.

Khi nào không dùng Remote Config

  • Không làm kho bí mật. Giá trị được tải về máy và cache; API key, salt, khoá ký không thuộc về đây.
  • Không để quyết định quyền. Flag is_premium điều khiển UI là hợp lý; chặn nội dung trả phí bằng flag đó là lỗ hổng, vì client bị sửa hoặc máy root sẽ bỏ qua.
  • Không cho thứ phải đúng ngay. Giá, thuế, phí vận chuyển phải do server tính; bảng giá cũ 12 giờ trên máy khách là vấn đề pháp lý.

FCM: hai loại message, hai hành vi

Phần lớn lỗi “không nhận được thông báo” đến từ việc chọn sai loại message.

Loại message Payload Hành vi trên Android
Notification notification, kèm data tùy chọn Nền: system tray hiển thị, onMessageReceived không được gọi. Foreground: onMessageReceived nhận message.
Data Chỉ data onMessageReceived luôn được gọi, kể cả ở nền; app phải tự hiển thị thông báo.
Notification + data Cả hai Nền: tray hiển thị theo notification, data vào extras của Intent khi bấm. Foreground: onMessageReceived nhận cả hai.

Cần kiểm soát nội dung, icon, deep link hay logic trước khi hiển thị thì dùng data message; chỉ cần thông báo đơn giản thì notification message rẻ hơn. Đừng trộn hai loại trong một chiến dịch.

Token không phải hằng số

Token đổi khi app cài lại, dữ liệu bị xoá, khôi phục sang máy mới, hoặc Firebase tự xoay; token không đổi chỉ vì phát hành bản cập nhật. Token cũ vẫn hợp lệ tới khi bị thu hồi, nên backend phải xoá khi nhận lỗi UNREGISTERED. Đọc token bằng FirebaseMessaging.getInstance().token, nhưng onNewToken mới là nơi đồng bộ thật với backend — đẩy việc gửi token vào WorkManager vì nó có thể chạy khi app không mở.

Topic và giới hạn của nó

subscribeToTopic("promo") gửi một message tới mọi thiết bị đã đăng ký mà không cần giữ danh sách token. Đổi lại, topic là kênh broadcast: ai biết tên cũng subscribe được, nên không dùng cho nội dung riêng của một người. Subscription mất khi dữ liệu app bị xoá, và bạn phải tự huỷ topic của tài khoản cũ khi người dùng đăng xuất.

Kênh thông báo và quyền trên Android 13+

Từ Android 8, mọi notification phải thuộc một channel; từ Android 13, app phải xin quyền runtime POST_NOTIFICATIONS, không xin thì notification bị chặn im lặng còn data message vẫn đến. Tạo channel trong Application.onCreate() — idempotent — và chọn importance đúng ngay, vì sau đó người dùng mới đổi được.

// File: app/src/main/java/vn/evotek/push/Notifications.kt
object Notifications {

    const val CHANNEL_CHAT = "chat"
    const val CHANNEL_PROMO = "promo"

    fun createChannels(context: Context) {
        if (Build.VERSION.SDK_INT < Build.VERSION_CODES.O) return
        val manager = context.getSystemService(NotificationManager::class.java)
        manager.createNotificationChannel(
            NotificationChannel(CHANNEL_CHAT, "Tin nhắn", NotificationManager.IMPORTANCE_HIGH)
        )
        manager.createNotificationChannel(
            NotificationChannel(CHANNEL_PROMO, "Khuyến mãi", NotificationManager.IMPORTANCE_DEFAULT)
        )
    }

    fun showFromData(context: Context, payload: Map<String, String>) {
        val title = payload["title"] ?: return
        val body = payload["body"] ?: return
        val threadId = payload["thread_id"]
        val tag = threadId ?: payload["message_id"] ?: return

        val intent = Intent(context, MainActivity::class.java).apply {
            action = Intent.ACTION_VIEW
            if (threadId != null) setData("evotek://chat/$threadId".toUri())
            flags = Intent.FLAG_ACTIVITY_NEW_TASK or Intent.FLAG_ACTIVITY_CLEAR_TOP
        }
        val pending = PendingIntent.getActivity(
            context, tag.hashCode(), intent,
            PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_IMMUTABLE
        )

        val notification = NotificationCompat.Builder(context, CHANNEL_CHAT)
            .setSmallIcon(R.drawable.ic_stat_message)
            .setContentTitle(title)
            .setContentText(body)
            .setAutoCancel(true)
            .setContentIntent(pending)
            .build()

        NotificationManagerCompat.from(context).notify(tag, 0, notification)
    }
}

Tag là threadId chứ không phải id tăng dần: nhiều tin nhắn trong cùng hội thoại thay thế nhau thay vì xếp hàng mười thông báo. Deep link nằm trong PendingIntent mở thẳng MainActivity qua URI evotek://chat/{threadId}. Bắt buộc FLAG_IMMUTABLE (Android 12+ ném exception nếu thiếu) và requestCode riêng cho từng notification, vì PendingIntent được so sánh theo requestCode và Intent. Đừng trỏ contentIntent vào receiver hay service: từ Android 12, notification trampoline bị chặn.

// File: app/src/main/java/vn/evotek/push/NotificationPermission.kt
@Composable
fun rememberNotificationPermissionRequester(onResult: (Boolean) -> Unit): () -> Unit {
    if (Build.VERSION.SDK_INT < Build.VERSION_CODES.TIRAMISU) return { onResult(true) }
    val launcher = rememberLauncherForActivityResult(
        ActivityResultContracts.RequestPermission(), onResult
    )
    return { launcher.launch(Manifest.permission.POST_NOTIFICATIONS) }
}

Đừng xin quyền ngay khi màn hình đầu mở: Android 13 cho phép từ chối hai lần, sau đó hệ thống không hiện hộp thoại nữa và lần gọi tiếp theo trả về false. Xin ở ngữ cảnh có lý do, kiểm tra shouldShowRequestPermissionRationale.

Service nhận message

Chỉ cần một service khai báo với action com.google.firebase.MESSAGING_EVENT. Giữ onMessageReceived dưới một giây: process chỉ sống thêm một lúc sau khi message đến, nên việc nặng đẩy sang WorkManager.

// File: app/src/main/java/vn/evotek/push/EvotekMessagingService.kt
class EvotekMessagingService : FirebaseMessagingService() {

    override fun onNewToken(token: String) {
        TokenSyncWorker.enqueue(applicationContext, token)
    }

    override fun onMessageReceived(message: RemoteMessage) {
        if (isDuplicate(message.messageId)) return
        when (message.data["kind"]) {
            "sync" -> CatalogSyncWorker.enqueue(applicationContext)
            else -> Notifications.showFromData(applicationContext, message.data)
        }
    }

    private fun isDuplicate(id: String?): Boolean {
        if (id == null) return false
        val prefs = getSharedPreferences("fcm_dedupe", Context.MODE_PRIVATE)
        return prefs.getBoolean(id, false).also { prefs.edit().putBoolean(id, true).apply() }
    }
}
<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />

<service
    android:name=".push.EvotekMessagingService"
    android:exported="false">
    <intent-filter>
        <action android:name="com.google.firebase.MESSAGING_EVENT" />
    </intent-filter>
</service>

Gửi từ server: HTTP v1

Server lấy access token OAuth2 từ service account (sống khoảng một giờ), rồi POST tới endpoint messages:send của HTTP v1 với project id trong đường dẫn. Body chỉ định một target — token, topic, hoặc condition — cộng notification, data, ttl, priority, collapse_key.

Phần lớn backend nên dùng Admin SDK thay vì tự gọi HTTP: nó lo token, retry và parse lỗi. Việc còn lại là đọc lỗi đúng cách — UNREGISTERED nghĩa là token đã chết, xoá khỏi database; QUOTA_EXCEEDED là gửi quá nhanh; INVALID_ARGUMENT thường là payload sai schema và sẽ lặp lại nếu retry.

Payload chỉ chứa id và loại sự kiện. Notification hiện trên màn hình khoá, tai nghe, lịch sử thông báo — số dư, OTP, chẩn đoán y tế, tin nhắn riêng tư không thuộc về đó. Nội dung thật lấy từ API khi app mở.

Phân phối không được đảm bảo

FCM là best-effort, không phải hàng đợi giao đúng một lần. Message có thể mất khi thiết bị offline quá ttl, khi app bị force-stop (phải mở lại app thì FCM mới hoạt động), khi Doze hoặc trình tiết kiệm pin của OEM chặn. Message cũng có thể đến hai lần khi server retry.

Vì vậy push là tín hiệu để app hỏi lại trạng thái, không phải trạng thái. Nhận message thì đánh dấu “có dữ liệu mới” và để màn hình gọi API; người dùng mở app thì luôn đồng bộ lại. Chống trùng ở hai tầng — messageId khi xử lý, tag notification khi hiển thị — và dùng unique work với ExistingWorkPolicy.KEEP.

Bẫy thường gặp

  • Coi Remote Config là kho bí mật. Giá trị được tải về máy và cache; bí mật thuộc về backend.
  • Chặn khởi động bằng fetch. Gọi fetchAndActivate() trong onCreate rồi chờ biến mạng chậm thành màn hình trắng; hiển thị mặc định và fetch ở background.
  • Gửi dữ liệu nhạy cảm trong notification. Payload đi qua hạ tầng Google và hiện trên màn hình khoá. Chỉ gửi id.
  • Bỏ qua token refresh. Không xử lý onNewToken thì sau khi người dùng đổi máy, backend vẫn gửi tới token cũ và bạn mất cả nhóm người dùng.
  • Trùng thông báo. Thiếu tag, thiếu dedupe theo messageId, hoặc vừa gửi notification message vừa tự dựng notification từ data.
  • Thiếu channel hoặc thiếu quyền. Không có channel trên Android 8+ hoặc không xin POST_NOTIFICATIONS trên Android 13+ thì notification không hiện, và log không nói gì.
  • Dùng API FCM cũ. Legacy server key và endpoint cũ đã tắt; tài liệu nội bộ còn nhắc “server key” là tài liệu cần xoá.

Chọn công cụ nào

Nhu cầu Công cụ Lý do
Bật/tắt tính năng, đổi copy, đổi tham số UI Remote Config Không cần bản mới, rollout theo %
Thông báo tới một người dùng ngay FCM theo token Cần định danh thiết bị và nội dung riêng
Chiến dịch tới nhóm quan tâm FCM theo topic Không cần giữ danh sách token
Quyền, giá, tồn kho, trạng thái đơn Backend API Phải đúng ngay và kiểm tra phía server

Nhìn tới 2027

Android 17 (API 37) đang beta và yêu cầu target của Play sẽ tăng tiếp sau khi ổn định; Firebase song song siết kiểm tra phía server bằng App Check và Play Integrity, đồng thời gỡ dần API legacy.

Checklist trước khi phát hành

  • Mọi tham số có giá trị mặc định trong code, app chạy đúng khi tắt mạng hoàn toàn.
  • minimumFetchIntervalInSeconds bằng 0 chỉ ở bản debug; bản release dùng 12 giờ.
  • Không có bí mật, giá hay quyết định phân quyền nào nằm trong Remote Config.
  • onNewToken đồng bộ với backend, và backend xoá token khi nhận UNREGISTERED.
  • Payload chỉ chứa id; notification có tag chống trùng; deep link mở đúng màn hình với FLAG_IMMUTABLE.

Đọc tiếp

Hai dịch vụ này đứng trên cùng hạ tầng với Authentication, Firestore và Crashlytics — đọc trước nếu bạn chưa có lớp xác thực ổn định. Cần vị trí trong cùng luồng thông báo thì xem Google Maps và Google Play Services. Để hiểu vì sao service nhận message chạy ngoài UI, đọc Services, Content Providers và Broadcast Receivers. Và để đặt các bài này vào đúng vị trí, quay lại lộ trình học lập trình viên Android.