VisualElements(Windows 8 패키지 스키마)

  • 아티클

UWP 앱의 시각적 측면을 설명합니다. 기본 타일, 로고 이미지, 텍스트 및 배경색, 초기 화면 방향, 시작 화면 및 잠금 화면 타일 모양.

요소 계층 구조

<패키지>
<애플리케이션>
<애플리케이션>
<VisualElements>

구문

<VisualElements DisplayName     = A string between 1 and 256 characters in length.
                Logo            = A string between 1 and 256 characters in length that ends with ".jpg", ".png", or ".jpeg" that can't contain these characters: <, >, :, %, ", |, ?, or *. In this string, the / and \ characters can't be the first or last characters. Also, the string can contain / or \ but not both.
                SmallLogo       = A string between 1 and 256 characters in length that ends with ".jpg", ".png", or ".jpeg" that can't contain these characters: <, >, :, %, ", |, ?, or *. In this string, the / and \ characters can't be the first or last characters. Also, the string can contain / or \ but not both.
                Description     = A string between 1 and 2048 characters in length that cannot include characters such as tabs, carriage returns, and line feeds.
                ForegroundText  = "light" | "dark"
                BackgroundColor = A three-byte hexadecimal number preceded by "#" or a named color.
                ToastCapable?   = boolean >

  <!-- Child elements -->
  ( DefaultTile?
  & LockScreen?
  & SplashScreen
  & InitialRotationPreference?
  )

</VisualElements>

키

? 선택 사항(0 또는 1)

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

특성 및 요소

특성

attribute 설명 데이터 형식 필수 기본값
BackgroundColor

앱 타일의 배경색을 지정합니다. 색 이름은 주의 섹션을 참조하세요. 여기에 지정된 배경색은 다음 항목에도 적용됩니다.

  • 앱 소유 대화 상자의 단추 색
  • Microsoft Store 앱 설명 페이지
  • Windows Phone 적용: "투명"을 선택하면 시스템 악센트 색이 사용됩니다.
 "#" 또는 명명된 색 앞에 오는 3바이트 16진수입니다. 예
설명

앱에 대한 설명입니다. 이 문자열은 지역화할 수 있습니다. 자세한 내용은 비고를 참조하세요.

 탭, 캐리지 리턴 및 줄 바꿈과 같은 문자를 포함할 수 없는 길이가 1자에서 2048자 사이의 문자열입니다. 예
표시 이름

사용자에게 표시할 수 있는 앱의 이름입니다. 이 문자열은 지역화할 수 있습니다. 자세한 내용은 비고를 참조하세요.

Microsoft Store 업로드된 앱의 DisplayName으로 사용할 수 없는 두 개의 명시적으로 예약된 단어는 "NoUIEntryPoints" 및 "NoUIEntryPoints-DesignMode"입니다. 이러한 식별자는 개발 도구와 테스트 도구 모음에서 사용하도록 예약되어 있습니다.

 길이가 1~256자인 문자열입니다. 예
ForegroundText

앱 타일의 전경색을 지정합니다.

  • Windows Phone 적용: 이 값은 무시됩니다. 모든 타일은 밝은 텍스트 색을 사용합니다.

이 특성 값은 다음 중 하나일 수 있습니다.

  • 간단하고
  • 어두운
 예
로고

앱의 사각형 타일로 사용되는 이미지입니다. 이 특성에서 이미지를 지정하는 방법에 대한 자세한 내용은 비고를 참조하세요.

 ".jpg", ".png" 또는 ".jpeg"로 끝나는 길이가 1자에서 256자 사이의 문자열로, 다음 문자를 <포함할 수 없습니다. , >:, %, ", ", |, ?, 또는 *. 이 문자열에서 / 및 \ 문자는 첫 번째 또는 마지막 문자가 될 수 없습니다. 또한 문자열은 /또는 \를 포함할 수 있지만 둘 다 포함할 수는 없습니다. 예
SmallLogo

앱을 식별하기 위해 타일의 모서리에 표시되는 작은 이미지입니다. 이 특성에서 이미지를 지정하는 방법에 대한 자세한 내용은 비고를 참조하세요.

  • Windows Phone 적용: Windows Phone 타일에 작은 로고가 표시되지 않습니다. 앱 목록에서만 사용됩니다.
 ".jpg", ".png" 또는 ".jpeg"로 끝나는 길이가 1자에서 256자 사이의 문자열로, 다음 문자를 <포함할 수 없습니다. , >:, %, ", ", |, ?, 또는 *. 이 문자열에서 / 및 \ 문자는 첫 번째 또는 마지막 문자가 될 수 없습니다. 또한 문자열은 /또는 \를 포함할 수 있지만 둘 다 포함할 수는 없습니다. 예
ToastCapable

true 값은 앱이 알림 메시지를 제공할 수 있음을 나타냅니다. 기본 값은 false입니다. 알림 메시지를 표시하지 않으려면 이 특성의 값을 지정하지 마세요. 앱은 이 값을 기반으로 알림 메시지를 보낼지 여부를 결정해서는 안 됩니다.

 boolean 예

 

자식 요소

자식 요소 설명
DefaultTile

시작 화면의 앱을 나타내는 기본 타일입니다. 이 타일은 앱이 처음 설치될 때 업데이트 알림을 받기 전에 표시됩니다. 타일에 표시할 알림이 없으면 타일이 이 기본값으로 돌아갑니다.
InitialRotationPreference

