Sdílet prostřednictvím

<InstallChecks> Prvek (Zaváděcího Nástroje)

  • Článek

Prvek InstallChecks podporuje spouštění různých testů proti místnímu počítači, pro ověření, že byly nainstalovány všechny příslušné požadavky pro aplikace.

<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

Tento prvek je volitelný podřízený prvek InstallChecks. Pro každou instanci AssemblyCheck se zaváděcí nástroj ujistí, že sestavení identifikované prvkem existuje v globální mezipaměti sestavení (GAC). Neobsahuje žádné prvky a má následující atributy.

Atribut

Popis

Property

Povinné. Název vlastnosti k ukládání výsledků. Tuto vlastnost lze odkazovat z testu pod prvkem InstallConditions, který je podřízený prvku Command. Další informace naleznete v tématu <Commands> Prvek (Zaváděcího Nástroje).

Name

Povinné. Plně kvalifikovaný název sestavení pro kontrolu.

PublicKeyToken

Povinné. Zkrácená forma veřejného klíče spojená s tímto silně pojmenovaným sestavením. Všechny sestavení uložené v GAC musí mít název, verzi a veřejný klíč.

Version

Povinné. Verze sestavení.

Číslo verze má formát <hlavní verze>.<podverze>.<verze sestavení>.<verze revize>.

Language

Nepovinné. Jazyk lokalizovaného sestavení. Výchozí hodnota je neutrální.

ProcessorArchitecture

Nepovinné. Procesor počítače směrovaný touto instalací. Výchozí hodnota je msil.

ExternalCheck

Tento prvek je volitelný podřízený prvek InstallChecks. Pro každou instanci ExternalCheck zaváděcí nástroj spustí jmenovaný externí program v samostatném procesu a uloží jeho ukončovací kód do vlastnosti uvedené v Property. ExternalCheck je užitečný pro provádění složitých kontrol závislostí nebo pokud jedinou možností zjištění existence součásti je vytvoření její instance.

ExternalCheckobsahuje žádné prvky a má následující atributy.

Atribut

Popis

Property

Povinné. Název vlastnosti k ukládání výsledků. Tuto vlastnost lze odkazovat z testu pod prvkem InstallConditions, který je podřízený prvku Command. Další informace naleznete v tématu <Commands> Prvek (Zaváděcího Nástroje).

PackageFile

Povinné. Externí program pro spuštění. Program musí být součástí balíčku instalační distribuce.

Arguments

Nepovinné. Dodává argumenty příkazového řádku spustitelnému souboru pojmenovaného PackageFile.

FileCheck

Tento prvek je volitelný podřízený prvek InstallChecks. Pro každou instanci FileCheck určí zaváděcí nástroj, zda jmenovaný soubor existuje a vrátí číslo verze souboru. Pokud soubor neobsahuje číslo verze, zaváděcí nástroj nastaví vlastnost s názvem v Property na hodnotu 0. Pokud soubor neexistuje, Property není nastavena na žádnou hodnotu.

FileCheckobsahuje žádné prvky a má následující atributy.

Atribut

Popis

Property

Povinné. Název vlastnosti k ukládání výsledků. Tuto vlastnost lze odkazovat z testu pod prvkem InstallConditions, který je podřízený prvku Command. Další informace naleznete v tématu <Commands> Prvek (Zaváděcího Nástroje).

FileName

Povinné. Název souboru, který se má najít.

SearchPath

Povinné. Disk nebo složka, ve které chcete vyhledat soubor. Musí to být relativní cesta pokud je SpecialFolder přiřazena; v opačném případě musí být určena jako absolutní cesta.

SpecialFolder

Nepovinné. Složka, která má zvláštní význam v systému Windows nebo ClickOnce. Ve výchozím nastavení je SearchPath interpretována jako absolutní cesta. Platné hodnoty zahrnují následující:

AppDataFolder Složka dat aplikace pro tuto aplikaci ClickOnce; specifická pro aktuálního uživatele.

CommonAppDataFolder. Složka dat aplikace používaná všemi uživateli.

CommonFilesFolder Složka Common Files pro aktuálního uživatele.

LocalDataAppFolder. Složka dat nepřenosných aplikací.

ProgramFilesFolder Standardní složka Program Files pro 32bitové aplikace.

StartupFolder Složka, která obsahuje všechny aplikace, které jsou spuštěny při spuštění systému.

SystemFolder Složka obsahující 32bitové systémové knihovny DLL.

WindowsFolder Složka obsahující instalaci systému Windows.

WindowsVolume. Jednotka nebo oddíl, který obsahuje instalaci systému Windows.

SearchDepth

Nepovinné. Úroveň pro prohledání podsložky pro jmenovaný soubor. Vyhledávání je nejprve v úrovni. Výchozí hodnota je 0, což omezí vyhledávání na složky nejvyšší úrovně určené pomocí SpecialFolder a SearchPath.

MsiProductCheck

Tento prvek je volitelný podřízený prvek InstallChecks. Pro každou instanci MsiProductCheck zaváděcí nástroj zkontroluje, zda zadaná Instalační služba Microsoft Windows běžela dokud nebyla dokončena. Hodnota vlastnosti je nastavena v závislosti na stavu daného nainstalovaného produktu. Kladná hodnota znamená, že je produkt nainstalován, 0 nebo -1 označuje, že není nainstalován. (Prohlédněte si prosím funkci sady SDK Instalační služby systému Windows MsiQueryFeatureState pro další informace.) . Pokud Instalační služba systému Windows není nainstalována na počítači, Property není nastavena.

