收藏
评论

OpenSDK支持FileProvider方式分享文件到微信官方

各位开发者:

最新版本(7.0.13)的微信 SDK 已经适配使用FileProvider的方式来进行消息分享。

如果分享的消息中涉及文件路径(如图片类型消息),建议开发者针对Android 7.0版本及以上设备,判断微信版本支持(判断方法见后文【微信版本支持】一节)的情况下,更新为FileProvider的方式进行分享。

以下是具体的适配说明。

使用FileProvider

1. 配置

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

<provider
    android:name="android.support.v4.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_provider_paths" />
</provider>
​
// ${applicationId}为你的应用包名

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

<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <external-files-path name="sharedata" path="shareData/"/>
</paths>

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

<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <external-files-path name="sharedata" path="shareData/"/>
    <external-files-path name="sharedata2" path="shareData2/"/>
</paths>

paths内部还支持节点配置其他的路径,比如:

  • files-path,对应于 Context.getFilesDir() 获取到的目录
  • cache-path,对应于 Context.getCacheDir() 获取到的目录
  • ...
  • 还有一些其他可配置的路径,开发者可自行了解使用。


2. 使用FileProvider接口

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

public 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://"开头的用于共享的路径
}


微信版本支持

  1. OpenSDK版本:必须大于或等于 5.4.3 版本,建议开发者升级至最新版本 5.5.8
  2. 微信版本:当且仅当通过 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 消息分享文档:https://developers.weixin.qq.com/doc/oplatform/Mobile_App/Share_and_Favorites/Android.html


微信团队

2020年03月31日

186004浏览
最后一次编辑于  2020-03-31
收藏

126 个评论

  • 竹阳街道沈小红
    竹阳街道沈小红
    发表于移动端
    2020-07-12
    2020-07-12
    赞同 54
    回复 2
    • 马兴兵
      马兴兵
      发表于移动端
      2022-01-29
      微信扫码登不上号
      2022-01-29
      31
      回复
    • 浅
      发表于移动端
      2022-08-28回复马兴兵
      我微信扫码也登不上号
      2022-08-28
      3
      回复
  • 迎着风
    迎着风
    发表于移动端
    2021-01-25
    我希望微信变得更好更安全
    2021-01-25
    赞同 36
    回复
  • SungKim
    SungKim
    2020-12-22

    小米10 安卓11,分享文件不行,系统分享文件也不行,请问这个是安卓11的bug还是小米安卓11的bug,还是微信的bug?还有一点就是分享图片是正常,就文件不行

    2020-12-22
    赞同 36
    回复
  • 李强
    李强
    2020-04-01

    这篇应该放到 OpenSDK 消息分享文档 https://developers.weixin.qq.com/doc/oplatform/Mobile_App/Share_and_Favorites/Android.html


    2020-04-01
    赞同 34
    回复
  • 竹阳街道沈小红
    竹阳街道沈小红
    发表于移动端
    2020-07-12
    2020-07-12
    赞同 30
    回复 1
    • 〆h潮钕
      〆h潮钕
      发表于移动端
      2021-11-08
      分手了吧好像
      2021-11-08
      11
      回复
  • 艳芳
    艳芳
    2020-11-07

    android11,微信7.0.20双开微信怎么分享

    2020-11-07
    赞同 29
    回复 3
  • 薯条
    薯条
    2020-09-27

    升级Android11后,系统分享渠道,通过FileProvider授权后,出现资源无法加载的情况,请问如何处理?

    2020-09-27
    赞同 29
    回复 4
    • Felix 、
      Felix 、
      2020-12-19
      同样的问题,以FileProvider构建出来的uri其实是有问题的,还是一个路径,并非真正的Uri
      2020-12-19
      14
      回复
    • 高yeah
      高yeah
      2021-11-15
      +1
      2021-11-15
      7
      回复
    • 牛皮
      牛皮
      2022-01-25回复Felix 、
      那如何进行修改呢?
      2022-01-25
      4
      回复
    • Liu Zhiyong🇨🇳
      Liu Zhiyong🇨🇳
      发表于移动端
      2022-02-01回复高yeah
      这么麻烦
      2022-02-01
      回复
  • 桥
    2020-06-04

    如何支持多张图片分享?

    2020-06-04
    赞同 29
    回复 1
    • 叶子 萝卜
      叶子 萝卜
      2020-06-05
      +1
      2020-06-05
      9
      回复
  • akpar
    akpar
    发表于移动端
    2020-11-13
    18599387907
    2020-11-13
    赞同 28
    回复
  •  xinyexiangn
     xinyexiangn
    发表于移动端
    2020-10-20
    支付功能被限制了,请帮我打开
    2020-10-20
    赞同 28
    回复 1

正在加载...

登录 后发表内容