Firebase AI Logic SDK'larını kullanarak Gemini API'yi kullanmaya başlama

Bu kılavuzda, seçtiğiniz platform için Gemini API istemci SDK'larını kullanarak doğrudan uygulamanızdan Firebase AI Logic'ya nasıl çağrı yapmaya başlayacağınız gösterilmektedir.

Ön koşullar

Swift

Bu kılavuzda, Apple platformları (ör. iOS) için uygulama geliştirmek üzere Xcode'u kullanma konusunda bilgi sahibi olduğunuz varsayılır.

Geliştirme ortamınızın ve Apple platformları uygulamanızın aşağıdaki koşulları karşıladığından emin olun:

  • Xcode 26.2 veya sonraki sürümler
  • Uygulamanız iOS 15 veya sonraki sürümleri ya da macOS 12 veya sonraki sürümleri hedefliyor.

Kotlin

Bu kılavuzda, Android için uygulama geliştirirken Android Studio'yu kullanma konusunda bilgi sahibi olduğunuz varsayılır.

Geliştirme ortamınızın ve Android uygulamanızın aşağıdaki koşulları karşıladığından emin olun:

  • Android Studio (en son sürüm)
  • Uygulamanız API düzeyi 21 veya sonraki sürümleri hedefliyor

Java

Bu kılavuzda, Android için uygulama geliştirirken Android Studio'yu kullanma konusunda bilgi sahibi olduğunuz varsayılır.

Geliştirme ortamınızın ve Android uygulamanızın aşağıdaki koşulları karşıladığından emin olun:

  • Android Studio (en son sürüm)
  • Uygulamanız API düzeyi 21 veya sonraki sürümleri hedefliyor

Web

Bu kılavuzda, web uygulamaları geliştirmek için JavaScript kullanma konusunda bilgi sahibi olduğunuz varsayılır. Bu kılavuz, çerçeveden bağımsızdır.

Geliştirme ortamınızın ve web uygulamanızın aşağıdaki koşulları karşıladığından emin olun:

  • (İsteğe bağlı) Node.js
  • Modern web tarayıcısı

Dart

Bu rehberde, Flutter ile uygulama geliştirme konusunda bilgi sahibi olduğunuz varsayılmaktadır.

Geliştirme ortamınızın ve Flutter uygulamanızın aşağıdaki koşulları karşıladığından emin olun:

  • Dart 3.2.0 veya daha yeni bir sürüm

Unity

Bu kılavuzda, Unity ile oyun geliştirme konusunda bilgi sahibi olduğunuz varsayılmaktadır.

Geliştirme ortamınızın ve Unity oyununuzun aşağıdaki koşulları karşıladığından emin olun:

  • Unity Editor 2021 LTS veya daha yeni sürümler

Faydalı kaynaklara göz atın

Swift

Hızlı başlangıç uygulamasını deneme

SDK'yı hızlıca denemek ve çeşitli kullanım alanlarının eksiksiz bir uygulamasını görmek için hızlı başlangıç uygulamasını kullanın. Apple platformları uygulamanız yoksa hızlı başlangıç uygulamasını kullanın. Hızlı başlangıç uygulamasını kullanmak için bir Firebase projesine bağlamanız gerekir.

Hızlı başlangıç uygulamasına gitme

Eğitim videosu izleyin

Bu videoda, Firebase AI Logic ile nasıl çalışmaya başlayacağınız gösterilmektedir. Bunun için, metin isteminden tarifler oluşturan, yapay zeka destekli gerçek hayattaki bir yemek planlama uygulaması oluşturulur.

Videodaki uygulamanın kod tabanını indirip inceleyebilirsiniz.

Videonun uygulamasının kod tabanını görüntüleme



Kotlin

Hızlı başlangıç uygulamasını deneme

SDK'yı hızlıca denemek ve çeşitli kullanım alanlarının eksiksiz bir uygulamasını görmek için hızlı başlangıç uygulamasını kullanın. Kendi Android uygulamanız yoksa hızlı başlangıç uygulamasını kullanın. Hızlı başlangıç uygulamasını kullanmak için bir Firebase projesine bağlamanız gerekir.

Hızlı başlangıç uygulamasına gitme

Eğitim videosu izleyin

Bu videoda, Firebase AI Logic ile nasıl çalışmaya başlayacağınız gösterilmektedir. Bunun için, metin isteminden tarifler oluşturan, yapay zeka destekli gerçek hayattaki bir yemek planlama uygulaması oluşturulur.

Videodaki uygulamanın kod tabanını indirip inceleyebilirsiniz.

Videonun uygulamasının kod tabanını görüntüleme



Java

Hızlı başlangıç uygulamasını deneme

