Firebase SDK'larındaki Vertex AI'ın GA sürümünden Firebase AI mantık SDK'larına geçiş

Swift

1. Xcode'da, uygulama projeniz açıkken Firebase paketinizi aşağıdaki seçeneklerden birini kullanarak v11.13.0 veya sonraki bir sürüme güncelleyin:

   • 1. seçenek: Tüm paketleri güncelleme: Dosya > Paketler > En Son Paket Sürümlerine Güncelle'ye gidin.

   • 2. seçenek: Firebase'i ayrı ayrı güncelleyin: Paket Bağımlılıkları bölümünde Firebase paketine gidin. Firebase paketini sağ tıklayın ve Paketi Güncelle'yi seçin.

2. Firebase paketinin artık v11.13.0 veya sonraki bir sürümü gösterdiğinden emin olun. Bu sürüm değilse belirttiğiniz Paket Şartları'nın v11.13.0 veya sonraki bir sürüme güncellenmeye izin verdiğini doğrulayın.

3. Proje Düzenleyici'de uygulamanızın hedefini seçin ve ardından Framework'ler, Kitaplıklar ve Yerleştirilmiş İçerik bölümüne gidin.

4. Yeni kitaplığı ekleyin: + düğmesini seçin ve ardından Firebase paketinden FirebaseAI'yı ekleyin.

5. Uygulamanızı taşımayı tamamladıktan sonra (bu kılavuzdaki kalan bölümlere bakın) eski kitaplığı kaldırdığınızdan emin olun:
   FirebaseVertexAI'ı seçin, ardından — düğmesine basın.

Kotlin

1. Modül (uygulama düzeyi) Gradle dosyanızda (genellikle <project>/<app-module>/build.gradle.kts veya <project>/<app-module>/build.gradle) eski bağımlılıkları (uygun olduğu şekilde) aşağıdakilerle değiştirin.

   Eski bağımlılığı silmeden önce uygulamanızın kod tabanını taşımak daha kolay olabilir (bu kılavuzdaki diğer bölümlere bakın).

   // 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.15.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. Android projenizi Gradle dosyalarıyla senkronize edin.

Firebase Android BoM kullanmamayı tercih ederseniz firebase-ai kitaplığının bağımlılığını eklemeniz ve Android Studio'nun önerdiği en son sürümü kabul etmeniz gerekir.

Java

1. Modül (uygulama düzeyi) Gradle dosyanızda (genellikle <project>/<app-module>/build.gradle.kts veya <project>/<app-module>/build.gradle) eski bağımlılıkları (uygun olduğu şekilde) aşağıdakilerle değiştirin.

   Eski bağımlılığı silmeden önce uygulamanızın kod tabanını taşımak daha kolay olabilir (bu kılavuzdaki diğer bölümlere bakın).

   // 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.15.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. Android projenizi Gradle dosyalarıyla senkronize edin.

Firebase Android BoM kullanmamayı tercih ederseniz firebase-ai kitaplığının bağımlılığını eklemeniz ve Android Studio'nun önerdiği en son sürümü kabul etmeniz gerekir.

Web

1. npm kullanarak web için Firebase JS SDK'sının en son sürümünü edinin:

   npm i firebase@latest

   VEYA

   yarn add firebase@latest

2. Kitaplığı içe aktardığınız her yerde, içe aktarma ifadelerinizi firebase/ai kullanacak şekilde güncelleyin.

   Eski içe aktarma işlemlerini silmeden önce uygulamanızın kod tabanını taşımanın daha kolay olabileceğini unutmayın (bu kılavuzdaki diğer bölümlere bakın).

   // 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. firebase_ai paketini pubspec.yaml dosyanızda kullanmak için Flutter proje dizininizden aşağıdaki komutu çalıştırarak güncelleyin:

   flutter pub add firebase_ai

2. Flutter projenizi yeniden oluşturun:

   flutter run

3. Uygulamanızı taşımayı tamamladıktan sonra (bu rehberdeki kalan bölümlere bakın) eski paketi sildiğinizden emin olun:

   flutter pub remove firebase_vertexai

Unity

Unity desteği "Vertex AI in Firebase" tarafından sağlanmıyordu.

Unity için Firebase AI Logic SDK'sını kullanmaya nasıl başlayacağınızı öğrenin.

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.5-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.5-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.5-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.5-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.5-flash');

Unity

Unity desteği "Vertex AI in Firebase" tarafından sağlanmıyordu.

Unity için Firebase AI Logic SDK'sını kullanmaya nasıl başlayacağınızı öğrenin.

Swift

Başka değişiklik yapılmadı.

Kotlin

• Live API

  • Enum sınıfı ResponseModality için UNSPECIFIED değeri kaldırıldı. Bunun yerine null kullanın.

Java

• Live API

  • Enum sınıfı ResponseModality için UNSPECIFIED değeri kaldırıldı. Bunun yerine null kullanın.

• Çeşitli Java oluşturucu yöntemleri, artık void yerine sınıflarının örneğini doğru şekilde döndürecek şekilde değiştirildi.

Web

Değişiklikler yalnızca Vertex AI Gemini API yerine Gemini Developer API kullanmaya başlıyorsanız gereklidir:

• Güvenlik ayarları

  • Desteklenmeyen SafetySetting.method kullanımı kaldırıldı.

• Satır içi veriler

  • Desteklenmeyen InlineDataPart.videoMetadata kullanımı kaldırıldı.

Dart

Başka değişiklik yapılmadı.

Unity

Unity desteği "Vertex AI in Firebase" tarafından sağlanmıyordu.

Unity için Firebase AI Logic SDK'sını kullanmaya nasıl başlayacağınızı öğrenin.