Qt如何获取安卓系统Files的Documents路径 -- 3种方法

Qt如何获取安卓系统Files的Documents路径

在 Qt 中获取 Android 系统的 Files/Documents 路径，可以通过 Qt 的跨平台 API 或 JNI 来实现。

方法 1：使用 QStandardPaths 获取应用私有 Documents 路径

Qt 提供了 QStandardPaths 类，可以用来访问应用程序的标准路径。例如，获取当前应用的私有文件夹下的 Documents 目录。

#include <QStandardPaths>
#include <QDebug>

QString documentsPath = QStandardPaths::writableLocation(QStandardPaths::DocumentsLocation);
qDebug() << "Documents Path:" << documentsPath;

说明

• QStandardPaths::DocumentsLocation 返回当前应用的私有 Documents 目录。

• 这个路径通常是在 getExternalFilesDir() 对应的目录下，比如：

  /storage/emulated/0/Android/data/com.yourapp/files/Documents
  

如果需要确保子目录存在，可以手动创建：

QDir dir(documentsPath);
if (!dir.exists()) {
    dir.mkpath(".");
}

方法 2：使用 JNI 调用 Android 的原生方法

如果需要访问公共 Documents 目录（即 Environment.DIRECTORY_DOCUMENTS），可以通过 JNI 调用 Android 原生的 Java API。

步骤

1. 添加必要的 JNI 调用代码
   在 Qt 项目中使用 QAndroidJniObject 来调用 Android 的 Java API。

#include <QAndroidJniObject>
#include <QDebug>

QString getAndroidDocumentsPath() {
    QAndroidJniObject env = QAndroidJniObject::callStaticObjectMethod(
        "android/os/Environment",
        "getExternalStoragePublicDirectory",
        "(Ljava/lang/String;)Ljava/io/File;",
        QAndroidJniObject::fromString("Documents").object<jstring>()
    );

    if (env.isValid()) {
        QString documentsPath = env.toString();
        qDebug() << "Public Documents Path:" << documentsPath;
        return documentsPath;
    } else {
        qWarning() << "Failed to get public Documents path!";
        return QString();
    }
}

1. 调用函数
   在代码中直接调用 getAndroidDocumentsPath() 函数即可获取路径。

输出路径示例

调用成功后会返回设备上的公共 Documents 目录，例如：

/storage/emulated/0/Documents

方法 3：Storage Access Framework（适配 Android 10+）

对于 Android 10 (API 29) 及以上版本，Google 强制推荐使用 Storage Access Framework (SAF)，这涉及到用户选择路径并返回 URI。通过 JNI 可以实现 SAF 操作。

关键点

• 启动文件选择器 Intent，通过 JNI 触发。
• 用户选择目录后，返回一个 URI。
• 通过 Qt 的文件访问功能处理该 URI。

方法对比

建议

• 如果只是存储和读取应用的私有文档，推荐使用 QStandardPaths。
• 如果需要操作公共 Documents 目录，并支持多 Android 版本，可结合 JNI 调用和动态权限处理实现。