Android uygulama bağlantısı, web sitesi URL'lerinizin kullanıcının uygulamayı seçmesini gerektirmeden Android uygulamanızda ilgili içeriği hemen açmasına olanak tanıyan özel bir derin bağlantı türüdür. Android uygulama bağlantıları, uygulamanızın web sitesi tarafından onaylandığına dair güven oluşturmak için Digital Asset Links API'yi kullanır. Böylece, uygulamanız ilgili alanın bağlantılarını otomatik olarak açabilir. Sistem, URL'lerin sahibi olduğunuzu başarıyla doğrularsa bu URL intent'lerini otomatik olarak uygulamanıza yönlendirir.
Hem uygulamanızın hem de web sitesi URL'lerinin size ait olduğunu doğrulamak için aşağıdaki adımları tamamlayın:
autoVerifyözelliğini içeren intent filtreleri ekleyin. Bu özellik, sistemin uygulamanızın intent filtrelerinizde kullanılan URL alanlarına ait olup olmadığını doğrulaması gerektiğini belirtir.Aşağıdaki konumda bir Digital Asset Links JSON dosyası barındırarak web siteniz ile intent filtreleriniz arasındaki ilişkilendirmeyi belirtin:
https://domain.name/.well-known/assetlinks.json
İlgili bilgileri aşağıdaki kaynaklarda bulabilirsiniz:
Uygulama bağlantısı doğrulaması için intent filtreleri ekleme
Uygulamanız için bağlantı işleme doğrulamasını etkinleştirmek üzere aşağıdaki biçimle eşleşen intent filtreleri ekleyin:
<!-- Make sure you explicitly set android:autoVerify to "true". -->
<intent-filter android:autoVerify="true">
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<category android:name="android.intent.category.BROWSABLE" />
<!-- If a user clicks on a shared link that uses the "http" scheme, your
app should be able to delegate that traffic to "https". -->
<!-- Do not include other schemes. -->
<data android:scheme="http" />
<data android:scheme="https" />
<!-- Include one or more domains that should be verified. -->
<data android:host="..." />
</intent-filter>
Her ana makine için yalnızca bir <intent-filter> beyanında autoVerify eklemek yeterli olsa da, bu ana makine işaretlenmemiş diğer beyanlarda kullanılsa bile tutarlılık için her <intent-filter> öğesine autoVerify eklemeniz önerilir. Bu, manifest dosyanızdaki öğeleri kaldırdıktan veya yeniden yapılandırdıktan sonra uygulamanızın, hâlâ tanımladığınız tüm alanlarla ilişkili kalmasını da sağlar.
Alan doğrulama süreci için internet bağlantısı gerekir ve sürecin tamamlanması biraz zaman alabilir. Sistemin, sürecin verimliliğini artırmasına yardımcı olmak için Android 12 veya sonraki sürümleri hedefleyen bir uygulamanın alanını doğrulaması için alanın, önceki kod snippet'inde belirtilen tam biçimi içeren bir <intent-filter> öğesi içinde olması gerekir.
Örneğin, "http" ve "https" dışındaki <data android:scheme="custom" /> gibi şemalar, <intent-filter>'un alan adı doğrulamasını tetiklemesini engeller.
Birden fazla ana makine için uygulama bağlantısını destekleme
Sistem, uygulamanın URL intent filtrelerinin veri öğelerinde belirtilen ana makineyi, ilgili intent filtresindeki ilgili web alanlarında barındırılan Digital Asset Link dosyalarıyla doğrulayabilmelidir. Doğrulama başarısız olursa sistem, Uygulama İçeriğine Derin Bağlantı Oluşturma bölümünde açıklandığı gibi, amacı çözmek için varsayılan olarak standart davranışına döner. Ancak uygulama, diğer intent filtrelerinde tanımlanan URL kalıplarından herhangi biri için varsayılan işleyici olarak doğrulanabilir.
Not: Android 11 (API düzeyi 30) ve önceki sürümlerde sistem, manifest dosyasında tanımladığınız tüm ana makineler için eşleşen bir Digital Asset Links dosyası bulmadığı sürece uygulamanızı varsayılan işleyici olarak doğrulamaz.
Örneğin, aşağıdaki intent filtrelerine sahip bir uygulama, https://www.example.com/.well-known/assetlinks.json alanında bir assetlinks.json dosyası bulunduğunda ancak https://www.example.net/.well-known/assetlinks.json alanında bulunmadığında yalnızca https://www.example.com için doğrulama işlemini geçer.
<application>
<activity android:name=”MainActivity”>
<intent-filter android:autoVerify="true">
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<category android:name="android.intent.category.BROWSABLE" />
<data android:scheme="http" />
<data android:scheme="https" />
<data android:host="www.example.com" />
</intent-filter>
</activity>
<activity android:name=”SecondActivity”>
<intent-filter>
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<category android:name="android.intent.category.BROWSABLE" />
<data android:scheme="https" />
<data android:host="www.example.net" />
</intent-filter>
</activity>
</application>
Not: Aynı intent filtresindeki tüm <data> öğeleri, birleştirilmiş özelliklerinin tüm varyasyonlarını hesaba katmak için birleştirilir. Örneğin, yukarıdaki ilk intent filtresi yalnızca HTTPS şemasını açıklayan bir <data> öğesi içerir. Ancak intent filtresinin hem http://www.example.com hem de https://www.example.com'yi desteklemesi için diğer <data> öğesiyle birleştirilir.
Bu nedenle, URI şemaları ve alan adlarının belirli kombinasyonlarını tanımlamak istediğinizde ayrı intent filtreleri oluşturmanız gerekir.
Birden fazla alt alan adı için uygulama bağlama desteği
Digital Asset Links protokolü, intent filtrelerinizdeki alt alan adlarını benzersiz ve ayrı ana makineler olarak değerlendirir. Bu nedenle, intent filtrenizde farklı alt alan adlarına sahip birden fazla ana makine listeleniyorsa her alan adında geçerli bir assetlinks.json yayınlamanız gerekir. Örneğin, aşağıdaki intent filtresi, kabul edilen intent URL ana makineleri olarak www.example.com ve mobile.example.com'yi içerir. Bu nedenle, geçerli bir assetlinks.json hem https://www.example.com/.well-known/assetlinks.json hem de https://mobile.example.com/.well-known/assetlinks.json'de yayınlanmalıdır.
<application>
<activity android:name=”MainActivity”>
<intent-filter android:autoVerify="true">
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<category android:name="android.intent.category.BROWSABLE" />
<data android:scheme="https" />
<data android:scheme="https" />
<data android:host="www.example.com" />
<data android:host="mobile.example.com" />
</intent-filter>
</activity>
</application>
Alternatif olarak, ana makine adınızı joker karakterle (*.example.com gibi) tanımlarsanız assetlinks.json dosyanızı kök ana makine adında (example.com) yayınlamanız gerekir. Örneğin, aşağıdaki intent filtresine sahip bir uygulama, assetlinks.json dosyası https://example.com/.well-known/assetlinks.json'de yayınlandığı sürece example.com'nin herhangi bir alt adı (foo.example.com gibi) için doğrulamayı geçer:
<application>
<activity android:name=”MainActivity”>
<intent-filter android:autoVerify="true">
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<category android:name="android.intent.category.BROWSABLE" />
<data android:scheme="https" />
<data android:host="*.example.com" />
</intent-filter>
</activity>
</application>
Aynı alanla ilişkili birden fazla uygulama olup olmadığını kontrol etme
Her biri aynı alanla ilişkilendirilmiş birden fazla uygulama yayınlarsanız bunların her biri başarıyla doğrulanabilir. Ancak uygulamalar tam olarak aynı alan ana makinesini ve yolunu çözebiliyorsa (bir uygulamanın lite ve tam sürümlerinde olduğu gibi) yalnızca en son yüklenen uygulama ilgili alan için web intent'lerini çözebilir.
Bu gibi durumlarda, gerekli paket görünürlüğüne sahip olmanız koşuluyla kullanıcının cihazında olası çakışan uygulamaları kontrol edin. Ardından, uygulamanızda queryIntentActivities() çağrısının sonuçlarını içeren özel bir seçici iletişim kutusu gösterin.
Kullanıcı, iletişim kutusunda görünen eşleşen uygulamalar listesinden tercih ettiği uygulamayı seçebilir.
Web sitesi ilişkilendirmelerini bildirme
Web sitesiyle ilişkili Android uygulamalarını belirtmek ve uygulamanın URL intent'lerini doğrulamak için web sitenizde bir Digital Asset Links JSON dosyası yayınlanmalıdır. JSON dosyası, ilişkili uygulamaları tanımlamak için aşağıdaki alanları kullanır:
package_name: Uygulamanınbuild.gradledosyasında beyan edilen uygulama kimliği.sha256_cert_fingerprints: Uygulamanızın imzalama sertifikasının SHA256 parmak izleri. Java anahtar aracı aracılığıyla parmak izini oluşturmak için aşağıdaki komutu kullanabilirsiniz:keytool -list -v -keystore my-release-key.keystore
Bu alan, uygulamanızın hata ayıklama ve üretim derlemeleri gibi farklı sürümlerini desteklemek için kullanılabilecek birden fazla parmak izini destekler.Uygulamanız için Play Uygulama İmzalama'yı kullanıyorsanız
keytool'nin yerel olarak çalıştırılarak oluşturulan sertifika parmak izi genellikle kullanıcıların cihazlarındaki parmak iziyle eşleşmez. Uygulamanız için Play App Signing'i kullanıp kullanmadığınızı Play Console geliştirici hesabınızdakiRelease > Setup > App signingbölümünden doğrulayabilirsiniz. Kullanıyorsanız aynı sayfada uygulamanız için doğru Digital Asset Links JSON snippet'ini de bulabilirsiniz.
Aşağıdaki örnek assetlinks.json dosyası, com.example Android uygulamasına bağlantı açma hakları verir:
[{
"relation": ["delegate_permission/common.handle_all_urls"],
"target": {
"namespace": "android_app",
"package_name": "com.example",
"sha256_cert_fingerprints":
["14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5"]
}
}]
Bir web sitesini birden fazla uygulamayla ilişkilendirme
Bir web sitesi, aynı assetlinks.json
dosyası içinde birden fazla uygulamayla ilişkilendirme beyanında bulunabilir. Aşağıdaki dosya listesinde, iki uygulamayla ayrı ayrı ilişkilendirmeyi belirten ve https://www.example.com/.well-known/assetlinks.json adresinde bulunan bir beyan dosyası örneği gösterilmektedir:
[{
"relation": ["delegate_permission/common.handle_all_urls"],
"target": {
"namespace": "android_app",
"package_name": "com.example.puppies.app",
"sha256_cert_fingerprints":
["14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5"]
}
},
{
"relation": ["delegate_permission/common.handle_all_urls"],
"target": {
"namespace": "android_app",
"package_name": "com.example.monkeys.app",
"sha256_cert_fingerprints":
["14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5"]
}
}]
Farklı uygulamalar, aynı web barındırıcısı altındaki farklı kaynakların bağlantılarını işleyebilir. Örneğin, uygulama1 https://example.com/articles için bir intent filtresi, uygulama2 ise https://example.com/videos için bir intent filtresi tanımlayabilir.
Not: Bir alanla ilişkilendirilmiş birden fazla uygulama aynı veya farklı sertifikalarla imzalanmış olabilir.
Birden fazla web sitesini tek bir uygulamayla ilişkilendirme
Birden fazla web sitesi, ilgili assetlinks.json dosyalarında aynı uygulamayla ilişkilendirme beyanında bulunabilir. Aşağıdaki dosya listelemelerinde, example.com ve example.net ile app1 arasındaki ilişkilendirmenin nasıl tanımlanacağıyla ilgili bir örnek gösterilmektedir. İlk girişte, example.com ile app1 arasındaki ilişki gösterilmektedir:
https://www.example.com/.well-known/assetlinks.json
[{
"relation": ["delegate_permission/common.handle_all_urls"],
"target": {
"namespace": "android_app",
"package_name": "com.mycompany.app1",
"sha256_cert_fingerprints":
["14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5"]
}
}]
Sonraki girişte, example.net'in app1 ile ilişkisi gösterilmektedir. Yalnızca bu dosyaların barındırıldığı konum farklıdır (.com ve .net):
https://www.example.net/.well-known/assetlinks.json
[{
"relation": ["delegate_permission/common.handle_all_urls"],
"target": {
"namespace": "android_app",
"package_name": "com.mycompany.app1",
"sha256_cert_fingerprints":
["14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5"]
}
}]
JSON doğrulama dosyasını yayınlama
JSON doğrulama dosyanızı aşağıdaki konumda yayınlamanız gerekir:
https://domain.name/.well-known/assetlinks.json
Aşağıdakilerden emin olun:
assetlinks.jsondosyası, content-typeapplication/jsonile yayınlanır.- Uygulamanızın intent filtrelerinin veri şeması olarak HTTPS'yi tanımlayıp tanımlamadığına bakılmaksızın
assetlinks.jsondosyasına HTTPS bağlantısı üzerinden erişilebilmelidir. assetlinks.jsondosyasına herhangi bir yönlendirme olmadan erişilebilmelidir (301 veya 302 yönlendirmesi olmamalıdır).- Uygulama bağlantılarınız birden fazla barındırıcı alanını destekliyorsa
assetlinks.jsondosyasını her alanda yayınlamanız gerekir. Çoklu ana makine için uygulama bağlamayı destekleme başlıklı makaleyi inceleyin. - Uygulamanızı, manifest dosyasında herkese açık olmayan (ör. yalnızca VPN ile erişilebilen) geliştirici/test URL'leriyle yayınlamayın. Bu tür durumlarda, geliştirici derlemeleri için farklı bir manifest dosyası oluşturmak üzere derleme çeşitlerini yapılandırmak geçici bir çözümdür.
Android uygulama bağlantıları doğrulaması
Uygulamanızın intent filtrelerinden en az birinde android:autoVerify="true" varsa uygulamanızı Android 6.0 (API düzeyi 23) veya sonraki bir sürümün yüklü olduğu bir cihaza yüklediğinizde sistem, uygulamanızın intent filtrelerindeki URL'lerle ilişkili ana makineleri otomatik olarak doğrular. Android 12 ve sonraki sürümlerde, doğrulama mantığını test etmek için doğrulama sürecini manuel olarak da çağırabilirsiniz.
Otomatik doğrulama
Sistemin otomatik doğrulaması aşağıdakileri içerir:
- Sistem, aşağıdakilerden herhangi birini içeren tüm intent filtrelerini inceler:
- İşlem:
android.intent.action.VIEW - Kategoriler:
android.intent.category.BROWSABLEveandroid.intent.category.DEFAULT - Veri şeması:
httpveyahttps
- İşlem:
- Android, yukarıdaki intent filtrelerinde bulunan her benzersiz ana makine adı için
https://hostname/.well-known/assetlinks.jsonadresindeki Digital Asset Links dosyasıyla ilgili web sitelerini sorgulayarak
Uygulamanızla ilişkilendirilecek web sitelerinin listesini ve barındırılan JSON dosyasının geçerli olduğunu onayladıktan sonra uygulamayı cihazınıza yükleyin. Asenkron doğrulama sürecinin tamamlanması için en az 20 saniye bekleyin. Sistemin uygulamanızı doğrulayıp doğru bağlantı işleme politikalarını ayarlayıp ayarlamadığını kontrol etmek için aşağıdaki komutu kullanın:
adb shell am start -a android.intent.action.VIEW \
-c android.intent.category.BROWSABLE \
-d "http://domain.name:optional_port"
Manuel doğrulama
Android 12'den itibaren, cihaza yüklenmiş bir uygulama için alan doğrulamasını manuel olarak çağırabilirsiniz. Bu işlemi, uygulamanızın Android 12'yi hedefleyip hedeflemediğinden bağımsız olarak gerçekleştirebilirsiniz.
İnternet bağlantısı kurun
Alan doğrulamasını gerçekleştirmek için test cihazınızın internete bağlı olması gerekir.
Güncellenen alan doğrulama sürecini destekleme
Uygulamanız Android 12 veya sonraki bir sürümü hedefliyorsa sistem, güncellenmiş alan doğrulama sürecini otomatik olarak kullanır.
Aksi takdirde güncellenmiş doğrulama sürecini manuel olarak etkinleştirebilirsiniz. Bunu yapmak için bir terminal penceresinde aşağıdaki komutu çalıştırın:
adb shell am compat enable 175408749 PACKAGE_NAME
Bir cihazdaki Android uygulama bağlantılarının durumunu sıfırlama
Bir cihazda alan doğrulamasını manuel olarak çağırmadan önce test cihazındaki Android uygulama bağlantılarının durumunu sıfırlamanız gerekir. Bunu yapmak için terminal penceresinde aşağıdaki komutu çalıştırın:
adb shell pm set-app-links --package PACKAGE_NAME 0 all
Bu komut, kullanıcı herhangi bir alan için varsayılan uygulamaları seçmeden önceki duruma cihazı döndürür.
Alan doğrulama sürecini başlatma
Bir cihazdaki Android uygulama bağlantılarının durumunu sıfırladıktan sonra doğrulamayı kendiniz gerçekleştirebilirsiniz. Bunu yapmak için bir terminal penceresinde aşağıdaki komutu çalıştırın:
adb shell pm verify-app-links --re-verify PACKAGE_NAME
Doğrulama sonuçlarını inceleme
Doğrulama temsilcisinin isteklerini tamamlaması için biraz zaman tanıdıktan sonra doğrulama sonuçlarını inceleyin. Bunu yapmak için aşağıdaki komutu çalıştırın:
adb shell pm get-app-links PACKAGE_NAME
Bu komutun çıktısı aşağıdakine benzer:
com.example.pkg:
ID: 01234567-89ab-cdef-0123-456789abcdef
Signatures: [***]
Domain verification state:
example.com: verified
sub.example.com: legacy_failure
example.net: verified
example.org: 1026
Doğrulamayı başarıyla geçen alanların alan doğrulama durumu verified olur. Diğer tüm durumlar, alan doğrulamasının yapılamadığını gösterir. Özellikle none durumu, doğrulama temsilcisinin doğrulama sürecini henüz tamamlamamış olabileceğini gösterir.
Aşağıdaki listede, alan doğrulamasının belirli bir alan için döndürebileceği olası değer gösterilmektedir:
none- Bu alan için hiçbir şey kaydedilmedi. Doğrulama aracısının alan doğrulamasıyla ilgili istekleri tamamlaması için birkaç dakika daha bekleyin, ardından alan doğrulama sürecini tekrar başlatın.
verified- Alan, beyan eden uygulama için başarıyla doğrulandı.
approved- Alan, genellikle bir kabuk komutu çalıştırılarak zorunlu olarak onaylandı.
denied- Alan, genellikle bir kabuk komutu çalıştırılarak zorla reddedildi.
migrated- Sistem, eski alan doğrulamasını kullanan önceki bir işlemin sonucunu korudu.
restored- Kullanıcı veri geri yükleme işlemi gerçekleştirdikten sonra alan onaylandı. Alanın daha önce doğrulandığı varsayılır.
legacy_failure- Alan, eski bir doğrulayıcı tarafından reddedildi. Belirli hata nedeni bilinmiyor.
system_configured- Alan, cihaz yapılandırması tarafından otomatik olarak onaylandı.
1024veya daha büyük bir hata koduCihazın doğrulayıcısına özgü özel hata kodu.
Ağ bağlantısı oluşturduğunuzdan emin olun ve alan doğrulama sürecini tekrar başlatın.
Kullanıcıdan uygulamanızı bir alanla ilişkilendirmesini isteme
Uygulamanızın bir alan için onay almasının bir diğer yolu da kullanıcıdan uygulamanızı ilgili alanla ilişkilendirmesini istemektir.
Uygulamanızın alan için onaylanıp onaylanmadığını kontrol edin
Kullanıcıdan izin istemeden önce, uygulamanızın <intent-filter> öğelerinizde tanımladığınız alanların varsayılan işleyicisi olup olmadığını kontrol edin. Onay durumunu aşağıdaki yöntemlerden birini kullanarak sorgulayabilirsiniz:
DomainVerificationManagerAPI'si (çalışma zamanında).- Komut satırı programı (test sırasında).
DomainVerificationManager
Aşağıdaki kod snippet'inde, DomainVerificationManager API'nin nasıl kullanılacağı gösterilmektedir:
Kotlin
val context: Context = TODO("Your activity or fragment's Context")
val manager = context.getSystemService(DomainVerificationManager::class.java)
val userState = manager.getDomainVerificationUserState(context.packageName)
// Domains that have passed Android App Links verification.
val verifiedDomains = userState?.hostToStateMap
?.filterValues { it == DomainVerificationUserState.DOMAIN_STATE_VERIFIED }
// Domains that haven't passed Android App Links verification but that the user
// has associated with an app.
val selectedDomains = userState?.hostToStateMap
?.filterValues { it == DomainVerificationUserState.DOMAIN_STATE_SELECTED }
// All other domains.
val unapprovedDomains = userState?.hostToStateMap
?.filterValues { it == DomainVerificationUserState.DOMAIN_STATE_NONE }
Java
Context context = TODO("Your activity or fragment's Context");
DomainVerificationManager manager =
context.getSystemService(DomainVerificationManager.class);
DomainVerificationUserState userState =
manager.getDomainVerificationUserState(context.getPackageName());
Map<String, Integer> hostToStateMap = userState.getHostToStateMap();
List<String> verifiedDomains = new ArrayList<>();
List<String> selectedDomains = new ArrayList<>();
List<String> unapprovedDomains = new ArrayList<>();
for (String key : hostToStateMap.keySet()) {
Integer stateValue = hostToStateMap.get(key);
if (stateValue == DomainVerificationUserState.DOMAIN_STATE_VERIFIED) {
// Domain has passed Android App Links verification.
verifiedDomains.add(key);
} else if (stateValue == DomainVerificationUserState.DOMAIN_STATE_SELECTED) {
// Domain hasn't passed Android App Links verification, but the user has
// associated it with an app.
selectedDomains.add(key);
} else {
// All other domains.
unapprovedDomains.add(key);
}
}
Komut satırı programı
Geliştirme sırasında uygulamanızı test ederken kuruluşunuza ait alanların doğrulama durumunu sorgulamak için aşağıdaki komutu çalıştırabilirsiniz:
adb shell pm get-app-links --user cur PACKAGE_NAME
Aşağıdaki örnek çıktıda, uygulama "example.org" alanı için doğrulama işlemini geçememesine rağmen 0 numaralı kullanıcı, uygulamayı sistem ayarlarında manuel olarak onaylamıştır ve söz konusu alan için başka bir paket doğrulanmamıştır.
com.example.pkg:
ID: ***
Signatures: [***]
Domain verification state:
example.com: verified
example.net: verified
example.org: 1026
User 0:
Verification link handling allowed: true
Selection state:
Enabled:
example.org
Disabled:
example.com
example.net
Kullanıcının belirli bir alanla ilişkili uygulamayı seçtiği süreci simüle etmek için kabuk komutlarını da kullanabilirsiniz. Bu komutların tam açıklamasını adb shell pm çıktısından bulabilirsiniz.
İsteğin bağlamını belirtin
Alan onayı için bu isteği göndermeden önce kullanıcıyla ilgili bazı bilgiler verin. Örneğin, kullanıcıya uygulamanızın belirli bir alan için neden varsayılan işleyici olması gerektiğini açıklayan bir açılış ekranı, iletişim kutusu veya benzer bir kullanıcı arayüzü öğesi gösterebilirsiniz.
İsteği gönderin
Kullanıcı, uygulamanızın kendisinden ne istediğini anladıktan sonra isteği yapın.
Bunu yapmak için aşağıdaki kod snippet'inde gösterildiği gibi ACTION_APP_OPEN_BY_DEFAULT_SETTINGS intent işlemini ve hedef uygulama için package:com.example.pkg ile eşleşen bir veri dizesini içeren bir intent çağırın:
Kotlin
val context: Context = TODO("Your activity or fragment's Context")
val intent = Intent(Settings.ACTION_APP_OPEN_BY_DEFAULT_SETTINGS,
Uri.parse("package:${context.packageName}"))
context.startActivity(intent)
Java
Context context = TODO("Your activity or fragment's Context");
Intent intent = new Intent(Settings.ACTION_APP_OPEN_BY_DEFAULT_SETTINGS,
Uri.parse("package:" + context.getPackageName()));
context.startActivity(intent);
Intent çağrıldığında kullanıcılar Varsayılan olarak aç adlı bir ayar ekranı görür. Bu ekranda, Şekil 1'de gösterildiği gibi Desteklenen bağlantıları aç adlı bir radyo düğmesi bulunur.
Kullanıcı Desteklenen bağlantıları aç'ı etkinleştirdiğinde Bu uygulamada açılacak bağlantılar adlı bir bölümün altında bir dizi onay kutusu görünür. Kullanıcılar buradan uygulamanızla ilişkilendirmek istedikleri alanları seçebilir. Ayrıca, şekil 2'de gösterildiği gibi alan eklemek için Bağlantı ekle'yi de seçebilirler. Kullanıcılar daha sonra ekledikleri alan adlarındaki herhangi bir bağlantıyı seçtiğinde bağlantı otomatik olarak uygulamanızda açılır.
Uygulamanızda, uygulamanızın doğrulayamadığı alanları açma
Uygulamanızın ana işlevi, yönetilen alanlarını doğrulama yeteneği olmadan bağlantıları üçüncü taraf olarak açmak olabilir. Bu durumda, kullanıcılara bir web bağlantısı seçerken birinci taraf uygulaması ile üçüncü taraf uygulamanız arasında seçim yapamayacaklarını açıklayın. Kullanıcıların alanları üçüncü taraf uygulamanızla manuel olarak ilişkilendirmesi gerekir.
Ayrıca, kullanıcının tercih etmesi durumunda bağlantıyı birinci taraf uygulamasında açmasına olanak tanıyan bir iletişim kutusu veya trampolin etkinliği sunabilirsiniz. Bu tür bir iletişim kutusu veya trampolin etkinliği oluşturmadan önce uygulamanızı, uygulamanızın web intent filtresiyle eşleşen birinci taraf uygulamalarına paket görünürlüğü olacak şekilde ayarlayın.
Uygulama bağlantılarını test etme
Uygulama bağlama özelliğini uygularken, sistemin uygulamanızı web sitelerinizle ilişkilendirebildiğinden ve URL isteklerini beklediğiniz gibi işlediğinden emin olmak için bağlantı işlevini test etmeniz gerekir.
Mevcut bir ekstre dosyasını test etmek için Ekstre Listesi Oluşturucu ve Test Aracı'nı kullanabilirsiniz.
Doğrulanacak ana makinelerin listesini onaylama
Test sırasında, sistemin uygulamanız için doğrulaması gereken ilişkili ana makinelerin listesini onaylamanız gerekir. İlgili intent filtreleri aşağıdaki özellikleri ve öğeleri içeren tüm URL'lerin listesini oluşturun:
android:schemeözelliğihttpveyahttpsdeğerine sahip- Alan URL'si kalıbı içeren
android:hostözelliği android.intent.action.VIEWişlem öğesiandroid.intent.category.BROWSABLEkategori öğesi
Her adlandırılmış ana makine ve alt alan adında bir Digital Asset Links JSON dosyasının sağlanıp sağlanmadığını kontrol etmek için bu listeyi kullanın.
Digital Asset Links dosyalarını onaylama
Her web sitesi için Digital Asset Links JSON dosyasının doğru şekilde barındırıldığından ve tanımlandığından emin olmak üzere Digital Asset Links API'yi kullanın:
https://digitalassetlinks.googleapis.com/v1/statements:list? source.web.site=https://domain.name:optional_port& relation=delegate_permission/common.handle_all_urls
Bağlantı politikalarını kontrol etme
Test sürecinizin bir parçası olarak, bağlantı işlemeyle ilgili mevcut sistem ayarlarını kontrol edebilirsiniz. Bağlı cihazınızdaki tüm uygulamalar için mevcut bağlantı işleme politikalarının listesini almak üzere aşağıdaki komutu kullanın:
adb shell dumpsys package domain-preferred-apps
Aşağıdaki kod da aynı işlemi yapar:
adb shell dumpsys package d
Not: Sistemin doğrulama sürecini tamamlaması için uygulamanızı yükledikten sonra en az 20 saniye beklediğinizden emin olun.
Komut, cihazda tanımlanan her kullanıcının veya profilin listesini döndürür. Bu listeye, aşağıdaki biçimde bir başlık eklenir:
App linkages for user 0:
Bu başlığın ardından, çıkışta ilgili kullanıcının bağlantı işleme ayarlarını listelemek için aşağıdaki biçim kullanılır:
Package: com.android.vending Domains: play.google.com market.android.com Status: always : 200000002
Bu liste, ilgili kullanıcının hangi uygulamaların hangi alan adlarıyla ilişkili olduğunu gösterir:
Package: Bir uygulamayı, manifest dosyasında beyan edildiği şekilde paket adıyla tanımlar.Domains: Bu uygulamanın web bağlantılarını işlediği ana makinelerin tam listesini, ayırıcı olarak boşluklar kullanılarak gösterir.Status: Bu uygulamanın geçerli bağlantı işleme ayarını gösterir. Doğrulamayı geçmiş ve manifestiandroid:autoVerify="true"içeren bir uygulamanın durumualwaysolarak gösterilir. Bu durumdan sonra gelen on altılık sayı, Android sisteminin kullanıcının uygulama bağlantısı tercihlerini kaydetmesiyle ilgilidir. Bu değer, doğrulamanın başarılı olup olmadığını belirtmez.
Not: Bir kullanıcı, doğrulama tamamlanmadan önce bir uygulamanın uygulama bağlantısı ayarlarını değiştirirse doğrulama başarısız olsa bile doğrulama işleminin başarılı olduğuyla ilgili yanlış pozitif bir sonuç görebilirsiniz. Ancak kullanıcı, uygulamanın desteklenen bağlantıları sormadan açmasını açıkça etkinleştirdiyse bu doğrulama hatası önemli değildir. Bunun nedeni, kullanıcı tercihlerinin programatik doğrulamaya (veya doğrulamanın olmamasına) göre öncelikli olmasıdır. Sonuç olarak, bağlantı, doğrulama başarılı olmuş gibi bir iletişim kutusu göstermeden doğrudan uygulamanıza yönlendirir.
Test örneği
Uygulama bağlantısı doğrulamasının başarılı olması için sistemin, uygulamanızı belirli bir intent filtresinde belirttiğiniz ve uygulama bağlantılarıyla ilgili ölçütleri karşılayan web sitelerinin her biriyle doğrulayabilmesi gerekir. Aşağıdaki örnekte, birkaç uygulama bağlantısının tanımlandığı bir manifest yapılandırması gösterilmektedir:
<application>
<activity android:name=”MainActivity”>
<intent-filter android:autoVerify="true">
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<category android:name="android.intent.category.BROWSABLE" />
<data android:scheme="https" />
<data android:scheme="https" />
<data android:host="www.example.com" />
<data android:host="mobile.example.com" />
</intent-filter>
<intent-filter>
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.BROWSABLE" />
<data android:scheme="https" />
<data android:host="www.example2.com" />
</intent-filter>
</activity>
<activity android:name=”SecondActivity”>
<intent-filter>
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<category android:name="android.intent.category.BROWSABLE" />
<data android:scheme="https" />
<data android:host="account.example.com" />
</intent-filter>
</activity>
<activity android:name=”ThirdActivity”>
<intent-filter>
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<data android:scheme="https" />
<data android:host="map.example.com" />
</intent-filter>
<intent-filter>
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.BROWSABLE" />
<data android:scheme="market" />
<data android:host="example.com" />
</intent-filter>
</activity>
</application>
Platformun yukarıdaki manifest dosyasından doğrulamaya çalışacağı ana makinelerin listesi:
www.example.com mobile.example.com www.example2.com account.example.com
Platformun yukarıdaki manifest dosyasından doğrulama denemeyeceği barındırıcıların listesi:
map.example.com (it does not have android.intent.category.BROWSABLE) market://example.com (it does not have either an "http" or "https" scheme)
Açıklama listeleri hakkında daha fazla bilgi edinmek için Açıklama Listesi Oluşturma başlıklı makaleyi inceleyin.
Sık karşılaşılan uygulama hatalarını düzeltme
Android uygulama bağlantılarınızı doğrulayamıyorsanız aşağıdaki yaygın hataları kontrol edin. Bu bölümde, yer tutucu alan adı olarak example.com kullanılır. Bu kontrolleri yaparken example.com yerine sunucunuzun gerçek alan adını girin.
- Yanlış intent filtresi ayarı
<intent-filter>öğesine uygulamanızın sahibi olmadığı bir URL ekleyip eklemediğinizi kontrol edin.- Yanlış sunucu yapılandırması
Sunucunuzun JSON yapılandırmasını kontrol edin ve SHA değerinin doğru olduğundan emin olun.
Ayrıca,
example.com.(sonunda noktayla) değerininexample.comile aynı içeriği yayınladığından emin olun.- Sunucu tarafı yönlendirmeler
Aşağıdaki gibi bir yönlendirme ayarlarsanız sistem, uygulamanız için hiçbir Android App Links'i doğrulamaz:
http://example.com-https://example.comexample.com-www.example.com
Bu davranış, uygulamanızın güvenliğini korur.
- Sunucu sağlamlığı
Sunucunuzun istemci uygulamalarınıza bağlanıp bağlanamadığını kontrol edin.
- Doğrulanamayan bağlantılar
Test amacıyla kasıtlı olarak doğrulanamayan bağlantılar ekleyebilirsiniz. Android 11 ve önceki sürümlerde bu bağlantıların, sistemin uygulamanız için tüm Android Uygulama Bağlantıları'nı doğrulamamasına neden olacağını unutmayın.
- assetlinks.json dosyasında yanlış imza
İmzanızın doğru olduğunu ve uygulamanızı imzalamak için kullanılan imzayla eşleştiğini doğrulayın. Yaygın hatalar şunlardır:
- Uygulamanın hata ayıklama sertifikasıyla imzalanması ve
assetlinks.json'te yalnızca sürüm imzasının bulunması. assetlinks.jsoniçinde küçük harfli bir imza olması. İmza büyük harflerle yazılmalıdır.- Play Uygulama İmzalama özelliğini kullanıyorsanız Google'ın her bir sürümünüzü imzalamak için kullandığı imzayı kullandığınızdan emin olun. Web sitesi ilişkilerini beyan etme ile ilgili talimatları uygulayarak JSON snippet'inin tamamı da dahil olmak üzere bu ayrıntıları doğrulayabilirsiniz.
- Uygulamanın hata ayıklama sertifikasıyla imzalanması ve