Push Notification & Deep Link #

dependencies:
  firebase_core: ^3.8.1
  firebase_messaging: ^15.1.6
  flutter_local_notifications: ^17.2.4

# Jalankan konfigurasi Firebase via CLI
flutterfire configure --project=nama-proyek-firebase-kita

// lib/core/notifications/notification_service.dart
import 'dart:convert';
import 'package:firebase_core/firebase_core.dart';
import 'package:firebase_messaging/firebase_messaging.dart';
import 'package:flutter/foundation.dart';
import 'package:flutter_local_notifications/flutter_local_notifications.dart';
import '../router/app_router.dart';

/// Handler background message wajib ditempatkan sebagai top-level function
/// dan dianotasikan dengan @pragma('vm:entry-point') agar tidak dihapus compiler.
@pragma('vm:entry-point')
Future<void> _fcmBackgroundHandler(RemoteMessage message) async {
  await Firebase.initializeApp();
  debugPrint('[FCM Background] Menerima pesan: ${message.messageId}');
}

class NotificationService {
  static final FirebaseMessaging _messaging = FirebaseMessaging.instance;
  static final FlutterLocalNotificationsPlugin _localNotifications =
      FlutterLocalNotificationsPlugin();

  static const AndroidNotificationChannel _channelPenting = AndroidNotificationChannel(
    'channel_penting_id', 
    'Notifikasi Penting',
    description: 'Channel ini digunakan untuk notifikasi transaksi & promo penting.',
    importance: Importance.max,
    playSound: true,
  );

  static Future<void> inisialisasi() async {
    // 1. Registrasi Background Handler di baris awal
    FirebaseMessaging.onBackgroundMessage(_fcmBackgroundHandler);

    // 2. Minta Izin Notifikasi (terutama penting untuk iOS dan Android 13+)
    final NotificationSettings settings = await _messaging.requestPermission(
      alert: true,
      badge: true,
      sound: true,
    );
    debugPrint('Status Izin Notifikasi: ${settings.authorizationStatus}');

    // 3. Konfigurasi Local Notification untuk Foreground
    const AndroidInitializationSettings inisialisasiAndroid =
        AndroidInitializationSettings('@mipmap/ic_launcher');
    const DarwinInitializationSettings inisialisasiIOS = DarwinInitializationSettings(
      requestAlertPermission: false,
      requestBadgePermission: false,
      requestSoundPermission: false,
    );

    await _localNotifications.initialize(
      const InitializationSettings(android: inisialisasiAndroid, iOS: inisialisasiIOS),
      onDidReceiveNotificationResponse: _onTapNotificationLokal,
    );

    // 4. Buat Channel Notifikasi Android
    await _localNotifications
        .resolvePlatformSpecificImplementation<AndroidFlutterLocalNotificationsPlugin>()
        ?.createNotificationChannel(_channelPenting);

    // 5. Daftarkan Event Handler
    _setupEventHandlers();

    // 6. Ambil Token FCM untuk Pengiriman dari Backend
    final token = await _messaging.getToken();
    debugPrint('FCM Token Perangkat: $token');
    if (token != null) {
      await _kirimTokenKeServer(token);
    }

    // Perbarui token di server jika terjadi rotasi token
    _messaging.onTokenRefresh.listen(_kirimTokenKeServer);
  }

  static void _setupEventHandlers() {
    // KONDISI 1: FOREGROUND (Aplikasi Sedang Terbuka Aktif)
    // OS tidak akan menampilkan banner secara otomatis. Kita harus memicu notifikasi lokal.
    FirebaseMessaging.onMessage.listen((RemoteMessage message) {
      debugPrint('[FCM Foreground] Pesan masuk: ${message.notification?.title}');
      _tampilkanNotifikasiLokal(message);
    });

    // KONDISI 2: BACKGROUND (Aplikasi Terbuka tapi Sedang Diminimalisasi)
    // OS menampilkan banner di tray. Callback ini terpicu HANYA saat pengguna mengetuk banner.
    FirebaseMessaging.onMessageOpenedApp.listen((RemoteMessage message) {
      debugPrint('[FCM Background Tap] Pengguna mengetuk notifikasi.');
      _arahkanRuteHalaman(message.data);
    });

    // KONDISI 3: TERMINATED (Aplikasi dalam Keadaan Mati Total)
    // Kita panggil saat inisialisasi untuk memeriksa apakah aplikasi dinyalakan dari tap notifikasi.
    _periksaNotifikasiColdStart();
  }