SDK'yı hızlıca denemek ve çeşitli kullanım alanlarının eksiksiz bir uygulamasını görmek için hızlı başlangıç uygulamasını kullanın. Kendi Android uygulamanız yoksa hızlı başlangıç uygulamasını kullanın. Hızlı başlangıç uygulamasını kullanmak için bir Firebase projesine bağlamanız gerekir.

Hızlı başlangıç uygulamasına gitme

Eğitim videosu izleyin

Bu videoda, Firebase AI Logic ile nasıl başlayacağınız gösterilmektedir. Bunun için, metin isteminden tarifler oluşturan, yapay zeka destekli gerçek dünya yemek planlama uygulaması oluşturulur.*

Videodaki uygulamanın kod tabanını indirip inceleyebilirsiniz.

Videonun uygulamasının kod tabanını görüntüleme

* Bu video ve uygulaması Kotlin ile yazılmıştır ancak Java geliştiricilerin Firebase AI Logic ile çalışmaya başlamanın temellerini anlamalarına yardımcı olabilir.

Web

Hızlı başlangıç uygulamasını deneme

SDK'yı hızlıca denemek ve çeşitli kullanım alanlarının eksiksiz bir uygulamasını görmek için hızlı başlangıç uygulamasını kullanın. Kendi web uygulamanız yoksa hızlı başlangıç uygulamasını kullanın. Hızlı başlangıç uygulamasını kullanmak için bir Firebase projesine bağlamanız gerekir.

Hızlı başlangıç uygulamasına gitme

Dart

Hızlı başlangıç uygulamasını deneme

SDK'yı hızlıca denemek ve çeşitli kullanım alanlarının eksiksiz bir uygulamasını görmek için hızlı başlangıç uygulamasını kullanın. Alternatif olarak, kendi Flutter uygulamanız yoksa hızlı başlangıç uygulamasını kullanın. Hızlı başlangıç uygulamasını kullanmak için bir Firebase projesine bağlamanız gerekir.

Hızlı başlangıç uygulamasına gitme

Eğitim videosu izleyin

Bu videoda, Firebase AI Logic ile nasıl çalışmaya başlayacağınız gösterilmektedir. Bunun için, metin isteminden tarifler oluşturan, yapay zeka destekli gerçek hayattaki bir yemek planlama uygulaması oluşturulur.

Videodaki uygulamanın kod tabanını indirip inceleyebilirsiniz.

Videonun uygulamasının kod tabanını görüntüleme



Unity

Hızlı başlangıç uygulamasını deneme

SDK'yı hızlıca denemek ve çeşitli kullanım alanlarının eksiksiz bir uygulamasını görmek için hızlı başlangıç uygulamasını kullanın. Kendi Unity oyununuz yoksa hızlı başlangıç uygulamasını kullanın. Hızlı başlangıç uygulamasını kullanmak için bir Firebase projesine bağlamanız gerekir.

Hızlı başlangıç uygulamasına gitme

1. adım: Firebase projesi oluşturma ve API'leri etkinleştirme

  1. Firebase konsolunda oturum açın ve Firebase projenizi seçin.

  2. Firebase konsolunda AI Services > AI Logic'e gidin.

  3. Projeniz için gerekli API'leri ve kaynakları ayarlamanıza yardımcı olacak rehberli bir iş akışı başlatmak için Başlayın'ı tıklayın.

  4. İstenirse uygulamanızı kaydetmek ve Firebase yapılandırmanızı uygulamanıza eklemek için ekrandaki talimatları uygulayın.

  5. "Gemini API sağlayıcısı" seçmeniz istendiğinde, ücretsiz olarak hızlıca başlamanıza olanak tanıyan Gemini Developer API'yi seçmenizi öneririz.

    Daha sonra istediğiniz zaman Vertex AI Gemini API'ı (ve faturalandırma şartını) ayarlayabilirsiniz.

  6. Firebase AI Logic için gerekli API'leri ve ilişkili hizmetleri ayarlamak üzere iş akışına devam edin.

    Temmuz 2026'nın başlarından itibaren iş akışının bu aşamasında, AI Logic için otomatik olarak Firebase App Check zorunlu kılınacak. Bu, Gemini API doğrudan uygulamanızdan erişildiğinde korunmasına yardımcı olan kritik bir hizmettir. Başlangıç sürecinin bir parçası olarak (bu kılavuzun ilerleyen bölümlerindeki adımlara bakın), App Check zorunlu kılındığında yerel geliştirme için App Check hata ayıklama sağlayıcısını yapılandırmanız gerekir.

  7. Gerekli SDK'ları uygulamanıza eklemek için bu kılavuzdaki sonraki adıma geçin.

2. adım: Gerekli SDK'ları ekleyin

Firebase projeniz ayarlanmış ve gerekli API'ler etkinleştirilmişken (önceki adıma bakın) artık gerekli SDK'ları uygulamanıza ekleyebilirsiniz.

