웹 앱 매니페스트 - 애플리케이션 정보

W3C 그룹 노트

이 문서에 대한 자세한 정보
이 버전:
https://www.w3.org/TR/2023/NOTE-manifest-app-info-20230821/
최신 발행 버전:
https://www.w3.org/TR/manifest-app-info/
최신 에디터 초안:
https://w3c.github.io/manifest-app-info/
히스토리:
https://www.w3.org/standards/history/manifest-app-info/
커밋 히스토리
에디터:
Aaron Gustafson (Microsoft Corporation)
피드백:
GitHub w3c/manifest-app-info (풀 리퀘스트, 새 이슈, 오픈 이슈)

요약

이 문서는 웹 애플리케이션 매니페스트 명세의 보조 멤버 레지스트리로, 애플리케이션 매니페스트에 추가 메타데이터를 제공합니다. 이 메타데이터는 디지털 스토어프론트나 이 웹 애플리케이션이 홍보 또는 배포될 수 있는 다른 영역에서 사용되거나, 웹 애플리케이션을 설치할 때 설치 대화상자를 향상시키는 데 활용할 수 있습니다.

이 문서의 상태

이 섹션은 이 문서가 발행될 당시의 상태를 설명합니다. 현재 W3C 발행물의 목록과 이 기술 보고서의 최신 개정본은 W3C 기술 보고서 색인 https://www.w3.org/TR/ 에서 확인하실 수 있습니다.

이 문서는 계속 발전하고 있으며, 변경 사항이 있을 때마다 새로운 스냅샷을 발행합니다. 관심 있는 분들은 manifest-app-info GitHub 저장소에서 변경 사항을 구독하거나 새로운 매니페스트 멤버 제안을 할 수 있습니다.

이 문서는 웹 애플리케이션 작업 그룹에서 Note track을 사용해 Group Note로 발행되었습니다.

이 Group Note는 웹 애플리케이션 작업 그룹의 승인을 받았으나, W3C 자체나 그 회원들의 승인은 받은 바 없습니다.

이 문서는 초안이며 언제든지 업데이트, 교체 또는 폐기될 수 있습니다. 이 문서를 진행 중인 작업 외의 목적으로 인용하는 것은 적합하지 않습니다.

W3C 특허 정책 은 이 문서에 어떠한 라이선스 요건이나 의무사항을 부여하지 않습니다.

이 문서는 2023년 6월 12일 W3C 프로세스 문서에 의해 관리됩니다.

1. 마케팅이 가능한 웹 애플리케이션

웹 애플리케이션이 다양한 서비스(예: 디지털 스토어프론트, 검색 결과 등)를 통해 제공되면서, 네이티브 애플리케이션과 나란히 표시될 때 네이티브 앱과 유사하게 보이는 것이 매우 중요해졌습니다. 웹 애플리케이션은 매니페스트에서 nameicons를 모두 정의할 수 있지만, 이 키들만으로는 사용자가 해당 앱을 설치할지 판단하는 데 충분한 정보를 제공하지 않습니다. 사용자들은 설치를 고려하는 애플리케이션에 대해 더 많은 세부 정보를 제공받는 데에 익숙해졌으며, 본 문서는 그와 같은 추가 정보를 제공할 수 있는 매니페스트 멤버들을 정의합니다.

2. 보조 매니페스트 멤버

아래의 멤버들은 애플리케이션 매니페스트의 멤버를 보완합니다. 이들 멤버들은 런타임에서 웹 애플리케이션에 적용되지 않으므로, 보조(supplementary)로 분류됩니다(즉, 이 항목들은 단순히 참고용이며 사용자 에이전트가 설치된 웹 애플리케이션을 표시하는 방식에 영향을 주지 않습니다). 모든 멤버는 선택사항이며, 아래 예시와 같이 애플리케이션 매니페스트의 루트에 추가할 수 있습니다.

예시 1: 보조 멤버 사용 사례
{
  "name": "Donate App",
  "categories": ["fundraising", "donations"],
  "description": "This app helps you donate to worthy causes.",
  "iarc_rating_id": "e84b072d-71b3-4d3e-86ae-31a8ce4e53b7",
  "screenshots": [{
    "src": "images/screenshot.png",
    "sizes": "800x600",
    "platform": "windows",
    "label": "Lots of organizations to donate to"
  }]
}

