Google AI istemci SDK'larından Firebase AI Logic SDK'larına geçiş yapma

Swift

Firebase bağımlılıklarını yüklemek ve yönetmek için Swift Package Manager'ı kullanın. Gerekirse diğer yükleme seçenekleri hakkında bilgi edinin.

Firebase AI Logic kitaplığı, Gemini modelleriyle etkileşim kurmak için API'lere erişim sağlar. Kitaplık, Apple platformları için Firebase SDK'sının (firebase-ios-sdk) bir parçası olarak dahil edilir.

Firebase'i zaten kullanıyorsanız Firebase paketinizin v12.5.0 veya sonraki bir sürüm olduğundan emin olun.

1. Xcode'da, uygulama projeniz açıkken File > Add Package Dependencies'e (Dosya > Paket Bağımlılıkları Ekle) gidin.

2. İstendiğinde Firebase Apple platformları SDK deposunu ekleyin:

   https://github.com/firebase/firebase-ios-sdk
   

3. En yeni SDK sürümünü seçin.

4. FirebaseAILogic kitaplığını ve FirebaseAppCheck kitaplığını seçin.

İşlem tamamlandığında Xcode, bağımlılıklarınızı arka planda otomatik olarak çözmeye ve indirmeye başlar.

Kotlin

Firebase AI Logic Android için SDK (firebase-ai), Gemini modelleriyle etkileşim kurmak için API'lere erişim sağlar.

Modülünüzün (uygulama düzeyinde) Gradle dosyasında (ör. <project>/<app-module>/build.gradle.kts), Android için Firebase AI Logic ve App Check kitaplıklarının bağımlılıklarını ekleyin. Kitaplık sürümünü kontrol etmek için Firebase Android BoM kullanmanızı öneririz.

dependencies {
  // ... other androidx dependencies

  // Import the BoM for the Firebase platform
  implementation(platform("com.google.firebase:firebase-bom:35.0.0"))

  // Add the dependencies for the Firebase AI Logic and App Check libraries
  // When using the BoM, you don't specify versions in Firebase library dependencies
  implementation("com.google.firebase:firebase-ai")
  implementation("com.google.firebase:firebase-appcheck-debug")
}

Firebase Android BoM öğesini kullanarak, uygulamanız her zaman Firebase Android kitaplıklarının uyumlu sürümlerini kullanır.

dependencies {
  // Add the dependencies for the Firebase AI Logic and App Check libraries
  // When NOT using the BoM, you must specify versions in Firebase library dependencies
  implementation("com.google.firebase:firebase-ai:18.0.0")
  implementation("com.google.firebase:firebase-appcheck-debug:20.0.0")
}

Java

Firebase AI Logic Android için SDK (firebase-ai), Gemini modelleriyle etkileşim kurmak için API'lere erişim sağlar.

Modülünüzün (uygulama düzeyinde) Gradle dosyasında (ör. <project>/<app-module>/build.gradle.kts), Android için Firebase AI Logic ve App Check kitaplıklarının bağımlılıklarını ekleyin. Kitaplık sürümünü kontrol etmek için Firebase Android BoM kullanmanızı öneririz.

Java için iki ek kitaplık eklemeniz gerekir.

dependencies {
  // ... other androidx dependencies

  // Import the BoM for the Firebase platform
  implementation(platform("com.google.firebase:firebase-bom:35.0.0"))

  // Add the dependencies for the Firebase AI Logic and App Check libraries
  // When using the BoM, you don't specify versions in Firebase library dependencies
  implementation("com.google.firebase:firebase-ai")
  implementation("com.google.firebase:firebase-appcheck-debug")

  // Required for one-shot operations (to use `ListenableFuture` from Guava Android)
  implementation("com.google.guava:guava:31.0.1-android")

  // Required for streaming operations (to use `Publisher` from Reactive Streams)
  implementation("org.reactivestreams:reactive-streams:1.0.4")
}

Firebase Android BoM öğesini kullanarak, uygulamanız her zaman Firebase Android kitaplıklarının uyumlu sürümlerini kullanır.

dependencies {
  // Add the dependencies for the Firebase AI Logic and App Check libraries
  // When NOT using the BoM, you must specify versions in Firebase library dependencies
  implementation("com.google.firebase:firebase-ai:18.0.0")
  implementation("com.google.firebase:firebase-appcheck-debug:20.0.0")
}

Web

Firebase AI Logic kitaplığı, Gemini modelleriyle etkileşim kurmak için API'lere erişim sağlar. Kitaplık, Web için Firebase JavaScript SDK'sının bir parçası olarak dahil edilir.

1. npm kullanarak web için Firebase JS SDK'sını yükleyin:

   npm install firebase
   

2. Uygulamanızda Firebase'i başlatın:

   import { initializeApp } from "firebase/app";
   import { initializeAppCheck, DebugProvider } from "firebase/app-check";
   
   // 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);
   

Dart

