Android：自定义带圆角CardView的Map Marker圆角丢失问题排查

嘿，我之前也踩过一模一样的坑！咱们先搞清楚为啥CardView的圆角会凭空消失：

问题根源 #

CardView的圆角不是直接画出来的，是靠系统的Outline裁剪机制实现的——简单说就是给View套了个圆角的“遮罩”。但你直接用Canvas把View转成Bitmap的时候，默认不会触发这个裁剪机制，相当于把遮罩去掉了，自然就变成方形了。另外还有几个容易忽略的小细节：

• 转Bitmap时，View可能还没完成测量和布局，圆角参数根本没生效
• 生成Bitmap用了不支持透明的格式，圆角的透明区域被填充成了背景色
• CardView本身没开clipToOutline属性，或者圆角半径设得太小没看出来

一步步修复 #

1. 先让View“准备好”再转Bitmap #

在生成Bitmap之前，必须让自定义Marker View先完成测量和布局，不然尺寸和圆角都是错的：

// 加载你的自定义Marker布局
val markerView = LayoutInflater.from(context).inflate(R.layout.your_marker_layout, null)
// 手动指定宽高，也可以根据内容自适应，这里举个固定值的例子
val widthSpec = View.MeasureSpec.makeMeasureSpec(200, View.MeasureSpec.EXACTLY)
val heightSpec = View.MeasureSpec.makeMeasureSpec(150, View.MeasureSpec.EXACTLY)
markerView.measure(widthSpec, heightSpec)
// 布局View，确定最终位置和尺寸
markerView.layout(0, 0, markerView.measuredWidth, markerView.measuredHeight)

2. 用正确的方式生成Bitmap #

别自己手动写Canvas绘制了，AndroidX提供的drawToBitmap()扩展方法会自动处理Outline裁剪问题，直接用就行：

// 一行代码搞定带圆角的Bitmap
val bitmap = markerView.drawToBitmap()
// 生成Map Marker
val markerOptions = MarkerOptions().icon(BitmapDescriptorFactory.fromBitmap(bitmap))

如果没用到AndroidX，手动实现的话记得开启硬件加速的离屏缓冲：

// 开启硬件层，让系统自动处理圆角裁剪
markerView.setLayerType(View.LAYER_TYPE_HARDWARE, null)
// 创建支持透明通道的Bitmap
val bitmap = Bitmap.createBitmap(markerView.width, markerView.height, Bitmap.Config.ARGB_8888)
val canvas = Canvas(bitmap)
markerView.draw(canvas)
// 用完记得关掉硬件层，避免性能损耗
markerView.setLayerType(View.LAYER_TYPE_NONE, null)

3. 检查CardView的布局属性 #

确保你的CardView配置没毛病，这步很容易忘：

<androidx.cardview.widget.CardView
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    app:cardCornerRadius="16dp" <!-- 设个明显的圆角值，别太小 -->
    app:cardElevation="4dp"
    android:clipToOutline="true"> <!-- 这个必须开！不然裁剪不生效 -->

    <!-- 内部的ImageView和其他子布局 -->
</androidx.cardview.widget.CardView>

要是还在用旧版support包的CardView，建议换成AndroidX版本，兼容性好太多。

4. 别用不支持透明的Bitmap格式 #

生成Bitmap时一定要用ARGB_8888格式，它支持透明通道，圆角的空白区域才会显示透明，不会变成方形背景：

val bitmap = Bitmap.createBitmap(width, height, Bitmap.Config.ARGB_8888)

绝对别用RGB_565，它不支持透明，会把圆角区域填上默认背景色。

总结 #

说白了就是CardView的圆角裁剪没被Bitmap绘制过程正确识别，只要让View先完成布局，用支持裁剪的方式生成Bitmap，再检查下CardView的关键属性，问题就能解决啦！

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