Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Flutter projenizde Firebase'i kullanmaya başlama

Ön koşullar

Tercih ettiğiniz düzenleyiciyi veya IDE'yi yükleyin.
Aşağıdakiler de dahil olmak üzere, Flutter'ı yükleyin:
- Flutter SDK'sı
- Desteklenen kitaplıklar
- Platforma özel yazılımlar ve SDK'lar

Platforma özel ön koşullar:

Apple

Fiziksel bir Apple cihaz kurun veya uygulamanızı çalıştırmak için simülatör kullanın.
Flutter uygulamanızın aşağıdaki platform sürümlerini veya daha yeni sürümleri hedeflediğinden emin olun:
- iOS 15
- macOS 10.15

Cloud Messaging kullanmak istiyor musunuz?

Apple platformlarında Cloud Messaging için ön koşullar şunlardır:

Fiziksel bir Apple cihaz kurun.

Apple Geliştirici hesabınız için Apple Anında Bildirim Kimlik Doğrulama Anahtarı edinin.

Xcode'da App > Capabilities (Uygulama > Özellikler) bölümünde push bildirimlerini etkinleştirin.

Android

Uygulamanızı çalıştırmak için bir cihaz veya emülatör ayarlayın. Emülatörler Google Play içeren bir emülatör görüntüsü kullanmalıdır.
Uygulamanızın aşağıdaki koşulları karşıladığından emin olun:
- API düzeyi 23 (Marshmallow) veya sonraki sürümleri hedefliyor
- Android 6.0 veya sonraki bir sürümün yüklü olması

Web

Platforma özgü ön koşul yok

Henüz bir Flutter uygulamanız yoksa tercih ettiğiniz düzenleyiciyi veya IDE'yi kullanarak yeni bir Flutter uygulaması oluşturmak için Başlangıç: Test Sürüşü bölümünü tamamlayabilirsiniz.

1. adım: Gerekli komut satırı araçlarını yükleyin

Henüz yapmadıysanız Firebase CLI'yı yükleyin.
Aşağıdaki komutu çalıştırarak Google Hesabınızı kullanarak Firebase'e giriş yapın:
```
firebase login
```
FlutterFire CLI'yi yüklemek için herhangi bir dizinden aşağıdaki komutu çalıştırın:
```
dart pub global activate flutterfire_cli
```

2. adım: Uygulamalarınızı Firebase'i kullanacak şekilde yapılandırın

Flutter uygulamalarınızı Firebase'e bağlanacak şekilde yapılandırmak için FlutterFire KSA'yı kullanın.

Uygulama yapılandırma iş akışını başlatmak için Flutter proje dizininizden aşağıdaki komutu çalıştırın:

flutterfire configure

Bu flutterfire configure iş akışı ne işe yarar?

flutterfire configure iş akışı şunları yapar:

Flutter uygulamanızda desteklenen platformları (iOS, Android, Web) seçmenizi ister. FlutterFire CLI, seçilen her platform için Firebase projenizde yeni bir Firebase uygulaması oluşturur.

Mevcut bir Firebase projesini kullanmayı veya yeni bir Firebase projesi oluşturmayı seçebilirsiniz. Mevcut bir Firebase projesine kayıtlı uygulamalarınız varsa FlutterFire CLI, bu uygulamaları mevcut Flutter projesi yapılandırmanıza göre eşleştirmeye çalışır.

Not: Firebase projenizi ayarlama ve yönetmeyle ilgili bazı ipuçlarını aşağıda bulabilirsiniz:

Birden fazla varyantı işleme dahil olmak üzere uygulamaları Firebase projesine eklemeyle ilgili en iyi uygulamalarımıza göz atın.

Projenizde Google Analytics'ı etkinleştirin. Bu özellik, Crashlytics ve Remote Config gibi birçok Firebase ürünüyle optimum deneyim sunar.

Firebase yapılandırma dosyası (firebase_options.dart) oluşturur ve bunu lib/ dizininize ekler.

Not: Bu Firebase yapılandırma dosyasında, seçtiğiniz her platform için benzersiz ancak gizli olmayan tanımlayıcılar bulunur.
Bu yapılandırma dosyası hakkında daha fazla bilgi edinmek için Firebase projelerini anlama sayfasını ziyaret edin.