  static Future<void> _periksaNotifikasiColdStart() async {
    final RemoteMessage? pesanAwal = await _messaging.getInitialMessage();
    if (pesanAwal != null) {
      debugPrint('[FCM Cold Start Tap] Aplikasi dinyalakan dari notifikasi.');
      // Berikan jeda kecil agar struktur router dan element tree terpasang sempurna
      await Future.delayed(const Duration(milliseconds: 800));
      _arahkanRuteHalaman(pesanAwal.data);
    }
  }

  static Future<void> _tampilkanNotifikasiLokal(RemoteMessage message) async {
    final RemoteNotification? notification = message.notification;
    if (notification == null) return;

    await _localNotifications.show(
      notification.hashCode,
      notification.title,
      notification.body,
      NotificationDetails(
        android: AndroidNotificationDetails(
          _channelPenting.id,
          _channelPenting.name,
          channelDescription: _channelPenting.description,
          importance: Importance.max,
          priority: Priority.high,
          icon: '@mipmap/ic_launcher',
        ),
        iOS: const DarwinNotificationDetails(
          presentAlert: true,
          presentBadge: true,
          presentSound: true,
        ),
      ),
      payload: jsonEncode(message.data), // Sertakan data payload JSON sebagai string
    );
  }

  static void _onTapNotificationLokal(NotificationResponse response) {
    final String? payload = response.payload;
    if (payload != null && payload.isNotEmpty) {
      final Map<String, dynamic> data = jsonDecode(payload) as Map<String, dynamic>;
      _arahkanRuteHalaman(data);
    }
  }

  static void _arahkanRuteHalaman(Map<String, dynamic> data) {
    final String? tipeHalaman = data['type'] as String?;
    final String? idKonten = data['id'] as String?;

    if (tipeHalaman == null) return;

    // Alihkan rute menggunakan router aplikasi kita
    switch (tipeHalaman) {
      case 'promo':
        AppRouter.router.push('/promo');
        break;
      case 'produk':
        if (idKonten != null) AppRouter.router.push('/produk/$idKonten');
        break;
      case 'transaksi':
        if (idKonten != null) AppRouter.router.push('/transaksi/$idKonten');
        break;
      default:
        AppRouter.router.go('/');
    }
  }

  static Future<void> _kirimTokenKeServer(String token) async {
    // Logika pengiriman token ke backend kita agar server tahu alamat perangkat ini
    debugPrint('Mengirim token FCM ke database server backend...');
  }
}

