Migra a los SDKs de Firebase AI Logic desde la versión preliminar 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 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 terminar de migrar tu app (consulta las secciones restantes de esta guía), asegúrate de quitar la biblioteca anterior:
   Selecciona FirebaseVertexAI-Preview 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("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. 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 del módulo (nivel de la app) (generalmente <project>/<app-module>/build.gradle.kts o <project>/<app-module>/build.gradle), reemplaza las dependencias antiguas (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("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. 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. En todos los lugares 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 antiguas.

   // 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. Actualiza el uso del paquete firebase_ai en tu archivo pubspec.yaml ejecutando 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 desde "Vertex AI in Firebase".

Obtén información para comenzar a utilizar 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 desde "Vertex AI in Firebase".

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

Swift

• Enumeraciones

  • Se reemplazaron la mayoría de los tipos enum por structs con variables estáticas. Este cambio permite una mayor flexibilidad para desarrollar la API de forma retrocompatible. Cuando uses instrucciones switch, ahora debes incluir un caso default: para abarcar los valores desconocidos o no controlados, incluidos los valores nuevos que se agreguen al SDK en el futuro.

  • Se cambió el nombre de la enumeración BlockThreshold a HarmBlockThreshold. Este tipo ahora es un struct.

  • Se quitaron los casos unknown y unspecified de las siguientes enumeraciones (ahora structs): HarmCategory, HarmBlockThreshold, HarmProbability, BlockReason y FinishReason.

  • Se reemplazó la enumeración ModelContent.Part por un protocolo llamado Part para permitir que se agreguen tipos nuevos de forma retrocompatible. Este cambio se describe con más detalle en la sección Partes del contenido.

• Partes del contenido

  • Se quitó el protocolo ThrowingPartsRepresentable y se simplificaron los inicializadores de ModelContent para evitar errores ocasionales del compilador. Las imágenes que no se codifiquen correctamente seguirán arrojando errores cuando se usen en generateContent.

  • Se reemplazaron los casos de ModelContent.Part por los siguientes tipos de struct que se ajustan al protocolo Part:

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

• Categoría de daño

  • Se cambió HarmCategory para que ya no esté anidado en el tipo SafetySetting. Si te refieres a ella como SafetySetting.HarmCategory, puedes reemplazarla por HarmCategory.

• Comentarios sobre seguridad

  • Se quitó el tipo SafetyFeedback, ya que no se usaba en ninguna de las respuestas.

• Metadatos de citas

  • Se cambió el nombre de la propiedad citationSources a citations en CitationMetadata.

• Total de caracteres facturables

  • Se cambió la propiedad totalBillableCharacters en CountTokensResponse para que sea opcional y refleje situaciones en las que no se envían caracteres.

• Respuesta del candidato

  • Se cambió el nombre de CandidateResponse a Candidate para que coincida con otras plataformas.

• Configuración de la generación

  • Se cambiaron las propiedades públicas de GenerationConfig a internal. Todos siguen siendo configurables en el inicializador.

Kotlin

• Enumeraciones

  • Se reemplazaron las clases enum y sealed por clases regulares. Este cambio permite una mayor flexibilidad para evolucionar la API de forma retrocompatible.

  • Se cambió el nombre de la enumeración BlockThreshold a HarmBlockThreshold.

  • Se quitaron valores de las siguientes enumeraciones: HarmBlockThreshold, HarmProbability, HarmSeverity, BlockReason y FinishReason.

• Métodos de Blob

  • Se cambió el nombre de todos los métodos que incluían Blob como parte de su nombre para usar InlineData en su lugar.

• Configuración de seguridad

  • Se cambió el campo method para que sea anulable.

• Clase Duration

  • Se quitaron todos los usos de la clase Duration de Kotlin y se reemplazaron por long. Este cambio proporciona una mejor interoperabilidad con Java.

• Metadatos de citas

  • Se unieron todos los campos declarados anteriormente en CitationMetadata en una clase nueva llamada Citation. Las citas se pueden encontrar en la lista llamada citations en CitationMetadata. Este cambio permite una mejor alineación de los tipos en todas las plataformas.

• Contar tokens

  • Se cambió el campo totalBillableCharacters para que admita valores nulos.

• Total de caracteres facturables

  • Se cambió la propiedad totalBillableCharacters en CountTokensResponse para que sea opcional y refleje situaciones en las que no se envían caracteres.

• Cómo crear una instancia de un modelo

  • Se movió el parámetro requestOptions al final de la lista de parámetros para alinearlo con otras plataformas.

• Live API

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

  • Se cambió el nombre de LiveGenerationConfig.setResponseModalities por LiveGenerationConfig.setResponseModality.

  • Se quitó la clase LiveContentResponse.Status y, en su lugar, se anidaron los campos de estado como propiedades de LiveContentResponse.

  • Se quitó la clase LiveContentResponse y, en su lugar, se proporcionaron subclases de LiveServerMessage que coinciden con las respuestas del modelo.

  • Se cambió LiveModelFutures.connect para que devuelva ListenableFuture<LiveSessionFutures> en lugar de ListenableFuture<LiveSession>.

Java

• Enumeraciones

  • Se reemplazaron las clases enum y sealed por clases regulares. Este cambio permite una mayor flexibilidad para evolucionar la API de forma retrocompatible.

  • Se cambió el nombre de la enumeración BlockThreshold a HarmBlockThreshold.

  • Se quitaron valores de las siguientes enumeraciones: HarmBlockThreshold, HarmProbability, HarmSeverity, BlockReason y FinishReason.

• Métodos de Blob

  • Se cambió el nombre de todos los métodos que incluían Blob como parte de su nombre para usar InlineData en su lugar.

• Configuración de seguridad

  • Se cambió el campo method para que sea anulable.

• Clase Duration

  • Se quitaron todos los usos de la clase Duration de Kotlin y se reemplazaron por long. Este cambio proporciona una mejor interoperabilidad con Java.

• Metadatos de citas

  • Se unieron todos los campos declarados anteriormente en CitationMetadata en una clase nueva llamada Citation. Las citas se pueden encontrar en la lista llamada citations en CitationMetadata. Este cambio permite una mejor alineación de los tipos en todas las plataformas.

• Contar tokens

  • Se cambió el campo totalBillableCharacters para que admita valores nulos.

• Total de caracteres facturables

  • Se cambió la propiedad totalBillableCharacters en CountTokensResponse para que sea opcional y refleje situaciones en las que no se envían caracteres.

• Cómo crear una instancia de un modelo

  • Se movió el parámetro requestOptions al final de la lista de parámetros para alinearlo con otras plataformas.

• Live API

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

  • Se cambió el nombre de LiveGenerationConfig.setResponseModalities por LiveGenerationConfig.setResponseModality.

  • Se quitó la clase LiveContentResponse.Status y, en su lugar, se anidaron los campos de estado como propiedades de LiveContentResponse.

  • Se quitó la clase LiveContentResponse y, en su lugar, se proporcionaron subclases de LiveServerMessage que coinciden con las respuestas del modelo.

  • Se cambió LiveModelFutures.connect para que devuelva ListenableFuture<LiveSessionFutures> en lugar de ListenableFuture<LiveSession>.

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

Web

• Enumeraciones

  • Se quitaron valores de las siguientes enumeraciones: HarmCategory, BlockThreshold, HarmProbability, HarmSeverity, BlockReason y FinishReason.

• Motivo del bloqueo

  • Se cambió blockReason en PromptFeedback para que sea opcional.

Cambios necesarios solo si comienzas a usar 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 admitido.

• Datos intercalados

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

Dart

• Enumeraciones

  • Se quitaron los valores de las siguientes enumeraciones: HarmCategory, HarmProbability, BlockReason y FinishReason.

• Parte de datos

  • Se cambió el nombre de DataPart por InlineDataPart y el de la función static data por inlineData para alinearlo con otras plataformas.

• Opciones de solicitud

  • Se quitó RequestOptions porque timeout no funcionaba. Se volverá a agregar en el futuro cercano, pero se cambiará al tipo GenerativeModel para que coincida con otras plataformas.

• Secuencias de detención

  • Se cambió el parámetro stopSequences en GenerationConfig para que sea opcional y se use null de forma predeterminada, en lugar de un array vacío.

• Citas

  • Se cambió el nombre de la propiedad citationSources a citations en CitationMetadata. Se cambió el nombre del tipo CitationSource por Citation para que coincida con otras plataformas.

• Tipos, métodos y propiedades públicos innecesarios

  • Se quitaron los siguientes tipos, métodos y propiedades que se expusieron de forma no intencional: defaultTimeout, CountTokensResponseFields, parseCountTokensResponse, parseEmbedContentResponse, parseGenerateContentResponse, parseContent, BatchEmbedContentsResponse, ContentEmbedding, EmbedContentRequest y EmbedContentResponse.

• Cuenta tokens

  • Se quitaron los campos adicionales de la función countTokens que ya no son necesarios. Solo se necesita contents.

• Cómo crear una instancia de un modelo

  • Se trasladó el parámetro systemInstruction al final de la lista de parámetros para alinearse con otras plataformas.

• Funcionalidad de incorporación

  • Se quitó la funcionalidad de incorporación no admitida (embedContent y batchEmbedContents) del modelo.

Unity

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

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