OpenSDK支持FileProvider方式分享文件到微信
各位开发者: 最新版本(7.0.13)的微信 SDK 已经适配使用FileProvider的方式来进行消息分享。 如果分享的消息中涉及文件路径(如图片类型消息),建议开发者针对Android 7.0版本及以上设备,判断微信版本支持(判断方法见后文【微信版本支持】一节)的情况下,更新为FileProvider的方式进行分享。以下是具体的适配说明。 使用FileProvider1. 配置在项目的[代码]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://"开头的用于共享的路径
}
微信版本支持OpenSDK版本:必须大于或等于 5.4.3 版本,建议开发者升级至最新版本 5.5.8微信版本:当且仅当通过 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日