QT运行时从linuxdeployqt打包后的部署包文件夹加载图片问题

• C++侧代码错误：QDir类仅支持传入本地文件系统的纯路径字符串，不识别file:开头的URL格式；且未基于程序所在目录拼接路径，默认以程序运行时的工作目录为基准，无法准确定位到打包后的release目录。
• QML侧代码错误：file:///img/是指向系统根目录下img文件夹的绝对路径，并非程序release目录下的自定义img文件夹，因此无法读取到目标资源。

1. C++侧实现（推荐，路径处理更稳妥） #

通过QCoreApplication::applicationDirPath()获取程序二进制文件所在的绝对路径，拼接自定义资源文件夹路径后读取文件列表，同时把资源文件夹的URL传给QML侧使用：

int main(int argc, char *argv[]) {
    QGuiApplication app(argc, argv);
    QQmlApplicationEngine engine;

    // 获取linuxdeployqt打包后release文件夹的绝对路径（二进制文件所在目录）
    QString appDir = QCoreApplication::applicationDirPath();
    // 拼接自定义资源文件夹路径，示例为release目录下的arts文件夹
    QString artDirPath = appDir + "/arts";
    QDir directory(artDirPath);

    // 可选：添加路径存在性校验，方便排查问题
    if (!directory.exists()) {
        qDebug() << "资源目录不存在：" << artDirPath;
    }

    // 读取目录下所有普通文件，过滤.和..特殊目录
    QStringList artList = directory.entryList(QStringList("*.*"), QDir::Files);
    for (int i=0; i<artList.size(); i++) {
        qDebug() << "----> list element: " << artList.at(i);
    }

    // 把资源目录的本地URL和文件列表都传给QML
    engine.rootContext()->setContextProperty("artDirUrl", QUrl::fromLocalFile(artDirPath).toString() + "/");
    engine.rootContext()->setContextProperty("artModel", QVariant::fromValue(artList));
    
    engine.load(QUrl(QStringLiteral("qrc:/main.qml")));
    if (engine.rootObjects().isEmpty())
        return -1;
    return app.exec();
}

2. QML侧适配 #

直接使用C++侧传入的路径参数拼接完整资源路径即可：

Rectangle {
    property int currentIndex: 0
    property bool swiping: false
    color: "transparent"

    AnimatedImage {
        id: anim_0
        // 拼接完整资源路径
        source: artDirUrl + artModel[currentIndex]
        width: parent.width
        height: parent.height
        fillMode: AnimatedImage.PreserveAspectCrop
        z: 10
    }
}

• 手动将存放自定义资源的arts/img文件夹复制到linuxdeployqt输出的release目录下，和二进制可执行文件处于同级目录
• 如果仍读取失败，可通过打印artDirPath的实际输出值，确认路径是否符合预期

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