1. 개발자를 위한 웹 기술
  2. 프로그레시브 웹 앱
  3. Web app manifests

This page was translated from English by the community. Learn more and join the MDN Web Docs community.

View in English Always switch to English

Web app manifests

Experimental: 이 기능은 실험적인 기능입니다.
프로덕션 환경에서 사용하기 전에 브라우저 호환성 표를 주의 깊게 확인하세요.

웹 앱 매니페스트(Web app manifest)는 프로그레시브 웹 앱(PWA)라고 칭하는 웹 기술 모음집의 일부로서, 앱 스토어를 거치지 않고 장치의 홈 화면에 설치할 수 있는 웹사이트를 구성합니다. 단순한 홈 화면 링크/북마크를 통한 일반적인 웹 앱과 달리, PWA는 사전 다운로드를 통해 오프라인에서도 동작하며 일반적인 Web API도 사용할 수 있습니다.

웹 앱 매니페스트는 웹 애플리케이션의 정보를 JSON 텍스트 파일로 제공하여, 웹 앱의 다운로드 및 네이티브 앱과 유사한 형태로 제공(홈 화면 설치를 통한 더 빠른 접근 및 풍부한 사용자 경험 제공)을 가능케 합니다. PWA 매니페스트는 자신의 이름, 저작자, 아이콘, 버전, 설명, 기타 필요한 리소스 등을 포함합니다.

구성요소

웹 앱 매니페스트는 다음의 키를 포함할 수 있습니다. 각각의 링크를 클릭해 더 많은 정보를 알아보세요.

예제

json
{
 "name": "HackerWeb",
 "short_name": "HackerWeb",
 "start_url": ".",
 "display": "standalone",
 "background_color": "#fff",
 "description": "A simply readable Hacker News app.",
 "icons": [
 {
 "src": "images/touch/homescreen48.png",
 "sizes": "48x48",
 "type": "image/png"
 },
 {
 "src": "images/touch/homescreen72.png",
 "sizes": "72x72",
 "type": "image/png"
 },
 {
 "src": "images/touch/homescreen96.png",
 "sizes": "96x96",
 "type": "image/png"
 },
 {
 "src": "images/touch/homescreen144.png",
 "sizes": "144x144",
 "type": "image/png"
 },
 {
 "src": "images/touch/homescreen168.png",
 "sizes": "168x168",
 "type": "image/png"
 },
 {
 "src": "images/touch/homescreen192.png",
 "sizes": "192x192",
 "type": "image/png"
 }
 ],
 "related_applications": [
 {
 "platform": "play",
 "url": "https://play.google.com/store/apps/details?id=cheeaun.hackerweb"
 }
 ]
}

매니페스트 배포

웹 앱 매니페스트는 HTML 페이지 <head> 요소 내의 <link> 요소를 사용해 연결합니다.

html
<link rel="manifest" href="/manifest.webmanifest" />

참고 : .webmanifest 확장자는 명세의 Media type registration 구획에 정의(매니페스트 파일의 응답은 Content-Type: application/manifest+json을 반환해야 함)되어 있습니다. 브라우저는 .json과 같은 기타 적절한 확장자도 지원합니다. (Content-Type: application/json).

참고 : 매니페스트를 가져오려면 인증 정보가 필요한 경우, 매니페스트 파일이 현재 페이지와 동일한 출처에 위치하더라도 반드시 crossorigin 특성을 use-credentials로 지정해야 합니다.

스플래시 화면

Chrome 47 이후 버전에서는, 홈 화면에서 실행한 사이트가 스플래시 화면을 사용합니다. 스플래시 화면은 웹 앱 매니페스트의 다음 속성을 사용해 자동으로 생성합니다.

명세서

Specification
Manifest Incubations
# file_handlers-member
Manifest Incubations
# note_taking-member
Manifest Incubations
# protocol_handlers-member
Manifest Incubations
# related_applications-member
Manifest Incubations
# protocol-member
Manifest Incubations
# prefer_related_applications-member
Manifest Incubations
# new_note_url-member
Manifest Incubations
# display_override-member
Manifest Incubations
# url-member
Manifest Incubations
# scope_extensions-member
Manifest Incubations
# dfn-tabbed
Web Application Manifest
# name-member
Web Application Manifest
# background_color-member
Web Application Manifest
# icons-member
Web Application Manifest
# scope-member
Web Application Manifest
# dfn-minimal-ui
Web Application Manifest
# display-member
Web Application Manifest
# theme_color-member
Web Application Manifest
# shortcuts-member
Web Application Manifest
# start_url-member
Web Application Manifest
# orientation-member
Web Application Manifest
# id-member
Web Application Manifest
# dfn-fullscreen
Web Application Manifest
# dfn-browser
Web Application Manifest
# dfn-standalone
Web Application Manifest
# short_name-member
Web App Manifest - Application Information
# description-member
Window Controls Overlay
# addition-of-new-window-controls-overlay-display-mode
Web App Launch Handler API
# client_mode-member
Web App Launch Handler API
# launch_handler-member
Web Share Target API
# share_target-member

브라우저 호환성

같이 보기

Help improve MDN

Learn how to contribute

This page was last modified on by MDN contributors.

AltStyle によって変換されたページ (->オリジナル) /