Condividi tramite

Specificare le proprietà di pubblicazione ClickOnce

È possibile configurare le proprietà Di pubblicazione ClickOnce nella pagina Pubblica di Progettazione progetti oppure tramite la Pubblicazione guidata. Questo articolo illustra come specificare proprietà come il percorso di pubblicazione, l'URL di installazione, la modalità di installazione online o offline e la versione di pubblicazione.

Annotazioni

In ClickOnce per .NET Core 3.1 e .NET 5 o versione successiva è possibile impostare le proprietà di distribuzione usando lo strumento Pubblica anziché la pubblicazione guidata e la pagina Pubblica di Progettazione progetti. Per altre informazioni, vedere Distribuire un'applicazione Windows .NET con ClickOnce e ClickOnce per .NET.

Specificare un luogo di pubblicazione

Quando si pubblica un'applicazione usando ClickOnce, la Publish Location proprietà specifica il percorso in cui vengono inseriti i file e il manifesto dell'applicazione. Può trattarsi di un percorso di unità (C:\deploy\myapplication), di una condivisione file (\\server\myapplication) o di un server FTP (ftp://ftp.microsoft.com/myapplication). Si noti che il testo deve essere presente nella casella Percorso di pubblicazione affinché il pulsante Sfoglia (...) funzioni.

È possibile specificare la Publish Location proprietà nella pagina Pubblica della Progettazione del progetto oppure tramite la procedura guidata di pubblicazione. Per altre informazioni, vedere Procedura: Pubblicare un'applicazione ClickOnce tramite la Pubblicazione guidata.

Annotazioni

Quando si installano più versioni di un'applicazione usando ClickOnce, l'installazione sposta le versioni precedenti dell'applicazione in una cartella denominata Archive, nel percorso di pubblicazione specificato. L'archiviazione delle versioni precedenti in questo modo impedisce alla directory di installazione di cancellare le cartelle dalla versione precedente.

  1. Con un progetto selezionato in Esplora soluzioni scegliere Proprietà dal menu Progetto.

  2. Fare clic sulla scheda Pubblica .

  3. Nel campo Percorso di pubblicazione immettere il percorso di pubblicazione usando uno dei formati seguenti:

    • Per pubblicare in una condivisione file o in un percorso del disco, immettere il percorso usando un percorso UNC (\\Server\ApplicationName) o un percorso di file (C:\Deploy\ApplicationName).

    • Per pubblicare in un server FTP, immettere il percorso usando il formato ftp://ftp.microsoft.com/<ApplicationName>.

      Si noti che il testo deve essere presente nella casella Percorso di pubblicazione affinché il pulsante Sfoglia (...) funzioni.

Specificare il percorso da cui verranno installati gli utenti finali

Quando si pubblica un'applicazione ClickOnce, il percorso in cui gli utenti passano per scaricare e installare l'applicazione non è necessariamente il percorso in cui si pubblica inizialmente l'applicazione. Ad esempio, in alcune organizzazioni uno sviluppatore potrebbe pubblicare un'applicazione in un server di staging e quindi un amministratore sposta l'applicazione in un server Web.

In questo caso, è possibile usare la Installation URL proprietà per specificare il server Web in cui gli utenti dovranno scaricare l'applicazione. Questa operazione è necessaria in modo che il manifesto dell'applicazione sappia dove cercare gli aggiornamenti.

La Installation URL proprietà può essere impostata nella pagina Pubblica di Progettazione progetti.

Annotazioni

La Installation URL proprietà può essere impostata anche tramite PublishWizard. Per altre informazioni, vedere Procedura: Pubblicare un'applicazione ClickOnce tramite la Pubblicazione guidata.

Specificare un URL di installazione

  1. Con un progetto selezionato in Esplora soluzioni scegliere Proprietà dal menu Progetto.

  2. Fare clic sulla scheda Pubblica .

  3. Nel campo URL di installazione, immettere il percorso di installazione usando un URL completo nel formato https://www.contoso.com/ApplicationName, oppure un percorso UNC nel formato \Server\ApplicationName.

Specificare la modalità di installazione offline o online di ClickOnce.

Install Mode per un'applicazione ClickOnce determina se l'applicazione sarà disponibile offline o online. Quando si sceglie L'applicazione è disponibile solo online, l'utente deve avere accesso al percorso di pubblicazione ClickOnce (una pagina Web o una condivisione file) per eseguire l'applicazione. Quando si sceglie Anche l'applicazione è disponibile offline, l'applicazione aggiunge voci al menu Start e la finestra di dialogo Installazione applicazioni ; l'utente è in grado di eseguire l'applicazione quando non sono connessi.

Install Mode può essere impostato nella pagina Pubblica del Designer del Progetto.

Annotazioni

L'oggetto Install Mode può anche essere impostato tramite la procedura guidata di pubblicazione. Per altre informazioni, vedere Procedura: Pubblicare un'applicazione ClickOnce tramite la Pubblicazione guidata.

Rendere disponibile solo online un'applicazione ClickOnce

  1. Con un progetto selezionato in Esplora soluzioni scegliere Proprietà dal menu Progetto.

  2. Fare clic sulla scheda Pubblica .

  3. Nell'area Modalità di installazione e impostazioni fare clic sul pulsante di opzione L'applicazione è disponibile solo online .

Rendere disponibile un'applicazione ClickOnce online o offline

  1. Con un progetto selezionato in Esplora soluzioni scegliere Proprietà dal menu Progetto.

  2. Fare clic sulla scheda Pubblica .

  3. Nell'area Modalità di installazione e impostazioni fare clic sul pulsante di opzione L'applicazione è disponibile anche offline .

    Quando è installato, l'applicazione aggiunge voci al menu Start e a Installazione applicazioni nel Pannello di controllo.

Impostare la versione di pubblicazione di ClickOnce

La proprietà ClickOnce Publish Version determina se l'applicazione che si sta pubblicando verrà considerata come un aggiornamento. Ogni volta che viene incrementata la versione, l'applicazione verrà pubblicata come aggiornamento.

La Publish Version proprietà può essere impostata nella pagina Pubblica di Progettazione progetti.

Quando il numero di versione viene modificato, l'applicazione viene pubblicata come aggiornamento. Ogni parte della versione di pubblicazione (Major, Minor, Build, Revision) può avere un valore massimo pari a 65535 (MaxValue), il valore massimo consentito da Version.

Quando si installano più versioni di un'applicazione usando ClickOnce, l'installazione sposta le versioni precedenti dell'applicazione in una cartella denominata Archive, nel percorso di pubblicazione specificato. L'archiviazione delle versioni precedenti in questo modo impedisce alla directory di installazione di cancellare le cartelle dalla versione precedente.

Annotazioni

È disponibile un'opzione di progetto che incrementerà automaticamente la Publish Version proprietà ogni volta che l'applicazione viene pubblicata. Questa opzione è abilitata per impostazione predefinita. Per ulteriori informazioni, vedere Incremento automatico della versione di pubblicazione ClickOnce.

Modificare la versione di pubblicazione

  1. Con un progetto selezionato in Esplora soluzioni, scegliere Proprietà dal menu Progetto.

  2. Fare clic sulla scheda Pubblica .

  3. Nel campo Publish Version, incrementa il numero principale, secondario, build o revisione della versione.

    Annotazioni

    Non devi mai decrementare un numero di versione; in questo modo potrebbe causare un comportamento di aggiornamento imprevedibile.

Incrementare automaticamente la versione di pubblicazione ClickOnce

Quando si pubblica un'applicazione ClickOnce, la modifica della proprietà Publish Version fa sì che l'applicazione venga pubblicata come aggiornamento. Per impostazione predefinita, Visual Studio incrementa automaticamente il numero Revision del Publish Version ogni volta che si pubblica l'applicazione.

È possibile disabilitare questo comportamento nella pagina Pubblica di Progettazione progetti.

Annotazioni

Le finestre di dialogo e i comandi di menu visualizzati potrebbero differire da quelli descritti nella Guida in base alle impostazioni o all'edizione attiva. Per modificare le impostazioni, scegliere Importa/Esporta impostazioni dal menu Strumenti . Per altre informazioni vedere Reimpostare le impostazioni.

Disabilitare l'incremento automatico della versione di pubblicazione

  1. Con un progetto selezionato in Esplora soluzioni scegliere Proprietà dal menu Progetto.

  2. Fare clic sulla scheda Pubblica .

  3. Nella sezione Pubblica versione deselezionare la casella di controllo Incrementa automaticamente la revisione con ogni versione .

Specificare una pagina di pubblicazione per un'applicazione ClickOnce

Quando si pubblica un'applicazione ClickOnce, viene generata e pubblicata una pagina Web predefinita (publish.htm) insieme all'applicazione. Questa pagina contiene il nome dell'applicazione, un collegamento per installare l'applicazione e/o i prerequisiti e un collegamento a un argomento della Guida che descrive ClickOnce. La proprietà Pubblica pagina per il progetto consente di specificare un nome per la pagina Web per l'applicazione ClickOnce.

Dopo aver specificato la pagina di pubblicazione, quando pubblichi di nuovo, verrà copiata nel percorso di pubblicazione; non verrà sovrascritta se si pubblica nuovamente. Se si desidera personalizzare l'aspetto della pagina, è possibile farlo senza preoccuparsi di perdere le modifiche. Per altre informazioni, vedere Personalizzare la pagina Web predefinita clickOnce.

La proprietà Pubblica pagina può essere impostata nella finestra di dialogo Opzioni di pubblicazione accessibile dal riquadro Pubblica di Progettazione progetti.

Per specificare una pagina Web personalizzata per un'applicazione ClickOnce:

  1. Con un progetto selezionato in Esplora soluzioni, scegliere Proprietà dal menu Progetto.

  2. Selezionare il riquadro Pubblica .

  3. Fare clic sul pulsante Opzioni per aprire la finestra di dialogo Opzioni di pubblicazione .

  4. Fare clic su Distribuzione.

  5. Nella finestra di dialogo Opzioni di pubblicazione assicurarsi che sia selezionata la casella di controllo Apri pagina Web di distribuzione dopo la pubblicazione .Deve essere selezionata per impostazione predefinita.

  6. Nella casella pagina Web di Distribuzione, immettere il nome della pagina Web e quindi fare clic su OK.

Per impedire l'avvio della pagina di pubblicazione ogni volta che si pubblica:

  1. Con un progetto selezionato in Esplora soluzioni, scegliere Proprietà dal menu Progetto.

  2. Selezionare il riquadro Pubblica .

  3. Fare clic sul pulsante Opzioni per aprire la finestra di dialogo Opzioni di pubblicazione .

  4. Fare clic su Distribuzione.

  5. Nella finestra di dialogo Opzioni di pubblicazione deselezionare la casella di controllo Apri pagina Web di distribuzione dopo la pubblicazione .

Personalizzare la pagina Web predefinita per un'applicazione ClickOnce

Quando si pubblica un'applicazione ClickOnce sul Web, viene generata e pubblicata automaticamente una pagina Web insieme all'applicazione. La pagina predefinita contiene il nome dell'applicazione e i collegamenti per installare l'applicazione, installare i prerequisiti o accedere alla Guida su MSDN.

Annotazioni

I collegamenti effettivi visualizzati nella pagina dipendono dal computer in cui viene visualizzata la pagina e dai prerequisiti inclusi.

Il nome predefinito per la pagina Web è Publish.htm; è possibile modificare il nome in Progettazione progetti. Per altre informazioni, vedere Specificare una pagina di pubblicazione per un'applicazione ClickOnce.

La pagina WebPublish.htm viene pubblicata solo se viene rilevata una versione più recente.

Annotazioni

Le modifiche apportate alle impostazioni di pubblicazione non influiscono sulla pagina Publish.htm , con un'eccezione: se si aggiungono o rimuovono i prerequisiti dopo la pubblicazione iniziale, l'elenco dei prerequisiti non sarà più accurato. Sarà necessario modificare il testo per il collegamento prerequisito per riflettere le modifiche.

Per personalizzare la pagina Web di pubblicazione:

  1. Pubblicare l'applicazione ClickOnce su un percorso Web. Per altre informazioni, vedere Procedura: Pubblicare un'applicazione ClickOnce tramite la Pubblicazione guidata.

  2. Nel server Web aprire il file Publish.htm in Visual Web Designer o in un altro editor HTML.

  3. Personalizzare la pagina in base alle esigenze e salvarla.

  4. Opzionale. Per impedire a Visual Studio di sovrascrivere la pagina Web di pubblicazione personalizzata, deselezionare Genera automaticamente la pagina Web di distribuzione dopo ogni pubblicazione nella finestra di dialogo Opzioni di pubblicazione.

Quando si pubblica un'applicazione ClickOnce, la proprietà URL di supporto identifica una pagina Web o una condivisione file in cui gli utenti possono accedere per ottenere informazioni sull'applicazione. Questa proprietà è facoltativa; se specificato, l'URL verrà visualizzato nella finestra di dialogo Installazione applicazioni della voce dell'applicazione.

La proprietà URL di supporto può essere impostata nella pagina Pubblica di Progettazione progetti.

Per specificare un URL di supporto:

  1. Con un progetto selezionato in Esplora soluzioni scegliere Proprietà dal menu Progetto.

  2. Fare clic sulla scheda Pubblica .

  3. Fare clic sul pulsante Opzioni per aprire la finestra di dialogo Opzioni di pubblicazione .

  4. Fare clic su Descrizione.

  5. Nel campo URL di supporto immettere un percorso completo per un sito Web, una pagina Web o una condivisione UNC.

Specificare un URL di supporto per i singoli prerequisiti in una distribuzione ClickOnce

Una distribuzione ClickOnce può verificare la presenza di diversi prerequisiti che devono essere disponibili sul computer del client per l'esecuzione dell'applicazione ClickOnce. Queste dipendenze includono la versione minima richiesta di .NET Framework, la versione del sistema operativo e tutti gli assembly che devono essere preinstallati nella Global Assembly Cache (GAC). ClickOnce, tuttavia, non può installare nessuno di questi prerequisiti; se non viene trovato un prerequisito, l'installazione viene semplicemente interrotta e viene visualizzata una finestra di dialogo che spiega perché l'installazione non è riuscita.

Esistono due metodi per installare i prerequisiti. È possibile installarli usando un'applicazione del programma di avvio automatico. In alternativa, è possibile specificare un URL di supporto per i singoli prerequisiti, che viene visualizzato agli utenti nella finestra di dialogo se il prerequisito non viene trovato. La pagina a cui fa riferimento tale URL può contenere collegamenti a istruzioni per l'installazione del prerequisito richiesto. Se un'applicazione non specifica un URL di supporto per un singolo prerequisito, ClickOnce visualizza l'URL di supporto specificato nel manifesto della distribuzione per l'applicazione nel suo complesso, se definito.

Anche se Visual Studio, Mage.exee MageUI.exe possono essere usati tutti per generare distribuzioni ClickOnce, nessuno di questi strumenti supporta direttamente la specifica di un URL di supporto per i singoli prerequisiti. Questo documento descrive come modificare il manifesto dell'applicazione e il manifesto della distribuzione per includere questi URL di supporto.

Annotazioni

In ClickOnce per .NET Core 3.1 e .NET 5 o versione successiva è possibile impostare le proprietà di distribuzione usando lo strumento Pubblica anziché la pubblicazione guidata e la pagina Pubblica di Progettazione progetti. Per altre informazioni, vedere Distribuire un'applicazione Windows .NET con ClickOnce e ClickOnce per .NET.

Specificare un URL di supporto per un singolo prerequisito

  1. Aprire il manifesto dell'applicazione (il file manifesto ) per l'applicazione ClickOnce in un editor di testo.

  2. Per un prerequisito del sistema operativo, aggiungere l'attributo supportUrl all'elemento dependentOS :

     <dependency>
    <dependentOS supportUrl="http://www.adatum.com/MyApplication/wrongOSFound.htm">
      <osVersionInfo>
        <os majorVersion="5" minorVersion="1" buildNumber="2600" servicePackMajor="0" servicePackMinor="0" />
      </osVersionInfo>
    </dependentOS>
  </dependency>

  3. Per un prerequisito per una determinata versione di Common Language Runtime, aggiungere l'attributo supportUrl alla dependentAssembly voce che specifica la dipendenza di Common Language Runtime:

      <dependency>
    <dependentAssembly dependencyType="preRequisite" allowDelayedBinding="true" supportUrl=" http://www.adatum.com/MyApplication/wrongClrVersionFound.htm">
      <assemblyIdentity name="Microsoft.Windows.CommonLanguageRuntime" version="4.0.30319.0" />
    </dependentAssembly>
  </dependency>

  4. Per un assembly che deve essere preinstallato nella Global Assembly Cache come prerequisito, impostare il supportUrl per l'elemento dependentAssembly che specifica l'assembly richiesto:

      <dependency>
    <dependentAssembly dependencyType="preRequisite" allowDelayedBinding="true" supportUrl=" http://www.adatum.com/MyApplication/missingSampleGACAssembly.htm">
      <assemblyIdentity name="SampleGACAssembly" version="5.0.0.0" publicKeyToken="04529dfb5da245c5" processorArchitecture="msil" language="neutral" />
    </dependentAssembly>
  </dependency>

  5. Opzionale. Per le applicazioni destinate a .NET Framework 4, aprire il manifesto della distribuzione (il file dell'applicazione) per l'applicazione ClickOnce in un editor di testo.

  6. Per un prerequisito di .NET Framework 4, aggiungere l'attributo supportUrl all'elemento compatibleFrameworks :

    <compatibleFrameworks  xmlns="urn:schemas-microsoft-com:clickonce.v2" supportUrl="http://adatum.com/MyApplication/CompatibleFrameworks.htm">
  <framework targetVersion="4.0" profile="Client" supportedRuntime="4.0.30319" />
  <framework targetVersion="4.0" profile="Full" supportedRuntime="4.0.30319" />
</compatibleFrameworks>

  7. Dopo aver modificato manualmente il manifesto dell'applicazione, è necessario firmare nuovamente il manifesto dell'applicazione usando il certificato digitale, quindi aggiornare e firmare nuovamente il manifesto della distribuzione. Usare gli strumenti Mage.exe o MageUI.exe SDK per eseguire questa attività, perché la rigenerazione di questi file tramite Visual Studio cancella le modifiche manuali. Per altre informazioni sull'uso di Mage.exe per firmare nuovamente i manifesti, vedere Procedura: Firmare nuovamente manifesti dell'applicazione e della distribuzione.

.NET Framework (sicurezza)

L'URL di supporto non viene visualizzato nella finestra di dialogo se l'applicazione è contrassegnata per l'esecuzione in attendibilità parziale.

Annotazioni

In ClickOnce per .NET Core e .NET 5 o versione successiva, l'attendibilità parziale, che richiede la sicurezza dall'accesso al codice, non è supportata. In .NET Framework l'uso della sicurezza dall'accesso di codice non è una procedura consigliata e non è consigliato.

Modificare la lingua di pubblicazione per un'applicazione ClickOnce

Quando si pubblica un'applicazione ClickOnce, l'interfaccia utente visualizzata durante l'installazione si imposta automaticamente sul linguaggio e sulle impostazioni della cultura del computer di sviluppo. Se si pubblica un'applicazione localizzata, è necessario specificare una lingua e impostazioni cultura in modo che corrispondano alla versione localizzata. Questo è determinato dalla proprietà Publish language per il progetto.

La Publish language proprietà può essere impostata nella finestra di dialogo Opzioni di pubblicazione accessibile dalla pagina Pubblica di Progettazione progetti.

Annotazioni

Le finestre di dialogo e i comandi di menu visualizzati potrebbero differire da quelli descritti nella Guida in base alle impostazioni o all'edizione attiva. Per modificare le impostazioni, scegliere Importa/Esporta impostazioni dal menu Strumenti . Per altre informazioni vedere Reimpostare le impostazioni.

Per modificare la lingua di pubblicazione:

  1. Con un progetto selezionato in Esplora soluzioni scegliere Proprietà dal menu Progetto.

  2. Fare clic sulla scheda Pubblica .

    Annotazioni

    In ClickOnce per .NET Core 3.1 e .NET 5 o versione successiva è possibile impostare le proprietà di distribuzione usando lo strumento Pubblica anziché la pubblicazione guidata e la pagina Pubblica di Progettazione progetti. Per altre informazioni, vedere Distribuire un'applicazione Windows .NET con ClickOnce e ClickOnce per .NET.

  3. Fare clic sul pulsante Opzioni per aprire la finestra di dialogo Opzioni di pubblicazione .

  4. Fare clic su Descrizione.

  5. Nella finestra di dialogo Opzioni di pubblicazione selezionare una lingua e impostazioni cultura dall'elenco a discesa Pubblica lingua e quindi fare clic su OK.

Specificare un nome di menu Start per un'applicazione ClickOnce

Quando un'applicazione ClickOnce viene installata sia per l'uso online che offline, viene aggiunta una voce al menu Start e all'elenco Installazione applicazioni . Per impostazione predefinita, il nome visualizzato corrisponde al nome dell'assembly dell'applicazione, ma è possibile modificare il nome visualizzato impostando Nome prodotto nella finestra di dialogo Opzioni di pubblicazione .

Il nome del prodotto verrà visualizzato nella pagina publish.htm ; per un'applicazione offline installata, sarà il nome della voce nel menu Start e sarà anche il nome visualizzato in Installazione applicazioni.

Il nome dell'editore verrà visualizzato nella pagina publish.htm sopra Nome prodotto e, per un'applicazione offline installata, sarà anche il nome della cartella che contiene l'icona dell'applicazione nel menu Start .

Il collegamento al menu Start o il riferimento all'app viene creato in %appdata%\Microsoft\Windows\Start Menu\Programmi\<nome dell'editore>. Il collegamento o il riferimento all'app ha lo stesso nome del prodotto.

È possibile impostare le proprietà Nome prodotto e Nome editore nella finestra di dialogo Opzioni di pubblicazione, disponibile nella pagina Pubblica di Progettazione progetti.

Per specificare un nome di menu Start:

  1. Con un progetto selezionato in Esplora soluzioni scegliere Proprietà dal menu Progetto.

  2. Fare clic sulla scheda Pubblica .

  3. Fare clic sul pulsante Opzioni per aprire la finestra di dialogo Opzioni di pubblicazione .

  4. Fare clic su Descrizione.

  5. Nella finestra di dialogo Opzioni di pubblicazione immettere il nome da visualizzare in Nome prodotto.

  6. Facoltativamente, è possibile immettere un nome dell'autore nel nome del server di pubblicazione.

Abilitare l'avvio automatico per le installazioni cd

Quando si distribuisce un'applicazione ClickOnce tramite supporti rimovibili, ad esempio CD-ROM o DVD-ROM, è possibile abilitare AutoStart in modo che l'applicazione ClickOnce venga avviata automaticamente quando viene inserito il supporto.

AutoStart può essere abilitato nella pagina Pubblica di Progettazione progetti.

Per abilitare l'avvio automatico:

  1. Con un progetto selezionato in Esplora soluzioni, scegliere Proprietà dal menu Progetto.

  2. Fare clic sulla scheda Pubblica .

  3. Fare clic sul pulsante Opzioni .

    Verrà visualizzata la finestra di dialogo Opzioni di pubblicazione.

  4. Fare clic su Distribuzione.

  5. Selezionare la casella di controllo Per le installazioni cd, avviare automaticamente il programma di installazione quando viene inserito CD .

    Un file Autorun.inf verrà copiato nel percorso di pubblicazione quando l'applicazione viene pubblicata.

Contenuti correlati