Flutter için Firebase AI Logic eklentisi (firebase_ai), Gemini modelleriyle etkileşim kurmak için API'lere erişim sağlar.

1. Flutter proje dizininizden Firebase AI Logic ve App Check eklentilerini yüklemek için aşağıdaki komutu çalıştırın:

   flutter pub add firebase_ai firebase_app_check
   

2. lib/main.dart dosyanızda Firebase AI Logic ve App Check eklentilerini içe aktarın:

   import 'package:firebase_core/firebase_core.dart';
   import 'package:firebase_ai/firebase_ai.dart';
   import 'package:firebase_app_check/firebase_app_check.dart';
   import 'firebase_options.dart';
   

3. Ayrıca lib/main.dart dosyanızda, yapılandırma dosyası tarafından dışa aktarılan DefaultFirebaseOptions nesnesini kullanarak Firebase'i başlattığınızdan emin olun:

   await Firebase.initializeApp(
     options: DefaultFirebaseOptions.currentPlatform,
   );
   

4. Flutter uygulamanızı yeniden oluşturun:

   flutter run
   

Unity

Unity desteği, Google AI istemci SDK'larında kullanılamıyordu.

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

Swift

Eski kitaplığı kaldırın:

1. Xcode'da uygulama projeniz açıkken Packages Dependencies (Paket Bağımlılıkları) bölmesine gidin.

2. Paket bağımlılıkları listesinden generative-ai-swift paketini seçin.

3. Listenin alt kısmındaki - düğmesini ve onaylamak için Kaldır'ı tıklayın.

Kotlin

dependencies {
    implementation("com.google.ai.client.generativeai:generativeai:VERSION")
}

Java

dependencies {
    implementation("com.google.ai.client.generativeai:generativeai:VERSION")
}

Web

// BEFORE
import { initializeApp } from "firebase/app";
import { GoogleGenerativeAI } from "@google/generative-ai";

Dart

Eski paketi silin:
flutter pub remove google_generative_ai

Unity

Unity desteği, Google AI istemci SDK'larında kullanılamıyordu.

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

Swift

// BEFORE
import GoogleGenerativeAI

let model = GenerativeModel(name: "MODEL_NAME", apiKey: APIKey.default)

// AFTER
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

// BEFORE
import com.google.ai.client.generativeai.Chat
import com.google.ai.client.generativeai.type.Content
import com.google.ai.client.generativeai.java.GenerativeModuleFutures

...

val generativeModel = GenerativeModel(modelName = "MODEL_NAME",
  // Access your API key as a Build Configuration variable
  apiKey = BuildConfig.apiKey
)

// AFTER
import com.google.firebase.Firebase
import com.google.firebase.ai.ai
import com.google.firebase.ai.type.GenerativeBackend

...

// 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

// BEFORE
import com.google.ai.client.generativeai.Chat;
import com.google.ai.client.generativeai.type.Content;
import com.google.ai.client.generativeai.java.GenerativeModuleFutures;

...

GenerativeModel gm = new GenerativeModel("MODEL_NAME",
  // Access your API key as a Build Configuration variable
  BuildConfig.apiKey
);

GenerativeModelFutures model = GenerativeModelFutures.from(gm);

// AFTER
import com.google.firebase.ai.FirebaseAI;
import com.google.firebase.ai.GenerativeModel;
import com.google.firebase.ai.java.GenerativeModelFutures;
import com.google.firebase.ai.type.GenerativeBackend;

...

// 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

// BEFORE
import { GoogleGenerativeAI } from "@google/generative-ai";

// Fetch your API_KEY and access your API
const API_KEY = "...";
const genAI = new GoogleGenerativeAI(API_KEY);

...

const model = genAI.getGenerativeModel({ model: "MODEL_NAME"});

// AFTER
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

// BEFORE
import 'package:google_generative_ai/google_generative_ai.dart';

final apiKey = Platform.environment['API_KEY'];
if (apiKey == null) {
print('No \$API_KEY environment variable');
exit(1);
}

final model = GenerativeModel(model: 'MODEL_NAME', apiKey: apiKey);

// AFTER
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, Google AI istemci SDK'larında 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ı.

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ı.

Web

JavaScript için Google AI istemci SDK'sında, Firebase AI Logic istemci SDK'larının ayrıldığı zamandan bu yana birçok değişiklik yapıldığını unutmayın. Aşağıdaki listede, Firebase AI Logic istemci SDK'larına geçerken dikkate almanız gerekebilecek bazı olası değişiklikler yer almaktadır.

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

• Arama Temellendirmesi (Search Grounding)

  • Bu özellik henüz Firebase AI Logic SDK'larında desteklenmediğinden bu özelliğin tüm kullanımları kaldırıldı.

• Hatalar

  • GoogleGenerativeAIError ile ilgili tüm kullanımlar kaldırıldı ve isteğe bağlı olarak AIError'a geçildi.

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, Google AI istemci SDK'larında kullanılamıyordu.

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