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值靠谱得多










