Procedura dettagliata: distribuzione manuale di una applicazione ClickOnce che non richiede una nuova firma e conserva le informazioni di personalizzazione

Articolo
08/11/2011

Quando si crea un'applicazione ClickOnce e quindi la si passa a un cliente per la pubblicazione e la distribuzione, in genere il cliente deve aggiornare il manifesto della distribuzione e firmarlo di nuovo. Sebbene questo sia ancora il metodo consigliato nella maggior parte dei casi, in .NET Framework 3.5 è possibile di creare distribuzioni di ClickOnce che possono essere distribuite dai clienti senza dover rigenerare un nuovo manifesto della distribuzione. Per ulteriori informazioni, vedere Distribuzione di applicazioni ClickOnce per i server di test e di produzione senza riapposizione della firma.

Quando si crea un'applicazione ClickOnce per poi passarla a un cliente che la pubblicherà e distribuirà, l'applicazione può utilizzare le informazioni di personalizzazione del cliente oppure conservare le proprie. Se, ad esempio, l'applicazione è una singola applicazione proprietaria, è possibile che si desideri conservare le proprie informazioni di personalizzazione. Se invece l'applicazione è fortemente personalizzata per ciascun cliente, è possibile che si desideri utilizzare le informazioni di personalizzazione del cliente. .NET Framework 3.5 consente di conservare le informazioni di personalizzazione, le informazioni sull'editore nonché la firma di sicurezza quando si affida un'applicazione a un'organizzazione per la distribuzione. Per ulteriori informazioni, vedere Creazione di applicazioni ClickOnce per la distribuzione da parte di terzi.

Nota

In questa procedura dettagliata le distribuzioni vengono create manualmente utilizzando lo strumento della riga di comando Mage.exe o lo strumento grafico MageUI.exe. Per ulteriori informazioni sulle distribuzioni manuali, vedere Procedura dettagliata: distribuzione manuale di un'applicazione ClickOnce.

Prerequisiti

Per eseguire i passaggi della procedura, è necessario disporre di quanto segue:

Un'applicazione Windows Form pronta per la distribuzione. Tale applicazione verrà indicata come WindowsFormsApp1.
Visual Studio o Windows SDK.

Per distribuire un'applicazione ClickOnce con il supporto per più distribuzioni e marchi utilizzando Mage.exe

Aprire un prompt dei comandi di Visual Studio o di Windows SDK e passare alla directory in cui verranno archiviati i file di ClickOnce.
Creare una directory con il nome corrispondente alla versione corrente della distribuzione. Se l'applicazione viene distribuita per la prima volta, il nome più probabile sarà 1.0.0.0.

Nota

La versione della distribuzione può essere distinta da quella dei file dell'applicazione.
Creare una sottodirectory con il nome bin e copiarvi tutti i file dell'applicazione, inclusi eseguibili, assembly, risorse e file di dati.

Generare il manifesto dell'applicazione eseguendo una chiamata a Mage.exe.

mage -New Application -ToFile 1.0.0.0\WindowsFormsApp1.exe.manifest -Name "Windows Forms App 1" -Version 1.0.0.0 -FromDirectory 1.0.0.0\bin -UseManifestForTrust true -Publisher "A. Datum Corporation"

Firmare il manifesto dell'applicazione con il certificato digitale.
```
mage -Sign WindowsFormsApp1.exe.manifest -CertFile mycert.pfx
```
Generare il manifesto di distribuzione eseguendo una chiamata a Mage.exe. Per impostazione predefinita, Mage.exe contrassegna la distribuzione ClickOnce come un'applicazione installata, consentendone l'esecuzione sia online che offline. Per rendere disponibile l'applicazione solo quando l'utente è online, utilizzare l'argomento -i con il valore f. Poiché questa applicazione usufruisce della funzionalità di distribuzione multipla, escludere l'argomento -providerUrl di Mage.exe. (Nelle versioni di .NET Framework precedenti alla versione 3.5, l'esclusione di -providerUrl per un'applicazione offline restituisce un errore.)
```
mage -New Deployment -ToFile WindowsFormsApp1.application -Name "Windows Forms App 1" -Version 1.0.0.0 -AppManifest 1.0.0.0\WindowsFormsApp1.manifest 
```
Non firmare il manifesto di distribuzione.
Fornire tutti i file al cliente che distribuirà l'applicazione nella propria rete.
In questa fase, il cliente deve firmare il manifesto di distribuzione con il proprio certificato autogenerato. Se, ad esempio, il cliente lavora per un'azienda denominata Adventure Works, può generare un certificato autofirmato utilizzando lo strumento MakeCert.exe. Successivamente, dovrà utilizzare lo strumento Pvk2pfx.exe per combinare i file creati da MakeCert.exe in un file PFX che è possibile passare a Mage.exe.
```
makecert -r -pe -n "CN=Adventure Works" -sv MyCert.pvk MyCert.cer
pvk2pfx.exe -pvk MyCert.pvk -spc MyCert.cer -pfx MyCert.pfx
```
Il cliente utilizza quindi questo certificato per firmare il manifesto di distribuzione.
```
mage -Sign WindowsFormsApp1.application -CertFile MyCert.pfx
```
Il cliente distribuisce l'applicazione ai propri utenti.

