다음을 통해 공유

UWP API 및 라이브러리를 Windows App SDK에 매핑

  • 아티클

이 항목에서는 UWP API를 해당 Windows App SDK에 매핑합니다. 경우에 따라 매핑이 일대일이 아닌 경우도 있습니다. 두 플랫폼 모두 네임스페이스 또는 클래스의 기능이 다른 플랫폼보다 많거나 적을 수 있습니다.

두 플랫폼 사이의 네임스페이스와 클래스의 이름(UI 컨트롤 포함)이 다릅니다. 대부분의 경우, 네임스페이스 이름을 간단히 변경하면 코드가 컴파일됩니다. 네임스페이스 이름과 함께 클래스 또는 API 이름이 변경된 경우도 있습니다. 매핑이 더 복잡하므로 접근 방법을 변경해야 하는 경우도 있습니다.

표 사용 방법. 먼저 사용하는 클래스 멤버의 이름을 검색합니다. 단순한 클래스 이름 또는 네임스페이스 이름 변경보다 매핑이 더 복잡할 때마다 멤버가 나열됩니다. 멤버가 나열되지 않으면 사용하는 클래스의 이름을 검색합니다. 매핑이 네임스페이스 이름을 변경하는 것보다 더 복잡할 경우 클래스가 나열됩니다(자세한 참고 자료는 기능 영역 가이드 참조). 클래스가 나열되지 않는 경우 매핑 시 네임스페이스만 변경하면 됩니다. 따라서 클래스의 네임스페이스 이름을 찾은 다음, 해당하는 Windows App SDK 네임스페이스 이름을 찾습니다. 해당 네임스페이스에 클래스가 있습니다. 네임스페이스가 나열되지 않는 경우 이름이 변경되지 않은 것입니다.