애플리케이션 매니페스트는 JSON이므로, 본 명세의 멤버들은 object, array, string 타입입니다(The JSON Data Interchange Format, 2판 참고).

2.1 categories 멤버

categories 멤버는 웹 애플리케이션이 속하는 카테고리를 설명하는 array 타입의 strings입니다. 이는 웹 애플리케이션을 나열하는 카탈로그나 스토어에 힌트를 제공하기 위한 것으로, 해당 스토어 및 카탈로그가 적합한 카테고리에 등록하려 최대한 노력할 것으로 기대되지만, 검색 엔진의 메타 키워드처럼 이 힌트를 반드시 따를 필요는 없습니다.

매니페스트 작성자는 소문자 사용을 권장합니다.

사용 가능한 카테고리 목록:

참고: 카테고리 추가

더 많은 카테고리를 추가하고 싶으신 경우, manifest-app-info GitHub 저장소에 이슈를 등록하거나 풀 리퀘스트로 제안해 주세요.

2.2 description 멤버

description 멤버는 웹 애플리케이션의 목적을 설명할 수 있는 string 타입입니다. 이 값은 접근성 설명으로 사용될 수 있으며, 설치된 웹 애플리케이션에 대한 설명 역할을 합니다.

2.3 iarc_rating_id 멤버

iarc_rating_id 멤버는 웹 애플리케이션의 국제 연령 등급 연합(IARC) 인증 코드를 나타내는 string입니다. 이 값은 해당 웹 애플리케이션이 적합한 연령대를 판단하는 데 사용됩니다.

참고

IARC 인증은 웹 앱 배포용 스토어를 통해 발급받을 수 있습니다. iarc_rating_id 멤버는 하나의 인증 코드만을 사용해야 하며, 같은 제품(즉, 사용자 에이전트 스니핑 등으로 완전히 다른 코드 경로를 제공하지 않는 경우라면)이라면 여러 스토어에서 동일한 코드를 사용할 수 있습니다.

IARC에 대한 자세한 내용은 How IARC WorksHow developers can get their games and apps rated with IARC를 참고하세요.

2.4 screenshots 멤버

screenshots 멤버는 다양한 사용 시나리오에서 웹 애플리케이션을 대표하는 screenshots 객체 Array입니다.

3. 스크린샷 객체 및 그 멤버

screenshots 객체ImageResource object에 몇 가지 추가 멤버들을 포함한 것입니다.

3.1 label 멤버

label 멤버는 해당 string 값으로 접근 가능한 이름 역할을 하게 됩니다. 접근성을 위해 작성자는 각 스크린샷에 label을 제공하는 것이 좋습니다. 이 멤버는 스크린샷이 시각적으로 렌더링될 때 대체 텍스트로 사용될 수 있습니다.

예시 2: 보조 멤버 사용 사례
{
  "screenshots": [{
    "src": "images/screenshot.png",
    "sizes": "800x600",
    "form_factor": "wide",
    "label": "With Software, you can select a part of your screen and take a screenshot in seconds."
  }]
}

3.2 platform 멤버

platform 멤버는 배포 플랫폼을 나타내는 string 값입니다. 작성자는 스크린샷이 특정 상황에서만 적용되는 경우에만 이 멤버를 사용하는 것을 권장합니다.

참고: platform 작성자 사용 가이드

platform은 스크린샷이 범용 경험을 대표하지 못하는 경우에만 사용해야 합니다. 예를 들어, 운영체제별 platform 값은 해당 플랫폼에서만 제공되는 기능이 스크린샷에 포함된 경우에 사용해야 합니다.

사용자 에이전트는 몇 개의 스크린샷이든(또는 전혀) 표시할 수 있지만, 자신의 플랫폼에 해당하지 않는 스크린샷은 노출하지 않아야 합니다(예: Google Play는 iOS 전용 스크린샷을 표시하지 않음).

platform이 설정되지 않았을 땐, 사용자 에이전트는 해당 스크린샷이 모든 플랫폼에 적용된다고 간주해야 합니다.

