애플리케이션(Windows 10)

  • 아티클

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

요소 계층 구조

<패키지>

    <애플리케이션>

         <애플리케이션>

Syntax

<Application
  EntryPoint? = 'See the Attributes table for more info.'
  Executable?
  uap10:HostId?
  Id
  uap10:Parameters?
  ResourceGroup?
  uap10:RuntimeBehavior?
  StartPage?
  desktop4:Subsystem?
  uap10:Subsystem?
  desktop4:SupportsMultipleInstances?
  uap10:SupportsMultipleInstances?
  uap10:TrustLevel?
  uap16:BaseNamedObjectsIsolation?
  uap17:BaseNamedObjectsIsolation?
  desktop11:AppLifecycleBehavior?
  uap11:CurrentDirectoryPath?
  uap11:Parameters?

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

</Application>

키

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

특성 및 요소

특성

attribute Description 데이터 형식 필수 기본값
EntryPoint 활성화 가능한 클래스 ID(예: "Office.Winword.Class") 또는 "windows.fullTrustApplication" 또는 "windows.partialTrustApplication"입니다. EntryPoint를 지정하는 경우 실행 파일 특성도 지정해야 합니다. EntryPoint를 지정하는 경우 StartPage 특성을 지정하면 안 됩니다. 확장을 처리하는 작업을 나타내는 길이가 1~256자인 문자열입니다. 일반적으로 Windows 런타임 형식의 정규화된 네임스페이스 이름이지만 특수 값 "windows.fullTrustApplication" 또는 "windows.partialTrustApplication" 중 하나일 수 있습니다. EntryPoint를 지정하지 않으면 앱에 대해 정의된 EntryPoint가 대신 사용됩니다. No
실행 파일 앱의 기본 시작 실행 파일입니다. 지정된 파일이 패키지에 있어야 합니다. 이전 시스템에서(자세한 내용은 설명 섹션 참조) 실행 파일을 지정하는 경우 EntryPoint 특성도 지정해야 합니다. 실행 파일을 지정하는 경우 StartPage 특성을 지정하면 안 됩니다. 로 끝나 .exe 야 하며 , ">:|?또는 *문자를 포함할 수 없는 길이가 1~256자<인 문자열입니다. No
uap10:HostId 현재 앱에 대한 호스트 앱의 앱 ID입니다. 이 특성은 호스트된 앱에 사용됩니다. 길이가 1~255자인 영숫자 문자열입니다. 문자로 시작해야 합니다. No
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, LPT8 및 LPT9. Yes
uap10:Parameters 앱에 전달할 명령줄 매개 변수를 포함합니다. 패키지 ID가 있는 데스크톱 앱 에 대해서만 지원됩니다( 배포 개요 참조). 시작과 끝에 공백이 아닌 문자가 있는 길이가 1자에서 32767자 사이의 문자열입니다. No
ResourceGroup 리소스 관리 목적(예: CPU 및 메모리)을 위해 확장 활성화를 함께 그룹화하는 데 사용되는 태그입니다. Application@ResourceGroup설명 섹션을 참조하세요. 길이가 1~255자인 영숫자 문자열입니다. 문자로 시작해야 합니다. No
uap10:RuntimeBehavior 앱의 런타임 동작을 지정합니다.

"packagedClassicApp"-WinUI 3 앱 또는 데스크톱 브리지 앱(Centennial). WinUI 3 앱의 경우 일반적으로 "mediumIL"의 TrustLevel 을 사용합니다(하지만 "appContainer"도 옵션임).

"win32App"- 외부 위치로 패키지된 앱을 포함하여 다른 종류의 Win32 앱입니다. 일반적으로 "mediumIL"의 TrustLevel 을 사용합니다(그러나 "appContainer"도 옵션임).

"windowsApp"-UWP(유니버설 Windows 플랫폼) 앱입니다. 항상 "appContainer"의 TrustLevel 을 사용합니다.

