Esegui la migrazione agli SDK Firebase AI Logic dalla versione GA degli SDK Vertex AI in Firebase

Swift

1. In Xcode, con il progetto dell'app aperto, aggiorna il pacchetto Firebase alla versione 12.5.0 o successive utilizzando una delle seguenti opzioni:

   • Opzione 1: aggiorna tutti i pacchetti. Vai a File > Packages > Update to Latest Package Versions (File > Pacchetti > Aggiorna alle ultime versioni dei pacchetti).

   • Opzione 2: aggiorna Firebase singolarmente. Vai al pacchetto Firebase nella sezione Package Dependencies (Dipendenze pacchetto). Fai clic con il tasto destro del mouse sul pacchetto Firebase, quindi seleziona Update Package (Aggiorna pacchetto).

2. Assicurati che il pacchetto Firebase mostri la versione 12.5.0 o successiva. In caso contrario, verifica che i requisiti del pacchetto specificati consentano l'aggiornamento alla versione 12.5.0 o successive.

3. Seleziona il target della tua app nell'editor di progetto, quindi vai alla sezione Framework, librerie e contenuti incorporati.

4. Aggiungi la nuova libreria: seleziona il pulsante + e poi aggiungi FirebaseAILogic dal pacchetto Firebase.

5. Dopo aver completato la migrazione dell'app (consulta le sezioni rimanenti di questa guida), assicurati di rimuovere la vecchia libreria:
   Seleziona FirebaseVertexAI, quindi premi il pulsante —.

Kotlin

1. Nel file Gradle del modulo (a livello di app) (solitamente <project>/<app-module>/build.gradle.kts o <project>/<app-module>/build.gradle), sostituisci le vecchie dipendenze (se applicabile) con le seguenti.

   Tieni presente che potrebbe essere più semplice eseguire la migrazione del codebase della tua app (consulta le sezioni rimanenti di questa guida) prima di eliminare la vecchia dipendenza.

   // 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. Sincronizza il tuo progetto Android con i file Gradle.

Tieni presente che se scegli di non utilizzare Firebase Android BoM, aggiungi semplicemente la dipendenza per la libreria firebase-ai e accetta l'ultima versione suggerita da Android Studio.

Java

1. Nel file Gradle del modulo (a livello di app) (solitamente <project>/<app-module>/build.gradle.kts o <project>/<app-module>/build.gradle), sostituisci le vecchie dipendenze (se applicabile) con le seguenti.

   Tieni presente che potrebbe essere più semplice eseguire la migrazione del codebase della tua app (consulta le sezioni rimanenti di questa guida) prima di eliminare la vecchia dipendenza.

   // 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. Sincronizza il tuo progetto Android con i file Gradle.

Tieni presente che se scegli di non utilizzare Firebase Android BoM, aggiungi semplicemente la dipendenza per la libreria firebase-ai e accetta l'ultima versione suggerita da Android Studio.

Web

1. Scarica l'ultima versione dell'SDK Firebase JS per il web utilizzando npm:

   npm i firebase@latest

   OPPURE

   yarn add firebase@latest

2. Ovunque tu abbia importato la libreria, aggiorna le istruzioni di importazione in modo che utilizzino firebase/ai.

   Tieni presente che potrebbe essere più semplice eseguire la migrazione del codebase della tua app (consulta le sezioni rimanenti di questa guida) prima di eliminare le vecchie importazioni.

   // 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. Esegui l'aggiornamento per utilizzare il pacchetto firebase_ai nel file pubspec.yaml eseguendo il seguente comando dalla directory del progetto Flutter:

   flutter pub add firebase_ai

2. Ricrea il progetto Flutter:

   flutter run

3. Dopo aver completato la migrazione dell'app (consulta le sezioni rimanenti di questa guida), assicurati di eliminare il vecchio pacchetto:

   flutter pub remove firebase_vertexai

Unity

Il supporto per Unity non era disponibile da "Vertex AI in Firebase".

Scopri come iniziare a utilizzare l'SDK Firebase AI Logic per Unity.

Swift

import FirebaseAILogic

// Initialize the Agent Platform Gemini API backend service (fomerly Vertex AI).
let ai = FirebaseAI.firebaseAI(backend: .agentPlatform())

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

Kotlin

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

Java

// Initialize the Agent Platform Gemini API backend service (formerly Vertex AI).
// Create a `GenerativeModel` instance with a model that supports your use case.
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.agentPlatform())
        .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, AgentPlatformBackend } 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 Agent Platform Gemini API backend service (formerly Vertex AI).
const ai = getAI(firebaseApp, { backend: new AgentPlatformBackend() });

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

Unity

Il supporto per Unity non era disponibile da "Vertex AI in Firebase".

Scopri come iniziare a utilizzare l'SDK Firebase AI Logic per Unity.

Swift

Nessuna modifica aggiuntiva.

Kotlin

• Live API

  • Valore UNSPECIFIED rimosso per la classe enum ResponseModality. Utilizza invece null.

Java

• Live API

  • Valore UNSPECIFIED rimosso per la classe enum ResponseModality. Utilizza invece null.

• Sono stati modificati vari metodi del builder Java in modo che ora restituiscano correttamente l'istanza della loro classe, anziché void.

Web

Modifiche necessarie solo se inizi a utilizzare Gemini Developer API (anziché Agent Platform Gemini API (formerly Vertex AI)):

• Impostazioni di sicurezza

  • Sono stati rimossi gli utilizzi di SafetySetting.method non supportato.

• Dati in linea

  • Sono stati rimossi gli utilizzi di InlineDataPart.videoMetadata non supportato.

Dart

Nessuna modifica aggiuntiva.

Unity

Il supporto per Unity non era disponibile da "Vertex AI in Firebase".

Scopri come iniziare a utilizzare l'SDK Firebase AI Logic per Unity.