애플리케이션(Windows 10)

패키지에 제공된 기능의 일부 또는 전부를 구성하는 앱을 나타냅니다.

요소 계층 구조

<패키지>

    <애플리케이션>

         <애플리케이션>

Syntax

<Application
  Id = 'An ASCII string between 1 and 64 characters in length. See the Attributes table for more information on character restrictions.'
  Executable = 'A string with an optional value between 1 and 256 characters in length, that must end with ".exe", and cannot contain the following characters: <, >, :, ", |, ?, or *. Specifies the default executable for the extension. If not specified, the executable defined for the app is used.  If specified, the EntryPoint property is also used. If the EntryPoint property is not specified, the EntryPoint defined for the app is used.'
  EntryPoint = 'A string with an optional value between 1 and 256 characters in length. Represents the task handling the extension (normally the fully namespace-qualified name of a Windows Runtime type). If EntryPoint is not specified, the EntryPoint defined for the app is used instead.'
  StartPage = 'Any valid URI or IRI (the non-ASCII version of a URI). See below for more details.' 
  ResourceGroup = 'An alphanumeric string between 1 and 255 characters in length. Must begin with an letter.'
  desktop4:Subsystem = 'A string that can have one of the following values: "console" or "windows".'
  uap10:Subsystem = 'A string that can have one of the following values: "console" or "windows".'
  desktop4:SupportsMultipleInstances = 'An optional boolean value.'
  uap10:SupportsMultipleInstances = 'An optional boolean value.'
  uap10:TrustLevel = 'A string that can have one of the following values: "appContainer" or "mediumIL".'
  uap10:RuntimeBehavior  = 'A string that can have one of the following values: "windowsApp", "packagedClassicApp", or "win32App".'
  uap10:HostId = 'An alphanumeric string between 1 and 255 characters in length. Must begin with a letter.'
  uap10:Parameters   = 'A string between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.' >

  <!-- Child elements -->
  uap:VisualElements
  uap:ApplicationContentUriRules?
  Extensions?

</Application>

? 선택적(0개 또는 1개) & 인터리브 커넥터(임의의 순서로 발생할 수 있음)

특성 및 요소

특성

attribute 설명 데이터 형식 필수 기본값
ID 패키지 내에서 애플리케이션의 고유 식별자입니다. PRAID(패키지 상대 앱 식별자)라고도 합니다. ID는 패키지 내에서 고유하지만 전역적으로는 고유하지 않습니다. 같은 ID를 사용하는 시스템에 다른 패키지가 있을 수 있습니다. 동일한 패키지에서 동일한 ID를 두 번 이상 사용할 수 없습니다. Visual Studio 템플릿을 사용하는 경우 이 특성의 기본값은 App입니다. 개발자는 매니페스트에서 수동으로 변경해야 합니다. 앱이 Microsoft Store에 게시된 후에는 앱의 식별자를 변경하면 안 됩니다. 이렇게 하면 시작 화면에서 타일의 위치가 중단됩니다. 길이가 1~64자인 ASCII 문자열입니다. 이 문자열에는 마침표로 구분된 영숫자 필드가 있습니다. 각 필드는 ASCII 알파벳 문자로 시작해야 합니다. CON, PRN, AUX, NUL, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8LPT9로 사용할 수 없습니다.
EntryPoint 활성화 가능한 클래스 ID(예: "Office.Winword.Class")입니다. 이 특성을 지정하는 경우 실행 파일 특성도 지정해야 합니다. 이 특성을 지정하는 경우 StartPage 특성을 지정해서는 안 됩니다. 확장을 처리하는 작업을 나타내는 길이가 1자에서 256자 사이의 문자열입니다. 이는 일반적으로 Windows 런타임 형식의 정규화된 네임스페이스 이름입니다. EntryPoint를 지정하지 않으면 앱에 대해 정의된 EntryPoint가 대신 사용됩니다.
실행 파일 앱의 기본 시작 실행 파일입니다. 이 파일은 패키지에 있어야 합니다. 이 특성을 지정하는 경우 EntryPoint 특성을 지정해야 합니다. 이 특성을 지정하는 경우 StartPage 특성을 지정해서는 안 됩니다. 길이가 1자에서 256자 사이의 문자열로 .exe 끝나야 하며 다음 ?>*:|"문자를 <포함할 수 없습니다. 확장의 기본 실행 파일을 지정합니다. 지정하지 않으면 앱에 대해 정의된 실행 파일이 사용됩니다. 지정한 경우 EntryPoint 속성도 사용됩니다. 해당 EntryPoint 속성을 지정하지 않으면 앱에 대해 정의된 EntryPoint가 사용됩니다. 아니요
StartPage 확장성 지점을 처리하는 웹 페이지입니다. 다음 문자를 <|*>:"?포함할 수 없는 길이가 1~256자인 문자열입니다.
ResourceGroup 리소스 관리 용도(예: CPU 및 메모리)를 위해 확장 활성화를 함께 그룹화하는 데 사용되는 선택적 태그입니다. Application@ResourceGroup주의 섹션을 참조하세요. 길이가 1~255자인 영숫자 문자열입니다. 문자로 시작해야 합니다. 아니요
desktop4:하위 시스템 앱이 표준 UWP 앱인지 UWP 콘솔 앱인지 여부를 나타냅니다. 콘솔 또는 값 중 어느 것이든 될 수 있는 문자열입니다.
uap10:하위 시스템 앱이 표준 UWP 앱인지 UWP 콘솔 앱인지 여부를 나타냅니다. conole 또는 windows 값 중 어느 것이든 될 수 있는 문자열입니다. 아니요
desktop4:SupportsMultipleInstances UWP 앱의 여러 개별 인스턴스에 대한 지원을 나타냅니다. 자세한 내용은 설명 섹션을 참조하세요. 선택적 부울 값
uap10:SupportsMultipleInstances UWP 앱의 여러 개별 인스턴스에 대한 지원을 나타냅니다. 자세한 내용은 설명 섹션을 참조하세요. 선택적 부울 값입니다.
uap10:TrustLevel 앱의 신뢰 수준을 지정합니다. "appContainer" 또는 "mediumIL" 값 중 어느 것이든 될 수 있는 문자열입니다.
uap10:RuntimeBehavior 앱의 런타임 동작을 지정합니다. "windowsApp", "packagedClassicApp" 또는 "win32App" 값 중에서 사용할 수 있는 문자열입니다. 아니요
uap10:HostId 이 값은 현재 앱에 대한 호스트 앱의 앱 ID를 지정합니다. 이 특성은 호스트된 앱에 사용됩니다. 길이가 1~255자인 영숫자 문자열입니다. 문자로 시작해야 합니다.
uap10:Parameters 앱에 전달할 명령줄 매개 변수를 포함합니다. 패키지 ID가 있는 데스크톱 앱에 대해서만 지원됩니다. 시작과 끝에 공백이 아닌 문자가 있는 길이가 1자에서 32767자 사이의 문자열입니다.

