Przejście z pakietów SDK klienta Google AI na pakiety SDK Firebase AI Logic

Swift

Do instalacji zależności Firebase i do zarządzania nimi możesz używać menedżera pakietów Swift. W razie potrzeby dowiedz się więcej o innych opcjach instalacji.

Biblioteka Firebase AI Logic zapewnia dostęp do interfejsów API do interakcji 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 pakiet Firebase ma wersję 12.5.0 lub nowszą.

1. Po otwarciu projektu aplikacji wybierz w Xcode opcję 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 wyszukiwać i pobierać zależności w tle.

Kotlin

Firebase AI Logic Pakiet 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 wersji biblioteki.

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

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

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

Java

Firebase AI Logic Pakiet 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 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: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")
}

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

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

Web

Biblioteka Firebase AI Logic zapewnia dostęp do interfejsów API do interakcji z modelami Gemini. Biblioteka jest częścią pakietu Firebase JavaScript SDK na potrzeby internetu.

1. Zainstaluj pakiet Firebase JS SDK na potrzeby internetu 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. W katalogu projektu Flutter uruchom to polecenie, aby zainstalować wtyczki Firebase AI Logic i App Check:

   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 sprawdź też, czy Firebase został zainicjowany za pomocą obiektu DefaultFirebaseOptions wyeksportowanego z pliku konfiguracyjnego:

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

4. Przebuduj aplikację Flutter:

   flutter run
   

Unity

Obsługa Unity nie była dostępna w pakietach SDK klienta Google AI.

Dowiedz się, jak zacząć korzystać z pakietu Firebase AI Logic SDK do Unity.

Swift

Usuń starą bibliotekę:

1. Po otwarciu projektu aplikacji wybierz w Xcode panel Packages Dependencies (Zależności pakietów).

2. Wybierz pakiet generative-ai-swift z listy zależności pakietu.

3. Kliknij przycisk - u dołu listy i kliknij Usuń, aby potwierdzić.

Kotlin

dependencies {
    implementation("com.google.ai.client.generativeai:generativeai:VERSION")
}

Java

dependencies {
    implementation("com.google.ai.client.generativeai:generativeai:VERSION")
}

Web

// BEFORE
import { initializeApp } from "firebase/app";
import { GoogleGenerativeAI } from "@google/generative-ai";

Dart

Usuń stary pakiet:
flutter pub remove google_generative_ai

Unity

Obsługa Unity nie była dostępna w pakietach SDK klienta Google AI.

Dowiedz się, jak zacząć korzystać z pakietu Firebase AI Logic SDK do Unity.

Swift

• Wyliczenia

  • Zastąpiliśmy większość typów enum typami struct ze zmiennymi statycznymi. Ta zmiana zapewnia większą elastyczność w zakresie rozwoju interfejsu API w sposób zachowujący zgodność wsteczną. Podczas korzystania z instrukcji switch musisz teraz uwzględnić klauzulę default:, aby obejmowała nieznane lub nieobsługiwane wartości, w tym nowe wartości, które zostaną dodane do pakietu SDK w przyszłości.

  • Zmieniono nazwę wyliczenia BlockThreshold na HarmBlockThreshold. Ten typ jest teraz struct.

  • Usunięto przypadki unknown i unspecified z tych wyliczeń (obecnie struct): HarmCategory, HarmBlockThreshold, HarmProbability, BlockReason i FinishReason.

  • Zastąpiliśmy wyliczenie ModelContent.Part protokołem o nazwie Part, aby umożliwić dodawanie nowych typów w sposób zapewniający zgodność wsteczną. Ta zmiana jest szczegółowo opisana w sekcji Części treści.

• Elementy treści

  • Usunięto protokół ThrowingPartsRepresentable i uproszczono inicjatory dla ModelContent, aby uniknąć sporadycznych błędów kompilatora. Obrazy, które nie są prawidłowo zakodowane, nadal będą powodować błędy podczas używania w generateContent.

  • Zastąpiliśmy przypadki ModelContent.Part tymi typami struct zgodnymi z protokołem Part:

    • .text do TextPart
    • .data do InlineDataPart
    • .fileData do FileDataPart
    • .functionCall do FunctionCallPart
    • .functionResponse do FunctionResponsePart

