Pierwsze kroki z interfejsem Gemini API przy użyciu pakietów SDK Firebase AI Logic

Z tego przewodnika dowiesz się, jak zacząć wykonywać wywołania do Gemini API bezpośrednio z aplikacji za pomocą pakietów SDK klienta Firebase AI Logic na wybraną platformę.

Wymagania wstępne

Swift

W tym przewodniku założyliśmy, że wiesz już, jak używać Xcode do tworzenia aplikacji na platformy Apple (np. iOS).

Upewnij się, że środowisko programistyczne i aplikacja na platformy Apple spełniają te wymagania:

  • Xcode 26.2 lub nowszy,
  • Twoja aplikacja jest kierowana na system iOS 15 lub nowszy albo macOS 12 lub nowszy.

Kotlin

W tym przewodniku założyliśmy, że wiesz już, jak używać Androida Studio do tworzenia aplikacji na Androida.

Upewnij się, że środowisko programistyczne i aplikacja na Androida spełniają te wymagania:

  • Android Studio (najnowsza wersja)
  • Aplikacja jest kierowana na interfejs API na poziomie 24 (Nougat) lub wyższym.

Java

W tym przewodniku zakładamy, że wiesz, jak używać Android Studio do tworzenia aplikacji na Androida.

Upewnij się, że środowisko programistyczne i aplikacja na Androida spełniają te wymagania:

  • Android Studio (najnowsza wersja)
  • Aplikacja jest kierowana na interfejs API na poziomie 24 (Nougat) lub wyższym.

Web

W tym przewodniku zakładamy, że znasz język JavaScript i umiesz tworzyć aplikacje internetowe. Ten przewodnik jest niezależny od platformy.

Upewnij się, że środowisko programistyczne i aplikacja internetowa spełniają te wymagania:

  • (Opcjonalnie) Node.js
  • nowoczesna przeglądarka internetowa,

Dart

W tym przewodniku zakładamy, że masz już doświadczenie w tworzeniu aplikacji we Flutterze.

Upewnij się, że środowisko programistyczne i aplikacja Flutter spełniają te wymagania:

  • Dart 3.2.0 lub nowszy

Unity

W tym przewodniku zakładamy, że masz już doświadczenie w tworzeniu gier w Unity.

Upewnij się, że środowisko programistyczne i gra Unity spełniają te wymagania:

  • Unity Editor 2021 LTS lub nowszy

Przydatne materiały

Swift

Wypróbuj aplikację z krótkiego wprowadzenia

Użyj aplikacji z krótkiego wprowadzenia, aby szybko wypróbować pakiet SDK i zobaczyć pełną implementację różnych przypadków użycia. Jeśli nie masz własnej aplikacji na platformy Apple, możesz użyć aplikacji z przewodnika Szybki start. Aby użyć aplikacji z przewodnika Szybki start, musisz połączyć ją z projektem w Firebase.

Otwórz aplikację do szybkiego startu

Obejrzyj film instruktażowy

Ten film pokazuje, jak zacząć korzystać z Firebase AI Logic, tworząc rzeczywistą aplikację do planowania posiłków opartą na AI, która generuje przepisy na podstawie prompta tekstowego.

Możesz też pobrać i przejrzeć bazę kodu aplikacji przedstawionej w filmie.

Wyświetlanie bazy kodu aplikacji, w której znajduje się film



Kotlin

Wypróbuj aplikację z krótkiego wprowadzenia

Użyj aplikacji z krótkiego wprowadzenia, aby szybko wypróbować pakiet SDK i zobaczyć pełną implementację różnych przypadków użycia. Jeśli nie masz własnej aplikacji na Androida, możesz użyć aplikacji z przewodnika Szybki start. Aby z niej skorzystać, musisz połączyć ją z projektem w Firebase.

Otwórz aplikację do szybkiego startu

Obejrzyj samouczek wideo

Ten film pokazuje, jak zacząć korzystać z Firebase AI Logic, tworząc rzeczywistą aplikację do planowania posiłków opartą na AI, która generuje przepisy na podstawie prompta tekstowego.

