解决Android11上分享图片失败,微信提示需要使用FileProvider

微信在Android11分享图片失败的问题

先看下微信分享错误的提示:


分享失败.png

先分析问题原因

看到这个错误大家第一个可能会想到FileProvider我在AndroidManifest早已配置过了,但是配置了是你可以使用FileProvider存储了应用间共享文件,但是在并不代表你使用了FileProvider,然后了解问题我们就要先了解一个概念分区存储

分区存储

Android 10之前,外部存储区的内容主要以两种形式:

  • 1.由应用的包名命名,归属于特定应用目录下的内容
  • 2.存储在公共存储区域的内容。

在Android 10 中,Google首次引入了分区存储,将公共区域划分成了不同的集合,并且在媒体文件和其他文档之间建立了清楚的分割。经过划分之后应用不可以随意访问外部存储区中的文件,而只能访问媒体文件。

  • 1.应用私有目录:存储应用私有数据,外部存储应用私有目录对应Android/data/packagename,内部存储应用私有目录对应data/data/packagename;
  • 2.共享目录:存储其他应用可访问文件, 包含媒体文件、文档文件以及其他文件,对应设备DCIM、Pictures、Alarms, Music, Notifications,Podcasts, Ringtones、Movies、Download等目录。

Android 11 (API 级别 30) 进一步增强了平台功能,为外部存储中的应用和用户数据提供了更好的保护。
从 Android 11 开始,使用 分区存储模式 的应用即使拥有 READ_EXTERNAL_STORAGE 权限,也无法再访问外部存储中的任何其他应用的 专属目录 中的文件

分区存储

受到这一限制的影响,如果你的应用通过第三方 SDK 分享文件 (例如分享照片给另一应用上的好友) 到其他应用,而这只是将自己专属目录中的文件路径传递给目标应用,目标应用将无法读取该文件。部分分享 SDK 可能没有正确处理这种情形,没有显式报错而只是静默失败 (对方用户都没有意识到这次分享),影响开发者和用户的体验。

FileProvider

FileProvider是Android7就提出的应用间共享文件适配方式,而目前大多数应用和SDK都具备这中方式
如果您的应用需要在 Android 11 上向其他应用分享文件,请检查您使用的第三方分享 SDK 是否支持通过 FileProvider 进行分享 (现在大部分常用的第三方分享 SDK 均已支持)。通过 FileProvider,您的应用能够允许第三方应用读取所分享的文件,而不会受到分区存储的限制

了解了原因,开始解决问题

这里微信已经支持通过了FileProvider形式进行分享了,我们可以直接调用

FileProvider绝对大数App在适配 Android7 的文件存储的时候就已经做了,可以忽略第一步

第一步 使用FileProvider

在项目的AndroidManifest.xml添加相关配置,示例如下:


    

​
// ${applicationId}为你的应用包名

在res/xml目录(如果没有xml目录,则新建一个)下,添加文件file_provider_paths.xml,内容如下:



    

external-files-path表示通过 Context.getExternalFilesDir(null) 接口获取到的目录下的文件才可被共享,其他未配置的路径均不可被分享。同样的节点可以配置多个,以支持多个不同的子目录,如下所示:



    
    

第二步使用FileProvider接口

将路径通过FileProvider的接口转换成content://URI形式,示例如下:

ublic void shareToWechat(Context context) {
    // ...
    
    String filePath = context.getExternalFilesDir(null) + "/shareData/test.png";
    // 该filePath对应于xml/file_provider_paths里的第一行配置:,因此才可被共享
  
    File file = new File(filePath);
    String contentPath = getFileUri(context, file);
  
    // 使用contentPath作为文件路径进行分享
    // ...
}
​
​
public String getFileUri(Context context, File file) {
    if (file == null || !file.exists()) {
        return null;
    }
  
    Uri contentUri = FileProvider.getUriForFile(context, 
        "com.example.app.fileprovider",  // 要与`AndroidManifest.xml`里配置的`authorities`一致,假设你的应用包名为com.example.app
        file);
  
    // 授权给微信访问路径
    context.grantUriPermission("com.tencent.mm",  // 这里填微信包名    
        contentUri, Intent.FLAG_GRANT_READ_URI_PERMISSION);
  
    return contentUri.toString();   // contentUri.toString() 即是以"content://"开头的用于共享的路径
}

第三步 微信版本支持
  • OpenSDK版本:必须大于或等于 5.4.3 版本,建议开发者升级至最新版本 5.5.8
  • 微信版本:微信版本为7.0.13及以上,并且Android版本7.0及以上,使用FileProvider获取路径,

微信版本的判断方式:当且仅当通过 IWXAPI.getWXAppSupportAPI() 接口获取到的值 >= 0x27000D00,才能支持FileProvider的方式进行分享。示例代码如下:

private IWXAPI api; // api的初始化这里省略
​
public void shareToWechat(Context context) {
    // ...
    if (checkVersionValid(context) && checkAndroidNotBelowN()) {
        String filePath = context.getExternalFilesDir(null) + "/shareData/test.png";
        File file = new File(filePath);
        String contentPath = WXOpenSDKFileProviderHelper.getFileUri(context, file);
      
        // 使用contentPath作为文件路径进行分享
        // ...
    }
    else {
        // 使用原有方式传递文件路径进行分享
        // ...
    }
}
​
// 判断微信版本是否为7.0.13及以上
public boolean checkVersionValid(Context context) {
    return api.getWXAppSupportAPI() >= 0x27000D00;
}
​
// 判断Android版本是否7.0及以上
public boolean checkAndroidNotBelowN() {
    return android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.N;
}

参考文档OpenSDK支持FileProvider方式分享文件到微信

(每天学习一点点.每天进步一点点,分享不宜路过点个赞呀,喜欢的点个关注后续更新不断)

你可能感兴趣的:(解决Android11上分享图片失败,微信提示需要使用FileProvider)