<activity
    android:name=".MainActivity"
    ...>
    
    <!-- 1. Konfigurasi Custom URL Scheme (skema-kita://) -->
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:scheme="skema-kita" />
    </intent-filter>

    <!-- 2. Konfigurasi Android App Links (HTTPS Domain) -->
    <intent-filter android:autoVerify="true">
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        
        <!-- Masukkan domain web resmi kita -->
        <data android:scheme="https" android:host="unisbadri.com" />
        <data android:scheme="http" android:host="unisbadri.com" />
    </intent-filter>
</activity>

[
  {
    "relation": [
      "delegate_permission/common.handle_all_urls"
    ],
    "target": {
      "namespace": "android_app",
      "package_name": "com.unisbadri.app",
      "sha256_cert_fingerprints": [
        "14:6D:E9:83:C5:E0:14:10:BC:82:13:90:85:12:20:AA:BB:CC:DD:EE:FF:GG:HH:II:JJ:KK:LL:MM:NN"
      ]
    }
  }
]

{
  "applinks": {
    "apps": [],
    "details": [
      {
        "appID": "AB12345XYZ.com.unisbadri.app",
        "paths": [
          "/produk/*",
          "/promo",
          "/transaksi/*"
        ]
      }
    ]
  }
}

dependencies:
  go_router: ^14.2.0
  app_links: ^6.1.1

// lib/core/router/app_router.dart
import 'package:flutter/material.dart';
import 'package:go_router/go_router.dart';
import 'package:app_links/app_links.dart';

class AppRouter {
  static final AppLinks _appLinks = AppLinks();
  
  static final GoRouter router = GoRouter(
    initialLocation: '/',
    routes: [
      GoRoute(
        path: '/',
        builder: (context, state) => const Scaffold(
          body: Center(child: Text('Halaman Utama')),
        ),
      ),
      GoRoute(
        path: '/promo',
        builder: (context, state) => const Scaffold(
          body: Center(child: Text('Halaman Promo Spesial')),
        ),
      ),
      GoRoute(
        path: '/produk/:id',
        builder: (context, state) {
          final String id = state.pathParameters['id'] ?? '';
          return Scaffold(
            appBar: AppBar(title: const Text('Detail Produk')),
            body: Center(child: Text('Menampilkan Produk ID: $id')),
          );
        },
      ),
      GoRoute(
        path: '/transaksi/:id',
        builder: (context, state) {
          final String id = state.pathParameters['id'] ?? '';
          return Scaffold(
            appBar: AppBar(title: const Text('Detail Transaksi')),
            body: Center(child: Text('Menampilkan Detail Transaksi ID: $id')),
          );
        },
      ),
    ],
  );

  /// Inisialisasi listener deep link untuk memantau tautan masuk
  static Future<void> inisialisasiDeepLinking() async {
    // A. KONDISI COLD START (Aplikasi Mati Lalu Dibuka dari Link)
    try {
      final Uri? tautanAwal = await _appLinks.getInitialLink();
      if (tautanAwal != null) {
        debugPrint('[DeepLink Cold Start] Tautan awal terdeteksi: $tautanAwal');
        _prosesNavigasiDeepLink(tautanAwal);
      }
    } catch (e) {
      debugPrint('Gagal membaca tautan awal deep link: $e');
    }

    // B. KONDISI RUNTIME (Aplikasi Aktif di Foreground / Background)
    _appLinks.uriLinkStream.listen((Uri uri) {
      debugPrint('[DeepLink Runtime] Tautan masuk: $uri');
      _prosesNavigasiDeepLink(uri);
    }, onError: (err) {
      debugPrint('Error pada aliran data deep link: $err');
    });
  }

  static void _prosesNavigasiDeepLink(Uri uri) {
    // Kita mengambil jalur path dan query parameters secara presisi
    final String path = uri.path;
    
    if (path.isNotEmpty && path != '/') {
      // Mengalihkan fokus halaman router ke jalur tautan deep link
      router.push(path);
    }
  }
}

// main.dart
import 'package:flutter/material.dart';
import 'package:firebase_core/firebase_core.dart';
import 'core/notifications/notification_service.dart';
import 'core/router/app_router.dart';
import 'firebase_options.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  // 1. Inisialisasi Firebase & Notifikasi
  await Firebase.initializeApp(
    options: DefaultFirebaseOptions.currentPlatform,
  );
  await NotificationService.inisialisasi();
  
  // 2. Inisialisasi Deep Linking Listener
  await AppRouter.inisialisasiDeepLinking();

  runApp(const MyApp());
}

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

  @override
  Widget build(BuildContext context) {
    return MaterialApp.router(
      title: 'Aplikasi Integrasi',
      routerConfig: AppRouter.router,
    );
  }
}

{
  "message": {
    "token": "TOKEN_FCM_PERANGKAT_TARGET",
    "notification": {
      "title": "Promo Terbatas! 🚀",
      "body": "Dapatkan diskon 50% untuk produk buku Flutter terbaru."
    },
    "data": {
      "type": "produk",
      "id": "flutter-book-advanced",
      "click_action": "FLUTTER_NOTIFICATION_CLICK"
    },
    "android": {
      "notification": {
        "channel_id": "channel_penting_id",
        "click_action": "FLUTTER_NOTIFICATION_CLICK"
      }
    },
    "apns": {
      "payload": {
        "aps": {
          "sound": "default",
          "badge": 1
        }
      }
    }
  }
}