Android中分享图文时如何让ShareSheet显示图片预览

你的代码存在几个关键问题导致分享面板只显示文本预览，以下是修正方案：

问题分析 #

1. Action使用错误：单个图片分享应使用Intent.ACTION_SEND，ACTION_SEND_MULTIPLE是用于分享多个文件的场景
2. 参数传递错误：ACTION_SEND_MULTIPLE要求EXTRA_STREAM传入ArrayList<Uri>，而非单个Uri，这会导致系统无法正确识别图片资源
3. Type设置对象错误：你给外部的intent变量设置了type，而非实际用于分享的Intent实例

修正后的代码 #

1. 单个图片分享（优先显示图片预览） #

// 确保bitmapUri是合法的Uri，Android7+需用FileProvider生成，不能直接用file://
val bitmapUri = getImageUriViaFileProvider(path) 

val shareIntent = Intent(Intent.ACTION_SEND).apply {
    type = "image/*" // 设置MIME类型为图片，让系统优先识别图片预览
    putExtra(Intent.EXTRA_TEXT, "NcQAvD_BwE")
    putExtra(Intent.EXTRA_STREAM, bitmapUri)
    // 可选：添加FLAG_GRANT_READ_URI_PERMISSION确保接收方有权限访问Uri
    addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION)
}

val chooser = Intent.createChooser(shareIntent, null)
startActivity(chooser)

2. 若需分享多张图片（使用ACTION_SEND_MULTIPLE） #

val imageUris = arrayListOf<Uri>(
    getImageUriViaFileProvider(path1),
    getImageUriViaFileProvider(path2)
)

val shareIntent = Intent(Intent.ACTION_SEND_MULTIPLE).apply {
    type = "image/*"
    putExtra(Intent.EXTRA_TEXT, "NcQAvD_BwE")
    putParcelableArrayListExtra(Intent.EXTRA_STREAM, imageUris)
    addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION)
}

val chooser = Intent.createChooser(shareIntent, null)
startActivity(chooser)

3. FileProvider配置（Android7+必需） #

在AndroidManifest.xml中注册FileProvider：

<application>
    <provider
        android:name="androidx.core.content.FileProvider"
        android:authorities="${applicationId}.fileprovider"
        android:exported="false"
        android:grantUriPermissions="true">
        <meta-data
            android:name="android.support.FILE_PROVIDER_PATHS"
            android:resource="@xml/file_paths" />
    </provider>
</application>

在res/xml/file_paths.xml中配置可访问的文件路径：

<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <!-- 示例：分享应用私有目录下的图片 -->
    <files-path name="images" path="images/" />
    <!-- 若分享外部存储的图片，可使用external-path -->
    <!-- <external-path name="external_images" path="." /> -->
</paths>

生成合法Uri的工具方法 #

private fun getImageUriViaFileProvider(imagePath: String): Uri {
    val file = File(imagePath)
    return FileProvider.getUriForFile(
        this,
        "${packageName}.fileprovider",
        file
    )
}

关键注意点 #

• MIME类型优先级：设置type="image/*"会让系统优先展示图片预览，而非文本
• Uri权限：必须给Intent添加FLAG_GRANT_READ_URI_PERMISSION，否则接收应用无法访问图片资源
• Android版本兼容：Android7及以上禁止直接使用file://Uri，必须通过FileProvider生成content://类型的Uri

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