Android Uygulama Bağlantıları Ekleyin

Android App Links, kullanıcıları doğrudan belirli bir web sitesine yönlendiren HTTP URL'leridir ekleyebilirsiniz. Android App Links, uygulamanıza daha fazla trafik çekebilir en çok hangi uygulama içeriğinin kullanıldığını keşfetmenize yardımcı olur ve 'nı kullanarak ve Google'a erişim izni verebilirsiniz.

Android App Links desteği eklemek için:

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

Android Studio'daki App Links Asistan, adım adım açıklamalarla işlemi basitleştirir sihirbazını kullanabilirsiniz.

Uygulama bağlantılarının işleyiş şekli ve sunduğu avantajlar hakkında daha fazla bilgi için Android App Links'i kullanma.

Amaç filtreleri ekle

Android Studio'daki Uygulama Bağlantıları Asistanı ile yeni seçenekler oluşturabilirsiniz: amaç filtreleri manifest dosyanıza ekleyin ve web sitenizdeki mevcut URL'leri uygulamanızdaki etkinliklerle eşleyin. Uygulama Bağlantıları Asistan, aynı zamanda isteyebilirsiniz.

Amaç filtreleri ve URL işleme eklemek için aşağıdaki adımları uygulayın:

  1. Araçlar > Uygulama Bağlantıları Asistanı.
  2. URL Eşleme Düzenleyiciyi Aç'ı ve ardından Ekle'yi tıklayın. URL Eşleme listesinin altına yeni bir URL eşlemesi ekleyin.

  3. Yeni URL eşlemesinin ayrıntılarını ekleyin:

    App Links Assistant, temel URL eşlemede size yol gösterir

    Şekil 1. Sitenizin bağlantısıyla ilgili temel ayrıntıları ekleyin URL'leri uygulamanızdaki etkinliklerle eşlemek için zahmetsizce yapılandırılmış bir yapıya sahip olmanız gerekir.

    1. Barındırıcı alanına web sitenizin URL'sini girin.

    2. Bir path, Eşlemek istediğiniz URL'ler için pathPrefix veya pathPattern.

      Örneğin, aynı restoranda sunulan tüm tarifleri içeren bir yemek tarifi paylaşma uygulamanız varsa, etkinliği ve ilgili web sitenizin tarifleri aynı /recipe içinde olmalıdır pathPrefix dizinini kullanın ve /recipe. yazın. Bu şekilde, URL http://www.recipe-app.com/recipe/ızgara-patato-salata, seçtiğiniz aktiviteyle eşleşir. adım adım anlatacağız.

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

    URL Eşleme Düzenleyici penceresi görünür. Uygulama Bağlantıları Asistanı, amacınıza bağlı olarak AndroidManifest.xml dosyası oluşturur ve Preview (Önizleme) alanına gidin. Herhangi bir değişiklik yapmak isterseniz Aç'ı AndroidManifest.xml dosyasını kullanın. Daha fazla bilgi edinmek için intent filtrelerine bakın.

    Ana Uygulama Bağlantıları Asistanı aracı penceresi, AndroidManifest.xml dosyası oluşturur ve Tüm manifest sorunlarını düzeltin.

    Uygulama Bağlantıları Asistanı, manifestteki yanlış yapılandırmaları düzeltmenize olanak tanır.

    Not: Uygulamanızı güncellemeden gelecekteki bağlantıları desteklemek için eklemeyi planladığınız URL'leri destekleyen bir URL eşlemesi tanımlayın. Ayrıca, şunları da ekleyin: uygulamanızın ana ekranının URL'sini ayarlar ve böylece arama sonuçlarına eklenir.

  4. URL eşlemenizin düzgün çalıştığını doğrulamak için URL Eşlemesini Kontrol Et bölümüne bir URL girin. girin.

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

Gelen bağlantıları işleme

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

  1. Uygulama Bağlantıları Asistanı'nda 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 kendi başına tamamlanmaz. Şimdi, appLinkData (ör. ilgili içeriği gösterir). Örneğin, yemek tarifi paylaşım uygulamasında kullandığınız kod aşağıdaki örneğe benzer:

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 Uygulama Bağlantıları Asistanı bir Dijital Varlık oluşturur Kullanabileceğiniz bağlantılar dosyası web sitenizi Google ile daha fazla bilgi edinip başvurabilirsiniz.

