Trusted Web Activity — это новый способ интеграции содержимого вашего веб-приложения, например PWA, с вашим приложением Android с использованием протокола на основе пользовательских вкладок.
Для доверенной веб-активности необходимо, чтобы открываемые источники были проверены с помощью ссылок на цифровые активы , чтобы отобразить содержимое на весь экран.
Когда пользователь выходит из проверенного источника, отображается пользовательский интерфейс Custom Tab. Строка URL в Custom Tab сообщает пользователям, что они теперь перемещаются в домене за пределами приложения, а также предоставляет пользователю кнопку X, которая позволяет быстро вернуться к проверенному источнику.
Однако веб-приложения также часто создают опыт, охватывающий несколько источников. Примером может служить приложение для совершения покупок, основной опыт которого находится на сайте www.example.com , а процесс оформления заказа размещается на сайте checkout.example.com .
В таких случаях отображение пользовательских вкладок нежелательно не только потому, что пользователь находится в том же приложении, но и потому, что верхняя панель может заставить пользователя подумать, что он вышел из приложения и отказался от оформления заказа.
Trusted Web Activities позволяет разработчикам проверять несколько источников, и пользователь будет оставаться в полноэкранном режиме при навигации по этим источникам. Как и в случае с основным доменом, разработчик должен иметь возможность контролировать каждый проверенный источник.
Настройка проверки для нескольких источников
Как и в основном источнике, проверка выполняется с помощью ссылок на цифровые активы, и каждый домен, подлежащий проверке, должен иметь свой собственный файл assetlinks.json.
Добавьте файл assetlinks к каждому источнику
В нашем примере с www.example.com и checkout.example.com мы бы имели:
-
https://www.example.com/.well-known/assetlinks.json -
https://checkout.example.com/.well-known/assetlinks.json
Поскольку каждый домен подключается к одному и тому же приложению Android, файлы assetlinks.json выглядят абсолютно одинаково.
Если предположить, что имя пакета для приложения Android — com.example.twa , оба файла assetlink.json будут содержать что-то похожее на следующее:
[{ "relation": ["delegate_permission/common.handle_all_urls"], "target": { "namespace": "android_app", "package_name": "com.example", "sha256_cert_fingerprints": ["..."]} }] Добавьте несколько источников в приложение Android
В приложении Android необходимо обновить декларацию asset_statements , включив в нее все источники, которые необходимо проверить:
<string name="asset_statements"> [{ \"relation\": [\"delegate_permission/common.handle_all_urls\"], \"target\": { \"namespace\": \"web\", \"site\": \"https://www.example.com\" } }], [{ \"relation\": [\"delegate_permission/common.handle_all_urls\"], \"target\": { \"namespace\": \"web\", \"site\": \"https://checkout.example.com\" } }], </string> Добавить дополнительные источники в LauncherActivity
Использование LauncherActivity по умолчанию
LauncherActivity , являющийся частью библиотеки поддержки android-browser-helper предоставляет возможность добавлять несколько источников для проверки путем настройки проекта Android.
Сначала добавьте элемент string-array в файл res/values/strings.xml . Каждый дополнительный URL-адрес, который нужно проверить, будет находиться внутри подэлемента item :
... <string-array name="additional_trusted_origins"> <item>https://www.google.com</item> </string-array> ... Затем добавьте новый тег meta-data внутри существующего элемента activity, который ссылается на LauncherActivity , внутри AndroidManifest.xml :
... <activity android:name="com.google.androidbrowserhelper.trusted.LauncherActivity" android:label="@string/app_name"> <meta-data android:name="android.support.customtabs.trusted.ADDITIONAL_TRUSTED_ORIGINS" android:resource="@array/additional_trusted_origins" /> ... </activity> ... Использование пользовательского LauncherActivity
При использовании пользовательского кода для запуска Trusted Web Activity можно добавить дополнительные источники, вызвав setAdditionalTrustedOrigins при создании намерения для запуска Trusted Web Activity:
public void launcherWithMultipleOrigins(View view) { List<String> origins = Arrays.asList( "https://checkout.example.com/" ); TrustedWebActivityIntentBuilder builder = new TrustedWebActivityIntentBuilder(LAUNCH_URI) .setAdditionalTrustedOrigins(origins); new TwaLauncher(this).launch(builder, null, null); } Заключение
С этими шагами Trusted Web Activity теперь готово поддерживать несколько источников. android-browser-helper имеет пример приложения для многоисточниковых Trusted Web Activities. Обязательно проверьте его.
Поиск неисправностей
Настройка ссылок на цифровые активы имеет несколько подвижных частей. Если приложение по-прежнему показывает панель пользовательских вкладок сверху, скорее всего, что-то не так с конфигурацией.
Краткое руководство по работе с Trusted Web Activity содержит отличный раздел по устранению неполадок , посвященный устранению неполадок Digital Asset Link.
Также имеется замечательный инструмент Peter's Asset Link Tool , который помогает отлаживать ссылки на цифровые активы в приложениях, установленных на устройстве.