Firebase SDK'larındaki Vertex AI'ın önizleme sürümünden Firebase AI Logic SDK'larına geçiş yapma

Swift

1. Xcode'da, uygulama projeniz açıkken aşağıdaki seçeneklerden birini kullanarak Firebase paketinizi v12.5.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üncelleme: 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 v12.5.0 veya sonraki bir sürümü gösterdiğinden emin olun. Aksi takdirde, belirttiğiniz Paket Koşulları'nın v12.5.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 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 FirebaseAILogic'i 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-Preview'ı seçin ve — düğmesine basın.

Kotlin

1. Modülünüzün (uygulama düzeyinde) Gradle dosyasında (genellikle <project>/<app-module>/build.gradle.kts veya <project>/<app-module>/build.gradle), eski bağımlılıkları (geçerli olduğu durumlarda) aşağıdakilerle değiştirin.

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

   // 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.0.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 yalnızca firebase-ai kitaplığının bağımlılığını ekleyip Android Studio'nun önerdiği en yeni sürümü kabul etmeniz yeterlidir.

Java

1. Modülünüzün (uygulama düzeyinde) Gradle dosyasında (genellikle <project>/<app-module>/build.gradle.kts veya <project>/<app-module>/build.gradle), eski bağımlılıkları (geçerli olduğu durumlarda) aşağıdakilerle değiştirin.

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

   // 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.0.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 yalnızca firebase-ai kitaplığının bağımlılığını ekleyip Android Studio'nun önerdiği en yeni sürümü kabul etmeniz yeterlidir.

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 (bu kılavuzdaki diğer bölümlere bakın) daha kolay olabileceğini unutmayın.

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

   flutter pub add firebase_ai

2. Flutter projenizi yeniden oluşturun:

   flutter run

