使用Gluon Attach BrowserService在Android打开文件路径失败求助

问题本质 #

BrowserService在Android平台的实现是调用系统浏览器，但Android 13及以上版本出于安全限制，禁止浏览器直接访问file://格式的本地文件/文件夹路径——这并非URL格式错误，而是BrowserService的设计定位为打开网页URL，而非本地文件系统路径。

解决方案 #

1. Android端改用FileProvider+系统Intent打开文件/文件夹

Android推荐通过FileProvider共享文件，生成content://格式的安全Uri来访问本地文件：

• 注册FileProvider
  在AndroidManifest.xml中添加Provider配置：

  <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>
  

• 配置共享路径
  在res/xml目录下创建file_paths.xml，定义允许共享的文件路径（根据实际路径调整）：

  <?xml version="1.0" encoding="utf-8"?>
  <paths xmlns:android="http://schemas.android.com/apk/res/android">
      <external-root-path name="external_root" path="." />
      <!-- 更精确的路径示例：<external-files-path name="logs" path="Documents/CommLink6/logs"/> -->
  </paths>
  

• 代码生成Uri并调用系统Intent

  // 获取目标文件/文件夹
  File targetPath = new File(Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOCUMENTS), "CommLink6/logs");
  
  // 生成content://格式的Uri
  String authority = getApplicationContext().getPackageName() + ".fileprovider";
  Uri contentUri = FileProvider.getUriForFile(getApplicationContext(), authority, targetPath);
  
  // 创建打开Intent
  Intent intent = new Intent(Intent.ACTION_VIEW);
  // 文件夹可尝试指定"resource/folder"类型，文件按实际类型设置MIME
  intent.setDataAndType(contentUri, targetPath.isDirectory() ? "resource/folder" : "text/plain");
  intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
  intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
  
  // 检查是否有可处理的应用
  if (intent.resolveActivity(getApplicationContext().getPackageManager()) != null) {
      getApplicationContext().startActivity(intent);
  }
  

2. 跨平台适配

通过Gluon Attach的PlatformService区分平台，桌面端保留BrowserService实现，Android端用上述Intent方案：

PlatformService platformService = PlatformService.create().orElseThrow();
File logPath = new File(Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOCUMENTS), "CommLink6/logs");

if (platformService.isDesktop()) {
    BrowserService.create().ifPresent(service -> {
        try {
            // 桌面端用file:///格式，注意替换Windows路径的反斜杠
            service.launchExternalBrowser("file:///" + logPath.getAbsolutePath().replace("\\", "/"));
        } catch (IOException e) {
            e.printStackTrace();
        }
    });
} else if (platformService.isAndroid()) {
    // 执行上述Android端的Intent代码逻辑
    String authority = getApplicationContext().getPackageName() + ".fileprovider";
    Uri contentUri = FileProvider.getUriForFile(getApplicationContext(), authority, logPath);
    
    Intent intent = new Intent(Intent.ACTION_VIEW);
    intent.setDataAndType(contentUri, logPath.isDirectory() ? "resource/folder" : "text/plain");
    intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
    intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
    
    if (intent.resolveActivity(getApplicationContext().getPackageManager()) != null) {
        getApplicationContext().startActivity(intent);
    }
}

注意事项 #

• Android 13及以上版本，访问公共目录文件需申请对应权限（如READ_MEDIA_IMAGES），使用FileProvider可避免申请高危的MANAGE_EXTERNAL_STORAGE权限。
• 不同品牌的系统文件管理器对文件夹MIME类型的支持可能有差异，可尝试留空MIME类型让系统自动匹配。

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