MiniApp 매니페스트

MiniApp 매니페스트는 루트에 다음 멤버를 포함해야(MUST) 합니다.

• app_id
• icons
• name
• pages
• platform_version
• version

image resource 객체는 MiniApp 매니페스트의 icons 멤버 안에서 다음을 포함해야(MUST) 합니다.

• src

MiniApp 매니페스트는 루트에 widgets 멤버를 포함할 수(MAY) 있습니다. 이 멤버는 list)인 MiniApp 위젯 리소스의 배열을 포함해야(MUST) 합니다. 각 MiniApp 위젯 리소스 객체는 다음 멤버를 포함해야(MUST) 합니다.

• name
• path

MiniApp 매니페스트는 루트에 req_permissions 멤버를 포함할 수(MAY) 있습니다. 이 멤버는 list)인 MiniApp 권한 리소스의 배열을 포함해야(MUST) 합니다. 각 MiniApp 권한 리소스 객체는 다음 멤버를 포함해야(MUST) 합니다.

• name

MiniApp 사용자 에이전트는 매니페스트의 공급업체별 확장을 구현하여 선택적 멤버를 지원할 수(MAY) 있습니다.

다음 표는 MiniApp 매니페스트의 멤버 요약을 보여줍니다.

MiniApp 매니페스트는 다음 필수 application manifest 멤버를 사용합니다.

다음 멤버는 Web App Manifest - Application Information 명세 [MANIFEST-APP-INFO]에 정의되어 있습니다.

다음 멤버는 MiniApp 매니페스트의 범위 아래에서 정의되며, MiniApp의 특정 측면을 다룹니다.

appIdRule = name *("." name)
name = ALPHA [*( ALPHA / DIGIT / "-" ) ( ALPHA / DIGIT)]

MiniApp 매니페스트는 Application manifest의 확장으로서, [APPMANIFEST]에 정의된 manifest 처리 알고리즘의 확장 지점에서 처리될 보충 알고리즘을 제공합니다. 따라서 사용자 에이전트는 Application manifest의 멤버를 처리하는 것으로 시작하고, 확장 지점에서 다음 알고리즘을 사용하여 MiniApp 매니페스트 멤버 처리를 계속합니다.

ordered map json 및 ordered map manifest가 주어졌을 때, 확장 지점에서 MiniApp 매니페스트를 처리하려면:

1. manifest["name"]이 존재하지 않으면, throw a TypeError합니다.
2. manifest["icons"]가 존재하지 않으면, throw a TypeError합니다.
3. icons를 manifest["icons"]로 둡니다.
4. icons["src"]가 존재하지 않으면, throw a TypeError합니다.
5. manifest["icons"]가 존재하지 않으면, throw a TypeError합니다.
6. json 및 manifest를 전달하여 app_id 멤버를 처리합니다.
7. manifest["app_id"]가 존재하지 않으면, throw a TypeError합니다.
8. json 및 manifest를 전달하여 color_scheme 멤버를 처리합니다.
9. json 및 manifest를 전달하여 description 멤버를 처리합니다.
10. json 및 manifest를 전달하여 device_type 멤버를 처리합니다.
11. json 및 manifest를 전달하여 pages 멤버를 처리합니다.
12. manifest["pages"]가 존재하지 않으면, throw a TypeError합니다.
13. json 및 manifest를 전달하여 platform_version 멤버를 처리합니다.
14. manifest["platform_version"]이 존재하지 않으면, throw a TypeError합니다.
15. json 및 manifest를 전달하여 req_permissions 멤버를 처리합니다.
16. json 및 manifest를 전달하여 version 멤버를 처리합니다.
17. manifest["version"]이 존재하지 않으면, throw a TypeError합니다.
18. json 및 manifest를 전달하여 widgets 멤버를 처리합니다.
19. json 및 manifest를 전달하여 window 멤버를 처리합니다.

MiniApp 플랫폼 버전 리소스의 min_code 멤버는 MiniApp의 정상 작동을 보장하기 위해 MiniApp 사용자 에이전트 플랫폼의 최소 지원 버전을 나타내는 음이 아닌 정수입니다.

ordered map json 및 ordered map platform_version이 주어졌을 때, 플랫폼 버전의 min_code 멤버를 처리하려면:

