Android Compose中Image函数调用报错，导入指定包仍未解决

你按照Android Developers Codelab教程学习时，导入androidx.compose.foundation.Image后，调用Image组件仍出现参数不匹配错误，代码如下：

@Composable
fun GreetingImage(message: String, from: String, modifier: Modifier = Modifier){
    val image = painterResource(R.drawable.androidparty)
    Image(
        painter = image
    )
}

收到的错误信息：

None of the following functions can be called with the arguments supplied.
Image(ImageBitmap, String?, Modifier = ..., Alignment = ..., ContentScale = ..., Float = ..., ColorFilter? = ..., FilterQuality = ...) defined in androidx.compose.foundation
Image(Painter, String?, Modifier = ..., Alignment = ..., ContentScale = ..., Float = ..., ColorFilter? = ...) defined in androidx.compose.foundation
Image(ImageVector, String?, Modifier = ..., Alignment = ..., ContentScale = ..., Float = ..., ColorFilter? = ...) defined in androidx.compose.foundation

解决方法 #

错误原因是Image组件的contentDescription参数为必填项（即使它的类型是可空的String?，也必须显式传入），你需要给Image添加这个参数：

@Composable
fun GreetingImage(message: String, from: String, modifier: Modifier = Modifier){
    val image = painterResource(R.drawable.androidparty)
    Image(
        painter = image,
        contentDescription = "Android派对图片" // 传入有意义的图片描述，或传null
    )
}

• contentDescription主要用于无障碍服务（如屏幕阅读器），建议传入能描述图片内容的文本；如果是纯装饰性图片，可传入null。

内容的提问来源于stack exchange，提问作者Erkan Özkan