如何在App Widget中实现圆形图片？代码实现后出现白背景问题

问题分析 #

你通过Kotlin代码实现的圆形裁剪已经生效，但Widget中的ImageView默认带有白色背景，导致透明区域被白色填充，出现方形底色。结合Widget的限制（无法用AndroidX、ShapeableImageView故障），可以从布局配置、裁剪代码优化、RemoteViews设置三个维度解决。

1. 修正ImageView布局配置 #

打开Widget布局文件widget_layout.xml，找到目标ImageView（R.id.smarthutsLogo），添加以下属性确保背景透明：

<ImageView
    android:id="@+id/smarthutsLogo"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:background="@android:color/transparent"
    android:scaleType="centerCrop" />

• android:background="@android:color/transparent"：强制ImageView背景透明
• android:scaleType="centerCrop"：避免图片拉伸变形，适配圆形裁剪

2. 优化圆形裁剪代码 #

原代码未处理非正方形图片（会出现椭圆），且可强化透明通道处理。修改getCroppedBitmap函数：

@Throws(Exception::class)
fun getCroppedBitmap(bitmap: Bitmap): Bitmap {
    // 先将原图裁剪为正方形，确保最终是正圆
    val size = min(bitmap.width, bitmap.height)
    val xOffset = (bitmap.width - size) / 2
    val yOffset = (bitmap.height - size) / 2
    val squaredBitmap = Bitmap.createBitmap(bitmap, xOffset, yOffset, size, size)

    // 创建带透明通道的输出Bitmap
    val output = Bitmap.createBitmap(size, size, Bitmap.Config.ARGB_8888)
    val canvas = Canvas(output)
    val paint = Paint().apply {
        isAntiAlias = true
        isFilterBitmap = true
    }

    // 清空画布为全透明
    canvas.drawARGB(0, 0, 0, 0)
    // 绘制圆形遮罩
    canvas.drawCircle(
        (size / 2f),
        (size / 2f),
        (size / 2f),
        paint
    )
    // 仅保留圆形区域的原图内容
    paint.xfermode = PorterDuffXfermode(PorterDuff.Mode.SRC_IN)
    canvas.drawBitmap(squaredBitmap, 0f, 0f, paint)

    // 回收临时Bitmap，避免内存泄漏
    if (squaredBitmap != bitmap) squaredBitmap.recycle()

    return output
}

3. 强制RemoteViews设置透明背景 #

在onUpdate方法中，给ImageView额外设置透明背景，避免主题或系统默认背景干扰：

// 在setImageViewBitmap之前添加
view.setInt(R.id.smarthutsLogo, "setBackgroundColor", android.graphics.Color.TRANSPARENT)
view.setImageViewBitmap(R.id.smarthutsLogo, getCroppedBitmap(logoBitmap))

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