플러터:푸시 알람(FCM) 편집하기 (부분)

=== 예시 코드 ===

* onMessage, onMessageOpenedApp, getInitialMessage 이들을 이해하는 게 핵심.
<syntaxhighlight lang="dart">
import 'package:flutter/material.dart';
import 'package:firebase_core/firebase_core.dart';
import 'package:firebase_messaging/firebase_messaging.dart';

/// 🔹 백그라운드 메시지 핸들러 (top-level 필수)
Future<void> firebaseMessagingBackgroundHandler(
    RemoteMessage message) async {
  await Firebase.initializeApp();
  // UI 접근 불가, 필요하면 로그/저장만
  debugPrint('백그라운드 메시지 수신: ${message.messageId}');
}

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();

  // 백그라운드 핸들러 등록
  FirebaseMessaging.onBackgroundMessage(
    firebaseMessagingBackgroundHandler,
  );

  runApp(const MyApp());
}

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  String? fcmToken;
  final List<String> messages = [];

  @override
  void initState() {
    super.initState();
    _initFCM();
    _setupMessageHandlers();
  }

  /// FCM 초기 설정 + 토큰 발급
  Future<void> _initFCM() async {
    // iOS 권한 요청 (Android에서는 무시됨)
    await FirebaseMessaging.instance.requestPermission();

    final token = await FirebaseMessaging.instance.getToken();
    setState(() {
      fcmToken = token;
    });
  }

  /// 메시지 수신 / 클릭 처리
  void _setupMessageHandlers() {
    // 1️⃣ 포그라운드 수신
    FirebaseMessaging.onMessage.listen((RemoteMessage message) {
      final title = message.notification?.title ?? '(no title)';
      final body = message.notification?.body ?? '(no body)';
      setState(() {
        messages.add('[FOREGROUND] $title - $body');
      });
    });

    // 2️⃣ 백그라운드 상태에서 알림 클릭
    FirebaseMessaging.onMessageOpenedApp.listen((RemoteMessage message) {
      final title = message.notification?.title ?? '(no title)';
      setState(() {
        messages.add('[CLICK - BG] $title');
      });
    });

    // 3️⃣ 종료 상태에서 알림 클릭
    FirebaseMessaging.instance.getInitialMessage().then((message) {
      if (message != null) {
        final title = message.notification?.title ?? '(no title)';
        setState(() {
          messages.add('[CLICK - TERMINATED] $title');
        });
      }
    });
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: const Text('FCM 단일 파일 예제')),
        body: Padding(
          padding: const EdgeInsets.all(16),
          child: Column(
            crossAxisAlignment: CrossAxisAlignment.start,
            children: [
              const Text(
                'FCM Token',
                style: TextStyle(fontWeight: FontWeight.bold),
              ),
              SelectableText(
                fcmToken ?? '토큰 불러오는 중...',
                style: const TextStyle(fontSize: 12),
              ),
              const SizedBox(height: 16),
              const Text(
                '수신 / 클릭 메시지',
                style: TextStyle(fontWeight: FontWeight.bold),
              ),
              const SizedBox(height: 8),
              Expanded(
                child: ListView.builder(
                  itemCount: messages.length,
                  itemBuilder: (context, index) {
                    return ListTile(
                      title: Text(messages[index]),
                    );
                  },
                ),
              ),
            ],
          ),
        ),
      ),
    );
  }
}

</syntaxhighlight>