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

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 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. W Xcode otwórz projekt aplikacji i kliknij File > Add Package Dependencies (Plik > Dodaj zależności pakietu).

2. Gdy pojawi się odpowiedni komunikat, 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 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.

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.

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:18.0.0")
  implementation("com.google.firebase:firebase-appcheck-debug:20.0.0")
}

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 języka Java 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 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:18.0.0")
  implementation("com.google.firebase:firebase-appcheck-debug:20.0.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 upewnij się też, że Firebase został zainicjowany za pomocą obiektu DefaultFirebaseOptions wyeksportowanego przez plik konfiguracji:

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

4. Ponownie skompiluj aplikację Flutter:

   flutter run
   

Unity

Wsparcie dla Unity nie było dostępne w pakietach SDK klienta Google AI.

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

Swift

Usuń starą bibliotekę:

1. W Xcode otwórz projekt aplikacji i przejdź do panelu 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 na potrzeby Unity.

Swift

• Wyliczenia

  • Zastąpiono większość typów enum typami struct ze zmiennymi statycznymi. Ta zmiana zapewnia większą elastyczność w rozwoju interfejsu API w sposób zgodny wstecznie. Gdy używasz 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 zgodny wstecznie. Ta zmiana jest bardziej 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 struct typami zgodnymi z protokołem Part:

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

• Kategoria szkodliwości

  • Zmieniliśmy element HarmCategory, aby nie był już zagnieżdżony w typie SafetySetting. Jeśli odnosisz się do niego jako SafetySetting.HarmCategory, możesz zastąpić to określenie słowem 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ę usługi citationSources na citations w CitationMetadata.

• Łączna liczba znaków podlegających opłacie

  • Zmieniono właściwość totalBillableCharacters w CountTokensResponse, aby była opcjonalna, co odzwierciedla 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 publiczne właściwości GenerationConfig na internal. Wszystkie te ustawienia można nadal konfigurować w inicjatorze.

Kotlin

• Wyliczenia

  • Zastąpiliśmy zajęcia enum i sealed zwykłymi zajęciami. Ta zmiana zapewnia większą elastyczność w rozwijaniu 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

  • Zmieniliśmy nazwy wszystkich metod, które zawierały znak Blob, tak aby zamiast niego używały znaku 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 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 opłacie

  • Zmieniono właściwość totalBillableCharacters w CountTokensResponse, aby była opcjonalna, co odzwierciedla 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ąpiliśmy zajęcia enum i sealed zwykłymi zajęciami. Ta zmiana zapewnia większą elastyczność w rozwijaniu 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

  • Zmieniliśmy nazwy wszystkich metod, które zawierały znak Blob, tak aby zamiast niego używały znaku 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 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 opłacie

  • Zmieniono właściwość totalBillableCharacters w CountTokensResponse, aby była opcjonalna, co odzwierciedla 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 oddzieliły się Firebase AI Logicpakiety SDK klienta. Poniżej znajdziesz listę potencjalnych zmian, które warto wziąć pod uwagę podczas przechodzenia na Firebase AI Logicklientowe SDK

• Wyliczenia

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

• Przyczyna blokady

  • Zmieniono pole 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

  • Usunęliśmy wszystkie przypadki użycia GoogleGenerativeAIError i opcjonalnie przenieśliśmy się 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 była zgodna 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 GenerationConfig tak, aby był opcjonalny i domyślnie miał wartość null zamiast pustej tablicy.

• Cytowania

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

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

  • Usunięto 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 dodatkowe pola z funkcji countTokens, 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 osadzania

  • 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 na potrzeby Unity.