尧图网站建设 
Impeccable Android 平台设计指南以 Material 3 为准绳的原生 Android 界面审查与验证实践【免费下载链接】impeccableThe design language that makes your AI harness better at design.项目地址: https://gitcode.com/GitHub_Trending/im/impeccableAndroid 原生界面Jetpack Compose、Android Views、React Native、Expo、Flutter如何在保持品牌表达的同时获得“像原生一样”的信任感本指南以 Impeccable 设计技能库中的 Android 平台参考文档 为骨架系统讲解 Material Design 3 框架下的布局、触控、排版、色彩、动效规范以及基于 adb 的真机/模拟器截图验证流程。读完本文你将掌握一套可直接执行的 Android 平台设计检查清单与命令行验证方案并了解它在 Impeccable 审计、适配工作流中的具体落点。适用范围与核心原则访客模式下 Material 3 是唯一规则书该参考文档面向所有最终运行在 Android 硬件上的原生应用Jetpack Compose、Android Views、React Native、Expo、Flutter 均在其列。它的核心前提是一个贯穿 Impeccable 设计体系的“访客模式”visitor mode概念访客模式收窄了表达层可以覆盖的范围——即结构、导航与交互在每种模式下都必须由 Material Design 3 管辖品牌只能通过 Material 的主题化机制color roles 色彩角色、type scale 字体阶梯、shape 形状、motion 动效来表达自己而不是绕过平台规范另起炉灶。这里有一个容易被忽视的边界一个“处处 Material”的跨平台应用如果同时发布到 iPhone那么在 iOS 硬件上它仍然欠 iOS 一份操作系统级的保证——安全区 insets、Reduce Motion减弱动态效果、边缘滑动返回edge-swipe back。这正是 iOS 平台参考 所管辖的范围。从仓库中可以看到Impeccable 将这类平台知识组织成“参考文档”reference体系init命令在记录到平台为ios、android或adaptive时会自行加载对应的原生平台参考见 skill/SKILL.src.mdaudit.native与adapt.native也都会在开始前读取目标平台参考文档作为评分与规划依据见 skill/reference/audit.native.md 与 skill/reference/adapt.native.md。The Android slop test一眼识破“披着 Android 皮的 iOS 应用”“Android slop test”Android 廉价移植测试是该参考文档的验收门槛一个熟练的 Android 用户会信任这个应用还是在偏离规格的组件上绊倒最常见的失败信号恰恰是“披着 Android 皮肤的 iOS 应用”照抄 iPhone 的仅底部导航bottom-only navigation存在无视系统返回手势的后退箭头back arrow that ignores the system Back gesture出现Cupertino 形状的开关和对话框Cupertino-shaped switches and dialogs。结论很明确Material 3 是规则书跟随它的组件并通过它来主题化品牌。在 audit.native.md 的“Platform ConformanceCRITICAL”维度中这一测试被操作化为具体扣分项——预测性返回被劫持predictive Back hijacked、Web 形状控件web-shaped controls、图标漂移混合图标集而非 Material Symbols、iOS 模式出现在 Android 上等。而在 adapt.native.md 的“平台到平台”迁移表中iOS ↔ Android 惯用法被一一翻译而不是移植Tab bar ↔ Navigation bar / rail / drawer边缘滑动返回 ↔ 预测性 Back 手势/按钮Switch/segmented control ↔ Material switch/chips/Material pickersAction sheet ↔ Bottom sheet/Material dialogSF Symbols/SF Pro/Dynamic Type ↔ Material Symbols/Roboto/sp 缩放语义系统色/material ↔ Material color roles/tonal elevation系统 push/sheet 转场 ↔ container transform/shared-axis/fade-through。布局与结构从导航形态到窗口 insets 的四个硬性要求布局层面的规则在文档中以带规则 ID 的检查项呈现这些 ID 同时是审计时可直接引用的规则标识Material 导航需与屏幕尺寸匹配android-layout-adaptive-nav窄屏compact width使用底部导航栏navigation bar3–5 个目的地宽屏expanded width切换为导航栏抽屉navigation rail或抽屉drawer。绝不允许把手机的底部栏原封不动地搬到平板上。系统返回必须始终可用android-layout-system-back尊重预测性 Back 手势与返回按钮绝不困住用户或劫持该手势。边到边渲染配合窗口 insetsandroid-layout-window-insets应用状态栏、导航栏、刘海/挖孔display cutout与 IME输入法insets确保内容永远不会藏在系统栏或键盘后面。顶部应用栏top app bar提供屏幕上下文当屏幕只有一个主操作时搭配一个 FAB。值得强调的是adapt.native.md的补充视角平板适配的关键是从window size classes窗口尺寸类驱动结构而非机型判断并且“多窗口multi-window是一种尺寸不是边缘情况”——Android 多窗口可以把手机宽度的窗口放到平板上尺寸类驱动的布局可以免费处理这一切skill/reference/adapt.native.md。触控目标48×48 dp 与 8 dp 间距底线文档给出单一但明确的标准规则 IDandroid-touch-target-48dp每个触控目标最小48×48 dp目标之间至少8 dp间距。对比 iOS 参考文档的 44×44 pt可看出平台差异被严格区分。在audit.native.md的“Accessibility”维度中触控目标低于 48 dpAndroid或 44 ptiOS、以及目标拥挤无间距都是明确的扣分项skill/reference/audit.native.md。排版Material 字体阶梯、系统字体与 sp 可缩放单位排版规则对应三个规则 IDMaterial 字体阶梯android-typo-type-scale使用 Display、Headline、Title、Body、Label 五类角色每类各有 large/medium/small。把文本映射到角色绝不为每个屏幕手挑字号。Roboto 是系统字体android-typo-system-font通过字体阶梯主题化品牌字体保证正文、标签与控件清晰一致。sp 单位而非固定 pxandroid-typo-scalable-sp让字号跟随系统字体大小设置。后者直接呼应audit.native.md的可访问性检查项“固定 point 大小破坏了 Dynamic TypeiOS或使用 px 而非 spAndroid的布局在放大字号时被裁剪或重叠”skill/reference/audit.native.md。这也是后续验证环节中font_scale 1.3检查的意义所在。色彩与主题化从角色 token 到 Dynamic Color 与色调高度Material 色彩角色android-color-role-tokensprimary、on-primary、surface、surface-variant、secondary-container、outline、error。角色 token 会自动解析亮色/暗色与对比度变体裸 hex 色值在这些场景下会失效。Dynamic ColorMaterial Youandroid-color-dynamic-color在合适的场景下从 Android 12 的用户壁纸派生配色方案并提供静态回退方案。深色主题是一等方案android-color-dark-theme要真正设计与测试深色主题绝不做快速的取反。色调高度android-color-tonal-elevation通过标准的 surface 色调等级传达高度感必要时辅以阴影不用任意的投影。audit.native.md的 “Appearance Theming” 维度逐条对应裸 hex 代替 Material 色彩角色/设计 token、缺少深色变体、无静态回退的 Dynamic Color、以及用手搓的视觉材质代替系统材质或 tonal elevation均属于硬编码与主题化缺陷skill/reference/audit.native.md。组件与动效Material 组件、单一 FAB、Snackbar 与四种动效模式Material 组件android-components-materialfilled / tonal / outlined / text 四类按钮、FAB、开关、chips、Snackbar、底部弹层bottom sheets、Material 对话框、导航栏/抽屉。绝不复刻 iOS 控件也不自行发明等价物。单一 FAB 单一主操作android-components-single-fab绝不堆叠 FAB也不把 FAB 花在次要任务上。Snackbar 用于瞬时反馈android-components-snackbar需要时携带操作项但绝不用 toast 替代只有必须打断的决策才用对话框。Material 动效模式android-motion-material-and-reducecontainer transform、shared-axis、fade-through配标准缓动与时长当系统开启“移除动画”Remove animations设置时降级为交叉淡化或瞬时切换。动效的可访问性在audit.native.md中同样被列为检查点“忽略 Reduce Motion——视差和大幅滑动没有交叉淡化替代”skill/reference/audit.native.md。验证构建adb 驱动的截图取证流程这是本参考文档最具实操价值的部分Android 的验证截图必须来自模拟器或连接的真机绝不允许来自浏览器。完整流程如下构建并安装然后用adb exec-out screencap -p path截图多台设备连接时用adb -s serial指定设备。覆盖所有发布目标设备类别至少一台手机若平板是发布目标再截一台平板。截图文件写入审查流程review flow期望的路径。深色主题与字体缩放属于必测项这是固定布局最常见的翻车点# 切换深色主题 adb shell cmd uimode night yes # 放大字体到 1.3 倍捕获固定布局隐藏的裁剪标签 adb shell settings put system font_scale 1.3 # 验证完毕后恢复 adb shell settings put system font_scale 1.0多台目标设备连接时上述命令同样需要带上-s serial。最后一条原则关乎证据诚实性android-verify-hardware-honesty模拟器能提供覆盖面但手势、刷新率与性能需要真实硬件——审查产出物必须说明证据来自哪一种。参考文档在 Impeccable 工作流中的落点该 Android 参考不是孤立的规范文本而是被 Impeccable 的命令体系直接引用的裁决依据上下文加载impeccable context会在适用时加载原生平台指南见 skill/SKILL.src.mdinit在平台被记录为ios/android/adaptive时会自行加载对应的原生平台参考skill/SKILL.src.md。原生审计audit.native从源码SwiftUI / UIKit / Compose / React Native / Flutter评分并明确“针对平台参考评分ios.md / android.mdadaptive 两者都要读”(skill/reference/audit.native.md)其“Platform Conformance”维度直接内置了 slop test 的操作化版本。原生适配adapt.native在规划前读取目标平台参考并要求“当适配在每个上下文里都显得原生时交给 impeccable polish 做最终打磨”skill/reference/adapt.native.md。测试证据仓库的 oracle 黄金夹具中可见平台字段如何被解析——Platform: Android解析为platform: androidios, android解析为adaptive参见 tests/oracle/golden/context-android.json 与 tests/oracle/golden/context-adaptive.json说明“原生平台 vs 自适应平台”的分流在引擎层是真实生效的。结语把 Material 3 当规则书而不是建议总结这份 Android 平台参考的核心主张在 Android 硬件上Material Design 3 是结构、导航与交互的唯一规则书品牌通过它的主题化层表达slop test 是验收门槛48 dp 触控目标、sp 字号、色彩角色、tonal elevation、Material 组件与动效是具体落点而验证必须回到模拟器/真机用adb exec-out screencap取证并把深色主题与 1.3 倍字体缩放纳入每个通过pass。这套规范与验证闭环构成了 Impeccable 在 Android 原生面上“让设计经得起推敲”的底线。【免费下载链接】impeccableThe design language that makes your AI harness better at design.项目地址: https://gitcode.com/GitHub_Trending/im/impeccable创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Impeccable Android 平台设计指南：以 Material 3 为准绳的原生 Android 界面审查与验证实践
Impeccable Android 平台设计指南以 Material 3 为准绳的原生 Android 界面审查与验证实践【免费下载链接】impeccableThe design language that makes your AI harness better at design.项目地址: https://gitcode.com/GitHub_Trending/im/impeccableAndroid 原生界面Jetpack Compose、Android Views、React Native、Expo、Flutter如何在保持品牌表达的同时获得“像原生一样”的信任感本指南以 Impeccable 设计技能库中的 Android 平台参考文档 为骨架系统讲解 Material Design 3 框架下的布局、触控、排版、色彩、动效规范以及基于 adb 的真机/模拟器截图验证流程。读完本文你将掌握一套可直接执行的 Android 平台设计检查清单与命令行验证方案并了解它在 Impeccable 审计、适配工作流中的具体落点。适用范围与核心原则访客模式下 Material 3 是唯一规则书该参考文档面向所有最终运行在 Android 硬件上的原生应用Jetpack Compose、Android Views、React Native、Expo、Flutter 均在其列。它的核心前提是一个贯穿 Impeccable 设计体系的“访客模式”visitor mode概念访客模式收窄了表达层可以覆盖的范围——即结构、导航与交互在每种模式下都必须由 Material Design 3 管辖品牌只能通过 Material 的主题化机制color roles 色彩角色、type scale 字体阶梯、shape 形状、motion 动效来表达自己而不是绕过平台规范另起炉灶。这里有一个容易被忽视的边界一个“处处 Material”的跨平台应用如果同时发布到 iPhone那么在 iOS 硬件上它仍然欠 iOS 一份操作系统级的保证——安全区 insets、Reduce Motion减弱动态效果、边缘滑动返回edge-swipe back。这正是 iOS 平台参考 所管辖的范围。从仓库中可以看到Impeccable 将这类平台知识组织成“参考文档”reference体系init命令在记录到平台为ios、android或adaptive时会自行加载对应的原生平台参考见 skill/SKILL.src.mdaudit.native与adapt.native也都会在开始前读取目标平台参考文档作为评分与规划依据见 skill/reference/audit.native.md 与 skill/reference/adapt.native.md。The Android slop test一眼识破“披着 Android 皮的 iOS 应用”“Android slop test”Android 廉价移植测试是该参考文档的验收门槛一个熟练的 Android 用户会信任这个应用还是在偏离规格的组件上绊倒最常见的失败信号恰恰是“披着 Android 皮肤的 iOS 应用”照抄 iPhone 的仅底部导航bottom-only navigation存在无视系统返回手势的后退箭头back arrow that ignores the system Back gesture出现Cupertino 形状的开关和对话框Cupertino-shaped switches and dialogs。结论很明确Material 3 是规则书跟随它的组件并通过它来主题化品牌。在 audit.native.md 的“Platform ConformanceCRITICAL”维度中这一测试被操作化为具体扣分项——预测性返回被劫持predictive Back hijacked、Web 形状控件web-shaped controls、图标漂移混合图标集而非 Material Symbols、iOS 模式出现在 Android 上等。而在 adapt.native.md 的“平台到平台”迁移表中iOS ↔ Android 惯用法被一一翻译而不是移植Tab bar ↔ Navigation bar / rail / drawer边缘滑动返回 ↔ 预测性 Back 手势/按钮Switch/segmented control ↔ Material switch/chips/Material pickersAction sheet ↔ Bottom sheet/Material dialogSF Symbols/SF Pro/Dynamic Type ↔ Material Symbols/Roboto/sp 缩放语义系统色/material ↔ Material color roles/tonal elevation系统 push/sheet 转场 ↔ container transform/shared-axis/fade-through。布局与结构从导航形态到窗口 insets 的四个硬性要求布局层面的规则在文档中以带规则 ID 的检查项呈现这些 ID 同时是审计时可直接引用的规则标识Material 导航需与屏幕尺寸匹配android-layout-adaptive-nav窄屏compact width使用底部导航栏navigation bar3–5 个目的地宽屏expanded width切换为导航栏抽屉navigation rail或抽屉drawer。绝不允许把手机的底部栏原封不动地搬到平板上。系统返回必须始终可用android-layout-system-back尊重预测性 Back 手势与返回按钮绝不困住用户或劫持该手势。边到边渲染配合窗口 insetsandroid-layout-window-insets应用状态栏、导航栏、刘海/挖孔display cutout与 IME输入法insets确保内容永远不会藏在系统栏或键盘后面。顶部应用栏top app bar提供屏幕上下文当屏幕只有一个主操作时搭配一个 FAB。值得强调的是adapt.native.md的补充视角平板适配的关键是从window size classes窗口尺寸类驱动结构而非机型判断并且“多窗口multi-window是一种尺寸不是边缘情况”——Android 多窗口可以把手机宽度的窗口放到平板上尺寸类驱动的布局可以免费处理这一切skill/reference/adapt.native.md。触控目标48×48 dp 与 8 dp 间距底线文档给出单一但明确的标准规则 IDandroid-touch-target-48dp每个触控目标最小48×48 dp目标之间至少8 dp间距。对比 iOS 参考文档的 44×44 pt可看出平台差异被严格区分。在audit.native.md的“Accessibility”维度中触控目标低于 48 dpAndroid或 44 ptiOS、以及目标拥挤无间距都是明确的扣分项skill/reference/audit.native.md。排版Material 字体阶梯、系统字体与 sp 可缩放单位排版规则对应三个规则 IDMaterial 字体阶梯android-typo-type-scale使用 Display、Headline、Title、Body、Label 五类角色每类各有 large/medium/small。把文本映射到角色绝不为每个屏幕手挑字号。Roboto 是系统字体android-typo-system-font通过字体阶梯主题化品牌字体保证正文、标签与控件清晰一致。sp 单位而非固定 pxandroid-typo-scalable-sp让字号跟随系统字体大小设置。后者直接呼应audit.native.md的可访问性检查项“固定 point 大小破坏了 Dynamic TypeiOS或使用 px 而非 spAndroid的布局在放大字号时被裁剪或重叠”skill/reference/audit.native.md。这也是后续验证环节中font_scale 1.3检查的意义所在。色彩与主题化从角色 token 到 Dynamic Color 与色调高度Material 色彩角色android-color-role-tokensprimary、on-primary、surface、surface-variant、secondary-container、outline、error。角色 token 会自动解析亮色/暗色与对比度变体裸 hex 色值在这些场景下会失效。Dynamic ColorMaterial Youandroid-color-dynamic-color在合适的场景下从 Android 12 的用户壁纸派生配色方案并提供静态回退方案。深色主题是一等方案android-color-dark-theme要真正设计与测试深色主题绝不做快速的取反。色调高度android-color-tonal-elevation通过标准的 surface 色调等级传达高度感必要时辅以阴影不用任意的投影。audit.native.md的 “Appearance Theming” 维度逐条对应裸 hex 代替 Material 色彩角色/设计 token、缺少深色变体、无静态回退的 Dynamic Color、以及用手搓的视觉材质代替系统材质或 tonal elevation均属于硬编码与主题化缺陷skill/reference/audit.native.md。组件与动效Material 组件、单一 FAB、Snackbar 与四种动效模式Material 组件android-components-materialfilled / tonal / outlined / text 四类按钮、FAB、开关、chips、Snackbar、底部弹层bottom sheets、Material 对话框、导航栏/抽屉。绝不复刻 iOS 控件也不自行发明等价物。单一 FAB 单一主操作android-components-single-fab绝不堆叠 FAB也不把 FAB 花在次要任务上。Snackbar 用于瞬时反馈android-components-snackbar需要时携带操作项但绝不用 toast 替代只有必须打断的决策才用对话框。Material 动效模式android-motion-material-and-reducecontainer transform、shared-axis、fade-through配标准缓动与时长当系统开启“移除动画”Remove animations设置时降级为交叉淡化或瞬时切换。动效的可访问性在audit.native.md中同样被列为检查点“忽略 Reduce Motion——视差和大幅滑动没有交叉淡化替代”skill/reference/audit.native.md。验证构建adb 驱动的截图取证流程这是本参考文档最具实操价值的部分Android 的验证截图必须来自模拟器或连接的真机绝不允许来自浏览器。完整流程如下构建并安装然后用adb exec-out screencap -p path截图多台设备连接时用adb -s serial指定设备。覆盖所有发布目标设备类别至少一台手机若平板是发布目标再截一台平板。截图文件写入审查流程review flow期望的路径。深色主题与字体缩放属于必测项这是固定布局最常见的翻车点# 切换深色主题 adb shell cmd uimode night yes # 放大字体到 1.3 倍捕获固定布局隐藏的裁剪标签 adb shell settings put system font_scale 1.3 # 验证完毕后恢复 adb shell settings put system font_scale 1.0多台目标设备连接时上述命令同样需要带上-s serial。最后一条原则关乎证据诚实性android-verify-hardware-honesty模拟器能提供覆盖面但手势、刷新率与性能需要真实硬件——审查产出物必须说明证据来自哪一种。参考文档在 Impeccable 工作流中的落点该 Android 参考不是孤立的规范文本而是被 Impeccable 的命令体系直接引用的裁决依据上下文加载impeccable context会在适用时加载原生平台指南见 skill/SKILL.src.mdinit在平台被记录为ios/android/adaptive时会自行加载对应的原生平台参考skill/SKILL.src.md。原生审计audit.native从源码SwiftUI / UIKit / Compose / React Native / Flutter评分并明确“针对平台参考评分ios.md / android.mdadaptive 两者都要读”(skill/reference/audit.native.md)其“Platform Conformance”维度直接内置了 slop test 的操作化版本。原生适配adapt.native在规划前读取目标平台参考并要求“当适配在每个上下文里都显得原生时交给 impeccable polish 做最终打磨”skill/reference/adapt.native.md。测试证据仓库的 oracle 黄金夹具中可见平台字段如何被解析——Platform: Android解析为platform: androidios, android解析为adaptive参见 tests/oracle/golden/context-android.json 与 tests/oracle/golden/context-adaptive.json说明“原生平台 vs 自适应平台”的分流在引擎层是真实生效的。结语把 Material 3 当规则书而不是建议总结这份 Android 平台参考的核心主张在 Android 硬件上Material Design 3 是结构、导航与交互的唯一规则书品牌通过它的主题化层表达slop test 是验收门槛48 dp 触控目标、sp 字号、色彩角色、tonal elevation、Material 组件与动效是具体落点而验证必须回到模拟器/真机用adb exec-out screencap取证并把深色主题与 1.3 倍字体缩放纳入每个通过pass。这套规范与验证闭环构成了 Impeccable 在 Android 原生面上“让设计经得起推敲”的底线。【免费下载链接】impeccableThe design language that makes your AI harness better at design.项目地址: https://gitcode.com/GitHub_Trending/im/impeccable创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考