In diesem Leitfaden erfahren Sie, wie Sie mit den Firebase AI Logic-Client-SDKs für die von Ihnen ausgewählte Plattform direkt aus Ihrer App Aufrufe an die Gemini API senden.
Vorbereitung
Swift
In diesem Leitfaden wird davon ausgegangen, dass Sie mit der Verwendung von Xcode zum Entwickeln von Apps für Apple-Plattformen (z. B. iOS) vertraut sind.
Ihre Entwicklungsumgebung und Ihre Apple-Plattform-App müssen die folgenden Anforderungen erfüllen:
- Xcode 26.2 oder höher
- Ihre App ist auf iOS 15 oder höher oder macOS 12 oder höher ausgerichtet.
Kotlin
In dieser Anleitung wird davon ausgegangen, dass Sie mit der Entwicklung von Android-Apps mit Android Studio vertraut sind.
Ihre Entwicklungsumgebung und Android-App müssen die folgenden Anforderungen erfüllen:
- Android Studio (neueste Version)
- Ihre App ist auf API‑Level 21 oder höher ausgerichtet.
Java
In dieser Anleitung wird davon ausgegangen, dass Sie mit der Entwicklung von Android-Apps mit Android Studio vertraut sind.
Ihre Entwicklungsumgebung und Android-App müssen die folgenden Anforderungen erfüllen:
- Android Studio (neueste Version)
- Ihre App ist auf API‑Level 21 oder höher ausgerichtet.
Web
In diesem Leitfaden wird davon ausgegangen, dass Sie mit der Entwicklung von Web-Apps mit JavaScript vertraut sind. Diese Anleitung ist frameworkunabhängig.
Ihre Entwicklungsumgebung und Web-App müssen die folgenden Anforderungen erfüllen:
- (Optional) Node.js
- Moderner Webbrowser
Dart
In diesem Leitfaden wird davon ausgegangen, dass Sie mit der Entwicklung von Apps mit Flutter vertraut sind.
Ihre Entwicklungsumgebung und Flutter-App müssen die folgenden Anforderungen erfüllen:
- Dart 3.2.0 und höher
Einheit
In dieser Anleitung wird davon ausgegangen, dass Sie mit der Entwicklung von Spielen mit Unity vertraut sind.
Ihre Entwicklungsumgebung und Ihr Unity-Spiel müssen die folgenden Anforderungen erfüllen:
- Unity Editor 2021 LTS oder höher
Hilfreiche Ressourcen ansehen
Swift
Kurzanleitung-App ausprobieren
Mit der Schnellstart-App können Sie das SDK schnell ausprobieren und eine vollständige Implementierung verschiedener Anwendungsfälle sehen. Sie können auch die Quickstart-App verwenden, wenn Sie keine eigene App für Apple-Plattformen haben. Dazu müssen Sie die App mit einem Firebase-Projekt verknüpfen.
Videoanleitung ansehen
In diesem Video wird gezeigt, wie Sie mit Firebase AI Logic beginnen, indem Sie eine KI-basierte App zur Essensplanung erstellen, die Rezepte aus einem Text-Prompt generiert.
Sie können auch die Codebasis für die App im Video herunterladen und erkunden.
Codebasis für die App des Videos ansehen
Kotlin
Kurzanleitung-App ausprobieren
Mit der Schnellstart-App können Sie das SDK schnell ausprobieren und eine vollständige Implementierung verschiedener Anwendungsfälle sehen. Wenn Sie keine eigene Android-App haben, können Sie die Schnellstart-App verwenden. Dazu müssen Sie sie mit einem Firebase-Projekt verknüpfen.
Videoanleitung ansehen
In diesem Video wird gezeigt, wie Sie mit Firebase AI Logic beginnen, indem Sie eine KI-basierte App zur Essensplanung erstellen, die Rezepte aus einem Text-Prompt generiert.
Sie können auch die Codebasis für die App im Video herunterladen und erkunden.
Codebasis für die App des Videos ansehen
Java
Kurzanleitung-App ausprobieren
Mit der Schnellstart-App können Sie das SDK schnell ausprobieren und eine vollständige Implementierung verschiedener Anwendungsfälle sehen. Wenn Sie keine eigene Android-App haben, können Sie die Schnellstart-App verwenden. Dazu müssen Sie sie mit einem Firebase-Projekt verknüpfen.
Videoanleitung ansehen
In diesem Video wird gezeigt, wie Sie mit Firebase AI Logic beginnen können, indem Sie eine KI-basierte App zur Essensplanung entwickeln, die Rezepte aus einem Text-Prompt generiert.*
Sie können auch die Codebasis für die App im Video herunterladen und erkunden.
Codebasis für die App des Videos ansehen
* Dieses Video und die zugehörige App sind in Kotlin, können aber trotzdem Java-Entwicklern helfen, die Grundlagen für den Einstieg in Firebase AI Logic zu verstehen.
Web
Kurzanleitung-App ausprobieren
Mit der Schnellstart-App können Sie das SDK schnell ausprobieren und eine vollständige Implementierung verschiedener Anwendungsfälle sehen. Sie können auch die Schnellstart-App verwenden, wenn Sie keine eigene Web-App haben. Dazu müssen Sie sie mit einem Firebase-Projekt verknüpfen.
Dart
Kurzanleitung-App ausprobieren
Mit der Schnellstart-App können Sie das SDK schnell ausprobieren und eine vollständige Implementierung verschiedener Anwendungsfälle sehen. Wenn Sie keine eigene Flutter-App haben, können Sie die Quickstart-App verwenden. Dazu müssen Sie sie mit einem Firebase-Projekt verknüpfen.
Videoanleitung ansehen
In diesem Video wird gezeigt, wie Sie mit Firebase AI Logic beginnen, indem Sie eine KI-basierte App zur Essensplanung erstellen, die Rezepte aus einem Text-Prompt generiert.
Sie können auch die Codebasis für die App im Video herunterladen und erkunden.
Codebasis für die App des Videos ansehen
Einheit
Kurzanleitung-App ausprobieren
Mit der Schnellstart-App können Sie das SDK schnell ausprobieren und eine vollständige Implementierung verschiedener Anwendungsfälle sehen. Oder verwenden Sie die Schnellstart-App, wenn Sie kein eigenes Unity-Spiel haben. Wenn Sie die Schnellstart-App verwenden möchten, müssen Sie eine Verbindung zu einem Firebase-Projekt herstellen.
Schritt 1: Firebase-Projekt einrichten und APIs aktivieren
Melden Sie sich in der Firebase Console an und wählen Sie Ihr Firebase-Projekt aus.
Rufen Sie in derFirebaseConsole AI Services > AI Logic auf.
Klicken Sie auf Jetzt starten, um einen geführten Workflow zu starten, mit dem Sie die erforderlichen APIs und Ressourcen für Ihr Projekt einrichten können.
Folgen Sie bei Aufforderung der Anleitung auf dem Bildschirm, um Ihre App zu registrieren und die Firebase-Konfiguration hinzuzufügen.
Wenn Sie aufgefordert werden, einen „Gemini API-Anbieter“ auszuwählen, empfehlen wir Ihnen, die Gemini Developer API auszuwählen, mit der Sie schnell und kostenlos loslegen können.
Sie können die Vertex AI Gemini API (und die damit verbundenen Abrechnungsanforderungen) jederzeit später einrichten.
Fahren Sie mit dem Workflow fort, um die erforderlichen APIs und zugehörigen Dienste für Firebase AI Logic einzurichten.
Ab Anfang Juli 2026 wird in dieser Phase des Workflows automatisch Firebase App Check für AI Logic erzwungen. AI Logic ist ein wichtiger Dienst, der dazu beiträgt, die Gemini API zu schützen, wenn direkt über Ihre App darauf zugegriffen wird. Im Rahmen der ersten Schritte (siehe Anleitung weiter unten) müssen Sie den App Check-Debug-Anbieter für die lokale Entwicklung konfigurieren, wenn App Check erzwungen wird.
Fahren Sie mit dem nächsten Schritt in dieser Anleitung fort, um Ihrer App die erforderlichen SDKs hinzuzufügen.
Schritt 2: Erforderliche SDKs hinzufügen
Nachdem Sie Ihr Firebase-Projekt eingerichtet und die erforderlichen APIs aktiviert haben (siehe vorheriger Schritt), können Sie Ihrer App die erforderlichen SDKs hinzufügen.
Swift
Verwenden Sie Swift Package Manager, um Firebase-Abhängigkeiten zu installieren und zu verwalten. Weitere Installationsoptionen
Die Bibliothek Firebase AI Logic bietet Zugriff auf die APIs für die Interaktion mit Gemini-Modellen. Die Bibliothek ist Teil des Firebase SDK für Apple-Plattformen (firebase-ios-sdk).
Wenn Sie Firebase bereits verwenden, muss Ihr Firebase-Paket Version 12.5.0 oder höher haben.
Öffnen Sie Ihr App-Projekt und gehen Sie in Xcode zu File > Add Package Dependencies (Datei > Paketabhängigkeiten hinzufügen).
Fügen Sie bei entsprechender Aufforderung das Firebase Apple Platforms SDK-Repository hinzu:
https://github.com/firebase/firebase-ios-sdkWählen Sie die neueste SDK-Version aus.
Wählen Sie die Bibliothek
FirebaseAILogicund die BibliothekFirebaseAppCheckaus.
Wenn Sie fertig sind, beginnt Xcode automatisch, Ihre Abhängigkeiten im Hintergrund aufzulösen und herunterzuladen.
Kotlin
Das Firebase AI Logic SDK für Android (firebase-ai) bietet Zugriff auf die APIs für die Interaktion mit Gemini-Modellen.
Fügen Sie in der Gradle-Datei Ihres Moduls (auf App-Ebene) (z. B. <project>/<app-module>/build.gradle.kts) die Abhängigkeit für die Firebase AI Logic-Bibliothek für Android hinzu.
Wir empfehlen, die Firebase Android BoM zu verwenden, um die Versionsverwaltung der Bibliothek zu steuern.
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") }
Mit der Firebase Android BoM haben Sie immer eine kompatible Version der Firebase Android-Bibliotheken in Ihrer App.
Java
Das Firebase AI Logic SDK für Android (firebase-ai) bietet Zugriff auf die APIs für die Interaktion mit Gemini-Modellen.
Fügen Sie in der Gradle-Datei Ihres Moduls (auf App-Ebene) (z. B. <project>/<app-module>/build.gradle.kts) die Abhängigkeit für die Firebase AI Logic-Bibliothek für Android hinzu.
Wir empfehlen, die Firebase Android BoM zu verwenden, um die Versionsverwaltung der Bibliothek zu steuern.
Für Java müssen Sie zwei zusätzliche Bibliotheken hinzufügen.
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") }
Mit der Firebase Android BoM haben Sie immer eine kompatible Version der Firebase Android-Bibliotheken in Ihrer App.
Web
Die Bibliothek Firebase AI Logic bietet Zugriff auf die APIs für die Interaktion mit Gemini-Modellen. Die Bibliothek ist im Firebase JavaScript SDK for Web enthalten.
Installieren Sie das Firebase JS SDK für Web mit npm:
npm install firebaseFirebase in Ihrer App initialisieren:
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
Das Firebase AI Logic-Plug-in für Flutter (firebase_ai) bietet Zugriff auf die APIs für die Interaktion mit Gemini-Modellen.
Führen Sie im Verzeichnis Ihres Flutter-Projekts den folgenden Befehl aus, um das Core-Plug-in und das Firebase AI Logic-Plug-in zu installieren:
flutter pub add firebase_ai firebase_app_checkImportieren Sie in der Datei
lib/main.dartdie Plug-ins Firebase AI Logic und App Check: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';Achten Sie auch in Ihrer
lib/main.dart-Datei darauf, dass Sie Firebase mit demDefaultFirebaseOptions-Objekt initialisiert haben, das von der Konfigurationsdatei exportiert wird:await Firebase.initializeApp( options: DefaultFirebaseOptions.currentPlatform, );Erstellen Sie Ihre Flutter-Anwendung neu:
flutter run
Einheit
Laden Sie das Firebase Unity SDK herunter und entpacken Sie es an einem geeigneten Ort.
Das Firebase Unity SDK ist nicht plattformspezifisch.
Rufen Sie in Ihrem geöffneten Unity-Projekt Assets > Import Package > Custom Package auf.
Wählen Sie im extrahierten SDK das Paket
FirebaseAIund das PaketFirebaseAppCheckaus.Klicken Sie im Fenster Import Unity Package (Unity-Paket importieren) auf Import (Importieren).
Schritt 3: App Check-Debug-Anbieter für die lokale Entwicklung konfigurieren
Ab Anfang Juli 2026 wird im Rahmen des geführten Einrichtungsvorgangs für AI Logic in der Console automatisch Firebase App Check erzwungen, um die Gemini API zu schützen. Für die lokale Entwicklung müssen Sie den App Check-Debug-Anbieter konfigurieren, um die Attestierung zu umgehen und gleichzeitig die Durchsetzung von App Check beizubehalten.
Swift
So verwenden Sie den Debugging-Anbieter, während Sie Ihre App interaktiv in einem Simulator ausführen (z. B. während der lokalen Entwicklung):
Importieren Sie in Ihrem Xcode-Projekt
FirebaseAppCheckund initialisieren Sie App Check mit der Debug-Anbieter-Factory, bevor SieFirebasekonfigurieren.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() } } } }Debug-Token abrufen:
Starten Sie die App im Simulator oder auf Ihrem Testgerät.
Öffnen Sie die Xcode-Konsole und suchen Sie nach dem App Check-Debug-Token. Beispiel:
<Warning> [AppCheckCore][I-GAC004001] App Check debug token: '123a4567-b89c-12d3-e456-789012345678'.Kopieren Sie das Token (z. B.
123a4567-b89c-12d3-e456-789012345678).
Registrieren Sie Ihr Debug-Token bei App Check:
Rufen Sie in der Firebase-Konsole den Tab Apps unter Sicherheit > App Check auf.
Suchen Sie Ihre App, klicken Sie auf das Dreipunkt-Menü () und wählen Sie dann Debug-Tokens verwalten aus.
Folgen Sie der Anleitung auf dem Bildschirm, um Ihr Debug-Token zu registrieren.
Weitere Informationen zum Debugging-Anbieter (einschließlich der Vorgehensweise zum Abrufen eines neuen Debugging-Tokens) finden Sie in der offiziellen App Check-Dokumentation.
Kotlin
So verwenden Sie den Debugging-Anbieter, während Sie Ihre App interaktiv in einem Emulator ausführen (z. B. während der lokalen Entwicklung):
Konfigurieren Sie in Ihrem Debug-Build App Check so, dass die Debug-Provider-Factory verwendet wird:
Firebase.initialize(context = this) Firebase.appCheck.installAppCheckProviderFactory( DebugAppCheckProviderFactory.getInstance(), )
Debug-Token abrufen:
Führen Sie Ihre App im Emulator oder auf Ihrem Testgerät aus.
Suchen Sie in Ihren Logs nach dem App Check-Debug-Token. Beispiel:
D DebugAppCheckProvider: Enter this debug secret into the allow list in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678Kopieren Sie das Token (z. B.
123a4567-b89c-12d3-e456-789012345678).
Registrieren Sie Ihr Debug-Token bei App Check:
Rufen Sie in der Firebase-Konsole den Tab Apps unter Sicherheit > App Check auf.
Suchen Sie Ihre App, klicken Sie auf das Dreipunkt-Menü () und wählen Sie dann Debug-Tokens verwalten aus.
Folgen Sie der Anleitung auf dem Bildschirm, um Ihr Debug-Token zu registrieren.
Weitere Informationen zum Debugging-Anbieter (einschließlich der Vorgehensweise zum Abrufen eines neuen Debugging-Tokens) finden Sie in der offiziellen App Check-Dokumentation.
Java
So verwenden Sie den Debugging-Anbieter, während Sie Ihre App interaktiv in einem Emulator ausführen (z. B. während der lokalen Entwicklung):
Konfigurieren Sie in Ihrem Debug-Build App Check so, dass die Debug-Provider-Factory verwendet wird:
FirebaseApp.initializeApp(/*context=*/ this); FirebaseAppCheck firebaseAppCheck = FirebaseAppCheck.getInstance(); firebaseAppCheck.installAppCheckProviderFactory( DebugAppCheckProviderFactory.getInstance());
Debug-Token abrufen:
Führen Sie Ihre App im Emulator oder auf Ihrem Testgerät aus.
Suchen Sie in Ihren Logs nach dem App Check-Debug-Token. Beispiel:
D DebugAppCheckProvider: Enter this debug secret into the allow list in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678Kopieren Sie das Token (z. B.
123a4567-b89c-12d3-e456-789012345678).
Registrieren Sie Ihr Debug-Token bei App Check:
Rufen Sie in der Firebase-Konsole den Tab Apps unter Sicherheit > App Check auf.
Suchen Sie Ihre App, klicken Sie auf das Dreipunkt-Menü () und wählen Sie dann Debug-Tokens verwalten aus.
Folgen Sie der Anleitung auf dem Bildschirm, um Ihr Debug-Token zu registrieren.
Weitere Informationen zum Debugging-Anbieter (einschließlich der Vorgehensweise zum Abrufen eines neuen Debugging-Tokens) finden Sie in der offiziellen App Check-Dokumentation.
Web
So verwenden Sie den Debug-Anbieter, während Sie Ihre App interaktiv über localhost ausführen (z. B. bei der lokalen Entwicklung):
Aktivieren Sie in Ihrem Debug-Build den Fehlerbehebungsmodus, indem Sie
self.FIREBASE_APPCHECK_DEBUG_TOKENauftruesetzen, bevor Sie App Check initialisieren. Beispiel:self.FIREBASE_APPCHECK_DEBUG_TOKEN = true; initializeAppCheck(app, { /* App Check options */ });Rufen Sie Ihre Web-App lokal auf und öffnen Sie die Entwicklertools des Browsers. In der Debug-Konsole wird ein Debug-Token angezeigt:
AppCheck debug token: "123a4567-b89c-12d3-e456-789012345678". You will need to safelist it in the Firebase console for it to work.Registrieren Sie Ihr Debug-Token bei App Check:
Rufen Sie in der Firebase-Konsole den Tab Apps unter Sicherheit > App Check auf.
Suchen Sie Ihre App, klicken Sie auf das Dreipunkt-Menü () und wählen Sie dann Debug-Tokens verwalten aus.
Folgen Sie der Anleitung auf dem Bildschirm, um Ihr Debug-Token zu registrieren.
Weitere Informationen zum Debugging-Anbieter (einschließlich der Vorgehensweise zum Abrufen eines neuen Debugging-Tokens) finden Sie in der offiziellen App Check-Dokumentation.
Dart
iOS+
So verwenden Sie den Debugging-Anbieter, während Sie Ihre App interaktiv in einem Simulator ausführen (z. B. während der lokalen Entwicklung):
Aktivieren Sie App Check mit dem Debugging-Anbieter direkt nach der Initialisierung Ihrer Firebase-App:
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()); }Debug-Logging in Ihrem Xcode-Projekt aktivieren:
- Öffnen Sie Product > Scheme > Edit scheme (Produkt > Schema > Schema bearbeiten).
- Wählen Sie im Menü auf der linken Seite Ausführen und dann den Tab Argumente aus.
- Fügen Sie im Bereich Beim Start übergebene Argumente
-FIRDebugEnabledhinzu.
Debug-Token abrufen:
Öffnen Sie
ios/Runner.xcworkspacemit Xcode und führen Sie Ihre App im Simulator oder auf Ihrem Testgerät aus.Öffnen Sie die Xcode-Konsole und suchen Sie nach dem App Check-Debug-Token. Beispiel:
<Warning> [AppCheckCore][I-GAC004001] App Check debug token: '123a4567-b89c-12d3-e456-789012345678'.Kopieren Sie das Token (z. B.
123a4567-b89c-12d3-e456-789012345678).
Registrieren Sie Ihr Debug-Token bei App Check:
Rufen Sie in der Firebase-Konsole den Tab Apps unter Sicherheit > App Check auf.
Suchen Sie Ihre App, klicken Sie auf das Dreipunkt-Menü () und wählen Sie dann Debug-Tokens verwalten aus.
Folgen Sie der Anleitung auf dem Bildschirm, um Ihr Debug-Token zu registrieren.
Android
So verwenden Sie den Debugging-Anbieter, während Sie Ihre App interaktiv in einem Emulator ausführen (z. B. während der lokalen Entwicklung):
Aktivieren Sie App Check mit dem Debugging-Anbieter direkt nach der Initialisierung Ihrer Firebase-App:
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()); }Debug-Token abrufen:
Führen Sie Ihre App im Emulator oder auf Ihrem Testgerät aus.
Suchen Sie in Ihren Logs nach dem App Check-Debug-Token. Beispiel:
D DebugAppCheckProvider: Enter this debug secret into the allow list in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678Kopieren Sie das Token (z. B.
123a4567-b89c-12d3-e456-789012345678).
Registrieren Sie Ihr Debug-Token bei App Check:
Rufen Sie in der Firebase-Konsole den Tab Apps unter Sicherheit > App Check auf.
Suchen Sie Ihre App, klicken Sie auf das Dreipunkt-Menü () und wählen Sie dann Debug-Tokens verwalten aus.
Folgen Sie der Anleitung auf dem Bildschirm, um Ihr Debug-Token zu registrieren.
Web
So verwenden Sie den Debugging-Anbieter, während Sie Ihre App interaktiv über localhost ausführen (z. B. während der lokalen Entwicklung):
Aktivieren Sie in der Datei
web/index.htmlden Debug-Modus, indem Sieself.FIREBASE_APPCHECK_DEBUG_TOKENauftruefestlegen:<body> <script> self.FIREBASE_APPCHECK_DEBUG_TOKEN = true; </script> ... </body>Führen Sie Ihre Web-App lokal aus und öffnen Sie die Entwicklertools des Browsers. In der Debug-Konsole wird ein Debug-Token angezeigt:
AppCheck debug token: "123a4567-b89c-12d3-e456-789012345678". You will need to safelist it in the Firebase console for it to work.Dieses Token wird lokal in Ihrem Browser gespeichert und immer verwendet, wenn Sie Ihre App im selben Browser auf demselben Computer verwenden. Wenn Sie das Token in einem anderen Browser oder auf einem anderen Computer verwenden möchten, legen Sie
self.FIREBASE_APPCHECK_DEBUG_TOKENauf den Tokenstring anstelle vontruefest.Registrieren Sie Ihr Debug-Token bei App Check:
Rufen Sie in der Firebase-Konsole den Tab Apps unter Sicherheit > App Check auf.
Suchen Sie Ihre App, klicken Sie auf das Dreipunkt-Menü () und wählen Sie dann Debug-Tokens verwalten aus.
Folgen Sie der Anleitung auf dem Bildschirm, um Ihr Debug-Token zu registrieren.
Weitere Informationen zum Debugging-Anbieter (einschließlich der Vorgehensweise zum Abrufen eines neuen Debugging-Tokens) finden Sie in der offiziellen App Check-Dokumentation.
Einheit
So verwenden Sie den Debugging-Anbieter, während Sie Ihre App interaktiv in einem Emulator ausführen (z. B. während der lokalen Entwicklung):
Erstellen Sie in der Firebase-Konsole ein Debug-Token:
Rufen Sie in der Firebase-Konsole den Tab Apps unter Sicherheit > App Check auf.
Suchen Sie Ihre App, klicken Sie auf das Dreipunkt-Menü () und wählen Sie dann Debug-Tokens verwalten aus.
Folgen Sie der Anleitung auf dem Bildschirm, um ein neues Debug-Token zu erstellen.
Fügen Sie dem Initialisierungscode Ihrer App Folgendes hinzu:
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 }
Weitere Informationen zum Debugging-Anbieter (einschließlich der Vorgehensweise zum Abrufen eines neuen Debugging-Tokens) finden Sie in der offiziellen App Check-Dokumentation.
Schritt 4: Dienst initialisieren und Modellinstanz erstellen
|
Klicken Sie auf Ihren Gemini API-Anbieter, um anbieterspezifische Inhalte und Code auf dieser Seite aufzurufen. |
Bevor Sie einen Prompt an ein Gemini-Modell senden, initialisieren Sie den Dienst für den von Ihnen ausgewählten API-Anbieter und erstellen Sie eine GenerativeModel-Instanz.
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');
Einheit
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");
Je nach verwendeter Funktion wird möglicherweise nicht immer eine GenerativeModel-Instanz erstellt. Wenn Sie Ein- und Ausgabe mit Gemini Live API streamen möchten, erstellen Sie eine LiveModel-Instanz.
Nachdem Sie diese Kurzanleitung durchgearbeitet haben, können Sie sich auch ansehen, wie Sie ein Modell für Ihren Anwendungsfall und Ihre App auswählen.
Schritt 5: Anfrage an ein Modell senden
Sie können jetzt eine Anfrage an ein Gemini-Modell senden.
Mit generateContent() können Sie Text aus einem Prompt generieren, der Text enthält:
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
In Kotlin sind die Methoden in diesem SDK suspend-Funktionen und müssen aus einem Coroutine-Bereich aufgerufen werden.
// 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
Bei Java geben die Methoden in diesem SDK eineListenableFuture zurück.
// 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);
Einheit
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.");
Was kannst du sonst noch tun?
Weitere Informationen zu den unterstützten Modellen
Verfügbare Modelle für verschiedene Anwendungsfälle sowie ihre Kontingente und Preise
Andere Funktionen ausprobieren
- Weitere Informationen zum Generieren von Text aus reinen Text-Prompts, einschließlich des Streamings der Antwort.
- Sie können Text generieren, indem Sie Prompts mit verschiedenen Dateitypen wie Bildern, PDFs, Videos und Audiodateien verwenden.
- Wechselseitige Unterhaltungen (Chat) erstellen
- Strukturierte Ausgaben (z. B. JSON) generieren – sowohl aus Text- als auch aus multimodalen Prompts.
- Bilder aus Text- und multimodalen Prompts generieren und bearbeiten
- Stream-Ein- und -Ausgabe (einschließlich Audio) mit Gemini Live API.
- Verwenden Sie Tools wie Funktionsaufrufe und Fundierung mit der Google Suche, um ein Gemini-Modell mit anderen Teilen Ihrer App sowie mit externen Systemen und Informationen zu verbinden.
Informationen zum Steuern der Inhaltserstellung
- Prompt-Design – Best Practices, Strategien und Beispiel-Prompts
- Modellparameter konfigurieren, z. B. maximale Anzahl von Ausgabetokens, Wahrscheinlichkeit wiederholter Ausgabetokens usw.
- Mit den Sicherheitseinstellungen können Sie die Wahrscheinlichkeit anpassen, Antworten zu erhalten, die als schädlich eingestuft werden könnten.
Feedback zu Firebase AI Logic geben