Swift

Firebase bağımlılarını yükleyip yönetmek için Swift Package Manager'ı kullanın. Gerekirse diğer yükleme seçenekleri hakkında bilgi edinin.

Firebase AI Logic kitaplığı, Gemini modelleriyle etkileşim kurmak için API'lere erişim sağlar. Kitaplık, Apple platformları için Firebase SDK'sının (firebase-ios-sdk) bir parçası olarak dahil edilir.

Firebase'i zaten kullanıyorsanız Firebase paketinizin v12.5.0 veya sonraki bir sürüm olduğundan emin olun.

  1. Xcode'da, uygulamanız açıkken File > Add Package Dependencies (Dosya > Paket Bağımlılıkları Ekle) seçeneğine gidin.

  2. İstendiğinde Firebase Apple platformları SDK deposunu ekleyin:

    https://github.com/firebase/firebase-ios-sdk

  3. En yeni SDK sürümünü seçin.

  4. FirebaseAILogic kitaplığını ve FirebaseAppCheck kitaplığını seçin.

İşlem tamamlandığında Xcode otomatik olarak arka planda bağımlılarınızı çözümlemeye ve indirmeye başlar.

Kotlin

Firebase AI Logic Android için SDK (firebase-ai), Gemini modelleriyle etkileşim kurmaya yönelik API'lere erişim sağlar.

Modülünüzün (uygulama düzeyinde) Gradle dosyasında (ör. <project>/<app-module>/build.gradle.kts), Android için Firebase AI Logic ve App Check kitaplıklarının bağımlılıklarını ekleyin. Kitaplık sürüm oluşturmayı kontrol etmek için Firebase Android BoM kullanmanızı öneririz.

dependencies {
  // ... other androidx dependencies

  // Import the BoM for the Firebase platform
  implementation(platform("com.google.firebase:firebase-bom:34.15.0"))

  // Add the dependencies for the Firebase AI Logic and App Check libraries
  // When using the BoM, you don't specify versions in Firebase library dependencies
  implementation("com.google.firebase:firebase-ai")
  implementation("com.google.firebase:firebase-appcheck-debug")
}

Firebase Android BoM kullanıldığında uygulamanız Firebase Android kitaplıklarının daima uyumlu sürümlerini kullanır.

Java

Firebase AI Logic Android için SDK (firebase-ai), Gemini modelleriyle etkileşim kurmaya yönelik API'lere erişim sağlar.

Modülünüzün (uygulama düzeyinde) Gradle dosyasında (ör. <project>/<app-module>/build.gradle.kts), Android için Firebase AI Logic ve App Check kitaplıklarının bağımlılıklarını ekleyin. Kitaplık sürüm oluşturmayı kontrol etmek için Firebase Android BoM kullanmanızı öneririz.

Java için iki ek kitaplık eklemeniz gerekir.

dependencies {
  // ... other androidx dependencies

  // Import the BoM for the Firebase platform
  implementation(platform("com.google.firebase:firebase-bom:34.15.0"))

  // Add the dependencies for the Firebase AI Logic and App Check libraries
  // When using the BoM, you don't specify versions in Firebase library dependencies
  implementation("com.google.firebase:firebase-ai")
  implementation("com.google.firebase:firebase-appcheck-debug")

  // Required for one-shot operations (to use `ListenableFuture` from Guava Android)
  implementation("com.google.guava:guava:31.0.1-android")

  // Required for streaming operations (to use `Publisher` from Reactive Streams)
  implementation("org.reactivestreams:reactive-streams:1.0.4")
}

Firebase Android BoM kullanıldığında uygulamanız Firebase Android kitaplıklarının daima uyumlu sürümlerini kullanır.

Web

Firebase AI Logic kitaplığı, Gemini modelleriyle etkileşim kurmak için API'lere erişim sağlar. Kitaplık, Web için Firebase JavaScript SDK'sının bir parçası olarak dahil edilir.

  1. npm kullanarak web için Firebase JS SDK'sını yükleyin:

    npm install firebase

  2. Uygulamanızda Firebase'i başlatın:

    import { initializeApp } from "firebase/app";
import { initializeAppCheck, DebugProvider } from "firebase/app-check";

// TODO(developer) Replace the following with your app's Firebase configuration
// See: https://firebase.google.com/docs/web/learn-more#config-object
const firebaseConfig = {
  // ...
};

// Initialize FirebaseApp
const firebaseApp = initializeApp(firebaseConfig);

Dart

Flutter için Firebase AI Logic eklentisi (firebase_ai), Gemini modelleriyle etkileşim kurmaya yönelik API'lere erişim sağlar.

  1. Flutter proje dizininizden aşağıdaki komutu çalıştırarak Firebase AI Logic ve App Check eklentilerini yükleyin:

    flutter pub add firebase_ai firebase_app_check

  2. lib/main.dart dosyanızda Firebase AI Logic ve App Check eklentilerini içe aktarın:

    import 'package:firebase_core/firebase_core.dart';
