Udostępnij przez

OnLaunch

Ten element oznacza, że usługa wdrażania sprawdzi aktualizację pliku Instalatora aplikacji po uruchomieniu aplikacji.

Hierarchia elementów

> <AppInstaller
<UpdateSettings>
> onlaunch<

Składnia

<OnLaunch s4:HoursBetweenUpdateChecks? = String with numeric values between 0 and 255 inclusive.
    s4:ShowPrompt? = Boolean
    s4:UpdateBlocksActivation? = Boolean />

Klucz

? opcjonalne (zero lub jeden)

Atrybuty i elementy

Atrybuty

Atrybut Opis Typ danych Wymagane
s4:HoursBetweenUpdateChecks HoursBetweenUpdateChecks określa częstotliwość, z jaką usługa wdrażania sprawdzi aktualizację pliku Instalatora aplikacji. Gdy parametr HoursBetweenUpdateChecks ma wartość 0, usługa wdrażania będzie sprawdzać dostępność aktualizacji za każdym razem, gdy aplikacja zostanie uruchomiona. W przypadku innych wartości usługa wdrażania sprawdzi dostępność aktualizacji, gdy aplikacja jest uruchamiana tylko wtedy, gdy nie została wcześniej sprawdzona w ciągu ostatnich godzin określonych przez HoursBetweenUpdateChecks. Jeśli na przykład właściwość HoursBetweenUpdateChecks jest ustawiona na 12, usługa wdrożeń sprawdzi dostępność aktualizacji, gdy aplikacja zostanie uruchomiona tylko wtedy, gdy nie została jeszcze sprawdzona pod kątem aktualizacji w ciągu ostatnich 12 godzin. Wartości liczbowe z zakresu od 0 do 255 włącznie. Wartość domyślna to 24. Nie
s4:ShowPrompt Wskazuje, czy wdrożenie wyświetli monit, informując użytkownika o aktualizacji. Aby uzyskać więcej informacji na temat zachowania tego atrybutu, zobacz uwagi. Dostępne w systemie Windows 10 w wersji 1903 lub nowszej. Boolowski Nie
s4:UpdateBlocksActivation Należy używać tylko wtedy, gdy ShowPrompt="true". Wskazuje, czy wdrożenie uniemożliwi użytkownikowi uruchomienie aplikacji do momentu zastosowania aktualizacji. "UpdateBlocksActivation" = true oznacza, że interfejs użytkownika, który użytkownik zobaczy, umożliwia użytkownikowi podjęcie aktualizacji lub zamknięcie aplikacji. "UpdateBlocksActivation" = false oznacza, że interfejs użytkownika, który użytkownik zobaczy, umożliwia użytkownikowi podjęcie aktualizacji lub uruchomienie aplikacji bez aktualizowania. W tym drugim przypadku aktualizacja zostanie zastosowana dyskretnie w odpowiednim czasie. Aby uzyskać więcej informacji na temat zachowania tego atrybutu, zobacz uwagi. Dostępne w systemie Windows 10 w wersji 1903 lub nowszej. Boolowski Nie

Elementy nadrzędne

Elementy nadrzędne Opis
UpdateSettings Opcjonalny element pliku appinstaller. UpdateSettings oznacza, czy należy sprawdzić dostępność aktualizacji podczas uruchamiania aplikacji.

Uwagi

Ustawienie atrybutu ShowPrompt="true" pokazuje obecnie monit o aplikacje platformy UWP, ale nie dla aplikacji klasycznych, które zostały spakowane w pakiecie aplikacji systemu Windows (czyli aplikacji klasycznych korzystających z mostka klasycznego). W przypadku aplikacji klasycznych ta funkcja zapewnia dyskretną aktualizację; ta sama funkcja domyślna zapewniana przez element OnLaunch.

Atrybuty ShowPrompt i UpdateBlocksActivation działają tylko wtedy, gdy użytkownik uruchamia aplikację z elementu menu, kafelek w menu Start, alias aplikacji lub program obsługi protokołu. Te atrybuty nie mają wpływu, jeśli użytkownik uruchamia aplikację ze skrótu pulpitu lub z paska zadań.

Przykłady

W tym przykładzie wdrożenie będzie sprawdzać dostępność aktualizacji za każdym razem, gdy aplikacja zostanie uruchomiona. Jeśli aktualizacje zostaną znalezione, wdrożenie wyświetli monit informujący użytkownika, że musi podjąć aktualizację przed uruchomieniem aplikacji. Można również zwiększać lub dekrementować wersję aplikacji.

<UpdateSettings> 
    <OnLaunch s4:HoursBetweenUpdateChecks="0" s4:ShowPrompt="true" s4:UpdateBlocksActivation="true"/>
    <s4:ForceUpdateFromAnyVersion>true</s4:ForceUpdateFromAnyVersion>
</UpdateSettings>

Wymagania

Wymaganie Opis
xmlns=http://schemas.microsoft.com/appx/appinstaller/2017 Ta przestrzeń nazw jest wymagana w przypadku funkcji wprowadzonych w systemie Windows 10 w wersji 1709.
xmlns:s4=http://schemas.microsoft.com/appx/appinstaller/2021 Ta przestrzeń nazw jest wymagana w przypadku funkcji wprowadzonych w systemie Windows w wersji 21H2 kompilacji 22000
Minimalna wersja systemu operacyjnego Windows 10, wersja 1709
  • Last updated on