MAUI入门指南

ABP商业平台提供了一个基础的MAUI模板，用于开发与基于ABP的后端集成的移动应用程序。

运行服务器应用程序

运行入门文档中描述的后端应用程序。

运行移动应用程序

打开MAUI项目中的appsettings.json文件：

确保Authority和BaseUrl与正在运行的.HttpApi.Host、.Web或.Blazor(BlazorServer UI)项目地址匹配。

确认后端应用程序正在运行且移动应用程序中的appsettings.json已正确配置后，您可以继续运行移动应用程序。您可以通过使用dotnet build命令（例如，Android使用dotnet build -t:Run -f net9.0-android，iOS使用dotnet build -t:Run -f net9.0-ios）或通过Visual Studio或任何其他支持MAUI的IDE来运行应用程序。

有关运行移动应用程序的更多信息，请参阅微软官方文档。

您可以查看用户页面或任何其他预定义页面，了解如何使用CSharp客户端代理请求后端API，并在您的应用程序中以相同方式使用后端API。此外，如果在特定平台上遇到错误，可以参考以下各平台的章节查找常见问题及其解决方案。

Android

如果在连接到模拟器或实体手机时出现以下错误，需要设置端口映射。

无法连接到本地主机上的后端服务。

打开命令行终端并运行adb reverse命令，将Android设备上的端口暴露给您计算机上的端口。例如：

adb reverse tcp:44305 tcp:44305

将44305替换为您的后端应用程序运行的端口号。

在Android模拟器启动后运行此命令。

[!重要] 如果您的项目使用分层或微服务架构，请确保使用adb reverse命令正确代理认证服务器和所有远程服务端口。您可以在YourProjectName.Maui/appsettings.json文件中找到所有必需的远程服务端口和AuthServer配置。

[!注意] 如果您没有单独安装Android调试桥(adb)，可以通过Visual Studio工具栏菜单工具 > Android > Android Adb命令提示符打开。此操作需要Android模拟器正在运行。

iOS

iOS模拟器使用主机网络。因此，在模拟器中运行的应用程序可以通过机器的IP地址或localhost主机名连接到在本地计算机上运行的Web服务。例如，假设本地安全Web服务通过/api/todoitems/相对URI公开GET操作，在iOS模拟器上运行的应用程序可以通过向https://localhost:<端口>/api/todoitems/发送GET请求来使用该操作。

如果在Windows上通过远程连接使用模拟器，请按照微软官方文档设置正确的配置。

遇到"could not find any available provisioning profiles for on ios"错误

您需要执行一些额外步骤，请查看微软文档

Windows的远程iOS模拟器

如果在Mac代理上运行MAUI，远程iOS模拟器无法访问在Windows上运行的后端应用程序，您需要在Mac上运行后端应用程序或使后端应用程序内部化。

用户界面

MAUI模板包含四个页面：

首页：应用程序的欢迎页面。
用户：应用程序用户的管理页面。您可以搜索、添加、更新或删除应用程序用户。
租户：租户管理页面。
设置：应用程序设置的管理页面。在此页面上，您可以更改当前语言、个人资料图片、当前密码和/或当前主题。

首页

用户页面

租户页面

设置页面

高级功能

验证

在MVVM模式（模型-视图-视图模型）的上下文中，视图模型负责执行数据验证并向视图发出任何验证错误信号，以便用户能够纠正这些错误。在MAUI中，要执行验证，您应将视图模型属性定义为ValidatableObject<T>类型并指定相关的验证规则。

要指定验证规则并向属性添加验证规则，可以参考微软的验证文档。

发布

发布应用程序没有自定义步骤。您可以按照每个平台的官方文档操作：

ABP模板使用安全存储来存储访问令牌和刷新令牌。因此，请确保您已完成以下每个平台的部分以便在生产环境中使用：

安全存储 - 入门指南