import 'package:firebase_ai/firebase_ai.dart';
import 'package:firebase_app_check/firebase_app_check.dart';
import 'firebase_options.dart';

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

    await Firebase.initializeApp(
  options: DefaultFirebaseOptions.currentPlatform,
);

  4. Flutter uygulamanızı yeniden oluşturun:

    flutter run

Unity

  1. Firebase Unity SDK'sını indirip SDK'yı uygun bir yere çıkarın.

    Firebase Unity SDK'sı platforma özgü değildir.

  2. Açık Unity projenizde Öğeler > Paket İçe Aktar > Özel Paket'e gidin.

  3. Ayıklanan SDK'dan FirebaseAI ve FirebaseAppCheck paketlerini seçin.

  4. Unity Paketini İçe Aktar penceresinde İçe Aktar'ı tıklayın.

3. adım: Yerel geliştirme için App Check hata ayıklama sağlayıcısını yapılandırın

Temmuz 2026'nın başlarından itibaren, konsolda AI Logic için rehberli kurulum iş akışının bir parçası olarak Firebase App Check, Gemini API'yi korumak için otomatik olarak zorunlu kılınacak. Yerel geliştirme için, App Check'nın zorunlu kılınmasını sürdürürken onaylamayı atlamak üzere App Check hata ayıklama sağlayıcısını yapılandırmanız gerekir.

uygulayın.

Swift

Uygulamanızı bir simülatörde etkileşimli olarak (ör. yerel geliştirme sırasında) çalıştırırken hata ayıklama sağlayıcısını kullanma adımları aşağıda verilmiştir:

  1. Xcode projenizde FirebaseAppCheck öğesini içe aktarın ve App Check öğesini, Firebase öğesini yapılandırmadan önce hata ayıklama sağlayıcı fabrikasıyla başlatın.

    import SwiftUI
import FirebaseCore
import FirebaseAppCheck

@main
struct YourApp: App {
  init() {
    let providerFactory = AppCheckDebugProviderFactory()
    AppCheck.setAppCheckProviderFactory(providerFactory)
    FirebaseApp.configure()
  }

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}

  2. Hata ayıklama jetonunuzu alın:

    1. Uygulamanızı simülatörde veya test cihazınızda başlatın.

    2. Xcode konsolunu açın ve App Check hata ayıklama jetonunu bulun. Örneğin:

      <Warning> [AppCheckCore][I-GAC004001] App Check debug token: '123a4567-b89c-12d3-e456-789012345678'.

    3. Jetonu kopyalayın (örneğin, 123a4567-b89c-12d3-e456-789012345678).

  3. Hata ayıklama jetonunuzu App Check ile kaydedin:

    1. Firebase konsolunda Güvenlik > App Check > Uygulamalar sekmesine gidin.

    2. Uygulamanızı bulun, taşma menüsünü () tıklayın ve Hata ayıklama jetonlarını yönet'i seçin.

    3. Hata ayıklama jetonunuzu kaydetmek için ekrandaki talimatları uygulayın.

Hata ayıklama sağlayıcısı hakkında ayrıntılı bilgi (yeni bir hata ayıklama jetonunun nasıl alınacağı dahil) için resmi App Check belgelerini inceleyin.

Kotlin

Uygulamanızı bir emülatörde etkileşimli olarak (ör. yerel geliştirme sırasında) çalıştırırken hata ayıklama sağlayıcısını kullanma adımları şunlardır:

  1. Hata ayıklama derlemenizde, App Check öğesini hata ayıklama sağlayıcı fabrikasını kullanacak şekilde yapılandırın:

    Firebase.initialize(context = this)
Firebase.appCheck.installAppCheckProviderFactory(
    DebugAppCheckProviderFactory.getInstance(),
)

  2. Hata ayıklama jetonunuzu alın:

    1. Uygulamanızı emülatörde veya test cihazınızda çalıştırın.

    2. Günlüklerinizde App Check hata ayıklama jetonunu bulun. Örneğin:

      D DebugAppCheckProvider: Enter this debug secret into the allow list
in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678

    3. Jetonu kopyalayın (örneğin, 123a4567-b89c-12d3-e456-789012345678).

  3. Hata ayıklama jetonunuzu App Check ile kaydedin:

    1. Firebase konsolunda Güvenlik > App Check > Uygulamalar sekmesine gidin.

    2. Uygulamanızı bulun, taşma menüsünü () tıklayın ve Hata ayıklama jetonlarını yönet'i seçin.

    3. Hata ayıklama jetonunuzu kaydetmek için ekrandaki talimatları uygulayın.

