TargetDeviceFamily(Windows 10)

아티클
04/28/2023

패키지가 대상으로 하는 디바이스 패밀리를 식별합니다. 디바이스 제품군에 대한 자세한 내용은 확장 SDK를 사용한 프로그래밍을 참조하세요.

요소 계층 구조

<TargetDeviceFamily>

구문

<TargetDeviceFamily
    Name = 'An alphanumeric string that can contain period and dash characters.'
    MinVersion = 'A version string in quad notation ("Major.Minor.Build.Revision"), where Major cannot be 0.'
    MaxVersionTested = 'A version string in quad notation ("Major.Minor.Build.Revision"), where Major cannot be 0.' />

특성 및 요소

특성

attribute	Description	데이터 형식	필수
이름	앱이 대상으로 하는 디바이스 패밀리의 이름입니다. 지원되는 디바이스 패밀리 이름에 대한 자세한 내용은 예제 섹션을 참조하세요.	마침표 및 대시 문자를 포함할 수 있는 영숫자 문자열입니다.	Yes
MinVersion	앱이 대상으로 하는 디바이스 패밀리의 최소 버전입니다. 배포 시 적용 가능성에 사용됩니다. 시스템의 디바이스 패밀리 버전이 MinVersion보다 낮으면 앱이 적용 가능한 것으로 간주되지 않습니다.	쿼드 표기법(`Major.Minor.Build.Revision`)의 버전 문자열입니다. 여기서 는 `Major` 일 `0`수 없습니다.	Yes
MaxVersionTested	앱이 대상으로 하는 디바이스 패밀리의 최대 버전입니다. 이는 런타임에 쿼크에 대한 효과적인 프로세스 공간을 결정하는 데 사용됩니다.	쿼드 표기법(`Major.Minor.Build.Revision`)의 버전 문자열입니다. 여기서 는 `Major` 일 `0`수 없습니다.	예

자식 요소

없음

부모 요소

부모 요소	Description
종속성	패키지를 사용하여 소프트웨어를 완료하는 다른 패키지를 선언합니다.

예제

"유니버설 디바이스 패밀리"(앱이 모든 디바이스에서 실행됨)로 알려진 API 집합을 대상으로 지정하려면 아래 예제와 같이 하나의 디바이스 패밀리를 지정하기만 하면 됩니다. 앱이 특정 디바이스 패밀리의 디바이스에서 실행 중일 때 범용 디바이스 패밀리 외부에서 API를 밝히는 적응 코드를 계속 작성할 수 있습니다. 버전 10.0.x.0 및 10.0.y.0은 물론 동일한 값일 수 있습니다.

<Dependencies>
    <TargetDeviceFamily Name="Windows.Universal" MinVersion="10.0.x.0" MaxVersionTested="10.0.y.0"/>
</Dependencies>

참고

"MinVersion" 및 "MaxVersionTested"가 버전 10.0.0.0으로 설정된 "Windows.Universal"을 대상으로 하는 경우 앱은 프로젝트 파일의 대상 최소 버전 및 대상 버전에 지정된 버전을 각각 사용합니다. "MinVersion" 및 "MaxVersionTested"가 10.0.0.0 이외의 값으로 설정된 "Windows.Universal"을 사용하는 경우 앱은 프로젝트 파일에 지정된 값 대신 지정된 "MinVersion" 및 "MaxVersionTested"를 대상으로 합니다.

모든 자식 디바이스 패밀리는 "범용 디바이스 패밀리" API 집합에서 "파생"됩니다. 따라서 자식 디바이스 패밀리는 "범용 및 기타 자식 디바이스-가족별 API"를 의미합니다. 자식 디바이스 패밀리를 대상으로 하는 경우 범용으로 멘션 필요가 없습니다. 다음 예제에서 앱은 "모바일 디바이스 패밀리"라고 하는 API 집합을 대상으로 하므로 모바일 디바이스 제품군 API(모바일 디바이스)를 구현하는 디바이스에서만 실행됩니다. 예를 들어 다른 장치 패밀리를 대상으로 지정하려는 경우 "Mobile"을 "데스크톱", "Xbox", "Holographic", "IoT" 또는 "IoTHeadless"로 바꿉니다.

<Dependencies>
    <TargetDeviceFamily Name="Windows.Mobile" MinVersion="10.0.x.0" MaxVersionTested="10.0.y.0"/>
</Dependencies>

참고

앱이 "Windows.Universal"이 아닌 디바이스 패밀리를 대상으로 하는 경우 대상 디바이스 패밀리에 대해 "MinVersion" 및 "MaxVersionTested"를 올바르게 지정해야 합니다.

Xbox 장치 패밀리를 대상으로 하려면 Name 특성을 "Windows.Xbox"로 설정합니다. Xbox 장치 패밀리를 대상으로 하려면 MinVersion을 10.0.14393.0 이상으로 설정해야 합니다.

