[TIL] Day 80 Firebase Remote Config

현서·2026년 3월 23일

TIL dart flutter

[TIL] Flutter 9기

목록 보기

92/102

Firebase Remote Config

Remote Config란?

앱을 업데이트하지 않고 앱의 동작과 UI를 바꿀 수 있는 Firebase 서비스.
설정값을 Firebase 콘솔에서 수정하면 앱이 다음 실행 시 새 값을 받아옴.

어디에 쓰이는가?

이벤트 배너 문구, 색상 원격 변경
특정 기능 ON/OFF (기능 플래그)
점검 공지 팝업 여부 제어
앱 최소 버전 강제 업데이트 유도
A/B 테스트 (어떤 UI가 더 반응 좋은지 실험)

동작 흐름

1. Firebase 콘솔에서 파라미터(키-값) 설정
2. 앱 실행 시 Remote Config 서버에서 값 fetch
3. activate() 호출로 앱에 적용
4. 앱에서 getValue()로 값 읽어서 사용

fetch한 값은 바로 적용되지 않음. activate() 해야 실제로 반영됨.

핵심 개념

파라미터 (Parameter)

Remote Config에서 관리하는 키-값 쌍.

키: show_banner
값: true

기본값 (Default Value)

서버에서 값을 못 받아왔을 때 앱이 사용하는 fallback 값.
반드시 앱 코드 안에 설정해두는 게 좋음.

fetch & activate

fetch() — 서버에서 최신 값을 가져옴 (캐시에 저장)
activate() — 캐시에 있는 값을 앱에 실제 반영
fetchAndActivate() — 두 작업을 한 번에

Flutter 기본 사용법

// 1. 패키지 추가
// pubspec.yaml
// firebase_remote_config: ^x.x.x

// 2. 초기화 및 기본값 설정
final remoteConfig = FirebaseRemoteConfig.instance;

await remoteConfig.setDefaults({
  'show_banner': false,
  'banner_text': '기본 배너 문구',
});

// 3. 서버에서 값 가져와서 적용
await remoteConfig.fetchAndActivate();

// 4. 값 읽기
final showBanner = remoteConfig.getBool('show_banner');
final bannerText = remoteConfig.getString('banner_text');

fetch 캐시 주의

기본 캐시 만료 시간은 12시간.
개발 중에는 아래처럼 최소화해서 테스트.

await remoteConfig.setConfigSettings(RemoteConfigSettings(
  fetchTimeout: Duration(seconds: 10),
  minimumFetchInterval: Duration.zero, // 개발용, 배포 시엔 제거
));