1. json["min_code"]가 존재하지 않거나, json["min_code"]가 number가 아니면 failure를 반환합니다.
2. platform_version["min_code"]를 json["min_code"]로 설정합니다.

MiniApp 플랫폼 버전 리소스의 release_type 멤버는 애플리케이션 실행에 필요한 MiniApp 사용자 에이전트의 대상 플랫폼 버전의 릴리스 타입을 나타내는 string입니다.

ordered map json 및 ordered map platform_version이 주어졌을 때, 플랫폼 버전의 release_type 멤버를 처리하려면:

1. json["release_type"]이 존재하지 않거나, json["release_type"]이 string이 아니면 반환합니다.
2. platform_version["release_type"]을 json["release_type"]으로 설정합니다.

MiniApp 플랫폼 버전 리소스의 target_code 멤버는 MiniApp의 정상 작동을 보장하기 위해 MiniApp 사용자 에이전트 플랫폼의 대상 지원 버전을 나타내는 음이 아닌 정수입니다.

ordered map json 및 ordered map platform_version이 주어졌을 때, 플랫폼 버전의 target_code 멤버를 처리하려면:

1. json["target_code"]가 존재하지 않거나, json["target_code"]가 number가 아니면 반환합니다.
2. platform_version["target_code"]를 json["target_code"]로 설정합니다.

MiniApp 권한 리소스의 name 멤버는 요청된 기능의 이름을 나타내는 string입니다.

ordered map json 및 ordered map permission이 주어졌을 때, 권한 리소스의 name 멤버를 처리하려면:

1. json["name"]이 존재하지 않거나,
   json["name"]이 string이 아니거나, json["name"]이 빈 문자열이면 반환합니다.
2. permission["name"]을 json["name"]으로 설정합니다.

선택적 MiniApp 권한 리소스의 reason 멤버는 [MiniApp permission resource/name=] 속성에 지정된 기능을 요청하기 위해 제시된 이유를 나타내는 string입니다.

ordered map json 및 ordered map permission이 주어졌을 때, 권한 리소스의 reason 멤버를 처리하려면:

1. json["reason"]이 존재하지 않거나,
   json["reason"]이 string이 아니거나, json["reason"]이 빈 문자열이면 반환합니다.
2. permission["reason"]을 json["reason"]으로 설정합니다.

MiniApp 버전 리소스의 code 멤버는 MiniApp의 버전을 나타내는 음이 아닌 정수입니다. 이는 주로 MiniApp의 유지 관리성과 보안을 향상하는 데 사용됩니다(예: 증분 버전 간 호환성). code 멤버는 개발 및 배포 프로세스를 지원하는 것을 목표로 하며, 일반적으로 최종 사용자에게 표시되지 않습니다.

ordered map json 및 ordered map version이 주어졌을 때, 버전의 code 멤버를 처리하려면:

1. json["code"]가 존재하지 않거나, json["code"]가 number가 아니면 failure를 반환합니다.
2. version을 처음에는 1인 number로 둡니다.
3. json["code"]가 0보다 크면:
   version을 json["code"]로 설정합니다.
4. version["code"]를 version으로 설정합니다.

MiniApp 버전 리소스의 name 멤버는 MiniApp의 버전에 대한 정보를 설명하는 데 주로 사용되는 string이며, 버전 제어, MiniApp 애플리케이션 및 플랫폼 호환성에서 필수적인 역할을 합니다. 일반적으로 공개적으로 표시되고 사용자에게 표시되는 버전으로 간주됩니다.

ordered map json 및 ordered map version이 주어졌을 때, 버전의 name 멤버를 처리하려면:

1. json["name"]이 존재하지 않거나, json["name"]이 string이 아니면 failure를 반환합니다.
2. version["name"]을 json["name"]으로 설정합니다.

MiniApp 위젯 리소스의 name 멤버는 위젯의 제목을 나타내는 string입니다.

ordered map json 및 ordered map widget이 주어졌을 때, 위젯의 name 멤버를 처리하려면:

1. json["name"]이 존재하지 않거나, json["name"]이 string이 아니면 반환합니다.
2. widget["name"]을 json["name"]으로 설정합니다.

