Migrar para os SDKs de lógica de IA do Firebase da versão de pré-lançamento 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 12.5.0 ou mais recente usando uma das seguintes opções:

   • Opção 1: atualize todos os pacotes: acesse File > Packages > Update to Latest Package Versions.

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

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

3. Selecione o destino do app no Editor de projetos e acesse a seção Frameworks, Libraries, and Embedded Content.

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

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

Kotlin

1. No arquivo 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.

   Talvez seja mais fácil migrar a base de código do app (consulte as seções restantes deste guia) antes de excluir a dependência antiga.

   // 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.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. 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 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.

   Talvez seja mais fácil migrar a base de código do app (consulte as seções restantes deste guia) antes de excluir a dependência antiga.

   // 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.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. 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. Instale a versão mais recente do SDK do Firebase para JS para Web usando o npm:

   npm i firebase@latest

   OU

   yarn add firebase@latest

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

   Pode ser mais fácil migrar a base de código do 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-preview";
   
   
   // 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 para o Unity não estava disponível em "Vertex AI in Firebase".

Saiba como começar a usar o SDK do 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

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

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

Swift

• Enumerações

  • Substituição da maioria dos tipos enum por structs com variáveis estáticas. Essa mudança permite mais flexibilidade para desenvolver a API de maneira compatível com versões anteriores. Ao usar instruções switch, agora é necessário incluir um caso default: para cobrir valores desconhecidos ou não processados, incluindo novos valores adicionados ao SDK no futuro.

  • A enumeração BlockThreshold foi renomeada como HarmBlockThreshold. Esse tipo agora é um struct.

  • Os casos unknown e unspecified foram removidos das seguintes enumerações (agora structs): HarmCategory, HarmBlockThreshold, HarmProbability, BlockReason e FinishReason.

  • Substituição da enumeração ModelContent.Part por um protocolo chamado Part para permitir que novos tipos sejam adicionados de maneira compatível com versões anteriores. Essa mudança é descrita em mais detalhes na seção Partes do conteúdo.

• Partes do conteúdo

  • O protocolo ThrowingPartsRepresentable foi removido, e os inicializadores de ModelContent foram simplificados para evitar erros ocasionais do compilador. As imagens que não forem codificadas corretamente ainda vão gerar erros quando forem usadas em generateContent.

  • Os casos ModelContent.Part foram substituídos pelos seguintes tipos struct em conformidade com o protocolo Part:

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

• Categoria de dano

  • Mudança de HarmCategory para que não seja mais aninhado no tipo SafetySetting. Se você se referir a ele como SafetySetting.HarmCategory, ele pode ser substituído por HarmCategory.

• Feedback de segurança

  • O tipo SafetyFeedback foi removido, já que não era usado em nenhuma das respostas.

• Metadados de citação

  • A propriedade citationSources foi renomeada como citations em CitationMetadata.

• Total de caracteres faturáveis

  • A propriedade totalBillableCharacters em CountTokensResponse foi alterada para ser opcional, refletindo situações em que nenhum caractere é enviado.

• Resposta candidata

  • Renomeamos CandidateResponse como Candidate para corresponder a outras plataformas.

• Configuração de geração

  • As propriedades públicas de GenerationConfig foram alteradas para internal. Todos eles permanecem configuráveis no inicializador.

Kotlin

• Enumerações

  • As classes enum e sealed foram substituídas por classes regulares. Essa mudança permite mais flexibilidade para desenvolver a API de maneira compatível com versões anteriores.

  • A enumeração BlockThreshold foi renomeada como HarmBlockThreshold.

  • Valores removidos das seguintes enumerações: HarmBlockThreshold, HarmProbability, HarmSeverity, BlockReason e FinishReason.

• Métodos de blob

  • Renomeação de todos os métodos que incluíam Blob como parte do nome para usar InlineData.

• Configurações de segurança

  • O campo method foi mudado para ser anulável.

• Classe de duração

  • Removemos todos os usos da classe Duration do Kotlin e os substituímos por long. Essa mudança oferece uma interoperabilidade melhor com o Java.

• Metadados de citação

  • Todos os campos declarados anteriormente em CitationMetadata foram agrupados em uma nova classe chamada Citation. As citações podem ser encontradas na lista chamada citations em CitationMetadata. Essa mudança permite um melhor alinhamento de tipos em todas as plataformas.

• Contar tokens

  • O campo totalBillableCharacters foi mudado para ser anulável.

• Total de caracteres faturáveis

  • A propriedade totalBillableCharacters em CountTokensResponse foi alterada para ser opcional, refletindo situações em que nenhum caractere é enviado.

• Como instanciar um modelo

  • O parâmetro requestOptions foi movido para o final da lista de parâmetros para se alinhar com outras plataformas.