Możesz też pobrać i przeanalizować bazę kodu aplikacji z filmu.

Wyświetlanie bazy kodu aplikacji z filmu



Java

Wypróbuj aplikację z krótkiego wprowadzenia

Użyj aplikacji z krótkiego wprowadzenia, aby szybko wypróbować pakiet SDK i zobaczyć pełną implementację różnych przypadków użycia. Jeśli nie masz własnej aplikacji na Androida, możesz użyć aplikacji szybkiego startu. Aby to zrobić, musisz połączyć ją z projektem w Firebase.

Otwórz aplikację do szybkiego startu

Obejrzyj samouczek wideo

W tym filmie pokazujemy, jak zacząć korzystać z Firebase AI Logic, tworząc praktyczną aplikację do planowania posiłków opartą na AI, która generuje przepisy na podstawie prompta tekstowego*.

Możesz też pobrać i przeanalizować bazę kodu aplikacji z filmu.

Wyświetlanie bazy kodu aplikacji z filmu

* Ten film i aplikacja są w języku Kotlin, ale mogą pomóc programistom Javy zrozumieć podstawy korzystania z Firebase AI Logic.

Web

Wypróbuj aplikację z krótkiego wprowadzenia

Użyj aplikacji z krótkiego wprowadzenia, aby szybko wypróbować pakiet SDK i zobaczyć pełną implementację różnych przypadków użycia. Jeśli nie masz własnej aplikacji internetowej, możesz użyć aplikacji z przewodnika Szybki start. Aby z niej korzystać, musisz połączyć ją z projektem w Firebase.

Otwórz aplikację z szybkim startem

Dart

Wypróbuj aplikację z krótkiego wprowadzenia

Użyj aplikacji z krótkiego wprowadzenia, aby szybko wypróbować pakiet SDK i zobaczyć pełną implementację różnych przypadków użycia. Jeśli nie masz własnej aplikacji Flutter, możesz użyć aplikacji z krótkiego wprowadzenia. Aby z niej korzystać, musisz połączyć ją z projektem w Firebase.

Otwórz aplikację do szybkiego startu

Obejrzyj samouczek wideo

Ten film pokazuje, jak zacząć korzystać z Firebase AI Logic, tworząc rzeczywistą aplikację do planowania posiłków opartą na AI, która generuje przepisy na podstawie prompta tekstowego.

Możesz też pobrać i przejrzeć bazę kodu aplikacji przedstawionej w filmie.

Wyświetlanie bazy kodu aplikacji z filmu



Unity

Wypróbuj aplikację z krótkiego wprowadzenia

Skorzystaj z aplikacji do szybkiego rozpoczęcia, aby szybko wypróbować pakiet SDK i zobaczyć pełną implementację różnych przypadków użycia. Jeśli nie masz własnej gry Unity, możesz użyć aplikacji z krótkiego wprowadzenia. Aby używać aplikacji z przewodnika Szybki start, musisz połączyć ją z projektem w Firebase.

Otwórz aplikację do szybkiego startu

Krok 1. Skonfiguruj projekt w Firebase i włącz interfejsy API

  1. Zaloguj się w konsoli Firebase i wybierz projekt w Firebase.

  2. W konsoli Firebase otwórz Usługi AI > Logika AI.

  3. Kliknij Rozpocznij, aby uruchomić proces, który pomoże Ci skonfigurować wymagane interfejsy API i zasoby w projekcie.

  4. Jeśli pojawi się monit, postępuj zgodnie z instrukcjami wyświetlanymi na ekranie, aby zarejestrować aplikację i dodać do niej konfigurację Firebase.

  5. Gdy pojawi się prośba o wybranie „dostawcy interfejsu Gemini API”, zalecamy wybranie Gemini Developer API, który umożliwia szybkie rozpoczęcie korzystania bezpłatnie.

    W każdej chwili możesz skonfigurować Agent Platform Gemini API (formerly Vertex AI) (i wymagane płatności).

  6. Kontynuuj proces, aby skonfigurować wymagane interfejsy API i powiązane usługi dla Firebase AI Logic.

    Od początku lipca 2026 r. ten etap przepływu pracy będzie automatycznie egzekwować Firebase App Check w przypadku AI Logic, czyli krytycznej usługi, która pomaga chronić Gemini API, gdy jest on bezpośrednio dostępny z Twojej aplikacji. Na początku (patrz kroki opisane w dalszej części tego przewodnika) musisz skonfigurować dostawcę debugowania App Check na potrzeby lokalnego programowania, gdy App Check jest egzekwowany.

  7. Przejdź do kolejnego kroku tego przewodnika, aby dodać do aplikacji wymagane pakiety SDK.

