Copyright © 2023 World Wide Web Consortium. W3C® liability, trademark and permissive document license rules apply.
이 문서는 웹 애플리케이션 매니페스트 명세의 보조 멤버 레지스트리로, 애플리케이션 매니페스트에 추가 메타데이터를 제공합니다. 이 메타데이터는 디지털 스토어프론트나 이 웹 애플리케이션이 홍보 또는 배포될 수 있는 다른 영역에서 사용되거나, 웹 애플리케이션을 설치할 때 설치 대화상자를 향상시키는 데 활용할 수 있습니다.
이 섹션은 이 문서가 발행될 당시의 상태를 설명합니다. 현재 W3C 발행물의 목록과 이 기술 보고서의 최신 개정본은 W3C 기술 보고서 색인 https://www.w3.org/TR/ 에서 확인하실 수 있습니다.
이 문서는 계속 발전하고 있으며, 변경 사항이 있을 때마다 새로운 스냅샷을 발행합니다. 관심 있는 분들은 manifest-app-info GitHub 저장소에서 변경 사항을 구독하거나 새로운 매니페스트 멤버 제안을 할 수 있습니다.
이 문서는 웹 애플리케이션 작업 그룹에서 Note track을 사용해 Group Note로 발행되었습니다.
이 Group Note는 웹 애플리케이션 작업 그룹의 승인을 받았으나, W3C 자체나 그 회원들의 승인은 받은 바 없습니다.
이 문서는 초안이며 언제든지 업데이트, 교체 또는 폐기될 수 있습니다. 이 문서를 진행 중인 작업 외의 목적으로 인용하는 것은 적합하지 않습니다.
W3C 특허 정책 은 이 문서에 어떠한 라이선스 요건이나 의무사항을 부여하지 않습니다.
이 문서는 2023년 6월 12일 W3C 프로세스 문서에 의해 관리됩니다.
웹 애플리케이션이 다양한 서비스(예: 디지털 스토어프론트, 검색 결과 등)를 통해 제공되면서, 네이티브 애플리케이션과 나란히 표시될 때 네이티브 앱과 유사하게 보이는 것이 매우 중요해졌습니다. 웹 애플리케이션은 매니페스트에서 name과 icons를 모두 정의할 수 있지만, 이 키들만으로는 사용자가 해당 앱을 설치할지 판단하는 데 충분한 정보를 제공하지 않습니다. 사용자들은 설치를 고려하는 애플리케이션에 대해 더 많은 세부 정보를 제공받는 데에 익숙해졌으며, 본 문서는 그와 같은 추가 정보를 제공할 수 있는 매니페스트 멤버들을 정의합니다.
아래의 멤버들은 애플리케이션 매니페스트의 멤버를 보완합니다. 이들 멤버들은 런타임에서 웹 애플리케이션에 적용되지 않으므로, 보조(supplementary)로 분류됩니다(즉, 이 항목들은 단순히 참고용이며 사용자 에이전트가 설치된 웹 애플리케이션을 표시하는 방식에 영향을 주지 않습니다). 모든 멤버는 선택사항이며, 아래 예시와 같이 애플리케이션 매니페스트의 루트에 추가할 수 있습니다.
{
"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판 참고).
categories
멤버는 웹 애플리케이션이 속하는 카테고리를 설명하는 array 타입의
strings입니다. 이는 웹 애플리케이션을 나열하는 카탈로그나 스토어에 힌트를 제공하기 위한 것으로,
해당 스토어 및 카탈로그가 적합한 카테고리에 등록하려 최대한 노력할 것으로 기대되지만, 검색 엔진의 메타 키워드처럼 이 힌트를 반드시 따를 필요는 없습니다.
매니페스트 작성자는 소문자 사용을 권장합니다.
사용 가능한 카테고리 목록:
더 많은 카테고리를 추가하고 싶으신 경우, manifest-app-info GitHub 저장소에 이슈를 등록하거나 풀 리퀘스트로 제안해 주세요.
description
멤버는 웹 애플리케이션의 목적을 설명할 수 있는 string 타입입니다. 이 값은 접근성 설명으로 사용될 수 있으며, 설치된 웹 애플리케이션에 대한 설명 역할을 합니다.
iarc_rating_id
멤버는 웹 애플리케이션의 국제 연령 등급 연합(IARC) 인증 코드를 나타내는 string입니다. 이 값은 해당 웹 애플리케이션이 적합한 연령대를 판단하는 데 사용됩니다.
IARC 인증은 웹 앱 배포용 스토어를 통해 발급받을 수 있습니다. 멤버는 하나의 인증 코드만을
사용해야 하며, 같은 제품(즉, 사용자 에이전트 스니핑 등으로 완전히 다른 코드 경로를 제공하지 않는 경우라면)이라면 여러 스토어에서 동일한 코드를 사용할 수 있습니다.
iarc_rating_id
IARC에 대한 자세한 내용은 How IARC Works 및 How developers can get their games and apps rated with IARC를 참고하세요.
screenshots
멤버는
다양한 사용 시나리오에서 웹 애플리케이션을 대표하는 screenshots 객체 Array입니다.
screenshots 객체는 ImageResource object에 몇 가지 추가 멤버들을 포함한 것입니다.
label
멤버는 해당 string 값으로
접근 가능한 이름 역할을 하게 됩니다. 접근성을 위해 작성자는 각 스크린샷에 label을 제공하는 것이 좋습니다. 이 멤버는 스크린샷이 시각적으로 렌더링될 때 대체 텍스트로 사용될
수 있습니다.
{
"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."
}]
}
platform
멤버는 배포 플랫폼을 나타내는 string 값입니다. 작성자는 스크린샷이 특정 상황에서만 적용되는 경우에만 이 멤버를 사용하는 것을
권장합니다.
platform은 스크린샷이 범용 경험을 대표하지 못하는 경우에만 사용해야 합니다. 예를 들어, 운영체제별 platform 값은 해당
플랫폼에서만 제공되는 기능이 스크린샷에 포함된 경우에 사용해야 합니다.
사용자 에이전트는 몇 개의 스크린샷이든(또는 전혀) 표시할 수 있지만, 자신의 플랫폼에 해당하지 않는 스크린샷은 노출하지 않아야 합니다(예: Google Play는 iOS 전용 스크린샷을 표시하지 않음).
platform이 설정되지 않았을 땐, 사용자 에이전트는 해당 스크린샷이 모든 플랫폼에 적용된다고 간주해야 합니다.
사용자 에이전트는 스크린샷의 종횡비(sizes)를 참고하여 표시 여부를 결정할 수 있습니다.
운영체제별 platform 값 목록:
애플리케이션 배포 플랫폼별 platform 값 목록:
더 많은 platform을 추가하고 싶으신 경우, manifest-app-info GitHub 저장소에 이슈를 등록하거나 풀 리퀘스트로 제안해 주세요.
form_factor
멤버는 특정한 스크린샷이 어떤 디바이스 화면 형태(예: 화면이 좁거나 넓은지)에 적용되는지를 나타내는 string 값입니다. 작성자는 스크린샷이 특정 컨텍스트에만 해당하는 경우에만 이 멤버 사용을
권장합니다.
form_factor는 스크린샷이 범용 경험을 대표하지 않는 경우에만 사용해야 합니다. 예를 들어, 화면 방향에 따라 레이아웃/디자인이 달라지는 경우
"narrow" 또는 "wide"를 지정하는 것이 좋습니다.
사용자 에이전트는 여러 개(또는 아무 것도) 스크린샷을 표시할 수 있지만, 자신의 form factor(형태)에 해당하지 않는 스크린샷은 표시하지 않아야 합니다(예: 휴대폰에서는
"wide" form_factor 스크린샷을 표시하지 않음).
form_factor를 지정하지 않으면, 사용자 에이전트는 모든 형태에 해당한다고 간주해야 합니다.
form_factor 값 목록:
이 절은 비규범적입니다.
작성자는 이 문서에서 정의한 모든 텍스트 문자열의 콘텐츠를 Manifest 명세에 명시된 접근 방식을 기반으로 현지화할 것으로 예상됩니다.
Rob Dolin이 많은 작업, 특히 iarc_rating_id 멤버를 주도해 주신 점, 그리고 이러한 아이디어를 검토하는 데 도움을 주신 Kenneth Rohde
Christiansen께 감사드립니다.
다음 기여자 여러분께도 감사드립니다: Christian Liebel, Julien Cayzac, Marcos Cáceres, Thomas Steiner, Xiaoqian Wu, 그리고 Yajing Tang.
categories
§2.1
description
§2.2
form_factor
§3.3
iarc_rating_id
§2.3
label
§3.1
platform
§3.2
screenshots
§2.4
manifest의 아이콘(icons)
manifest의 name
ImageResource
sizes (ImageResource용)
Referenced in: