Android Activity 生命周期与配置变更
在 android 系统中，当设备发生配置变更（如屏幕方向切换、键盘可用性变化、屏幕尺寸或密度变化等）时，默认行为是销毁当前的 activity 实例，然后重新创建一个新的 activity 实例。这一机制旨在确保应用能够根据新的配置加载最合适的资源和布局。然而，对于某些需要维护复杂状态的组件，例如地图视图（如 azure maps），activity 的重建会导致其当前视图状态（如缩放级别、中心点、标记等）丢失，用户体验会受到严重影响。
解决方案：阻止 Activity 重建并手动处理配置变更
为了防止 Activity 在屏幕方向变化时重置，我们可以告知 Android 系统，由应用自身来处理特定的配置变更，而不是销毁并重建 Activity。这主要通过以下两个步骤实现：
1. 修改 AndroidManifest.xml
在应用的 AndroidManifest.xml 文件中，找到包含 Azure Maps 的 Activity 的
示例代码：
android:configChanges 属性详解：
- orientation: 表示当屏幕方向发生变化时，Activity 不会被销毁重建，而是会调用其 onConfigurationChanged() 方法。
- keyboardHidden: 表示当键盘的可用性（显示或隐藏）发生变化时，Activity 不会被销毁重建。
- screenSize: （推荐在 API Level 13 及以上版本添加）表示当屏幕尺寸发生变化时，Activity 不会被销毁重建。在现代 Android 设备上，屏幕方向变化通常也伴随着屏幕尺寸的变化，因此添加此属性非常重要，以确保在所有情况下都能阻止 Activity 重建。
添加这些属性后，当指定的配置发生变化时，Android 系统将不会销毁并重新创建 YourMapActivity，而是会调用该 Activity 的 onConfigurationChanged() 方法。
2. 处理 onConfigurationChanged() 回调
在 YourMapActivity 类中，重写 onConfigurationChanged() 方法。当配置变更发生时，系统会调用此方法，您可以在其中执行任何必要的视图调整或状态更新。
示例代码：
import android.content.res.Configuration;
import androidx.appcompat.app.AppCompatActivity;
import android.os.Bundle;
public class YourMapActivity extends AppCompatActivity {
// 假设您的 Azure Maps 实例
// private MapControl mapControl;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_map);
// 初始化 Azure Maps
// mapControl = findViewById(R.id.azure_map_view);
// ... 其他初始化代码
}
@Override
public void onConfigurationChanged(Configuration newConfig) {
super.onConfigurationChanged(newConfig);
// 默认情况下，如果只是为了防止 Activity 重建，
// 并且您的布局在横竖屏切换时能够自动适应，
// 那么这里可能不需要编写复杂的逻辑。
// Azure Maps 视图通常能够自行处理其内部的布局调整。
// 如果您有特定的UI元素需要在方向改变时进行调整，
// 可以在这里根据 newConfig.orientation 进行判断和处理。
if (newConfig.orientation == Configuration.ORIENTATION_LANDSCAPE) {
// 当前是横屏
// Log.d("MapActivity", "屏幕切换到横屏");
} else if (newConfig.orientation == Configuration.ORIENTATION_PORTRAIT) {
// 当前是竖屏
// Log.d("MapActivity", "屏幕切换到竖屏");
}
// 注意：不要在这里重新加载或重置 Azure Maps 实例，
// 因为我们的目标就是保持其状态。
// 如果需要，可以在这里调整地图视图的大小或布局参数，
// 但通常情况下，当Activity不重建时，布局系统会自动处理。
}
}在大多数情况下，当您只是想阻止 Activity 重建时，onConfigurationChanged() 方法内可能不需要特别复杂的逻辑。因为一旦 Activity 不再重建，其视图层次结构和状态将得以保留。Azure Maps 实例也会保持其加载状态和视图属性。如果您的布局文件（XML）已经很好地支持了横竖屏的自适应（例如使用 ConstraintLayout 或不同的布局资源文件），那么通常不需要在 onConfigurationChanged() 中进行额外的布局调整。
注意事项
- 适用场景： 这种方法最适用于需要维护复杂状态（如地图、播放器、游戏）且不希望在配置变更时丢失状态的 Activity。
- 资源管理： 当您手动处理配置变更时，您需要负责所有与配置相关的资源更新。例如，如果您有针对横屏和竖屏的不同布局文件 (layout-land/)，当 Activity 不重建时，系统不会自动加载这些不同的布局。您可能需要在 onConfigurationChanged() 中手动处理布局的切换，或者设计一个能够自适应的单一布局。然而，对于像 Azure Maps 这样的组件，通常其内部渲染机制会自行适应视图容器的大小变化。
- 替代方案： 对于不那么复杂的 Activity，或者当您希望利用 Android 默认的生命周期管理时，可以考虑使用 ViewModel 来保存 Activity 的 UI 相关数据。ViewModel 的生命周期比 Activity 更长，可以在 Activity 重建时保留数据。但对于阻止整个 Activity 重建的需求，android:configChanges 是更直接的解决方案。
- 测试： 在不同设备和 Android 版本上充分测试您的应用，确保在屏幕方向切换时，Azure Maps 的行为符合预期，并且没有引入新的问题。
总结
通过在 AndroidManifest.xml 中为目标 Activity 添加 android:configChanges="orientation|keyboardHidden|screenSize" 属性，并重写 onConfigurationChanged() 方法，开发者可以有效地阻止 Android Activity 在屏幕方向变化时被销毁和重建。这一策略对于维护 Azure Maps 等状态敏感型组件的连续性和用户体验至关重要。正确实施后，用户在导航地图时切换设备方向，将不再面临地图重置的问题，从而获得更加流畅和专业的应用体验。
