Android Studio中Polyline渐变失效问题求助

你用的StyleSpan(StrokeStyle.gradientBuilder(...))是Android用于设置文本字符样式的API，完全不适用于地图折线绘制，这是导致只显示黑色的根本原因。下面针对主流场景给出渐变路线的实现方案：

方案1：Google Maps Android SDK 原生实现渐变折线 #

Google Maps SDK内置了渐变折线的支持，注意使用Maps SDK专属的StrokeStyle（别和文本样式的StrokeStyle混淆）：

// 构建渐变笔触样式
val gradientStroke = com.google.maps.android.data.geojson.StrokeStyle.gradientBuilder(
    listOf(Color.RED, Color.GREEN), // 渐变颜色序列
    listOf(0.0f, 1.0f) // 颜色对应折线的位置比例（0=起点，1=终点）
).build()

// 添加渐变折线到地图
val polyline = googleMap.addPolyline(
    PolylineOptions()
        .addAll(routeCoordinates) // routeCoordinates为路线坐标集合
        .width(12f) // 折线宽度
        .strokeStyle(gradientStroke)
)

方案2：分段绘制模拟渐变（适配其他地图SDK） #

如果所用地图SDK不原生支持渐变，可通过拆分折线为多段、逐段设置过渡色来模拟渐变：

val startColor = Color.RED
val endColor = Color.GREEN
val segmentCount = 50 // 分段数越多，渐变越平滑

// 计算RGB通道的颜色增量
val redDelta = (Color.red(endColor) - Color.red(startColor)) / segmentCount
val greenDelta = (Color.green(endColor) - Color.green(startColor)) / segmentCount
val blueDelta = (Color.blue(endColor) - Color.blue(startColor)) / segmentCount

// 遍历分段绘制折线
for (i in 0 until segmentCount) {
    val currentColor = Color.rgb(
        Color.red(startColor) + redDelta * i,
        Color.green(startColor) + greenDelta * i,
        Color.blue(startColor) + blueDelta * i
    )
    // 获取当前分段的起止坐标
    val startIdx = i * (routeCoordinates.size / segmentCount)
    val endIdx = (i + 1) * (routeCoordinates.size / segmentCount)
    val startPoint = routeCoordinates[startIdx]
    val endPoint = routeCoordinates[endIdx.coerceAtMost(routeCoordinates.size - 1)]
    
    // 调用对应地图SDK的折线添加方法
    map.addPolyline(
        PolylineOptions()
            .add(startPoint, endPoint)
            .width(12f)
            .color(currentColor)
    )
}

关键注意事项 #

• 严格区分Android文本样式API与地图SDK的图形样式API，二者无关联
• 渐变颜色与位置数组的长度必须一致，否则会触发样式 fallback（显示黑色）
• 分段绘制时，若路线坐标点数量不足，需做边界判断避免数组越界

内容的提问来源于stack exchange，提问作者KARTHIK