TargetDeviceFamily(Windows 10)

패키지가 대상으로 하는 디바이스 패밀리를 식별합니다. 디바이스 제품군에 대한 자세한 내용은 확장 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 데이터 형식 필수 기본값
이름 앱이 대상으로 하는 디바이스 패밀리의 이름입니다. 지원되는 디바이스 패밀리 이름에 대한 자세한 내용은 예제 섹션을 참조하세요. 마침표 및 대시 문자를 포함할 수 있는 영숫자 문자열입니다.
MinVersion 앱이 대상으로 하는 디바이스 패밀리의 최소 버전입니다. 배포 시 적용 가능성에 사용됩니다. 시스템의 디바이스 패밀리 버전이 MinVersion보다 낮으면 앱이 적용 가능한 것으로 간주되지 않습니다. 을 사용할 수 없는 쿼드 표기법(Major.Minor.Build.Revision) Major 의 버전 문자열입니다 0.
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 집합(모바일 디바이스)을 구현하는 디바이스에서만 실행됩니다. 예를 들어 다른 장치 패밀리를 대상으로 지정하려는 경우 "모바일"을 "데스크톱", "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>

요구 사항

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