Dela via

Skapa bootstrapper-paket

Installationsprogrammet är ett allmänt installationsprogram som kan konfigureras för att identifiera och installera omdistribuerbara komponenter som Windows Installer-filer (.msi) och körbara program. Installationsprogrammet kallas även bootstrapper. Den programmeras via en uppsättning XML-manifest som anger metadata för att hantera installationen av komponenten. Varje omdistribuerbar komponent, eller förutsättning, som visas i dialogrutan Förutsättningar för ClickOnce är ett bootstrapper-paket. Ett bootstrapper-paket är en grupp kataloger och filer som innehåller manifestfiler som beskriver hur förutsättningen ska installeras.

Bootstrapper identifierar först om någon av förhandskraven redan är installerade. Om kraven inte har installerats visar bootstrappern först licensavtalen. För det andra, när slutanvändaren har godkänt licensavtalen, börjar installationen för förhandskraven. Annars startar bootstrappern bara programinstallationsprogrammet om alla förutsättningar identifieras.

Skapa anpassade bootstrapper-paket

Du kan generera bootstrapper-manifesten med hjälp av XML-redigeraren i Visual Studio. Ett exempel på hur du skapar ett bootstrapper-paket finns i Genomgång: Skapa en anpassad bootstrapper med en sekretessfråga.

För att skapa ett bootstrapper-paket måste du skapa ett produktmanifest och, för varje lokaliserad version av en komponent, även ett paketmanifest.

  • Produktmanifestet ,product.xml, innehåller alla språkneutrala metadata för paketet. Detta innehåller metadata som är gemensamma för alla lokaliserade versioner av den omdistribuerbara komponenten. Information om hur du skapar den här filen finns i Så här skapar du ett produktmanifest.

  • Paketmanifestet package.xmlinnehåller språkspecifika metadata. den innehåller vanligtvis lokaliserade felmeddelanden. En komponent måste ha minst ett paketmanifest för varje lokaliserad version av komponenten. Information om hur du skapar den här filen finns i Så här skapar du ett paketmanifest.

När dessa filer har skapats placerar du produktmanifestfilen i en mapp med namnet för den anpassade bootstrappern. Paketmanifestfilen hamnar i en mapp med namnet för språkvarianten. Om paketmanifestfilen till exempel är avsedd för omdistribution på engelska placerar du filen i en mapp med namnet en. Upprepa den här processen för varje språk, till exempel ja för japanska och de för tyska. Det slutliga anpassade bootstrapper-paketet kan ha följande mappstruktur.

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

Kopiera sedan de omdistribuerbara filerna till mappen bootstrapper. Mer information finns i Så här skapar du ett lokaliserat bootstrapper-paket.

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

eller

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

Anmärkning

Sökvägen som anges ovan för Visual Studio-installationens sökväg fungerar från och med uppdateringen av Visual Studio 2019 Update 7.

Du kan också hitta platsen för bootstrapper-mappen från värdet Sökväg i följande registernyckel:

*HKLM\Software\Microsoft\GenericBootstrapper*

På 64-bitarssystem använder du följande registernyckel:

*HKLM\Software\Wow6432Node\Microsoft\GenericBootstrapper*

Varje omdistribuerbar komponent visas i sin egen undermapp under paketkatalogen. Produktmanifestet och omdistribuerbara filer måste placeras i den här undermappen. Lokaliserade versioner av komponent- och paketmanifest måste placeras i undermappar med namnet enligt Kulturnamn.

När dessa filer har kopierats till mappen bootstrapper visas bootstrapper-paketet automatiskt i dialogrutan Förutsättningar för Visual Studio. Om ditt anpassade bootstrapper-paket inte visas stänger du och öppnar sedan dialogrutan Förutsättningar igen. Mer information finns i dialogrutan Förutsättningar.

I följande tabell visas de egenskaper som fylls i automatiskt av bootstrappern.

Fastighet Beskrivning
Applikationsnamn Namnet på applikationen.
Processorarkitektur Processorn och bit-per-word för plattformen som mål för en körbar fil. Värdena omfattar följande:

-Intel
- IA64
– AMD64
VersionNT Versionsnumret för Windows-operativsystemen. Syntaxen för versionen är Major.Minor.ServicePack.
VersionMSI Den version av Windows Installer-sammansättningen (msi.dll) som ska köras under installationen.
AdminUser Den här egenskapen anges om användaren har administratörsbehörighet. Värden är sanna eller falska.
Installationsläge Installationsläget anger var komponenten måste installeras från. Värdena omfattar följande:

– HomeSite – Förutsättningar installeras från leverantörens webbplats.
”SpecificSite” – nödvändiga komponenter installeras från den källa som du väljer.
– SameSite – förutsättningar installeras från samma plats som programmet.

Separera omdistributioner från programinstallationer

Du kan förhindra att dina omdistribuerbara filer distribueras i installationsprojekt. Det gör du genom att skapa en omdistribuerbar lista i mappen RedistList i .NET Framework-katalogen:

%ProgramFiles%\Microsoft.NET\RedistList

Den omdistribuerbara listan är en XML-fil som du bör namnge med följande format: <Företagsnamn>.<Komponentnamn>.RedistList.xml. Om komponenten till exempel heter DataWidgets som görs av Acme använder duAcme.DataWidgets.RedistList.xml. Ett exempel på den omdistribuerbara listans innehåll kan likna följande:

<?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>

Relaterat innehåll