사용자 에이전트는 스크린샷의 종횡비(sizes)를 참고하여 표시 여부를 결정할 수 있습니다.

운영체제별 platform 값 목록:

android
구글 안드로이드용.
chromeos
구글 크롬OS용.
ipados
애플 iPadOS용.
ios
애플 iOS용.
kaios
KaiOS용.
macos
애플 macOS용.
windows
마이크로소프트 윈도우용.
xbox
마이크로소프트 Xbox용.

애플리케이션 배포 플랫폼별 platform 값 목록:

chrome_web_store
구글 크롬 웹 스토어
play
구글 플레이 스토어
itunes
아이튠즈 앱 스토어
microsoft-inbox
마이크로소프트 윈도우와 함께 사전 설치됨
microsoft-store
마이크로소프트 스토어
참고: 카테고리 추가

더 많은 platform을 추가하고 싶으신 경우, manifest-app-info GitHub 저장소에 이슈를 등록하거나 풀 리퀘스트로 제안해 주세요.

3.3 form_factor 멤버

form_factor 멤버는 특정한 스크린샷이 어떤 디바이스 화면 형태(예: 화면이 좁거나 넓은지)에 적용되는지를 나타내는 string 값입니다. 작성자는 스크린샷이 특정 컨텍스트에만 해당하는 경우에만 이 멤버 사용을 권장합니다.

참고: form_factor 작성자 사용 가이드

form_factor는 스크린샷이 범용 경험을 대표하지 않는 경우에만 사용해야 합니다. 예를 들어, 화면 방향에 따라 레이아웃/디자인이 달라지는 경우 "narrow" 또는 "wide"를 지정하는 것이 좋습니다.

사용자 에이전트는 여러 개(또는 아무 것도) 스크린샷을 표시할 수 있지만, 자신의 form factor(형태)에 해당하지 않는 스크린샷은 표시하지 않아야 합니다(예: 휴대폰에서는 "wide" form_factor 스크린샷을 표시하지 않음).

form_factor를 지정하지 않으면, 사용자 에이전트는 모든 형태에 해당한다고 간주해야 합니다.

form_factor 값 목록:

narrow
좁은 화면만 해당(예: 모바일 기기)되는 스크린샷
wide
넓은 화면만 해당(예: 현황판 등)되는 스크린샷

A. 국제화

이 절은 비규범적입니다.

작성자는 이 문서에서 정의한 모든 텍스트 문자열의 콘텐츠를 Manifest 명세에 명시된 접근 방식을 기반으로 현지화할 것으로 예상됩니다.

B. 감사의 말씀

Rob Dolin이 많은 작업, 특히 iarc_rating_id 멤버를 주도해 주신 점, 그리고 이러한 아이디어를 검토하는 데 도움을 주신 Kenneth Rohde Christiansen께 감사드립니다.

다음 기여자 여러분께도 감사드립니다: Christian Liebel, Julien Cayzac, Marcos Cáceres, Thomas Steiner, Xiaoqian Wu, 그리고 Yajing Tang.

C. 색인

C.1 이 명세서에서 정의된 용어

C.2 참조를 통해 정의된 용어

D. 참고 문헌

D.1 참고용 참고 문헌

[accname-1.2]
Accessible Name and Description Computation 1.2. Bryan Garaventa; Joanmarie Diggs; Michael Cooper. W3C. 2019년 7월 11일. W3C Working Draft. URL: https://www.w3.org/TR/accname-1.2/
[appmanifest]
Web Application Manifest. Marcos Caceres; Kenneth Christiansen; Matt Giuca; Aaron Gustafson; Daniel Murphy; Anssi Kostiainen. W3C. 2023년 5월 2일. W3C Working Draft. URL: https://www.w3.org/TR/appmanifest/
[ECMA-404]
JSON 데이터 교환 포맷, 2판. Ecma International. 2017년 12월 1일. Standard. URL: https://www.ecma-international.org/wp-content/uploads/ECMA-404_2nd_edition_december_2017.pdf
[image-resource]
Image Resource. Aaron Gustafson; Rayan Kanso; Marcos Caceres. W3C. 2021년 6월 4일. W3C Working Draft. URL: https://www.w3.org/TR/image-resource/