Hata ayıklama sağlayıcısı hakkında ayrıntılı bilgi (yeni bir hata ayıklama jetonunun nasıl alınacağı dahil) için resmi App Check belgelerini inceleyin.

Java

Uygulamanızı bir emülatörde etkileşimli olarak (ör. yerel geliştirme sırasında) çalıştırırken hata ayıklama sağlayıcısını kullanma adımları şunlardır:

  1. Hata ayıklama derlemenizde, App Check öğesini hata ayıklama sağlayıcı fabrikasını kullanacak şekilde yapılandırın:

    FirebaseApp.initializeApp(/*context=*/ this);
FirebaseAppCheck firebaseAppCheck = FirebaseAppCheck.getInstance();
firebaseAppCheck.installAppCheckProviderFactory(
        DebugAppCheckProviderFactory.getInstance());

  2. Hata ayıklama jetonunuzu alın:

    1. Uygulamanızı emülatörde veya test cihazınızda çalıştırın.

    2. Günlüklerinizde App Check hata ayıklama jetonunu bulun. Örneğin:

      D DebugAppCheckProvider: Enter this debug secret into the allow list
in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678

    3. Jetonu kopyalayın (örneğin, 123a4567-b89c-12d3-e456-789012345678).

  3. Hata ayıklama jetonunuzu App Check ile kaydedin:

    1. Firebase konsolunda Güvenlik > App Check > Uygulamalar sekmesine gidin.

    2. Uygulamanızı bulun, taşma menüsünü () tıklayın ve Hata ayıklama jetonlarını yönet'i seçin.

    3. Hata ayıklama jetonunuzu kaydetmek için ekrandaki talimatları uygulayın.

Hata ayıklama sağlayıcısı hakkında ayrıntılı bilgi (yeni bir hata ayıklama jetonunun nasıl alınacağı dahil) için resmi App Check belgelerini inceleyin.

Web

Uygulamanızı localhost etkileşimli olarak (ör. yerel geliştirme sırasında) çalıştırırken hata ayıklama sağlayıcısını kullanmak için:

  1. Hata ayıklama derlemenizde, App Check öğesini başlatmadan önce self.FIREBASE_APPCHECK_DEBUG_TOKEN değerini true olarak ayarlayarak hata ayıklama modunu etkinleştirin. Örneğin:

    self.FIREBASE_APPCHECK_DEBUG_TOKEN = true;
initializeAppCheck(app, { /* App Check options */ });

  2. Web uygulamanızı yerel olarak ziyaret edin ve tarayıcının geliştirici araçlarını açın. Hata ayıklama konsolunda bir hata ayıklama jetonu görürsünüz:

    AppCheck debug token: "123a4567-b89c-12d3-e456-789012345678".
You will need to safelist it in the Firebase console for it to work.

  3. Hata ayıklama jetonunuzu App Check ile kaydedin:

    1. Firebase konsolunda Güvenlik > App Check > Uygulamalar sekmesine gidin.

    2. Uygulamanızı bulun, taşma menüsünü () tıklayın ve Hata ayıklama jetonlarını yönet'i seçin.

    3. Hata ayıklama jetonunuzu kaydetmek için ekrandaki talimatları uygulayın.

Hata ayıklama sağlayıcısı hakkında ayrıntılı bilgi (yeni bir hata ayıklama jetonunun nasıl alınacağı dahil) için resmi App Check belgelerini inceleyin.

Dart

iOS+

Uygulamanızı bir simülatörde etkileşimli olarak (ör. yerel geliştirme sırasında) çalıştırırken hata ayıklama sağlayıcısını kullanma adımları aşağıda verilmiştir:

  1. Firebase uygulamanızı başlattıktan hemen sonra hata ayıklama sağlayıcısıyla App Check'ı etkinleştirin:

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

// Import the firebase_app_check plugin
import 'package:firebase_app_check/firebase_app_check.dart';

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  await FirebaseAppCheck.instance.activate(
    // Set appleProvider to `AppleProvider.debug`
    appleProvider: AppleProvider.debug,
  );
  runApp(App());
}

  2. Xcode projenizde hata ayıklama günlüğünü etkinleştirin:

    1. Product (Ürün) > Scheme (Şema) > Edit scheme (Şemayı düzenle)'yi açın.
    2. Soldaki menüden Run'ı (Çalıştır) ve ardından Arguments (Bağımsız Değişkenler) sekmesini seçin.
    3. Arguments Passed on Launch (Başlatmada İletilen Parametreler) bölümüne -FIRDebugEnabled ifadesini ekleyin.

  3. Hata ayıklama jetonunuzu alın:

    1. ios/Runner.xcworkspace dosyasını Xcode ile açın ve uygulamanızı simülatörde veya test cihazınızda çalıştırın.

    2. Xcode konsolunu açın ve App Check hata ayıklama jetonunu bulun. Örneğin:

      <Warning> [AppCheckCore][I-GAC004001] App Check debug token: '123a4567-b89c-12d3-e456-789012345678'.

    3. Jetonu kopyalayın (örneğin, 123a4567-b89c-12d3-e456-789012345678).

  4. Hata ayıklama jetonunuzu App Check ile kaydedin:

    1. Firebase konsolunda Güvenlik > App Check > Uygulamalar sekmesine gidin.

    2. Uygulamanızı bulun, taşma menüsünü () tıklayın ve Hata ayıklama jetonlarını yönet'i seçin.

    3. Hata ayıklama jetonunuzu kaydetmek için ekrandaki talimatları uygulayın.

