--- title: "Flutter SDK'yı yükle ve yapılandır" description: "Abonelik tabanlı uygulamalar için Flutter üzerinde Adapty SDK kurulumuna dair adım adım kılavuz." --- Adapty SDK, Flutter uygulamanıza sorunsuz entegrasyon için iki temel modül içerir: - **Core Adapty**: Adapty'nin uygulamanızda düzgün çalışması için zorunlu olan SDK. - **AdaptyUI**: Kolayca çapraz platform paywall'lar oluşturmaya yarayan, kod gerektirmeyen kullanıcı dostu araç [Adapty Paywall Builder](adapty-paywall-builder)'ı kullanıyorsanız ihtiyaç duyacağınız isteğe bağlı modül. :::tip Adapty SDK'nın bir mobil uygulamaya nasıl entegre edildiğini gerçek bir örnekle görmek ister misiniz? Paywall gösterme, satın alma yapma ve diğer temel işlevler dahil tam kurulumu sergileyen [örnek uygulamamıza](https://github.com/adaptyteam/AdaptySDK-Flutter/tree/master/example) göz atın. ::: ## Gereksinimler \{#requirements\} Adapty SDK iOS 13.0+ sürümünü destekler; ancak paywall builder ile oluşturulan paywall'larla düzgün çalışabilmesi için iOS 15.0+ gereklidir. :::info Adapty, Google Play Billing Library 8.x sürümüne kadar uyumludur. Varsayılan olarak Adapty, Google Play Billing Library v7.0.0 ile çalışır; ancak daha yeni bir sürümü zorlamak istiyorsanız [bağımlılığı manuel olarak ekleyebilirsiniz](https://developer.android.com/google/play/billing/integrate#dependency). ::: --- no_index: true --- import Callout from '../../../components/Callout.astro'; SDK'yı yüklemek, Adapty kurulumunun 5. adımıdır. Uygulamanızda satın almalar çalışmadan önce uygulamanızı mağazalara bağlamanız, ardından Adapty Kontrol Paneli'nde ürünler, bir paywall ve bir placement oluşturmanız gerekir. [Hızlı başlangıç kılavuzu](quickstart) tüm gerekli adımları anlatmaktadır. ## Adapty SDK'yı yükle \{#install-adapty-sdk\} [![Release](https://img.shields.io/github/v/release/adaptyteam/AdaptySDK-Flutter.svg?style=flat&logo=flutter)](https://github.com/adaptyteam/AdaptySDK-Flutter/releases) 1. `pubspec.yaml` dosyanıza Adapty'yi ekleyin: ```yaml showLineNumbers title="pubspec.yaml" dependencies: adapty_flutter: ^ ``` 2. Bağımlılıkları yüklemek için aşağıdaki komutu çalıştırın: ```bash showLineNumbers title="Terminal" flutter pub get ``` 3. Adapty SDK'larını uygulamanıza import edin: ```dart showLineNumbers title="main.dart" import 'package:adapty_flutter/adapty_flutter.dart'; ``` ## Adapty SDK'nın Adapty modülünü etkinleştir \{#activate-adapty-module-of-adapty-sdk\} Adapty SDK'yı uygulama kodunuzda etkinleştirin. :::note Adapty SDK, uygulamanızda yalnızca bir kez etkinleştirilmelidir. ::: **Public SDK Key**'inizi almak için: 1. Adapty Kontrol Paneli'ne gidin ve [**App settings → General**](https://app.adapty.io/settings/general) sayfasına geçin. 2. **Api keys** bölümünden **Public SDK Key**'i kopyalayın (Secret Key'i değil). 3. Koddaki `"YOUR_PUBLIC_SDK_KEY"` ifadesini bununla değiştirin. :::important - Adapty'yi başlatırken **Public SDK key** kullandığınızdan emin olun; **Secret key** yalnızca [sunucu tarafı API](getting-started-with-server-side-api) için kullanılmalıdır. - **SDK key**'leri her uygulama için benzersizdir; birden fazla uygulamanız varsa doğru olanı seçtiğinizden emin olun. ::: ```dart showLineNumbers title="main.dart" void main() { runApp(MyApp()); } class MyApp extends StatefulWidget { @override _MyAppState createState() => _MyAppState(); } class _MyAppState extends State { @override void initState() { _initializeAdapty(); super.initState(); } Future _initializeAdapty() async { try { await Adapty().activate( configuration: AdaptyConfiguration(apiKey: 'YOUR_PUBLIC_SDK_KEY'), ); } catch (e) { // handle the error } } Widget build(BuildContext context) { return Text("Hello"); } } ``` Şimdi uygulamanızda paywall'ları ayarlayın: - [Adapty Paywall Builder](adapty-paywall-builder) kullanıyorsanız önce aşağıdaki [AdaptyUI modülünü etkinleştir](#activate-adaptyui-module-of-adapty-sdk) adımını tamamlayın, ardından [Paywall Builder hızlı başlangıç kılavuzunu](flutter-quickstart-paywalls) izleyin. - Kendi paywall arayüzünüzü oluşturuyorsanız [özel paywall'lar için hızlı başlangıç kılavuzuna](flutter-quickstart-manual) bakın. ## Adapty SDK'nın AdaptyUI modülünü etkinleştirin \{#activate-adaptyui-module-of-adapty-sdk\} [Paywall Builder](adapty-paywall-builder) kullanmayı planlıyorsanız ve [AdaptyUI modülünü kurduysanız](sdk-installation-flutter#install-adapty-sdk), AdaptyUI'yi de etkinleştirmeniz gerekir: :::note AdaptyUI'ye ilişkin bağımlılıklar, AdaptyUI etkinleştirilmiş olsun ya da olmasın uygulamanıza bağlanır. ::: :::important Kodunuzda AdaptyUI'yi etkinleştirmeden önce önce Adapty'nin çekirdek modülünü etkinleştirmelisiniz. ::: ```dart showLineNumbers title="main.dart" await Adapty().activate( configuration: AdaptyConfiguration(apiKey: 'YOUR_PUBLIC_SDK_KEY') ..withActivateUI(true), // This automatically activates AdaptyUI ); ``` ## İsteğe bağlı kurulum \{#optional-setup\} ### Loglama \{#logging\} #### Log sistemini ayarla \{#set-up-the-logging-system\} Adapty, neler olduğunu anlamanıza yardımcı olmak için hataları ve diğer önemli bilgileri loglar. Kullanılabilir log seviyeleri şunlardır: | Seviye | Açıklama | | :----------------------- | :------------------------------------------------------------------------------------------------------------------------ | | `AdaptyLogLevel.none` | Hiçbir şey loglanmaz. Varsayılan değer | | `AdaptyLogLevel.error` | Yalnızca hatalar loglanır | | `AdaptyLogLevel.warn` | Hatalar ve kritik hatalara yol açmayan ancak dikkat edilmesi gereken SDK mesajları loglanır. | | `AdaptyLogLevel.info` | Hatalar, uyarılar ve çeşitli bilgilendirme mesajları loglanır. | | `AdaptyLogLevel.verbose` | Hata ayıklama sırasında yararlı olabilecek fonksiyon çağrıları, API sorguları gibi ek bilgiler loglanır. | Adapty'yi yapılandırmadan önce uygulamanızda log seviyesini ayarlayabilirsiniz: ```dart showLineNumbers title="main.dart" // Set log level before activation. // 'verbose' is recommended for development and the first production release await Adapty().setLogLevel(AdaptyLogLevel.verbose); // Or set it during configuration await Adapty().activate( configuration: AdaptyConfiguration(apiKey: 'YOUR_PUBLIC_SDK_KEY') ..withLogLevel(AdaptyLogLevel.verbose), ); ``` ### Veri politikaları \{#data-policies\} Adapty, siz açıkça göndermediğiniz sürece kullanıcılarınızın kişisel verilerini saklamaz; ancak mağaza veya ülke yönergelerine uymak için ek veri güvenliği politikaları uygulayabilirsiniz. #### IP adresi toplama ve paylaşmayı devre dışı bırak \{#disable-ip-address-collection-and-sharing\} Adapty modülünü etkinleştirirken, kullanıcı IP adresi toplama ve paylaşmayı devre dışı bırakmak için `ipAddressCollectionDisabled` değerini `true` olarak ayarlayın. Varsayılan değer `false`'tur. Bu parametreyi; kullanıcı gizliliğini artırmak, bölgesel veri koruma yönetmeliklerine (GDPR veya CCPA gibi) uymak ya da IP tabanlı özellikler uygulamanız için gerekli değilse gereksiz veri toplamayı azaltmak amacıyla kullanın. ```dart showLineNumbers title="main.dart" await Adapty().activate( configuration: AdaptyConfiguration(apiKey: 'YOUR_PUBLIC_SDK_KEY') ..withIpAddressCollectionDisabled(true), ); ``` #### Reklam kimliği toplama ve paylaşmayı devre dışı bırak \{#disable-advertising-id-collection-and-sharing\} Adapty modülünü etkinleştirirken, reklam tanımlayıcılarının toplanmasını devre dışı bırakmak için `appleIdfaCollectionDisabled` (iOS) veya `googleAdvertisingIdCollectionDisabled` (Android) değerini `true` olarak ayarlayın. Varsayılan değer `false`'tur. Bu parametreyi; App Store/Play Store politikalarına uymak, Uygulama İzleme Şeffaflığı istemini tetiklemekten kaçınmak ya da uygulamanız reklam kimliklerine dayalı attribution veya analitik gerektirmiyorsa kullanın. ```dart showLineNumbers title="main.dart" await Adapty().activate( configuration: AdaptyConfiguration(apiKey: 'YOUR_PUBLIC_SDK_KEY') ..withAppleIdfaCollectionDisabled(true) // iOS ..withGoogleAdvertisingIdCollectionDisabled(true), // Android ); ``` #### AdaptyUI için medya önbellek yapılandırmasını ayarla \{#set-up-media-cache-configuration-for-adaptyui\} Modül, Adapty SDK ile birlikte otomatik olarak etkinleştirilir. Paywall Builder kullanmıyor ve AdaptyUI modülünü devre dışı bırakmak istiyorsanız, etkinleştirme sırasında `withActivateUI(false)` değerini geçirin. Varsayılan olarak AdaptyUI, performansı artırmak ve ağ kullanımını azaltmak için medyayı (görseller ve videolar gibi) önbelleğe alır. Özel bir yapılandırma sağlayarak önbellek ayarlarını özelleştirebilirsiniz. Varsayılan önbellek boyutunu ve geçerlilik süresini değiştirmek için `withMediaCacheConfiguration` kullanın. Bu isteğe bağlıdır; bu yöntemi çağırmazsanız varsayılan değerler kullanılır (100 MB disk boyutu, sınırsız bellek sayısı). Ancak yapılandırmayı kullanırsanız tüm parametrelerin dahil edilmesi gerekir. ```dart showLineNumbers title="main.dart" final mediaCacheConfig = AdaptyUIMediaCacheConfiguration( memoryStorageTotalCostLimit: 200 * 1024 * 1024, // 200 MB memoryStorageCountLimit: 2147483647, // max int value diskStorageSizeLimit: 200 * 1024 * 1024, // 200 MB ); await Adapty().activate( configuration: AdaptyConfiguration(apiKey: 'YOUR_PUBLIC_SDK_KEY') ..withMediaCacheConfiguration(mediaCacheConfig), ); ``` **Parametreler:** | Parametre | Zorunluluk | Açıklama | |-----------------------------|------------|-----------------------------------------------------------------------------| | memoryStorageTotalCostLimit | isteğe bağlı | Bellekteki toplam önbellek boyutu (bayt cinsinden). Varsayılan 100 MB. | | memoryStorageCountLimit | isteğe bağlı | Bellek depolamasının öğe sayısı sınırı. Varsayılan maksimum int değeridir. | | diskStorageSizeLimit | isteğe bağlı | Diskteki dosya boyutu sınırı (bayt cinsinden). Varsayılan 100 MB. | ### Yerel access level'ları etkinleştir (Android) \{#enable-local-access-levels-android\} Varsayılan olarak [yerel access level'lar](local-access-levels) iOS'ta etkin, Android'de devre dışıdır. Android'de de etkinleştirmek için `withGoogleLocalAccessLevelAllowed` değerini `true` olarak ayarlayın: ```dart showLineNumbers title="main.dart" await Adapty().activate( configuration: AdaptyConfiguration(apiKey: 'YOUR_PUBLIC_SDK_KEY') ..withGoogleLocalAccessLevelAllowed(true), ); ``` ### Yedekten geri yüklemede veriyi temizle \{#clear-data-on-backup-restore\} `clearDataOnBackup` değeri `true` olarak ayarlandığında, SDK uygulamanın iCloud yedekten geri yüklendiğini algılar ve önbelleğe alınmış profil bilgileri, ürün ayrıntıları ve paywall'lar dahil yerel olarak depolanan tüm SDK verilerini siler. SDK ardından temiz bir durumla başlatılır. Varsayılan değer `false`'tur. :::note Yalnızca yerel SDK önbelleği silinir. Apple ile işlem geçmişi ve Adapty sunucularındaki kullanıcı verileri değişmez. ::: ```dart showLineNumbers title="main.dart" await Adapty().activate( configuration: AdaptyConfiguration(apiKey: 'YOUR_PUBLIC_SDK_KEY') ..withClearDataOnBackup(true) // default – false ); ``` ## Sorun Giderme \{#troubleshooting\} #### Android yedekleme kuralları (Otomatik Yedekleme yapılandırması) \{#android-backup-rules-auto-backup-configuration\} Bazı SDK'lar (Adapty dahil) kendi Android Auto Backup yapılandırmasını içerir. Yedekleme kurallarını tanımlayan birden fazla SDK kullanıyorsanız, Android manifest birleştirme işlemi `android:fullBackupContent`, `android:dataExtractionRules` veya `android:allowBackup` ile ilgili bir hatayla başarısız olabilir. Tipik hata belirtileri: `Manifest merger failed: Attribute application@dataExtractionRules value=(@xml/your_data_extraction_rules) is also present at [com.other.sdk:library:1.0.0] value=(@xml/other_sdk_data_extraction_rules)` :::note Bu değişiklikler Android platform dizininizde yapılmalıdır (genellikle projenizin `android/` klasöründe bulunur). ::: Sorunu çözmek için şunları yapmanız gerekir: - Manifest birleştirme işlemine, yedeklemeyle ilgili özellikler için uygulamanızın değerlerini kullanmasını söyleyin. - Adapty'nin kurallarını diğer SDK'ların kurallarıyla birleştiren yedekleme kuralı dosyaları oluşturun. #### 1. Manifestinize `tools` ad alanını ekleyin \{#1-add-the-tools-namespace-to-your-manifest\} `AndroidManifest.xml` dosyanızda, kök `` etiketinin tools içerdiğinden emin olun: ```xml ... ``` #### 2. `` içinde yedekleme özelliklerini geçersiz kılın \{#2-override-backup-attributes-in-application\} Aynı `AndroidManifest.xml` dosyasında, `` etiketini güncelleyerek uygulamanızın nihai değerleri sağlamasını ve manifest birleştirme işlemine kütüphane değerlerini değiştirmesini söyleyin: ```xml ... ``` Herhangi bir SDK de `android:allowBackup` ayarlıyorsa, bunu `tools:replace` içine ekleyin: ```xml tools:replace="android:allowBackup,android:fullBackupContent,android:dataExtractionRules" ``` #### 3. Birleştirilmiş yedekleme kuralı dosyaları oluşturun \{#3-create-merged-backup-rules-files\} Android projenizin `res/xml/` dizininde, Adapty'nin kurallarını diğer SDK'ların kurallarıyla birleştiren XML dosyaları oluşturun. Android, işletim sistemi sürümüne bağlı olarak farklı yedekleme kuralı formatları kullandığından, her iki dosyayı da oluşturmak uygulamanızın desteklediği tüm Android sürümleriyle uyumluluk sağlar. :::note Aşağıdaki örneklerde örnek bir üçüncü taraf SDK olarak AppsFlyer kullanılmaktadır. Uygulamanızda kullandığınız diğer SDK'lar için kuralları değiştirin veya ekleyin. ::: **Android 12 ve üzeri için** (yeni veri çıkarma kuralları formatını kullanır): ```xml title="sample_data_extraction_rules.xml" ``` **Android 11 ve altı için** (eski tam yedekleme içeriği formatını kullanır): ```xml title="sample_backup_rules.xml" #### Android'de başka bir uygulamadan döndükten sonra satın almalar başarısız oluyor \{#purchases-fail-after-returning-from-another-app-in-android\} Satın alma akışını başlatan Activity, varsayılan olmayan bir `launchMode` kullanıyorsa, kullanıcı Google Play'den, bir bankacılık uygulamasından veya tarayıcıdan geri döndüğünde Android bu Activity'yi hatalı şekilde yeniden oluşturabilir ya da yeniden kullanabilir. Bu durum, satın alma sonucunun kaybolmasına veya iptal edilmiş olarak değerlendirilmesine yol açabilir. Satın almaların düzgün çalışmasını sağlamak için, satın alma akışını başlatan Activity'de yalnızca `standard` veya `singleTop` başlatma modlarını kullanın; diğer modlardan kaçının. `AndroidManifest.xml` dosyanızda, satın alma akışını başlatan Activity'nin `standard` veya `singleTop` olarak ayarlandığından emin olun: ```xml ``` #### Podfile SWIFT_VERSION geçersiz kılmasının neden olduğu Swift 6 derleme hataları \{#swift-6-build-errors-caused-by-podfile-swift_version-override\} Flutter uygulamanızı iOS için derlerken Adapty pod hedeflerinde Swift 6 derleme hataları görebilirsiniz. Tipik belirtiler arasında `AdaptyUIBuilderLogic` içinde `@Sendable` uyumsuzlukları, Adapty türlerinde eksik `Sendable` uyumu veya aktör izolasyon hataları yer alır. Adapty pod'ları `s.swift_version = '6.0'` bildirimi yapar ve derlemek için Swift 6 gerektirir. Kendi uygulama kodunuz Swift 5'te kalabilir — yalnızca Adapty pod hedeflerinin (`Adapty`, `AdaptyUI`, `AdaptyUIBuilder`, `AdaptyLogger`, `AdaptyPlugin`) Swift 6 ile derlenmesi gerekir. En yaygın neden, `ios/Podfile` dosyasındaki her pod hedefi için `SWIFT_VERSION` değerini yeniden yazan bir `post_install` kancasıdır: ```ruby showLineNumbers title="ios/Podfile" post_install do |installer| installer.pods_project.targets.each do |target| target.build_configurations.each do |config| config.build_settings['SWIFT_VERSION'] = '5.9' end end end ``` **Düzeltme**: Adapty pod hedeflerini bu geçersiz kılmanın dışında tutun: ```ruby showLineNumbers title="ios/Podfile" post_install do |installer| installer.pods_project.targets.each do |target| next if %w[Adapty AdaptyUI AdaptyUIBuilder AdaptyLogger AdaptyPlugin].include?(target.name) target.build_configurations.each do |config| config.build_settings['SWIFT_VERSION'] = '5.9' end end end ``` Ardından `ios/` dizininden `pod install` komutunu çalıştırın ve yeniden derleyin. Doğrulamak için `ios/Pods/Pods.xcodeproj` dosyasını açın, `Adapty` pod hedefini seçin → **Build Settings** → **Swift Language Version**. Değerin **Swift 6** olması gerekir.