Adapty React Native SDK'yı Expo projesine kurma ve yapılandırma

Adapty SDK’yı Expo’ya kurma

Adapty SDK çalışabilmesi için native modüllere ihtiyaç duyduğundan, Expo Go ile kullanılamaz. Bunun yerine geliştirme için Expo Dev Client kullanmanız gerekir.

1. Adapty paketlerini yükleme

Projenizin kök dizininde aşağıdaki komutu çalıştırın:

npx expo install react-native-adapty

2. Expo config plugin’ini yapılandırma

Adapty’nin Expo config plugin’ini app.json veya app.config.js dosyanıza ekleyin:

{
  "expo": {
    "plugins": [
      "react-native-adapty"
    ]
  }
}

3. Native projeyi yeniden derleme

Config plugin’ini ekledikten sonra native projeyi yeniden derlemeniz gerekir:

npx expo prebuild --clean

Ardından uygulamanızı çalıştırın:

npx expo run:ios

npx expo run:android

Adapty SDK’yı yapılandırma

Public SDK Key’inizi almak için:

1. Adapty Kontrol Paneli’ne gidin ve App settings → General sayfasına gidin.
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 değiştirin.

Ya da Adapty CLI kullanarak programatik olarak alın:

npm install -g adapty
adapty auth login
adapty apps list

Ya da doğrudan:

npx adapty auth login
adapty apps list

• Adapty başlatma işlemi için Public SDK key kullandığınızdan emin olun; Secret key yalnızca sunucu taraflı API için kullanılmalıdır.
• SDK key’leri her uygulama için benzersizdir, bu nedenle birden fazla uygulamanız varsa doğru olanı seçtiğinizden emin olun.

Adapty SDK’yı yapılandırmak için activate metodunu uygulama başlangıcında çağırın:

activateAdapty({ apiKey: 'PUBLIC_SDK_KEY' });

PUBLIC_SDK_KEY değerini kendi Adapty public SDK anahtarınızla değiştirdiğinizden emin olun.

Yedekleme kuralları

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)

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

AndroidManifest.xml dosyanızda, kök <manifest> etiketinin tools içerdiğinden emin olun:

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
package="com.example.app">

    ...
</manifest>

2. <application> içinde yedekleme özelliklerini geçersiz kılın

Aynı AndroidManifest.xml dosyasında, <application> 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:

<application
android:name=".App"
android:allowBackup="true"
android:fullBackupContent="@xml/sample_backup_rules"           
android:dataExtractionRules="@xml/sample_data_extraction_rules"
tools:replace="android:fullBackupContent,android:dataExtractionRules">

    ...
</application>

Herhangi bir SDK de android:allowBackup ayarlıyorsa, bunu tools:replace içine ekleyin:

tools:replace="android:allowBackup,android:fullBackupContent,android:dataExtractionRules"

3. Birleştirilmiş yedekleme kuralı dosyaları oluşturun

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.

Android 12 ve üzeri için (yeni veri çıkarma kuralları formatını kullanır):

<?xml version="1.0" encoding="utf-8"?>
<data-extraction-rules>
    <cloud-backup>
        
        <exclude domain="sharedpref" path="appsflyer-data"/>
        <exclude domain="sharedpref" path="appsflyer-purchase-data"/>
        <exclude domain="database" path="afpurchases.db"/>
        
        <exclude domain="sharedpref" path="AdaptySDKPrefs.xml"/>
    </cloud-backup>

    <device-transfer>
        
        <exclude domain="sharedpref" path="appsflyer-data"/>
        <exclude domain="sharedpref" path="appsflyer-purchase-data"/>
        <exclude domain="database" path="afpurchases.db"/>
        <exclude domain="sharedpref" path="AdaptySDKPrefs.xml"/>
    </device-transfer>
</data-extraction-rules>

Android 11 ve altı için (eski tam yedekleme içeriği formatını kullanır):