• Kategoria szkodliwości

  • Zmieniono element HarmCategory, aby nie był już zagnieżdżony w typie SafetySetting. Jeśli używasz nazwy SafetySetting.HarmCategory, możesz ją zastąpić nazwą HarmCategory.

• Opinie dotyczące bezpieczeństwa

  • Usunęliśmy typ SafetyFeedback, ponieważ nie był używany w żadnej z odpowiedzi.

• Metadane cytowania

  • Zmieniliśmy nazwę właściwości citationSources na citations w usłudze CitationMetadata.

• Łączna liczba znaków podlegających rozliczeniu

  • Zmieniono właściwość totalBillableCharacters w CountTokensResponse na opcjonalną, aby odzwierciedlała sytuacje, w których nie są wysyłane żadne znaki.

• Odpowiedź kandydata

  • Nazwa CandidateResponse została zmieniona na Candidate, aby była zgodna z innymi platformami.

• Konfiguracja generowania

  • Zmieniono właściwości publiczne GenerationConfig na internal. Wszystkie te ustawienia można nadal konfigurować w inicjatorze.

Kotlin

• Wyliczenia

  • Zastąpiono zajęcia enum i sealed zwykłymi zajęciami. Ta zmiana zapewnia większą elastyczność w zakresie rozwoju interfejsu API w sposób zgodny wstecznie.

  • Zmieniono nazwę wyliczenia BlockThreshold na HarmBlockThreshold.

  • Usunięto wartości z tych wyliczeń: HarmBlockThreshold, HarmProbability, HarmSeverity, BlockReason i FinishReason.

• Metody obiektu blob

  • W nazwach wszystkich metod, które zawierały Blob, zamieniliśmy ten ciąg znaków na InlineData.

• Ustawienia bezpieczeństwa

  • Pole method zostało zmienione na dopuszczające wartość null.

• Klasa czasu trwania

  • Usunęliśmy wszystkie przypadki użycia klasy Duration w Kotlinie i zastąpiliśmy je klasą long. Ta zmiana zapewnia lepszą interoperacyjność z Javą.

• Metadane cytowania

  • Wszystkie pola zadeklarowane wcześniej w okręgu CitationMetadata zostały umieszczone w nowej klasie o nazwie Citation. Cytaty znajdziesz na liście o nazwie citations w CitationMetadata. Ta zmiana pozwala lepiej dopasować typy na różnych platformach.

• Licz tokeny

  • Pole totalBillableCharacters zostało zmienione na dopuszczające wartość null.

• Łączna liczba znaków podlegających rozliczeniu

  • Zmieniono właściwość totalBillableCharacters w CountTokensResponse na opcjonalną, aby odzwierciedlała sytuacje, w których nie są wysyłane żadne znaki.

• Tworzenie instancji modelu

  • Przeniesiono parametr requestOptions na koniec listy parametrów, aby był zgodny z innymi platformami.

Java

• Wyliczenia

  • Zastąpiono zajęcia enum i sealed zwykłymi zajęciami. Ta zmiana zapewnia większą elastyczność w zakresie rozwoju interfejsu API w sposób zgodny wstecznie.

  • Zmieniono nazwę wyliczenia BlockThreshold na HarmBlockThreshold.

  • Usunięto wartości z tych wyliczeń: HarmBlockThreshold, HarmProbability, HarmSeverity, BlockReason i FinishReason.

• Metody obiektu blob

  • W nazwach wszystkich metod, które zawierały Blob, zamieniliśmy ten ciąg znaków na InlineData.

• Ustawienia bezpieczeństwa

  • Pole method zostało zmienione na dopuszczające wartość null.

