Advanced Firebase Logger #

Firebase tabanlı Flutter uygulamaları için geliştirilmiş gelişmiş bir loglama paketi. Bu paket, farklı log seviyelerini destekler ve logları otomatik olarak Firebase Cloud Firestore'a kaydeder.

Özellikler #

• 8 farklı log seviyesi: FINEST, FINER, FINE, CONFIG, INFO, WARNING, SEVERE, SHOUT
• Firebase Cloud Firestore entegrasyonu: Loglar otomatik olarak Firestore'a kaydedilir
• Özelleştirilebilir minimum log seviyesi: Hangi seviyedeki logların kaydedileceğini belirleyebilirsiniz
• Ek veri desteği: Log mesajlarıyla birlikte ek meta veriler ekleyebilirsiniz
• Tag desteği: Logları kategorilere ayırmak için tag kullanabilirsiniz
• Singleton pattern: Uygulama genelinde tek instance kullanımı
• Debug Console Integration: Loglar hem Firestore'a hem de Flutter debug konsoluna yazılır

Başlangıç #

Gereksinimler #

• Flutter SDK
• Firebase projesi ve Firebase yapılandırması
• Cloud Firestore etkinleştirilmiş olmalı

Kurulum #

pubspec.yaml dosyanıza ekleyin:

dependencies:
  advanced_firebase_logger: ^0.1.0
  firebase_core: ^3.8.0
  cloud_firestore: ^5.4.4

Firebase Yapılandırması #

1. Firebase Console'da bir proje oluşturun
2. Flutter uygulamanızı Firebase projesine ekleyin
3. Cloud Firestore'u etkinleştirin
4. Firebase yapılandırma dosyalarını projenize ekleyin

Kullanım #

Başlatma #

import 'package:firebase_core/firebase_core.dart';
import 'package:advanced_firebase_logger/firebase_logger.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  // Firebase'i başlat
  await Firebase.initializeApp();
  
  // FirebaseLogger'ı başlat
  await FirebaseLogger.initialize(
    collectionName: 'app_logs', // Opsiyonel: varsayılan 'logs'
    minimumLevel: LogLevel.info, // Opsiyonel: varsayılan LogLevel.info
  );
  
  runApp(MyApp());
}

Temel Kullanım #

// Farklı seviyelererde log yazma
await FirebaseLogger.finest('En detaylı log mesajı');
await FirebaseLogger.finer('Detaylı log mesajı');
await FirebaseLogger.fine('Login Successful');
await FirebaseLogger.config('Yapılandırma değişti');
await FirebaseLogger.info('Kullanıcı giriş yaptı');
await FirebaseLogger.warning('Dikkat: Düşük hafıza');
await FirebaseLogger.severe('Kritik hata oluştu');
await FirebaseLogger.shout('Acil durum!');

Ek Verilerle Kullanım #

// Ek meta verilerle log yazma
await FirebaseLogger.info(
  'Kullanıcı profili güncellendi',
  additionalData: {
    'userId': '12345',
    'action': 'profile_update',
    'timestamp': DateTime.now().millisecondsSinceEpoch,
  },
  tag: 'USER_MANAGEMENT',
);

Minimum Log Seviyesi Ayarlama #

// Sadece WARNING ve üzeri seviyedeki logları kaydet
FirebaseLogger.setMinimumLevel(LogLevel.warning);

// Mevcut minimum seviyeyi öğren
LogLevel currentLevel = FirebaseLogger.getMinimumLevel();

Log Seviyeleri #

Debug Console Integration #

Bu paket, logları hem Firebase Firestore'a hem de Flutter debug konsoluna yazdırır. Debug modunda çalışırken, tüm log mesajlarını gerçek zamanlı olarak konsolunuzda görebilirsiniz.

Debug Console Format #

[INFO] 2024-01-15T10:30:45.123Z: Kullanıcı giriş yaptı
[WARNING] 2024-01-15T10:30:46.456Z [AUTH]: Oturum süresi doldu
[INFO] 2024-01-15T10:30:47.789Z [USER_ACTION]: Profil güncellendi
Additional Data: {userId: 12345, action: profile_update}

Firestore Veri Yapısı #

Loglar aşağıdaki yapıda Firestore'a kaydedilir:

{
  "timestamp": "Firebase Server Timestamp",
  "level": "INFO",
  "levelValue": 400,
  "message": "Log mesajı",
  "tag": "Optional tag",
  "additionalData": { /* Ek veriler */ }
}

Example #

Bu paketin nasıl kullanılacağını görmek için example/ klasöründeki örnek uygulamayı inceleyebilirsiniz.

Example'ı Çalıştırma #

⚠️ IMPORTANT: Example'ı çalıştırmak için Firebase projesi kurmanız gerekiyor.

Hızlı Başlangıç

cd example
flutter pub get
flutter run

Not: Firebase kurulumu yapılmadan example "Demo Mode"da çalışır ve logları sadece debug konsolunda gösterir.

Tam Firebase Kurulumu

Detaylı kurulum rehberi için example/SETUP.md dosyasını inceleyin. Bu rehber:

• Firebase projesi oluşturma
• Cloud Firestore kurulumu
• Güvenlik kuralları ayarlama
• Konfigürasyon dosyalarını ekleme

adımlarını içerir.

Example Özellikleri #

Example uygulaması şunları gösterir:

• Farklı log seviyelerinin kullanımı
• Tag ve ek veri desteği
• Minimum log seviyesi değiştirme
• Debug konsolunda gerçek zamanlı log görüntüleme
• Firebase bağlantı durumu göstergesi
• Demo mode desteği (Firebase olmadan da çalışır)

Lisans #

Bu proje MIT lisansı altında lisanslanmıştır.