Radial GradientDrawable兼容问题
在android中可以使用<shape/>标签方便实现图形Drawable，<shape/>标签对应的class类是GradientDrawable。如果要实现一个圆形的阴影效果，可以使用下面的xml代码：
<!-- radial shadow drawable -->
<?xml version="1.0" encoding="utf-8"?>
<shape xmlns:android="http://schemas.android.com/apk/res/android"
android:shape="oval">
<gradient
android:centerX="0.5"
android:centerY="0.5"
android:endColor="@android:color/transparent"
android:gradientRadius="50"
android:startColor="#2b2b2b"
android:type="radial"/>
</shape>
<gradient/>标签实现了渐变效果，android:type="radial"表示圆形类型，另外还有linear,sweep。linear表示线性渐变，sweep则是类似雷达扫描的渐变。这里只探讨radial类型的情况。
android:gradientRadius是渐变半径值，必须设置该值才能实现圆形渐变效果。而不同SDK API版本下从xml解析该属性值的实现不同，也导致了本文所说的兼容性问题。
在Drawable Xml资源文件解析过程一文中，xml的解析最后会在drawable.inflate()中完成。下面是GradientDrawable.inflate()方法的实现，这里只关注对android:gradientRadius的解析。
// SDK 19 KITKAT 4.4
// xml解析
TypedValue tv = a.peekValue(com.android.internal.R.styleable.GradientDrawableGradient_gradientRadius);
if (tv != null) {
boolean radiusRel = tv.type == TypedValue.TYPE_FRACTION;
st.mGradientRadius = radiusRel ?
tv.getFraction(1.0f, 1.0f) : tv.getFloat();
} else if (gradientType == RADIAL_GRADIENT) {
throw new XmlPullParserException(a.getPositionDescription()
+ "<gradient> tag requires 'gradientRadius' "
+ "attribute with radial type");
}
// 绘制
mFillPaint.setShader(new RadialGradient(x0, y0,
level * st.mGradientRadius, colors, null,
Shader.TileMode.CLAMP));
/*
可以看到，如果type设置为radial，但没有设置gradientRadius会抛出异常；
而gradientRadius可以使用Fraction、Float格式，并且直接以px单位使用了该值。
虽然可以使用Fraction，但并不支持*%，*%p格式。
*/
// SDK 21 LOLLIPOP 5.0
// xml解析
final TypedValue tv = a.peekValue(R.styleable.GradientDrawableGradient_gradientRadius);
if (tv != null) {
final float radius;
final int radiusType;
if (tv.type == TypedValue.TYPE_FRACTION) {
radius = tv.getFraction(1.0f, 1.0f);
final int unit = (tv.data >> TypedValue.COMPLEX_UNIT_SHIFT)
& TypedValue.COMPLEX_UNIT_MASK;
if (unit == TypedValue.COMPLEX_UNIT_FRACTION_PARENT) {
radiusType = RADIUS_TYPE_FRACTION_PARENT;
} else {
radiusType = RADIUS_TYPE_FRACTION;
}
} else {
radius = tv.getDimension(r.getDisplayMetrics());
radiusType = RADIUS_TYPE_PIXELS;
}
st.mGradientRadius = radius;
st.mGradientRadiusType = radiusType;
} else if (st.mGradient == RADIAL_GRADIENT) {
throw new XmlPullParserException(
a.getPositionDescription()
+ "<gradient> tag requires 'gradientRadius' "
+ "attribute with radial type");
}
// 绘制
float radius = st.mGradientRadius;
if (st.mGradientRadiusType == RADIUS_TYPE_FRACTION) {
radius *= Math.min(st.mWidth, st.mHeight);
} else if (st.mGradientRadiusType == RADIUS_TYPE_FRACTION_PARENT) {
radius *= Math.min(r.width(), r.height());
}
if (st.mUseLevel) {
radius *= getLevel() / 10000.0f;
}
mGradientRadius = radius;
/*
5.0中gradientRadius可以使用Fraction、Dimension格式，并且真正支持了Fraction百分比格式(*%, *%p)。
但却不能使用Float格式，Float格式将被解析为Dimension，导致效果不符合预期，5.1中解决了这个问题。
*/
// SDK 22 LOLLIPOP_MR1 5.1
// xml解析
final TypedValue tv = a.peekValue(R.styleable.GradientDrawableGradient_gradientRadius);
if (tv != null) {
final float radius;
final int radiusType;
if (tv.type == TypedValue.TYPE_FRACTION) {
radius = tv.getFraction(1.0f, 1.0f);
final int unit = (tv.data >> TypedValue.COMPLEX_UNIT_SHIFT)
& TypedValue.COMPLEX_UNIT_MASK;
if (unit == TypedValue.COMPLEX_UNIT_FRACTION_PARENT) {
radiusType = RADIUS_TYPE_FRACTION_PARENT;
} else {
radiusType = RADIUS_TYPE_FRACTION;
}
} else if (tv.type == TypedValue.TYPE_DIMENSION) {
radius = tv.getDimension(r.getDisplayMetrics());
radiusType = RADIUS_TYPE_PIXELS;
} else {
radius = tv.getFloat();
radiusType = RADIUS_TYPE_PIXELS;
}
st.mGradientRadius = radius;
st.mGradientRadiusType = radiusType;
} else if (st.mGradient == RADIAL_GRADIENT) {
throw new XmlPullParserException(
a.getPositionDescription()
+ "<gradient> tag requires 'gradientRadius' "
+ "attribute with radial type");
}
// 绘制
float radius = st.mGradientRadius;
if (st.mGradientRadiusType == RADIUS_TYPE_FRACTION) {
// Fall back to parent width or height if intrinsic
// size is not specified.
final float width = st.mWidth >= 0 ? st.mWidth : r.width();
final float height = st.mHeight >= 0 ? st.mHeight : r.height();
radius *= Math.min(width, height);
} else if (st.mGradientRadiusType == RADIUS_TYPE_FRACTION_PARENT) {
radius *= Math.min(r.width(), r.height());
}
/*
5.1解决了5.0的问题，可以支持Float格式数据，并且优化了‘*%’格式下自身size未指定时的情况。
*/
总结：
设置android:gradientRadius属性值时：
Api 21以下：只能使用Float格式数据。%、%p、dimension格式没有预期效果；
Api 21时：只能使用Fraction(%,%p)、Dimension格式数据。不能使用Float数据，否则Float会被解析为Dimension，显示错误。drawable自身size未指定时，使用%格式不会显示；
Api 22及以上：可以正常使用Float、Dimension、％、％p格式。
(float值使用时单位为px)
