Migrer vers les SDK Firebase AI Logic à partir de la version GA de Vertex AI dans les SDK Firebase

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Swift

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

   • Option 1: Mettre à 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: Mettre à jour Firebase individuellement: accédez au package Firebase dans la section Dépendances de package. Effectuez un clic droit sur le package Firebase, puis sélectionnez Mettre à jour le package.

2. Assurez-vous que le package Firebase indique désormais la version 11.13.0 ou ultérieure. Si ce n'est pas le cas, vérifiez que les exigences concernant les packages que vous avez spécifiées permettent la mise à niveau vers la version 11.13.0 ou ultérieure.

3. Sélectionnez la cible de votre application dans l'éditeur de projet, puis accédez à la section Cadres, bibliothèques et contenus intégrés.

4. Ajoutez la nouvelle bibliothèque: sélectionnez le bouton +, puis ajoutez FirebaseAI à 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 votre fichier Gradle de 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 éléments suivants.

   Notez qu'il peut être plus facile de migrer le code de base de votre application (voir les autres sections 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:33.14.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 votre fichier Gradle de 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 éléments suivants.

   Notez qu'il peut être plus facile de migrer le code de base de votre application (voir les autres sections 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:33.14.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. Dans tous les emplacements où vous avez importé la bibliothèque, modifiez vos instructions d'importation pour utiliser firebase/ai à la place.

   Notez qu'il peut être plus facile de migrer le code de base 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. Passez à l'utilisation du package firebase_ai dans votre fichier pubspec.yaml en exécutant la commande suivante à partir du répertoire de votre projet Flutter:

   flutter pub add firebase_ai

2. Recréez votre projet Flutter:

   flutter run

3. Une fois la migration de votre application terminée (voir les sections restantes de ce guide), veillez à supprimer l'ancien package:

   flutter pub remove firebase_vertexai

Unity

La prise en charge d'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 FirebaseAI

// 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-2.0-flash")

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-2.0-flash")

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-2.0-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, 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-2.0-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 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-2.0-flash');

Unity

La prise en charge d'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 diverses méthodes de création 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 Vertex AI Gemini API):

• Paramètres de sécurité

  • Suppression des utilisations de SafetySetting.method non compatibles.

• Données intégrées

  • Suppression des utilisations de InlineDataPart.videoMetadata non compatibles.

Dart

Aucune modification supplémentaire.

Unity

L'assistance pour Unity n'était pas disponible auprès de "Vertex AI in Firebase".

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