Migra a los SDKs de Firebase AI Logic desde la versión de GA de los SDKs de Vertex AI in Firebase

Swift

1. En Xcode, con el proyecto de tu app abierto, actualiza el paquete de Firebase a la versión 12.5.0 o una posterior con una de las siguientes opciones:

   • Opción 1: Actualiza todos los paquetes. Para ello, navega a File > Packages > Update to Latest Package Versions.

   • Opción 2: Actualiza Firebase de forma individual. Para ello, navega al paquete de Firebase en la sección llamada Package Dependencies. Haz clic con el botón derecho en el paquete de Firebase y, luego, selecciona Update Package.

2. Asegúrate de que el paquete de Firebase ahora muestre la versión 12.5.0 o una posterior. Si no es así, verifica que los requisitos del paquete que especificaste permitan la actualización a la versión 12.5.0 o una posterior.

3. Selecciona el destino de tu app en el editor de proyectos y, luego, navega a la sección Frameworks, Libraries, and Embedded Content.

4. Agrega la biblioteca nueva: Selecciona el botón + y, luego, agrega FirebaseAILogic desde el paquete de Firebase.

5. Después de que termines de migrar tu app (consulta las secciones restantes de esta guía), asegúrate de quitar la biblioteca anterior:
   Selecciona FirebaseVertexAI y, luego, presiona el botón —.

Kotlin

1. En el archivo Gradle del módulo (nivel de la app) (generalmente <project>/<app-module>/build.gradle.kts o <project>/<app-module>/build.gradle), reemplaza las dependencias anteriores (según corresponda) por las siguientes.

   Ten en cuenta que puede ser más fácil migrar la base de código de tu app (consulta las secciones restantes de esta guía) antes de borrar la dependencia anterior.

   // 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:35.1.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. Sincroniza tu proyecto de Android con archivos Gradle.

Ten en cuenta que, si decides no usar la Firebase Android BoM, solo debes agregar la dependencia para la biblioteca firebase-ai y aceptar la versión más reciente que sugiere Android Studio.

Java

1. En el archivo Gradle del módulo (nivel de la app) (generalmente <project>/<app-module>/build.gradle.kts o <project>/<app-module>/build.gradle), reemplaza las dependencias anteriores (según corresponda) por las siguientes.

   Ten en cuenta que puede ser más fácil migrar la base de código de tu app (consulta las secciones restantes de esta guía) antes de borrar la dependencia anterior.

   // 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:35.1.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. Sincroniza tu proyecto de Android con archivos Gradle.

Ten en cuenta que, si decides no usar la Firebase Android BoM, solo debes agregar la dependencia para la biblioteca firebase-ai y aceptar la versión más reciente que sugiere Android Studio.

Web

1. Obtén la versión más reciente del SDK de Firebase JS para la Web con npm:

   npm i firebase@latest

   O

   yarn add firebase@latest

2. Dondequiera que hayas importado la biblioteca, actualiza tus declaraciones de importación para usar firebase/ai en su lugar.

   Ten en cuenta que puede ser más fácil migrar la base de código de tu app (consulta las secciones restantes de esta guía) antes de borrar las importaciones anteriores.

   // 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. Actualiza el uso del paquete firebase_ai en tu archivo pubspec.yaml. Para ello, ejecuta el siguiente comando desde el directorio de tu proyecto de Flutter:

   flutter pub add firebase_ai

2. Vuelve a compilar tu proyecto de Flutter:

   flutter run

3. Después de que termines de migrar tu app (consulta las secciones restantes de esta guía), asegúrate de borrar el paquete anterior:

   flutter pub remove firebase_vertexai

Unity

La compatibilidad con Unity no estaba disponible en "Vertex AI in Firebase".

Obtén información para comenzar a usar el SDK de Firebase AI Logic para 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

La compatibilidad con Unity no estaba disponible en "Vertex AI in Firebase".

Obtén información para comenzar a usar el SDK de Firebase AI Logic para Unity.

Swift

No hay cambios adicionales.

Kotlin

• Live API

  • Se quitó el valor UNSPECIFIED de la clase enum ResponseModality. En su lugar, usa null.

Java

• Live API

  • Se quitó el valor UNSPECIFIED de la clase enum ResponseModality. En su lugar, usa null.

• Se cambiaron varios métodos de compilador de Java para que ahora devuelvan correctamente la instancia de su clase, en lugar de void.

Web

Los cambios son obligatorios solo si comienzas a usar el Gemini Developer API (en lugar de Agent Platform Gemini API (formerly Vertex AI)):

• Configuración de seguridad

  • Se quitaron los usos de SafetySetting.method no compatible.

• Datos intercalados

  • Se quitaron los usos de InlineDataPart.videoMetadata no compatible.

Dart

No hay cambios adicionales.

Unity

La compatibilidad con Unity no estaba disponible en "Vertex AI in Firebase".

Obtén información para comenzar a usar el SDK de Firebase AI Logic para Unity.