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)
Mục lục
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-configvà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()trongonCreaterồ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ý
onNewTokenthì 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_NOTIFICATIONStrê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.
minimumFetchIntervalInSecondsbằ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ậnUNREGISTERED.- 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.



