Android shape gradient centerX XML径向渐变中心X

radial gradient 的 centerx 是 0～1 的相对值，非像素；必须显式指定 gradientradius（单位 px）；centerx 基于 layer 自身尺寸而非容器；api 21 以下不支持 centerx，需代码适配。

radial gradient 的 centerX 是相对值，不是像素

android xml 径向渐变的 centerX（和 centerY）必须是 0～1 之间的浮点数，代表占整个 drawable 宽高比例的位置。写成 50 或 50dp 会直接导致解析失败、Resources$NotFoundException 或静默失效——系统根本不会报错，但渐变就是不按预期显示。

常见错误现象：centerX="0.5" 看起来居中，但实际偏左；centerX="1" 没跑到最右边缘；drawable 被用在 ImageView 且设置了 scaleType 后中心彻底“漂移”。

• centerX="0.5" 表示水平方向 50% 处，前提是 drawable 自身宽高被完整拉伸到容器尺寸（如 android:layout_width="match_parent" + scaleType="fitXY"）
• 如果 drawable 被缩放或居中显示（比如 scaleType="center"），centerX 仍按 drawable 本体尺寸算，不是容器尺寸
• 没有单位，不能写 "0.5dp"、"50%" 或整数 "50"，只接受纯小数（如 "0.33"）或整数 "0"/"1"

radial gradient 必须显式指定 gradientRadius

哪怕你只改 centerX，漏掉 gradientRadius 就会让整个 shape 失效（API 21+ 可能渲染为纯色，旧版本直接 crash）。这不是可选参数，是径向渐变的强制要求。

常见错误现象：XML 无报错，但运行时看到的是单色块而非渐变；Logcat 出现 Caused by: java.lang.UnsupportedOperationException: Can't convert to color: type=0x2（常因解析中途失败引发）。

• gradientRadius 也必须是数值，单位是 px（不是 dp），且建议用 @dimen/ 或硬编码数字，避免用 match_parent 类语义
• 值太小（如 1）→ 渐变收缩成一个点；太大（如超过 drawable 宽高两倍）→ 视觉上接近线性渐变
• 若需响应不同屏幕密度，应配合 values-mdpi/ 等资源目录提供对应 gradientRadius 值

centerX 在 layer-list 中的行为容易被误解

当你把 radial gradient 放进 layer-list，它的 centerX 依然以**当前 layer 自身尺寸**为基准，不是整个 layer-list 的合成区域。这意味着：如果该 layer 有 android:top、android:left 偏移，或者被 android:gravity 拉伸/对齐，centerX="0.5" 依然指这个 layer 的中间，而不是最终视觉中心。

使用场景：做带阴影/描边的按钮背景，主层是 radial gradient，底层是 solid 颜色。此时主层的 centerX 若设为 "0.5"，而它又被 android:gravity="center" 居中，那没问题；但如果主层 android:width="100dp" 且父容器是 200dp 宽，centerX="0.5" 就只在那 100dp 内居中，看起来偏左。

• 调试技巧：给该 layer 加个临时 android:stroke 边框，肉眼确认它的实际绘制范围
• 若需绝对坐标对齐（例如始终对齐父容器中心），别依赖 centerX，改用 android:background + 单独 drawable + scaleType 控制，或直接用 GradientDrawable 代码生成
• android:gravity 对 radial gradient 无效，它只影响 layer 的布局位置，不影响渐变内部坐标系

API 21+ 的 android:centerX 和旧版写法兼容性

从 Android 5.0（API 21）起，android:centerX 和 android:centerY 才被正式支持；低于 API 21 时，这些属性会被忽略，系统回退到默认中心（0.5, 0.5），且不报错。所以如果你的 minSdkVersion ，又需要非中心渐变，就得放弃 XML，改用代码创建 <code>GradientDrawable 并调用 setGradientCenter(Float x, float y)。

性能影响：XML 定义的 radial gradient 在 inflate 时解析一次，内存占用低；代码动态创建则每次都需要 new 对象，频繁切换状态（如按钮按下态）时要注意复用。

• 检查方式：在 res/values-v21/ 下单独放一份含 centerX 的 drawable，res/values/ 下放不含的备用版
• 不要试图用 tools:centerX 模拟效果——designer 不识别，且 runtime 完全无效
• 真机调试时，用 Layout Inspector 查看该 drawable 的实际 bounds，比凭空猜 centerX 值靠谱得多

事情说清了就结束。注意：XML 里所有 radial 相关属性都只认相对坐标和绝对像素，没有“自动适配”这回事，画布在哪、谁在画、怎么缩放——得自己一环环对齐。