• Live API

  • O valor UNSPECIFIED foi removido da classe de tipo enumerado ResponseModality. Em vez disso, use null.

  • LiveGenerationConfig.setResponseModalities foi renomeado como LiveGenerationConfig.setResponseModality.

  • A classe LiveContentResponse.Status foi removida, e os campos de status foram aninhados como propriedades de LiveContentResponse.

  • A classe LiveContentResponse foi removida e, em vez disso, foram fornecidas subclasses de LiveServerMessage que correspondem às respostas do modelo.

  • LiveModelFutures.connect foi alterado para retornar ListenableFuture<LiveSessionFutures> em vez de ListenableFuture<LiveSession>.

Java

• Enumerações

  • As classes enum e sealed foram substituídas por classes regulares. Essa mudança permite mais flexibilidade para desenvolver a API de maneira compatível com versões anteriores.

  • A enumeração BlockThreshold foi renomeada como HarmBlockThreshold.

  • Valores removidos das seguintes enumerações: HarmBlockThreshold, HarmProbability, HarmSeverity, BlockReason e FinishReason.

• Métodos de blob

  • Renomeação de todos os métodos que incluíam Blob como parte do nome para usar InlineData.

• Configurações de segurança

  • O campo method foi mudado para ser anulável.

• Classe de duração

  • Removemos todos os usos da classe Duration do Kotlin e os substituímos por long. Essa mudança oferece uma interoperabilidade melhor com o Java.

• Metadados de citação

  • Todos os campos declarados anteriormente em CitationMetadata foram agrupados em uma nova classe chamada Citation. As citações podem ser encontradas na lista chamada citations em CitationMetadata. Essa mudança permite um melhor alinhamento de tipos em todas as plataformas.

• Contar tokens

  • O campo totalBillableCharacters foi mudado para ser anulável.

• Total de caracteres faturáveis

  • A propriedade totalBillableCharacters em CountTokensResponse foi alterada para ser opcional, refletindo situações em que nenhum caractere é enviado.

• Como instanciar um modelo

  • O parâmetro requestOptions foi movido para o final da lista de parâmetros para se alinhar com outras plataformas.

• Live API

  • O valor UNSPECIFIED foi removido da classe de tipo enumerado ResponseModality. Em vez disso, use null.

  • LiveGenerationConfig.setResponseModalities foi renomeado como LiveGenerationConfig.setResponseModality.

  • A classe LiveContentResponse.Status foi removida, e os campos de status foram aninhados como propriedades de LiveContentResponse.

  • A classe LiveContentResponse foi removida e, em vez disso, foram fornecidas subclasses de LiveServerMessage que correspondem às respostas do modelo.

  • LiveModelFutures.connect foi alterado para retornar ListenableFuture<LiveSessionFutures> em vez de ListenableFuture<LiveSession>.

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

Web

• Enumerações

  • Valores removidos das seguintes enumerações: HarmCategory, BlockThreshold, HarmProbability, HarmSeverity, BlockReason e FinishReason.

• Motivo do bloqueio

  • Mudança de blockReason em PromptFeedback para ser opcional.

Mudanças necessárias somente se você estiver começando a usar o Gemini Developer API (em vez do Agent Platform Gemini API (formerly Vertex AI)):

• Configurações de segurança

  • Os usos do SafetySetting.method incompatível foram removidos.

• Dados inline

  • Os usos do InlineDataPart.videoMetadata incompatível foram removidos.

Dart

• Enumerações

  • Valores removidos das seguintes enumerações: HarmCategory, HarmProbability, BlockReason e FinishReason.

• Parte de dados

  • Renomeamos DataPart como InlineDataPart e a função static data como inlineData para alinhar com outras plataformas.

• Opções de solicitação

  • Remoção de RequestOptions, já que timeout não estava funcionando. Ele será adicionado novamente em breve, mas será movido para o tipo GenerativeModel para corresponder a outras plataformas.

• Sequências de parada

  • O parâmetro stopSequences em GenerationConfig foi alterado para ser opcional e usar null como padrão em vez de uma matriz vazia.

• Citações

  • A propriedade citationSources foi renomeada como citations em CitationMetadata. O tipo CitationSource foi renomeado como Citation para corresponder a outras plataformas.

• Tipos, métodos e propriedades públicos desnecessários

  • Os seguintes tipos, métodos e propriedades que foram expostos sem intenção foram removidos: defaultTimeout, CountTokensResponseFields, parseCountTokensResponse, parseEmbedContentResponse, parseGenerateContentResponse, parseContent, BatchEmbedContentsResponse, ContentEmbedding, EmbedContentRequest e EmbedContentResponse.

• Contar tokens

  • Campos extras que não são mais necessários foram removidos da função countTokens. Apenas contents é necessário.

• Como instanciar um modelo

  • O parâmetro systemInstruction foi movido para o final da lista de parâmetros para se alinhar com outras plataformas.

• Funcionalidade de incorporação

  • Remoção da funcionalidade de embedding não compatível (embedContent e batchEmbedContents) do modelo.

Unity

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

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