<?xml version="1.0" encoding="utf-8"?>
<full-backup-content>
    
    <exclude domain="sharedpref" path="appsflyer-data"/>

    
    <exclude domain="sharedpref" path="AdaptySDKPrefs.xml"/>

    

Örnek uygulama

Adapty SDK, React Native uygulamanıza sorunsuz entegrasyon için iki temel modül içerir:

• Core Adapty: Bu modül, Adapty’nin uygulamanızda düzgün çalışması için gereklidir.
• AdaptyUI: Bu modül, platformlar arası paywall’lar oluşturmak için kullanılan, kod gerektirmeyen kullanıcı dostu bir araç olan Adapty Paywall Builder’ı kullanıyorsanız gereklidir. AdaptyUI, core modülüyle birlikte otomatik olarak etkinleştirilir.

React Native uygulamanızda uygulama içi satın alma (IAP) entegrasyonunun nasıl yapılacağına dair kapsamlı bir rehber arıyorsanız şuraya göz atabilirsiniz.

Eksiksiz bir uygulama adım adım anlatımı için şu videoyu da izleyebilirsiniz:

Gereksinimler

Adapty React Native SDK, iOS 15.0+ gerektirir.

iOS için derleme yapmak Swift 6.0 veya sonrasını gerektirir. Kids Mode Swift 6.1 veya sonrasını gerektirir.

Adapty SDK’yı yükleyin

1. Adapty SDK’yı yükleyin (bu, @adapty/core’u da otomatik olarak yükler):

   npx expo install react-native-adapty
   npx expo prebuild

2. Uygulamanızı EAS veya yerel derleme kullanarak geliştirme için derleyin:

   # For iOS
   eas build --profile development --platform ios
   
   # For Android
   eas build --profile development --platform android

   # For iOS
   npx expo run:ios
   
   # For Android
   npx expo run:android

3. Geliştirme sunucusunu başlatın:

   npx expo start --dev-client

Adapty SDK 4.0 (beta): Swift Package Manager’ı etkinleştirme

Flow Builder desteği ekleyen React Native SDK 4.0, React Native 0.75 veya sonrasını gerektiren bir ön sürümdür. Tam sürümü yükleyin (npm, ön sürümleri caret/tilde aralıkları üzerinden çözümlemez):

npx expo install react-native-adapty@4.0.0-beta.1

v4, yerel iOS SDK’larını (Adapty, AdaptyUI, AdaptyPlugin) CocoaPods alt bağımlılıkları yerine Swift Package Manager aracılığıyla çeker (CocoaPods’un spec deposu Aralık 2026’da salt okunur hâle geliyor). SPM dinamik framework’ler gerektirir; bunları Expo’da expo-build-properties eklentisiyle etkinleştirirsiniz. Bunu app.json (veya app.config.js) dosyasına ekleyin:

{
  "expo": {
    "plugins": [
      [
        "expo-build-properties",
        {
          "ios": {
            "useFrameworks": "dynamic"
          }
        }
      ]
    ]
  }
}

Ardından eklentiyi yükleyin ve yerel projeyi yeniden oluşturun:

npx expo install expo-build-properties
npx expo prebuild --clean

Tam geçiş için bkz. Adapty React Native SDK’yı v4’e geçirme.

Adapty SDK’nın Adapty modülünü etkinleştirme

Public SDK Key’inizi almak için:

1. Adapty Kontrol Paneli’ne gidin ve App settings → General sayfasına gidin.
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 değiştirin.

Ya da Adapty CLI kullanarak programatik olarak alın:

npm install -g adapty
adapty auth login
adapty apps list

Ya da doğrudan:

npx adapty auth login
adapty apps list

• Adapty başlatma işlemi için Public SDK key kullandığınızdan emin olun; Secret key yalnızca sunucu taraflı API için kullanılmalıdır.
• SDK key’leri her uygulama için benzersizdir, bu nedenle birden fazla uygulamanız varsa doğru olanı seçtiğinizden emin olun.

Adapty’yi etkinleştirmek için aşağıdaki kodu App.tsx dosyasına kopyalayın:

