news 2026/6/12 20:48:53

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/12 17:31:55

Kotaemon支持CI/CD持续集成部署吗?DevOps整合

Kotaemon支持CI/CD持续集成部署吗&#xff1f;DevOps整合 在企业级AI系统日益复杂的今天&#xff0c;一个常见的挑战浮出水面&#xff1a;如何将大语言模型&#xff08;LLM&#xff09;驱动的智能体从实验室原型平稳地推向生产环境&#xff1f;许多团队经历过这样的窘境——本地…

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

KotaemonA/B测试方案设计:实验组划分指导

Kotaemon A/B测试方案设计&#xff1a;实验组划分实践指南 在智能客服和企业级知识管理场景中&#xff0c;一个问答系统的准确性不再仅仅取决于大模型的能力&#xff0c;更依赖于背后整套检索增强生成&#xff08;RAG&#xff09;流程的精细调优。我们常常会遇到这样的问题&…

作者头像 李华
网站建设 2026/6/10 20:45:59

基于Kotaemon的会议室预订智能助手开发

基于Kotaemon的会议室预订智能助手开发 在现代企业办公环境中&#xff0c;一个看似简单的任务——“订个会议室”——却常常演变成一场耗时的协调战。员工需要打开日历系统、手动筛选空闲时段、确认设备配置、检查权限、拉群通知同事……稍有疏忽&#xff0c;就可能出现时间冲…

作者头像 李华
网站建设 2026/6/12 10:18:30

Kotaemon助力企业构建私有化知识库问答系统

Kotaemon助力企业构建私有化知识库问答系统 在当今企业数字化转型的浪潮中&#xff0c;知识不再只是静态文档的堆砌&#xff0c;而是驱动效率与决策的核心资产。然而&#xff0c;当员工面对分布在Confluence、SharePoint、本地服务器甚至个人笔记中的海量资料时&#xff0c;“我…

作者头像 李华
网站建设 2026/6/10 15:13:01

Kotaemon微服务架构拆分建议:适应大规模部署

Kotaemon微服务架构拆分建议&#xff1a;适应大规模部署 在企业智能对话系统逐渐成为客服、知识管理与自动化办公核心组件的今天&#xff0c;一个关键问题摆在了架构师面前&#xff1a;如何让原本为本地开发设计的AI框架&#xff0c;顺利演进为支撑高并发、可扩展、易维护的企业…

作者头像 李华
网站建设 2026/6/12 7:50:38

【例3-2】单词查找树(信息学奥赛一本通- P1337)

【题目描述】在进行文法分析的时候&#xff0c;通常需要检测一个单词是否在我们的单词列表里。为了提高查找和定位的速度&#xff0c;通常都画出与单词列表所对应的单词查找树&#xff0c;其特点如下&#xff1a;1&#xff0e;根结点不包含字母&#xff0c;除根结点外每一个结点…

作者头像 李华