Тази статия ще Ви помогне да разберете и отстраните често срещани грешки, когато внедрявате връзки към приложението или универсални връзки.
На тази страница
- Често срещани грешки при настройването на внедряване на връзки към приложения
- Често срещани грешки при настройването на внедряване на универсални връзки
Често срещани грешки при настройването на внедряване на връзки към приложения
Това са често срещаните грешки при настройването на връзки към приложението за Android и насоки как да ги коригирате.
Грешки в мрежата
- Атрибутът за хост е образуван правилно: Уверете се, че хостът е правилно образуван URL адрес, например google.bg или www.google.bg.
- Липсващ файл .JSON за Digital Asset Links: Трябва да бъде намерен за всяко уникално име на хост, съдържащо се във филтрите за намерение. Например https://[domain.name]/.well-known/assetlinks.json.
- Забележка: Тази грешка може да се покаже и ако файлът JSON не е обходен от Google. Например когато достъпът на робота е отказан във файла robots.txt. Може да проверите URL адреса на файла .JSON, за да разберете дали това е така.
- Неправилно име на пакета на приложението в JSON файла за Digital Asset Links: Това име на пакета трябва да съответства на идентификатора на приложението, деклариран във файла build.gradle на приложението, и приложението трябва да е налице в Google Play Магазин.
- Неправилен цифров отпечатък на приложението (sha256_cert_fingerprints) във файла .JSON за Digital Asset Links. Научете повече за това как да отстраните тази грешка.
- Неправилен тип съдържание в JSON файла за Digital Asset Links: Типът съдържание трябва да е application/json за всички уеб домейни.
- JSON файлът за Digital Asset Links е достъпен само на адрес http:// вместо https://: Независимо дали приложението декларира http://, или https:// като връзка към приложението, JSON файлът винаги трябва да се хоства на адрес https:// от съображения за сигурност.
- Файлът .JSON за Digital Asset Links е достъпен само чрез пренасочвания: Трябва да има пряк достъп до този файл за потвърждаване на собствеността върху приложението без пренасочвания 301/302.
- Файлът robots.txt блокира достъпа за обхождане до /.well-known/assetlinks.json: Този файл трябва да е достъпен от роботи.
Грешки в приложението
- Липсва маркер <data>, който включва атрибута android:scheme, в манифеста на приложението
- Липсва атрибут за действие чрез намерение ACTION_VIEW във филтъра за намерение (android.intent.action.VIEW)
- Липсват категориите DEFAULT и BROWSABLE като атрибути във филтъра за намерение (android.intent.category.DEFAULT и android.intent.category.BROWSABLE)
- Липсва атрибут android:autoVerify=”true” във филтъра за намерение
- Включване на URL адреси за пренасочване: Всички URL адреси трябва да отвеждат потребителите директно в приложението.
- Логически противоречиво деклариране на връзки към приложението : Припокриващ се URL адрес на връзка към приложението, например: https://example.com/ задейства активност X, а https://example.com/Y – активност Y. При това условие системата на Android ще показва диалогов прозорец за избор на приложение (прекъсвайки връзката към приложението). Понастоящем това не се открива от инструмента за проверка на преки връзки и не е препоръчително внедряване.
Често срещани грешки при настройването на внедряване на универсални връзки
Това са често срещаните грешки при настройването на универсални връзки за iOS и насоки как да ги коригирате.
Грешки в мрежата
- Липсващ файл за асоцииране в уеб домейна: Ако сайтът използва няколко поддомейна (като example.com, www.example.com или support.example.com), всеки от тях изисква собствен запис в Associated Domains Entitlement и трябва да предоставя собствен файл apple-app-site-association.
- Хостване на файла за асоцииране на грешното място: Файлът за асоцииране трябва да се хоства в същия домейн като универсалната Ви връзка. Не се допускат пренасочвания. Ако например универсалната Ви връзка е https://photo.google.com/album, файлът Ви за асоцииране трябва да е на адрес https://photo.google.com/.well-known/apple-app-site-association или https://photo.google.com/apple-app-site-association.
- Забележка: /.well-known/ е предпочитаният метод.
- Добавяне на разширение .json към файла на Apple App Site Association (AASA): Изключете .json, тъй като apple-app-site-association.json е неправилно.
- Показване на файл за асоцииране с тип на съдържанието MIME plain/text: Той трябва да е application/json.
- Надвишаване на ограниченията за размера на файла: Файлът за асоцииране трябва да е по-малък от 128 KБ (некомпресиран размер).
- Неправилна конфигурация на идентификатора на приложението: Идентификаторът на приложението трябва да бъде генериран от идентификатора на екипа и идентификатора на пакета, свързани с точка (.) .
- Наличие на robots.txt или друг механизъм в домейна, който блокира достъпа за обхождане до файла за асоцииране
- Логически противоречиво деклариране на универсални връзки: Ключът „paths“ ще бъде обработен по ред.
Пример 1
https://apple.com/wwdc/ ще задейства универсални връзки.
{
"appID": "ABCD1234.com.apple.wwdc",
"paths": [ "*", "NOT /wwdc/*" ]
},
Пример 2
Универсалните връзки за второто приложение (EFGH5678.com.apple.wwdc) никога не работят.
{
"appID": "ABCD1234.com.apple.wwdc",
"paths": [ "*" ]
},
{
"appID": "EFGH5678.com.apple.wwdc",
"paths": [ "/wwdc/news/", "/videos/wwdc/2015/*"]
}
Грешки в приложението
- Използване на персонализирана схема: Използвайте https или http.
- Липсва applinks: в началото: Форматът за всички свързани домейни трябва да е подобен на applinks:yourdomain.com.
- Неправилна конфигурация на свързаните домейни: Например .google.com съответства на www.google.com, но не и на google.com. Ако искате да декларирате асоциация за google.com и поддомейните (като www.google.com), трябва да декларирате applinks:*.google.com и applinks:google.com.
Забележка: Инструментът за валидиране на преки връзки няма да извършва проверки на ниво приложение за валидността на JSON файла AASA.
Най-добри практики
- Тестване на телефона: Изпратете URL адреса до телефона си, на който е инсталирано приложението. Кликнете върху връзката чрез приложение без вграден браузър (Google Keep може да е чудесен инструмент за тестване).
- Ако приложението се отвори, това е валидна универсална връзка.
- Ако приложението не се отвори или се показва диалогов прозорец за потвърждение за отварянето му, нямате валидна универсална връзка.
- В този случай приложението няма да се отвори в Appify.
- Ако приложението се използва за кампания за ангажиране с приложение, в този случай рекламата няма да бъде одобрена.
