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ılmaktadı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ştirmek üzere 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 24 (Nougat) veya sonraki sürümleri hedefliyor.
Java
Bu kılavuzda, Android için uygulama geliştirmek üzere 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 24 (Nougat) veya sonraki sürümleri hedefliyor.
Web
Bu kılavuzda, web uygulamaları geliştirmek için JavaScript kullanmayı bildiğiniz varsayılmaktadı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 şartları karşıladığından emin olun:
- Dart 3.2.0+
Unity
Bu rehberde, 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 bir sürüm
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. Kendi Apple platformları uygulamanız yoksa hızlı başlangıç uygulamasını kullanabilirsiniz. Hızlı başlangıç uygulamasını kullanmak için uygulamayı bir Firebase projesine bağlamanız gerekir.
Hızlı başlangıç uygulamasına gidin
Eğitim videosunu izleyin
Bu videoda, Firebase AI Logic ile çalışmaya başlamak için metin isteminden tarifler oluşturan, yapay zeka destekli gerçek dünya yemek planlama uygulamasının nasıl oluşturulacağı gösterilmektedir.
Videodaki uygulamanın kod tabanını indirip inceleyebilirsiniz.
Videodaki uygulamanı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. 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 gidin
Eğitim videosunu izleyin
Bu videoda, Firebase AI Logic ile çalışmaya başlamak için metin isteminden tarifler oluşturan, yapay zeka destekli gerçek dünya yemek planlama uygulamasının nasıl oluşturulacağı gösterilmektedir.
Ayrıca 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 uygulamayı bir Firebase projesine bağlamanız gerekir.
Hızlı başlangıç uygulamasına gidin
Eğitim videosunu izleyin
Bu videoda, Firebase AI Logic ile nasıl başlayacağınız gösterilmektedir.* Bu amaçla, metin isteminden tarifler oluşturan, yapay zeka destekli gerçek dünya yemek planlama uygulaması oluşturulur.
Ayrıca videodaki uygulamanın kod tabanını indirip inceleyebilirsiniz.
Videodaki uygulamanın kod tabanını görüntüleme
* Bu video ve videodaki uygulama Kotlin dilinde olsa da Java geliştiricilerin Firebase AI Logic kullanmaya başlama ile ilgili temel bilgileri 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. Alternatif olarak, kendi web uygulamanız yoksa hızlı başlangıç uygulamasını kullanabilirsiniz. Hızlı başlangıç uygulamasını kullanmak için bir Firebase projesine bağlamanız gerekir.
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. 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 gidin
Eğitim videosunu izleyin
Bu videoda, Firebase AI Logic ile çalışmaya başlamak için metin isteminden tarifler oluşturan, yapay zeka destekli gerçek dünya yemek planlama uygulamasının nasıl oluşturulacağı gösterilmektedir.
Videodaki uygulamanın kod tabanını indirip inceleyebilirsiniz.
Videodaki uygulamanı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.
1. adım: Firebase projesi oluşturun ve API'leri etkinleştirin
Firebase konsolunda oturum açın ve Firebase projenizi seçin.
Firebase konsolunda AI Services (Yapay Zeka Hizmetleri) > AI Logic (Yapay Zeka Mantığı) bölümüne gidin.
Projeniz için gerekli API'leri ve kaynakları ayarlamanıza yardımcı olan rehberli bir iş akışını başlatmak için Başlayın'ı tıklayın.
İstenirse uygulamanızı kaydetmek ve Firebase yapılandırmanızı uygulamanıza eklemek için ekrandaki talimatları uygulayın.
"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 dilediğiniz zaman Agent Platform Gemini API (formerly Vertex AI)'i (ve faturalandırma şartını) ayarlayabilirsiniz.
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, uygulamanıza doğrudan erişildiğinde Gemini API'ı korumaya yardımcı olan kritik bir hizmet olan AI Logic için otomatik olarak Firebase App Check uygulanacak. Başlarken (bu kılavuzun ilerleyen bölümlerindeki adımlara bakın) App Check uygulandığında yerel geliştirme için App Check hata ayıklama sağlayıcısını yapılandırmanız gerekir.
Gerekli SDK'ları uygulamanıza eklemek için bu kılavuzdaki sonraki adıma geçin.
2. adım: Gerekli SDK'ları ekleyin
Firebase projenizi ayarlayıp gerekli API'leri etkinleştirdikten sonra (önceki adıma bakın) artık gerekli SDK'ları uygulamanıza ekleyebilirsiniz.
Swift
Firebase bağımlılıklarını yüklemek ve 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ına (firebase-ios-sdk) dahildir.
Firebase'i zaten kullanıyorsanız Firebase paketinizin v12.5.0 veya sonraki bir sürüm olduğundan emin olun.
Xcode'da uygulama projeniz açıkken File > Add Package Dependencies'e (Dosya > Paket Bağımlılıkları Ekle) gidin.
İstendiğinde Firebase Apple platformları SDK deposunu ekleyin:
https://github.com/firebase/firebase-ios-sdkEn son SDK sürümünü seçin.
FirebaseAILogickitaplığını veFirebaseAppCheckkitaplığını seçin.
İşlem tamamlandığında Xcode, arka planda bağımlılıklarınızı otomatik olarak çözmeye ve indirmeye başlar.
Kotlin
Firebase AI Logic Android için SDK (firebase-ai), Gemini modelleriyle etkileşim kurmak için 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ünü 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:35.0.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 öğesini kullanarak, uygulamanız her zaman Firebase Android kitaplıklarının uyumlu sürümlerini kullanır.
Java
Firebase AI Logic Android için SDK (firebase-ai), Gemini modelleriyle etkileşim kurmak için 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ünü 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:35.0.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 kullanarak uygulamanızın her zaman Firebase Android kitaplıklarının uyumlu sürümlerini kullanmasını sağlayabilirsiniz.
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 sunulur.
npm kullanarak web için Firebase JS SDK'sını yükleyin:
npm install firebaseUygulamanı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 kurmak için API'lere erişim sağlar.
Firebase AI Logic ve App Check eklentilerini yüklemek için Flutter proje dizininizden aşağıdaki komutu çalıştırın:
flutter pub add firebase_ai firebase_app_checklib/main.dartdosyanı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';Ayrıca
lib/main.dartdosyanızda, yapılandırma dosyası tarafından dışa aktarılanDefaultFirebaseOptionsnesnesini kullanarak Firebase'i başlattığınızdan emin olun:await Firebase.initializeApp( options: DefaultFirebaseOptions.currentPlatform, );Flutter uygulamanızı yeniden derleyin:
flutter run
Unity
Firebase Unity SDK'sını indirip SDK'yı uygun bir yere çıkarın.
Firebase Unity SDK'sı platforma özgü değildir.
Açık Unity projenizde Assets > Import Package > Custom Package'a (Öğeler > Paketi İçe Aktar > Özel Paket) gidin.
Ayıklanan SDK'dan
FirebaseAIveFirebaseAppCheckpaketlerini seçin.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, Firebase konsolundaki rehberli kurulum iş akışı sırasında Firebase, Firebase App Check'u otomatik olarak zorunlu kılacak. Bu sayede Firebase AI Logic, Gemini API'nin korunmasına yardımcı olacak.
Yerel geliştirme için App Check hata ayıklama sağlayıcısını ayarlayabilir ve Firebase AI Logic için App Check'yi zorunlu kılmaya devam edebilirsiniz.
uygulayın.Swift
Uygulamanızı bir simülatörde etkileşimli olarak çalıştırırken (ör. yerel geliştirme sırasında) hata ayıklama sağlayıcısını şu şekilde kullanabilirsiniz:
Xcode projenizde
FirebaseAppCheckiçe aktarın ve hata ayıklama sağlayıcı fabrikası ile App Check ilk kullanıma hazırlayın önceFirebaseyapılandırı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() } } } }Hata ayıklama jetonunuzu alın:
Uygulamanızı simülatörde veya test cihazınızda başlatın.
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'.Jetonu (ör.
123a4567-b89c-12d3-e456-789012345678) kopyalayın.
Hata ayıklama jetonunuzu App Check ile kaydedin:
Firebase konsolunda Security (Güvenlik) > App Check (Uygulama Kontrolü) > Apps (Uygulamalar) sekmesine gidin.
Uygulamanızı bulun, taşma menüsünü () tıklayın ve Hata ayıklama jetonlarını yönet'i seçin.
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 belgelerine bakın.
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ı:
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(), )
Hata ayıklama jetonunuzu alın:
Uygulamanızı emülatörde veya test cihazınızda çalıştırın.
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-789012345678Jetonu (ör.
123a4567-b89c-12d3-e456-789012345678) kopyalayın.
Hata ayıklama jetonunuzu App Check ile kaydedin:
Firebase konsolunda Security (Güvenlik) > App Check (Uygulama Kontrolü) > Apps (Uygulamalar) sekmesine gidin.
Uygulamanızı bulun, taşma menüsünü () tıklayın ve ardından Hata ayıklama jetonlarını yönet'i seçin.
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 belgeleri inceleyin.
Java
Uygulamanızı bir emülatörde etkileşimli olarak çalıştırırken (örneğin, yerel geliştirme sırasında) hata ayıklama sağlayıcısını şu şekilde kullanabilirsiniz:
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());
Hata ayıklama jetonunuzu alın:
Uygulamanızı emülatörde veya test cihazınızda çalıştırın.
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-789012345678Jetonu (ör.
123a4567-b89c-12d3-e456-789012345678) kopyalayın.
Hata ayıklama jetonunuzu App Check ile kaydedin:
Firebase konsolunda Security (Güvenlik) > App Check (Uygulama Kontrolü) > Apps (Uygulamalar) sekmesine gidin.
Uygulamanızı bulun, taşma menüsünü () tıklayın ve ardından Hata ayıklama jetonlarını yönet'i seçin.
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 belgelerine bakın.
Web
Uygulamanızı localhost üzerinden etkileşimli olarak çalıştırırken (ör. yerel geliştirme sırasında) hata ayıklama sağlayıcısını nasıl kullanacağınızı aşağıda bulabilirsiniz:
Hata ayıklama derlemenizde, App Check başlatılmadan önce
self.FIREBASE_APPCHECK_DEBUG_TOKENdeğerinitrueolarak ayarlayarak hata ayıklama modunu etkinleştirin. Örneğin:self.FIREBASE_APPCHECK_DEBUG_TOKEN = true; initializeAppCheck(app, { /* App Check options */ });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.Hata ayıklama jetonunuzu App Check ile kaydedin:
Firebase konsolunda Güvenlik > Uygulama Kontrolü > Uygulamalar sekmesine gidin.
Uygulamanızı bulun, taşma menüsünü () tıklayın ve Hata ayıklama jetonlarını yönet'i seçin.
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 belgelerine bakın.
Dart
iOS+
Uygulamanızı bir simülatörde etkileşimli olarak çalıştırırken (örneğin, yerel geliştirme sırasında) hata ayıklama sağlayıcısını şu şekilde kullanabilirsiniz:
Firebase uygulamanızı başlattıktan hemen sonra hata ayıklama sağlayıcısıyla App Check özelliğini 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()); }Xcode projenizde hata ayıklama günlük kaydını etkinleştirin:
- Product > Scheme > Edit scheme'i (Ürün > Şema > Şemayı düzenle) açın.
- Soldaki menüden Run'ı (Çalıştır) ve ardından Arguments (Bağımsız Değişkenler) sekmesini seçin.
- Arguments Passed on Launch (Başlatmada İletilen Parametreler) bölümüne
-FIRDebugEnabledifadesini ekleyin.
Hata ayıklama jetonunuzu alın:
ios/Runner.xcworkspacedosyasını Xcode ile açın ve uygulamanızı simülatörde veya test cihazınızda çalıştırın.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'.Jetonu kopyalayın (örneğin,
123a4567-b89c-12d3-e456-789012345678).
Hata ayıklama jetonunuzu App Check ile kaydedin:
Firebase konsolunda Security (Güvenlik) > App Check (Uygulama Kontrolü) > Apps (Uygulamalar) sekmesine gidin.
Uygulamanızı bulun, taşma menüsünü () tıklayın ve ardından Hata ayıklama jetonlarını yönet'i seçin.
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ı:
Firebase uygulamanızı başlattıktan hemen sonra hata ayıklama sağlayıcısıyla App Check özelliğini 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()); }Hata ayıklama jetonunuzu alın:
Uygulamanızı emülatörde veya test cihazınızda çalıştırın.
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-789012345678Jetonu kopyalayın (örneğin,
123a4567-b89c-12d3-e456-789012345678).
Hata ayıklama jetonunuzu App Check ile kaydedin:
Firebase konsolunda Güvenlik > Uygulama Kontrolü > Uygulamalar sekmesine gidin.
Uygulamanızı bulun, taşma menüsünü () tıklayın ve Hata ayıklama jetonlarını yönet'i seçin.
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ı nasıl kullanacağınızı aşağıda bulabilirsiniz:
web/index.htmldosyasında,self.FIREBASE_APPCHECK_DEBUG_TOKENdeğerinitrueolarak ayarlayarak hata ayıklama modunu etkinleştirin:<body> <script> self.FIREBASE_APPCHECK_DEBUG_TOKEN = true; </script> ... </body>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ı makinedeki 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_TOKENdeğerinitrueyerine jeton dizesi olarak ayarlayın.Hata ayıklama jetonunuzu App Check ile kaydedin:
Firebase konsolunda Security (Güvenlik) > App Check (Uygulama Kontrolü) > Apps (Uygulamalar) sekmesine gidin.
Uygulamanızı bulun, taşma menüsünü () tıklayın ve ardından Hata ayıklama jetonlarını yönet'i seçin.
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 belgeleri 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ı:
Firebase konsolunda bir hata ayıklama jetonu oluşturun:
Firebase konsolunda Güvenlik > Uygulama Kontrolü > Uygulamalar sekmesine gidin.
Uygulamanızı bulun, taşma menüsünü () tıklayın ve Hata ayıklama jetonlarını yönet'i seçin.
Yeni bir hata ayıklama jetonu oluşturmak için ekrandaki talimatları uygulayın.
Uygulamanızın başlatma 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 belgelerine bakın.
4. adım: Hizmeti başlatın ve model örneği oluşturun
|
Bu sayfada sağlayıcıya özel içerikleri ve kodu 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ı için hizmeti başlatın ve bir GenerativeModel örneği oluşturun.
Swift
import FirebaseAILogic
// Initialize the Gemini Developer API backend service
let ai = FirebaseAI.firebaseAI(backend: .googleAI())
// Create a `GenerativeModel` instance with a model that supports your use case
let model = ai.generativeModel(modelName: "gemini-3.8-flash")
Kotlin
// Initialize the Gemini Developer API backend service.
// Create a `GenerativeModel` instance with a model that supports your use case.
val model = Firebase.ai(backend = GenerativeBackend.googleAI())
.generativeModel("gemini-3.8-flash")
Java
// Initialize the Gemini Developer API backend service.
// Create a `GenerativeModel` instance with a model that supports your use case.
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.googleAI())
.generativeModel("gemini-3.8-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, GoogleAIBackend } 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 Gemini Developer API backend service.
const ai = getAI(firebaseApp, { backend: new GoogleAIBackend() });
// Create a `GenerativeModel` instance with a model that supports your use case.
const model = getGenerativeModel(ai, { model: "gemini-3.8-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 Gemini Developer API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
final model =
FirebaseAI.googleAI().generativeModel(model: 'gemini-3.8-flash');
Unity
using Firebase;
using Firebase.AI;
// Initialize the Gemini Developer API backend service.
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.GoogleAI());
// Create a `GenerativeModel` instance with a model that supports your use case.
var model = ai.GetGenerativeModel(modelName: "gemini-3.8-flash");
Kullandığınız özelliğe bağlı olarak her zaman bir GenerativeModel örneği oluşturamayabileceğinizi unutmayın. 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 Gemini Developer API backend service
let ai = FirebaseAI.firebaseAI(backend: .googleAI())
// Create a `GenerativeModel` instance with a model that supports your use case
let model = ai.generativeModel(modelName: "gemini-3.8-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 için bu SDK'daki yöntemler askıya alma işlevleridir ve Coroutine kapsamından çağrılmaları gerekir.
// Initialize the Gemini Developer API backend service.
// Create a `GenerativeModel` instance with a model that supports your use case.
val model = Firebase.ai(backend = GenerativeBackend.googleAI())
.generativeModel("gemini-3.8-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 birListenableFuture döndürür.
// Initialize the Gemini Developer API backend service.
// Create a `GenerativeModel` instance with a model that supports your use case.
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.googleAI())
.generativeModel("gemini-3.8-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, GoogleAIBackend } 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 Gemini Developer API backend service.
const ai = getAI(firebaseApp, { backend: new GoogleAIBackend() });
// Create a `GenerativeModel` instance with a model that supports your use case.
const model = getGenerativeModel(ai, { model: "gemini-3.8-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 Gemini Developer API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
final model =
FirebaseAI.googleAI().generativeModel(model: 'gemini-3.8-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 Gemini Developer API backend service.
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.GoogleAI());
// Create a `GenerativeModel` instance with a model that supports your use case.
var model = ai.GetGenerativeModel(modelName: "gemini-3.8-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 yapabilirsiniz?
Desteklenen modeller hakkında daha fazla bilgi
Çeşitli kullanım alanları için kullanılabilen modeller, kotaları ve fiyatlandırmaları hakkında bilgi edinin.
Diğer özellikleri deneyin
- Yanıtın nasıl akış olarak alınacağı da dahil olmak üzere yalnızca metin istemlerinden metin oluşturma hakkında daha fazla bilgi edinin.
- Resim, PDF, video ve ses gibi çeşitli dosya türleriyle istem girerek metin oluşturun.
- Çok aşamalı etkileşimli görüşmeler (sohbet) oluşturun.
- Hem metin hem de çok formatlı istemlerden yapılandırılmış çıkış (ör. JSON) oluşturun.
- Hem metin hem de çok formatlı istemlerden görüntü üretip düzenleyin.
- Gemini Live API kullanarak giriş ve çıkış akışı (ses dahil) yapın.
-
Gemini modelini uygulamanızın diğer bölümlerine, harici sistemlere ve bilgilere bağlamak için araçları (işlev çağrısı ve
Google Search veyaGoogle Maps ile temellendirme gibi) kullanın.
İçerik üretimini nasıl kontrol edeceğinizi öğrenin.
- En iyi uygulamalar, stratejiler ve örnek istemler de dahil olmak üzere istem tasarımını anlama
- Maksimum çıkış jetonu sayısı, tekrarlanan çıkış jetonlarının olasılığı gibi model parametrelerini yapılandırın.
- Zararlı olarak değerlendirilebilecek yanıtlar alma olasılığını ayarlamak için güvenlik ayarlarını kullanın.
Firebase AI Logic ile ilgili deneyiminiz hakkında geri bildirim verme