Udostępnij za pośrednictwem


Zarządzanie aktualizacjami dla aplikacji ClickOnce

Aplikacje ClickOnce mogą automatycznie lub programowo sprawdzać dostępność aktualizacji. Jako deweloper masz dużą elastyczność w określaniu, kiedy i w jaki sposób są wykonywane testy aktualizacji, czy aktualizacje są obowiązkowe, i gdzie aplikacja powinna sprawdzać dostępność aktualizacji.

Aplikację można skonfigurować pod kątem automatycznego sprawdzania dostępności aktualizacji przed uruchomieniem aplikacji lub w określonych odstępach czasu po uruchomieniu aplikacji. Ponadto można określić minimalną wymaganą wersję; oznacza to, że aktualizacja jest instalowana, jeśli wersja użytkownika jest niższa niż wymagana wersja.

Aplikację można skonfigurować tak, aby programowo sprawdzać dostępność aktualizacji na podstawie zdarzenia takiego jak żądanie użytkownika. Procedura "Aby programowo sprawdzić dostępność aktualizacji" w tym temacie pokazuje, jak napisać kod, który używa ApplicationDeployment klasy do sprawdzania dostępności aktualizacji na podstawie zdarzenia.

Uwaga

Klasy ApplicationDeployment i interfejsy API w System.Deployment.Application przestrzeni nazw nie są obsługiwane w wersjach .NET Core i .NET 5 i nowszych. W programie .NET 7 jest obsługiwana nowa metoda uzyskiwania dostępu do właściwości wdrażania aplikacji. Aby uzyskać więcej informacji, zobacz Access ClickOnce deployment properties in .NET (Uzyskiwanie dostępu do właściwości wdrożenia ClickOnce na platformie .NET). Platforma .NET 7 nie obsługuje odpowiedników metod ApplicationDeployment.

Możesz również wdrożyć aplikację z jednej lokalizacji i zaktualizować ją z innej. Zobacz procedurę "Aby określić inną lokalizację aktualizacji".

Aby uzyskać więcej informacji, zobacz Wybieranie strategii aktualizacji ClickOnce.

Zachowanie aktualizacji jest zarządzane w oknie dialogowym Aktualizacje aplikacji dostępne na stronie Publikowanie Projektant projektu.

Aby sprawdzić dostępność aktualizacji przed uruchomieniem aplikacji

  1. Po wybraniu projektu w Eksplorator rozwiązań w menu Projekt kliknij pozycję Właściwości.

  2. Kliknij kartę Publikuj .

    Uwaga

    W technologii ClickOnce dla platformy .NET Core 3.1 i .NET 5 lub nowszej można ustawić właściwości wdrożenia przy użyciu narzędzia Publikuj zamiast kreatora Publikowanie i strony Publikowanie w programie Project Projektant. Aby uzyskać więcej informacji, zobacz Deploy a .NET Windows application using ClickOnce and ClickOnce for .NET (Wdrażanie aplikacji .NET przy użyciu technologii ClickOnce i ClickOnce dla platformy .NET).

  3. Kliknij przycisk Aktualizacje, aby otworzyć okno dialogowe Aktualizacje aplikacji.

  4. W oknie dialogowym Aplikacja Aktualizacje upewnij się, że zaznaczono pole wyboru Aplikacja powinna sprawdzać dostępność aktualizacji.

  5. W sekcji Wybierz, kiedy aplikacja powinna sprawdzić dostępność aktualizacji , wybierz pozycję Przed uruchomieniem aplikacji. Dzięki temu użytkownicy połączeni z siecią zawsze uruchamiają aplikację z najnowszymi aktualizacjami.

