README

Plugin open-source untuk mengintegrasikan Firebase Cloud Messaging (FCM) ke dalam aplikasi mobile NativePHP khusus untuk Android. Memungkinkan pengambilan token perangkat secara unik dan penanganan izin notifikasi secara otomatis mengikuti standar arsitektur NativePHP Mobile v3.

Fitur Unggulan

• Manajemen Izin Real-time: Mengecek status 'saklar' notifikasi di semua versi Android secara akurat.
• Auto-dialog (Android 13+): Memicu dialog permintaan izin POST_NOTIFICATIONS secara runtime sesuai kebijakan Google terbaru.
• Bypass ke Pengaturan: Membuka halaman pengaturan aplikasi langsung jika izin ditolak atau ingin dikonfigurasi manual.
• Pengambilan Token FCM: Mengambil registrasi token unik dengan penanganan error yang kuat.
• Otomatisasi Aset: Hook bawaan untuk menyalin file kredensial (google-services.json) ke folder build native.
• V3 Bridge Standards: Menggunakan struktur direktori resources/ yang kompatibel dengan NativePHP Plugin Kit.

Instalasi

Tambahkan plugin ke proyek Laravel Anda melalui Composer:

composer require denis156/fcm-notification

Daftarkan plugin di proyek NativePHP Anda untuk mengaktifkan integrasi native:

php artisan native:plugin:register denis156/fcm-notification

Persiapan Firebase

1. File Konfigurasi

Plugin ini menggunakan hook copy_assets untuk menyalin file konfigurasi Firebase Anda ke target native secara otomatis. Letakkan file kredensial Anda di folder firebase/ pada root proyek:

• Android: firebase/google-services.json

2. Update Proyek

Pastikan Application ID di file .env sudah sama dengan yang terdaftar di Firebase Console:

NATIVEPHP_APP_ID=com.example.app

Jalankan build untuk memicu penyalinan file dan kompilasi plugin:

php artisan native:run android

Penggunaan

Sisi PHP (Laravel/Inertia/Livewire)

Gunakan facade FcmNotification untuk berinteraksi dengan layanan native:

use Denis156\FcmNotification\Facades\FcmNotification;

// 1. Cek status izin saat ini ('granted' atau 'denied')
$status = FcmNotification::getStatus();

// 2. Minta izin notifikasi (Dialog popup pada Android 13+)
if ($status !== 'granted') {
    FcmNotification::requestPermission();
}

// 3. Buka halaman pengaturan aplikasi (Jika user menolak izin sebelumnya)
FcmNotification::openSettings();

// 4. Mengambil Token FCM untuk dikirim ke backend
$token = FcmNotification::getToken();

Sisi JavaScript (Vue/React/Inertia)

Anda juga bisa memanggil fungsi native langsung dari frontend:

import { fcmNotification } from '@denis156/fcm-notification';

// Ambil status izin
const status = await fcmNotification.getStatus();

// Buka pengaturan
await fcmNotification.openSettings();

// Ambil token
const token = await fcmNotification.getToken();

Panduan Debugging

Jika token tidak muncul atau status izin selalu denied:

1. Pantau Log Native: Gunakan php artisan native:tail untuk melihat aktivitas bridge.
2. Detail Log Android: Gunakan adb logcat -s FCM_PLUGIN untuk melihat debugging level native (Kotlin).
3. Reset Token Lokal: Gunakan Tinker untuk menghapus token lama agar plugin memicu pengambilan ulang:

   php artisan tinker --execute 'App\Models\AppSession::query()->update(["fcm_token" => null]);'

Struktur Direktori (Standar v3)

packages/denis156/fcm-notification/
├── nativephp.json          # Manifest Plugin & Bridge Functions
├── src/                    # Kode PHP (Service Provider, Facade, Command)
└── resources/
    ├── android/src/        # Kode Kotlin (Bridge Implementation)
    └── boost/guidelines/   # Instruksi spesifik untuk AI assistants

Kontributor

Dikembangkan dengan penuh dedikasi oleh denis156.

Lisensi

MIT License