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.

Nota

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 percorso di pubblicazione

Quando si pubblica un'applicazione tramite ClickOnce, la proprietà Publish Location specifica il percorso in cui vengono inseriti i file dell'applicazione e il manifesto. Può trattarsi di un percorso di file o del percorso di un server FTP.

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

Nota

Quando si usa ClickOnce per installare più versioni di un'applicazione, l'installazione sposta le versioni precedenti dell'applicazione in una cartella denominata Archivio nel percorso di pubblicazione specificato. L'archiviazione delle versioni precedenti consente di mantenere pulita la directory di installazione.

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

  2. Fare clic sulla scheda Pubblica.

  3. Nel campo Percorso 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 Posizione di pubblicazione perché il pulsante Sfoglia (...) funzioni.

Specificare il percorso da cui gli utenti finali eseguiranno l'installazione

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.

Nota

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 usando il formato o un percorso UNC usando il formato https://www.contoso.com/ApplicationName\Server\ApplicationName.

Specificare la modalità di installazione online o offline di ClickOnce

Per Install Mode 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 alla finestra di dialogo Installazione applicazioni ; l'utente è in grado di eseguire l'applicazione quando non sono connessi.

Può Install Mode essere impostato nella pagina Pubblica di Progettazione progetti.

Nota

L'oggetto Install Mode può essere impostato anche tramite la pubblicazione guidata. 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 in Pannello di controllo.

Impostare la versione pubblicazione per un'applicazione 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.

Nota

È 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 altre informazioni, vedere Incrementa automaticamente la 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 Pubblica versione incrementare i numeri di versione principale, secondaria, build o revisione .

    Nota

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

Incrementare automaticamente il numero di versione pubblicazione dell'applicazione ClickOnce

Quando si pubblica un'applicazione ClickOnce, la modifica della proprietà determina la Publish Version pubblicazione dell'applicazione come aggiornamento. Per impostazione predefinita, Visual Studio incrementa automaticamente il Revision numero di Publish Version ogni volta che si pubblica l'applicazione.

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

Nota

È possibile che le finestre di dialogo e i comandi di menu visualizzati varino da quelli descritti nella Guida a seconda delle impostazioni attive o dell'edizione del programma. 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, la successiva pubblicazione verrà copiata nel percorso di pubblicazione; non verrà sovrascritto 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 pagina Web 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.

Nota

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 Web Publish.htm viene pubblicata solo se viene rilevata una versione più recente.

Nota

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 in 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. Facoltativo. 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ò testare per diversi prerequisiti che devono essere disponibili nel computer 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.exe e 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.

Nota

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 prerequisito per un assembly che deve essere preinstallato nella Global Assembly Cache, impostare per l'elemento supportUrl che specifica l'assembly dependentAssembly necessario:

      <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. Facoltativo. 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.

Cambiare la lingua di pubblicazione di un'applicazione ClickOnce

Quando si pubblica un'applicazione ClickOnce, l'interfaccia utente visualizzata durante l'installazione usa per impostazione predefinita il linguaggio e le impostazioni 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 Publish language proprietà per il progetto.

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

Nota

È possibile che le finestre di dialogo e i comandi di menu visualizzati varino da quelli descritti nella Guida a seconda delle impostazioni attive o dell'edizione del programma. 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.

    Nota

    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 il nome di un'applicazione ClickOnce per il menu Start

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 menu Start riferimento all'app viene creato in %appdata%\Microsoft\Windows\Start Menu\Programmi\<nome> 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 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.

Attivare l'avvio automatico per le installazioni da 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.