Esempio di creazione di singoli pacchetti

L'esempio PUASample.msi è un esempio di pacchetto windows Installer 5.0 a doppio scopo che è in grado di essere installato nel contesto di installazione per utente o per computer in Windows Server 2008 R2 e Windows 7. Questo pacchetto di esempio segue le linee guida per lo sviluppo descritte in Creazione di pacchetti singoli.

Recupero di una copia dell'esempio

Una copia di questo esempio e di un editor di tabelle di database di Windows Installer, Orca.exe, si trovano nei componenti di Windows SDK per sviluppatori di Windows Installer. L'editor di esempi e tabelle viene fornito con Windows Software Development Kit per Windows Server 2008 R2 e Windows 7 come file di installazione di Windows Installer PUASample1.msi e Orca.msi.

Requisiti di sistema

L'editor di database, Orca.exe, richiede Windows Server 2008 R2 e versioni precedenti e Windows 7 e versioni precedenti. Il pacchetto a doppio scopo, PUASample1.msi, può essere installato nel contesto di installazione per computer o per utente in Windows Server 2008 R2 e Windows 7. PUASample1.msi può essere installato solo nel contesto per computer in Windows Server 2008 e versioni precedenti e Windows Vista e versioni precedenti. È possibile installare l'editor di database per esaminare il contenuto di PUASample1.msi senza installare l'esempio. Per installare i pacchetti dell'esempio o dell'editor, verificare che il criterio DisableMSI non sia impostato su un valore che blocca le installazioni dell'applicazione.

Identificazione di un pacchetto a doppio scopo

I pacchetti a doppio scopo devono inizializzare il valore della proprietà MSIINSTALLPERU edizione Standard R su 1. Questo identifica il pacchetto come in grado di essere installato nel contesto per computer o per utente in Windows Server 2008 R2 e Windows 7. Impostare la proprietà MSIINSTALLPERU edizione Standard R nel pacchetto solo se è stata scritta seguendo le linee guida di sviluppo descritte in Creazione di pacchetti singoli e se si intende fornire agli utenti la possibilità di installare il pacchetto nel contesto per utente o per computer. Un pacchetto a doppio scopo deve anche inizializzare il valore della proprietà ALLU edizione Standard RS su 2. Specifica per utente come contesto di installazione predefinito per l'applicazione. Se il valore della proprietà ALLU edizione Standard RS è qualsiasi valore diverso da 2, Windows Installer ignora la proprietà MSIINSTALLPERU edizione Standard R.

Usare un editor di database di Windows Installer, ad esempio Orca.exe, per esaminare il contenuto di PUASample1.msi. La tabella Property nel pacchetto di esempio contiene le due voci seguenti.

Tabella delle proprietà (parziale)

Finestra di dialogo personalizzata per il contesto di installazione

L'interfaccia utente del pacchetto di esempio include un esempio di una finestra di dialogo personalizzata, VerifyReadyDialog, che consente agli utenti di selezionare il contesto di installazione per utente o per computer in fase di installazione. La tabella Dialog contiene un record che descrive la finestra di dialogo VerifyReadyDialog. Il valore immesso nel campo Attributi è 39 perché questa finestra di dialogo usa i bit di stile msidbDialogAttributesVisible (1), msidbDialogAttributesModal (2), msidbDialogAttributesMinimize (4) e msidbDialogAttributesTrackDiskSpace (32). Nella barra del titolo della finestra di dialogo viene visualizzato un titolo specificato dal valore della proprietà ProductName.

Tabella finestra di dialogo (parziale)

