示例工程教程【免费下载链接】cw-omnibusSource code to omnibus edition of _The Busy Coders Guide to Android Development_项目地址https://gitcode.com/gh_mirrors/cw/cw-omnibus点击查看免费下载本篇技术指南以 cw-omnibus 仓库中的 StatusBarColor 示例工程 为蓝本系统讲解如何在 Android 应用中通过appcompat-v7同时定制 Action Bar操作栏与设备状态栏Status Bar的颜色。该示例是The Busy Coders Guide to Android Development中appcompat-v7章节官方 ActionBar 移植版的配套演示代码阅读本文后你将掌握主题Theme中三个核心颜色属性的含义与取值方式、在代码中针对不同 API 级别安全设置状态栏颜色的完整写法以及appcompat-v7依赖下主题从Theme.AppCompat继承的正确姿势。示例工程概览一个文件承载两个着色目标示例工程位于 AppCompat/StatusBarColor 目录是一个标准的 Android 应用模块settings.gradle中仅包含:app一个模块。它的演示目标非常明确对Action Bar操作栏应用自定义颜色对设备状态栏Status Bar应用自定义颜色。整个工程只有一个 Activity ——ActionBarDemoActivity界面主体是一个加载了若干单词的ListView布局见 list_content_simple.xml菜单见 actions.xml演示的重点不在于列表本身而在于窗口顶部的两层“色带”如何被统一驱动。包名com.commonsware.android.abverscolor也暗示了它的主题abActionBar versVersion版本判断 color颜色。主题定义三个颜色属性驱动整套配色appcompat-v7的着色体系基于 Material Design 的“主色”概念通过三个主题属性即可控制全局配色。示例在 styles.xml 中定义了自己的主题?xml version1.0 encodingutf-8? resources style nameTheme.Apptheme parentTheme.AppCompat item namecolorPrimarycolor/primary/item item namecolorPrimaryDarkcolor/primary_dark/item item namecolorAccentcolor/accent/item /style /resources三个属性的职责划分如下属性作用对象本示例取值colorPrimaryAction Bar 背景色color/primarycolorPrimaryDark状态栏颜色API 21与 Action Bar 的深色变体color/primary_darkcolorAccent控件强调色选中态、进度条、输入框光标等color/accent对应的颜色值定义在 colors.xml?xml version1.0 encodingutf-8? resources color nameprimary#3f51b5/color color nameprimary_dark#1a237e/color color nameaccent#ffee58/color /resources从取值看这是一套标准的 Material Indigo 配色#3f51b5Indigo 500用于主色#1a237eIndigo 900作为深色变体#ffee58Yellow A200作为强调色。Action Bar 的着色完全由主题属性驱动只要应用了这个主题appcompat-v7就会自动把 Action Bar 背景绘制为colorPrimary无需任何 Java 代码干预——这也是该示例与仓库中另一个仅演示 Action Bar 着色的变体 ActionBarColor 共有的核心思路。在代码中设置状态栏颜色API 21 的安全写法Action Bar 的颜色由主题自动处理但状态栏颜色必须由代码显式设置而且只在 Android 5.0API 21Lollipop及以上生效。示例在 ActionBarDemoActivity.java 的onCreate()中完成了这一工作if (Build.VERSION.SDK_INT Build.VERSION_CODES.LOLLIPOP) { Window window getWindow(); window.addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS); window.clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS); window.setStatusBarColor(getResources().getColor(R.color.primary_dark)); } setContentView(R.layout.list_content_simple); initAdapter();逐行拆解这段代码的意图版本判断Build.VERSION.SDK_INT Build.VERSION_CODES.LOLLIPOP确保只在该 API 支持状态栏着色时执行在旧版本设备上静默跳过保证应用在 API 15 的minSdkVersion上也能正常安装运行。FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS从 API 21 起窗口默认不再绘制系统栏状态栏、导航栏背景必须显式添加该标志setStatusBarColor()才会真正生效。它是“允许窗口绘制系统栏背景”的开关。FLAG_TRANSLUCENT_STATUS该标志会使状态栏变为半透明效果。clearFlags()将其移除明确要求使用不透明的实色背景与示例期望的纯色渲染一致。这一加一清的组合是许多 Material 应用的标准写法。setStatusBarColor()传入的R.color.primary_dark与主题中的colorPrimaryDark使用同一个颜色资源因此状态栏颜色与 Action Bar 的深色变体天然保持一致形成“ActionBar 亮、状态栏暗”的层次感。注意getResources().getColor()返回 ARGB 颜色值API 23 推荐用getColor(id, theme)或ContextCompat.getColor()本示例面向当时的 Android 开发环境写法以getColor(R.color.primary_dark)为准。主题如何被应用清单文件中的全局声明主题只有在被引用时才会生效。示例在 AndroidManifest.xml 的application节点上声明了它application android:allowBackupfalse android:icondrawable/ic_launcher android:labelstring/app_name android:themestyle/Theme.Apptheme activity android:nameActionBarDemoActivity android:labelstring/app_name ... /activity /application把android:theme放在application级别意味着主题作用于整个应用的所有界面。由于Theme.Apptheme的父主题是Theme.AppCompatActivity 继承自AppCompatActivity见 ActionBarDemoActivity.java 的import android.support.v7.app.AppCompatActivity;与类声明这正是appcompat-v7使用模式的完整闭环主题继承Theme.AppCompatActivity 继承AppCompatActivity二者缺一不可否则 Action Bar 将退化为系统原生样式。工程构建前提依赖与 SDK 版本工程使用 Gradle 构建应用模块的构建配置见 app/build.gradleapply plugin: com.android.application dependencies { implementation com.android.support:appcompat-v7:27.1.1 } android { compileSdkVersion 27 buildToolsVersion 27.0.3 defaultConfig { minSdkVersion 15 targetSdkVersion 27 } }要点说明appcompat-v7:27.1.1是本例 Action Bar 着色的前提依赖Theme.AppCompat、AppCompatActivity均来自该库由于appcompat-v7内部又依赖support-v4等基础库构建时会被 Gradle 一并引入。compileSdkVersion 27与targetSdkVersion 27匹配依赖库的编译版本才能解析出Theme.AppCompat中colorPrimary等属性顶部 build.gradle 使用 Android Gradle Plugin 3.1.4对应 Gradle 4.4见 gradle-wrapper.properties。minSdkVersion 15说明该示例兼容 Android 4.0.3API 15以上的设备状态栏着色部分通过代码中的版本判断实现了向后兼容。值得留意的是工程根目录的 project.properties 仍保留着旧的 Eclipse ADT 时代配置targetandroid-19而 AndroidManifest.xml 中uses-sdk也写着旧值minSdkVersion14、targetSdkVersion19——在实际 Gradle 构建中以app/build.gradle中的defaultConfig为准。变体对照ActionBarColor 只着色 Action Barcw-omnibus 仓库中还提供了功能更窄的对照工程 ActionBarColor它只演示appcompat-v7Action Bar 的颜色定制主题定义与StatusBarColor完全相同同样是Theme.AppCompat父主题 colorPrimary/colorPrimaryDark/colorAccent颜色值一致但 Activity 代码中没有setStatusBarColor()相关逻辑minSdkVersion也更低7。两个工程的差异恰好划出了“主题属性能覆盖什么、代码还必须做什么”的边界主题属性colorPrimary等负责 Action Bar 的自动着色两者一致状态栏着色必须额外编写 API 21 判断与 Window Flags 操作只有StatusBarColor具备。如果你只需要定制操作栏参照ActionBarColor即可若想让状态栏也纳入配色体系本示例的“主题 代码”组合就是完整的参考实现。延伸阅读仓库内的配套资源示例入口代码ActionBarDemoActivity.java主题与颜色定义styles.xml、colors.xml清单与构建配置AndroidManifest.xml、app/build.gradle对照工程ActionBarColor主题背景工程drawable目录下的*_apptheme.xml与.9.png素材如 ab_background_textured_apptheme.xml、progress_horizontal_apptheme.xml均出自 Android Action Bar Style Generator用于渲染 Action Bar 各控件的按压、聚焦、选中等状态可作为进一步定制样式的参考。该示例的完整讲解收录于The Busy Coders Guide to Android Development的appcompat-v7官方 ActionBar 移植版章节本文内容即为该章节配套示例在仓库中的落地实现解读。赞分享示例工程教程【免费下载链接】cw-omnibusSource code to omnibus edition of _The Busy Coders Guide to Android Development_项目地址https://gitcode.com/gh_mirrors/cw/cw-omnibus点击查看免费下载相关推荐在 appcompat-v7 ActionBar 中集成 ShareActionProvidercw-omnibus 共享操作示例深度解析在 appcompat v7 ActionBar 中集成 ShareActionProvidercw omnibus 共享操作示例深度解析 本篇技术指南以 c示例工程教程在 AppCompat ActionBar 中集成 SearchView 向后移植cw-omnibus SearchView 示例深度解析在 AppCompat ActionBar 中集成 SearchView 向后移植cw omnibus SearchView 示例深度解析 cw omnibu示例工程教程cw-omnibus AppCompat/Basic 示例集用 appcompat-v7 修订基本控件的行为与外观cw omnibus AppCompat/Basic 示例集用 appcompat v7 修订基本控件的行为与外观 在 cw omnibus 仓库中 App示例工程教程上一篇C-Eval革命性中文基础模型评估套件52个学科全面评测下一篇StorageChooser未来路线图即将推出的新功能与改进创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考