MiniApp 위젯 리소스의 path 멤버는 위젯의 대응하는 페이지 라우트를 정의하는 relative-url string이며, pages list에서와 같이 표현됩니다.

ordered map json 및 ordered map widget이 주어졌을 때, 위젯의 path 멤버를 처리하려면:

1. json["path"]가 존재하지 않거나, json["path"]가 string이 아니면 반환합니다.
2. url을 json["path"]를 파싱한 결과로 둡니다.
3. url이 failure이면 반환합니다.
4. widget["path"]를 url로 설정합니다.

선택적 MiniApp 위젯 리소스의 min_code 멤버는 MiniApp 위젯에 대해 지원되는 최소 플랫폼 버전을 나타내는 number입니다.

ordered map json, ordered map widget 및 ordered map manifest가 주어졌을 때, 위젯의 min_code 멤버를 처리하려면:

1. widget["min_code"]를 manifest["min_code"]로 설정합니다.
2. json["min_code"]가 존재하지 않거나, json["min_code"]가 string이 아니면 반환합니다.
3. widget["min_code"]를 json["min_code"]로 설정합니다.

auto_design_width 멤버는 페이지의 design_width 가 사용자 에이전트에 의해 자동 계산되는지를 나타내는 boolean입니다. auto_design_width 가 true이면, design_width 의 값은 무시됩니다. 이 경우 시스템의 기준 너비는 화면의 픽셀 밀도에 따라 자동으로 결정됩니다.

기본값: false.

ordered map json 및 ordered map window가 주어졌을 때, window의 auto_design_width 멤버를 처리하려면:

1. json["auto_design_width"]가 존재하지 않거나, json["auto_design_width"]가 boolean이 아니면 반환합니다.
2. window["auto_design_width"]를 json["auto_design_width"]로 설정합니다.

background_color 멤버는 MiniApp을 포함하는 창의 배경색을 지정하는 string입니다.

이 멤버는 sRGB 색상을 지원하며, application manifest의 background_color와 동일합니다.

기본값: "#ffffff".

background_text_style 멤버는 밝은 색 테마 또는 어두운 색 테마(즉, "light" 또는 "dark")를 나타내는 배경 텍스트 스타일을 지정하는 string입니다.

이 멤버는 prefers-color-scheme 값을 지원하며, 다음 background text style 값 중 하나를 포함해야(MUST) 합니다.

"light"

밝은 스타일용.

"dark" (기본값)

어두운 스타일용.

ordered map json 및 ordered map window가 주어졌을 때, window의 background_text_style 멤버를 처리하려면:

1. json["background_text_style"]가 존재하지 않거나,
   json["background_text_style"]가 string이 아니거나,
   json["background_text_style"]가 포함하지 않는 경우, 즉 background text style 값 중 하나를 포함하지 않으면 반환합니다.
2. window["background_text_style"]를 json["background_text_style"]로 설정합니다.

design_width 멤버는 pixel unit 단위에서 페이지 디자인의 기준 너비를 나타내는 number입니다. 이는 페이지 컴포넌트를 시각적으로 조정하는 데 사용됩니다.

값은 음이 아닌 정수이며 기본값은 750입니다.

ordered map json 및 ordered map window가 주어졌을 때, window의 design_width 멤버를 처리하려면:

1. json["design_width"]가 존재하지 않거나,
   json["design_width"]가 number가 아니거나, json["design_width"]가 0보다 작으면 반환합니다.
2. window["design_width"]를 json["design_width"]로 설정합니다.

enable_pull_down_refresh 멤버는 MiniApp과의 상호작용 중에 pull-to-refresh 이벤트가 활성화되는지를 지정하는 boolean입니다.

기본값: false.

ordered map json 및 ordered map window가 주어졌을 때, window의 enable_pull_down_refresh 멤버를 처리하려면:

1. json["enable_pull_down_refresh"]가 존재하지 않거나,
   또는 json["enable_pull_down_refresh"]가 boolean이 아니면 반환합니다.
2. window["enable_pull_down_refresh"]를 json["enable_pull_down_refresh"]로 설정합니다.

fullscreen 멤버는 MiniApp이 전체 화면 표시 모드로 표시되는지를 나타내는 boolean입니다.