Krok 2. Dodaj wymagane pakiety SDK.

Po skonfigurowaniu projektu w Firebase i włączeniu wymaganych interfejsów API (patrz poprzedni krok) możesz teraz dodać do aplikacji wymagane pakiety SDK.

Swift

Do instalowania zależności Firebase i zarządzania nimi używaj Swift Package Manager. W razie potrzeby dowiedz się więcej o innych opcjach instalacji.

Biblioteka Firebase AI Logic zapewnia dostęp do interfejsów API umożliwiających interakcję z modelami Gemini. Biblioteka jest częścią pakietu SDK Firebase na platformy Apple (firebase-ios-sdk).

Jeśli korzystasz już z Firebase, upewnij się, że masz pakiet Firebase w wersji 12.5.0 lub nowszej.

  1. W Xcode, po otwarciu projektu aplikacji, kliknij File > Add Package Dependencies (Plik > Dodaj zależności pakietu).

  2. Gdy pojawi się prośba, dodaj repozytorium pakietu SDK Firebase na platformy Apple:

    https://github.com/firebase/firebase-ios-sdk
    
  3. Wybierz najnowszą wersję pakietu SDK.

  4. Wybierz bibliotekę FirebaseAILogic i bibliotekę FirebaseAppCheck.

Po zakończeniu Xcode automatycznie zacznie przetwarzać i pobierać zależności w tle.

Kotlin

Pakiet Firebase AI Logic SDK na Androida (firebase-ai) zapewnia dostęp do interfejsów API umożliwiających interakcję z modelami Gemini.

W pliku Gradle na poziomie modułu (aplikacji) (np. <project>/<app-module>/build.gradle.kts) dodaj zależności dla bibliotek Firebase AI Logic i App Check na Androida. Zalecamy używanie Firebase Android BoM do kontrolowania obsługi wersji biblioteki.

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")
}

Gdy korzystamy z Firebase Android BoM, aplikacja zawsze używa zgodnych wersji bibliotek Firebase na Androida.

Java

Pakiet Firebase AI Logic SDK na Androida (firebase-ai) zapewnia dostęp do interfejsów API do interakcji z modelami Gemini.

W pliku Gradle na poziomie modułu (aplikacji) (np. <project>/<app-module>/build.gradle.kts) dodaj zależności bibliotek Firebase AI Logic i App Check na Androida. Zalecamy używanie Firebase Android BoM do kontrolowania obsługi wersji biblioteki.

W przypadku Javy musisz dodać 2 dodatkowe biblioteki.

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")
}

Gdy korzystasz z Firebase Android BoM, aplikacja zawsze używa zgodnych wersji bibliotek Firebase na Androida.

Web

Biblioteka Firebase AI Logic zapewnia dostęp do interfejsów API umożliwiających interakcję z modelami Gemini. Biblioteka jest częścią pakietu Firebase JavaScript SDK dla aplikacji internetowych.

  1. Zainstaluj pakiet Firebase JS SDK dla aplikacji internetowych za pomocą npm:

    npm install firebase
    
  2. Zainicjuj Firebase w aplikacji:

    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