Aby sprawdzić dostępność aktualizacji w tle po uruchomieniu aplikacji

  1. Po wybraniu projektu w Eksplorator rozwiązań w menu Projekt kliknij pozycję Właściwości.

  2. Kliknij kartę Publikuj .

  3. Kliknij przycisk Aktualizacje, aby otworzyć okno dialogowe Aktualizacje aplikacji.

  4. W oknie dialogowym Aplikacja Aktualizacje upewnij się, że zaznaczono pole wyboru Aplikacja powinna sprawdzać dostępność aktualizacji.

  5. W sekcji Wybierz, kiedy aplikacja powinna sprawdzić dostępność aktualizacji, wybierz pozycję Po uruchomieniu aplikacji. Aplikacja zacznie się szybciej w ten sposób, a następnie będzie sprawdzać dostępność aktualizacji w tle i powiadamiać użytkownika tylko o dostępności aktualizacji. Po zainstalowaniu aktualizacje nie zostaną zastosowane do momentu ponownego uruchomienia aplikacji.

  6. W sekcji Określ częstotliwość sprawdzania dostępności aktualizacji przez aplikację wybierz pozycję Sprawdź za każdym razem, gdy aplikacja jest uruchamiana (wartość domyślna) lub Sprawdź co i wprowadź liczbę i interwał czasu.

Uwaga

W technologii ClickOnce dla platform .NET Core i .NET 5 lub nowszych to zadanie nie jest obsługiwane. Aby uzyskać więcej informacji, zobacz ClickOnce dla platformy .NET.

Aby określić minimalną wymaganą wersję aplikacji

  1. Po wybraniu projektu w Eksplorator rozwiązań w menu Projekt kliknij pozycję Właściwości.

  2. Kliknij kartę Publikuj .

  3. Kliknij przycisk Aktualizacje, aby otworzyć okno dialogowe Aktualizacje aplikacji.

  4. W oknie dialogowym Aplikacja Aktualizacje upewnij się, że zaznaczono pole wyboru Aplikacja powinna sprawdzać dostępność aktualizacji.

  5. Zaznacz pole wyboru Określ minimalną wymaganą wersję dla tej aplikacji, a następnie wprowadź numery wersji głównej, pomocniczej, kompilacji i poprawek dla aplikacji.

Aby określić inną lokalizację aktualizacji

  1. Po wybraniu projektu w Eksplorator rozwiązań w menu Projekt kliknij pozycję Właściwości.

  2. Kliknij kartę Publikuj .

  3. Kliknij przycisk Aktualizacje, aby otworzyć okno dialogowe Aktualizacje aplikacji.

  4. W oknie dialogowym Aplikacja Aktualizacje upewnij się, że zaznaczono pole wyboru Aplikacja powinna sprawdzać dostępność aktualizacji.

  5. W polu Aktualizuj lokalizację wprowadź lokalizację aktualizacji z w pełni kwalifikowanym adresem URL, używając formatu lub ścieżki UNC w formacie http://Hostname/ApplicationName\\Server\ApplicationName lub kliknij przycisk Przeglądaj, aby wyszukać lokalizację aktualizacji.

Aby programowo sprawdzić dostępność aktualizacji

  1. Po wybraniu projektu w Eksplorator rozwiązań w menu Projekt kliknij pozycję Właściwości.

  2. Kliknij kartę Publikuj .

  3. Kliknij przycisk Aktualizacje, aby otworzyć okno dialogowe Aktualizacje aplikacji.

  4. W oknie dialogowym Aplikacja Aktualizacje upewnij się, że pole wyboru Aplikacja powinna sprawdzić dostępność aktualizacji. (Opcjonalnie możesz zaznaczyć to pole wyboru, aby programowo sprawdzić dostępność aktualizacji, a także zezwolić środowisku uruchomieniowemu ClickOnce na automatyczne sprawdzanie dostępności aktualizacji).

  5. W polu Aktualizuj lokalizację wprowadź lokalizację aktualizacji z w pełni kwalifikowanym adresem URL, używając formatu lub ścieżki UNC w formacie http://Hostname/ApplicationName\\Server\ApplicationName lub kliknij przycisk Przeglądaj, aby wyszukać lokalizację aktualizacji. Lokalizacja aktualizacji to miejsce, w którym aplikacja będzie szukać zaktualizowanej wersji.

  6. Utwórz przycisk, element menu lub inny element interfejsu użytkownika w formularzu systemu Windows, który użytkownicy będą wybierać, aby sprawdzić dostępność aktualizacji. Z programu obsługi zdarzeń tego elementu wywołaj metodę , aby sprawdzić i zainstalować aktualizacje. Przykład kodu Visual Basic i Visual C# dla takiej metody można znaleźć w temacie Instrukcje: programowe sprawdzanie aktualizacji aplikacji przy użyciu interfejsu API wdrażania ClickOnce.

  7. Skompiluj aplikację.