<InstallChecks> 요소(부트스트래퍼)

InstallChecks 요소에서는 응용 프로그램에 필수 구성 요소가 모두 설치되었는지 확인하기 위해 로컬 컴퓨터에 대해 다양한 테스트를 지원합니다.

<InstallChecks>
    <AssemblyCheck 
        Property
        Name
        PublicKeyToken
        Version
        Language
        ProcessorArchitecture
    />
    <RegistryCheck
        Property
        Key
        Value
    />
    <ExternalCheck 
        PackageFile
        Property
        Arguments
    />
    <FileCheck 
        Property
        FileName
        SearchPath
        SpecialFolder
        SearchDepth
    />
    <MsiProductCheck 
        Property
        Product
        Feature
    />
    <RegistryFileCheck 
        Property
        Key
        Value
        FileName
        SearchDepth
    />
</InstallChecks>

AssemblyCheck

이 요소는 InstallChecks의 선택적 자식 요소입니다. 부트스트래퍼는 AssemblyCheck의 각 인스턴스에 대해 요소로 식별된 어셈블리가 GAC(전역 어셈블리 캐시)에 있는지 확인합니다. 이 요소는 자식 요소를 포함하지 않으며 다음과 같은 특성을 가지고 있습니다.

ExternalCheck

이 요소는 InstallChecks의 선택적 자식 요소입니다. ExternalCheck의 각 인스턴스에 대해 부트스트래퍼는 명명된 외부 프로그램을 별도의 프로세스에서 실행되고 Property 의해 표시된 속성에 종료 코드를 저장합니다. ExternalCheck는 복잡한 종속성 검사를 구현하려는 경우나 구성 요소가 있는지 검사하려면 이를 인스턴스화해야만 하는 경우에 유용합니다.

ExternalCheck는 요소를 포함하지 않으며 다음과 같은 특성을 가지고 있습니다.

FileCheck

이 요소는 InstallChecks의 선택적 자식 요소입니다. 부트스트래퍼는 FileCheck의 각 인스턴스에 대해 명명된 파일이 있는지 확인하고 파일의 버전 번호를 반환합니다. 파일에 버전 번호가 없는 경우 부트스트래퍼는 Property에서 명명한 속성을 0으로 설정합니다. 파일이 없으면 Property가 모든 값으로 설정되지 않습니다.

FileCheck는 요소를 포함하지 않으며 다음과 같은 특성을 가지고 있습니다.

MsiProductCheck

이 요소는 InstallChecks의 선택적 자식 요소입니다. 부트스트래퍼는 MsiProductCheck의 각 인스턴스에 대해 지정된 Microsoft Windows Installer 설치가 완료되었는지 검사합니다. 속성 값은 설치된 해당 제품의 상태에 따라 설정됩니다. 양수 값은 제품이 설치되어 있음을 나타내고 0 또는 -1은 제품이 설치되지 않았음을 나타냅니다. 자세한 내용은 Windows Installer SDK의 MsiQueryFeatureState 함수를 참조하십시오. . 컴퓨터에 Windows Installer가 설치되어 있지 않으면 Property가 설정되지 않습니다.

MsiProductCheck는 요소를 포함하지 않으며 다음과 같은 특성을 가지고 있습니다.

RegistryCheck

이 요소는 InstallChecks의 선택적 자식 요소입니다. 부트스트래퍼는 RegistryCheck의 각 인스턴스에 대해 지정된 레지스트리 키가 있는지 확인하거나 레지스트리 키에 지정된 값이 있는지 확인합니다.

RegistryCheck는 요소를 포함하지 않으며 다음과 같은 특성을 가지고 있습니다.

RegistryFileCheck

이 요소는 InstallChecks의 선택적 자식 요소입니다. 부트스트래퍼는 RegistryFileCheck의 각 인스턴스에 대해 먼저 지정한 레지스트리 키에서 파일의 경로를 검색 시도하여 특정 파일의 버전을 검색합니다. 이는 레지스트리에 값으로 지정된 디렉터리에서 파일을 조회하려는 경우에 특히 유용합니다.

RegistryFileCheck는 요소를 포함하지 않으며 다음과 같은 특성을 가지고 있습니다.

설명

InstallChecks 아래의 요소는 실행할 테스트를 정의하지만 테스트를 실제로 실행하지는 않습니다. 테스트를 실행하려면 Commands 요소 아래에 Command 요소를 만들어야 합니다.

예제

다음 코드 예제에서는 .NET Framework에 대한 제품 파일에 사용되는 InstallChecks 요소를 보여 줍니다.

<InstallChecks>
    <ExternalCheck Property="DotNetInstalled" PackageFile="dotnetchk.exe" />
    <RegistryCheck Property="IEVersion" Key="HKLM\Software\Microsoft\Internet Explorer" Value="Version" />
</InstallChecks>

InstallConditions

InstallChecks가 확인되면 속성이 생성됩니다. 이러한 속성은 InstallConditions에서 패키지를 설치할 것인지, 건너뛸 것인지 아니면 설치를 중지할 것인지를 결정하는 데 사용됩니다. 다음 표에는 InstallConditions 목록이 나와 있습니다.

미리 정의된 속성

다음 표는 BypassIf 및 FailIf 요소를 나열합니다.

예를 들어 Windows 95를 실행하는 컴퓨터에 대한 설치를 차단하려면 다음과 같은 코드를 사용합니다.

<!-- Block install on Windows 95 -->
    <FailIf Property="Version9X" Compare="VersionLessThan" Value="4.10" String="InvalidPlatform"/>

참고 항목

참조

<Commands> 요소(부트스트래퍼)

제품 및 패키지 스키마 참조