Migrar para os SDKs de lógica de IA do Firebase da versão GA dos SDKs da Vertex AI no Firebase

Swift

1. No Xcode, com o projeto do app aberto, atualize o pacote do Firebase para a versão 11.13.0 ou mais recente usando uma das seguintes opções:

   • Opção 1: atualize todos os pacotes: acesse Arquivo > Pacotes > Atualizar para as versões mais recentes do pacote.

   • Opção 2: atualize o Firebase individualmente: acesse o pacote do Firebase na seção Dependências de pacote. Clique com o botão direito do mouse no pacote do Firebase e selecione Atualizar pacote.

2. Verifique se o pacote do Firebase agora mostra a versão 11.13.0 ou mais recente. Se não for o caso, verifique se os requisitos de pacote especificados permitem a atualização para a versão 11.13.0 ou mais recente.

3. Selecione o destino do app no editor de projetos e acesse a seção Frameworks, bibliotecas e conteúdo incorporado.

4. Adicione a nova biblioteca: selecione o botão + e adicione FirebaseAI do pacote do Firebase.

5. Depois de concluir a migração do app (consulte as seções restantes neste guia), remova a biblioteca antiga:
   Selecione FirebaseVertexAI, e pressione o botão —.

Kotlin

1. No arquivo do Gradle do módulo (nível do app) (geralmente <project>/<app-module>/build.gradle.kts ou <project>/<app-module>/build.gradle), substitua as dependências antigas (conforme aplicável) pelas seguintes.

   Observação: talvez seja mais fácil migrar a base de código do seu app (consulte as seções restantes neste guia) antes de excluir a dependência antiga.

   // 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.12.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. Sincronize seu projeto do Android com os arquivos Gradle.

Se você optar por não usar o Firebase Android BoM, basta adicionar a dependência da biblioteca firebase-ai e aceitar a versão mais recente sugerida pelo Android Studio.

Java

1. No arquivo do Gradle do módulo (nível do app) (geralmente <project>/<app-module>/build.gradle.kts ou <project>/<app-module>/build.gradle), substitua as dependências antigas (conforme aplicável) pelas seguintes.

   Observação: talvez seja mais fácil migrar a base de código do seu app (consulte as seções restantes neste guia) antes de excluir a dependência antiga.

   // 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.12.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. Sincronize seu projeto do Android com os arquivos Gradle.

Se você optar por não usar o Firebase Android BoM, basta adicionar a dependência da biblioteca firebase-ai e aceitar a versão mais recente sugerida pelo Android Studio.

Web

1. Acesse a versão mais recente do SDK do Firebase para JavaScript para a Web usando o npm:

   npm i firebase@latest

   OU

   yarn add firebase@latest

2. Onde você importou a biblioteca, atualize as instruções de importação para usar firebase/ai.

   Observe que talvez seja mais fácil migrar a base de código do seu app (consulte as seções restantes neste guia) antes de excluir as importações antigas.

   // 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. Atualize para usar o pacote firebase_ai no arquivo pubspec.yaml executando o seguinte comando no diretório do projeto do Flutter:

   flutter pub add firebase_ai

2. Recrie seu projeto do Flutter:

   flutter run

3. Depois de concluir a migração do app (consulte as seções restantes neste guia), exclua o pacote antigo:

   flutter pub remove firebase_vertexai

Unity

O suporte ao Unity não estava disponível em "Vertex AI in Firebase".

Saiba como começar a usar o Firebase AI Logic SDK para Unity.

Swift

import FirebaseAILogic

// Initialize the Vertex AI Gemini API backend service
let ai = FirebaseAI.firebaseAI(backend: .vertexAI())

// Create a `GenerativeModel` instance with a model that supports your use case
let model = ai.generativeModel(modelName: "gemini-3-flash-preview")

Kotlin

// Initialize the Vertex AI Gemini API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
val model = Firebase.ai(backend = GenerativeBackend.vertexAI())
                        .generativeModel("gemini-3-flash-preview")

Java

// Initialize the Vertex AI Gemini API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.vertexAI())
        .generativeModel("gemini-3-flash-preview");

// 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, VertexAIBackend } 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 Vertex AI Gemini API backend service
const ai = getAI(firebaseApp, { backend: new VertexAIBackend() });

// Create a `GenerativeModel` instance with a model that supports your use case
const model = getGenerativeModel(ai, { model: "gemini-3-flash-preview" });

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 Vertex AI Gemini API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
final model =
      FirebaseAI.vertexAI().generativeModel(model: 'gemini-3-flash-preview');

Unity

O suporte ao Unity não estava disponível na "Vertex AI in Firebase".

Saiba como começar a usar o Firebase AI Logic SDK para Unity.

Swift

Nenhuma mudança adicional.

Kotlin

• Live API

  • Valor UNSPECIFIED removido para a classe de tipo enumerado ResponseModality. Em vez disso, use null.

Java

• Live API

  • Valor UNSPECIFIED removido para a classe de tipo enumerado ResponseModality. Em vez disso, use null.

• Vários métodos de builder Java foram alterados para retornar corretamente a instância da classe, em vez de void.

Web

Mudanças necessárias apenas se você estiver começando a usar a Gemini Developer API (em vez da Vertex AI Gemini API):

• Configurações de segurança

  • Uso removido de SafetySetting.method sem suporte.

• Dados inline

  • Uso removido de InlineDataPart.videoMetadata sem suporte.

Dart

Nenhuma mudança adicional.

Unity

O suporte ao Unity não estava disponível na "Vertex AI in Firebase".

Saiba como começar a usar o Firebase AI Logic SDK para Unity.