Wtyczka Firebase AI Logic do Fluttera (firebase_ai) zapewnia dostęp do interfejsów API do interakcji z modelami Gemini.

  1. Aby zainstalować wtyczki Firebase AI Logic i App Check, uruchom w katalogu projektu Flutter to polecenie:

    flutter pub add firebase_ai firebase_app_check
    
  2. W pliku lib/main.dart zaimportuj wtyczki Firebase AI Logic i 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';
    
  3. W pliku lib/main.dart upewnij się też, że Firebase został zainicjowany za pomocą obiektu DefaultFirebaseOptions wyeksportowanego przez plik konfiguracji:

    await Firebase.initializeApp(
      options: DefaultFirebaseOptions.currentPlatform,
    );
    
  4. Przebuduj aplikację Flutter:

    flutter run
    

Unity

  1. Pobierz pakiet SDK Firebase Unity, a następnie rozpakuj go w dogodnym miejscu.

    Pakiet SDK Firebase Unity nie jest przeznaczony na konkretną platformę.

  2. W otwartym projekcie Unity kliknij Assets (Zasoby) > Import Package (Importuj pakiet) > Custom Package (Pakiet niestandardowy).

  3. Z wyodrębnionego pakietu SDK wybierz pakiety FirebaseAI i FirebaseAppCheck.

  4. W oknie Import Unity Package (Importowanie pakietu dla Unity) kliknij Import (Importuj).

Krok 3. Skonfiguruj dostawcę debugowania App Check na potrzeby programowania lokalnego

Na początku lipca 2026 r. w ramach procesu konfiguracji z przewodnikiem w Firebasekonsoli Firebase automatycznie wymusi Firebase App CheckFirebase AI Logic, aby chronić Gemini API.

W przypadku lokalnego środowiska programistycznego możesz skonfigurować App Check dostawcę debugowania i nadal wymuszać App Check w przypadku Firebase AI Logic.

Swift

Aby używać dostawcy debugowania podczas interaktywnego uruchamiania aplikacji w symulatorze (np. podczas lokalnego programowania):

  1. W projekcie Xcode zaimportuj FirebaseAppCheck i zainicjuj App Check za pomocą fabryki dostawcy debugowania przed skonfigurowaniem Firebase.

    import SwiftUI
    import FirebaseCore
    import FirebaseAppCheck
    
    @main
    struct YourApp: App {
      init() {
        let providerFactory = AppCheckDebugProviderFactory()
        AppCheck.setAppCheckProviderFactory(providerFactory)
        FirebaseApp.configure()
      }
    
      var body: some Scene {
        WindowGroup {
          NavigationView {
            ContentView()
          }
        }
      }
    }
    
  2. Uzyskaj token debugowania:

    1. Uruchom aplikację w symulatorze lub na urządzeniu testowym.

    2. Otwórz konsolę Xcode i poszukaj tokena debugowania App Check. Przykład:

      <Warning> [AppCheckCore][I-GAC004001] App Check debug token: '123a4567-b89c-12d3-e456-789012345678'.
      
    3. Skopiuj token (na przykład 123a4567-b89c-12d3-e456-789012345678).

  3. Zarejestruj token debugowania w App Check:

    1. W konsoli Firebase otwórz kartę Zabezpieczenia > Sprawdzanie aplikacji > Aplikacje.

    2. Znajdź aplikację, kliknij rozszerzone menu (), a następnie wybierz Zarządzaj tokenami debugowania.

    3. Aby zarejestrować token debugowania, postępuj zgodnie z instrukcjami wyświetlanymi na ekranie.

Szczegółowe informacje o dostawcy debugowania (w tym o tym, jak uzyskać nowy token debugowania) znajdziesz w oficjalnej dokumentacji App Check.

Kotlin

