애플리케이션(Windows 8 패키지 스키마)

아티클
07/20/2023

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

요소 계층 구조

<애플리케이션>: <애플리케이션>

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 between 1 and 256 characters in length that must end with ".exe" and cannot contain these characters: <, >, :, %, ", |, ?, or *. It 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 that EntryPoint property isn't specified, the EntryPoint defined for the app is used.
             EntryPoint? = A string between 1 and 256 characters in length, representing the task  handling the extension. This is 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?  = A string between 1 and 256 characters in length that cannot contain these characters: <, >, :, %, ", |, ?, or *. >

  <!-- Child elements -->
  ( VisualElements
  & ApplicationContentUriRules?
  & Extensions?
  )

</Application>

키

? 선택 사항(0개 또는 1개)

& 인터리브 커넥터(임의의 순서로 발생할 수 있음)

특성 및 요소

특성

attribute	Description	데이터 형식	필수
EntryPoint	활성화 가능한 클래스 ID(예: ""Office)입니다. Winword.Class". 데스크톱 앱의 경우 이 값은 "main", "WinMain" 또는 "wWinMain"과 같은 실행 파일의 실제 진입점이어야 합니다. 이 특성을 지정하는 경우 Executable 특성도 지정해야 합니다. 이 특성을 지정하는 경우 StartPage 특성을 지정해서는 안 됩니다.	확장을 처리하는 작업을 나타내는 길이가 1~256자인 문자열입니다. 이는 일반적으로 Windows 런타임 형식의 정규화된 네임스페이스 이름입니다. EntryPoint를 지정하지 않으면 앱에 대해 정의된 EntryPoint가 대신 사용됩니다.	아니요
실행 파일	앱의 기본 시작 실행 파일입니다. 이 파일은 패키지에 있어야 합니다. 이 특성을 지정하는 경우 EntryPoint 특성을 지정해야 합니다. 이 특성을 지정하는 경우 StartPage 특성을 지정해서는 안 됩니다.	길이가 1~256자인 문자열로, ".exe"로 끝나야 하며 , :>, %, ", ", \|, ?또는 *와 같은 문자를 <포함할 수 없습니다. 확장에 대한 기본 실행 파일을 지정합니다. 지정하지 않으면 앱에 대해 정의된 실행 파일이 사용됩니다. 지정한 경우 EntryPoint 속성도 사용됩니다. 해당 EntryPoint 속성을 지정하지 않으면 앱에 대해 정의된 EntryPoint가 사용됩니다.	아니요
ID	패키지 내 애플리케이션의 고유 식별자입니다. PRAID(패키지 상대 앱 식별자)라고도 합니다. ID는 패키지 내에서 고유하지만 전역적으로는 고유하지 않습니다. 같은 ID를 사용하는 시스템에 다른 패키지가 있을 수 있습니다. 동일한 패키지에서 동일한 ID를 두 번 이상 사용할 수 없습니다. 이 문자열에는 마침표로 구분된 영숫자 필드가 있습니다. 각 필드는 ASCII 알파벳 문자로 시작해야 합니다. 이러한 값을 필드 값으로 사용할 수 없습니다. "CON", "PRN", "AUX", "NUL", "COM1", "COM2", "COM3", "COM4", "COM5", "COM6", "COM7", "COM8", "COM9", "LPT1", "LPT2", "LPT3", "LPT4", "LPT5", "LPT6", "LPT7", "LPT8" 및 "LPT9"입니다. Visual Studio 템플릿을 사용하는 경우 이 특성의 기본값은 "App"입니다. 개발자는 매니페스트에서 수동으로 변경해야 합니다. 앱이 Microsoft Store 게시된 후에는 앱의 식별자를 변경하지 않아야 합니다. 이렇게 하면 시작 화면에서 타일의 위치가 중단됩니다.	길이가 1~64자인 ASCII 문자열입니다.	예
StartPage	앱의 기본 시작 HTML 페이지입니다. 이 파일은 패키지에 있어야 합니다. 이 특성을 지정하는 경우 EntryPoint 특성 또는 실행 파일 특성을 지정할 수 없습니다.	1~256자 사이의 문자열로 , , >:, %, ", \|, ?, *등의 문자를 <포함할 수 없습니다.	예

자식 요소

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

부모 요소

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

설명

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

StartPage 특성이 지정된 경우 JavaScript를 사용하는 Windows 앱입니다. StartPage를 지정하지 않으면 실행 파일 및 EntryPoint 특성을 모두 지정해야 하며 C# 또는 VB 및 XAML을 사용하는 UWP 앱입니다.

예

다음 예제는 SDK 샘플 중 하나의 패키지 매니페스트에서 가져옵니다.

                    
<Applications>
  <Application Id="App" StartPage="default.html">

    <VisualElements DisplayName="Assocation launching sample" 
         Logo="images\squareTile-sdk.png" SmallLogo="images\smallTile-sdk.png" 
         Description="SDK sample" 
         ForegroundText="dark" BackgroundColor="#FFFFFF" ToastCapable="false">
      <DefaultTile ShowName="allLogos" />
      <SplashScreen BackgroundColor="white" Image="images\splash-sdk.png" />
    </VisualElements>

    <Extensions>
      <Extension Category="windows.fileTypeAssociation">
        <FileTypeAssociation Name=".alsdkjs">
          <SupportedFileTypes>
            <FileType>.alsdkjs</FileType>
          </SupportedFileTypes>
        </FileTypeAssociation>
      </Extension>

      <Extension Category="windows.protocol">
        <Protocol Name="alsdkjs" />
      </Extension>
    </Extensions>
  </Application>
</Applications>

요구 사항

	값
Namespace	`http://schemas.microsoft.com/appx/2010/manifest`