s4:OnLaunch

아티클
05/07/2024

Description

배포 서비스가 앱 시작 시 앱 설치 관리자 파일에 대한 업데이트를 검사 여부를 지정합니다. (s4:OnLaunch)

요소 계층 구조

<s4:OnLaunch>

Syntax

<s4:OnLaunch     ShowPrompt? = Boolean.
    UpdateBlocksActivation? = Boolean.
    HoursBetweenUpdateChecks? = Unsigned byte.
></s4:OnLaunch>

키

? 선택 사항(0개 또는 1개)

특성

attribute	Description	데이터 형식	필수
ShowPrompt	배포에서 사용자에게 업데이트에 대해 알리는 프롬프트를 표시할지를 나타냅니다. 이 특성의 동작에 대한 자세한 내용은 설명을 참조하세요. Windows 10 버전 1903 이상에서 사용할 수 있습니다.	Boolean입니다.	No
UpdateBlocksActivation	ShowPrompt="true"인 경우에만 사용해야 합니다. 업데이트가 적용될 때까지 배포에서 사용자가 애플리케이션을 시작하지 못하게 하는지를 나타냅니다. "UpdateBlocksActivation" = true는 사용자가 볼 수 있는 UI가 사용자가 업데이트를 수행하거나 앱을 닫을 수 있도록 허용한다는 것을 의미합니다. "UpdateBlocksActivation" = false는 사용자에게 표시되는 UI를 통해 사용자가 업데이트를 수행하거나 업데이트하지 않고 앱을 시작할 수 있도록 허용한다는 것을 의미합니다. 후자의 경우 업데이트가 적절한 시간에 자동으로 적용됩니다. 이 특성의 동작에 대한 자세한 내용은 설명을 참조하세요. Windows 10 버전 1903 이상에서 사용할 수 있습니다.	Boolean입니다.	No
HoursBetweenUpdateChecks	배포 서비스가 앱 설치 관리자 파일에 대한 업데이트를 위해 검사 빈도를 지정합니다. HoursBetweenUpdateChecks가 0으로 설정되면 배포 서비스는 애플리케이션이 시작될 때마다 업데이트를 검사. 다른 값의 경우 배포 서비스는 HoursBetweenUpdateChecks에서 지정한 마지막 시간 내에 이전에 확인하지 않은 경우에만 애플리케이션이 시작될 때 업데이트를 검사. 예를 들어 HoursBetweenUpdateChecks가 12로 설정된 경우 이전 12시간 동안 업데이트를 아직 확인하지 않은 경우에만 애플리케이션이 시작될 때 배포 서비스에서 업데이트를 검사.	0에서 255 사이의 숫자 값입니다. 기본값은 24입니다.	No

부모 요소

부모 요소	Description
s4:UpdateSettings	앱 업데이트와 관련된 설정을 지정합니다.

설명

ShowPrompt="true" 특성을 설정하면 현재 UWP 애플리케이션에 대한 프롬프트가 표시되지만 Windows 앱 패키지에 패키지된 데스크톱 애플리케이션(즉, 데스크톱 브리지 사용하는 데스크톱 애플리케이션)에 대한 프롬프트는 표시되지 않습니다. 데스크톱 애플리케이션의 경우 이 기능은 자동 업데이트를 제공합니다. OnLaunch 요소에서 제공하는 것과 동일한 기본 기능입니다.

및 UpdateBlocksActivation 특성은 ShowPrompt 사용자가 시작 메뉴의 메뉴 항목 또는 타일에서 앱을 시작하는 경우에만 적용됩니다. 사용자가 바탕 화면 바로 가기 또는 작업 표시줄에서 앱을 시작하는 경우에는 이러한 특성이 적용되지 않습니다.

예제

이 예제에서는 앱이 시작될 때마다 업데이트에 대한 배포가 검사. 업데이트가 발견되면 배포에서 사용자에게 앱을 시작하기 전에 업데이트를 수행해야 한다는 메시지를 표시합니다. 앱 버전도 증가하거나 감소할 수 있습니다.

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

요구 사항

요구 사항	값
`xmlns:s4=http://schemas.microsoft.com/appx/appinstaller/2021`	이 네임스페이스는 Windows 버전 21H2 빌드 22000에 도입된 기능에 필요합니다.
최소 OS 버전	Windows 버전 21H2 빌드 22000

다음을 통해 공유