Обзор доверенных веб-действий
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Доверенная веб-активность — это новый способ открытия содержимого вашего веб-приложения, такого как прогрессивное веб-приложение (PWA), из приложения Android с использованием протокола, основанного на пользовательских вкладках.
Примечание . Доверенная веб-активность доступна в Chrome на Android версии 72 и выше.
Ищете код?
Есть несколько особенностей, которые отличают Trusted Web Activity от других способов открытия веб-контента из приложения Android:
- Содержимому доверенной веб-активности доверяют : ожидается, что приложение и сайт, который оно открывает, созданы одним и тем же разработчиком. (Это проверяется с помощью ссылок на цифровые активы .)
- Содержимое, отображаемое в доверенной веб-активности, поступает из Интернета : оно отображается браузером пользователя точно так же, как пользователь видит его в своем браузере, за исключением того, что оно запускается в полноэкранном режиме. Веб-контент должен быть доступен и полезен в первую очередь в браузере.
- Браузеры также обновляются независимо от Android и вашего приложения. Это экономит размер APK и гарантирует, что вы сможете использовать современную веб-среду выполнения. (Обратите внимание, что начиная с Lollipop, WebView также обновлялся независимо от Android, но существует значительное количество пользователей Android до Lollipop.)
- Хост-приложение не имеет прямого доступа к веб-контенту в доверенной веб-активности или к любому другому веб-состоянию, например файлам cookie и
localStorage
. Тем не менее, вы можете координировать свои действия с веб-контентом, передавая данные на страницу и обратно в URL-адресах (например, через параметры запроса и URI намерения ). - Переходы между веб-контентом и собственным контентом происходят между действиями . Каждое действие (т. е. экран) вашего приложения либо полностью обеспечивается Интернетом, либо действием Android.
Чтобы упростить тестирование, в настоящее время нет квалификаций для содержимого, открытого в предварительной версии действий доверенной сети. Однако вы можете ожидать, что действия доверенного веб-сайта должны соответствовать тем же требованиям, что и добавление на главный экран . Вы можете проверить свой сайт на соответствие этим требованиям с помощью аудита Lighthouse . Пользователю может быть предложено добавить на главный экран аудит.
Сегодня другие браузеры могут реализовать тот же протокол, который использует деятельность Trusted Web. Хотя последнее слово в выборе браузера остается за хост-приложением, мы рекомендуем ту же политику, что и для пользовательских вкладок: использовать браузер пользователя по умолчанию, если этот браузер предоставляет необходимые возможности.
Куда идти дальше?
Если вы хотите быстро создать приложение для Android, которое просто запускается и открывает PWA, ознакомьтесь с Краткое руководство по началу работы .
Если вы интегрируете Trusted Web Activity в существующее приложение Android, Руководство по интеграции — хорошее место для начала.
Контент и образцы кода на этой странице предоставлены по лицензиям. Java и OpenJDK – это зарегистрированные товарные знаки корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-07-29 UTC.
[[["Прост для понимания","easyToUnderstand","thumb-up"],["Помог мне решить мою проблему","solvedMyProblem","thumb-up"],["Другое","otherUp","thumb-up"]],[["Отсутствует нужная мне информация","missingTheInformationINeed","thumb-down"],["Слишком сложен/слишком много шагов","tooComplicatedTooManySteps","thumb-down"],["Устарел","outOfDate","thumb-down"],["Проблема с переводом текста","translationIssue","thumb-down"],["Проблемы образцов/кода","samplesCodeIssue","thumb-down"],["Другое","otherDown","thumb-down"]],["Последнее обновление: 2025-07-29 UTC."],[],[],null,["# Overview of Trusted Web Activities\n\n**Trusted Web Activity** is a new way to open *your* web-app content such as *your* Progressive Web App (PWA) from *your* Android app using a protocol based on Custom Tabs.\n\n**Note** : Trusted Web Activity is available in [Chrome on Android](https://play.google.com/store/apps/details?id=com.android.chrome), version 72 and above.\n\n*Looking for the code?*\n\n- [android-browser-helper library on GitHub](https://github.com/GoogleChrome/android-browser-helper)\n- [Trusted Web Activity demos](https://github.com/GoogleChrome/android-browser-helper/tree/master/demos)\n- [Bubblewrap, a NodeJs library / CLI to generate and build Trusted Web Activity projects](https://github.com/GoogleChromeLabs/bubblewrap)\n\nThere are a few things that make Trusted Web Activity different from other ways to open web content from your Android app:\n\n1. Content in a Trusted Web activity is **trusted** -- the app and the site it opens are expected to come from the same developer. (This is verified using [Digital Asset Links](https://developers.google.com/digital-asset-links/v1/getting-started).)\n2. The content rendered in a Trusted Web Activity comes from the **web**: they're rendered by the user's browser, in exactly the same way as a user would see it in their browser except they are run fullscreen. Web content must be accessible and useful in the browser first.\n3. Browsers are also updated independent of Android and your app. That saves on APK size and ensures you can use a modern web runtime. (Note that since Lollipop, WebView has also been updated independent of Android, but there are a [significant number](/about/dashboards) of pre-Lollipop Android users.)\n4. The host app doesn't have direct access to web content in a Trusted Web Activity or any other kind of web state, like cookies and `localStorage`. Nevertheless, you can coordinate with the web content by passing data to and from the page in URLs (e.g. through query parameters and [intent URIs](https://developer.chrome.com/docs/multidevice/android/intents).)\n5. Transitions between web and native content are between **activities**. Each activity (i.e. screen) of your app is either completely provided by the web, or by an Android activity\n\nTo make it easier to test, there are currently no qualifications for content opened in the preview of Trusted Web activities. You can expect, however, that Trusted Web activities need to meet the same [Add to Home Screen](https://web.dev/customize-install#criteria) requirements. You can audit your site for these requirements using the [Lighthouse](https://web.dev/measure/) \"*user can be prompted to Add to Home screen*\" audit.\n\nToday, it is possible for other browsers to implement the same protocol that Trusted Web activities use. While the host app has the final say on what browser gets opened, we recommend the same policy as for Custom Tabs: use the user's default browser, so long as that browser provides the required capabilities.\n\nWhere to go next?\n-----------------\n\nIf you are looking for quickly building an Android app that just starts and opens your PWA, checkout out the [Quick Start Guide](https://developer.chrome.com/docs/android/trusted-web-activity/quick-start).\n\nIf integrating Trusted Web Activity into an existing Android App, the [Integration Guide](https://developer.chrome.com/docs/android/trusted-web-activity/integration-guide) is a good place to get started."]]