La tabella Control contiene voci per i controlli visualizzati dalla finestra di dialogo VerifyReadyDialog. Nella finestra di dialogo vengono visualizzati i controlli PushButton e un controllo Testo . Tutti i controlli usano gli attributi del controllo msidbControlAttributesEnabled (2) e msidbControlAttributesVisible (1). Il controllo InstallPerMachine usa anche l'attributo di controllo ElevationShield , msidbControlAttributesElevationShield (8388608.) Questo attributo di controllo aggiunge l'icona di elevazione dell'account utente (icona di schermata) al controllo InstallPerMachine e informa l'utente che le credenziali di Controllo dell'account utente sono necessarie per installare l'applicazione nel contesto per computer. Il valore nel campo Testo della tabella Control è lo stile di testo e il testo visualizzato dal controllo. Per altre informazioni sull'aggiunta di testo a un controllo tramite stili predefiniti, vedere la descrizione del campo Testo nell'argomento Tabella di controllo.

Tabella di controllo (parziale)

La tabella ControlEvent specifica gli eventi ControlEvent o le azioni eseguite dal programma di installazione quando l'utente interagisce con un controllo. Quando un utente attiva il pulsante di push InstallPerUser, l'interfaccia utente visualizza una finestra di dialogo OutOfDisk se la proprietà OutOfDiskSpace è 1, imposta il valore della proprietà MSIINSTALLPERU edizione Standard R su 1, imposta il valore della proprietà ALLU edizione Standard RS su 2, imposta la proprietà MSIFASTINSTALL su 1 e restituisce . Poiché la proprietà MSIFASTINSTALL è impostata, non viene generato alcun punto di ripristino di sistema per l'installazione. Quando un utente attiva il pulsante di push InstallPerMachine, l'interfaccia utente visualizza una finestra di dialogo OutOfDisk se la proprietà OutOfDiskSpace è 1, imposta il valore della proprietà ALLU edizione Standard RS su 1 e restituisce .

Tabella ControlEvent (parziale)

Il controllo InstallPerUser deve essere rimosso dall'interfaccia utente di qualsiasi installazione usando una versione di Windows Installer precedente a Windows Installer Windows Installer 5.0. La tabella ControlCondition nel pacchetto di esempio contiene quattro voci che disabilitano e nascondono il controllo InstallPerUser se la versione corrente è minore di Windows Installer 5.0. La tabella usa il valore della proprietà VersionMsi e la sintassi dell'istruzione condizionale per definire questa condizione. L'azione specificata nel campo Azione viene eseguita solo se l'istruzione nel campo Condizione è true.

Tabella ControlCondition (parziale)

Specifica della struttura di directory

Usare l'editor di database per esaminare la tabella Directory di PUASample1.msi. Il record della tabella directory con una stringa vuota nel campo Directory_Parent rappresenta la directory radice degli alberi delle directory di origine e di destinazione. Se la proprietà TARGETDIR non è definita, il programma di installazione imposta il valore in fase di installazione sul valore della proprietà ROOTDRIVE. Se la proprietà SourceDir non è definita, il programma di installazione imposta il relativo valore sul percorso della directory contenente il pacchetto windows Installer (file con estensione msi). I nomi di directory vengono specificati utilizzando il formato short|long.

Tabella directory (parziale)

Nell'origine, questa tabella directory viene risolta nei percorsi di directory seguenti.

\[SourceDir\]\\Msft\\Sample1 \[SourceDir\]

Nella destinazione la tabella Directory viene risolta nei percorsi nella tabella seguente. Il programma di installazione imposta i valori delle proprietà ProgramFilesFolder e ProgramMenuFolder in percorsi che dipendono dal contesto di installazione e dal fatto che il sistema sia la versione a 32 bit o a 64 bit di Windows Server 2008 R2 e Windows 7. I percorsi delle cartelle di destinazione dipendono dal fatto che l'utente selezioni un'installazione per utente o per computer.

Le applicazioni per utente devono essere archiviate in sottocartelle nella cartella Programmi specificata dal valore della proprietà ProgramFilesFolder. In genere, il percorso dell'applicazione assume il formato seguente.

%LOCALAPPDATA%\Programs\ISV name\AppName.

I dati di configurazione per utente devono essere archiviati nella cartella Programmi specificata dal valore della proprietà ProgramMenuFolder. In genere, questa cartella si trova nel percorso seguente.