adapty.activate('YOUR_PUBLIC_SDK_KEY');

Şimdi uygulamanızda paywallları ayarlayın:

• Adapty Paywall Builder kullanıyorsanız, Paywall Builder hızlı başlangıç kılavuzunu takip edin.
• Kendi paywall arayüzünüzü oluşturuyorsanız, özel paywall’lar için hızlı başlangıç kılavuzuna bakın.

Adapty SDK’nın AdaptyUI modülünü etkinleştirin

Paywall Builder kullanmayı planlıyorsanız AdaptyUI modülüne ihtiyacınız olacaktır. Core modülü etkinleştirdiğinizde otomatik olarak etkinleştirilir; başka bir şey yapmanıza gerek yoktur.

İsteğe bağlı kurulum

Günlükleme

Günlük sistemini ayarlayın

Adapty, neler olduğunu anlamanıza yardımcı olmak için hataları ve diğer önemli bilgileri kaydeder. Aşağıdaki seviyeler mevcuttur:

// Set log level before activation
// 'verbose' is recommended for development and the first production release
adapty.setLogLevel('verbose');

// Or set it during configuration
adapty.activate('YOUR_PUBLIC_SDK_KEY', {
  logLevel: 'verbose',
});

Veri politikaları

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şımını devre dışı bırakma

Adapty modülünü etkinleştirirken, kullanıcı IP adresi toplama ve paylaşımını devre dışı bırakmak için ipAddressCollectionDisabled değerini true olarak ayarlayın. Varsayılan değer false’tur. Kullanıcı gizliliğini artırmak, bölgesel veri koruma düzenlemelerine (GDPR veya CCPA gibi) uymak ya da IP tabanlı özellikler uygulamanız için gerekli değilse gereksiz veri toplamayı azaltmak için bu parametreyi kullanabilirsiniz.

adapty.activate('YOUR_PUBLIC_SDK_KEY', {
  ipAddressCollectionDisabled: true,
});

Reklam kimliği toplama ve paylaşımını devre dışı bırakma

Adapty modülünü etkinleştirirken, reklam tanımlayıcılarının toplanmasını devre dışı bırakmak için ios.idfaCollectionDisabled (iOS) veya android.adIdCollectionDisabled (Android) değerini true olarak ayarlayın. Varsayılan değer false’tur.

Bu parametreyi; App Store/Play Store politikalarına uymak, App Tracking Transparency isteğini tetiklemekten kaçınmak veya uygulamanız reklam ID’lerine dayalı attribution ya da analitik gerektirmiyorsa kullanabilirsiniz.

adapty.activate('YOUR_PUBLIC_SDK_KEY', {
  ios: {
    idfaCollectionDisabled: true,
  },
  android: {
    adIdCollectionDisabled: true,
  },
});

AdaptyUI için medya önbelleği yapılandırmasını ayarlama

AdaptyUI, performansı artırmak ve ağ kullanımını azaltmak için medyayı (resimler ve videolar gibi) varsayılan olarak önbelleğe alır. Özel bir yapılandırma sağlayarak önbellek ayarlarını özelleştirebilirsiniz.

Varsayılan önbellek ayarlarını geçersiz kılmak için mediaCache kullanın:

adapty.activate('YOUR_PUBLIC_SDK_KEY', {
  mediaCache: {
    memoryStorageTotalCostLimit: 200 * 1024 * 1024, // Optional: memory cache size in bytes
    memoryStorageCountLimit: 2147483647,            // Optional: max number of items in memory
    diskStorageSizeLimit: 200 * 1024 * 1024,       // Optional: disk cache size in bytes
  },
});

Yerel access level’ları etkinleştirin (Android)

Varsayılan olarak yerel access level’lar iOS’ta etkin, Android’de devre dışıdır. Android’de de etkinleştirmek için localAccessLevelAllowed değerini true olarak ayarlayın:

adapty.activate('YOUR_PUBLIC_SDK_KEY', {
  android: {
     localAccessLevelAllowed: true,
  },
});

Yedekten geri yüklemede verileri temizleyin

clearDataOnBackup değeri true olarak ayarlandığında SDK, uygulamanın bir iCloud yedeğinden geri yüklendiğini algılar ve önbelleğe alınmış profil bilgileri, ürün ayrıntıları ve paywalllar dahil olmak üzere yerel olarak depolanan tüm SDK verilerini siler. SDK ardından temiz bir durumla başlatılır. Varsayılan değer false’tur.

adapty.activate('YOUR_PUBLIC_SDK_KEY', {
   ios: {
       clearDataOnBackup: true
   },
});

Geliştirme ortamı ipuçları

Expo Go / Expo Web için mock mod kurulumu

Expo Go ve Expo Web ortamları, Adapty’nin native modüllerine erişemez. Uygulamanızın arayüzünü ve paywall mantığını geliştirip test edebilmek için çalışma zamanı hatalarından kaçınmak amacıyla Adapty, mock mod sunar.

Varsayılan olarak, SDK Expo Go ve web ortamlarını otomatik olarak algılar ve sahte mod’u etkinleştirir. Sahte verileri özelleştirmek istemiyorsanız herhangi bir yapılandırma yapmanıza gerek yoktur.

Sahte mod etkinken:

• Tüm Adapty metodları, Adapty sunucularına ağ isteği göndermeksizin sahte veriler döndürür.
• Varsayılan olarak, başlangıçtaki sahte profilin aktif aboneliği yoktur.
• Varsayılan olarak, makePurchase(...) başarılı bir satın alma işlemini simüle eder ve premium erişim sağlar. Aktivasyon sırasında mockConfig kullanarak mock verileri özelleştirebilirsiniz. Konfigürasyon formatı ve desteklenen parametreler için buraya bakın.

try {
  await adapty.activate('YOUR_PUBLIC_SDK_KEY', {
    mockConfig: {
      // Customize the initial mock profile (optional)
    },
  });
} catch (error) {
  console.error('Failed to activate Adapty SDK:', error);
}

SDK metodlarını aktivasyondan önce çağırmanız gerekiyorsa (örneğin isActivated() veya setLogLevel()), activate() öncesinde enableMock() kullanın. Bridge zaten başlatılmışsa bu metod hiçbir şey yapmaz.

adapty.enableMock(); // İsteğe bağlı: mock verilerini özelleştirmek için mockConfig geçebilirsiniz

// Artık aktivasyondan önce metodları çağırabilirsiniz

await adapty.activate('YOUR_PUBLIC_SDK_KEY');

Geliştirme amacıyla SDK aktivasyonunu geciktirme

Adapty, SDK etkinleştirildiğinde tüm gerekli kullanıcı verilerini önceden alarak daha hızlı ve güncel veri erişimi sağlar.

Ancak bu durum, geliştirme sırasında sıkça kimlik doğrulama isteyen iOS simülatöründe sorun çıkarabilir. Adapty, StoreKit kimlik doğrulama akışını kontrol edemese de SDK’nın güncel kullanıcı verisi almak için yaptığı istekleri erteleyebilir.

__debugDeferActivation özelliğini etkinleştirdiğinizde, activate çağrısı bir sonraki Adapty SDK çağrısına kadar bekletilir. Bu sayede kimlik doğrulama verisi gerekmiyorsa gereksiz istemlerle karşılaşmazsınız. Bu özelliğin yalnızca geliştirme amaçlı kullanım için tasarlandığını belirtmek önemlidir; zira tüm olası kullanıcı senaryolarını kapsamaz. Üretim ortamında aktivasyon geciktirilmemelidir; gerçek cihazlar genellikle kimlik doğrulama verilerini hatırlar ve kullanıcıdan tekrar tekrar kimlik bilgisi girmesini istemez.

Kullanım için önerilen yaklaşım şöyledir:

try {
  adapty.activate('PUBLIC_SDK_KEY', {
    __debugDeferActivation: isSimulator(), // 'isSimulator' herhangi bir 3. parti kütüphaneden
  });
} catch (error) {
  console.error('Adapty SDK etkinleştirilemedi:', error);
  // Uygulamanız için hatayı uygun şekilde ele alın
}

React Native’in Fast Refresh özelliğinde SDK etkinleştirme hatalarını giderme

Adapty SDK ile React Native üzerinde geliştirme yaparken şu hatayla karşılaşabilirsiniz: Adapty can only be activated once. Ensure that the SDK activation call is not made more than once. Bu durum, React Native’in hızlı yenileme (fast refresh) özelliğinin geliştirme sırasında birden fazla aktivasyon çağrısını tetiklemesinden kaynaklanır. Bunu önlemek için __ignoreActivationOnFastRefresh seçeneğini __DEV__ (React Native’in geliştirme modu bayrağı) olarak ayarlayın.

try {
  adapty.activate('PUBLIC_SDK_KEY', {
    __ignoreActivationOnFastRefresh: __DEV__,
  });
} catch (error) {
  console.error('Failed to activate Adapty SDK:', error);
  // Handle the error appropriately for your app
}

Sorun giderme

Minimum iOS sürümü hatası

iOS için derleme yaparken, minimum iOS sürümü veya dağıtım hedefiyle ilgili bir hata görebilirsiniz. Adapty iOS 15.0+ gerektirir.

Expo, iOS projesini (Podfile dahil) expo prebuild sırasında oluşturduğundan, Podfile’ı doğrudan düzenlememelisiniz. Bunun yerine, dağıtım hedefini expo-build-properties yapılandırma eklentisi aracılığıyla ayarlayın.

1. Eklentiyi yükleyin:

   npx expo install expo-build-properties

2. iOS dağıtım hedefini ayarlamak için Expo yapılandırmanızı (app.json veya app.config.js) güncelleyin:

{
    "expo": {
        // ...other Expo config...
        "plugins": [
            [
                "expo-build-properties",
                {
                    "ios": {
                        // Adapty requires iOS 15.0+.
                        "deploymentTarget": "15.0"
                    }
                }
            ],
        ]
    }
}

3. Yerel iOS projesini yeniden oluşturun ve yeniden derleyin:

npx expo prebuild --clean
npx expo run:ios      # or `eas build -p ios` on your CI

Android Auto Backup manifest çakışması

Android Auto Backup’ı yapılandıran birden fazla SDK (Adapty, AppsFlyer veya expo-secure-store gibi) ile Expo kullanırken, bir manifest birleştirme çakışmasıyla karşılaşabilirsiniz.

Tipik bir hata şöyle görünür: Manifest merger failed : Attribute application@fullBackupContent value=(@xml/secure_store_backup_rules) from AndroidManifest.xml:24:248-306 is also present at [io.adapty:android-sdk:3.12.0] AndroidManifest.xml:9:18-70 value=(@xml/adapty_backup_rules).

Bu çakışmayı çözmek için Adapty eklentisinin Android yedekleme yapılandırmasını yönetmesine izin vermeniz gerekiyor. Projeniz aynı zamanda expo-secure-store kullanıyorsa, çakışmayı önlemek için kendi yedekleme kurulumunu devre dışı bırakın.

app.json dosyanızı şu şekilde yapılandırın:

{
  "expo": {
    "plugins": [
      ["react-native-adapty", { "replaceAndroidBackupConfig": true }],
      ["expo-secure-store", { "configureAndroidBackup": false }]
    ]
  }
}

replaceAndroidBackupConfig seçeneği varsayılan olarak false’tur. Etkinleştirildiğinde, Adapty eklentisinin Android yedekleme kurallarını yönetmesine olanak tanır. expo-secure-store kullanıyorsanız uyarıları önlemek için "configureAndroidBackup": false ekleyin; çünkü SecureStore’un yedekleme yapılandırması artık Adapty tarafından yönetilecektir.