Aby używać dostawcy debugowania podczas interaktywnego uruchamiania aplikacji w emulatorze (np. podczas lokalnego programowania):

  1. W kompilacji do debugowania skonfiguruj App Check tak, aby używała fabryki dostawcy debugowania:

    Firebase.initialize(context = this)
    Firebase.appCheck.installAppCheckProviderFactory(
        DebugAppCheckProviderFactory.getInstance(),
    )
  2. Uzyskaj token debugowania:

    1. Uruchom aplikację w emulatorze lub na urządzeniu testowym.

    2. W logach poszukaj App Check tokena debugowania. Przykład:

      D DebugAppCheckProvider: Enter this debug secret into the allow list
      in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678
      
    3. Skopiuj token (na przykład 123a4567-b89c-12d3-e456-789012345678).

  3. Zarejestruj token debugowania w App Check:

    1. W konsoli Firebase otwórz kartę Zabezpieczenia > Sprawdzanie aplikacji > Aplikacje.

    2. Znajdź aplikację, kliknij rozszerzone menu (), a następnie wybierz Zarządzaj tokenami debugowania.

    3. Aby zarejestrować token debugowania, postępuj zgodnie z instrukcjami wyświetlanymi na ekranie.

Szczegółowe informacje o dostawcy debugowania (w tym o tym, jak uzyskać nowy token debugowania) znajdziesz w oficjalnej dokumentacji App Check.

Java

Aby użyć dostawcy debugowania podczas interaktywnego uruchamiania aplikacji w emulatorze (np. podczas lokalnego programowania):

  1. W kompilacji do debugowania skonfiguruj App Check tak, aby używała fabryki dostawcy debugowania:

    FirebaseApp.initializeApp(/*context=*/ this);
    FirebaseAppCheck firebaseAppCheck = FirebaseAppCheck.getInstance();
    firebaseAppCheck.installAppCheckProviderFactory(
            DebugAppCheckProviderFactory.getInstance());
  2. Uzyskaj token debugowania:

    1. Uruchom aplikację w emulatorze lub na urządzeniu testowym.

    2. W logach poszukaj App Check tokena debugowania. Przykład:

      D DebugAppCheckProvider: Enter this debug secret into the allow list
      in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678
      
    3. Skopiuj token (na przykład 123a4567-b89c-12d3-e456-789012345678).

  3. Zarejestruj token debugowania w usłudze App Check:

    1. W konsoli Firebase otwórz kartę Zabezpieczenia > Sprawdzanie aplikacji > Aplikacje.

    2. Znajdź aplikację, kliknij rozszerzone menu (), a następnie wybierz Zarządzaj tokenami debugowania.

    3. Aby zarejestrować token debugowania, postępuj zgodnie z instrukcjami wyświetlanymi na ekranie.

Szczegółowe informacje o dostawcy debugowania (w tym o tym, jak uzyskać nowy token debugowania) znajdziesz w oficjalnej dokumentacji App Check.

Web

Aby użyć dostawcy debugowania podczas interaktywnego uruchamiania aplikacji z localhost (np. podczas lokalnego programowania):

  1. W kompilacji do debugowania włącz tryb debugowania, ustawiając wartość self.FIREBASE_APPCHECK_DEBUG_TOKEN na true przed zainicjowaniem App Check. Przykład:

    self.FIREBASE_APPCHECK_DEBUG_TOKEN = true;
    initializeAppCheck(app, { /* App Check options */ });
    
  2. Otwórz aplikację internetową lokalnie i narzędzia dla programistów w przeglądarce. W konsoli debugowania zobaczysz token debugowania:

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

    1. W konsoli Firebase otwórz kartę Zabezpieczenia > Sprawdzanie aplikacji > Aplikacje.

    2. Znajdź aplikację, kliknij rozszerzone menu (), a potem wybierz Zarządzaj tokenami debugowania.

    3. Aby zarejestrować token debugowania, postępuj zgodnie z instrukcjami wyświetlanymi na ekranie.

Szczegółowe informacje o dostawcy debugowania (w tym o tym, jak uzyskać nowy token debugowania) znajdziesz w oficjalnej dokumentacji App Check.

Dart

iOS+

