Android Uygulama Bağlantıları Ekleyin

Android App Links, kullanıcıları doğrudan Android uygulamanızdaki belirli içeriğe getiren HTTP URL'leridir. Android App Links, uygulamanıza daha fazla trafik çekebilir, en çok hangi uygulama içeriğinin kullanıldığını keşfetmenize yardımcı olabilir ve kullanıcıların yüklü bir uygulamada içerik bulup paylaşmasını kolaylaştırabilir.

Android App Links'e yönelik destek eklemek için:

  1. Manifest'inizde intent filtreleri oluşturun.
  2. Gelen bağlantıları işlemek için uygulama etkinliklerinize kod ekleyin.
  3. Uygulamanızı ve web sitenizi Digital Asset Links ile ilişkilendirin.

Android Studio'daki Uygulama Bağlantıları Asistanı, aşağıda açıklandığı gibi bir adım adım sihirbaz ile işlemi basitleştirir.

Uygulama bağlantılarının işleyiş şekli ve sunduğu avantajlar hakkında daha fazla bilgi için Android Uygulama Bağlantılarını Kullanma başlıklı makaleyi okuyun.

Amaç filtreleri ekle

Android Studio'daki App Links Assistant, manifest dosyanızda niyet filtreleri oluşturmanıza ve web sitenizdeki mevcut URL'leri uygulamanızdaki etkinliklerle eşleştirmenize yardımcı olabilir. App Links Asistan ayrıca amacı işlemek için ilgili her etkinliğe şablon kodu da ekler.

Niyet filtreleri ve URL işleme eklemek için şu adımları uygulayın:

  1. Araçlar > Uygulama Bağlantıları Asistanı'nı seçin.
  2. URL Eşleme Düzenleyiciyi Aç'ı ve ardından yeni bir URL eşleme eklemek için URL Eşleme listesinin en altındaki Ekle seçeneğini tıklayın.
  3. Yeni URL eşlemesi için ayrıntıları ekleyin:

    App Links Assistant, temel URL eşleme işlemlerinde size yol gösterir

    Şekil 1. URL'leri uygulamanızdaki etkinliklerle eşlemek için sitenizin bağlantı yapısıyla ilgili temel ayrıntıları ekleyin.

    1. Host (Barındırıcı) alanına web sitenizin URL'sini girin.
    2. Eşlemek istediğiniz URL'ler için path, pathPrefix veya pathPattern ekleyin.

      Örneğin, aynı etkinlikte bulunan tüm tarifleri içeren bir yemek tarifi paylaşma uygulamanız varsa ve karşılık gelen web sitenizin tarifleri aynı /Recipe dizinindeyse pathPrefix'i kullanın ve /Recipe girin. Bu şekilde, http://www.Recipe-app.com/Recipe/mangal-patates-salata URL'si, aşağıdaki adımda seçtiğiniz etkinlikle eşlenir.

    3. URL'lerin kullanıcıları yönlendirmesi gereken Etkinlik'i seçin.
    4. Tamam'ı tıklayın.

    URL Eşleme Düzenleyicisi penceresi görünür. App Links Assistant, AndroidManifest.xml dosyasıyla URL eşlemenizi temel alarak intent filtreleri ekler ve Önizleme alanında değişiklikleri vurgular. Herhangi bir değişiklik yapmak isterseniz amaç filtresini düzenlemek için AndroidManifest.xml dosyasını aç'ı tıklayın. Daha fazla bilgi edinmek için gelen bağlantılar için amaç filtreleri konusuna bakın.

    Ana Uygulama Bağlantıları Asistanı aracı penceresi de AndroidManifest.xml dosyasındaki mevcut tüm derin bağlantıları gösterir ve Tüm Manifest Sorunlarını Düzelt'i tıklayarak yanlış yapılandırmaları hızlıca düzeltmenize olanak tanır.

    App Links Assistant, manifestteki yanlış yapılandırmaları düzeltmenize olanak tanır.

    Not: İlerideki bağlantıları uygulamanızı güncellemeden desteklemek için, eklemeyi planladığınız URL'leri destekleyen bir URL eşlemesi tanımlayın. Ayrıca, arama sonuçlarına dahil edilmesi için uygulamanızın ana ekranının URL'sini ekleyin.

  4. URL eşlemenizin düzgün çalıştığını doğrulamak için URL Eşlemesini Kontrol Et alanına bir URL girin.

    Düzgün çalışıyorsa başarı mesajı, girdiğiniz URL'nin seçtiğiniz etkinlikle eşlendiğini gösterir.

