HarmonyOS5 便捷生活类——路径规划场景中绘制渐变颜色路径，颜色不生效问题如何解决-优快云博客

加入下方官方优快云班级，得鸿蒙礼盒

一起拿鸿蒙礼盒，戳我戳我！！

本期活动时间：2025年8月1日-12月31日

如有问题欢迎私聊我呀！

问题现象

地图两点之间需要绘制一条颜色渐变的多点折线，设置MapPolylineOptions.colors数组，渐变样式不生效。

效果预览

背景知识

初始化地图：新建地图初始化参数mapOptions，设置地图中心点坐标及层级。通过callback回调的方式获取MapComponentController对象，用来操作地图。调用MapComponent组件，传入mapOptions和callback参数，初始化地图。详见显示地图-创建地图-Map Kit（地图服务）-应用服务-华为HarmonyOS开发者 (huawei.com)。
绘制折线：新建折线时在MapPolylineOptions的colors属性中设置折线分段颜色值，详见折线-在地图上绘制-Map Kit（地图服务）-应用服务-华为HarmonyOS开发者 (huawei.com)。

定位思路

绘制渐变颜色的折线，首先要绘制折线，并设置折线的颜色渐变。这里渐变颜色不生效，可能是MapPolylineOptions.gradient或MapPolylineOptions.colors设置不正确。
MapPolylineOptions.gradient要设置为true，开启过渡色。MapPolylineOptions.colors数组长度要等于折线点数量，以确保每段折线都有过渡色。数组长度小于折线点数量会导致后半段折线缺少过渡色而显示默认颜色。

解决方案

MapPolylineOptions.colors 过渡段颜色数组，会按照折线点数量依次取色。MapPolylineOptions.gradient设置为true，两个折线点之间颜色会呈现过渡色。

import { map, mapCommon, MapComponent } from '@kit.MapKit'
import { AsyncCallback } from '@kit.BasicServicesKit';

// 地图折线点的坐标数组
const markers: Array<mapCommon.LatLng> =
[{ longitude: 121.47, latitude: 31.23 }, { longitude: 121.43, latitude: 31.18 },
{ longitude: 121.46, latitude: 31.13 }, { longitude: 121.43, latitude: 31.05 },
{ longitude: 121.34, latitude: 31.02 }]

@Entry
@Component
struct HwMapDrawPage {
private mapOption?: mapCommon.MapOptions; // 地图参数
private mapController?: map.MapComponentController; // 地图组件控制器
private callback?: AsyncCallback<map.MapComponentController>; // 地图初始化回调

aboutToAppear(): void {
this.mapOption = {
position: {
target: {
longitude: 121.47, latitude: 31.23 // 地图中心坐标
},
zoom: 11, // 屏幕中心的缩放级别
}
}

// 地图初始化的回调
this.callback = async (err, mapController) => {
if (!err) {
this.mapController = mapController;
}
}
}

build() {
Column() {
MapComponent({ mapOptions: this.mapOption, mapCallback: this.callback })
.width('100%')
.height('80%')
Column() {
Button('划线').onClick(async () => {
// 绘制颜色渐变折线
// polyline初始化参数
let polylineOption: mapCommon.MapPolylineOptions = {
points: markers, // 折线点坐标的数组
clickable: true, // 折线可点击
startCap: mapCommon.CapStyle.BUTT, // 折线起始顶点的样式
endCap: mapCommon.CapStyle.BUTT, // 折线结束顶点的样式
geodesic: false, // 折线线段是否为大地曲线
jointType: mapCommon.JointType.BEVEL, // 折线的线条拐角样式
visible: true,
width: 10,
zIndex: 10,
gradient: true, // 颜色过渡开启
colors: [0xffffff00, 0xff000000, 0xffCCCCCC, 0xffCF0983, 0xffee0000] // 过渡段颜色数组对应markers数组
// colors: [0xffffff00, 0xff000000] // 过渡段颜色数组数量少于折线点数量，后半段颜色无渐变效果
}
// 创建polyline
await this.mapController?.addPolyline(polylineOption);
})
Button('marker').onClick(async () => {
// 绘制多个坐标点的标记
for (let i = 0; i < markers.length; i++) {
// Marker初始化参数
let markerOptions: mapCommon.MarkerOptions = {
position: {
latitude: markers[i].latitude, // 标记点坐标
longitude: markers[i].longitude
},
rotation: 0, // 标记点旋转角度
visible: true,
zIndex: 0,
alpha: 0.9, // 标记点透明度
anchorU: 0.5, // 锚点水平坐标
anchorV: 1, // 锚点垂直坐标
clickable: true, // 是否可点击
draggable: true, // 是否可拖拽
flat: false // 是否平贴地图
};
await this.mapController?.addMarker(markerOptions)
}
})
}
}
.height('100%')
.width('100%')
}
}

总结

绘制渐变颜色需要注意以下几点：

显示地图要在AGC上开通地图服务，地图服务刚开通需24小时后生效。详见开发准备-Map Kit（地图服务）-应用服务-华为HarmonyOS开发者 (huawei.com)。
module.json5 配置client_id。打包使用手动签名，签名指纹要与AGC上一致。
折线参数gradient设置为true，colors数组长度要大于折线点个数以保证每段折线都有过渡色。