uap:Rule(Windows 10)

아티클
10/30/2023

웹 컨텍스트에서 시스템의 지리적 위치 디바이스에 액세스할 수 있는 페이지(앱에 이 기능에 액세스할 수 있는 권한이 있는 경우) 및 클립보드에 대한 액세스를 지정합니다.

요소 계층 구조

<uap:Rule>

구문

<uap:Rule
      Type = 'A string that can have one of the following values: "include" or "exclude".'
      Match = 'A string with a value between 1 and 2084 characters in length.'
      WindowsRuntimeAccess = 'An optional string that can have one of the following values: "allowForWebOnly", "all", or "none".' 
      uap5:ServiceWorker = 'An optional boolean value.' />

특성 및 요소

특성

attribute	Description	데이터 형식	필수	기본값
형식	규칙이 포함 또는 제외 규칙인지 여부를 지정하는 문자열입니다.	다음 값 중 하나를 포함하거나 제외할 수 있는 문자열입니다.	Yes
일치	규칙에 사용할 IRI입니다. 자세한 내용은 RFC 3987: IRI(Internationalized Resource Identifiers)를 참조하세요. 패키지의 애플리케이션별로 고유하며 대/소문자를 구분합니다. 예를 들어 일치 값은 , 또는 `*.pdf`일 수 있습니다`https://www.microsoft.com/`.	길이가 1~2084자인 문자열입니다.	Yes
WindowsRuntimeAccess	원격 사이트에서 UWP(Windows 런타임) 액세스를 선언합니다. 이 특성은 개발자에게 웹 사이트에서 UWP API에 액세스할 수 있는 URI 집합을 지정하는 제어 기능을 제공합니다. Type이 로 설정된 `exclude`경우 이 특성은 허용되지 않습니다.	allowForWebOnly(개발자가 만들고 앱 패키지 내에 포함된 UWP API만 노출됨), 모든 값(허용되는 모든 UWP API를 사용할 수 있음을 나타냅니다.) 또는 없음(명시적으로 UWP API가 노출되지 않음을 명시)을 포함할 수 있는 선택적 문자열입니다.	No	없음
uap5:ServiceWorker	이는 UWP 앱으로 실행하기 위해 웹 페이지(프로그레시브 웹앱)에서 서비스 작업자를 등록한 것을 나타냅니다. true이면 앱이 탐색하는 URL에 앱을 서비스 작업자로 등록하는 데 필요한 권한이 있는지 여부가 결정됩니다.	선택적 부울 값입니다.	No

참고

JavaScript 코드에 노출하려는 UWP Windows 런타임 클래스는 선언된 AllowForWeb 특성으로 데코레이팅되어야 합니다.

자식 요소

없음

부모 요소

부모 요소	Description
uap:ApplicationContentUriRules	웹 컨텍스트에서 시스템의 지리적 위치 디바이스에 액세스할 수 있는 페이지(앱에 이 기능에 액세스할 수 있는 권한이 있는 경우) 및 클립보드에 대한 액세스를 지정합니다.

설명

둘 이상의 규칙이 정의되면 규칙의 순서가 중요합니다.

웹 리소스에 대한 IRI를 사용하여 Match 특성을 정의하려면 보안 https: 사이트만 지정할 수 있습니다. 안전하지 않은 "http:" 사이트는 허용되지 않습니다. 사이트를 지정 http: 하면 스키마 의미 체계 검사 유효성 검사 오류가 발생합니다.

Windows 8.1(버전 6.3.0)에 스키마가 있는 값의 경우 매니페스트는 보안 https: 체계만 허용합니다. 매니페스트는 다른 구성표에 실패합니다. 이 규칙은 이전 버전과의 호환성을 위해 Windows 8 앱에는 적용되지 않습니다.

요구 사항

항목	값
Namespace	`http://schemas.microsoft.com/appx/manifest/uap/windows10`
Minimum OS Version	Windows 10 버전 1511(빌드 10586)