Gestire gli aggiornamenti per un'applicazione ClickOnce

  • Articolo

Le applicazioni ClickOnce possono verificare la disponibilità di aggiornamenti automaticamente o a livello di codice. Gli sviluppatori hanno una grande flessibilità per specificare quando e come vengono eseguiti i controlli degli aggiornamenti, se gli aggiornamenti sono obbligatori e dove l'applicazione deve verificare la disponibilità di aggiornamenti.

È possibile configurare l'applicazione per verificare la disponibilità di aggiornamenti automaticamente prima dell'avvio dell'applicazione o a intervalli impostati dopo l'avvio dell'applicazione. Inoltre, è possibile specificare una versione minima richiesta; ovvero, un aggiornamento viene installato se la versione dell'utente è inferiore alla versione richiesta.

È possibile configurare l'applicazione per verificare la disponibilità di aggiornamenti a livello di codice in base a un evento, ad esempio una richiesta utente. La procedura "Per verificare la disponibilità di aggiornamenti a livello di codice" in questo argomento illustra come scrivere codice che usa la ApplicationDeployment classe per verificare la disponibilità di aggiornamenti in base a un evento.

Nota

La ApplicationDeployment classe e le API nello System.Deployment.Application spazio dei nomi non sono supportate in .NET Core e .NET 5 e versioni successive. In .NET 7 è supportato un nuovo metodo di accesso alle proprietà di distribuzione dell'applicazione. Per altre informazioni, vedere Accedere alle proprietà di distribuzione ClickOnce in .NET. .NET 7 non supporta l'equivalente dei metodi ApplicationDeployment.

È anche possibile distribuire l'applicazione da un percorso e aggiornarla da un'altra. Vedere la procedura "Per specificare un percorso di aggiornamento diverso".

Per altre informazioni, vedere Scelta di una strategia di aggiornamento ClickOnce.

Il comportamento di aggiornamento viene gestito nella finestra di dialogo Application Aggiornamenti disponibile nella pagina Pubblica di Progettazione progetti.

Per verificare la disponibilità di aggiornamenti prima dell'avvio dell'applicazione

  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 Aggiornamenti per aprire la finestra di dialogo Aggiornamenti applicazione.

  4. Nella finestra di dialogo Applicazione Aggiornamenti verificare che sia selezionata la casella di controllo L'applicazione deve controllare la disponibilità di aggiornamenti.

  5. Nella sezione Scegliere quando l'applicazione deve verificare la disponibilità di aggiornamenti selezionare Prima dell'avvio dell'applicazione. Ciò garantisce che gli utenti connessi alla rete eseguano sempre l'applicazione con gli aggiornamenti più recenti.

Per cercare gli aggiornamenti in background dopo l'avvio dell'applicazione

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

  2. Fare clic sulla scheda Pubblica.

  3. Fare clic sul pulsante Aggiornamenti per aprire la finestra di dialogo Aggiornamenti applicazione.

  4. Nella finestra di dialogo Applicazione Aggiornamenti verificare che sia selezionata la casella di controllo L'applicazione deve controllare la disponibilità di aggiornamenti.

  5. Nella sezione Scegliere quando l'applicazione deve verificare la disponibilità di aggiornamenti selezionare Dopo l'avvio dell'applicazione. L'applicazione inizierà più rapidamente in questo modo e quindi verificherà la disponibilità degli aggiornamenti in background e informerà l'utente solo quando è disponibile un aggiornamento. Dopo l'installazione, gli aggiornamenti non avranno effetto fino al riavvio dell'applicazione.

  6. Nella sezione Specificare la frequenza con cui l'applicazione deve controllare la disponibilità di aggiornamenti selezionare Controlla ogni volta che l'applicazione viene eseguita (impostazione predefinita) o Controlla ogni e immettere un numero e un intervallo di tempo.

Nota

In ClickOnce per .NET Core e .NET 5 o versione successiva questa attività non è supportata. Per altre informazioni, vedere ClickOnce per .NET.

Per specificare una versione minima richiesta per l'applicazione

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

  2. Fare clic sulla scheda Pubblica.

  3. Fare clic sul pulsante Aggiornamenti per aprire la finestra di dialogo Aggiornamenti applicazione.

  4. Nella finestra di dialogo Applicazione Aggiornamenti verificare che sia selezionata la casella di controllo L'applicazione deve controllare la disponibilità di aggiornamenti.

  5. Selezionare la casella di controllo Specificare una versione minima richiesta per questa applicazione e quindi immettere i numeri principale, secondario, compilazione e revisione per l'applicazione.

Per specificare un percorso di aggiornamento diverso

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

  2. Fare clic sulla scheda Pubblica.

  3. Fare clic sul pulsante Aggiornamenti per aprire la finestra di dialogo Aggiornamenti applicazione.

  4. Nella finestra di dialogo Applicazione Aggiornamenti verificare che sia selezionata la casella di controllo L'applicazione deve controllare la disponibilità di aggiornamenti.

  5. Nel campo Percorso di aggiornamento immettere il percorso di aggiornamento con un URL completo, usando il formato http://Hostname/ApplicationNameo un percorso UNC usando il formato \\Server\ApplicationName oppure fare clic sul pulsante Sfoglia per cercare il percorso di aggiornamento.

Per verificare la disponibilità di aggiornamenti a livello di codice

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

  2. Fare clic sulla scheda Pubblica.

  3. Fare clic sul pulsante Aggiornamenti per aprire la finestra di dialogo Aggiornamenti applicazione.

  4. Nella finestra di dialogo Applicazione Aggiornamenti verificare che la casella di controllo L'applicazione deve controllare la disponibilità di aggiornamenti sia deselezionata. Facoltativamente, è possibile selezionare questa casella di controllo per verificare la disponibilità di aggiornamenti a livello di codice e consentire al runtime ClickOnce di controllare automaticamente la disponibilità di aggiornamenti.

  5. Nel campo Percorso di aggiornamento immettere il percorso di aggiornamento con un URL completo, usando il formato http://Hostname/ApplicationNameo un percorso UNC usando il formato \\Server\ApplicationName oppure fare clic sul pulsante Sfoglia per cercare il percorso di aggiornamento. Il percorso di aggiornamento è il punto in cui l'applicazione cercherà una versione aggiornata di se stessa.

  6. Crea un pulsante, una voce di menu o un'altra voce dell'interfaccia utente in un Windows Form che gli utenti selezioneranno per verificare la disponibilità di aggiornamenti. Dal gestore eventi dell'elemento chiamare un metodo per verificare e installare gli aggiornamenti. È possibile trovare un esempio di codice Visual Basic e Visual C# per un metodo di questo tipo in Procedura: Verificare la disponibilità di aggiornamenti delle applicazioni a livello di codice usando l'API di distribuzione ClickOnce.

  7. Compilare l'applicazione.

Contenuto correlato