Gelen bağlantıları işleyin

URL eşlemenizin düzgün çalıştığını doğruladıktan sonra oluşturduğunuz amacı işlemek için mantık ekleyin:

  1. App Links Asistan'dan Etkinlik Seç'i tıklayın.
  2. Listeden bir etkinlik seçip Kod Ekle'yi tıklayın.

Uygulama Bağlantıları Asistanı, aşağıdakine benzer şekilde etkinliğinize kod ekler:

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    ...
    // ATTENTION: This was auto-generated to handle app links.
    val appLinkIntent: Intent = intent
    val appLinkAction: String? = appLinkIntent.action
    val appLinkData: Uri? = appLinkIntent.data
    ...
}

Java

@Override
void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    ...
    // ATTENTION: This was auto-generated to handle app links.
    Intent appLinkIntent = getIntent();
    String appLinkAction = appLinkIntent.getAction();
    Uri appLinkData = appLinkIntent.getData();
    ...
}

Bu kod tek başına eksiksiz değildir. Artık appLinkData ürünündeki URI'yı temel alan, karşılık gelen içeriği görüntülemek gibi bir işlem yapmanız gerekir. Örneğin, yemek tarifi paylaşma uygulaması için kodunuz aşağıdaki örnek gibi görünebilir:

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    ...
    handleIntent(intent)
}

override fun onNewIntent(intent: Intent) {
    super.onNewIntent(intent)
    handleIntent(intent)
}

private fun handleIntent(intent: Intent) {
    val appLinkAction = intent.action
    val appLinkData: Uri? = intent.data
    if (Intent.ACTION_VIEW == appLinkAction) {
        appLinkData?.lastPathSegment?.also { recipeId ->
            Uri.parse("content://com.recipe_app/recipe/")
                    .buildUpon()
                    .appendPath(recipeId)
                    .build().also { appData ->
                        showRecipe(appData)
                    }
        }
    }
}

Java

protected void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);
  ...
  handleIntent(getIntent());
}

protected void onNewIntent(Intent intent) {
  super.onNewIntent(intent);
  handleIntent(intent);
}

private void handleIntent(Intent intent) {
    String appLinkAction = intent.getAction();
    Uri appLinkData = intent.getData();
    if (Intent.ACTION_VIEW.equals(appLinkAction) && appLinkData != null){
        String recipeId = appLinkData.getLastPathSegment();
        Uri appData = Uri.parse("content://com.recipe_app/recipe/").buildUpon()
            .appendPath(recipeId).build();
        showRecipe(appData);
    }
}

Uygulamanızı web sitenizle ilişkilendirme

Uygulamanız için URL desteği ayarladıktan sonra, App Links Assistant, web sitenizi uygulamanızla ilişkilendirmek için kullanabileceğiniz bir Digital Assets Links dosyası oluşturur.

Digital Asset Links dosyasını kullanmaya alternatif olarak Search Console'da sitenizi ve uygulamanızı ilişkilendirebilirsiniz.

Uygulamanız için Play Uygulama İmzalama özelliğini kullanıyorsanız Uygulama Bağlantıları Asistanı tarafından oluşturulan sertifika parmak izi genellikle kullanıcıların cihazlarındaki sertifika parmak iziyle eşleşmez. Bu durumda, uygulamanız için doğru Digital Asset Links JSON snippet'ini Release > Setup > App signing altındaki Play Console geliştirici hesabınızda bulabilirsiniz.

App Links Asistan'ı kullanarak uygulamanızı ve web sitenizi ilişkilendirmek için App Links Asistan'da Open Digital Asset Links File Üreticisi'ni tıklayın ve aşağıdaki adımları uygulayın:

App Links Assistant, temel URL eşleme işlemlerinde size yol gösterir

2. Şekil. Digital Asset Links dosyası oluşturmak için siteniz ve uygulamanızla ilgili ayrıntıları girin.

  1. Site alan adınızı ve Uygulama kimliğinizi girin.
  2. Digital Asset Links dosyanıza One Tap ile oturum açma desteği eklemek için, Uygulama ile web sitesi arasında destek paylaşımı kimlik bilgilerini seçin ve sitenizin oturum açma URL'sini girin.Bu işlem, Digital Asset Links dosyanıza, uygulamanızın ve web sitenizin oturum açma kimlik bilgilerini paylaştığını belirten şu dizeyi ekler: delegate_permission/common.get_login_creds.

  3. İmzalama yapılandırmasını belirtin veya bir anahtar deposu dosyası seçin.

    Sürüm derlemesi için doğru sürüm yapılandırmasını veya anahtar deposu dosyasını ya da uygulamanızın hata ayıklama derlemesi için hata ayıklama yapılandırmasını veya anahtar deposu dosyasını seçtiğinizden emin olun. Üretim derlemenizi oluşturmak istiyorsanız sürüm yapılandırmasını kullanın. Derlemenizi test etmek istiyorsanız hata ayıklama yapılandırmasını kullanın.

  4. Create Digital Asset Links dosyası'nı tıklayın.
  5. Android Studio dosyayı oluşturduktan sonra, indirmek için Dosyayı kaydet'i tıklayın.
  6. assetlinks.json dosyasını, herkes için okuma erişimi olacak şekilde https://yoursite/.well-known/assetlinks.json adresinden sitenize yükleyin.

    Önemli: Sistem, Digital Asset Links dosyasını şifrelenmiş HTTPS protokolü aracılığıyla doğrular. Uygulamanızın intent filtresinin https içerip içermediğinden bağımsız olarak assetlinks.json dosyasına HTTPS bağlantısı üzerinden erişilebildiğinden emin olun.

  7. Doğru Digital Asset Links dosyasını doğru konuma yüklediğinizi onaylamak için Bağla ve Doğrula'yı tıklayın.

Web sitesi ilişkilendirmelerini bildirme bölümündeki Digital Asset Links dosyası üzerinden web sitenizi uygulamanızla ilişkilendirme hakkında daha fazla bilgi edinin.

Android uygulama bağlantılarınızı test edin

Bağlantılarınızın doğru etkinliği açtığını doğrulamak için aşağıdaki adımları uygulayın:

  1. Uygulama Bağlantıları Asistanı'nda Uygulama Bağlantılarını Test Et'i tıklayın.
  2. Test etmek istediğiniz URL'yi URL alanına girin; örneğin, http://Recipe-app.com/Recipe/grilled-patato-salad.
  3. 3. Şekil. Test edilen bir URL ve başarı mesajı gösteren Uygulama Bağlantılarını Test Et iletişim kutusu.

  4. Run Test'i (Test Çalıştır) tıklayın.

URL eşleme doğru bir şekilde ayarlanmamışsa veya yoksa Uygulama Bağlantılarını Test Et iletişim kutusundaki URL'nin altında bir hata mesajı görünür. Aksi takdirde, Android Studio, açıklama iletişim kutusunu ("uygulama seçici") göstermeden cihazda veya emülatörde uygulamanızı belirtilen etkinlikte başlatır ve Şekil 3'te gösterildiği gibi Uygulama Bağlantısı Testi iletişim kutusunda bir başarı mesajı gösterir.

Android Studio uygulamayı başlatamazsa Android Studio'nun Çalıştır penceresinde bir hata mesajı görünür.

Android App Links'i App Links Assistant üzerinden test etmek için bir cihazınız veya Android 6.0 (API düzeyi 23) ya da sonraki sürümü çalıştıran bir sanal cihazınız olmalıdır. Daha fazla bilgi için cihaz bağlama veya AVD oluşturma konulu makaleleri inceleyin.