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.
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.
1. adım: Firebase projesi oluşturma ve API'leri etkinleştirme
Firebase konsolunda oturum açın ve Firebase projenizi seçin.
Firebase konsolunda AI Services > AI Logic'e gidin.
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.
İ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 istediğiniz zaman Vertex AI Gemini API'ı (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, 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.
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.
Xcode'da, uygulamanız açıkken File > Add Package Dependencies (Dosya > Paket Bağımlılıkları Ekle) seçeneğine gidin.
İstendiğinde Firebase Apple platformları SDK deposunu ekleyin:
https://github.com/firebase/firebase-ios-sdkEn yeni SDK sürümünü seçin.
FirebaseAILogickitaplığını veFirebaseAppCheckkitaplığı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.
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 kurmaya yönelik API'lere erişim sağlar.
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_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 oluşturun:
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 Öğeler > Paket İçe Aktar > Özel Paket'e 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, 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:
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() } } } }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 kopyalayın (örneğin,
123a4567-b89c-12d3-e456-789012345678).
Hata ayıklama jetonunuzu App Check ile kaydedin:
Firebase konsolunda Güvenlik > App Check > 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 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:
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 kopyalayın (örneğin,
123a4567-b89c-12d3-e456-789012345678).
Hata ayıklama jetonunuzu App Check ile kaydedin:
Firebase konsolunda Güvenlik > App Check > 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 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:
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 kopyalayın (örneğin,
123a4567-b89c-12d3-e456-789012345678).
Hata ayıklama jetonunuzu App Check ile kaydedin:
Firebase konsolunda Güvenlik > App Check > 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 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:
Hata ayıklama derlemenizde, App Check öğesini başlatmadan ö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 > App Check > 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 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:
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()); }Xcode projenizde hata ayıklama günlüğünü etkinleştirin:
- Product (Ürün) > Scheme (Şema) > Edit scheme (Şemayı düzenle)'yi 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 Güvenlik > App Check > 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.
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:
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()); }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 > App Check > 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ı kullanmak için:
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ı 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_TOKENdeğerinitrueyerine jeton dizesi olarak ayarlayın.Hata ayıklama jetonunuzu App Check ile kaydedin:
Firebase konsolunda Güvenlik > App Check > 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 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:
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 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 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.5-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.5-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.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, 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.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 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.5-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.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 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.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 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.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 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.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, 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.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 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.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 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.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
- Yanıtı yayınlama da dahil olmak üzere yalnızca metin içeren istemlerden metin oluşturma hakkında daha fazla bilgi edinin.
- Resim, PDF, video ve ses gibi çeşitli dosya türleriyle istem oluşturarak metin üretin.
- Çok adımlı 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ü oluşturma ve düzenleme
- Gemini Live API kullanarak akış girişi ve çıkışı (ses dahil)
- Gemini modelini uygulamanızın diğer bölümlerine ve harici sistemler ile bilgilere bağlamak için işlev çağrısı ve Google Arama ile temellendirme gibi araçları kullanın.
İçerik oluşturmayı kontrol etme hakkında bilgi
- 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