Capacitor SDK'da onboarding gösterimi

Warning

Onboardings, Adapty SDK v4 itibarıyla kullanımdan kaldırılmıştır. Bunun yerine flow oluşturun: onboarding’lerin WebView içinde çalışmasının aksine, flow’lar cihazda yerel olarak render edilir — daha akıcı animasyonlar, tutarlı bir yerel görünüm, daha hızlı yükleme süreleri ve WebView bağımlılığı olmadan çalışma.

Builder ile bir onboarding özelleştirdiyseniz, kullanıcıya göstermek için onu mobil uygulama kodunuzda ayrıca render etmeniz gerekmez. Bu tür bir onboarding, hem onboarding içinde ne gösterileceğini hem de nasıl gösterileceğini zaten içerir.

Başlamadan önce şunları yaptığınızdan emin olun:

Bir onboarding oluşturdunuz.
Onboarding’i bir placement’a eklediniz.

Onboarding’i sunma

Bir onboarding’i görüntülemek için createOnboardingView metodu ile oluşturulan view üzerinde view.present() metodunu kullanın. Her view yalnızca bir kez kullanılabilir. Onboarding’i tekrar görüntülemeniz gerekiyorsa, yeni bir view örneği oluşturmak için createOnboardingView’ı bir kez daha çağırın.

Warning

Aynı view’ı yeniden oluşturmadan tekrar kullanmak hataya yol açabilir.


try {
  const view = await createOnboardingView(onboarding);
  
  view.setEventHandlers({
    onClose: (actionId, meta) => {
      console.log('Onboarding closed:', actionId);
      return true; // Allow the onboarding to close
    },
    onCustom: (actionId, meta) => {
      console.log('Custom action:', actionId);
      return false; // Don't close the onboarding
    }
  });
  
  await view.present();
  console.log('Onboarding presented successfully');
} catch (error) {
  console.error('Failed to present onboarding:', error);
}

iOS sunum stilini yapılandırma

present() metoduna iosPresentationStyle parametresini geçirerek onboarding’in iOS’ta nasıl sunulacağını yapılandırın. Parametre 'full_screen' (varsayılan) veya 'page_sheet' değerlerini kabul eder.

await view.present({ iosPresentationStyle: 'page_sheet' });

Onboardinglerde bağlantıların nasıl açıldığını özelleştirin

Important

Onboardinglerde bağlantıların nasıl açıldığını özelleştirme özelliği Adapty SDK v3.15 sürümünden itibaren desteklenmektedir.

Varsayılan olarak, onboardinglerdeki bağlantılar uygulama içi tarayıcıda açılır. Bu, web sayfalarını uygulamanız içinde göstererek kullanıcıların uygulama değiştirmeden görüntülemesine olanak tanır ve kesintisiz bir kullanıcı deneyimi sağlar.

Bağlantıların bunun yerine harici tarayıcıda açılmasını tercih ediyorsanız, openIn parametresini browser_out_app olarak ayarlayarak bu davranışı özelleştirebilirsiniz:

await view.present({ openIn: 'browser_out_app' }); // default — browser_in_app

Sonraki adımlar

Onboarding’inizi sunduktan sonra kullanıcı etkileşimlerini ve olayları ele almayı öğrenebilirsiniz. Kullanıcı eylemlerine yanıt vermek ve analizleri takip etmek için onboarding olaylarının nasıl işleneceğini öğrenin.