Digital Asset Links dosyasını kullanmaya alternatif olarak sitenizi ve uygulamanızı Search Console.

Şunu kullanıyorsanız: Play Uygulaması Uygulamanız için imzalayın, ardından App Links tarafından oluşturulan sertifika parmak izi Asistan genellikle kullanıcıların cihazlar. Bu durumda, Play Console geliştirici hesabı Release > Setup > App signing.

Uygulama Bağlantıları Asistanı'nı kullanarak uygulamanızı ve web sitenizi ilişkilendirmek için Aç'ı tıklayın. App Links Asistan'dan Digital Asset Links Dosya Oluşturucu'yu ziyaret edin ve için şu adımları izleyin:

App Links Assistant, temel URL eşlemede size yol gösterir

Şekil 2. Siteniz ve uygulamanızla ilgili ayrıntıları girerek bir Digital Asset Links dosyası oluşturun.

  1. Site alan adınızı ve Uygulama ID.

  2. Digital Asset Links dosyanıza One Tap ile oturum açma, Uygulama ve uygulama web sitesini ziyaret edin ve sitenizin oturum açma URL'sini girin.Bu işlem, aşağıdaki dizeyi Uygulamanızın ve web sitenizin oturum açma kimlik bilgilerini paylaştığını belirten Digital Asset Links dosyası: delegate_permission/common.get_login_creds.

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

    Sürüm derlemesi veya için hata ayıklama yapılandırması veya anahtar deposu dosyası uygulamanızın hata ayıklama derlemesi Üretim derlemenizi ayarlamak isterseniz sürüm yapılandırması Derlemenizi test etmek isterseniz 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ı sitenize herkes için okuma erişimiyle, şu adresten yükleyin: https://yoursite/.well-known/assetlinks.json.

    Önemli: Sistem, Digital Asset Links dosyasını şununla doğrular: şifrelenmiş HTTPS protokolü kullanır. assetlinks.json dosyasına şunun üzerinden erişilebildiğinden emin olun: uygulamanızın intent filtresinin https.

  7. Doğru dijital varlığı yüklediğinizi onaylamak için Bağla ve Doğrula'yı tıklayın Dosyanın doğru konuma bağlanması.

App Link Assistant, yayınlanması gereken Digital Assets Links dosyasını doğrulayabilir sitenizi ziyaret edin. Asistan, manifest dosyasında tanımlanan her alan için dosyayı ayrıştırır. doğrulama kontrolleri gerçekleştiriyor ve varsa sorunları nasıl düzelteceğinizle ilgili ayrıntılı hatalar.

Digital Asset Links dosyası üzerinden web sitenizi uygulamanızla ilişkilendirme hakkında daha fazla bilgi: Web sitesi beyan edin ilişkilendirmeleri.

Android App Links'i test edin

Bağlantılarınızın doğru etkinliği açtığını doğrulamak için şu 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. Şekil 3. Uygulama Bağlantılarını Test Et iletişim kutusu test edilen bir URL ve başarı mesajı gösteriliyor.

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

URL eşlemesi doğru şekilde ayarlanmamışsa veya mevcut değilse Uygulama Bağlantılarını Test Et iletişim kutusundaki URL. Aksi halde Android Studio belirtilen etkinlikte uygulamanızı cihazda veya emülatörde başlatırken açıklama iletişim kutusu ("uygulama seçici") belirtir ve App Link Testing (Uygulama Bağlantısı Testi) iletişim kutusu (Şekil 3'te gösterildiği gibi) uygulanır.

Android Studio başlatılamıyorsa Android Studio'nun Çalıştır penceresinde bir hata mesajı görüntülenir.

Android App Links'i App Links Asistanı üzerinden test etmek için bağlı bir cihazınız veya Android 6.0 (API düzeyi 23) veya sonraki sürümleri çalıştıran sanal cihazlarda kullanılabilir. Daha fazla cihazları bağlama hakkında bilgi edinin veya AVD oluşturun.