모든 공통 속성(일부는 에 appxmanifest.xml선언됨)을 공유하고 패키지 ID 및 애플리케이션 ID를 사용하여 프로세스로 실행됩니다. 두 그룹에 있는 것으로 생각할 수 있습니다. 한 그룹은 UWP 앱("windowsApp")입니다. 다른 하나는 기본 또는 WinMain을 사용한 Windows .exes("packagedClassicApp" 또는 "win32App")입니다. 두 번째 그룹을 데스크톱 앱이라고도 합니다.		 "packagedClassicApp", "win32App" 또는 "windowsApp" 값 중 하나가 있는 문자열입니다. No
StartPage 확장성 지점을 처리하는 웹 페이지입니다. , 또는 문자를 포함할 수 없는 길이가 1~256자<":|>?인 문자열입니다.* 유효한 URI 또는 IRI(비 ASCII 버전의 URI)입니다. No
desktop4:하위 시스템 앱이 표준 UWP 앱인지 UWP 콘솔 앱인지 여부를 나타냅니다. 콘솔 또는 창 값 중 어느 것이든 될 수 있는 문자열입니다. No
uap10:하위 시스템 앱이 표준 UWP 앱인지 UWP 콘솔 앱인지 여부를 나타냅니다. 콘솔 또는 창 값 중 어느 것이든 될 수 있는 문자열입니다. No
desktop4:SupportsMultipleInstances UWP 앱의 여러 개별 인스턴스에 대한 지원을 나타냅니다. 자세한 내용은 설명 섹션을 참조하세요. 부울 값입니다. No
uap10:SupportsMultipleInstances UWP 앱의 여러 개별 인스턴스에 대한 지원을 나타냅니다. 자세한 내용은 설명 섹션을 참조하세요. 부울 값입니다. No
uap10:TrustLevel 앱의 신뢰 수준을 지정합니다.

"mediumIL"- 앱이 완전 신뢰입니다. 프로세스는 중간 의 무결성 수준으로 실행됩니다( 필수 무결성 제어 참조). "완전 신뢰 권한 수준" 제한된 기능이 필요합니다( 앱 기능 선언 참조).

"appContainer"- 앱은 간단한 앱 컨테이너에서 실행됩니다( MSIX AppContainer 앱 참조). 프로세스는 무결성 수준이 낮은 상태로 실행됩니다. 패키지되지 않은 앱이 AppContainer에서 실행되기도 합니다.		 "mediumIL" 또는 "appContainer" 값 중 하나가 있는 문자열입니다. No
uap16:BaseNamedObjectsIsolation 앱에 대해 BNO(BaseNameObject) 격리를 사용하도록 설정합니다. 패키지 또는 없음 값 중 하나일 수 있는 문자열입니다. No
uap17:BaseNamedObjectsIsolation 앱에 대해 BNO(BaseNameObject) 격리를 사용하도록 설정합니다. 패키지 또는 없음 값 중 하나일 수 있는 문자열입니다. No
desktop11:AppLifecycleBehavior 앱이 확장에 대한 런타임 동작과 연결된 수명 주기 동작을 재정의할 수 있습니다. RuntimeBehavior가 "windowsApp"인 앱 또는 확장에는 달리 지정하지 않는 한 암시적으로 AppLifecycleBehavior의 "systemManaged"가 있습니다. RuntimeBehavior가 "packagedClassicApp" 또는 "win32App"인 앱 또는 확장에는 달리 지정하지 않는 한 AppLifecycleBehavior가 암시적으로 "관리되지 않음"으로 표시됩니다. 다음 값 중 하나: "systemManaged" , "unmanaged". No
uap11:CurrentDirectoryPath 애플리케이션 프로세스가 시작될 때 초기 디렉터리를 지정합니다. 이 특성은 매크로를 지원합니다. 자세한 내용은 패키지 매니페스트 스키마의 매크로를 참조하세요. , ?>|또는 *문자를 <포함할 수 없는 선택적 문자열입니다. > No
uap11:Parameters 이 특성은 기본 확장 구문에서 상속되며 com4 확장에는 적용되지 않습니다. 구문 유효성 검사 외에 이 값은 무시됩니다. 이 특성은 매크로를 지원합니다. 자세한 내용은 패키지 매니페스트 스키마의 매크로를 참조하세요. 시작과 끝에 공백이 아닌 문자가 있는 길이가 1~32767자인 선택적 문자열입니다. No

자식 요소

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

부모 요소

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

설명

Application 요소에는 앱과 관련된 확장성 지점에 공통적인 특성이 포함되어 있습니다. 이 정보는 다른 확장성 지점에서 앱에 대한 정보를 가져오는 데 사용됩니다. 애플리케이션 특성은 앱의 instance 시작 및 관리에서 활성화 정보로도 사용됩니다(즉, 프로세스를 시작하는 방법 및 동작을 설명함).

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

