为 Mac Catalyst 应用指定 UI 成语

项目
05/14/2024

.NET 多平台应用 UI （.NET MAUI） Mac Catalyst 应用可以在 iPad 或 Mac 用户界面中运行：

iPad 用户界面风格会告诉 macOS 缩放应用的用户界面，以匹配 Mac 显示环境，同时保留类似 iPad 的外观。
Mac 用户界面风格不会缩放应用的用户界面以匹配 Mac 显示环境。某些控件会更改其大小和外观，与它们交互的感觉和与 AppKit 控件交互的感觉相同。例如，看起来 UIButton 与 . NSButton.

默认情况下，.NET MAUI Mac Catalyst 应用使用 iPad 用户界面风格。如果这是你想要的行为，请确保应用的 Info.plist 文件仅将 2 指定为 UIDeviceFamily 键的值：

<key>UIDeviceFamily</key>
<array>
  <integer>2</integer>
</array>

你可能会发现采用 Mac 用户界面成语可以增强应用的用户体验。为此，请更新应用的 Info.plist 文件以将 6 指定为键的值 UIDeviceFamily ：

<key>UIDeviceFamily</key>
<array>
  <integer>6</integer>
</array>

重要

Mac 用户界面成语需要 macOS 11.0+。因此，若要使用它，需要 SupportedOSPlatformVersion 将项目文件中的至少设置为 14.0，这是 macOS 11.0 的 Mac Catalyst 版本。

采用 Mac 用户界面成语可能需要对应用进行其他更改。例如，如果你的应用使用大小为 iPad 的图像，或者具有硬编码大小，则可能需要更新应用以适应大小差异。

警告

UIStepper， UIPickerViewApple UIRefreshControl 不支持 Mac 用户界面成语。这意味着使用这些本机控件的 .NET MAUI 控件（Stepper Picker和RefreshView）不能在 Mac 用户界面中使用。尝试这样做将引发 macOS 异常。

此外，Mac 用户界面成语中还应用了以下约束：

UISwitch 在非 Mac 成语视图中设置游戏时，引发 macOS 异常。
UIButton调用 macOS 异常或调用除任何状态以外的AddGestureRecognizerUIControlStateNormal.Normal任何状态时SetTitle或SetImage调用时引发 macOS 异常。
UISlider调用方法以及设置属性时SetThumbImage MaximumTrackTintColor SetMaxTrackImage MaxValueImage SetMinTrackImage ThumbTintColor MinimumTrackTintColor MinValueImage，将引发 macOS 异常。

确定用户界面成语

可以在运行时确定 .NET MAUI Mac Catalyst 应用正在使用的用户界面。可以通过检查以下UIViewController属性的值UserInterfaceIdiom来实现此目的：

#if MACCATALYST
    UIKit.UIViewController viewController = Platform.GetCurrentUIViewController();
    if (viewController.TraitCollection.UserInterfaceIdiom == UIKit.UIUserInterfaceIdiom.Mac)
        // Mac user interface idiom
    else
        // iPad user interface idiom
#endif

另请参阅

在 developer.apple.com 上为 Mac 应用选择用户界面成语。

通过

为 Mac Catalyst 应用指定 UI 成语

确定用户界面成语

另请参阅

其他资源