Android

Uygulamanızı bir emülatörde etkileşimli olarak (ör. yerel geliştirme sırasında) çalıştırırken hata ayıklama sağlayıcısını kullanma adımları şunlardır:

  1. Firebase uygulamanızı başlattıktan hemen sonra hata ayıklama sağlayıcısıyla App Check'ı etkinleştirin:

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

// Import the firebase_app_check plugin
import 'package:firebase_app_check/firebase_app_check.dart';

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  await FirebaseAppCheck.instance.activate(
    // Set androidProvider to `AndroidProvider.debug`
    androidProvider: AndroidProvider.debug,
  );
  runApp(App());
}

  2. Hata ayıklama jetonunuzu alın:

    1. Uygulamanızı emülatörde veya test cihazınızda çalıştırın.

    2. Günlüklerinizde App Check hata ayıklama jetonunu bulun. Örneğin:

      D DebugAppCheckProvider: Enter this debug secret into the allow list
in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678

    3. Jetonu kopyalayın (örneğin, 123a4567-b89c-12d3-e456-789012345678).

  3. Hata ayıklama jetonunuzu App Check ile kaydedin:

    1. Firebase konsolunda Güvenlik > App Check > Uygulamalar sekmesine gidin.

    2. Uygulamanızı bulun, taşma menüsünü () tıklayın ve Hata ayıklama jetonlarını yönet'i seçin.

    3. Hata ayıklama jetonunuzu kaydetmek için ekrandaki talimatları uygulayın.

Web

Uygulamanızı localhost üzerinden etkileşimli olarak (ör. yerel geliştirme sırasında) çalıştırırken hata ayıklama sağlayıcısını kullanmak için:

  1. web/index.html dosyasında, self.FIREBASE_APPCHECK_DEBUG_TOKEN değerini true olarak ayarlayarak hata ayıklama modunu etkinleştirin:

    <body>
  <script>
    self.FIREBASE_APPCHECK_DEBUG_TOKEN = true;
  </script>

  ...

</body>

  2. Web uygulamanızı yerel olarak çalıştırın ve tarayıcının geliştirici araçlarını açın. Hata ayıklama konsolunda bir hata ayıklama jetonu görürsünüz:

    AppCheck debug token: "123a4567-b89c-12d3-e456-789012345678".
You will need to safelist it in the Firebase console for it to work.

    Bu jeton tarayıcınızda yerel olarak depolanır ve uygulamanızı aynı makinede aynı tarayıcıda her kullandığınızda kullanılır. Jetonu başka bir tarayıcıda veya makinede kullanmak istiyorsanız self.FIREBASE_APPCHECK_DEBUG_TOKEN değerini true yerine jeton dizesi olarak ayarlayın.

  3. Hata ayıklama jetonunuzu App Check ile kaydedin:

    1. Firebase konsolunda Güvenlik > App Check > Uygulamalar sekmesine gidin.

    2. Uygulamanızı bulun, taşma menüsünü () tıklayın ve Hata ayıklama jetonlarını yönet'i seçin.

    3. Hata ayıklama jetonunuzu kaydetmek için ekrandaki talimatları uygulayın.

Hata ayıklama sağlayıcısı hakkında ayrıntılı bilgi (yeni bir hata ayıklama jetonunun nasıl alınacağı dahil) için resmi App Check belgelerini inceleyin.

Unity

Uygulamanızı bir emülatörde etkileşimli olarak (ör. yerel geliştirme sırasında) çalıştırırken hata ayıklama sağlayıcısını kullanma adımları şunlardır:

  1. Firebase konsolunda bir hata ayıklama jetonu oluşturun:

    1. Firebase konsolunda Güvenlik > Uygulama Kontrolü > Uygulamalar sekmesine gidin.

    2. Uygulamanızı bulun, taşma menüsünü () tıklayın ve Hata ayıklama jetonlarını yönet'i seçin.

    3. Yeni bir hata ayıklama jetonu oluşturmak için ekrandaki talimatları uygulayın.

  2. Uygulamanızın ilk kullanıma hazırlama koduna aşağıdakileri ekleyin:

    using Firebase.AppCheck;