uap10은 Windows 10 버전 2004(10.0; 빌드 19041)

네임스페이 uap10 스(및 uap10:TrustLevel용uap10:RuntimeBehavior)는 Windows 10 버전 2004(10.0; 빌드 19041). 패키지가 이전 시스템에 설치되는 경우 동일한 특성 조합을 제공해야 합니다(다음 섹션 참조). 그렇지 않으면 활성화 정보가 불완전하고 설치가 실패합니다.

그러나 패키지에 <TargetDeviceFamily MinVersion="10.0.19041.0">가 있는 경우 네임스페이스를 지원하는 uap10 시스템에만 설치됩니다. 이 경우 이전의 동등한 조합에 대한 기본 설정에서 및 uap10:TrustLevel 특성을 사용해야 uap10:RuntimeBehavior 합니다(다음 섹션 참조).

활성화 정보 특성의 조합

Application 요소에서 활성화 정보 특성을 지정할 수 있습니다. 필요에 따라 app-scope Extension 요소에 지정할 수 있습니다. 확장에 지정되지 않은 경우 부모 애플리케이션에서 상속됩니다. 이러한 특성을 조합으로 지정합니다. 예를 들어 EntryPoint, RuntimeBehavior 및 TrustLevel 은 겹치는 의미를 가지며 조합으로 지정(및/또는 상속됨)합니다. 다음은 활성화 정보 특성의 몇 가지 유효한 조합입니다.

  1. 실행 파일, uap10:RuntimeBehavior="packagedClassicApp", uap10:TrustLevel=["mediumIL", 또는 "appContainer"(생략된 경우 기본값)
  2. 실행 파일, uap10:RuntimeBehavior="win32App", uap10:TrustLevel="mediumIL"(다른 요구 사항은 이 항목의 앞부분에서 uap10:RuntimeBehavior에 대한 설명을 참조하세요).
  3. 실행 파일, EntryPoint="windows.fullTrustApplication"( uap10:RuntimeBehavior="packagedClassicApp", uap10:TrustLevel="mediumIL"과 동일)
  4. 실행 파일, EntryPoint="windows.partialTrustApplication"( uap10:RuntimeBehavior="packagedClassicApp", uap10:TrustLevel="appContainer"에 해당)
  5. 실행 파일, EntryPoint="<기타> 항목"

보듯이 대상 시스템에서 네임스페이스를 지원하지 uap10 않는 경우 EntryPoint 특성을 대신 지정할 수 있습니다. 마찬가지로 이전 시스템의 uap10:TrustLevel="appContainer"'에 해당하는 항목은 EntryPoint="windows.partialTrustApplication"입니다.

그러나 uap10:RuntimeBehavior/uap10:TrustLevel 및 EntryPoint 를 동시에 지정하는 것은 중복됩니다. 그러나 그렇게 하면 모순되는 경우 오류입니다.

UWP(유니버설 Windows 플랫폼) 앱 활성화에는 EntryPoint가 필요합니다. 따라서 Executable 및 uap10:RuntimeBehavior="windowsApp"( EntryPoint 없음)을 지정하면 오류가 발생합니다. 이 경우 EntryPoint 는 "windows.fullTrustApplication" 및 "windows.partialTrustApplication" 이외의 항목을 지정합니다. 및 두 값이 아닌 값은 이미 uap10:RuntimeBehavior="windowsApp"과 동일한 것을 말합니다. 따라서 이 경우 uap10:RuntimeBehavior 가 중복되고 실행 파일 및 EntryPoint를 지정합니다.

uap10:RuntimeBehavior="win32App" 및 uap10:TrustLevel="appContainer" 설정은 지원되지 않습니다.

while uap10:RuntimeBehavior="windowsApp" 를 Microsoft.coreAppActivation_8wekyb3d8bbwe 설정 uap10:TrustLevel="mediumIL" 하려면 사용자 지정 기능이 필요합니다.

및 EntryPoint 가 또는 "windows.partialTrustApplication"이외의 "windows.fullTrustApplication" 값인 경우에도 uap10:TrustLevel="mediumIL" 마찬가지입니다.

이 사용자 지정 기능에 대한 자세한 내용은 사용자 지정 기능에서 확인할 수 있습니다.

다중 인스턴스화 앱에 대한 중요 정보

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

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

요구 사항

항목 값
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