Per distribuire un'applicazione ClickOnce con il supporto per più distribuzioni e marchi utilizzando MageUI.exe

Aprire un prompt dei comandi di Visual Studio o di Windows SDK e passare alla directory in cui verranno archiviati i file di ClickOnce.
Creare una sottodirectory con il nome bin e copiarvi tutti i file dell'applicazione, inclusi eseguibili, assembly, risorse e file di dati.
Creare una sottodirectory con il nome corrispondente alla versione corrente della distribuzione. Se l'applicazione viene distribuita per la prima volta, il nome più probabile sarà 1.0.0.0.

Nota

La versione della distribuzione può essere distinta da quella dei file dell'applicazione.
Spostare la directory \bin in quella creata al passaggio 2.
Avviare lo strumento grafico MageUI.exe.
```
MageUI.exe
```
Creare un nuovo manifesto dell'applicazione scegliendo Nuovo dal menu File, quindi Manifesto applicazione.
Nella scheda Nome predefinita immettere il nome e il numero di versione della distribuzione. Specificare inoltre un valore per l'opzione Editore che verrà utilizzato come nome di cartella per il collegamento dell'applicazione nel menu Start al momento della distribuzione.
Selezionare la scheda Opzioni applicazione e fare clic su Usa manifesto applicazione per informazioni sull'attendibilità. In questo modo si attiverà il marchio di terze parti per questa applicazione ClickOnce.
Fare clic sulla scheda File, quindi scegliere il pulsante Sfoglia accanto alla casella di testo Directory dell'applicazione.
Selezionare la directory contenente i file dell'applicazione creati nel passaggio 2, quindi scegliere OK nella finestra di dialogo per la selezione delle cartelle.
Scegliere il pulsante Popola per aggiungere tutti i file dell'applicazione all'elenco dei file. Se l'applicazione contiene più file eseguibili, contrassegnare quello principale per la distribuzione corrente come applicazione di avvio selezionando Punto di ingresso dall'elenco a discesa Tipo file. Se l'applicazione contiene un solo file eseguibile, questo verrà contrassegnato automaticamente da MageUI.exe.
Fare clic sulla scheda Autorizzazioni necessarie e selezionare il livello di attendibilità che dovrà essere richiesto dall'applicazione. Il valore predefinito, Attendibilità totale, è adatto alla maggior parte delle applicazioni.
Scegliere Salva dal menu File, quindi salvare il manifesto dell'applicazione. Al momento del salvataggio del manifesto verrà chiesto di firmarlo.
Se si dispone di un certificato archiviato nel file system, utilizzare l'opzione Firma come file di certificato e selezionare il certificato dal file system utilizzando il pulsante con i puntini di sospensione (...).

-oppure-

Se il certificato si trova in un archivio certificati accessibile dal computer locale, scegliere l'opzione Firma con un certificato archiviato e selezionare il certificato dall'elenco fornito.
Scegliere Nuovo dal menu File, quindi Manifesto di distribuzione per creare il manifesto di distribuzione. Nella scheda Nome specificare un nome e un numero di versione (in questo esempio, 1.0.0.0).
Fare clic sulla scheda Aggiorna e specificare la frequenza di aggiornamento che si desidera impostare per l'applicazione. Se l'applicazione utilizza l'API della distribuzione ClickOnce per il controllo automatico degli aggiornamenti, deselezionare la casella di controllo Controlla aggiornamenti dell'applicazione.
Fare clic sulla scheda Riferimenti applicazione. Tutti i valori di questa scheda possono essere impostati automaticamente scegliendo il pulsante Seleziona manifesto e selezionando il manifesto dell'applicazione creato nei passaggi precedenti.
Scegliere Salva e salvare il manifesto di distribuzione sul disco. Al momento del salvataggio del manifesto verrà chiesto di firmarlo. Fare clic su Annulla per salvare il manifesto senza firmarlo.
Fornire tutti i file dell'applicazione al cliente.
In questa fase, il cliente deve firmare il manifesto di distribuzione con il proprio certificato autogenerato. Se, ad esempio, il cliente lavora per un'azienda denominata Adventure Works, può generare un certificato autofirmato utilizzando lo strumento MakeCert.exe. Successivamente, dovrà utilizzare lo strumento Pvk2pfx.exe per combinare i file creati da MakeCert.exe in un file PFX che è possibile passare a MageUI.exe.
```
makecert -r -pe -n "CN=Adventure Works" -sv MyCert.pvk MyCert.cer
pvk2pfx.exe -pvk MyCert.pvk -spc MyCert.cer -pfx MyCert.pfx
```
Dopo aver generato il certificato, il cliente firma il manifesto di distribuzione aprendolo in MageUI.exe e quindi salvandolo. Quando la finestra di dialogo di firma viene visualizzata, il cliente seleziona l'opzione Firma come file di certificato e sceglie il file PFX che ha salvato su disco.
Il cliente distribuisce l'applicazione ai propri utenti.

Vedere anche

Riferimenti

Mage.exe (Strumento per la generazione e la modifica di manifesti)

MageUI.exe (Strumento per la generazione e la modifica di manifesti, client grafico)

Makecert.exe (strumento di creazione certificati)

Condividi tramite