Переход на Firebase AI Logic SDKs из версии GA Vertex AI в Firebase SDKs

Быстрый

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

   • Вариант 1 : Обновить все пакеты: Перейдите в меню Файл > Пакеты > Обновить до последних версий пакетов .

   • Вариант 2 : Обновите Firebase по отдельности: Перейдите к пакету Firebase в разделе « Зависимости пакета» . Щелкните правой кнопкой мыши по пакету Firebase и выберите «Обновить пакет» .

2. Убедитесь, что в списке необходимых пакетов Firebase отображается версия 11.13.0 или более поздняя. Если это не так, проверьте, позволяют ли указанные вами требования к пакету обновить его до версии 11.13.0 или более поздней.

3. В редакторе проектов выберите целевой объект вашего приложения, а затем перейдите в раздел «Фреймворки, библиотеки и встроенный контент» .

4. Добавьте новую библиотеку: выберите кнопку «+» , а затем добавьте FirebaseAI из пакета Firebase.

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

Kotlin

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

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

   // BEFORE
   dependencies {
     implementation(platform("com.google.firebase:firebase-bom:33.x.y"))
     implementation("com.google.firebase:firebase-vertexai")
     // OR if not using the BoM
     implementation("com.google.firebase:firebase-vertexai:16.x.y")
   }
   
   
   // AFTER
   dependencies {
     // Import the BoM for the Firebase platform
     implementation(platform("com.google.firebase:firebase-bom:34.18.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(platform("com.google.firebase:firebase-bom:33.x.y"))
     implementation("com.google.firebase:firebase-vertexai")
     // OR if not using the BoM
     implementation("com.google.firebase:firebase-vertexai:16.x.y")
   }
   
   
   // AFTER
   dependencies {
     // Import the BoM for the Firebase platform
     implementation(platform("com.google.firebase:firebase-bom:34.18.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";
   
   
   // 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 в " Vertex AI in Firebase " отсутствовала.

Узнайте, как начать работу с Firebase AI Logic SDK для Unity .

Быстрый

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.7-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.7-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.7-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.7-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.7-flash');

Единство

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

Узнайте, как начать работу с Firebase AI Logic SDK для Unity .

Быстрый

Никаких дополнительных изменений.

Kotlin

• Live API

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

Java

• Live API

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

• Внесены изменения в различные методы Java-конструктора, теперь они корректно возвращают экземпляр класса, а не void.

Web

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

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

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

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

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

Dart

Никаких дополнительных изменений.

Единство

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

Узнайте, как начать работу с Firebase AI Logic SDK для Unity .

Быстрый

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

   • Вариант 1 : Обновить все пакеты: Перейдите в меню Файл > Пакеты > Обновить до последних версий пакетов .

   • Вариант 2 : Обновите Firebase по отдельности: Перейдите к пакету Firebase в разделе « Зависимости пакета» . Щелкните правой кнопкой мыши по пакету Firebase и выберите «Обновить пакет» .

2. Убедитесь, что в списке необходимых пакетов Firebase отображается версия 11.13.0 или более поздняя. Если это не так, проверьте, позволяют ли указанные вами требования к пакету обновить его до версии 11.13.0 или более поздней.

3. В редакторе проектов выберите целевой объект вашего приложения, а затем перейдите в раздел «Фреймворки, библиотеки и встроенный контент» .

4. Добавьте новую библиотеку: выберите кнопку «+» , а затем добавьте FirebaseAI из пакета Firebase.

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

Kotlin

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

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

   // BEFORE
   dependencies {
     implementation(platform("com.google.firebase:firebase-bom:33.x.y"))
     implementation("com.google.firebase:firebase-vertexai")
     // OR if not using the BoM
     implementation("com.google.firebase:firebase-vertexai:16.x.y")
   }
   
   
   // AFTER
   dependencies {
     // Import the BoM for the Firebase platform
     implementation(platform("com.google.firebase:firebase-bom:34.18.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(platform("com.google.firebase:firebase-bom:33.x.y"))
     implementation("com.google.firebase:firebase-vertexai")
     // OR if not using the BoM
     implementation("com.google.firebase:firebase-vertexai:16.x.y")
   }
   
   
   // AFTER
   dependencies {
     // Import the BoM for the Firebase platform
     implementation(platform("com.google.firebase:firebase-bom:34.18.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";
   
   
   // 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 в " Vertex AI in Firebase " отсутствовала.

Узнайте, как начать работу с Firebase AI Logic SDK для Unity .

Быстрый

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.7-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.7-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.7-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.7-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.7-flash');

Единство

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

Узнайте, как начать работу с Firebase AI Logic SDK для Unity .

Быстрый

Никаких дополнительных изменений.

Kotlin

• Live API

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

Java

• Live API

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

• Внесены изменения в различные методы Java-конструктора, теперь они корректно возвращают экземпляр класса, а не void.

Web

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

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

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

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

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

Dart

Никаких дополнительных изменений.

Единство

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

Узнайте, как начать работу с Firebase AI Logic SDK для Unity .

Быстрый

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

   • Вариант 1 : Обновить все пакеты: Перейдите в меню Файл > Пакеты > Обновить до последних версий пакетов .

   • Вариант 2 : Обновите Firebase по отдельности: Перейдите к пакету Firebase в разделе « Зависимости пакета» . Щелкните правой кнопкой мыши по пакету Firebase и выберите «Обновить пакет» .

2. Убедитесь, что в списке необходимых пакетов Firebase отображается версия 11.13.0 или более поздняя. Если это не так, проверьте, позволяют ли указанные вами требования к пакету обновить его до версии 11.13.0 или более поздней.

3. В редакторе проектов выберите целевой объект вашего приложения, а затем перейдите в раздел «Фреймворки, библиотеки и встроенный контент» .

4. Добавьте новую библиотеку: выберите кнопку «+» , а затем добавьте FirebaseAI из пакета Firebase.

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

Kotlin

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

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

   // BEFORE
   dependencies {
     implementation(platform("com.google.firebase:firebase-bom:33.x.y"))
     implementation("com.google.firebase:firebase-vertexai")
     // OR if not using the BoM
     implementation("com.google.firebase:firebase-vertexai:16.x.y")
   }
   
   
   // AFTER
   dependencies {
     // Import the BoM for the Firebase platform
     implementation(platform("com.google.firebase:firebase-bom:34.18.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(platform("com.google.firebase:firebase-bom:33.x.y"))
     implementation("com.google.firebase:firebase-vertexai")
     // OR if not using the BoM
     implementation("com.google.firebase:firebase-vertexai:16.x.y")
   }
   
   
   // AFTER
   dependencies {
     // Import the BoM for the Firebase platform
     implementation(platform("com.google.firebase:firebase-bom:34.18.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";
   
   
   // 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 в " Vertex AI in Firebase " отсутствовала.

Узнайте, как начать работу с Firebase AI Logic SDK для Unity .

Быстрый

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.7-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.7-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.7-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.7-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.7-flash');

Единство

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

Узнайте, как начать работу с Firebase AI Logic SDK для Unity .

Быстрый

Никаких дополнительных изменений.

Kotlin

• Live API

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

Java

• Live API

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

• Внесены изменения в различные методы Java-конструктора, теперь они корректно возвращают экземпляр класса, а не void.

Web

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

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

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

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

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

Dart

Никаких дополнительных изменений.

Единство

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

Узнайте, как начать работу с Firebase AI Logic SDK для Unity .

Быстрый

1. In Xcode, with your app project open, update your Firebase package to v11.13.0 or later using one of the following options:

   • Option 1 : Update all packages: Navigate to File > Packages > Update to Latest Package Versions .

   • Option 2 : Update Firebase individually: Navigate to the Firebase package in the section called Package Dependencies . Right-click on the Firebase package, and then select Update Package .

2. Make sure that the Firebase package now shows v11.13.0 or later. If it doesn't, verify that your specified Package Requirements allow updating to v11.13.0 or later.

3. Select your app's target in the Project Editor, and then navigate to the Frameworks, Libraries, and Embedded Content section.

4. Add the new library: Select the + button, and then add FirebaseAI from the Firebase package.

5. After you've finished migrating your app (see the remaining sections in this guide), make sure to remove the old library:
   Select FirebaseVertexAI , and then press the — button.

Kotlin

1. In your module (app-level) Gradle file (usually <project>/<app-module>/build.gradle.kts or <project>/<app-module>/build.gradle ), replace old dependencies (as applicable) with the following.

   Note that it might be easier to migrate your app's codebase (see the remaining sections in this guide) before deleting the old dependency.

   // BEFORE
   dependencies {
     implementation(platform("com.google.firebase:firebase-bom:33.x.y"))
     implementation("com.google.firebase:firebase-vertexai")
     // OR if not using the BoM
     implementation("com.google.firebase:firebase-vertexai:16.x.y")
   }
   
   
   // AFTER
   dependencies {
     // Import the BoM for the Firebase platform
     implementation(platform("com.google.firebase:firebase-bom:34.18.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. Sync your Android project with Gradle files.

Note that if you choose to not use the Firebase Android BoM , then just add the dependency for the firebase-ai library and accept the latest version that's suggested by Android Studio.

Java

1. In your module (app-level) Gradle file (usually <project>/<app-module>/build.gradle.kts or <project>/<app-module>/build.gradle ), replace old dependencies (as applicable) with the following.

   Note that it might be easier to migrate your app's codebase (see the remaining sections in this guide) before deleting the old dependency.

   // BEFORE
   dependencies {
     implementation(platform("com.google.firebase:firebase-bom:33.x.y"))
     implementation("com.google.firebase:firebase-vertexai")
     // OR if not using the BoM
     implementation("com.google.firebase:firebase-vertexai:16.x.y")
   }
   
   
   // AFTER
   dependencies {
     // Import the BoM for the Firebase platform
     implementation(platform("com.google.firebase:firebase-bom:34.18.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. Sync your Android project with Gradle files.

Note that if you choose to not use the Firebase Android BoM , then just add the dependency for the firebase-ai library and accept the latest version that's suggested by Android Studio.

Web

1. Get the latest version of the Firebase JS SDK for Web using npm:

   npm i firebase@latest

   ИЛИ

   yarn add firebase@latest

2. Wherever you've imported the library, update your import statements to use firebase/ai instead.

   Note that it might be easier to migrate your app's codebase (see the remaining sections in this guide) before deleting the old imports.

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

Dart

1. Update to the use the firebase_ai package in your pubspec.yaml file by running the following command from your Flutter project directory:

   flutter pub add firebase_ai

2. Rebuild your Flutter project:

   flutter run

3. After you've finished migrating your app (see the remaining sections in this guide), make sure to delete the old package:

   flutter pub remove firebase_vertexai

Единство

Support for Unity wasn't available from " Vertex AI in Firebase ".

Learn how to get started with the Firebase AI Logic SDK for Unity .

Быстрый

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.7-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.7-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.7-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.7-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.7-flash');

Единство

Support for Unity wasn't available from " Vertex AI in Firebase ".

Learn how to get started with the Firebase AI Logic SDK for Unity .

Быстрый

No additional changes.

Kotlin

• Live API

  • Removed UNSPECIFIED value for enum class ResponseModality . Instead use null .

Java

• Live API

  • Removed UNSPECIFIED value for enum class ResponseModality . Instead use null .

• Changed various Java builder methods to now correctly return the instance of their class, instead of void.

Web

Changes required only if you're starting to use the Gemini Developer API (instead of the Agent Platform Gemini API (formerly Vertex AI) ):

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

  • Removed usages of the unsupported SafetySetting.method .

• Inline data

  • Removed usages of the unsupported InlineDataPart.videoMetadata .

Dart

No additional changes.

Единство

Support for Unity wasn't available from " Vertex AI in Firebase ".

Learn how to get started with the Firebase AI Logic SDK for Unity .