MsiProductCheckobsahuje žádné prvky a má následující atributy.

Atribut

Popis

Property

Povinné. Název vlastnosti k ukládání výsledků. Tuto vlastnost lze odkazovat z testu pod prvkem InstallConditions, který je podřízený prvku Command. Další informace naleznete v tématu <Commands> Prvek (Zaváděcího Nástroje).

Product

Povinné. Identifikátor GUID nainstalovaného produktu.

Feature

Nepovinné. Identifikátor GUID pro konkrétní funkci nainstalované aplikace.

RegistryCheck

Tento prvek je volitelný podřízený prvek InstallChecks. Pro každou instanci RegistryCheck zaváděcí nástroj zkontroluje, zda zadaný klíč registru existuje nebo zda má uvedenou hodnotu.

RegistryCheckobsahuje žádné prvky a má následující atributy.

Atribut

Popis

Property

Povinné. Název vlastnosti k ukládání výsledků. Tuto vlastnost lze odkazovat z testu pod prvkem InstallConditions, který je podřízený prvku Command. Další informace naleznete v tématu <Commands> Prvek (Zaváděcího Nástroje).

Key

Povinné. Název klíče registru.

Value

Nepovinné. Název hodnoty registru k načtení. Výchozí je pro vrácení textu výchozí hodnoty. Value musí být řetězec nebo hodnota DWORD.

RegistryFileCheck

Tento prvek je volitelný podřízený prvek InstallChecks. Pro každou instanci RegistryFileCheck zaváděcí nástroj načte verze zadaného souboru, nejprve se pokouší načíst cestu k souboru ze zadaného klíče registru. Tato funkce je užitečná zejména v případě, že chcete vyhledat soubor v adresáři zadaném jako hodnota v registru.

RegistryFileCheckobsahuje žádné prvky a má následující atributy.

Atribut

Popis

Property

Povinné. Název vlastnosti k ukládání výsledků. Tuto vlastnost lze odkazovat z testu pod prvkem InstallConditions, který je podřízený prvku Command. Další informace naleznete v tématu <Commands> Prvek (Zaváděcího Nástroje).

Key

Povinné. Název klíče registru. Jeho hodnota je interpretována jako cesta k souboru, pokud je atribut File nastaven. Pokud tento klíč neexistuje, Property není nastavena.

Value

Nepovinné. Název hodnoty registru k načtení. Výchozí je pro vrácení textu výchozí hodnoty. Value musí být řetězec.

FileName

Nepovinné. Název souboru. Pokud je zadána, hodnota získaná z klíče registru je považována za cestu k adresáři a tento název je k němu připojen. Pokud není zadána, hodnota vrácená z registru se považuje za plnou cestu k souboru.

SearchDepth

Nepovinné. Úroveň pro prohledání podsložky pro jmenovaný soubor. Vyhledávání je nejprve v úrovni. Výchozí hodnota je 0, což omezuje vyhledávání na složku nejvyšší úrovně určenou hodnotou klíče registru.

Poznámky

Zatímco prvky pod InstallChecks definují testy k provedení, nespouštějí je. Chcete-li provést zkoušky, je nutné vytvořit prvky Command pod prvkem Commands.

Příklad

Následující příklad kódu ukazuje prvek InstallChecks tak, jak je použit v souboru produktu pro .NET Framework.

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

InstallConditions

Pokud jsou InstallChecks vyhodnoceny, produkují vlastnosti. Vlastnosti jsou pak používány pomocí InstallConditions pro určení, zda se má balíček instalovat, obejít nebo zda má selhat. Následující tabulka obsahuje InstallConditions:

FailIf

Pokud není žádná podmínka FailIf vyhodnocena jako true, balíček se nezdaří. Zbývající část podmínek nebude hodnocena.

BypassIf

Pokud nebude žádná podmínka BypassIf vyhodnocena jako true, bude možné obejít balíček. Zbývající část podmínek nebude hodnocena.

Předdefinované vlastnosti

V následující tabulce jsou uvedeny BypassIf a FailIf prvky:

Vlastnost

Poznámky

Možné hodnoty

Version9X

Číslo verze operačního systému Windows 9X.

4.10 = Systém Windows 98:

VersionNT

Číslo verze operačního systému Windows NT.

Major.minor.ServicePack

5.0 = Systém Windows 2000

5.1.0 = Windows XP

5.1.2 = Windows XP Professional SP2

5.2.0 = Windows Server 2003

VersionNT64

Číslo verze 64bitového operačního systému Windows NT.

Stejné jako výše uvedené.

VersionMsi

Číslo verze Instalační služby systému Windows.

2.0 = Instalační služba systému Windows 2.0

AdminUser

Určuje, zda má uživatel oprávnění správce operačním systému Windows NT.

0 = žádné oprávnění správce

1 = oprávnění správce

Například pro blokování instalace na počítači se systémem Windows 95, můžete použít kód jako například:

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

Viz také

Odkaz

<Commands> Prvek (Zaváděcího Nástroje)

Referenční schéma balíčku a produktu