void InitializeFirebase() {
  // Configure the Debug Provider factory with your debug token.
  DebugAppCheckProviderFactory.Instance.SetDebugToken("YOUR_DEBUG_TOKEN");

  // Set App Check to use the debug provider factory
  FirebaseAppCheck.SetAppCheckProviderFactory(
    DebugAppCheckProviderFactory.Instance);

  // Proceed to initialize Firebase as normal
}

Hata ayıklama sağlayıcısı hakkında ayrıntılı bilgi (yeni bir hata ayıklama jetonunun nasıl alınacağı dahil) için resmi App Check belgelerini inceleyin.

4. adım: Hizmeti başlatın ve model örneği oluşturun

Sağlayıcıya özel içeriği ve kodu bu sayfada görüntülemek için Gemini API sağlayıcınızı tıklayın.

Gemini modeline istem göndermeden önce, seçtiğiniz API sağlayıcısı için hizmeti başlatın ve GenerativeModel örneği oluşturun.

Swift 


import FirebaseAILogic

// Initialize the Vertex AI Gemini API backend service.
// Specify `global` as the location to access the model.
let ai = FirebaseAI.firebaseAI(backend: .vertexAI(location: "global"))

// Create a `GenerativeModel` instance with a model that supports your use case
let model = ai.generativeModel(modelName: "gemini-3.5-flash")

Kotlin 


// Initialize the Vertex AI Gemini API backend service.
// Specify `global` as the location to access the model.
// Create a `GenerativeModel` instance with a model that supports your use case.
val model = Firebase.ai(backend = GenerativeBackend.vertexAI(location = "global"))
                        .generativeModel("gemini-3.5-flash")

Java 


// Initialize the Vertex AI Gemini API backend service.
// Specify `global` as the location to access the model.
// Create a `GenerativeModel` instance with a model that supports your use case.
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.vertexAI("global"))
        .generativeModel("gemini-3.5-flash");

// Use the GenerativeModelFutures Java compatibility layer which offers
// support for ListenableFuture and Publisher APIs
GenerativeModelFutures model = GenerativeModelFutures.from(ai);

Web 


import { initializeApp } from "firebase/app";
import { getAI, getGenerativeModel, VertexAIBackend } from "firebase/ai";

// TODO(developer) Replace the following with your app's Firebase configuration
// See: https://firebase.google.com/docs/web/learn-more#config-object
const firebaseConfig = {
  // ...
};

// Initialize FirebaseApp
const firebaseApp = initializeApp(firebaseConfig);

// Initialize the Vertex AI Gemini API backend service.
// Specify `global` as the location to access the model.
const ai = getAI(firebaseApp, { backend: new VertexAIBackend('global') });

// Create a `GenerativeModel` instance with a model that supports your use case
const model = getGenerativeModel(ai, { model: "gemini-3.5-flash" });

Dart 


import 'package:firebase_ai/firebase_ai.dart';
import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart';

// Initialize FirebaseApp
await Firebase.initializeApp(
  options: DefaultFirebaseOptions.currentPlatform,
);

// Initialize the Vertex AI Gemini API backend service.
// Specify `global` as the location to access the model.
// Create a `GenerativeModel` instance with a model that supports your use case.
final model =
      FirebaseAI.vertexAI(location: 'global').generativeModel(model: 'gemini-3.5-flash');

Unity 


using Firebase;
using Firebase.AI;

// Initialize the Vertex AI Gemini API backend service.
// Specify `global` as the location to access the model.
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.VertexAI(location: "global"));

// Create a `GenerativeModel` instance with a model that supports your use case.
var model = ai.GetGenerativeModel(modelName: "gemini-3.5-flash");

Kullandığınız özelliğe bağlı olarak her zaman GenerativeModel örneği oluşturamayabilirsiniz. Gemini Live API kullanarak giriş ve çıkış akışı yapmak için LiveModel örneği oluşturun.

Ayrıca, bu başlangıç kılavuzunu tamamladıktan sonra kullanım alanınız ve uygulamanız için nasıl model seçeceğinizi öğrenin.

5. adım: Modele istek gönderme

Artık Gemini modeline istek gönderebilirsiniz.

generateContent() kullanarak metin içeren bir istemden metin oluşturabilirsiniz:

Swift 


import FirebaseAILogic

// Initialize the Vertex AI Gemini API backend service.
// Specify `global` as the location to access the model.
let ai = FirebaseAI.firebaseAI(backend: .vertexAI(location: "global"))

// Create a `GenerativeModel` instance with a model that supports your use case
let model = ai.generativeModel(modelName: "gemini-3.5-flash")

// Provide a prompt that contains text
let prompt = "Write a story about a magic backpack."

