Как перейти с предварительной версии Vertex AI в Firebase SDK на Firebase AI Logic SDK

Swift

1. Откройте проект приложения в Xcode и обновите пакет Firebase до версии 12.5.0 или более поздней, используя один из следующих вариантов:

   • Вариант 1. Обновите все пакеты, выбрав File (Файл) > Packages (Пакеты) > Update to Latest Package Versions (Обновить до последних версий пакетов).

   • Вариант 2. Обновите Firebase отдельно. Для этого перейдите к пакету Firebase в разделе Package Dependencies (Зависимости пакетов). Нажмите правой кнопкой мыши на пакет Firebase и выберите Update Package (Обновить пакет).

2. Убедитесь, что в пакете Firebase указана версия 12.5.0 или более поздняя. Если нет, убедитесь, что в разделе Требования к пакету указано, что можно установить версию 12.5.0 или более позднюю.

3. Выберите целевое приложение в редакторе проектов и перейдите в раздел Frameworks, Libraries, and Embedded Content (Фреймворки, библиотеки и встроенный контент).

4. Добавьте новую библиотеку. Нажмите кнопку + и добавьте FirebaseAILogic из пакета Firebase.

5. После того как вы перенесете приложение (см. оставшиеся разделы этого руководства), удалите старую библиотеку:
   Выберите FirebaseVertexAI-Preview и нажмите кнопку –.

Kotlin

1. В файле Gradle модуля (на уровне приложения) (обычно <project>/<app-module>/build.gradle.kts или <project>/<app-module>/build.gradle) замените старые зависимости (если они есть) на следующие:

   Обратите внимание, что может быть проще перенести код приложения (см. оставшиеся разделы этого руководства), прежде чем удалять старую зависимость.

   // BEFORE
   dependencies {
     implementation("com.google.firebase:firebase-vertexai:16.0.0-betaXX")
   }
   
   
   // AFTER
   dependencies {
     // Import the BoM for the Firebase platform
     implementation(platform("com.google.firebase:firebase-bom:35.0.0"))
   
     // Add the dependency for the Firebase AI Logic library
     // When using the BoM, you don't specify versions in Firebase library dependencies
     implementation("com.google.firebase:firebase-ai")
   }

2. Синхронизируйте проект для Android с файлами Gradle.

Если вы не хотите использовать Firebase Android BoM, добавьте зависимость для библиотеки firebase-ai и примите последнюю версию, предложенную Android Studio.

Java

1. В файле Gradle модуля (на уровне приложения) (обычно <project>/<app-module>/build.gradle.kts или <project>/<app-module>/build.gradle) замените старые зависимости (если они есть) на следующие:

   Обратите внимание, что может быть проще перенести код приложения (см. оставшиеся разделы этого руководства), прежде чем удалять старую зависимость.

   // BEFORE
   dependencies {
     implementation("com.google.firebase:firebase-vertexai:16.0.0-betaXX")
   }
   
   
   // AFTER
   dependencies {
     // Import the BoM for the Firebase platform
     implementation(platform("com.google.firebase:firebase-bom:35.0.0"))
   
     // Add the dependency for the Firebase AI Logic library
     // When using the BoM, you don't specify versions in Firebase library dependencies
     implementation("com.google.firebase:firebase-ai")
   }

2. Синхронизируйте проект для Android с файлами Gradle.

Если вы не хотите использовать Firebase Android BoM, добавьте зависимость для библиотеки firebase-ai и примите последнюю версию, предложенную Android Studio.

Web

1. Чтобы получить последнюю версию Firebase JS SDK для сайта, используйте npm:

   npm i firebase@latest

   ИЛИ

   yarn add firebase@latest

2. Везде, где вы импортировали библиотеку, обновите операторы импорта, чтобы вместо нее использовался firebase/ai.

   Обратите внимание, что может быть проще перенести базу кода приложения (см. остальные разделы этого руководства), прежде чем удалять старые импорты.

   // BEFORE
   import { initializeApp } from "firebase/app";
   import { getVertexAI, getGenerativeModel } from "firebase/vertexai-preview";
   
   
   // AFTER
   import { initializeApp } from "firebase/app";
   import { getAI, getGenerativeModel } from "firebase/ai";

Dart

1. Чтобы использовать пакет firebase_ai в файле pubspec.yaml, выполните следующую команду в каталоге проекта Flutter:

   flutter pub add firebase_ai

2. Пересоберите проект Flutter:

   flutter run