Aby używać dostawcy debugowania podczas interaktywnego uruchamiania aplikacji w symulatorze (np. podczas lokalnego programowania):

  1. Aktywuj App Check za pomocą dostawcy debugowania zaraz po zainicjowaniu aplikacji w Firebase:

    import 'package:flutter/material.dart';
    import 'package:firebase_core/firebase_core.dart';
    
    // Import the firebase_app_check plugin
    import 'package:firebase_app_check/firebase_app_check.dart';
    
    Future<void> main() async {
      WidgetsFlutterBinding.ensureInitialized();
      await Firebase.initializeApp();
      await FirebaseAppCheck.instance.activate(
        // Set appleProvider to `AppleProvider.debug`
        appleProvider: AppleProvider.debug,
      );
      runApp(App());
    }
    
  2. Włącz dziennik debugowania w projekcie Xcode:

    1. Kliknij Product (Produkt) > Scheme (Schemat) > Edit scheme (Edytuj schemat).
    2. W menu po lewej stronie kliknij Run (Uruchom), a następnie wybierz kartę Arguments (Argumenty).
    3. W sekcji Arguments Passed on Launch (Argumenty przekazywane przy uruchamianiu) dodaj -FIRDebugEnabled.
  3. Uzyskaj token debugowania:

    1. Otwórz ios/Runner.xcworkspace w Xcode i uruchom aplikację w symulatorze lub na urządzeniu testowym.

    2. Otwórz konsolę Xcode i poszukaj tokena debugowania App Check. Przykład:

      <Warning> [AppCheckCore][I-GAC004001] App Check debug token: '123a4567-b89c-12d3-e456-789012345678'.
      
    3. Skopiuj token (na przykład 123a4567-b89c-12d3-e456-789012345678).

  4. Zarejestruj token debugowania w App Check:

    1. W konsoli Firebase otwórz kartę Zabezpieczenia > Sprawdzanie aplikacji > Aplikacje.

    2. Znajdź aplikację, kliknij rozszerzone menu (), a następnie wybierz Zarządzaj tokenami debugowania.

    3. Aby zarejestrować token debugowania, postępuj zgodnie z instrukcjami wyświetlanymi na ekranie.

Android

Aby użyć dostawcy debugowania podczas interaktywnego uruchamiania aplikacji w emulatorze (np. podczas lokalnego programowania):

  1. Aktywuj App Check za pomocą dostawcy debugowania zaraz po zainicjowaniu aplikacji w Firebase:

    import 'package:flutter/material.dart';
    import 'package:firebase_core/firebase_core.dart';
    
    // Import the firebase_app_check plugin
    import 'package:firebase_app_check/firebase_app_check.dart';
    
    Future<void> main() async {
      WidgetsFlutterBinding.ensureInitialized();
      await Firebase.initializeApp();
      await FirebaseAppCheck.instance.activate(
        // Set androidProvider to `AndroidProvider.debug`
        androidProvider: AndroidProvider.debug,
      );
      runApp(App());
    }
    
  2. Uzyskaj token debugowania:

    1. Uruchom aplikację w emulatorze lub na urządzeniu testowym.

    2. Poszukaj w logach tokena debugowania App Check. Przykład:

      D DebugAppCheckProvider: Enter this debug secret into the allow list
      in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678
      
    3. Skopiuj token (na przykład 123a4567-b89c-12d3-e456-789012345678).

  3. Zarejestruj token debugowania w usłudze App Check:

    1. W konsoli Firebase otwórz kartę Zabezpieczenia > Sprawdzanie aplikacji > Aplikacje.

    2. Znajdź aplikację, kliknij rozszerzone menu (), a potem wybierz Zarządzaj tokenami debugowania.

    3. Aby zarejestrować token debugowania, postępuj zgodnie z instrukcjami wyświetlanymi na ekranie.

Sieć