(Android'de Crashlytics veya Performance Monitoring için) Flutter uygulamanıza gerekli ürüne özel Gradle eklentilerini ekler.

Not: FlutterFire KSA'nın uygun Gradle eklentisini ekleyebilmesi için ürünün Flutter eklentisinin Flutter uygulamanıza önceden aktarılmış olması gerekir.

flutterfire configure ilk çalıştırıldıktan sonra, aşağıdaki durumlarda komutu yeniden çalıştırmanız gerekir:

Flutter uygulamanızda yeni bir platformu desteklemeye başlayın.
Flutter uygulamanızda yeni bir Firebase hizmeti veya ürünü kullanmaya başladığınızda, özellikle Google ile oturum açma, Crashlytics, Performance Monitoring veya Realtime Database özelliklerini kullanmaya başladığınızda

Komutu yeniden çalıştırmak, Flutter uygulamanızın Firebase yapılandırmasının güncel olmasını sağlar ve (Android için) gerekli Gradle eklentilerini uygulamanıza otomatik olarak ekler.

3. adım: Uygulamanızda Firebase'i başlatın

Temel eklentiyi yüklemek için Flutter proje dizininizden aşağıdaki komutu çalıştırın:
```
flutter pub add firebase_core
```
Flutter projesi dizininizden aşağıdaki komutu çalıştırarak Flutter uygulamanızın Firebase yapılandırmasının güncel olduğundan emin olun:
```
flutterfire configure
```
lib/main.dart dosyanızda Firebase çekirdek eklentisini ve daha önce oluşturduğunuz yapılandırma dosyasını içe aktarın:
```
import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart';
```

Ayrıca lib/main.dart dosyanızda, yapılandırma dosyası tarafından dışa aktarılan DefaultFirebaseOptions nesnesini kullanarak Firebase'i başlatın:

WidgetsFlutterBinding.ensureInitialized();
await Firebase.initializeApp(
  options: DefaultFirebaseOptions.currentPlatform,
);
runApp(const MyApp());

Flutter uygulamanızı yeniden oluşturun:
```
flutter run
```

Demo proje kullanmayı tercih ederseniz Firebase Emulator'ı başlatabilir ve lib/main.dart dosyanızda demoProjectId kullanarak Firebase'i başlatabilirsiniz (demo- ile başlamalıdır):

await Firebase.initializeApp(
  demoProjectId: "demo-project-id",
);

4. adım: Firebase eklentilerini ekleyin

Flutter uygulamanızda Firebase'e çeşitli Firebase Flutter eklentileri aracılığıyla erişirsiniz. Her Firebase ürünü için bir eklenti vardır (ör. Cloud Firestore, Authentication, Analytics vb.).

Flutter çok platformlu bir çerçeve olduğundan her Firebase eklentisi Apple, Android ve web platformları için geçerlidir. Bu nedenle, Flutter uygulamanıza herhangi bir Firebase eklentisi eklerseniz bu eklenti uygulamanızın Apple, Android ve web sürümlerinde kullanılır.

Firebase Flutter eklentisi eklemek için:

Flutter proje dizininizden aşağıdaki komutu çalıştırın:
```
flutter pub add PLUGIN_NAME
```
Flutter proje dizininizden aşağıdaki komutu çalıştırın:
```
flutterfire configure
```
Bu komutu çalıştırmak, Flutter uygulamanızın Firebase yapılandırmasının güncel olmasını sağlar ve Android'de Crashlytics ile Performance Monitoring için gerekli Gradle eklentilerini uygulamanıza ekler.
İşlem tamamlandığında Flutter projenizi yeniden oluşturun:
```
flutter run
```

Her şey hazır Flutter uygulamalarınız Firebase'i kullanacak şekilde kaydedilmiş ve yapılandırılmış olmalıdır.

Web uygulamaları geliştirirken dikkat edilmesi gereken özel noktalar

Trusted Types desteği

Flutter için Firebase SDK, DOM tabanlı (istemci tarafı) XSS saldırılarını önlemeye yardımcı olmak için Trusted Types'ın kullanılmasını destekler. Uygulamanız için Güvenilir Tür zorunluluğunu etkinleştirdiğinizde Firebase SDK, flutterfire-firebase_core, flutterfire-firebase_auth vb. adlı özel Güvenilir Tür politikalarını kullanarak komut dosyalarını DOM'a yerleştirir.

Firebase JavaScript SDK'sının otomatik olarak eklenmesini devre dışı bırakma

Varsayılan olarak, Firebase Flutter SDK'sı web için derleme yaparken Firebase JavaScript SDK'sını otomatik olarak ekler. Firebase JavaScript SDK'sının otomatik olarak eklenmesini istemiyorsanız aşağıdakileri yapabilirsiniz:

Flutter projenizdeki web/index.html dosyasında <script> etiketi içine aşağıdaki özelliği ekleyerek otomatik yerleştirme komut dosyasını yoksayın:

<!-- Add this property inside a <script> tag within your "web/index.html" file in your Flutter project -->
<!-- Put in the names of all the plugins you wish to ignore: -->
window.flutterfire_ignore_scripts = ['analytics', 'firestore'];

Aşağıdaki seçeneklerden birini kullanarak komut dosyasını manuel olarak yükleyin:

1. seçenek: SDK'yı web/index.html dosyanıza window.addEventListener geri çağırma işlevi içinde açıkça ekleyin:

  window.addEventListener('load', async function (ev) {
    window.firebase_firestore = await import("https://www.gstatic.com/firebasejs/12.13.0/firebase-firestore.js");
    window.firebase_analytics = await import("https://www.gstatic.com/firebasejs/12.13.0/firebase-analytics.js");

    _flutter.loader.loadEntrypoint().then(function (engineInitializer) {
      // rest of the code

2. seçenek: Eklentinin Firebase JavaScript SDK kodunu gstatic alanından indirin ve bunları projenizde tutulup manuel olarak yüklenecek bir JavaScript dosyasına kaydedin:

  // "web/my-analytics.js" & "web/my-firestore.js" file loaded as a script into your "web/index.html" file:
  window.addEventListener('load', async function (ev) {
    window.firebase_analytics = await import("./my-analytics.js");
    window.firebase_firestore = await import("./my-firestore.js");

    _flutter.loader.loadEntrypoint().then(function (engineInitializer) {
      // rest of the code

Mevcut eklentiler

Ürün	Eklenti adı	Diğer Apple cihazlar (macOS vb.)	Windows
Firebase AI Logic ¹	`firebase_ai`	beta
Analytics	`firebase_analytics`	beta
App Check	`firebase_app_check`	beta
Authentication	`firebase_auth`	beta	beta
Cloud Firestore	`cloud_firestore`	beta	beta
Cloud Functions	`cloud_functions`	beta
Cloud Messaging	`firebase_messaging`	beta
Cloud Storage	`firebase_storage`	beta	beta
Crashlytics	`firebase_crashlytics`	beta
SQL Connect ²	`firebase_data_connect`
Dynamic Links	`firebase_dynamic_links`
In-App Messaging	`firebase_in_app_messaging`
Firebase yükleme	`firebase_app_installations`	beta
ML Model Downloader	`firebase_ml_model_downloader`	beta
Performance Monitoring	`firebase_performance`
Realtime Database	`firebase_database`	beta
Remote Config	`firebase_remote_config`	beta

^{1 Firebase AI Logic, daha önce
firebase_vertexai eklentisiyle birlikte
"Vertex AI in Firebase" olarak adlandırılıyordu.}

^{2 Firebase SQL Connect, daha önce
"Firebase Data Connect" olarak adlandırılıyordu.}

Sonraki adımlar

Firebase Flutter Codelab ile uygulamalı deneyim kazanın.
Uygulamanızı kullanıma sunmaya hazırlanın:
- Google Cloud konsolunda projeniz için bütçe uyarıları ayarlayın.
- Projenizin birden fazla Firebase hizmetindeki kullanımına dair genel bir görünüm elde etmek için Firebase konsolundaki Kullanım ve faturalandırma kontrol panelini izleyin.
- Firebase lansman kontrol listesini inceleyin.