Capacitor SDK'da onboarding'leri sunma

Onboarding’ler SDK v4’te kullanımdan kaldırılmıştır ve gelecekteki bir sürümde kaldırılacaktır. Artık hata düzeltmesi veya iyileştirme almamaktadır. Bunun yerine flow’ları kullanın: WebView içinde çalışan onboarding’lerin aksine, flow’lar cihazda yerel olarak render edilir — bu sayede 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 imkânı sunar. Başlamak için Flow’ları ve paywallları edinin ve Flow’ları ve paywallları görüntüleyin sayfalarına bakın.

Onboarding’i builder ile özelleştirdiyseniz, kullanıcıya göstermek için mobil uygulama kodunuzda ayrıca render işlemi yapmanıza gerek yoktur. Böyle bir onboarding, hem onboarding içinde gösterilecekleri hem de bunların nasıl gösterileceğini içerir.

Başlamadan önce şunları tamamladığı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.

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

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.