Aby użyć dostawcy debugowania podczas interaktywnego uruchamiania aplikacji z localhost (np. podczas lokalnego programowania):

  1. W pliku web/index.html włącz tryb debugowania, ustawiając self.FIREBASE_APPCHECK_DEBUG_TOKEN na true:

    <body>
      <script>
        self.FIREBASE_APPCHECK_DEBUG_TOKEN = true;
      </script>
    
      ...
    
    </body>
    
  2. Uruchom aplikację internetową lokalnie i otwórz narzędzia dla programistów w przeglądarce. W konsoli debugowania zobaczysz token debugowania:

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

    Token jest przechowywany lokalnie w przeglądarce i będzie używany za każdym razem, gdy będziesz korzystać z aplikacji w tej samej przeglądarce na tym samym komputerze. Jeśli chcesz użyć tokena w innej przeglądarce lub na innym komputerze, ustaw self.FIREBASE_APPCHECK_DEBUG_TOKEN na ciąg tokena zamiast true.

  3. Zarejestruj token debugowania w App Check:

    1. W konsoli Firebase otwórz kartę Zabezpieczenia > Sprawdzanie aplikacji > Aplikacje.

    2. Znajdź aplikację, kliknij rozszerzone menu (), a potem wybierz Zarządzaj tokenami debugowania.

    3. Aby zarejestrować token debugowania, postępuj zgodnie z instrukcjami wyświetlanymi na ekranie.

Szczegółowe informacje o dostawcy debugowania (w tym o tym, jak uzyskać nowy token debugowania) znajdziesz w oficjalnej dokumentacji App Check.

Unity

Aby użyć dostawcy debugowania podczas interaktywnego uruchamiania aplikacji w emulatorze (np. podczas lokalnego programowania):

  1. W konsoli Firebase utwórz token debugowania:

    1. W konsoli Firebase otwórz kartę Zabezpieczenia > Sprawdzanie aplikacji > Aplikacje.

    2. Znajdź aplikację, kliknij rozszerzone menu (), a potem wybierz Zarządzaj tokenami debugowania.

    3. Aby utworzyć nowy token debugowania, postępuj zgodnie z instrukcjami wyświetlanymi na ekranie.

  2. W kodzie inicjowania aplikacji dodaj ten kod:

    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
    }
    

Szczegółowe informacje o dostawcy debugowania (w tym o tym, jak uzyskać nowy token debugowania) znajdziesz w oficjalnej dokumentacji App Check.

Krok 4. Zainicjuj usługę i utwórz instancję modelu

Kliknij Gemini API dostawcę, aby wyświetlić na tej stronie treści i kod dostawcy.

Przed wysłaniem prompta do modelu Gemini zainicjuj usługę dla wybranego dostawcy interfejsu API i utwórz instancję GenerativeModel.

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");

Pamiętaj, że w zależności od używanej funkcji nie zawsze możesz utworzyć instancję GenerativeModel. Aby przesyłać strumieniowo dane wejściowe i wyjściowe za pomocą Gemini Live API, utwórz instancję LiveModel.

Po przeczytaniu tego przewodnika dowiesz się też, jak wybrać model do swojego przypadku użycia i aplikacji.

Krok 5. Wyślij żądanie do modelu

Możesz już wysłać żądanie do modelu Gemini.

Możesz użyć generateContent(), aby wygenerować tekst na podstawie prompta zawierającego tekst:

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

W przypadku języka Kotlin metody w tym pakiecie SDK są funkcjami zawieszania i muszą być wywoływane w zakresie współprogramu.

// 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

W przypadku języka Java metody w tym pakiecie SDK zwracają wartość ListenableFuture.

// 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.");

Co jeszcze możesz zrobić?

Więcej informacji o obsługiwanych modelach

Dowiedz się więcej o modelach dostępnych w różnych przypadkach użycia oraz o ich limitach i cenach.

Wypróbuj inne funkcje

Dowiedz się, jak kontrolować generowanie treści

Możesz też eksperymentować z promptami i konfiguracjami modeli, a nawet uzyskać wygenerowany fragment kodu za pomocą Google AI Studio.


Prześlij opinię o korzystaniu z usługi Firebase AI Logic