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à di base, ad esempio il percorso di pubblicazione, l'URL di installazione, la modalità di installazione online o offline e la versione di pubblicazione.

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.

    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. 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 accedono a 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.

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

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

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

    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. Nella sezione Pubblica versione deselezionare la casella di controllo Incrementa automaticamente la revisione con ogni versione.