Android平台QML中获取图片绝对路径失败的求助

1. 先搞定存储权限 #

Android 6.0及以上得动态申请读写权限，先在AndroidManifest.xml里添加权限：

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<!-- Android 13及以上推荐用这个更细化的权限 -->
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />

然后在QML里用Qt的权限模块动态请求权限：

import QtQuick.Controls 2.15
import QtPermissions 1.1

ApplicationWindow {
    visible: true
    width: 640
    height: 480
    title: "Android QML App"

    Permission {
        id: storagePermission
        type: Permission.Storage
    }

    Component.onCompleted: {
        storagePermission.request()
    }

    Image {
        id: bgImage
        anchors.fill: parent
        source: "file:///storage/emulated/0/background.png"
        // 加载失败时打印日志排查原因
        onStatusChanged: {
            if (status === Image.Error) {
                console.log("图片加载失败:", errorString)
            }
        }
    }
}

2. 修正路径格式 #

你代码里的路径多了一个斜杠，正确格式应该是file:///storage/emulated/0/background.png（三个斜杠后接存储路径），不要写成四个斜杠。

3. 确认文件真实存在 #

• 用手机文件管理器核实/storage/emulated/0/background.png确实存在，注意Android文件系统区分大小写，文件名别写错。
• 也可以在QML里直接检查文件是否存在：

Component.onCompleted: {
    var file = Qt.openUrlSync("file:///storage/emulated/0/background.png")
    if (file) {
        console.log("文件存在")
        file.close()
    } else {
        console.log("文件不存在")
    }
}

4. 适配Android 10+的存储限制 #

Android 10及以上引入了Scoped Storage，直接访问外部存储根目录可能受限，可选择两种方案：

• 把图片放到应用专属外部存储目录，比如/storage/emulated/0/Android/data/[你的应用包名]/files/background.png，这个路径无需额外权限，QML里可通过Qt.application.storageDirectory直接获取：

Image {
    source: "file:///" + Qt.application.storageDirectory + "/background.png"
}

• 若必须访问公共目录，需使用MediaStore或SAF（存储访问框架）获取文件Uri，不能直接使用本地路径。

5. 检查Qt项目配置 #

确保你的Qt项目已启用Android模块，且构建时正确打包了权限配置。

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