Отображение онбординга в Capacitor SDK
Если вы настроили онбординг с помощью билдера, вам не нужно беспокоиться об его рендеринге в коде мобильного приложения для отображения пользователю. Такой онбординг содержит как то, что должно отображаться внутри него, так и то, как это должно выглядеть.
Перед началом убедитесь, что:
- Вы создали онбординг.
- Вы добавили онбординг в плейсмент.
Отображение онбординга
Чтобы отобразить онбординг, используйте метод view.present() для объекта view, созданного методом createOnboardingView. Каждый view можно использовать только один раз. Если нужно показать онбординг повторно, вызовите createOnboardingView ещё раз, чтобы создать новый экземпляр view.
Повторное использование одного и того же view без его пересоздания может привести к ошибке.
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
Настройте способ отображения онбординга на iOS, передав параметр iosPresentationStyle в метод present(). Параметр принимает значения 'full_screen' (по умолчанию) или 'page_sheet'.
await view.present({ iosPresentationStyle: 'page_sheet' });
Настройка открытия ссылок в онбординге
Настройка открытия ссылок в онбординге поддерживается начиная с Adapty SDK v.3.15.
По умолчанию ссылки в онбординге открываются во встроенном браузере. Это обеспечивает удобный пользовательский опыт, отображая веб-страницы внутри вашего приложения без переключения между приложениями.
Если вы хотите открывать ссылки во внешнем браузере, можно изменить это поведение, задав параметру openIn значение browser_out_app:
await view.present({ openIn: 'browser_out_app' }); // default — browser_in_app
Дальнейшие шаги
После отображения онбординга вам потребуется обрабатывать действия пользователя и события. Узнайте, как работать с событиями онбординга, чтобы реагировать на действия пользователей и отслеживать аналитику.