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

:::tip
**SDK v4'ten itibaren**, onboarding'lere güçlü bir alternatif olarak [flow'lar](android-get-pb-paywalls) oluşturabilirsiniz. WebView içinde çalışan onboarding'lerin aksine, flow'lar cihazda yerel olarak render edilir; bu sayede daha akıcı animasyonlar, tutarlı bir Android görünümü, daha hızlı yükleme süreleri ve WebView çalışma zamanı bağımlılığı olmadan kullanım elde edersiniz. Başlamak için [Flow'ları ve paywall'ları al](android-get-pb-paywalls) ve [Flow'ları ve paywall'ları göster](android-present-paywalls) sayfalarına göz atın.
:::

Başlamadan önce şunlardan emin olun:

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

Onboarding Builder ile bir onboarding özelleştirdiyseniz, bunu kullanıcıya göstermek için mobil uygulama kodunuzda render işlemiyle uğraşmanıza gerek yok. Bu tür bir onboarding, hem ne gösterileceğini hem de nasıl gösterileceğini içerir.
Cihaz ekranında görsel onboarding'i gösterebilmek için önce yapılandırmanız gerekir. Bunu yapmak için `AdaptyUI.getOnboardingView()` metodunu çağırın veya `OnboardingView`'ı doğrudan oluşturun:

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

```kotlin
val onboardingView = AdaptyUI.getOnboardingView(
    activity = this,
    viewConfig = onboardingConfig,
    eventListener = eventListener
)
```
  </TabItem>
  <TabItem value="kotlin2" label="Kotlin (seçenek 2)">
```kotlin
val onboardingView = AdaptyOnboardingView(activity)
onboardingView.show(
    viewConfig = onboardingConfig,
    delegate = eventListener
)
```
  </TabItem>
  <TabItem value="java" label="Java (seçenek 1)">

```java
AdaptyOnboardingView onboardingView = AdaptyUI.getOnboardingView(
    activity,
    onboardingConfig,
    eventListener
);
```
  </TabItem>
  <TabItem value="java2" label="Java (seçenek 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, onu görünüm hiyerarşisine ekleyebilir ve cihaz ekranında görüntüleyebilirsiniz.

İstek parametreleri:
| Parametre | Zorunluluk | Açıklama |
| :-------- | :------- |:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **viewConfig** | zorunlu | `AdaptyUI.getOnboardingConfiguration()` ile elde edilen onboarding yapılandırması |
| **eventListener** | zorunlu | Onboarding olaylarını işlemek için `AdaptyOnboardingEventListener` uygulaması. Ayrıntılar için [Onboarding olaylarını işleme](android-handle-onboarding-events) bölümüne 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.

## Onboardinglerde linklerin nasıl açılacağını özelleştirme \{#customize-how-links-open-in-onboardings\}

:::important
Onboardinglerde linklerin nasıl açılacağını özelleştirme, Adapty SDK v3.15.1 sürümünden itibaren desteklenmektedir.
:::

Varsayılan olarak, onboardinglerdeki linkler uygulama içi bir tarayıcıda açılır. Bu, web sayfalarını uygulamanızın içinde göstererek kullanıcıların uygulamalar arasında geçiş yapmadan görüntülemesine olanak tanır ve kesintisiz bir kullanıcı deneyimi sunar.

Linklerin bunun yerine harici bir tarayıcıda açılmasını tercih ederseniz, `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>