---
title: "Android SDK'da onboarding'leri sunma"
description: "Etkili kullanıcı etkileşimi için Android'de onboarding'lerin nasıl sunulacağını öğrenin."
---

Başlamadan önce şunların yapıldığından emin olun:

1. [Adapty Android SDK](sdk-installation-android) 3.8.0 veya daha yeni bir sürümü yüklediniz.
2. [Bir onboarding oluşturdunuz](create-onboarding).
3. Onboarding'i bir [placement](placements)'a eklediniz.

Onboarding Builder kullanarak bir onboarding özelleştirdiyseniz, bunu kullanıcıya göstermek için mobil uygulama kodunuzda ayrıca render etmenize gerek yoktur. Bu tür bir onboarding, hem neyin hem de nasıl gösterileceğini kendi içinde barındırır.

Görsel onboarding'i cihaz ekranında görüntüleyebilmek için önce yapılandırmanız gerekir. Bunun için `AdaptyUI.getOnboardingView()` metodunu çağırın ya da `OnboardingView`'ı doğrudan oluşturun:

<Tabs groupId="views-code-examples" queryString>
  <TabItem value="kotlin" label="Kotlin (option 1)" default>

```kotlin
val onboardingView = AdaptyUI.getOnboardingView(
    activity = this,
    viewConfig = onboardingConfig,
    eventListener = eventListener
)
```
  </TabItem>
  <TabItem value="kotlin2" label="Kotlin (option 2)">

```kotlin
val onboardingView = AdaptyOnboardingView(activity)
onboardingView.show(
    viewConfig = onboardingConfig,
    delegate = eventListener
)
```
  </TabItem>
  <TabItem value="java" label="Java (option 1)">

```java
AdaptyOnboardingView onboardingView = AdaptyUI.getOnboardingView(
    activity,
    onboardingConfig,
    eventListener
);
```
  </TabItem>
  <TabItem value="java2" label="Java (option 2)">

```java
AdaptyOnboardingView onboardingView = new AdaptyOnboardingView(activity);
onboardingView.show(onboardingConfig, eventListener);
```
  </TabItem>
  <TabItem value="xml" label="XML">

```xml
<com.adapty.ui.onboardings.AdaptyOnboardingView
        android:id="@+id/onboardingView"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />
```
  </TabItem>
</Tabs>

View başarıyla oluşturulduktan sonra, bunu view hiyerarşisine ekleyip cihaz ekranında görüntüleyebilirsiniz.

İstek parametreleri:

| Parametre | Zorunluluk | Açıklama                                                                                                                                                                      |
| :-------- | :------- |:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **viewConfig** | zorunlu | `AdaptyUI.getOnboardingConfiguration()` metodundan alınan onboarding yapılandırması                                                                                               |
| **eventListener** | zorunlu | Onboarding olaylarını yönetmek için `AdaptyOnboardingEventListener` implementasyonu. Daha fazla ayrıntı için [Onboarding olaylarını yönetme](android-handle-onboarding-events) sayfasına bakın.      |

## Yükleme göstergesi rengini değiştirme \{#change-loading-indicator-color\}

Yükleme göstergesinin varsayılan rengini şu şekilde geçersiz kılabilirsiniz:

```xml

<style name="AppTheme" parent="android:Theme.Material.Light.NoActionBar">
    
    <item name="adapty_progressIndicatorColor">@color/yourColor</item>
</style>
```

## Splash ekranı ile onboarding arasına sorunsuz geçiş ekleme \{#add-smooth-transitions-between-the-splash-screen-and-onboarding\}

Varsayılan olarak, splash ekranı ile onboarding arasında onboarding tam olarak yüklenene kadar yükleme ekranı görünür. Ancak geçişi daha akıcı hale getirmek istiyorsanız bunu özelleştirebilir; splash ekranını uzatabilir ya da başka bir şey gösterebilirsiniz.

Bunu yapmak için `res/layout` dizininde `adapty_onboarding_placeholder_view.xml` dosyası oluşturun ve onboarding yüklenirken gösterilecek yer tutucuyu orada tanımlayın.

Bir yer tutucu tanımladığınızda onboarding arka planda yüklenir ve hazır olduğunda otomatik olarak görüntülenir.

## Güvenli alan dolgularını devre dışı bırakma \{#disable-safe-area-paddings\}

Varsayılan olarak, onboarding view durum çubuğu ve gezinme çubuğu gibi sistem arayüzü öğelerini önlemek amacıyla güvenli alan dolgularını otomatik olarak uygular. Ancak bu davranışı devre dışı bırakarak layout üzerinde tam kontrol sahibi olmak istiyorsanız `safeAreaPaddings` parametresini `false` olarak ayarlayabilirsiniz.

<Tabs groupId="views-code-examples" queryString>
  <TabItem value="kotlin" label="Kotlin (option 1)" default>

```kotlin
val onboardingView = AdaptyUI.getOnboardingView(
    activity = this,
    viewConfig = onboardingConfig,
    eventListener = eventListener,
    safeAreaPaddings = false
)
```
  </TabItem>
  <TabItem value="kotlin2" label="Kotlin (option 2)">

```kotlin
val onboardingView = AdaptyOnboardingView(activity)
onboardingView.show(
    viewConfig = onboardingConfig,
    delegate = eventListener,
    safeAreaPaddings = false
)
```
  </TabItem>
  <TabItem value="java" label="Java (option 1)">

```java
AdaptyOnboardingView onboardingView = AdaptyUI.getOnboardingView(
    activity,
    onboardingConfig,
    eventListener,
    false
);
```
  </TabItem>
  <TabItem value="java2" label="Java (option 2)">

```java
AdaptyOnboardingView onboardingView = new AdaptyOnboardingView(activity);
onboardingView.show(onboardingConfig, eventListener, false);
```
  </TabItem>
</Tabs>

Alternatif olarak, uygulamanıza bir boolean kaynağı ekleyerek bu davranışı genel düzeyde kontrol edebilirsiniz:

```xml

<resources>
    <bool name="adapty_onboarding_enable_safe_area_paddings">false</bool>
</resources>
```

`safeAreaPaddings` değeri `false` olarak ayarlandığında, onboarding otomatik dolgu ayarlaması yapılmadan tam ekrana uzanır; bu sayede layout üzerinde tam kontrol sağlanır ve onboarding içeriği ekranın tamamını kullanabilir.

## Onboarding'lerde bağlantıların nasıl açılacağını özelleştirme \{#customize-how-links-open-in-onboardings\}

:::important
Onboarding'lerde bağlantıların nasıl açılacağını özelleştirme özelliği Adapty SDK v. 3.15.1 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üleyebildiğinden kesintisiz bir deneyim yaşar.

Bağlantıları bunun yerine harici tarayıcıda açmayı tercih ediyorsanız `externalUrlsPresentation` parametresini `AdaptyWebPresentation.ExternalBrowser` olarak ayarlayarak bu davranışı özelleştirebilirsiniz:

<Tabs groupId="views-code-examples" queryString>
  <TabItem value="kotlin" label="Kotlin" default>

```kotlin
val onboardingConfig = AdaptyUI.getOnboardingConfiguration(
    onboarding = onboarding,
    externalUrlsPresentation = AdaptyWebPresentation.ExternalBrowser // default – InAppBrowser
)
```
  </TabItem>
  <TabItem value="java" label="Java">

```java
AdaptyOnboardingConfiguration onboardingConfig = AdaptyUI.getOnboardingConfiguration(
    onboarding,
    AdaptyWebPresentation.ExternalBrowser // default – InAppBrowser
);
```
  </TabItem>
</Tabs>