3. Uygulamanızı taşımayı tamamladıktan sonra (bu kılavuzdaki 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 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

Unity desteği "Vertex AI in Firebase" sürümünde kullanılamıyordu.

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

Swift

• Numaralandırmalar

  • Çoğu enum türü, statik değişkenlere sahip struct ile değiştirildi. Bu değişiklik, API'nin geriye dönük uyumlu bir şekilde geliştirilmesine daha fazla esneklik sağlar. switch ifadelerini kullanırken artık bilinmeyen veya işlenmemiş değerleri kapsayacak bir default: durumu eklemeniz gerekir. Bu duruma, gelecekte SDK'ya eklenecek yeni değerler de dahildir.

  • BlockThreshold numaralandırması HarmBlockThreshold olarak yeniden adlandırıldı. Bu tür artık struct.

  • Aşağıdaki numaralandırmalardan (artık struct) unknown ve unspecified durumları kaldırıldı: HarmCategory, HarmBlockThreshold, HarmProbability, BlockReason ve FinishReason.

  • Yeni türlerin geriye dönük uyumlu bir şekilde eklenmesine olanak tanımak için ModelContent.Part numaralandırması Part adlı bir protokolle değiştirildi. Bu değişiklik, İçerik bölümleri bölümünde daha ayrıntılı olarak açıklanmaktadır.

• İçerik bölümleri

  • ThrowingPartsRepresentable protokolü kaldırıldı ve ara sıra derleyici hatalarını önlemek için ModelContent başlatıcıları basitleştirildi. Düzgün şekilde kodlanmayan resimler, generateContent içinde kullanılırken hata vermeye devam eder.

  • ModelContent.Part durumları, Part protokolüne uygun aşağıdaki struct türleriyle değiştirildi:

    • .text - TextPart
    • .data - InlineDataPart
    • .fileData - FileDataPart
    • .functionCall - FunctionCallPart
    • .functionResponse - FunctionResponsePart

• Zarar kategorisi

  • HarmCategory türü, artık SafetySetting türünün içine yerleştirilmiyor. SafetySetting.HarmCategory olarak adlandırıyorsanız HarmCategory ile değiştirebilirsiniz.

• Güvenlik geri bildirimi

  • Yanıtların hiçbirinde kullanılmadığı için SafetyFeedback türü kaldırıldı.

• Alıntı meta verileri

  • citationSources mülkünün adını CitationMetadata içinde citations olarak değiştirdi.

• Faturalandırılabilir toplam karakter sayısı

  • Karakter gönderilmeyen durumları yansıtmak için CountTokensResponse içindeki totalBillableCharacters özelliği isteğe bağlı olarak değiştirildi.

• Aday yanıtı

  • Diğer platformlarla eşleşmesi için CandidateResponse, Candidate olarak yeniden adlandırıldı.

• Üretim yapılandırması

  • GenerationConfig adlı blogun herkese açık özelliklerini internal olarak değiştirdi. Bunların tümü başlatıcıda yapılandırılabilir.

Kotlin

• Numaralandırmalar

  • enum sınıfları ve sealed sınıfları normal sınıflarla değiştirildi. Bu değişiklik, API'nin geriye dönük uyumlu bir şekilde geliştirilmesine daha fazla esneklik sağlar.

  • BlockThreshold numaralandırması HarmBlockThreshold olarak yeniden adlandırıldı.

  • Aşağıdaki numaralandırmalardan değerler kaldırıldı: HarmBlockThreshold, HarmProbability, HarmSeverity, BlockReason ve FinishReason.

• Blob yöntemleri

  • Adlarında Blob bulunan tüm yöntemler, bunun yerine InlineData kullanılacak şekilde yeniden adlandırıldı.

• Güvenlik ayarları

  • method alanı boş bırakılabilir olarak değiştirildi.

• Süre sınıfı

  • Kotlin'in Duration sınıfının tüm kullanımları kaldırıldı ve long ile değiştirildi. Bu değişiklik, Java ile daha iyi birlikte çalışabilirlik sağlar.

• Alıntı meta verileri

  • CitationMetadata içinde daha önce tanımlanan tüm alanları Citation adlı yeni bir sınıfa sarmaladı. Alıntılar, CitationMetadata bölümündeki citations adlı listede yer alır. Bu değişiklik, platformlar arasında türlerin daha iyi eşleşmesini sağlar.

• Jetonları sayma

  • totalBillableCharacters alanı boş bırakılabilir olarak değiştirildi.

• Faturalandırılabilir toplam karakter sayısı

  • Karakter gönderilmeyen durumları yansıtmak için CountTokensResponse içindeki totalBillableCharacters özelliği isteğe bağlı olarak değiştirildi.

• Model oluşturma

  • Diğer platformlarla uyumlu olması için requestOptions parametresi, parametre listesinin sonuna taşındı.

• Live API

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

  • LiveGenerationConfig.setResponseModalities, LiveGenerationConfig.setResponseModality olarak yeniden adlandırıldı.

  • LiveContentResponse.Status sınıfı kaldırıldı ve bunun yerine durum alanları LiveContentResponse'nin özellikleri olarak iç içe yerleştirildi.

  • LiveContentResponse sınıfı kaldırıldı ve bunun yerine modelin yanıtlarıyla eşleşen LiveServerMessage alt sınıfları sağlandı.

  • LiveModelFutures.connect işlevi, ListenableFuture<LiveSession> yerine ListenableFuture<LiveSessionFutures> döndürecek şekilde değiştirildi.

Java

• Numaralandırmalar

  • enum sınıfları ve sealed sınıfları normal sınıflarla değiştirildi. Bu değişiklik, API'nin geriye dönük uyumlu bir şekilde geliştirilmesine daha fazla esneklik sağlar.

  • BlockThreshold numaralandırması HarmBlockThreshold olarak yeniden adlandırıldı.

  • Aşağıdaki numaralandırmalardan değerler kaldırıldı: HarmBlockThreshold, HarmProbability, HarmSeverity, BlockReason ve FinishReason.

• Blob yöntemleri

  • Adlarında Blob bulunan tüm yöntemler, bunun yerine InlineData kullanılacak şekilde yeniden adlandırıldı.

• Güvenlik ayarları

  • method alanı boş bırakılabilir olarak değiştirildi.

• Süre sınıfı

  • Kotlin'in Duration sınıfının tüm kullanımları kaldırıldı ve long ile değiştirildi. Bu değişiklik, Java ile daha iyi birlikte çalışabilirlik sağlar.

• Alıntı meta verileri

  • CitationMetadata içinde daha önce tanımlanan tüm alanları Citation adlı yeni bir sınıfa sarmaladı. Alıntılar, CitationMetadata bölümündeki citations adlı listede yer alır. Bu değişiklik, platformlar arasında türlerin daha iyi eşleşmesini sağlar.

• Jetonları sayma

  • totalBillableCharacters alanı boş bırakılabilir olarak değiştirildi.

• Faturalandırılabilir toplam karakter sayısı

  • Karakter gönderilmeyen durumları yansıtmak için CountTokensResponse içindeki totalBillableCharacters özelliği isteğe bağlı olarak değiştirildi.

• Model oluşturma

  • Diğer platformlarla uyumlu olması için requestOptions parametresi, parametre listesinin sonuna taşındı.

• Live API

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

  • LiveGenerationConfig.setResponseModalities, LiveGenerationConfig.setResponseModality olarak yeniden adlandırıldı.

  • LiveContentResponse.Status sınıfı kaldırıldı ve bunun yerine durum alanları LiveContentResponse'nin özellikleri olarak iç içe yerleştirildi.

  • LiveContentResponse sınıfı kaldırıldı ve bunun yerine modelin yanıtlarıyla eşleşen LiveServerMessage alt sınıfları sağlandı.

  • LiveModelFutures.connect işlevi, ListenableFuture<LiveSession> yerine ListenableFuture<LiveSessionFutures> döndürecek şekilde değiştirildi.

• Ç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

• Numaralandırmalar

  • Aşağıdaki numaralandırmalardan değerler kaldırıldı: HarmCategory, BlockThreshold, HarmProbability, HarmSeverity, BlockReason ve FinishReason.

• Engelleme nedeni

  • PromptFeedback içindeki blockReason alanı isteğe bağlı olarak değiştirildi.

Değişiklikler yalnızca Gemini Developer API (Agent Platform Gemini API (formerly Vertex AI) yerine) 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

• Numaralandırmalar

  • Aşağıdaki numaralandırmalardan değerler kaldırıldı: HarmCategory, HarmProbability, BlockReason ve FinishReason.

• Veri bölümü

  • Diğer platformlarla uyumlu olması için DataPart işlevi InlineDataPart, static data işlevi ise inlineData olarak yeniden adlandırıldı.

• İstek seçenekleri

  • timeout işlevsel olmadığı için RequestOptions kaldırıldı. Bu özellik yakın gelecekte yeniden eklenecek ancak diğer platformlarla eşleşmesi için GenerativeModel türüne taşınacak.

• Adım sıralarını durdurma

  • GenerationConfig içindeki stopSequences parametresi, boş bir dizi yerine isteğe bağlı olacak ve varsayılan olarak null olacak şekilde değiştirildi.

• Alıntılar

  • citationSources mülkünün adını CitationMetadata içinde citations olarak değiştirdi. CitationSource türü, diğer platformlarla eşleşmesi için Citation olarak yeniden adlandırıldı.

• Gereksiz genel türler, yöntemler ve özellikler

  • Aşağıdaki türler, yöntemler ve özellikler yanlışlıkla kullanıma sunulduğu için kaldırıldı: defaultTimeout, CountTokensResponseFields, parseCountTokensResponse, parseEmbedContentResponse, parseGenerateContentResponse, parseContent, BatchEmbedContentsResponse, ContentEmbedding, EmbedContentRequest ve EmbedContentResponse.

• Jetonları sayma

  • countTokens işlevinden artık gerekli olmayan ek alanlar kaldırıldı. Yalnızca contents gereklidir.

• Model oluşturma

  • Diğer platformlarla uyumlu olması için systemInstruction parametresi, parametre listesinin sonuna taşındı.

• Yerleştirme işlevi

  • Modelden desteklenmeyen yerleştirme işlevi (embedContent ve batchEmbedContents) kaldırıldı.

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.