news 2026/6/10 12:25:00

Android基础-Activity属性 android:configChanges

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
Android基础-Activity属性 android:configChanges
<activity android:name=".activity.MoreFuncActivity" android:exported="false" android:configChanges="keyboardHidden|orientation|screenSize|navigation|keyboard" />

项目清单文件中看到

android:configChanges="keyboardHidden|orientation|screenSize|navigation|keyboard"

不太清楚这个属性的作用,特地学习下,避免踩坑

android:configChanges是Android清单文件(Manifest)中Activity标签的一个重要属性,用于指定当设备配置发生变化时,Activity应该如何响应。

默认情况下,当设备配置发生变化(如屏幕旋转、键盘弹出等),Android系统会销毁并重新创建当前Activity,导致Activity状态丢失。开发者需要在onSaveInstanceState()onRestoreInstanceState()中处理状态保存与恢复。

设置此属性的目的

通过设置android:configChanges,开发者可以告诉系统"不要重新创建Activity,而是调用onConfigurationChanged()方法",让开发者自行处理配置变化,避免Activity重建带来的性能开销和状态管理复杂性。

例子中包含的属性配置变化:

  1. keyboardHidden- 软键盘显示/隐藏状态变化
  2. orientation- 屏幕方向变化(横屏/竖屏)
  3. screenSize- 屏幕尺寸变化(Android 3.2+引入,通常与屏幕旋转相关)
  4. navigation- 导航方式变化(如从触控变为方向键导航)
  5. keyboard- 物理键盘可用性变化(如折叠键盘展开/收起)

下表字符串是该属性的所有有效值(若有多个值,则使用|进行分隔,例如"locale|navigation|orientation")。

说明
"colorMode"

屏幕的颜色模式功能(色域或动态范围)已更改。

注意:activity 使用colorMode属性或在运行时请求的颜色模式不同于支持不同颜色模式的功能。更改所用颜色模式的 activity 不会导致配置更改,因为显示屏的颜色功能没有更改。

"density"

显示密度的更改,例如当用户指定不同的显示比例或其他屏幕当前处于活跃状态时。

在 API 级别 24 中引入。

"fontScale"字体缩放比例的更改,例如当用户选择新的全局字体大小时。
"fontWeightAdjustment"字体粗细增加量已发生变化。
"grammaticalGender"相应语言的语法性别已更改。请参阅 GrammaticalInflectionManager。

在 API 级别 34 中引入。

"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"配置,因为当设备在纵向模式与横向模式之间切换时,屏幕布局和屏幕大小可能会发生变化。

"screenLayout"屏幕布局的更改,例如在其他屏幕变为活动状态时。
"screenSize"

当前可用屏幕尺寸的更改。

该值表示目前可用尺寸相对于当前宽高比的变更,当用户在横向模式与纵向模式之间切换时,它便会发生变更。

在 API 级别 13 中引入。

"smallestScreenSize"

实体屏幕尺寸的更改。

该值表示与方向无关的尺寸变更,因此它只有在实际物理屏幕尺寸发生变更(如切换到外部显示器)时才会变化。对此配置所作变更对应 smallestWidth 配置的更改。

在 API 级别 13 中引入。

"touchscreen"触摸屏模式的更改,例如当用户连接或断开输入外围设备或在不同显示屏之间移动应用时。
"uiMode"界面模式的更改,例如当用户将设备放到桌面或车载基座上时,或者夜间模式发生变化时。如需了解有关不同界面模式的更多信息,请参阅UiModeManager

在 API 级别 8 中引入。

所有这些配置变更都可能影响应用所看到的资源值。因此,调用onConfigurationChanged()时,通常必须再次检索所有资源(包括视图布局和可绘制对象),才能正确处理更改。

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/6/2 21:41:56

AI元人文:技术哲学的跃迁宣言——意义行为原生

AI元人文&#xff1a;技术哲学的跃迁宣言——意义行为原生在人工智能深度发展的时代&#xff0c;我们正处于一场技术哲学的认知迷茫之中。传统技术哲学框架在AI的“价值对齐命题”前摇摆不定。工具论的“价值中立”已成幻象&#xff0c;批判理论的“技术异化”沦为悲观的注脚&a…

作者头像 李华
网站建设 2026/6/10 0:21:44

9、从代码到内存:通用入门指南

从代码到内存:通用入门指南 1. 代码示例与栈帧设置 先来看一段汇编代码: PUSH EBP ; put EBP (register) on the stack MOV EBP, ESP ; set EBP to value of ESP (register, top of stack) PUSH -1 ; put -1 (immediate) on the stack ADD ESP, 4 ; negat…

作者头像 李华
网站建设 2026/6/6 12:16:14

Kotaemon语音合成接口对接:TTS功能实现

Kotaemon语音合成接口对接&#xff1a;TTS功能实现 在智能客服、车载交互和无障碍服务日益普及的今天&#xff0c;用户对AI系统的期待早已不再局限于“能答对问题”——他们希望得到更自然、更具亲和力的回应。一个只会输出文字的助手&#xff0c;即便知识再丰富&#xff0c;也…

作者头像 李华
网站建设 2026/6/2 14:14:28

Kotaemon内置评估模块教你科学衡量问答质量

Kotaemon 内置评估模块&#xff1a;科学衡量问答质量的新范式 在智能客服、企业知识库和虚拟助手日益普及的今天&#xff0c;用户对 AI 回答准确性的容忍度正变得越来越低。一句看似合理却缺乏依据的回答&#xff0c;可能引发严重的业务误解甚至法律风险。大语言模型&#xff0…

作者头像 李华
网站建设 2026/6/9 22:21:04

9个AI写作工具,助研究生轻松搞定论文难题!

9个AI写作工具&#xff0c;助研究生轻松搞定论文难题&#xff01; AI 工具如何成为研究生论文写作的得力助手 在学术研究日益深入的今天&#xff0c;研究生们常常面临论文写作的重重挑战。从选题到撰写&#xff0c;再到修改与降重&#xff0c;每一个环节都可能成为瓶颈。而随着…

作者头像 李华