Android使用ContentResolver创建GIF文件时文件名与扩展名未正确设置的问题解决

我刚看了你的代码，问题出在这几个细节上：你只设置了DISPLAY_NAME，但没明确指定文件的MIME类型，Android系统会默认按JPG格式识别处理，所以自动篡改了扩展名；另外在Android Q及以上版本，MediaStore的文件管理逻辑有变化，光设置文件名还不够，得配合几个关键字段来确保系统尊重你的命名。

下面是修复后的完整代码，我标了核心修改点：

val fileName = "mygif.gif"
val resolver = applicationContext.contentResolver

val mediaUri = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
    MediaStore.Images.Media.getContentUri(MediaStore.VOLUME_EXTERNAL_PRIMARY)
} else {
    MediaStore.Images.Media.EXTERNAL_CONTENT_URI
}

val gifDetails = ContentValues().apply {
    // 1. 必须指定GIF的MIME类型，告诉系统这是GIF格式文件
    put(MediaStore.Images.Media.MIME_TYPE, "image/gif")
    put(MediaStore.Images.Media.DISPLAY_NAME, fileName)
    
    // 2. 可选：指定存储路径，让文件归类更规范，也降低系统修改文件名的概率
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
        put(MediaStore.Images.Media.RELATIVE_PATH, "Pictures/GIFs")
        // 3. 设置IS_PENDING为1，标记文件处于写入状态，避免系统中途篡改信息
        put(MediaStore.Images.Media.IS_PENDING, 1)
    }
}

resolver.insert(mediaUri, gifDetails)?.let { uri ->
    resolver.openOutputStream(uri)?.use { os ->
        // 在这里写入GIF的字节数据
    }?.run {
        // 写入完成后，把IS_PENDING改成0，让系统正常识别并显示这个文件
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
            val updateValues = ContentValues().apply {
                put(MediaStore.Images.Media.IS_PENDING, 0)
            }
            resolver.update(uri, updateValues, null, null)
        }
    }
}

关键细节说明： #

• MIME类型设置：image/gif是核心，这是告诉系统文件的真实格式，系统就不会随便把扩展名改成jpg了。
• RELATIVE_PATH（Q+）：指定文件存到Pictures/GIFs目录下，既方便用户在图库中找到，也让MediaStore更愿意保留你设置的文件名。
• IS_PENDING（Q+）：标记文件处于写入中状态，防止系统在你还没写完的时候就扫描并修改文件信息；写入完成后一定要改回0，否则文件可能不会在系统相册中显示。

另外注意：如果你的应用运行在Android 10（API 29）以下版本，要确保已经申请了WRITE_EXTERNAL_STORAGE权限，否则会出现写入失败的情况。

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