신뢰할 수 있는 웹 활동 개요
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
신뢰할 수 있는 웹 활동은 맞춤 탭을 기반으로 하는 프로토콜을 사용하여 Android 앱에서 프로그레시브 웹 앱 (PWA)과 같은 웹 앱 콘텐츠를 여는 새로운 방법입니다.
참고: 신뢰할 수 있는 웹 활동은 Android용 Chrome 버전 72 이상에서 사용할 수 있습니다.
코드를 찾고 계신가요?
신뢰할 수 있는 웹 활동은 Android 앱에서 웹 콘텐츠를 여는 다른 방법과 몇 가지 차이점이 있습니다.
- 신뢰할 수 있는 웹 활동의 콘텐츠는 신뢰할 수 있습니다. 앱과 앱에서 여는 사이트가 동일한 개발자가 제공하는 것으로 예상됩니다. 디지털 애셋 링크를 사용하여 확인합니다.
- 신뢰할 수 있는 웹 활동에서 렌더링되는 콘텐츠는 웹에서 가져옵니다. 전체 화면으로 실행되는 점을 제외하고 사용자가 브라우저에서 보는 것과 정확히 동일한 방식으로 사용자의 브라우저에서 렌더링됩니다. 웹 콘텐츠는 먼저 브라우저에서 액세스할 수 있고 유용해야 합니다.
- 브라우저도 Android 및 앱과는 별개로 업데이트됩니다. 따라서 APK 크기가 줄어들고 최신 웹 런타임을 사용할 수 있습니다. Lollipop 이후 WebView도 Android와 별개로 업데이트되었지만 Lollipop 이전 Android 사용자는 상당히 많습니다.
- 호스트 앱은 신뢰할 수 있는 웹 활동의 웹 콘텐츠 또는 쿠키 및
localStorage
와 같은 다른 종류의 웹 상태에 직접 액세스할 수 없습니다. 하지만 URL을 통해 페이지 간에 데이터를 전달하여 웹 콘텐츠와 협력할 수 있습니다 (예: 쿼리 매개변수 및 인텐트 URI 사용).
- 웹 콘텐츠와 네이티브 콘텐츠 간의 전환은 활동 간에 이루어집니다. 앱의 각 활동 (예: 화면)은 웹 또는 Android 활동에서 완전히 제공됩니다.
테스트를 쉽게 하기 위해 현재 신뢰할 수 있는 웹 활동 미리보기에서 열리는 콘텐츠에 대한 자격요건은 없습니다. 하지만 신뢰할 수 있는 웹 활동도 동일한 홈 화면에 추가 요구사항을 충족해야 합니다. Lighthouse의 '사용자에게 홈 화면에 추가하라는 메시지가 표시될 수 있음' 감사를 사용하여 사이트의 이러한 요구사항을 감사할 수 있습니다.
현재 다른 브라우저에서 신뢰할 수 있는 웹 활동에서 사용하는 것과 동일한 프로토콜을 구현할 수 있습니다. 호스트 앱이 어떤 브라우저를 열지 최종 결정하지만 맞춤 탭과 동일한 정책을 사용하는 것이 좋습니다. 즉, 브라우저가 필요한 기능을 제공하는 한 사용자의 기본 브라우저를 사용합니다.
다음 단계는 무엇일까요?
PWA를 시작하고 여는 Android 앱을 빠르게 빌드하려면 빠른 시작 가이드를 확인하세요.
신뢰할 수 있는 웹 활동을 기존 Android 앱에 통합하는 경우 통합 가이드를 참고하세요.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-07-27(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-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."]]