Capacitor SDK'da onboarding'leri sunma
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' });
Onboarding’lerde bağlantıların açılma şeklini özelleştirme
Onboarding’lerde bağlantıların açılma şeklinin özelleştirilmesi Adapty SDK v.3.15 sürümünden itibaren desteklenmektedir.
Varsayılan olarak, onboarding’lerdeki bağlantılar uygulama içi tarayıcıda açılır. Bu sayede kullanıcılar uygulama değiştirmeden web sayfalarını doğrudan uygulamanız içinde görüntüleyerek kesintisiz bir deneyim yaşar.
Bağlantıları bunun yerine harici tarayıcıda açmayı 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.