Vytváření balíčků bootstrapperu

  • Článek

Instalační program je obecný instalační program, který lze nakonfigurovat k detekci a instalaci distribuovatelných komponent, jako jsou soubory Instalační služby systému Windows (.msi) a spustitelné programy. Instalační program se také označuje jako bootstrapper. Programuje se prostřednictvím sady manifestů XML, které určují metadata pro správu instalace komponenty. Každá redistribuovatelná komponenta nebo předpoklad, která se zobrazí v dialogovém okně Požadavky pro ClickOnce, je balíček bootstrapperu. Balíček bootstrapperu je skupina adresářů a souborů, které obsahují soubory manifestu, které popisují, jak se má předpoklad nainstalovat.

Bootstrapper nejprve zjistí, jestli už je některá z požadovaných součástí nainstalovaná. Pokud nejsou nainstalovány požadavky, nejprve bootstrapper zobrazí licenční smlouvy. Za druhé, jakmile koncový uživatel přijme licenční smlouvy, zahájí se instalace pro požadavky. V opačném případě, pokud jsou zjištěny všechny požadavky, bootstrapper právě spustí instalační program aplikace.

Vytváření vlastních balíčků bootstrapperu

Manifesty bootstrapperu můžete vygenerovat pomocí editoru XML v sadě Visual Studio. Příklad vytvoření balíčku bootstrapperu najdete v tématu Návod: Vytvoření vlastního bootstrapperu s výzvou k ochraně osobních údajů.

Pokud chcete vytvořit balíček bootstrapperu, musíte vytvořit manifest produktu a pro každou lokalizovanou verzi komponenty také manifest balíčku.

  • Manifest produktu product.xml obsahuje všechna jazykově neutrální metadata balíčku. Obsahuje metadata společná pro všechny lokalizované verze redistribuovatelné komponenty. Chcete-li vytvořit tento soubor, přečtěte si téma Postupy: Vytvoření manifestu produktu.

  • Manifest balíčku package.xml obsahuje metadata specifická pro jazyk. Obvykle obsahuje lokalizované chybové zprávy. Komponenta musí mít alespoň jeden manifest balíčku pro každou lokalizovanou verzi této komponenty. Chcete-li vytvořit tento soubor, přečtěte si téma Postupy: Vytvoření manifestu balíčku.

Po vytvoření těchto souborů vložte soubor manifestu produktu do složky pojmenované pro vlastní bootstrapper. Soubor manifestu balíčku přejde do složky pojmenované pro národní prostředí. Pokud je například soubor manifestu balíčku pro anglickou redistribuci, vložte soubor do složky s názvem en. Tento postup opakujte pro každé národní prostředí, například ja pro japonštinu a de pro němčinu. Poslední vlastní balíček bootstrapperu může mít následující strukturu složek.

CustomBootstrapperPackage
  product.xml
  CustomBootstrapper.msi
  de
    eula.rtf
    package.xml
  en
    eula.rtf
    package.xml
  ja
    eula.rtf
    package.xml

Dále zkopírujte distribuovatelné soubory do umístění složky bootstrapperu. Další informace naleznete v tématu Postupy: Vytvoření lokalizovaného balíčku bootstrapperu.

*\Program Files (x86)\Microsoft SDKs\ClickOnce Bootstrapper\Packages*

or

*<VS Install Path>\MSBuild\Microsoft\VisualStudio\BootstrapperPackages*

Poznámka:

Cesta uvedená výše v instalační cestě sady Visual Studio funguje od verze Visual Studio 2019 Update 7.

Umístění složky bootstrapperu najdete také z hodnoty Cesta v následujícím klíči registru:

*HKLM\Software\Microsoft\GenericBootstrapper*

V 64bitových systémech použijte následující klíč registru:

*HKLM\Software\Wow6432Node\Microsoft\GenericBootstrapper*

Každá redistribuovatelná komponenta se zobrazí ve své vlastní podsložce v adresáři balíčků. Manifest produktu a distribuovatelné soubory musí být vloženy do této podsložky. Lokalizované verze manifestů komponent a balíčků musí být umístěny v podsložkách pojmenovaných podle názvu jazykové verze.

Po zkopírování těchto souborů do složky bootstrapper se balíček bootstrapperu automaticky zobrazí v dialogovém okně Visual Studio Prerequisites . Pokud se váš vlastní balíček bootstrapperu nezobrazí, zavřete a znovu otevřete dialogové okno Požadavky . Další informace naleznete v dialogovém okně Požadavky.

Následující tabulka ukazuje vlastnosti, které jsou automaticky naplněny bootstrapperem.

Vlastnost Popis
NázevAplikace Název aplikace.
ProcessorArchitecture Procesor a bity na slovo platformy, na kterou cílí spustitelný soubor. Mezi hodnoty patří:

-Intel
- IA64
- AMD64
VersionNT Číslo verze operačních systémů Windows. Syntaxe verze je Major.Minor.ServicePack.
VersionMSI Verze sestavení Instalační služby systému Windows (msi.dll), která se má spustit během instalace.
Správa Uživatel Tato vlastnost se nastaví, pokud má uživatel oprávnění správce. Hodnoty jsou true nebo false.
InstallMode Režim instalace označuje, odkud je potřeba komponentu nainstalovat. Mezi hodnoty patří:

- Domovský web – požadavky jsou nainstalovány z webu dodavatele.
- SpecificSite – požadavky se nainstalují z vybraného umístění.
– SameSite – požadavky se nainstalují ze stejného umístění jako aplikace.

Samostatné redistribuovatelné součásti od instalací aplikací

V projektech instalace můžete zabránit nasazení redistribuovatelných souborů. Chcete-li to provést, vytvořte distribuovatelný seznam ve složce RedistList v adresáři rozhraní .NET Framework:

%ProgramFiles%\Microsoft.NET\RedistList

Redistribuovatelný seznam je soubor XML, který byste měli pojmenovat pomocí následujícího formátu: <Název> společnosti.<Název> komponenty. RedistList.xml. Pokud se například komponenta nazývá DataWidgets made by Acme, použijte Acme.DataWidgets.RedistList.xml. Příklad obsahu redistribuovatelného seznamu může vypadat takto:

<?xml version="1.0" encoding="UTF-8"?>
<FileList Redist="Acme.DataWidgets" >
<File AssemblyName="Acme.DataGrid" Version="1.0.0.0" PublicKeyToken="b03f5f7f11d50a3a" Culture="neutral" ProcessorArchitecture="MSIL" InGAC="true" />
</FileList>

Související obsah