3. После того как вы перенесете приложение (см. остальные разделы этого руководства), удалите старый пакет:

   flutter pub remove firebase_vertexai

Unity

Поддержка Unity была недоступна в "Vertex AI in Firebase".

Подробнее о том, как начать работу с Firebase AI Logic SDK для Unity…

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

Поддержка Unity была недоступна с "Vertex AI in Firebase".

Подробнее о том, как начать работу с Firebase AI Logic SDK для Unity…

Swift

• Перечисления

  • Большинство типов enum заменены на struct со статическими переменными. Это изменение позволит развивать API с обратной совместимостью. При использовании операторов switch теперь необходимо включить вариант default:, чтобы охватить неизвестные или необработанные значения, в том числе новые значения, которые будут добавлены в SDK в будущем.

  • Перечисление BlockThreshold переименовано в HarmBlockThreshold. Теперь этот тип является struct.

  • Удалены случаи unknown и unspecified из следующих перечислений (теперь struct): HarmCategory, HarmBlockThreshold, HarmProbability, BlockReason и FinishReason.

  • Перечисление ModelContent.Part заменено протоколом Part, чтобы можно было добавлять новые типы с сохранением обратной совместимости. Подробную информацию об этом изменении можно найти в разделе Части контента.

• Части контента

  • Удален протокол ThrowingPartsRepresentable и упрощены инициализаторы для ModelContent, чтобы избежать ошибок компилятора. Изображения, которые не были правильно закодированы, будут вызывать ошибки при использовании в generateContent.

  • Случаи ModelContent.Part заменены следующими типами struct, соответствующими протоколу Part:

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

• Категория вреда

  • Изменено вложенное расположение типа HarmCategory в типе SafetySetting. Если вы называете его SafetySetting.HarmCategory, то можете заменить его на HarmCategory.

• Отзывы о безопасности

  • Удален тип SafetyFeedback, поскольку он не использовался ни в одном из ответов.

• Метаданные цитирования

  • Свойство citationSources переименовано в citations в CitationMetadata.

• Общее количество оплачиваемых символов

  • Свойство totalBillableCharacters в CountTokensResponse теперь необязательное, чтобы отражать ситуации, когда символы не отправляются.

• Ответ кандидата

  • Название CandidateResponse изменено на Candidate, чтобы соответствовать другим платформам.

• Настройка генерации

  • Изменены общедоступные свойства GenerationConfig на internal. Все эти параметры можно настроить в инициализаторе.

Kotlin

• Перечисления

  • Классы enum и sealed заменены на обычные классы. Это изменение позволяет более гибко развивать API, сохраняя обратную совместимость.

  • Переименовано перечисление BlockThreshold в HarmBlockThreshold.

  • Удалены значения из следующих перечислений: HarmBlockThreshold, HarmProbability, HarmSeverity, BlockReason и FinishReason.

• Методы Blob

  • Во всех названиях методов, содержащих Blob, этот символ заменен на InlineData.

• Настройки безопасности

  • Поле method теперь может иметь нулевое значение.

• Класс Duration

  • Удалены все случаи использования класса Duration Kotlin и заменены на long. Это изменение обеспечивает лучшую совместимость с Java.

• Метаданные цитирования

  • Все поля, ранее объявленные в CitationMetadata, были обернуты в новый класс Citation. Ссылки можно найти в списке citations в CitationMetadata. Это изменение позволит лучше согласовать типы на разных платформах.

• Как подсчитать токены

  • Поле totalBillableCharacters теперь может иметь нулевое значение.

• Общее количество оплачиваемых символов

  • Свойство totalBillableCharacters в CountTokensResponse теперь необязательное, чтобы отражать ситуации, когда символы не отправляются.

• Создание экземпляра модели

  • Параметр requestOptions перемещен в конец списка параметров, чтобы соответствовать другим платформам.

• Live API

  • Удалено значение UNSPECIFIED для класса перечисления ResponseModality. Вместо этого используйте null.

  • Название "LiveGenerationConfig.setResponseModalities" изменено на "LiveGenerationConfig.setResponseModality".

  • Удален класс LiveContentResponse.Status, а поля статуса вложены в качестве свойств в класс LiveContentResponse.

  • Удален класс LiveContentResponse. Вместо него добавлены подклассы LiveServerMessage, соответствующие ответам модели.

  • Изменено значение LiveModelFutures.connect, теперь возвращается ListenableFuture<LiveSessionFutures> вместо ListenableFuture<LiveSession>.

Java

