android gradient angle仅支持0/45/90/135/180/225/270/315八个离散值,非标准值如30°会被忽略并退化为0°;颜色alpha必须用八位十六进制(如#ffff0000)显式声明,否则默认全透明;shape需显式设置size或代码中调用setbounds();低版本必须显式声明android:type="linear";gradient为静态资源,颜色变更需mutate()或重新获取。

gradient 的 angle 属性只接受 0、45、90、135、180、225、270、315 这 8 个值
Android 的 <gradient></gradient> 在 XML 中不支持任意角度(比如 angle="30"),硬写非标准值会被忽略,退化为默认的 angle="0"(从左到右)。这是系统级限制,不是写法或版本问题。
实操建议:
- 必须用
android:angle="0"(左→右)、android:angle="90"(下→上)等离散值;android:angle="45"是左下→右上,不是“斜向 45°”的通用理解,方向由坐标系决定 - 如果真需要非标准角度(如 30°、60°),只能放弃
shape,改用BitmapDrawable预渲染,或在代码中用LinearGradient+Shader手动绘制 - 注意:角度值是逆时针旋转的——
android:angle="90"表示渐变方向是 90°,即垂直向上,对应颜色从底部色 → 顶部色
startColor / centerColor / endColor 的 alpha 值必须显式写十六进制(#AARRGGBB)
很多人写 android:startColor="#FF0000" 以为是红,结果发现透明——因为缺了 alpha 位,Android 会把三位/六位色值按 #RGB 或 #RRGGBB 解析,但默认 alpha=00(全透明)。这不是 bug,是解析规则。
实操建议:
- 一律用八位十六进制:不写
#FF0000,写#FFFF0000(不透明红);不写#00FF00,写#FF00FF00 -
centerColor不是必须项,但如果用了,它的 alpha 也得同样处理,否则中间段会意外变透明 - 如果想动态控制透明度,别在 XML 里拼,改用
Color.argb()在代码中生成再设给GradientDrawable
gradient 和 shape 的 size 必须显式声明,否则在不同控件中渲染异常
XML 中只写 <gradient></gradient> 不指定尺寸,会导致 GradientDrawable 初始 bounds 为 (0, 0, 0, 0),实际显示时拉伸行为不可控——按钮上看着正常,ImageView 里就糊成一片,甚至完全不出现。
实操建议:
- 在
<shape></shape>根节点下加<size android:width="100dp" android:height="100dp"></size>,数值按目标容器最小尺寸预估 - 更稳妥的做法是:不在 XML 里设固定 size,而是在代码中调用
drawable.setBounds(),比如在onDraw()或onSizeChanged()里同步控件尺寸 - 如果用于
background,且父容器尺寸不确定(如RecyclerViewitem),优先考虑用android:tileMode="disabled"防止重复平铺干扰渐变效果
API 24+ 的 android:type="linear" 是默认值,但低版本必须显式写
虽然文档说 type 默认是 linear,但实测在 API 21–23 上,省略 android:type="linear" 会导致整个 gradient 不生效(尤其搭配 angle 时),系统直接当无效属性跳过。
实操建议:
- 所有项目都显式加上
android:type="linear",不依赖默认行为 - 不要混用
android:centerX和android:angle:前者只对radial或sweep有效,和线性渐变无关;写了反而可能干扰渲染 - 如果要兼容深色模式或主题色变化,别把颜色硬编码在 XML,改用 ?attr/colorXXX 引用,但注意
GradientDrawable不支持运行时换色,需代码层重建 drawable
最常被忽略的一点:XML 里的 gradient 是静态资源,一旦 inflate 就固化。哪怕你改了 color 资源值,已加载的 drawable 不会自动更新——得手动 mutate() 再重设颜色,或者干脆重新 Context.getDrawable()。










