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()。