UWP Windows 앱 SDK
(Windows.ApplicationModel.Activation) LaunchActivatedEventArgs 클래스 (Microsoft.UI.Xaml) LaunchActivatedEventArgs 클래스(예: App.OnLaunched).
(Windows.ApplicationModel.Core) CoreApplication.CreateNewView 메서드 (Microsoft.UI.Windowing) AppWindow.Create 메서드
(Windows.ApplicationModel.Core) CoreApplicationViewTitleBar 클래스 (Microsoft.UI.Windowing) AppWindowTitleBar 클래스
(Windows.ApplicationModel.Core) CoreApplicationViewTitleBar.ExtendViewIntoTitleBar 속성 (Microsoft.UI.Windowing) AppWindowTitleBar.ExtendsContentIntoTitleBar 속성. 플랫폼은 계속해서 최소화/최대화/닫기 단추를 표시하고 폐색 정보를 보고합니다.
(Windows.ApplicationModel.Core) CoreApplicationViewTitleBar.Height 속성 (Microsoft.UI.Windowing) AppWindowTitleBar.Height 속성
(Windows.ApplicationModel.Core) CoreApplicationViewTitleBar.SystemOverlayLeftInset 속성 (Microsoft.UI.Windowing) AppWindowTitleBar.LeftInset 속성
(Windows.ApplicationModel.Core) CoreApplicationViewTitleBar.SystemOverlayRightInset 속성 (Microsoft.UI.Windowing) AppWindowTitleBar.RightInset 속성
Windows.ApplicationModel.Resources.Core 네임스페이스 Microsoft.Windows.ApplicationModel.Resources. MRT에서 MRT Core로 마이그레이션을 참조하세요.
(Windows.ApplicationModel.Resources.Core) ResourceContext.GetForCurrentView 메서드 (Microsoft.Windows.ApplicationModel.Resources) ResourceManager.CreateResourceContext 메서드. ResourceContext.GetForCurrentView 및 ResourceContext.GetForViewIndependentUse를 참조하세요.
(Windows.ApplicationModel.Resources.Core) ResourceContext.GetForViewIndependentUse 메서드 (Microsoft.Windows.ApplicationModel.Resources) ResourceManager.CreateResourceContext 메서드. ResourceContext.GetForCurrentView 및 ResourceContext.GetForViewIndependentUse를 참조하세요.
(Windows.ApplicationModel.Resources.Core) ResourceManager.Current 속성 새 (Microsoft.Windows.ApplicationModel.Resources) ResourceManager 개체를 만듭니다. ResourceManager 클래스를 참조하세요.
(Windows.ApplicationModel.Resources.Core) ResourceQualifierObservableMap.MapChanged 이벤트 환경 변경 내용을 직접 검색합니다. 리소스 한정자 값 변경을 참조하세요.
(Windows.Graphics.Printing) PrintManager 클래스 Windows App SDK 1.0에서 지원되지 않습니다.
(Windows.Media.Capture) CameraCaptureUI 클래스 Windows App SDK 1.0에서 지원되지 않습니다.
(Windows.Security.Authentication.Web) WebAuthenticationBroker 클래스 Windows App SDK 1.0에서 지원되지 않습니다.
(Windows.Storage.Pickers) FileOpenPicker, FileSavePicker 및 FolderPicker 클래스 지원되지만 IInitializeWithWindow 인터페이스를 사용해야 합니다. MessageDialog 및 선택기를 참조하세요.
(Windows.System.Display) DisplayRequest 클래스 Windows App SDK 1.0에서 지원되지 않습니다.
Windows.UI.Composition 네임스페이스 Microsoft.UI.Composition 네임스페이스
(Windows.UI.Core) CoreDispatcher 클래스 (Microsoft.UI.Dispatching) DispatcherQueue 클래스. CoreDispatcher를 DispatcherQueue로 변경을 참조하세요.
(Windows.UI.Core) CoreDispatcher.RunAsync 메서드 (Microsoft.UI.Dispatching) DispatcherQueue.TryEnqueue 메서드. RunAsync를 TryEnqueue로 변경을 참조하세요.
(Windows.UI.Core) CoreWindow 클래스 (Microsoft.UI.Windowing) AppWindow 클래스. 기간 이동 기능 마이그레이션을 참조하세요.
(Windows.UI.Core) CoreWindow.Bounds 속성(일반적으로 C#에 CoreWindow.GetForCurrentThread.Bounds로 표시) (Microsoft.UI.Windowing) AppWindow.Size 속성
(Windows.UI.Core) CoreWindow.GetForCurrentThread 메서드 Windows 앱 SDK API에 대한 직접 1:1 매핑이 없습니다. XAML을 사용하는 경우 Window.AppWindow를 가져와서 XAML 창과 연결된 AppWindow를 가져올 수 있지만, 액세스 권한이 없는 위치에서 액세스하려면 앱이 Window 또는 AppWindow를 캐시해야 합니다. 앱 개체에서 Window를 캐싱하고 노출하는 것이 좋습니다.
(Windows.UI.Core) CoreWindow.Activate 메서드 (Microsoft.UI.Windowing) AppWindow.Show 메서드
(Windows.UI.Core) CoreWindow.Dispatcher 속성 (Microsoft.UI.Xaml) Window.DispatcherQueue 속성. CoreWindow.Dispatcher를 Window.DispatcherQueue로 변경을 참조하세요.
(Windows.UI.Core) CoreWindow.SizeChanged 이벤트 (Microsoft.UI.Windowing) AppWindowChangedEventArgs.DidSizeChange 메서드
(Windows.UI.Core) SystemNavigationManager 클래스(전역 뒤로 단추) 지원되지 않습니다. 사용자 고유의 UI 내에서 뒤로 단추를 구현합니다. UWP PhotoLab 샘플 앱(C#)의 Windows App SDK 마이그레이션을 참조하세요.
(Windows.UI.Core) WindowSizeChangedEventArgs 클래스 (Microsoft.UI.Xaml) WindowSizeChangedEventArgs 클래스(예: (Microsoft.UI.Xaml) Window.SizeChanged용 처리기).
(Windows.UI.Popups) MessageDialog 클래스 지원되지만 IInitializeWithWindow 인터페이스를 사용해야 합니다. MessageDialog 및 선택기를 참조하세요.
(Windows.UI.Text.Core) CoreTextServicesManager 클래스 Windows 11에서만 지원됩니다.
(Windows.UI.ViewManagement) ApplicationView 클래스 (Microsoft.UI.Windowing) AppWindow 클래스
(Windows.UI.ViewManagement) ApplicationView.Title 속성 (Microsoft.UI.Windowing) AppWindow.Title 속성
(Windows.UI.ViewManagement) ApplicationView.TryConsolidateAsync 메서드 (Microsoft.UI.Windowing) AppWindow.Destroy 메서드
(Windows.UI.ViewManagement) ApplicationView.TryEnterFullScreenMode 메서드 (Microsoft.UI.Windowing) AppWindow.SetPresenter 메서드(AppWindowPresenterKind.FullScreen 포함)
(Windows.UI.ViewManagement) ApplicationView.TryEnterViewModeAsync 메서드(ApplicationViewMode.CompactOverlay 포함) (Microsoft.UI.Windowing) AppWindow.SetPresenter 메서드(AppWindowPresenterKind.CompactOverlay 포함)
(Windows.UI.ViewManagement) ApplicationView.TryResizeView 메서드 (Microsoft.UI.Windowing) AppWindow.Resize 메서드
(Windows.UI.ViewManagement) ApplicationViewMode.CompactOverlay 필드 (Microsoft.UI.Windowing) AppWindowPresenterKind.CompactOverlay 필드
(Windows.UI.ViewManagement) ApplicationViewTitleBar 클래스 (Microsoft.UI.Windowing) AppWindowTitleBar 클래스
(Windows.UI.ViewManagement) ApplicationViewWindowingMode.FullScreen 필드 (Microsoft.UI.Windowing) AppWindowPresenterKind.FullScreen 필드
(Windows.UI.WindowManagement) AppWindow 클래스 (Microsoft.UI.Windowing) AppWindow 클래스
(Windows.UI.WindowManagement) AppWindow.Changed 이벤트 (Microsoft.UI.Windowing) Microsoft.UI.Windowing.AppWindow.Changed 이벤트
(Windows.UI.WindowManagement) AppWindow.CloseAsync 메서드 (Microsoft.UI.Windowing) AppWindow.Destroy 메서드
(Windows.UI.WindowManagement) AppWindow.GetPlacement 메서드 (Microsoft.UI.Windowing) AppWindow.Position 속성
(Windows.UI.WindowManagement) Appwindow.RequestMoveXxx 메서드 (Microsoft.UI.Windowing) AppWindow.Move 메서드
(Windows.UI.WindowManagement) AppWindow.RequestSize 메서드 (Microsoft.UI.Windowing) AppWindow.Resize 메서드
(Windows.UI.WindowManagement) AppWindow.Title 속성 (Microsoft.UI.Windowing) AppWindow.Title 속성
(Windows.UI.WindowManagement) AppWindow.TryCreateAsync 메서드 (Microsoft.UI.Windowing) AppWindow.Create 메서드
(Windows.UI.WindowManagement) AppWindow.TryShowAsync 메서드 (Microsoft.UI.Windowing) AppWindow.Show 메서드
(Windows.UI.WindowManagement) AppWindowChangedEventArgs.DidSizeChange 메서드 (Microsoft.UI.Windowing) AppWindowChangedEventArgs.DidSizeChange 메서드
(Windows.UI.WindowManagement) AppWindowPlacement.Size 속성 (Microsoft.UI.Windowing) AppWindow.Size 속성
(Windows.UI.WindowManagement) AppWindowPresentationKind.CompactOverlay 필드 (Microsoft.UI.Windowing) AppWindowPresenterKind.CompactOverlay 필드
(Windows.UI.WindowManagement) AppWindowPresentationKind.FullScreen 필드 (Microsoft.UI.Windowing) AppWindowPresenterKind.FullScreen 필드
(Windows.UI.WindowManagement) AppWindowPresenter.RequestPresentation 메서드 (Microsoft.UI.Windowing) AppWindow.SetPresenter 메서드
(Windows.UI.WindowManagement) AppWindowTitleBar 클래스 (Microsoft.UI.Windowing) AppWindowTitleBar 클래스
(Windows.UI.WindowManagement) AppWindowTitleBar.GetPreferredVisibility Windows App SDK API에 대한 직접적인 1:1 매핑 없음
(Windows.UI.WindowManagement) AppWindowTitleBar.GetTitleBarOcclusions (Microsoft.UI.Windowing) AppWindowTitleBar.LeftInset 및 RightInset는 Height와 결합된 경우 동일한 정보를 제공합니다.
(Windows.UI.WindowManagement) AppWindowTitleBar.SetPreferredVisibility Windows App SDK API에 대한 직접적인 1:1 매핑 없음
(Windows.UI.WindowManagement) AppWindowTitleBarOcclusion 속성 (Microsoft.UI.Windowing) AppWindowTitleBar.LeftInset 및 RightInset는 Height와 결합된 경우 동일한 정보를 제공합니다.
(Windows.UI.WindowManagement) AppWindowTitleBarVisibility Windows App SDK API에 대한 직접적인 1:1 매핑 없음
Windows.UI.Xaml 네임스페이스 Microsoft.UI.Xaml 네임스페이스
(Windows.UI.Xaml) Application.OnActivated 메서드(일반적으로 C#에서 App.OnActivated로 표시됨) OnActivated, OnBackgroundActivated 및 기타 활성화 처리 메서드를 참조하세요.
(Windows.UI.Xaml) Application.OnBackgroundActivated 메서드(일반적으로 C#에서 App.OnBackgroundActivated로 표시됨) OnActivated, OnBackgroundActivated 및 기타 활성화 처리 메서드를 참조하세요.
(Windows.UI.Xaml) Application.OnCachedFileUpdaterActivated 메서드(일반적으로 C#에서 App.OnCachedFileUpdaterActivated로 표시됨) OnActivated, OnBackgroundActivated 및 기타 활성화 처리 메서드를 참조하세요.
(Windows.UI.Xaml) Application.OnFileActivated 메서드(일반적으로 C#에서 App.OnFileActivated로 표시됨) 파일 형식 연결 및 OnActivated, OnBackgroundActivated 및 기타 활성화 처리 메서드를 참조하세요.
(Windows.UI.Xaml) Application.OnFileOpenPickerActivated 메서드(일반적으로 C#에서 App.OnFileOpenPickerActivated로 표시됨) OnActivated, OnBackgroundActivated 및 기타 활성화 처리 메서드를 참조하세요.
(Windows.UI.Xaml) Application.OnFileSavePickerActivated 메서드(일반적으로 C#에서 App.OnFileSavePickerActivated로 표시됨) OnActivated, OnBackgroundActivated 및 기타 활성화 처리 메서드를 참조하세요.
(Windows.UI.Xaml) Application.OnSearchActivated 메서드(일반적으로 C#에서 App.OnSearchActivated로 표시됨) OnActivated, OnBackgroundActivated 및 기타 활성화 처리 메서드를 참조하세요.
(Windows.UI.Xaml) Application.OnShareTargetActivated 메서드(일반적으로 C#에서 App.OnShareTargetActivated로 표시됨) OnActivated, OnBackgroundActivated 및 기타 활성화 처리 메서드를 참조하세요.
(Windows.UI.Xaml) Window.Current 속성 사용되지 않으며 null을 반환합니다. 대안은 Window.Current를 App.Window로 변경을 참조하세요.
(Windows.UI.Xaml) Window.Dispatcher 속성(일반적으로 C#에서 Window.Current.Dispatcher로 작성됨) (Microsoft.UI.Xaml) Window.DispatcherQueue 속성
(Windows.UI.Xaml.Controls) ContentDialog 클래스 (Microsoft.UI.Xaml.Controls) ContentDialog가 지원되지만 XamlRoot 속성을 설정해야 합니다. ContentDialog 및 Popup을 참조하세요.
(Windows.UI.Xaml.Controls) InkCanvas 클래스 Windows App SDK 1.0에서 지원되지 않습니다.
(Windows.UI.Xaml.Controls) MediaElement 클래스 Windows App SDK 1.0에서 지원되지 않습니다.
(Windows.UI.Xaml.Controls.Maps) MapControl 클래스 (Microsoft.UI.Xaml.Controls) MapControl 클래스
(Windows.UI.Xaml.Controls.Primitives) Popup 클래스 (Microsoft.UI.Xaml.Controls.Primitives) Popup이 지원되지만 XamlRoot 속성을 설정해야 합니다. ContentDialog 및 Popup을 참조하세요.
(Windows.UI.Xaml.Media) AcrylicBrush.BackgroundSource 속성 Windows App SDK에서 (Microsoft.UI.Xaml.Media) AcrylicBrush는 항상 앱 콘텐츠의 샘플입니다. AcrylicBrush.BackgroundSource 속성을 참조하세요.
C++/WinRT. co_await winrt.resume_foreground(this->Dispatcher()); winrt.resume_foreground 마이그레이션을 참조하세요.

제3자 라이브러리

이 섹션에서는 UWP에서 지원되고 WinUI 3을 사용할 때 변경해야 하는 다양한 라이브러리에 대해 설명합니다.

UWP Windows 앱 SDK
OneDrive SDK Microsoft Graph SDK

참고 항목