.NET MAUI为何自行处理屏幕旋转？官方模板代码解析

你在官方模板生成的.NET MAUI Android项目中看到的这段代码：

[Activity(Theme = "@style/Maui.SplashTheme", MainLauncher = true, ConfigurationChanges = ConfigChanges.ScreenSize | ConfigChanges.Orientation | ConfigChanges.UiMode | ConfigChanges.ScreenLayout | ConfigChanges.SmallestScreenSize | ConfigChanges.Density)]
public class MainActivity : MauiAppCompatActivity
{
}

其中ConfigChanges.Orientation的作用是告诉Android系统：屏幕旋转导致的配置变化由应用自行处理，不要销毁重建Activity。而屏幕旋转功能依然正常，是因为MAUI框架内部实现了配置变化的处理逻辑，具体细节和手动处理的原因如下：

一、底层实现逻辑 #

1. 接管配置变化回调
   MauiAppCompatActivity继承自Android的AppCompatActivity，并重写了OnConfigurationChanged方法。当屏幕旋转触发配置变化时，系统不再销毁Activity，而是直接调用这个方法。
2. 跨平台层同步更新
   MAUI在OnConfigurationChanged中会将新的配置信息（比如新的屏幕方向、尺寸）传递到跨平台的.NET层，触发框架内部的布局更新逻辑。
3. UI适配与状态保留
   框架会自动重新计算页面布局，适配新的屏幕方向；同时保留当前页面的所有状态（比如输入框内容、页面导航栈），因为Activity没有被重建，这些状态自然不会丢失。
4. 资源适配处理
   如果你的项目中存在分方向的资源（比如layout-land目录下的布局文件），MAUI会在配置变化时自动加载对应方向的资源，完成UI的切换。

二、手动处理配置变化的原因 #

• 避免Activity重建的开销
  默认情况下，Android屏幕旋转会销毁并重建Activity，这个过程会导致页面状态丢失，且重建复杂页面时会有明显的卡顿。MAUI手动处理配置变化，直接复用现有Activity，避免了这些问题。
• 跨平台逻辑统一
  MAUI作为跨平台框架，需要在Android、iOS、Windows等平台实现一致的屏幕旋转行为。手动接管Android的配置变化后，能和其他平台的旋转处理逻辑对齐，让开发者不用针对每个平台单独适配。
• 性能优化
  减少Activity重建带来的资源消耗，尤其是对于包含大量控件或复杂业务逻辑的页面，手动处理配置变化能显著提升旋转时的流畅度。
• 精细控制能力
  框架可以在旋转过程中加入自定义逻辑，比如根据方向切换不同的布局模板、保存临时业务状态，比系统默认的重建机制更灵活。

内容的提问来源于stack exchange，提问作者me.at.coding