• Klasa czasu trwania

  • Usunęliśmy wszystkie przypadki użycia klasy Duration w Kotlinie i zastąpiliśmy je klasą long. Ta zmiana zapewnia lepszą interoperacyjność z Javą.

• Metadane cytowania

  • Wszystkie pola zadeklarowane wcześniej w okręgu CitationMetadata zostały umieszczone w nowej klasie o nazwie Citation. Cytaty znajdziesz na liście o nazwie citations w CitationMetadata. Ta zmiana pozwala lepiej dopasować typy na różnych platformach.

• Licz tokeny

  • Pole totalBillableCharacters zostało zmienione na dopuszczające wartość null.

• Łączna liczba znaków podlegających rozliczeniu

  • Zmieniono właściwość totalBillableCharacters w CountTokensResponse na opcjonalną, aby odzwierciedlała sytuacje, w których nie są wysyłane żadne znaki.

• Tworzenie instancji modelu

  • Przeniesiono parametr requestOptions na koniec listy parametrów, aby był zgodny z innymi platformami.

Web

Pamiętaj, że Google AIpakiet SDK klienta w JavaScript przeszedł wiele zmian od czasu, gdy od niego odłączono Google AIpakiety SDK klienta.Firebase AI Logic Poniżej znajdziesz listę potencjalnych zmian, które warto wziąć pod uwagę podczas migracji do pakietów SDK klienta Firebase AI Logic.

• Wyliczenia

  • Usunięto wartości z tych wyliczeń: HarmCategory, BlockThreshold, HarmProbability, HarmSeverity, BlockReason i FinishReason.

• Przyczyna blokady

  • Zmieniono blockReason w PromptFeedback na opcjonalne.

• Grounding w wyszukiwarce

  • Usunięto wszystkie przypadki użycia tej funkcji, ponieważ nie jest ona jeszcze obsługiwana w zestawach SDKFirebase AI Logic.

• Błędy

  • Usunięcie wszystkich zastosowań GoogleGenerativeAIError i opcjonalne przejście na AIError.

Dart

• Wyliczenia

  • Usunęliśmy wartości z tych wyliczeń: HarmCategory, HarmProbability, BlockReason i FinishReason.

• Część danych

  • Zmieniliśmy nazwę funkcji DataPart na InlineDataPart, a funkcji static data na inlineData, aby zachować spójność z innymi platformami.

• Opcje żądania

  • Usunięto RequestOptions, ponieważ timeout nie działało. W najbliższej przyszłości zostanie ona ponownie dodana, ale zostanie przeniesiona do typu GenerativeModel, aby pasować do innych platform.

• Sekwencje zatrzymania

  • Zmieniono parametr stopSequences w pliku GenerationConfig tak, aby był opcjonalny i domyślnie przyjmował wartość null zamiast pustej tablicy.

• Cytowania

  • Zmieniliśmy nazwę właściwości citationSources na citations w usłudze CitationMetadata. Typ CitationSource został zmieniony na Citation, aby był zgodny z innymi platformami.

• Niepotrzebne typy, metody i właściwości publiczne

  • Usunęliśmy te typy, metody i właściwości, które zostały udostępnione nieumyślnie: defaultTimeout, CountTokensResponseFields, parseCountTokensResponse, parseEmbedContentResponse, parseGenerateContentResponse, parseContent, BatchEmbedContentsResponse, ContentEmbedding, EmbedContentRequest i EmbedContentResponse.

• Licz tokeny

  • Usunięto z funkcji countTokens dodatkowe pola, które nie są już potrzebne. Wystarczy tylko contents.

• Tworzenie instancji modelu

  • Przeniesiono parametr systemInstruction na koniec listy parametrów, aby był zgodny z innymi platformami.

• Funkcja umieszczania

  • Usunięto z modelu nieobsługiwaną funkcję osadzania (embedContent i batchEmbedContents).

Unity

Obsługa Unity nie była dostępna w pakietach SDK klienta Google AI.

Dowiedz się, jak zacząć korzystać z pakietu Firebase AI Logic SDK do Unity.