최상의 사용자 환경을 위해 앱이 표시되는 방향을 설명합니다. 태블릿과 같이 회전할 수 있는 디바이스에서는 여기에 지정되지 않은 방향에 대해 앱을 다시 그려지지 않습니다. 예를 들어 앱이 가로 방향 및 LandscapeFlipped 방향만 지정하고 디바이스가 세로 방향으로 회전되는 경우 앱은 회전하지 않습니다.

회전할 수 없는 디바이스에서는 해당 디바이스의 기본 방향에 앱이 표시될 수 있으며 앱의 기본 방향은 무시됩니다. 그러나 회전 잠금이 활성화된 디바이스에서는 앱에서 선호하는 회전이 계속 적용됩니다.

이러한 방향 기본 설정 선택은 앱에 대한 새 세션이 시작될 때 [시작 화면](element-splashscreen.md) 및 앱 UI 모두에 적용됩니다. 런타임에 [AutoRotationPreferences](/uwp/api/Windows 통해 기본 설정을 변경할 수 있습니다. Graphics.Display.DisplayProperties) 속성입니다.
LockScreen

시스템이 잠겨 있을 때 표시되는 잠금 화면에서 앱을 나타내는 배지 및 알림을 정의합니다.
SplashScreen

시작 화면의 모양을 정의합니다. 시작 화면은 시작 중에 앱에서 표시합니다.

 

부모 요소

부모 요소 설명
애플리케이션

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

 

설명

타일 차원 요구 사항에 대한 자세한 내용은 타일 크기를 참조하세요.

로고 및 SmallLogo 이미지는 이미지 파일의 직접 경로 또는 리소스로 지정할 수 있습니다. 리소스 참조를 사용하여 Windows 디바이스 및 화면 해상도에 가장 적합한 크기를 선택할 수 있도록 다양한 규모의 이미지를 제공할 수 있습니다. 또한 접근성 및 지역화된 이미지를 위해 고대비 이미지를 제공하여 다른 UI 언어와 일치시킬 수 있습니다. 이 기능을 사용하면 DisplayName 및 설명 특성을 지역화할 수도 있습니다 . 자세한 내용은 세계화 항목을 참조하세요.

Applications/Application/Extensions/Extension/FileTypeAssociation/Logo Applications/Application/Extensions/Extension/Protocol/Logo

두 가지 유형의 로고 이미지에 대한 크기 요구 사항은 다음과 같습니다.

이미지 특성 크기 조정 이미지 크기(픽셀 Applications\Application\VisualElements\@Logo 100 150x150 140 210x210 180 270x270 Applications\Application\VisualElements\@SmallLogo 100 30x30 140 42x42 180 54x544

지원되는 배경색 이름은 다음과 같습니다.

속성 속성 속성 속성 속성 속성
aliceBlue antiqueWhite aqua aquamarine azure beige
bisque black blanchedAlmond blue blueViolet brown
burlyWood cadetBlue chartreuse chocolate coral 콘플라워블루
cornsilk crimson cyan darkBlue darkCyan darkGoldenrod
darkGray darkGreen darkKhaki darkMagenta darkOliveGreen darkOrange
darkOrchid darkRed darkSalmon darkSeaGreen darkSlateBlue darkSlateGray
darkTurquoise darkViolet deepPink deepSkyBlue dimGray dodgerBlue
firebrick floralWhite forestGreen fuchsia gainsboro ghostWhite
gold goldenrod gray green greenYellow honeydew
hotPink indianRed indigo ivory khaki lavender
lavenderBlush lawnGreen lemonChiffon lightBlue lightCoral lightCyan
lightGoldenrodYellow lightGreen lightGray lightPink lightSalmon lightSeaGreen
lightSkyBlue lightSlateGray lightSteelBlue lightYellow lime limeGreen
linen magenta maroon mediumAquamarine mediumBlue mediumOrchid
mediumPurple mediumSeaGreen mediumSlateBlue mediumSpringGreen mediumTurquoise mediumVioletRed
midnightBlue mintCream mistyRose moccasin navajoWhite navy
oldLace olive oliveDrab orange orangeRed orchid
paleGoldenrod paleGreen paleTurquoise paleVioletRed papayaWhip peachPuff
peru pink plum powderBlue purple red
rosyBrown royalBlue saddleBrown salmon sandyBrown seaGreen
조개 sienna silver skyBlue slateBlue slateGray
snow springGreen steelBlue tan teal thistle
tomato transparent turquoise violet wheat white
Whitesmoke yellow yellowGreen

 

예

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

                    
<Applications>
    <Application Id="App" StartPage="default.html">
        <VisualElements 
            DisplayName="ApplicationDataSample" 
            Logo="images\squareTile-sdk.png" 
            SmallLogo="images\smallTile-sdk.png" 
            Description="Application data sample" 
            ForegroundText="dark" 
            BackgroundColor="#FFFFFF" 
            ToastCapable="false">
            <DefaultTile ShowName="allLogos"/>
            <SplashScreen BackgroundColor="white" Image="images\splash-sdk.png"/>
        </VisualElements>
    </Application>
</Applications>

참고 항목

앱 스크린샷 및 이미지

Colors 클래스

빠른 시작: Visual Studio 매니페스트 편집기를 사용하여 기본 타일 만들기

요구 사항

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