<Dependencies>
    <TargetDeviceFamily Name="Windows.Xbox" MinVersion="10.0.x.0" MaxVersionTested="10.0.y.0"/>
</Dependencies>

앱이 HoloLens용으로 특별히 만들어졌으며 다른 플랫폼에서 지원되지 않는 경우 대상 디바이스 패밀리 "Windows.Holographic"을 지정합니다.

<Dependencies>
    <TargetDeviceFamily Name="Windows.Holographic" MinVersion="10.0.x.0" MaxVersionTested="10.0.y.0"/>
</Dependencies>

앱이 Windows 10 Team Edition을 단독으로 대상으로 하는 경우 Name 특성을 "Windows.Team"으로 설정합니다. 이는 일반적으로 Microsoft Surface Hub 디바이스에 사용됩니다.

<Dependencies>
    <TargetDeviceFamily Name="Windows.Team" MinVersion="10.0.x.0" MaxVersionTested="10.0.y.0"/>
</Dependencies>

IoT Core 플랫폼을 대상으로 하려면 Name 특성을 "Windows.IoT"로 설정합니다. 헤드리스 IoT 앱의 경우 "Windows.IoTHeadless"를 사용합니다.

<Dependencies>
    <TargetDeviceFamily Name="Windows.IoT" MinVersion="10.0.x.0" MaxVersionTested="10.0.y.0"/>
</Dependencies>

참고

현재 IoT 또는 IoTHeadless를 대상으로 하는 앱은 앱 스토어에서 유효하지 않으며 개발 목적으로만 사용해야 합니다.

이 예제에서 앱은 모바일 및 데스크톱 디바이스 패밀리를 대상으로 합니다. 따라서 앱은 모바일 디바이스 또는 데스크톱 디바이스에서 실행할 수 있지만 다른 디바이스에서는 실행할 수 없습니다. 앱은 적응 코드를 사용하여 API의 범용 디바이스 패밀리 집합에 없는 모든 API를 호출해야 합니다(두 디바이스 패밀리에서 API를 공유하지 않는 한).

<Dependencies>
    <TargetDeviceFamily Name="Windows.Mobile" MinVersion="10.0.x.0" MaxVersionTested="10.0.y.0"/>
    <TargetDeviceFamily Name="Windows.Desktop" MinVersion="10.0.x.0" MaxVersionTested="10.0.y.0"/>
</Dependencies>

이 마지막 예제에서 앱은 유니버설 디바이스 패밀리를 대상으로 합니다(따라서 기본적으로 지정된 최소 버전이 있는 모든 디바이스에서 실행됨). 예외는 모바일 디바이스 패밀리를 구현하는 디바이스의 경우 앱에 버전 10.0.m.0 이상이 있어야 한다는 것입니다. 이는 일반적인 사례(범용 디바이스 패밀리 사례)에 대해 지원하는 버전과 다른 경우에도 지정된 최소 버전보다 이전 버전의 자식 디바이스 패밀리를 지원하지 않음을 나타내는 방법입니다. 또한 예제에서 모바일 디바이스 패밀리 종속성에 대한 MaxVersionTested 값을 확인합니다. z > n인 경우 앱은 모바일 디바이스의 버전 10.0.z.0에서 실행되지만 해당 버전의 플랫폼에서 10.0.n.0 버전 동작이 발생합니다.

<Dependencies>
    <TargetDeviceFamily Name="Windows.Universal" MinVersion="10.0.x.0" MaxVersionTested="10.0.y.0"/>
    <TargetDeviceFamily Name="Windows.Mobile" MinVersion="10.0.m.0" MaxVersionTested="10.0.n.0"/>
</Dependencies>

설명

패키지는 최대 운영 체제(OS) 동작에만 액세스할 수 <TargetDeviceFamily [...] MaxVersionTested="version">있습니다. 따라서 패키지 값이 대상 컴퓨터의 MaxVersionTested OS 버전보다 높은 경우 패키지에서 이해되는 OS 동작이 있을 수 있지만 대상 OS에서 패키지에서 사용할 수 없습니다. 대상 OS가 (에 가까워지거나 일치하는 MaxVersionTested) 업그레이드하는 경우 패키지에서 인식할 수 있는 잠재적으로 OS 동작을 사용할 수 있게 되고 이전에는 사용할 수 없었습니다. 따라서 OS는 이러한 동작을 밝히기 위해 패키지를 다시 처리합니다.

배포에서 이 조명 시나리오를 발생시키는 프로세스를 ReIndexing이라고 합니다.

요구 사항

요구 사항	값
네임스페이스	`http://schemas.microsoft.com/appx/manifest/foundation/windows10`