Condividi tramite

Creare pacchetti bootstrap

Il programma di installazione è un programma di installazione generico che può essere configurato per rilevare e installare componenti ridistribuibili, ad esempio i file di Windows Installer (.msi) e i programmi eseguibili. Il programma di installazione è noto anche come programma di avvio automatico. Viene programmato tramite un set di manifesti XML che specificano i metadati per gestire l'installazione del componente. Ogni componente ridistribuibile o prerequisito visualizzato nella finestra di dialogo Prerequisiti per ClickOnce è un pacchetto del programma di avvio automatico. Un pacchetto del programma di avvio automatico è un gruppo di directory e file che contengono file manifesto che descrivono come deve essere installato il prerequisito.

Il programma di avvio automatico rileva prima se uno dei prerequisiti è già installato. Se i prerequisiti non sono installati, il programma di avvio automatico mostra prima i contratti di licenza. In secondo luogo, dopo che l'utente finale accetta i contratti di licenza, l'installazione inizia per i prerequisiti. Altrimenti, se vengono rilevati tutti i prerequisiti, il bootstrapper avvia semplicemente il programma di installazione dell'applicazione.

Creare pacchetti bootstrapper personalizzati

È possibile generare i manifesti del programma di avvio automatico usando l'editor XML in Visual Studio. Per un esempio di creazione di un pacchetto del programma di avvio automatico, vedere Procedura dettagliata: Creare un programma di avvio automatico personalizzato con una richiesta di privacy.

Per creare un pacchetto del programma di avvio automatico, è necessario creare un manifesto del prodotto e, anche per ogni versione localizzata di un componente, un manifesto del pacchetto.

  • Il manifesto del prodotto ,product.xml, contiene tutti i metadati indipendenti dalla lingua per il pacchetto. Contiene metadati comuni a tutte le versioni localizzate del componente ridistribuibile. Per creare questo file, vedere Procedura: Creare un manifesto del prodotto.

  • Il manifesto del pacchetto, package.xml, contiene metadati specifici della lingua; in genere contiene messaggi di errore localizzati. Un componente deve avere almeno un manifesto del pacchetto per ogni versione localizzata di tale componente. Per creare questo file, vedere Procedura: Creare un manifesto del pacchetto.

Dopo aver creato questi file, inserire il file manifesto del prodotto in una cartella denominata per il programma di avvio automatico personalizzato. Il file manifesto del pacchetto viene inserito in una cartella denominata per le impostazioni locali. Ad esempio, se il file manifesto del pacchetto è per la ridistribuzione inglese, inserire il file in una cartella denominata en. Ripetere questo processo per ogni impostazione locale, ad esempio ja per il giapponese e de per il tedesco. Il pacchetto del programma di avvio automatico personalizzato finale potrebbe avere la struttura di cartelle seguente.

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

Copia quindi i file ridistribuibili nella cartella del bootstrapper. Per altre informazioni, vedere Procedura: Creare un pacchetto del programma di avvio automatico localizzato.

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

o

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

Annotazioni

Il percorso riportato sopra nel percorso di installazione di Visual Studio funziona a partire dalla versione di Visual Studio 2019 Update 7.

È anche possibile trovare il percorso della cartella del programma di avvio automatico dal valore Path nella chiave del Registro di sistema seguente:

*HKLM\Software\Microsoft\GenericBootstrapper*

Nei sistemi a 64 bit usare la chiave del Registro di sistema seguente:

*HKLM\Software\Wow6432Node\Microsoft\GenericBootstrapper*

Ogni componente ridistribuibile appare nella propria sottocartella nella directory dei pacchetti. Il manifesto del prodotto e i file ridistribuibili devono essere inseriti in questa sottocartella. Le versioni localizzate del componente e dei manifesti del pacchetto devono essere inserite in sottocartelle denominate in base al nome cultura.

Dopo aver copiato questi file nella cartella del programma di avvio automatico, il pacchetto del programma di avvio automatico viene visualizzato automaticamente nella finestra di dialogo Prerequisiti di Visual Studio. Se il pacchetto del programma di avvio automatico personalizzato non viene visualizzato, chiudere e quindi riaprire la finestra di dialogo Prerequisiti . Per altre informazioni, vedere La finestra di dialogo Prerequisiti.

Nella tabella seguente sono mostrate le proprietà popolate automaticamente dal bootstrapper.

Proprietà Descrizione
Nome dell'Applicazione Nome dell'applicazione.
ArchitetturaDelProcessore Processore e bit per parola della piattaforma di destinazione di un eseguibile. Sono inclusi i valori seguenti:

-Intel
- IA64
- AMD64
VersionNT Numero di versione per i sistemi operativi Windows. La sintassi della versione è Major.Minor.ServicePack.
VersionMSI Versione dell'assembly di Windows Installer (msi.dll) da eseguire durante l'installazione.
AdminUser Questa proprietà viene impostata se l'utente dispone di privilegi di amministratore. I valori sono true o false.
Modalità di Installazione La modalità di installazione indica da dove deve essere installato il componente. Sono inclusi i valori seguenti:

- HomeSite: i prerequisiti vengono installati dal sito Web del fornitore.
- SpecificSite - i prerequisiti vengono installati dalla posizione che selezioni.
- SameSite - i prerequisiti vengono installati dalla stessa posizione dell'applicazione.

Separare i ridistribuibili dalle installazioni di applicazioni

È possibile impedire la distribuzione dei file ridistribuibili nei progetti di installazione. A tale scopo, creare un elenco ridistribuibile nella cartella RedistList nella directory di .NET Framework:

%ProgramFiles%\Microsoft.NET\RedistList

L'elenco ridistribuibile è un file XML da assegnare al formato seguente: <Nome> società.<Nome> componente.RedistList.xml. Ad esempio, se il componente è denominato DataWidgets creato da Acme, usare Acme.DataWidgets.RedistList.xml. Un esempio del contenuto dell'elenco ridistribuibile potrebbe essere simile al seguente:

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

Contenuti correlati