Android App Links, kullanıcıları doğrudan Android uygulamanızdaki belirli içeriklere yönlendiren HTTP URL'leridir. Android App Links, uygulamanıza daha fazla trafik çekmenize, en çok hangi uygulama içeriğinin kullanıldığını keşfetmenize ve kullanıcıların yüklü bir uygulamadaki içerikleri bulup paylaşmasını kolaylaştırmanıza yardımcı olabilir.
Android Uygulama Bağlantıları için destek eklemek istiyorsanız:
- Manifestinizde intent filtreleri oluşturun.
- Gelen bağlantıları işlemek için uygulamanızın etkinliklerine kod ekleyin.
- Uygulamanızı ve web sitenizi Digital Asset Links ile ilişkilendirin.
Android Studio'daki App Links Assistant, aşağıda açıklandığı gibi adım adım ilerleyen bir sihirbazla süreci basitleştirir.
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 başlıklı makaleyi okuyun.
Intent filtreleri ekleme
Android Studio'daki App Links Assistant, manifest dosyanızda intent filtreleri oluşturmanıza ve web sitenizdeki mevcut URL'leri uygulamanızdaki etkinliklerle eşlemenize yardımcı olabilir. App Links Assistant, intent'i işlemek için ilgili her etkinliğe şablon kodu da ekler.
Intent filtreleri ve URL işleme eklemek için aşağıdaki adımları uygulayın:
- Tools > App Links Assistant'ı (Araçlar > App Links Assistant) seçin.
- URL Eşleme Düzenleyicisi'ni aç'ı ve ardından yeni bir URL eşlemesi eklemek için URL Eşleme listesinin altındaki Ekle'yi
tıklayın. Yeni URL eşlemesiyle ilgili ayrıntıları ekleyin:
Şekil 1. URL'leri uygulamanızdaki etkinliklerle eşlemek için sitenizin bağlantı yapısıyla ilgili temel 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,pathPrefixveyapathPatternekleyin.Örneğin, tüm tariflerin aynı etkinlikte sunulduğu bir tarif paylaşma uygulamanız varsa ve web sitenizdeki tariflerin tümü aynı /tarif dizinindeyse pathPrefix özelliğini kullanın ve /tarif değerini girin. Bu şekilde, http://www.recipe-app.com/recipe/grilled-potato-salad URL'si bir sonraki 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 açılır. Uygulama Bağlantıları asistanı, URL eşlemenize göre
AndroidManifest.xmldosyasına intent filtreleri ekler ve değişiklikleri Önizleme alanında vurgular. Değişiklik yapmak isterseniz intent 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 intent filtreleri bölümüne bakın.Ana App Links Assistant araç penceresi,
AndroidManifest.xmldosyasındaki mevcut tüm derin bağlantıları da gösterir ve Tüm Manifest Sorunlarını Düzelt'i tıklayarak tüm hatalı yapılandırmaları hızlıca düzeltmenize olanak tanır.
Şekil 2. App Links Assistant'ta hatalı manifest yapılandırmalarını düzeltin. 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, arama sonuçlarına dahil edilmesi için uygulamanızın ana ekranının URL'sini de ekleyin.
URL eşlemenizin düzgün çalıştığını doğrulamak için URL Eşlemeyi Kontrol Et alanına bir URL girin.
Doğru şekilde çalışıyorsa başarı mesajı, girdiğiniz URL'nin seçtiğiniz etkinlikle eşleştiğini gösterir.
Gelen bağlantıları işleme
URL eşlemenizin doğru çalıştığını doğruladıktan sonra, oluşturduğunuz intent'i işleyecek mantığı ekleyin:
- App Links Assistant'ta Select Activity'yi (Etkinlik Seç) tıklayın.
- Listeden bir etkinlik seçip Kodu Ekle'yi tıklayın.
App Links Assistant, etkinliğinize aşağıdakine benzer bir 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 tam değildir. Şimdi, appLinkData içindeki URI'ye göre bir işlem yapmanız gerekir (ör. ilgili içeriği görüntüleme). Ö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 Asset 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'yı kullanıyorsanız App Links Assistant 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 Links JSON snippet'ini Play Console geliştirici hesabınızda Release > Setup > App signing bölümünde bulabilirsiniz.
App Links Assistant'ı kullanarak uygulamanızı ve web sitenizi ilişkilendirmek için App Links Assistant'ta Open Digital Asset Links File Generator'ı (Digital Asset Links Dosya Oluşturucu'yu aç) tıklayın ve aşağıdaki adımları uygulayın:
Şekil 3. Digital Asset Links dosyası oluşturmak için siteniz ve uygulamanızla ilgili ayrıntıları girin.
- 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 kimlik bilgilerinin paylaşılmasını destekle'yi 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.İmza yapılandırmasını belirtin veya bir keystore dosyası seçin.
Uygulamanızın yayınlanan derlemesi için doğru yayın yapılandırmasını veya anahtar deposu dosyasını, hata ayıklama derlemesi için ise hata ayıklama yapılandırmasını veya anahtar deposu dosyasını seçtiğinizden emin olun. Üretim derlemenizi ayarlamak istiyorsanız yayın yapılandırmasını kullanın. Derlemenizi test etmek istiyorsanız hata ayıklama yapılandırmasını kullanın.
- Digital Asset Links dosyası oluştur'u tıklayın.
- Android Studio dosyayı oluşturduktan sonra indirmek için Dosyayı kaydet'i tıklayın.
assetlinks.jsondosyasını, herkes için okuma erişimiyle birliktehttps://yoursite/.well-known/assetlinks.jsonadresinden sitenize yükleyin.Önemli: Sistem, şifrelenmiş HTTPS protokolünü kullanarak Digital Asset Links dosyasını doğrular. Uygulamanızın intent filtresinin
httpsiçerip içermediğine bakılmaksızınassetlinks.jsondosyası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.
App Links Assistant, web sitenizde yayınlanması gereken Digital Asset Links dosyasını doğrulayabilir. Asistan, manifest dosyasında beyan edilen her alan için web sitenizdeki dosyayı ayrıştırır, doğrulama kontrolleri yapar ve hataların nasıl çözüleceğine dair ayrıntılı bir açıklama sunar.
Web sitesi ilişkilendirmelerini bildirme bölümünde, Digital Asset Links dosyası aracılığıyla web sitenizi uygulamanızla ilişkilendirme hakkında daha fazla bilgi edinebilirsiniz.
Android Uygulama Bağlantılarınızı test etme
Bağlantılarınızın doğru etkinliği açtığını doğrulamak için aşağıdaki adımları uygulayın:
- App Links Assistant'ta Test App Links'i (Uygulama Bağlantılarını Test Et) tıklayın.
- Test etmek istediğiniz URL'yi URL alanına girin; örneğin, http://recipe-app.com/recipe/grilled-potato-salad.
- Testi Çalıştır'ı tıklayın.
Şekil 4. Test edilen bir URL'yi ve başarı mesajını gösteren Uygulama Bağlantılarını Test Et iletişim kutusu.
URL eşlemesi düzgün ş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, anlam belirsizliğini giderme iletişim kutusunu ("uygulama seçici") göstermeden uygulamanızı cihazda veya emülatörde belirtilen etkinlikte başlatır ve Uygulama Bağlantısı Testi iletişim kutusunda Şekil 4'te gösterildiği gibi bir başarı mesajı gösterir.
Android Studio uygulamayı başlatamazsa Android Studio'nun Run (Çalıştır) penceresinde bir hata mesajı görünür.
Android Uygulama Bağlantıları'nı App Links Assistant aracılığıyla test etmek için Android 6.0 (API düzeyi 23) veya sonraki sürümleri çalıştıran bağlı bir cihazınız ya da sanal cihazınız olmalıdır. Daha fazla bilgi için cihaz bağlama veya AVD oluşturma ile ilgili makaleleri okuyun.