Panoramica delle attività web attendibili
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Attività web attendibile è un nuovo modo per aprire i contenuti delle app web, come le app web progressive (PWA), dalla app per Android utilizzando un protocollo basato su Custom Tabs.
Nota: l'attività web attendibile è disponibile in Chrome su Android, versione 72 e successive.
Cerchi il codice?
Esistono alcuni aspetti che rendono Attività web attendibile diversa da altri modi per aprire contenuti web dalla tua app per Android:
- I contenuti di un'attività web attendibile sono attendibili: l'app e il sito che si apre dovrebbero provenire dallo stesso sviluppatore. Questa operazione viene verificata utilizzando Digital Asset Links.
- I contenuti visualizzati in un'attività web attendibile provengono dal web: vengono visualizzati dal browser dell'utente esattamente nello stesso modo in cui un utente li vedrebbe nel proprio browser, tranne per il fatto che vengono eseguiti a schermo intero. I contenuti web devono essere accessibili e utili nel browser.
- Anche i browser vengono aggiornati indipendentemente da Android e dalla tua app. In questo modo riduci le dimensioni dell'APK e ti assicuri di poter utilizzare un runtime web moderno. Tieni presente che, da Lollipop, anche WebView è stato aggiornato indipendentemente da Android, ma esiste un numero significativo di utenti Android precedenti a Lollipop.
- L'app host non ha accesso diretto ai contenuti web in un'Attività web attendibile o a qualsiasi altro tipo di stato web, come i cookie e
localStorage. Tuttavia, puoi eseguire il coordinamento con i contenuti web passando i dati alla pagina e da essa negli URL (ad es. tramite parametri di query e URI intent).
- Le transizioni tra contenuti web e nativi avvengono tra attività. Ogni attività (ovvero schermata) della tua app è completamente fornita dal web o da un'attività Android
Per semplificare il test, al momento non sono previste qualifiche per i contenuti aperti nell'anteprima delle Attività web attendibili. Tuttavia, tieni presente che le attività web attendibili devono soddisfare gli stessi requisiti di Aggiungi a schermata Home. Puoi verificare la presenza di questi requisiti nel tuo sito utilizzando il controllo "All'utente può essere chiesto di aggiungere l'app alla schermata Home" di Lighthouse.
Attualmente, è possibile per altri browser implementare lo stesso protocollo utilizzato dalle attività web attendibili. Sebbene l'app host abbia l'ultima parola su quale browser venga aperto, consigliamo le stesse norme di Custom Tabs: utilizza il browser predefinito dell'utente, a condizione che fornisca le funzionalità richieste.
Passaggi successivi
Se vuoi creare rapidamente un'app per Android che avvii e apra la tua PWA, consulta la guida rapida.
Se stai integrando Attività web attendibile in un'app per Android esistente, la guida all'integrazione è un buon punto di partenza.
I campioni di contenuti e codice in questa pagina sono soggetti alle licenze descritte nella Licenza per i contenuti. Java e OpenJDK sono marchi o marchi registrati di Oracle e/o delle sue società consociate.
Ultimo aggiornamento 2025-07-27 UTC.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-07-27 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."]]
