Android Uygulama Bağlantıları Ekleyin

Android Uygulama Bağlantıları, kullanıcıları doğrudan Android uygulamanızdaki belirli içeriğe götüren HTTP URL'leridir. Android Uygulama Bağlantıları, 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 sihirbazla süreci daha basit hale getirir.

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

Amaç filtreleri ekleyin

Android Studio'daki Uygulama Bağlantıları Asistanı, manifest dosyanızda amaç filtreleri oluşturmanıza ve web sitenizdeki mevcut URL'leri uygulamanızdaki etkinliklerle eşlemenize yardımcı olabilir. Uygulama Bağlantıları Asistan, amacı gerçekleştirmek 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şlemesi eklemek için URL Eşleme listesinin altındaki Ekle seçeneğini tıklayın.

  3. Yeni URL eşlemesi için ayrıntıları ekleyin:

    Uygulama Bağlantıları Asistanı temel URL eşleme işleminde 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ı etkinlikteki tüm tarifleri içeren bir yemek tarifi paylaşma uygulamanız varsa ve ilgili web sitenizin tarifleri aynı /recipe dizinindeyse pathPrefix'i kullanın ve /Recipe girin. Bu şekilde, http://www.recipe-app.com/recipe/grilled-patato-salad URL'si bir sonraki adımda seçtiğiniz aktiviteyle eşlenir.

    3. URL'lerin kullanıcıları götürmesi gereken etkinliğ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şlemenize bağlı olarak intent filtreleri ekler ve Preview (Ö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 de 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şleme

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. Uygulama Bağlantıları Asistanı'ndan Etkinlik Seç'i tıklayın.
  2. Listeden bir etkinlik seçin ve 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 kendi başına eksiksiz değildir. Şimdi appLinkData içindeki URI'ye dayanan, 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ğini 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, sitenizi ve uygulamanızı Search Console'da 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ındakiyle eşleşmez. Bu durumda, uygulamanız için doğru Digital Asset Link JSON snippet'ini, Play Console geliştirici hesabınızdaki Release > Setup > App signing altında bulabilirsiniz.

Uygulama Bağlantıları Asistanı'nı kullanarak uygulamanızı ve web sitenizi ilişkilendirmek için Uygulama Bağlantıları Asistanı'nda Dijital Öğe Bağlantıları Dosya Oluşturucu'yu Aç'ı tıklayın ve aşağıdaki adımları uygulayın:

Uygulama Bağlantıları Asistanı temel URL eşleme işleminde 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 bilgileri'ni seçin ve sitenizin oturum açma URL'sini girin.Bu işlem, Digital Asset Links dosyanıza şu dizeyi ekleyerek uygulamanızın ve web sitenizin oturum açma kimlik bilgilerini paylaştığını belirtir: 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ı 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. Generate 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ı https://yoursite/.well-known/assetlinks.json adresinden sitenize herkes için okuma erişimiyle yükleyin.

    Önemli: Sistem, Digital Asset Link dosyasını şifrelenmiş HTTPS protokolü aracılığıyla doğrular. Uygulamanızın amaç 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 Dijital Öğe Bağlantıları dosyasını doğru konuma yüklediğinizi onaylamak için Bağla ve Doğrula'yı tıklayın.

App Link Assistant, web sitenizde yayınlanması gereken Digital Assets Links dosyasını doğrulayabilir. Asistan, manifest dosyasında belirtilen her alan için web sitenizdeki dosyayı ayrıştırır, doğrulama kontrolleri gerçekleştirir ve hataların nasıl düzeltileceğiyle ilgili ayrıntılı açıklama sunar.

Web sitesi ilişkilendirmeleri beyan etme bölümünde Digital Asset Link dosyası aracılığıyla web sitenizi uygulamanızla ilişkilendirme hakkında daha fazla bilgi edinebilirsiniz.

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/ızgara-patates-salata.

    3. 3. Şekil. Test edilen bir URL ve işlemin başarılı olduğunu belirten Test Uygulama Bağlantıları iletişim kutusu.

  3. Testi Çalıştır'ı tıklayın.

URL eşleme doğru ayarlanmamışsa veya mevcut değilse 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 amaçlı iletişim kutusunu ("uygulama seçici") göstermeden uygulamanızı belirtilen etkinlikte cihazda veya emülatörde 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üntülenir.

Android App Links'i Uygulama Bağlantıları Asistanı ile test etmek için bağlı bir cihazınız veya Android 6.0 (API düzeyi 23) ya da sonraki sürümleri çalıştıran bir sanal cihazınız olmalıdır. Daha fazla bilgi için cihaz bağlama veya AVD oluşturma ile ilgili bilgileri okuyun.