Adapty React Native SDK 3.14.0, sizin tarafınızdan geçiş adımları gerektiren iyileştirmeler sunan büyük bir sürümdür:

• registerEventHandlers metodu, setEventHandlers metoduyla değiştirildi.
• AdaptyOnboardingView’da event handler’lar artık eventHandlers nesnesi yerine ayrı prop’lar olarak geçiliyor.
• UI bileşenleri için yeni, basitleştirilmiş bir import stili eklendi.
• logShowOnboarding metodu kaldırıldı.
• Minimum React Native sürümü 0.73.0 olarak güncellendi.
• Paywall’lar ve onboarding’ler için varsayılan iOS sunum stili, sayfa sayfasından tam ekrana değiştirildi.

registerEventHandlers’ı setEventHandlers ile Değiştirin

Adapty Paywall ve Onboarding Builder ile çalışmak için kullanılan registerEventHandlers metodu, setEventHandlers metoduyla değiştirildi. Adapty Paywall Builder ve/veya Adapty Onboarding Builder kullanıyorsanız, uygulama kodunuzda registerEventHandlers ifadesini bulun ve setEventHandlers ile değiştirin.

Bu değişiklik, metodun davranışını daha anlaşılır hale getirmek amacıyla yapıldı: Handler’lar artık tek tek çalışıyor çünkü her biri true/false döndürüyor; tek bir event için birden fazla handler tanımlamak sonuçtaki davranışı belirsiz hale getiriyordu.

AdaptyOnboardingView veya AdaptyPaywallView gibi React bileşenleri kullanırken event handler’lardan true/false döndürmeniz gerekmez; bileşenin görünürlüğünü kendi state yönetiminiz aracılığıyla kontrol edersiniz. Dönüş değerleri yalnızca SDK’nın view yaşam döngüsünü yönettiği modal ekran sunumlarında gereklidir.

- const unsubscribe = view.registerEventHandlers({
-    // your event handlers
- })

 const unsubscribe = view.setEventHandlers({
    // your event handlers
 })

UI Bileşenleri için Import Yollarını Güncelleyin

Adapty SDK 3.14.0, UI bileşenleri için basitleştirilmiş bir import stili sunuyor. Artık react-native-adapty/dist/ui yerine doğrudan react-native-adapty’den import edebilirsiniz.

Yeni import stili, standart React Native pratikleriyle daha tutarlı ve import ifadelerini daha sade hale getiriyor. AdaptyPaywallView veya AdaptyOnboardingView gibi UI bileşenleri kullanıyorsanız, import’larınızı aşağıda gösterildiği gibi güncelleyin:

- import { AdaptyPaywallView } from 'react-native-adapty/dist/ui';
+ import { AdaptyPaywallView } from 'react-native-adapty';

- import { AdaptyOnboardingView } from 'react-native-adapty/dist/ui';
+ import { AdaptyOnboardingView } from 'react-native-adapty';

- import { createPaywallView } from 'react-native-adapty/dist/ui';
+ import { createPaywallView } from 'react-native-adapty';

- import { createOnboardingView } from 'react-native-adapty/dist/ui';
+ import { createOnboardingView } from 'react-native-adapty';

React Bileşeninde Onboarding Event Handler’larını Güncelleyin

Onboarding’lere ait event handler’lar, AdaptyOnboardingView’daki eventHandlers nesnesinin dışına taşındı. Onboarding’leri AdaptyOnboardingView kullanarak gösteriyorsanız, event handling yapısını güncelleyin.

 import React, { useCallback } from 'react';
- import { AdaptyOnboardingView } from 'react-native-adapty/dist/ui';
+ import { AdaptyOnboardingView } from 'react-native-adapty';
+ import type { OnboardingEventHandlers } from 'react-native-adapty';
+
+ function MyOnboarding({ onboarding }) {
+   const onAnalytics = useCallback<OnboardingEventHandlers['onAnalytics']>((event, meta) => {}, []);
+   const onClose = useCallback<OnboardingEventHandlers['onClose']>((actionId, meta) => {}, []);
+   const onCustom = useCallback<OnboardingEventHandlers['onCustom']>((actionId, meta) => {}, []);
+   const onPaywall = useCallback<OnboardingEventHandlers['onPaywall']>((actionId, meta) => {}, []);
+   const onStateUpdated = useCallback<OnboardingEventHandlers['onStateUpdated']>((action, meta) => {}, []);
+   const onFinishedLoading = useCallback<OnboardingEventHandlers['onFinishedLoading']>((meta) => {}, []);
+   const onError = useCallback<OnboardingEventHandlers['onError']>((error) => {}, []);
+
   return (
     <AdaptyOnboardingView
       onboarding={onboarding}
       style={styles.container}
-       eventHandlers={{
-         onAnalytics(event, meta) { /* ... */ },
-         onClose(actionId, meta) { /* ... */ },
-         onCustom(actionId, meta) { /* ... */ },
-         onPaywall(actionId, meta) { /* ... */ },
-         onStateUpdated(action, meta) { /* ... */ },
-         onFinishedLoading(meta) { /* ... */ },
-         onError(error) { /* ... */ },
-       }}
+       onAnalytics={onAnalytics}
+       onClose={onClose}
+       onCustom={onCustom}
+       onPaywall={onPaywall}
+       onStateUpdated={onStateUpdated}
+       onFinishedLoading={onFinishedLoading}
+       onError={onError}
     />
   );
+ }

logShowOnboarding’i Kaldırın

Adapty SDK 3.14.0’da logShowOnboarding metodu SDK’dan kaldırıldı. Bu metodu kullanıyorsanız, SDK’yı 3.14 veya sonraki bir sürüme yükselttiğinizde artık kullanılamaz.

Bunun yerine Adapty kodsuz onboarding builder’da onboarding’ler oluşturabilirsiniz. Bu onboarding’lere ait analizler otomatik olarak takip edilir ve pek çok özelleştirme seçeneğine sahip olursunuz.

React Native’i Güncelleyin

Adapty SDK 3.14.0’dan itibaren React Native’in desteklenen minimum sürümü 0.73.0’dır. Daha eski bir sürüm kullanıyorsanız, Adapty SDK ile tutarlı ve güvenilir bir deneyim için React Native’i 0.73.0 veya sonraki bir sürüme güncelleyin.

Modal Paywall’lar ve Onboarding’ler için iOS Sunum Stilini Güncelleyin

Adapty SDK 3.14.0’da, view.present() metodu kullanılarak görüntülenen paywall’lar ve onboarding’ler için varsayılan iOS sunum stili, sayfa sayfasından tam ekrana değiştirildi.

Önceki sayfa sayfası sunum stilini korumak istiyorsanız, present() metoduna iosPresentationStyle parametresini geçin:

try {
  await view.present({ iosPresentationStyle: 'page_sheet' });
} catch (error) {
  // handle the error
}