JetBrains Rider 2025.2 Help

语言和框架:MAUI

JetBrains Rider 支持创建和处理 .NET MAUI 项目,适用于 Android、iOS、macOS 和 Windows。 尽管 JetBrains Rider 不提供 XAML 的设计器或预览器,您可以直接在模拟器或连接的设备中调整视觉效果,并通过 XAML 热重载观察差异。 您还可以利用 代码分析编码辅助调试 功能,支持 C#VB.NET 和其他语言,以及通用的 IDE 功能,例如 集成 VCS 客户端

如果 .NET MAUI 依赖的其他工具(例如 Android SDK、Android 模拟器)配置正确,您将能够直接从 JetBrains Rider IDE 构建、运行和发布您的 .NET MAUI 应用程序。

在 macOS 上,JetBrains Rider 提供了与 Xcode 的同步 ,您需要配置资源和目标,并签署应用程序。

开始之前

与操作系统无关的步骤

  1. 要在您的计算机上启用 MAUI 支持,请在终端中运行以下命令:

    dotnet workload install maui

  2. 可选地,安装特定目标的工作负载:

    maui-ios maui-android maui-maccatalyst maui-windows maui-macos
  3. 确保您拥有 Java JDK 11 或更高版本。

  4. 如果您需要为 Android 运行或发布您的应用程序,请 安装 Rider Android Support 插件。

根据您的操作系统,配置以下内容:

在 Windows 上,您可以为任何平台开发 MAUI 应用程序,但本地构建和运行/调试仅限于 Blazor 应用和 Android 设备及模拟器。

您可以在 iOS 和 macOS 上构建和运行您的应用程序。 为此,请 配置一个网络可访问的 Mac 代理 ,然后从主菜单中选择 工具 | iOS | 远程 Mac 代理 ,添加一个新连接并点击 连接

在 macOS 上,您可以开发、构建和运行 MAUI 应用程序。

要配置资源和目标并签署应用程序,请确保您的计算机上已安装 Xcode。 您需要一个 Apple ID 来安装和登录 Xcode。 如果您尚未拥有,可以在 https://appleid.apple.com 创建一个新的。

JetBrains Rider 将自动检测 Xcode。 如果您有 多个 Xcode 版本 ,您可以在 JetBrains Rider 设置 的 构建、执行、部署 | Apple 平台 页面上选择要使用的版本 Ctrl+Alt+S

Linux 上不支持 MAUI。

创建一个新的 MAUI 项目

JetBrains Rider 包含一个可配置的新 MAUI 项目模板。

您可以使用 文件 | 新建解决方案… 在新解决方案中创建一个新的 MAUI 项目,或者通过右键点击解决方案或解决方案资源管理器中的解决方案文件夹节点,选择 添加 | 新建项目 ,将新的 MAUI 项目添加到现有解决方案中。

JetBrains Rider:新解决方案向导。 Xamarin

运行和调试 MAUI 应用程序

当您创建或打开一个 MAUI 项目时,JetBrains Rider 会自动创建多个不同的 运行/调试配置 ,您可以使用它们在不同平台上运行项目。

如果您想调整应用程序启动和执行的方式,可以 编辑并创建新的 运行/调试配置。 当您从 IDE 启动一个 MAUI 应用程序时,您可以使用 工具栏 上的相应选择器来选择应使用的配置:

JetBrains Rider:为 MAUI 应用程序选择运行/调试配置

发布 MAUI 应用程序

当您的项目准备好部署时,您可以创建一个特定平台的归档文件,例如 .ipa ,用于手动发布。

JetBrains Rider 使用 发布到文件夹 类型的运行配置来维护多个发布配置文件并构建目标工件。

  1. 右键点击一个 MAUI 项目并选择 发布

    在出现的 发布到 弹出窗口中,选择或创建一个发布配置。 如果您还没有发布配置,请点击 本地文件夹

  2. 如果您选择了一个现有的发布配置,它将立即启动。 否则,将会打开 编辑配置 对话框,您可以在其中配置发布配置文件。

  3. 使用 目标框架 选择器选择目标构件类型,并指定是否保存构件及其他选项。

    如果您想维护多个发布配置文件,请为每个配置赋予有意义的名称。

    JetBrains Rider:发布 MAUI 应用程序
  4. 点击 运行。 创建构件的进度将显示在 Build 窗口中。 如果构建成功,构件将会在指定位置创建。

  5. 无论构建结果如何,发布配置都会为您的解决方案保存。 您可以在 运行/调试配置对话框 (运行 | 编辑配置) 中访问它。

macOS 上的 Xcode 同步

在 macOS 上开发 .NET MAUI 应用程序时,建议 使用 Xcode 编辑资源文件并将资源连接到代码

您可以使用 .storyboard .xib .plist 文件或 .NET MAUI macios 项目节点的上下文菜单在 Xcode 中打开它们。

如果文件或项目之前从未在 Xcode 中打开过,JetBrains Rider 将生成一个 Xcode 项目,如下所示:

  • 生成 xcodeproj 项目规范(类似于 csproj 的项目描述符,但适用于 Xcode)。

  • 为所有用户类型继承的 NSObject (表单、委托、视图、控件等)在 Objective C 中生成源文件。

  • 所有资源(图像、设计器文件)都会被复制。

当项目结构准备就绪时,Xcode 将自动启动,您可以使用它编辑资源。 每次 Rider 获得焦点时,它都会检查更改(现有文件的编辑、新文件、已删除文件)并将这些更改集成到 .NET MAUI .NET 项目中。 它会修改用户类型的 .designer.cs 部分(从 NSObject 继承)并将所有更改的资源复制回去。

所有与 Xcode 相关的事件都会打印在 Xcode 控制台 工具窗口中,当您在 Xcode 中打开资源或项目时,该窗口会出现:

JetBrains Rider 中的 .NET MAUI 开发:Xcode 控制台

其背后工作原理

当您创建一个新的 .NET MAUI macios 项目时

  1. JetBrains Rider 在 obj\xcode 子目录中创建相应的 xcodeproj 项目( pbxproj 和其他必要文件),并包含所有必需的设置和配置。

  2. 所有内容文件(视图、plist 文件、图像等)的副本都会在该目录中创建。

  3. 对于每种 ViewController 类型,JetBrains Rider 会生成一个带有操作和出口的 objc 类。

  4. 生成的项目会自动在 Xcode 中打开。

当您在 Xcode 中进行更改然后切换到 Rider 时

  1. 所有修改过的内容文件都会复制回 .NET 项目中。

  2. 设置会被更新。

  3. objc 文件会被解析,并为视图控制器重新生成 *.designer.cs 文件。 对于所有这些文件,您将看到一个生成的头文件:

    // WARNING // // This file has been generated automatically by Rider IDE // to store outlets and actions made in Xcode. // If it is removed, they will be lost. // Manual changes to this file may not be handled correctly.
最后修改日期: 2025年 9月 26日