// To generate text output, call generateContent with the text input
let response = try await model.generateContent(prompt)
print(response.text ?? "No text in response.")

Kotlin

Kotlin'de bu SDK'daki yöntemler askıya alma işlevleridir ve Coroutine kapsamından çağrılmaları gerekir. 

// Initialize the Vertex AI Gemini API backend service.
// Specify `global` as the location to access the model.
// Create a `GenerativeModel` instance with a model that supports your use case.
val model = Firebase.ai(backend = GenerativeBackend.vertexAI(location = "global"))
                        .generativeModel("gemini-3.5-flash")

// Provide a prompt that contains text
val prompt = "Write a story about a magic backpack."

// To generate text output, call generateContent with the text input
val response = model.generateContent(prompt)
print(response.text)

Java

Java için bu SDK'daki yöntemler bir ListenableFuture döndürür. 

// Initialize the Vertex AI Gemini API backend service.
// Specify `global` as the location to access the model.
// Create a `GenerativeModel` instance with a model that supports your use case.
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.vertexAI("global"))
        .generativeModel("gemini-3.5-flash");

// Use the GenerativeModelFutures Java compatibility layer which offers
// support for ListenableFuture and Publisher APIs
GenerativeModelFutures model = GenerativeModelFutures.from(ai);

// Provide a prompt that contains text
Content prompt = new Content.Builder()
    .addText("Write a story about a magic backpack.")
    .build();

// To generate text output, call generateContent with the text input
ListenableFuture<GenerateContentResponse> response = model.generateContent(prompt);
Futures.addCallback(response, new FutureCallback<GenerateContentResponse>() {
    @Override
    public void onSuccess(GenerateContentResponse result) {
        String resultText = result.getText();
        System.out.println(resultText);
    }

    @Override
    public void onFailure(Throwable t) {
        t.printStackTrace();
    }
}, executor);

Web 


import { initializeApp } from "firebase/app";
import { getAI, getGenerativeModel, VertexAIBackend } from "firebase/ai";

// TODO(developer) Replace the following with your app's Firebase configuration
// See: https://firebase.google.com/docs/web/learn-more#config-object
const firebaseConfig = {
  // ...
};

// Initialize FirebaseApp
const firebaseApp = initializeApp(firebaseConfig);

// Initialize the Vertex AI Gemini API backend service.
// Specify `global` as the location to access the model.
const ai = getAI(firebaseApp, { backend: new VertexAIBackend('global') });

// Create a `GenerativeModel` instance with a model that supports your use case
const model = getGenerativeModel(ai, { model: "gemini-3.5-flash" });

// Wrap in an async function so you can use await
async function run() {
  // Provide a prompt that contains text
  const prompt = "Write a story about a magic backpack."

  // To generate text output, call generateContent with the text input
  const result = await model.generateContent(prompt);

  const response = result.response;
  const text = response.text();
  console.log(text);
}

run();

Dart 


import 'package:firebase_ai/firebase_ai.dart';
import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart';

// Initialize FirebaseApp
await Firebase.initializeApp(
  options: DefaultFirebaseOptions.currentPlatform,
);

// Initialize the Vertex AI Gemini API backend service.
// Specify `global` as the location to access the model.
// Create a `GenerativeModel` instance with a model that supports your use case.
final model =
      FirebaseAI.vertexAI(location: 'global').generativeModel(model: 'gemini-3.5-flash');

// Provide a prompt that contains text
final prompt = [Content.text('Write a story about a magic backpack.')];

// To generate text output, call generateContent with the text input
final response = await model.generateContent(prompt);
print(response.text);

Unity 


using Firebase;
using Firebase.AI;

// Initialize the Vertex AI Gemini API backend service.
// Specify `global` as the location to access the model.
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.VertexAI(location: "global"));

// Create a `GenerativeModel` instance with a model that supports your use case.
var model = ai.GetGenerativeModel(modelName: "gemini-3.5-flash");

// Provide a prompt that contains text
var prompt = "Write a story about a magic backpack.";

// To generate text output, call GenerateContentAsync with the text input
var response = await model.GenerateContentAsync(prompt);
UnityEngine.Debug.Log(response.Text ?? "No text in response.");

Başka ne yapabilirsin?

Desteklenen modeller hakkında daha fazla bilgi

Çeşitli kullanım alanları için kullanılabilen modeller, bu modellerin kotaları ve fiyatlandırması hakkında bilgi edinin.

Diğer özellikleri deneyin

İçerik oluşturmayı kontrol etme hakkında bilgi

Ayrıca istemler ve model yapılandırmalarıyla denemeler yapabilir, hatta Vertex AI Studio kullanarak oluşturulmuş bir kod snippet'i alabilirsiniz.


Firebase AI Logic ile ilgili deneyiminiz hakkında geri bildirim verme