기본값: false.

ordered map json 및 ordered map window가 주어졌을 때, window의 fullscreen 멤버를 처리하려면:

1. json["fullscreen"]가 존재하지 않거나,
   또는 json["fullscreen"]가 boolean이 아니면 반환합니다.
2. window["fullscreen"]를 json["fullscreen"]로 설정합니다.

navigation_bar_background_color 멤버는 MiniApp의 내비게이션 바 배경색을 지정하는 string입니다.

이 멤버는 sRGB 색상을 지원합니다.

기본값: "#000000".

이 멤버는 [APPMANIFEST]에 지정된 내용에 따라 처리됩니다.

navigation_bar_text_style 멤버는 내비게이션 바 제목의 텍스트 색상(즉, "white" 또는 "black")을 나타내는 string입니다.

이 멤버는 다음 text style 값 중 하나를 포함해야(MUST) 합니다.

"white" (기본값)

흰색 텍스트 색상용.

"black"

검은색 텍스트 색상용.

ordered map json 및 ordered map window가 주어졌을 때, window의 navigation_bar_text_style 멤버를 처리하려면:

1. json["navigation_bar_text_style"]가 존재하지 않거나,
   json["navigation_bar_text_style"]가 string이 아니거나,
   json["navigation_bar_text_style"]가 text style 값 중 하나를 포함하지 않으면 반환합니다.
2. window["navigation_bar_text_style"]를 json["navigation_bar_text_style"]로 설정합니다.

navigation_bar_title_text 멤버는 MiniApp의 내비게이션 바 제목을 지정하는 string입니다.

ordered map json 및 ordered map window가 주어졌을 때, window의 navigation_bar_title_text 멤버를 처리하려면:

1. json["navigation_bar_title_text"]가 존재하지 않거나,
   json["navigation_bar_title_text"]가 string이 아니면 반환합니다.
2. window["navigation_bar_title_text"]를 json["navigation_bar_title_text"]로 설정합니다.

navigation_style 멤버는 내비게이션 바의 스타일(즉, "default" 또는 "custom")을 지정하는 string입니다.

이 멤버는 다음 navigation style 값 중 하나를 포함해야(MUST) 합니다.

"default" (기본값)

기본 스타일 적용용.

"custom"

사용자 지정 내비게이션 바 적용용.

ordered map json 및 ordered map window가 주어졌을 때, window의 navigation_style 멤버를 처리하려면:

1. json["navigation_style"]가 존재하지 않거나,
   json["navigation_style"]가 string이 아니거나,
   json["navigation_style"]가 포함하지 않는 경우, 즉 navigation style 값 중 하나를 포함하지 않으면 반환합니다.
2. window["navigation_style"]를 json["navigation_style"]로 설정합니다.

on_reach_bottom_distance 멤버는 페이지 pull-up 이벤트를 트리거하기 위해 필요한, 창 하단으로부터의 수직 오프셋을 정의하는 number입니다. 이 멤버의 값은 pixel unit으로 표현되는 음이 아닌 정수입니다.

기본값: 50.

ordered map json 및 ordered map window가 주어졌을 때, window의 on_reach_bottom_distance 멤버를 처리하려면:

1. json["on_reach_bottom_distance"]가 존재하지 않거나,
   json["on_reach_bottom_distance"]가 number가 아니거나,
   json["on_reach_bottom_distance"]가 0보다 작으면 반환합니다.
2. window["on_reach_bottom_distance"]를 json["on_reach_bottom_distance"]로 설정합니다.

orientation 멤버는 MiniApp의 화면 방향 구성을 지정하는 string입니다.

이 멤버는 OrientationLockType [SCREEN-ORIENTATION]에 정의된 orientation 값: "portrait" 및 "landscape"를 지원합니다.

기본값: "portrait".

ordered map json 및 ordered map window가 주어졌을 때, window의 orientation 멤버를 처리하려면:

1. json["orientation"]이 존재하지 않거나,
   json["orientation"]이 string이 아니거나,
   json["orientation"]이 포함하지 않는 경우, 즉 orientation 값 중 하나를 포함하지 않으면 반환합니다.
2. window["orientation"]을 json["orientation"]으로 설정합니다.