عرض الإشعارات المحلية باستخدام flutter_local_notifications

dependencies:
  flutter:
    sdk: flutter
  flutter_local_notifications: ^17.0.0   # استخدم أحدث إصدار مستقر

<!-- مطلوب لـ Android 13+ -->
<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />

<!-- مطلوب لجدولة التنبيهات الدقيقة على Android 12+ -->
<uses-permission android:name="android.permission.SCHEDULE_EXACT_ALARM" />

android {
    defaultConfig {
        minSdkVersion 21
        targetSdkVersion 34
    }
}

import 'package:flutter_local_notifications/flutter_local_notifications.dart';
import 'package:flutter/material.dart';

final FlutterLocalNotificationsPlugin flutterLocalNotificationsPlugin =
    FlutterLocalNotificationsPlugin();

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

  // --- إعدادات تهيئة Android ---
  const AndroidInitializationSettings androidSettings =
      AndroidInitializationSettings('@mipmap/ic_launcher');

  // --- إعدادات تهيئة iOS ---
  const DarwinInitializationSettings iosSettings =
      DarwinInitializationSettings(
    requestAlertPermission: true,
    requestBadgePermission: true,
    requestSoundPermission: true,
  );

  const InitializationSettings initSettings = InitializationSettings(
    android: androidSettings,
    iOS: iosSettings,
  );

  await flutterLocalNotificationsPlugin.initialize(
    initSettings,
    onDidReceiveNotificationResponse: (NotificationResponse response) {
      // يُستدعى عند نقر المستخدم على الإشعار
      debugPrint('تم النقر على الإشعار. البيانات: ${response.payload}');
    },
  );

  runApp(const MyApp());
}

Future<void> requestNotificationPermissions() async {
  // iOS
  final bool? grantedIOS = await flutterLocalNotificationsPlugin
      .resolvePlatformSpecificImplementation<
          IOSFlutterLocalNotificationsPlugin>()
      ?.requestPermissions(
        alert: true,
        badge: true,
        sound: true,
      );

  // Android 13+
  final bool? grantedAndroid = await flutterLocalNotificationsPlugin
      .resolvePlatformSpecificImplementation<
          AndroidFlutterLocalNotificationsPlugin>()
      ?.requestNotificationsPermission();

  debugPrint('iOS: $grantedIOS, Android: $grantedAndroid');
}

Future<void> showSimpleNotification({
  required int id,
  required String title,
  required String body,
  String? payload,
}) async {
  const AndroidNotificationDetails androidDetails =
      AndroidNotificationDetails(
    'general_channel',          // معرّف القناة (فريد لكل تطبيق)
    'General Notifications',    // اسم القناة (يظهر في الإعدادات)
    channelDescription: 'General app notifications',
    importance: Importance.max,
    priority: Priority.high,
    ticker: 'ticker',
  );

  const DarwinNotificationDetails iosDetails = DarwinNotificationDetails(
    presentAlert: true,
    presentBadge: true,
    presentSound: true,
  );

  const NotificationDetails notificationDetails = NotificationDetails(
    android: androidDetails,
    iOS: iosDetails,
  );

  await flutterLocalNotificationsPlugin.show(
    id,
    title,
    body,
    notificationDetails,
    payload: payload,
  );
}

// مثال على الاستخدام:
// await showSimpleNotification(
//   id: 0,
//   title: 'مرحباً من Flutter!',
//   body: 'هذا أول إشعار محلي لك.',
//   payload: 'home_screen',
// );

// داخل ودجت يملك وصولاً إلى Navigator (مثلاً خدمة بـ GlobalKey)
void handleNotificationTap(NotificationResponse response) {
  final String? payload = response.payload;
  if (payload == 'home_screen') {
    navigatorKey.currentState?.pushNamed('/home');
  } else if (payload == 'settings') {
    navigatorKey.currentState?.pushNamed('/settings');
  }
}