Sdílet prostřednictvím

Vytvoření balíčků bootstrapperu

Instalační program je obecný instalační program, který lze nakonfigurovat tak, aby detekoval a nainstaloval distribuovatelné součásti, jako je Instalační služba systému Windows (.msi) soubory a spustitelné programy. Instalační program je také známý jako zaváděcí program (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ů obsahujících manifestové soubory, které popisují způsob instalace nezbytných požadavků.

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

Vytvořit vlastní balíčky 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é podle vlastního bootstrapperu. 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 redistribuovatelné soubory do umístění složky bootstrapper. Další informace naleznete v tématu Postupy: Vytvoření lokalizovaného balíčku bootstrapperu.

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

nebo

*<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 kultury.

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 poté znovu otevřete dialogové okno Požadavky. Další informace naleznete v dialogovém okně Požadavky.

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

Vlastnictví Popis
Název aplikace Název aplikace.
Architektura Procesoru Procesor a počet bitů na slovo platformy, na kterou je cílen 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) pro spuštění během instalace.
Správce uživatel Tato vlastnost se nastaví, pokud má uživatel oprávnění správce. Hodnoty jsou pravdivé nebo nepravdivé.
Režim instalace Režim instalace označuje, odkud je potřeba komponentu nainstalovat. Mezi hodnoty patří:

- HomeSite – 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 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