• Перечисления

  • Классы enum и sealed заменены на обычные классы. Это изменение позволяет более гибко развивать API, сохраняя обратную совместимость.

  • Переименовано перечисление BlockThreshold в HarmBlockThreshold.

  • Удалены значения из следующих перечислений: HarmBlockThreshold, HarmProbability, HarmSeverity, BlockReason и FinishReason.

• Методы Blob

  • Во всех названиях методов, содержащих Blob, этот символ заменен на InlineData.

• Настройки безопасности

  • Поле method теперь может иметь нулевое значение.

• Класс Duration

  • Удалены все случаи использования класса Duration Kotlin и заменены на long. Это изменение обеспечивает лучшую совместимость с Java.

• Метаданные цитирования

  • Все поля, ранее объявленные в CitationMetadata, были обернуты в новый класс Citation. Ссылки можно найти в списке citations в CitationMetadata. Это изменение позволит лучше согласовать типы на разных платформах.

• Как подсчитать токены

  • Поле totalBillableCharacters теперь может иметь нулевое значение.

• Общее количество оплачиваемых символов

  • Свойство totalBillableCharacters в CountTokensResponse теперь необязательное, чтобы отражать ситуации, когда символы не отправляются.

• Создание экземпляра модели

  • Параметр requestOptions перемещен в конец списка параметров, чтобы соответствовать другим платформам.

• Live API

  • Удалено значение UNSPECIFIED для класса перечисления ResponseModality. Вместо этого используйте null.

  • Название "LiveGenerationConfig.setResponseModalities" изменено на "LiveGenerationConfig.setResponseModality".

  • Удален класс LiveContentResponse.Status, а поля статуса вложены в качестве свойств в класс LiveContentResponse.

  • Удален класс LiveContentResponse. Вместо него добавлены подклассы LiveServerMessage, соответствующие ответам модели.

  • Изменено значение LiveModelFutures.connect, теперь возвращается ListenableFuture<LiveSessionFutures> вместо ListenableFuture<LiveSession>.

• Изменены различные методы создания объектов Java, чтобы они правильно возвращали экземпляр своего класса, а не void.

Web

• Перечисления

  • Удалены значения из следующих перечислений: HarmCategory, BlockThreshold, HarmProbability, HarmSeverity, BlockReason и FinishReason.

• Причина блокировки

  • Поле "blockReason" в PromptFeedback стало необязательным.

Изменения требуются, только если вы начинаете использовать Gemini Developer API (вместо Agent Platform Gemini API (formerly Vertex AI)):

• Настройки безопасности

  • Удалены случаи использования неподдерживаемого тега SafetySetting.method.

• Встроенные данные

  • Удалены случаи использования неподдерживаемого тега InlineDataPart.videoMetadata.

Dart

• Перечисления

  • Из следующих перечислений удалены значения: HarmCategory, HarmProbability, BlockReason и FinishReason.

• Часть данных

  • Функция DataPart переименована в InlineDataPart, а функция static data – в inlineData, чтобы названия соответствовали другим платформам.

• Варианты запроса

  • Удалено RequestOptions, так как timeout не работало. В ближайшем будущем мы добавим его снова, но он будет относиться к типу GenerativeModel, как и на других платформах.

• Как остановить последовательности

  • Параметр stopSequences в GenerationConfig теперь необязательный. По умолчанию используется значение null, а не пустой массив.

• Источники

  • Свойство citationSources переименовано в citations в CitationMetadata. Тип CitationSource был переименован в Citation, чтобы соответствовать другим платформам.

• Ненужные общедоступные типы, методы и свойства

  • Удалены следующие типы, методы и свойства, которые были непреднамеренно предоставлены: defaultTimeout, CountTokensResponseFields, parseCountTokensResponse, parseEmbedContentResponse, parseGenerateContentResponse, parseContent, BatchEmbedContentsResponse, ContentEmbedding, EmbedContentRequest и EmbedContentResponse.

• Как подсчитать токены

  • Удалены лишние поля из функции countTokens, которые больше не нужны. Достаточно указать только contents.

• Создание экземпляра модели

  • Параметр systemInstruction перемещен в конец списка параметров, чтобы соответствовать другим платформам.

• Функция встраивания

  • Из модели удалена неподдерживаемая функция встраивания (embedContent и batchEmbedContents).

Unity

Поддержка Unity была недоступна в "Vertex AI in Firebase".

Подробнее о том, как начать работу с Firebase AI Logic SDK для Unity…