%APPDATA%\Microsoft\Windows\Menu Start\Programmi

Se si installano componenti del pacchetto Windows Installer a 32 bit, utilizzare la proprietà ProgramFilesFolder e CommonFilesFolder nella tabella Directory. Se si installano componenti del pacchetto Windows Installer a 64 bit, utilizzare le proprietà ProgramFiles64Folder e CommonFiles64Folder. Se l'applicazione contiene versioni a 32 bit e a 64 bit dello stesso componente, con lo stesso nome, assicurarsi che queste versioni vengano salvate in directory diverse o assegnare nomi diversi.

La tabella Directory seguente fornisce un esempio di layout di directory compatibile con un pacchetto che include componenti a 32 bit e a 64 bit e include alcuni componenti condivisi tra applicazioni.

Nell'origine, questa tabella directory viene risolta nei percorsi di directory seguenti.

\[SourceDir\]Prog32\\Msft\\Sample1\\x32\\myapp \[SourceDir\]Share32\\Common Files\\Msft\\Sample1\\x32\\shared \[SourceDir\\]Prog64\\Msft\\Sample1\\x64\\myapp \[SourceDir\]Share64\\Common Files\\Msft\\Sample1\\x64\\shared \[SourceDir\]Sample1

Nella destinazione questa tabella directory viene risolta nei percorsi di directory seguenti. I percorsi di destinazione dipendono dal contesto di installazione e dal sistema.

Registrazione dell'applicazione

