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

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Swift

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

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

   • Opción 2: Actualiza Firebase de forma individual: Navega al paquete de Firebase en la sección llamada Dependencias del paquete. 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 11.13.0 o una posterior. Si no es así, verifica que los Requisitos del paquete especificados permitan la actualización a la versión 11.13.0 o una posterior.

3. Selecciona el destino de tu app en el editor de proyectos y, luego, navega a la sección Frameworks, bibliotecas y contenido incorporado.

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

5. Después de terminar 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 (generalmente <project>/<app-module>/build.gradle.kts o <project>/<app-module>/build.gradle) del módulo (nivel de app), reemplaza las dependencias anteriores (según corresponda) por lo siguiente.

   Ten en cuenta que podría 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:33.13.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 Firebase Android BoM, solo debes agregar la dependencia de la biblioteca firebase-ai y aceptar la versión más reciente que sugiere Android Studio.

Java

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

   Ten en cuenta que podría 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:33.13.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 Firebase Android BoM, solo debes agregar la dependencia de 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. Donde hayas importado la biblioteca, actualiza las instrucciones de importación para usar firebase/ai en su lugar.

   Ten en cuenta que podría 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. Para actualizar y usar el paquete firebase_ai en tu archivo pubspec.yaml, 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 terminar 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 en Firebase".

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

Swift

import FirebaseAI

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

Unity

La compatibilidad con Unity no estaba disponible en "Vertex AI en 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 para la clase enum ResponseModality. En su lugar, usa null.

Java

• Live API

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

• Se cambiaron varios métodos de compilador de Java para que ahora muestren correctamente la instancia de su clase, en lugar de un valor nulo.

Web

Cambios obligatorios solo si comienzas a usar Gemini Developer API (en lugar de Vertex AI Gemini API):

• Configuración de seguridad

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

• Datos intercalados

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

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.