---
title: "Отображение онбординга в Capacitor SDK"
description: "Узнайте, как отображать онбординги в Capacitor для повышения конверсии и дохода."
---

Если вы настроили онбординг с помощью билдера, вам не нужно беспокоиться об его рендеринге в коде мобильного приложения для отображения пользователю. Такой онбординг содержит как то, что должно отображаться внутри него, так и то, как это должно выглядеть.

Перед началом убедитесь, что:

1. Вы [создали онбординг](create-onboarding).
2. Вы добавили онбординг в [плейсмент](placements).

## Отображение онбординга \{#present-onboarding\}

Чтобы отобразить онбординг, используйте метод `view.present()` для объекта `view`, созданного методом `createOnboardingView`. Каждый `view` можно использовать только один раз. Если нужно показать онбординг повторно, вызовите `createOnboardingView` ещё раз, чтобы создать новый экземпляр `view`.

:::warning
Повторное использование одного и того же `view` без его пересоздания может привести к ошибке.
:::

```typescript showLineNumbers

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 \{#configure-ios-presentation-style\}

Настройте способ отображения онбординга на iOS, передав параметр `iosPresentationStyle` в метод `present()`. Параметр принимает значения `'full_screen'` (по умолчанию) или `'page_sheet'`.

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

## Настройка открытия ссылок в онбординге \{#customize-how-links-open-in-onboardings\}

:::important
Настройка открытия ссылок в онбординге поддерживается начиная с Adapty SDK v.3.15.
:::

По умолчанию ссылки в онбординге открываются во встроенном браузере. Это обеспечивает удобный пользовательский опыт, отображая веб-страницы внутри вашего приложения без переключения между приложениями.

Если вы хотите открывать ссылки во внешнем браузере, можно изменить это поведение, задав параметру `openIn` значение `browser_out_app`:

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

## Дальнейшие шаги \{#next-steps\}

После отображения онбординга вам потребуется [обрабатывать действия пользователя и события](capacitor-handling-onboarding-events). Узнайте, как работать с событиями онбординга, чтобы реагировать на действия пользователей и отслеживать аналитику.