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:
- Manifest'inizde intent filtreleri oluşturun.
- Gelen bağlantıları işlemek için uygulama etkinliklerinize kod ekleyin.
- 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:
- Araçlar > Uygulama Bağlantıları Asistanı'nı seçin.
- 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.
Yeni URL eşlemesi için ayrıntıları ekleyin:
- Host (Barındırıcı) alanına web sitenizin URL'sini girin.
Eşlemek istediğiniz URL'ler için
path
,pathPrefix
veyapathPattern
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.
- URL'lerin kullanıcıları yönlendirmesi gereken Etkinlik'i seçin.
- 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.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.
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:
- App Links Asistan'dan Etkinlik Seç'i tıklayın.
- 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:
- Site alan adınızı ve Uygulama kimliğinizi girin.
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
.İ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.
- Create Digital Asset Links dosyası'nı tıklayın.
- Android Studio dosyayı oluşturduktan sonra, indirmek için Dosyayı kaydet'i tıklayın.
assetlinks.json
dosyasını, herkes için okuma erişimi olacak şekildehttps://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 olarakassetlinks.json
dosyasına HTTPS bağlantısı üzerinden erişilebildiğinden emin olun.- 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:
- Uygulama Bağlantıları Asistanı'nda Uygulama Bağlantılarını Test Et'i tıklayın.
- Test etmek istediğiniz URL'yi URL alanına girin; örneğin, http://Recipe-app.com/Recipe/grilled-patato-salad.
- 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.