기본 앱 설정 페이지 시작

ms-settings URI 체계를 사용하여 앱에서 기본 앱 설정 페이지를 표시하기 위해 Windows 설정 앱을 시작하는 방법을 알아봅니다.

Windows는 앱이 Windows 설정 앱을 시작하고 특정 설정 페이지를 표시할 수 있도록 하는 URI 집합을 정의합니다. 이 문서에서는 Windows 설정 앱을 기본 앱 설정 페이지로 직접 시작하고 필요에 따라 지정된 기본 애플리케이션의 설정으로 직접 이동하는 방법을 설명합니다. 자세한 내용은 Windows 설정 앱 실행하기를 참조하세요.

기본 앱 설정 URL

ms-settings:defaultapps Windows 설정 앱을 시작하고 기본 앱 설정 페이지로 이동합니다. Windows 11 버전 21H2(2023-04 누적 업데이트 포함), 22H2(2023-04 누적 업데이트 포함) 및 23H2 이상부터 이스케이프된 URI 형식의 추가 쿼리 문자열 매개 변수를 추가하여 특정 애플리케이션의 설정 페이지에 직접 시작할 수 있습니다.

세 개의 쿼리 문자열 매개 변수가 있습니다. 사용할 쿼리 문자열 매개 변수는 애플리케이션이 설치된 방법에 따라 달라집니다.

쿼리 문자열 매개 변수	전달할 값
등록된앱사용자	HKEY_CURRENT_USER\Software\RegisteredApplications에서 가져온 명명된 값 앱이 사용자별로 설치되고, 앱 등록이 HKEY_CURRENT_USER\Software\RegisteredApplications에 기록된 경우 사용합니다.
등록된앱기계	HKEY_LOCAL_MACHINE\Software\RegisteredApplications에서 명명된 값 컴퓨터별로 앱이 설치되고 앱 등록이 HKEY_LOCAL_MACHINE\Software\RegisteredApplications기록되었을 때 사용합니다.
등록된AUMID	애플리케이션 사용자 모델 ID 앱이 파일 형식(uap:FileTypeAssociation) 또는 URI 스키마(uap:Protocol)를 처리한다고 선언하는 매니페스트를 사용하여 패키지 관리자에 앱을 등록한 경우에 사용합니다.

메모

OS 업그레이드 후 registeredAUMID 쿼리 문자열 매개 변수가 작동하도록 하려면 앱에서 해당 매니페스트의 TargetDeviceFamily...MaxVersionTested 값을 증가시킬 필요가 있을 수 있습니다. 이렇게 하면 앱이 사용자에 대해 다시 인덱싱됩니다. 그러면 프로토콜 활성화를 통해 딥 링크를 처리하는 데 사용되는 적절한 정의가 업데이트됩니다. MaxVersionTested는 Windows 11, 버전 21H2의 경우 10.0.22000.1817으로, 버전 22H2의 경우 10.0.22621.1555으로 업데이트해야 합니다.

다음 예제에서는 windows 설정 앱을 시작하기 위해 LaunchUriAsync 호출됩니다. ms-settings:defaultapps Uri는 기본 앱 설정 페이지가 표시되도록 지정합니다. 다음으로, 시작해야 하는 앱이 결정됩니다. 예를 들어 HKEY_LOCAL_MACHINE\Software\RegisteredApplications앱에서 "Microsoft Edge"를 등록했습니다. 컴퓨터별로 설치된 앱이므로 registeredAppMachine 사용해야 하는 쿼리 문자열 매개 변수입니다. 선택적 쿼리 문자열 매개변수 registeredAppMachine는 등록된 이름으로 설정되며, Url.EscapeDataString호출을 통해 이스케이프되어 Microsoft Edge 페이지가 표시되도록 지정합니다.

private async void LaunchSettingsPage_Click(object sender, RoutedEventArgs e)
{
    bool result = await Windows.System.Launcher.LaunchUriAsync(new Uri("ms-settings:defaultapps?registeredAppMachine=" + Uri.EscapeDataString("Microsoft Edge")));
}

bool result = co_await Windows::System::Launcher::LaunchUriAsync(Windows::Foundation::Uri(L"ms-settings:defaultapps?registeredAppMachine=" + Uri::EscapeDataString(L"Microsoft Edge")));

관련 콘텐츠

Windows 설정 앱 시작

URI 대한 기본 앱을 시작합니다.