자식 요소

자식 요소 설명
확장(형식: CT_ApplicationExtensions) 앱에 대한 하나 이상의 확장 지점을 정의합니다.
uap:ApplicationContentUriRules 웹 컨텍스트에서 시스템의 지리적 위치 디바이스에 액세스할 수 있는 페이지(앱에 이 기능에 액세스할 수 있는 권한이 있는 경우) 및 클립보드에 대한 액세스를 지정합니다.
uap:VisualElements 앱의 시각적 측면을 설명합니다. 기본 타일, 로고 이미지, 텍스트 및 배경색, 초기 화면 방향, 시작 화면 및 잠금 화면 타일 모양.
uap7:Properties 앱의 속성을 지정합니다.

부모 요소

부모 요소 Description
애플리케이션 패키지를 구성하는 하나 이상의 앱을 나타냅니다.

설명

Application 요소에는 앱과 관련된 확장성 지점에 공통적인 특성이 포함되어 있습니다. 이 정보는 다른 확장성 지점에서 앱에 대한 정보를 가져오는 데 사용됩니다. 또한 애플리케이션 특성은 앱 인스턴스의 시작 및 관리에 사용됩니다.

StartPage는 JavaScript 앱에만 적용됩니다. StartPage를 지정하지 않으면 실행 파일EntryPoint 특성을 모두 지정해야 하며 이는 C#, C++또는 VB 앱에만 적용됩니다.

다중 인스턴싱 앱에 대한 중요한 참고 사항:

  • 앱이 Application 요소 내에서 SupportsMultipleInstances를 선언하는 경우 모든 포그라운드 확장도 다중 인스턴스화됩니다.
  • 앱이 Application 요소 내에서 SupportsMultipleInstances를 선언하는 경우 확장 수준(예: BackgroundTasks 또는 AppService 요소)에서 선언할 필요가 없습니다.
  • 앱은 백그라운드 작업, 백그라운드 오디오 또는 앱 서비스에 대해서만 SupportsMultipleInstances 를 선언해야 합니다.
  • 콘솔 앱은 항상 다중 인스턴스가 되며 SupportsMultipleInstances를 명시적으로 선언해야 합니다.
  • 앱은 매니페스트의 ResourceGroup 선언을 사용하여 여러 백그라운드 작업을 동일한 호스트로 그룹화할 수 있습니다. 이는 각 활성화가 별도의 호스트로 들어가는 다중 인스턴스화와 충돌합니다. 따라서 앱은 매니페스트에서 SupportsMultipleInstancesResourceGroup 을 모두 선언할 수 없습니다.

SupportsMultipleInstances 특성을 사용하여 UWP 앱의 여러 개별 인스턴스를 지원하는 방법에 대한 자세한 내용은 다중 인스턴스 유니버설 Windows 앱 만들기를 참조하세요.

요구 사항

Namespace http://schemas.microsoft.com/appx/manifest/uap/windows10
desktop4 특성 http://schemas.microsoft.com/appx/manifest/desktop/windows10/4
uap10 특성 http://schemas.microsoft.com/appx/manifest/uap/windows10/10