各位开发者：

最新版本（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日