android:configChanges
android:configChanges
列出 activity 将自行处理的配置变更。在运行时发生配置变更时,默认情况下会关闭 activity 并将其重启,但使用该属性声明配置将阻止 activity 重启。相反,activity 会保持运行状态,并且系统会调用其 onConfigurationChanged()
方法。
注意:请仅在特殊情况下使用此属性,以提高应用性能和响应速度。如需了解详情,请参阅处理配置更改。
下列字符串是该属性的有效值。若有多个值,则使用 |
进行分隔,例如 "locale|navigation|orientation"
。
值 | 说明 |
---|---|
"density" |
显示密度的更改,例如当用户指定不同的显示比例或其他屏幕当前处于活跃状态时。
在 API 级别 24 中引入。 |
"fontScale" |
字体缩放比例的更改,例如当用户选择新的全局字体大小时。 |
"keyboard" |
键盘类型的更改,例如当用户插入外接键盘时。 |
"keyboardHidden" |
键盘无障碍功能的更改,例如当用户显示硬件键盘时。 |
"layoutDirection" |
布局方向的更改,例如从由左到右 (LTR) 改为由右到左 (RTL)。
在 API 级别 17 中引入。 |
"locale" |
语言区域的更改,例如当用户选择显示文本所用的新语言时。 |
"mcc" |
当系统检测到用于更新 MCC 的 SIM 卡时,IMSI 移动设备国家/地区代码 (MCC) 发生的更改。 |
"mnc" |
当系统检测到用于更新 MNC 的 SIM 卡时,IMSI 移动网络代码 (MNC) 发生的更改。 |
"navigation" |
导航类型(轨迹球或方向键)的 TA 更改。通常不会出现这种情况。 |
"orientation" |
屏幕方向的更改,例如用户旋转设备时。 注意:如果应用面向 Android 3.2(API 级别 13)或更高版本的系统,则还应声明 |
"screenLayout" |
屏幕布局的更改,例如在其他屏幕变为活动状态时。 |
"screenSize" |
当前可用屏幕尺寸的更改。
该值表示目前可用尺寸相对于当前宽高比的变更,当用户在横向模式与纵向模式之间切换时,它便会发生变更。 在 API 级别 13 中引入。 |
"smallestScreenSize" |
实体屏幕尺寸的更改。
该值表示与方向无关的尺寸变更,因此它只有在实际物理屏幕尺寸发生变更(如切换到外部显示器)时才会变化。对此配置所作变更对应 在 API 级别 13 中引入。 |
"touchscreen" |
触摸屏的更改。通常不会出现这种情况。 |
"uiMode" |
界面模式的更改,例如当用户将设备放到桌面或车载基座上时,或者夜间模式发生变化时。如需了解有关不同界面模式的更多信息,请参阅 UiModeManager 。
在 API 级别 8 中引入。 |
所有这些配置变更都可能影响应用所看到的资源值。因此,调用 onConfigurationChanged()
时,通常必须再次检索所有资源(包括视图布局和可绘制对象),才能正确处理更改。
注意:如要处理所有多窗口模式相关的配置变更,请使用 "screenLayout"
和 "smallestScreenSize"
。Android 7.0(API 级别 24)或更高版本的系统支持多窗口模式。
Android 开发者 | Android Developers (google.cn)
onConfigurationChanged
onConfigurationChanged的目的是为了规避横竖屏切换干掉activity而重新调用onCreate方法的问题;
有的时候,我们希望重新进入OnCreate生命周期,此时可以调用onSaveInstanceState和onRestoreInstanceState方法,可参考http://www.cnblogs.com/leavescy/p/7845921.html;
而有的时候,我们又不希望这种事情发生,所以就要重写onConfigurationChanged方法;
1. 在AndroidManifest.xml中添加一些权限:
<uses-permission android:name="android.permission.CHANGE_CONFIGURATION"></uses-permission>
2. 配置目标activity属性:
android:configChanges="orientation|screenSize">
3. 最后在MainActivity.java中重写onConfigurationChanged方法,如下所示:
里面打印出来了一些日志,可以提示现在是横屏还是竖屏;
@Override public void onConfigurationChanged(Configuration newConfig) { if(this.getResources().getConfiguration().orientation == Configuration.ORIENTATION_LANDSCAPE){ Log.i("LANDSCAPE = ", String.valueOf(Configuration.ORIENTATION_LANDSCAPE)); } else if(this.getResources().getConfiguration().orientation == Configuration.ORIENTATION_PORTRAIT){ Log.i("LANDSCAPE = ", String.valueOf(Configuration.ORIENTATION_PORTRAIT)); } super.onConfigurationChanged(newConfig); }
Android onConfigurationChanged用法(规避横竖屏切换导致的重新调用onCreate方法) - 小叶子leavescy - 博客园 (cnblogs.com)