PUASample.msi aggiunge una sottochiave alla chiave del Registro di sistema Percorsi app per l'applicazione ed esegue registrazioni che consentono di salvare le informazioni dell'applicazione nel Registro di sistema in questa chiave. Per altre informazioni sui percorsi dell'app e sulla registrazione dell'applicazione, vedere la sezione PerceivedTypes, SystemFileAssociations e Application Registration (Registrazione dell'applicazione) nella sezione relativa all'estendibilità della shell della Guida per sviluppatori della shell. Al momento dell'installazione, l'utente decide di installare l'applicazione nel contesto di installazione per utente o per computer. Al momento della creazione del pacchetto a doppio scopo, lo sviluppatore del pacchetto non può sapere se le registrazioni devono essere eseguite con le chiavi HKEY_LOCAL_MACHINE o HKEY_CURRENT_Uedizione Standard R.

Lo sviluppatore del pacchetto definisce l'identificatore di file per il file eseguibile dell'applicazione nel campo File della tabella file .

Tabella file (parziale)

I valori da salvare nel Registro di sistema possono essere specificati nel campo Valore della tabella Del Registro di sistema come stringa formattata . Usare l'identificatore di file definito nel campo File della tabella File e la convenzione [#filekey] del tipo formattato per specificare il valore predefinito per la chiave del Registro di sistema Percorsi app. L'azione INSTALL di primo livello esegue le azioni nella tabella InstallExecuteSequence. Al termine delle azioni CostInitialize, FileCost e InstallFinalize in questa tabella, Windows Installer sostituisce la sottostringa formattata [#MyAppFile] nella tabella Registro di sistema con il percorso completo del file dell'applicazione.

L'esempio definisce una proprietà personalizzata, RegRoot, per contenere il percorso della chiave radice e usa un'azione personalizzata per reimpostare il valore della proprietà se l'utente sceglie un'installazione per computer. Usare la proprietà personalizzata RegRoot in qualsiasi valore stringa formattato che faccia riferimento alla posizione radice. Nella tabella Property il pacchetto PUASample.msi definisce la proprietà personalizzata e imposta il valore di RegRoot su HKCU. Inizializza il valore della proprietà per il contesto di installazione per utente, il contesto predefinito consigliato per i pacchetti a doppio scopo.

Tabella delle proprietà (parziale)

Nella tabella CustomAction il pacchetto definisce un'azione personalizzata denominata Set_RegRoot_HKLM. Il valore nel campo Tipo lo identifica come azione personalizzata tipo di azione personalizzata 51 standard. Il significato dei campi Origine e Destinazione nella tabella CustomAction dipende dal tipo di azione personalizzato. Per altre informazioni sui tipi standard di azioni personalizzate, vedere Tipi di azione personalizzati. Il campo Origine per l'azione personalizzata Set_RegRoot_HKLM specifica che il valore della proprietà RegRoot. Se il programma di installazione esegue l'azione personalizzata Set_RegRoot_HKLM, il valore della proprietà RegRoot viene reimpostato su HKLM.

Tabella CustomAction (parziale)

L'azione INSTALL di primo livello esegue le azioni nella tabella InstallExecuteSequence, nella sequenza specificata nel campo Sequenza di tale tabella. Il valore creato nel campo Sequenza per l'azione personalizzata Set_RegRoot_HKLM (1501) specifica che questa azione personalizzata deve essere eseguita dopo l'azione InstallInitialize (1500) e prima dell'azione ProcessComponents (1600). Questa sequenza garantisce che il record per l'azione personalizzata Set_RegRoot_HKLM venga valutato in fase di installazione. Per altre informazioni sulla sequenza consigliata di azioni nella tabella InstallExecuteSequence, vedere l'argomento Suggested InstallExecuteSequence . La sintassi dell'istruzione condizionale creata nel campo Condizione specifica che l'azione Set_RegRoot_HKLM deve essere eseguita solo se il valore della proprietà ALLU edizione Standard RS restituisce 1 al momento dell'installazione. Il valore della proprietà ALLU edizione Standard RS pari a 1 specifica un'installazione per computer.

Tabella InstallExecuteSequence (parziale)

I record seguenti nella tabella Registry eseguono le registrazioni se è installato il componente ProductComponent. Il valore -1 nel campo Radice è necessario per eseguire la registrazione in HKEY_LOCAL_MACHINE per un'installazione per utente e in HKEY_CURRENT_Uedizione Standard R per un'installazione per utente. Il record con una stringa vuota nel campo Registro di sistema aggiunge una sottochiave per l'applicazione nella chiave del Registro di sistema AppPaths e imposta il valore "(Default)" sul percorso completo del file eseguibile dell'applicazione. La registrazione myAppPathAlias esegue il mapping del file eseguibile a un alias dell'applicazione e consente l'avvio dell'applicazione se l'utente digita l'alias "puapct" al prompt della riga di comando. La registrazione myAppPathRegistration esegue il mapping del nome del file eseguibile al percorso completo del file.

Registrazione di annullamento autoPlay

PUASample.msi esegue registrazioni che consentono all'utente dell'applicazione di impedire l'avvio di Riproduzione automatica hardware per i dispositivi selezionati. Per informazioni sulla registrazione di un gestore per annullare la riproduzione automatica in risposta a un evento, vedere l'argomento Preparazione dell'hardware e del software per l'uso con AutoPlay nella sezione estendibilità della shell della Guida per sviluppatori della shell. Il record seguente registra il gestore specificato nel campo Name quando viene installato il componente ProductComponent. Il valore -1 nel campo Radice è necessario per specificare a Windows Installer che la registrazione deve essere reindirizzata a un percorso che dipende dal contesto di installazione.

Tabella del Registro di sistema

Registrazione del gestore di anteprima

PUASample.msi esegue registrazioni necessarie per installare un gestore di anteprima che consente un'anteprima di sola lettura dei file con estensione pua senza avviare l'applicazione. Per informazioni sulla registrazione dei gestori di anteprima, vedere l'argomento Registrazione dei gestori di anteprima nella sezione relativa all'estendibilità della shell della Guida per gli sviluppatori di Shell. I record seguenti nella tabella Registry registrano il gestore quando viene installato il componente ProductComponent. Il valore -1 nel campo Radice è necessario per specificare a Windows Installer che la registrazione deve essere reindirizzata a un percorso che dipende dal contesto di installazione.

Tabella del Registro di sistema