Migrer vers les SDK Firebase AI Logic depuis la version GA des SDK Vertex AI in Firebase

Swift

1. Dans Xcode, à partir de votre projet d'application ouvert, mettez à jour votre package Firebase vers la version 12.5.0 ou ultérieure à l'aide de l'une des options suivantes :

   • Option 1 : Mettez à jour tous les packages. Accédez à File > Packages > Update to Latest Package Versions (Fichier > Packages > Mettre à jour vers les dernières versions des packages).

   • Option 2 : mettez à jour Firebase individuellement. Accédez au package Firebase dans la section Package Dependencies (Dépendances des packages). Effectuez un clic droit sur le package Firebase, puis sélectionnez Update Package (Mettre à jour le package).

2. Assurez-vous que le package Firebase affiche désormais la version 12.5.0 ou une version ultérieure. Si ce n'est pas le cas, vérifiez que les exigences du package que vous avez spécifiées permettent de passer à la version 12.5.0 ou ultérieure.

3. Sélectionnez la cible de votre application dans l'éditeur de projet, puis accédez à la section Frameworks, Libraries, and Embedded Content (Frameworks, bibliothèques et contenu intégré).

4. Ajoutez la nouvelle bibliothèque : sélectionnez le bouton +, puis ajoutez FirebaseAILogic à partir du package Firebase.

5. Une fois la migration de votre application terminée (voir les sections restantes de ce guide), veillez à supprimer l'ancienne bibliothèque :
   Sélectionnez FirebaseVertexAI, puis appuyez sur le bouton —.

Kotlin

1. Dans le fichier Gradle de votre module (au niveau de l'application) (généralement <project>/<app-module>/build.gradle.kts ou <project>/<app-module>/build.gradle), remplacez les anciennes dépendances (le cas échéant) par les suivantes.

   Notez qu'il peut être plus facile de migrer le codebase de votre application (voir les sections restantes de ce guide) avant de supprimer l'ancienne dépendance.

   // 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. Synchronisez votre projet Android avec les fichiers Gradle.

Notez que si vous choisissez de ne pas utiliser Firebase Android BoM, il vous suffit d'ajouter la dépendance pour la bibliothèque firebase-ai et d'accepter la dernière version suggérée par Android Studio.

Java

1. Dans le fichier Gradle de votre module (au niveau de l'application) (généralement <project>/<app-module>/build.gradle.kts ou <project>/<app-module>/build.gradle), remplacez les anciennes dépendances (le cas échéant) par les suivantes.

   Notez qu'il peut être plus facile de migrer le codebase de votre application (voir les sections restantes de ce guide) avant de supprimer l'ancienne dépendance.

   // 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. Synchronisez votre projet Android avec les fichiers Gradle.

Notez que si vous choisissez de ne pas utiliser Firebase Android BoM, il vous suffit d'ajouter la dépendance pour la bibliothèque firebase-ai et d'accepter la dernière version suggérée par Android Studio.

Web

1. Obtenez la dernière version du SDK JS Firebase pour le Web à l'aide de npm :

   npm i firebase@latest

   OU

   yarn add firebase@latest

2. Partout où vous avez importé la bibliothèque, mettez à jour vos instructions d'importation pour utiliser firebase/ai à la place.

   Notez qu'il peut être plus facile de migrer le codebase de votre application (voir les sections restantes de ce guide) avant de supprimer les anciennes importations.

   // 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. Mettez à jour votre fichier pubspec.yaml pour utiliser le package firebase_ai en exécutant la commande suivante depuis le répertoire de votre projet Flutter :

   flutter pub add firebase_ai

2. Recompilez votre projet Flutter :

   flutter run

3. Une fois que vous avez terminé de migrer votre application (voir les sections restantes de ce guide), veillez à supprimer l'ancien package :

   flutter pub remove firebase_vertexai

Unity

La compatibilité avec Unity n'était pas disponible dans "Vertex AI in Firebase".

Découvrez comment faire vos premiers pas avec le SDK Firebase AI Logic pour 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

La compatibilité avec Unity n'était pas disponible dans "Vertex AI in Firebase".

Découvrez comment faire vos premiers pas avec le SDK Firebase AI Logic pour Unity.

Swift

Aucune modification supplémentaire.

Kotlin

• Live API

  • Suppression de la valeur UNSPECIFIED pour la classe d'énumération ResponseModality. Utilisez plutôt null.

Java

• Live API

  • Suppression de la valeur UNSPECIFIED pour la classe d'énumération ResponseModality. Utilisez plutôt null.

• Modification de différentes méthodes de compilateur Java pour qu'elles renvoient désormais correctement l'instance de leur classe, au lieu de "void".

Web

Modifications requises uniquement si vous commencez à utiliser Gemini Developer API (au lieu de Agent Platform Gemini API (formerly Vertex AI)) :

• Paramètres de sécurité

  • Suppression des utilisations de SafetySetting.method non compatible.

• Données intégrées

  • Suppression des utilisations de InlineDataPart.videoMetadata non compatible.

Dart

Aucune modification supplémentaire.

Unity

La compatibilité avec Unity n'était pas disponible dans "Vertex AI in Firebase".

Découvrez comment faire vos premiers pas avec le SDK Firebase AI Logic pour Unity.