Android的shape drawable是开发中最常用的背景绘制方式之一，其中gradient标签可以实现颜色渐变效果。很多同学只知道设置startColor和endColor，却不清楚type属性决定了渐变的形态。实际上gradient一共支持三种type：linear线性渐变、radial放射渐变和sweep扫描渐变，三者的视觉效果和使用参数差异很大。本文将逐一讲解这三种渐变的XML配置方法，并给出实际场景中的应用示例。
一、gradient标签的基础属性与type的作用
gradient标签必须放在shape标签内部，一个完整的渐变背景通常包含以下几个关键属性。首先是三个颜色值：startColor表示渐变起始颜色，centerColor表示中间颜色（可选），endColor表示结束颜色。如果只设置startColor和endColor，渐变会在两个颜色之间线性过渡；设置centerColor后，颜色过渡会经过中间色，可以做出更丰富的层次感，比如从深蓝到浅蓝再到深蓝的水波效果。
type属性是渐变形态的决定性参数，它有三个可选值：linear（线性渐变，默认值）、radial（放射渐变）和sweep（扫描渐变）。如果不显式指定type，系统默认按linear处理，这也是为什么很多开发者写了radial相关的参数却发现不生效的原因之一。除了type之外，angle属性只对linear类型有效，用于指定渐变的角度，必须是45的整数倍，比如0表示从左到右，90表示从下到上，270表示从上到下。gradientRadius只对radial类型有效，表示放射渐变的半径，可以使用像素值也可以使用百分比。
下面是一个最基础的linear渐变shape文件，放在res/drawable目录下即可使用：
<?xml version="1.0" encoding="utf-8"?>
<shape xmlns:android="http://schemas.android.com/apk/res/android"
android:shape="rectangle">
<gradient
android:type="linear"
android:angle="270"
android:startColor="#1E90FF"
android:centerColor="#87CEFA"
android:endColor="#FFFFFF" />
<corners android:radius="12dp" />
</shape>这个例子实现了一个从上到下的蓝色渐变按钮背景。需要注意的是angle的基准方向：0度是从左向右，角度逆时针递增，所以90度是从下向上，270度才是从上向下。如果angle填了非45倍数的值，在某些版本上会直接抛出异常。
二、radial放射渐变的配置与常见问题
radial渐变是以某个中心点为圆心，从内向外呈圆形扩散的颜色过渡，常用于做光晕效果、圆形按钮的立体感或者加载动画的背景。它的核心参数是gradientRadius，指定渐变半径。中心点位置由centerX和centerY控制，取值范围是0到1的相对比例，默认都是0.5，也就是控件的几何中心。
下面是一个典型的放射渐变示例，模拟一个中心发亮的光球效果：
<?xml version="1.0" encoding="utf-8"?>
<shape xmlns:android="http://schemas.android.com/apk/res/android"
android:shape="oval">
<gradient
android:type="radial"
android:centerX="0.5"
android:centerY="0.5"
android:gradientRadius="60dp"
android:startColor="#FFFFCC"
android:centerColor="#FFAA33"
android:endColor="#FF6600" />
</shape>这里有个常见的坑：如果gradientRadius设置的值小于控件的实际半径，超出部分会直接填充endColor，看起来像渐变被截断了；如果值过大，渐变会被拉伸得很平缓。建议使用时让gradientRadius略大于控件半径，例如控件是120dp的圆，半径可以设为70dp左右，这样边缘过渡更自然。
另外要注意，shape的形状会影响放射渐变的呈现。如果shape是rectangle，渐变仍然是圆形扩散，但会被矩形的裁剪区域切掉四角，做卡片背景光晕时可以利用这个特性。还有一个进阶技巧：从API 24开始，如果需要更灵活的动态效果，可以考虑代码创建RadialGradient，它支持多色渐变数组和位置数组，比XML的表达能力更强。
三、sweep扫描渐变的写法与应用场景
sweep渐变也叫角度渐变，颜色沿着圆周方向从起始角度开始顺时针扫过一圈。它最常见的应用场景是雷达扫描动画、仪表盘表盘、进度环等。sweep类型不需要设置angle和gradientRadius，因为它的过渡方向固定是沿圆周，颜色分布由startColor、centerColor、endColor在整个圆周上的位置决定。
一个扫描渐变的基础写法如下：
<?xml version="1.0" encoding="utf-8"?>
<?xml version="1.0" encoding="utf-8"?>
<shape xmlns:android="http://schemas.android.com/apk/res/android"
android:shape="ring"
android:innerRadiusRatio="3"
android:thicknessRatio="10"
android:useLevel="false">
<gradient
android:type="sweep"
android:startColor="#00000000"
android:centerColor="#660000FF"
android:endColor="#FF0000FF" />
</shape>这个示例配合ring形状可以做出一个进度环，透明起始色到蓝色的过渡让进度有一种渐渐消失的尾部效果，类似各类下载进度条的视觉风格。这里有个细节必须提醒：使用ring形状时，useLevel要设为false，否则默认会根据LevelDrawable的level值来裁剪显示，直接设置background会看不到任何内容，这是很多人第一次写ring时踩过的坑。
还有一点需要注意，sweep渐变的起始位置固定在圆的最右侧也就是3点钟方向，如果需要改变起始角度，单纯靠XML做不到，需要外层套一个rotate标签旋转，或者用代码创建SweepGradient。例如雷达扫描效果通常是给sweep渐变的shape外面包一层rotate动画，让整个渐变旋转起来实现扫描的动态感。
四、三种渐变的对比与选择建议
三者的核心区别可以简单总结为：linear沿直线方向过渡，适合按钮、卡片、标题栏背景；radial从中心向外扩散，适合光晕、聚焦点、圆形控件；sweep沿圆周过渡，适合进度环、雷达、表盘。选择时先看视觉需求的方向性，再考虑控件形状。
最后补充几个实用建议。第一，渐变颜色数量尽量控制在两到三个，颜色过多容易显得杂乱，而且centerColor位置可以通过centerX和centerY微调。第二，做暗色主题渐变时，建议两端颜色明度差不要太大，否则视觉割裂感明显。第三，如果渐变需要跟随状态变化，比如按压时变色，可以配合selector使用，将gradient shape作为item的drawable。第四，复杂的多点渐变XML表达不了时，不要硬套shape，改用自定义View配合LinearGradient或SweepGradient绘制会更灵活。掌握这些细节后，绝大多数界面渐变需求都可以用一份简洁的shape XML搞定，无需引入任何图片资源，还能有效减小安装包体积。
Android shapegradient typeXML渐变修改时间：2026-09-07 08:44:37