yarn add @krmao/react-native-umshareapplication gradle.properties add support platforms:
enableUMSharePlatforms=WEIXIN,DINGTALK,SMS,EMAIL,MORE,FACEBOOK,FACEBOOK_MESSAGER
import {SHARE_MEDIA, ShareUtil} from "@krmao/react-native-umshare";
const config = {
ANDROID: {
UMENG: {
APPID: "xxxxxx",
}, WEIXIN: {
APPID: "xxxxxx", SECRET: "xxxxxx",
},
}, IOS: {
UMENG: {
APPID: "xxxxxx",
}, WEIXIN: {
APPID: "xxxxxx", SECRET: "xxxxxx",
},
},
};
ShareUtil.init(Platform.OS === "android" ? config.ANDROID : config.IOS);
const sharePlatforms = [
// SHARE_MEDIA.WEIXIN,
// SHARE_MEDIA.GENERIC,
SHARE_MEDIA.SMS, SHARE_MEDIA.EMAIL,
// SHARE_MEDIA.FACEBOOK,
// SHARE_MEDIA.FACEBOOK_MESSAGER,
// SHARE_MEDIA.TWITTER,
// SHARE_MEDIA.PINTEREST,
// SHARE_MEDIA.LINKEDIN,
// SHARE_MEDIA.WHATSAPP,
// SHARE_MEDIA.DINGTALK,
SHARE_MEDIA.MORE
];
const shareTitle = "分享标题文本";
const shareDescription = "分享描述文本";
const shareThumbImage = "https://xxxxxx.jpg";
const shareWebUrl = "https://xxxxxx.html";
// shareTitle 在短信和邮箱中无效, 所以可以拼接到 shareDescription 前面
// '\n' 换行分享到短信有效, 分享到邮箱无效
// 复制不包含链接
ShareUtil.shareboard(shareTitle + "\n" + shareDescription + "\n", shareThumbImage, shareWebUrl, shareTitle, sharePlatforms, (shareResult) => {
console.log("share callback shareResult=", shareResult, typeof shareResult);
});-
(如果包含) 钉钉分享, 在 ${applicationId} 包名下创建 ddshare 文件夹, 添加 DDShareActivity.java 继承于 com.umshare.ddshare.ABSDDShareActivity.java
package ${applicationId}; import com.umshare.ddshare.ABSDDShareActivity; public class DDShareActivity extends ABSDDShareActivity { }
-
(如果包含) 微信分享, 在 ${applicationId} 包名下创建 wxapi 文件夹, 添加 WXEntryActivity.java 继承于 com.umshare.wxshare.ABSWXEntryActivity.java
package ${applicationId}; import com.umshare.wxshare.ABSWXEntryActivity; public class WXEntryActivity extends ABSWXEntryActivity { }
-
AndroidManifest.xml 添加
<queries> <!-- (如果包含) umshare 微信 --> <package android:name="com.tencent.mm"/> <!-- (如果包含) umshare qq --> <package android:name="com.tencent.mobileqq"/> <!-- (如果包含) umshare 微博 --> <!-- <package android:name="com.sina.weibo"/>--> <!-- (如果包含) umshare 企业微信 --> <package android:name="com.tencent.wework"/> <!-- (如果包含) umshare QQ空间 --> <!-- <package android:name="com.qzone"/>--> <!-- (如果包含) umshare 钉钉 --> <package android:name="com.alibaba.android.rimed"/> <!-- (如果包含) umshare 支付宝 --> <!-- <package android:name="com.eg.android.AlipayGphone"/>--> <!-- (如果包含) umshare instagram --> <package android:name="com.instagram.android"/> <!-- (如果包含) umshare 抖音 --> <!-- <package android:name="com.ss.android.ugc.aweme"/>--> </queries> <application> <!-- (如果包含) Facebook App ID meta-data, facebook的 id 必须写在 string 文件中且名字必须用 facebook_app_id --> <meta-data android:name="com.facebook.sdk.ApplicationId" android:value="@string/facebook_app_id"/> <!-- (如果包含) 友盟微信分享 --> <activity android:name=".wxapi.WXEntryActivity" android:configChanges="keyboardHidden|orientation|screenSize" android:exported="true" android:theme CCC6 ="@android:style/Theme.Translucent.NoTitleBar"/> <!-- (如果包含) 友盟钉钉分享 --> <activity android:name=".ddshare.DDShareActivity" android:configChanges="keyboardHidden|orientation|screenSize" android:exported="true" android:launchMode="singleInstance" android:theme="@android:style/Theme.Translucent.NoTitleBar"/> <!-- 友盟Facebook分享 https://developer.umeng.com/docs/128606/detail/129622 --> <activity android:name="com.umeng.facebook.FacebookActivity" android:configChanges="keyboardHidden|orientation|screenSize" android:exported="true" android:launchMode="singleInstance" android:theme="@android:style/Theme.Translucent.NoTitleBar"/> <!-- (如果包含) QQ分享需要授权 --> <activity android:name="com.tencent.tauth.AuthActivity" android:exported="true" android:launchMode="singleTask" android:noHistory="true"> <intent-filter> <action android:name="android.intent.action.VIEW"/> <category android:name="android.intent.category.DEFAULT"/> <category android:name="android.intent.category.BROWSABLE"/> <data android:scheme="tencent100424468"/> </intent-filter> </activity> <!-- (如果包含) QQ --> <activity android:name="com.tencent.connect.common.AssistActivity" android:configChanges="orientation|keyboardHidden|screenSize" android:theme="@android:style/Theme.Translucent.NoTitleBar"/> <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/umshare_file_paths" tools:replace="android:resource"/> </provider> </application>
-
res/xml/umshare_file_paths.xml 合并到主工程
如果写在库中会报合并错误:
Error: Attribute meta-data#android.support.FILE_PROVIDER_PATHS@resource value=(@xml/provider_paths) from [:xxx] AndroidManifest.xml:23:17-75 is also present at [:krmao_react-native-umshare] AndroidManifest.xml:64:17-59 value=(@xml/umshare_file_paths). Suggestion: add 'tools:replace="android:resource"' to element at AndroidManifest.xml to override. FAILURE: Build failed with an exception.
<?xml version="1.0" encoding="utf-8"?> <paths> <root-path name="opensdk_root" path=""/> <external-files-path name="umeng_cache" path="umeng_cache/"/> <!-- (如果包含) QQ 官方分享SDK 共享路径 --> <!-- <root-path name="opensdk_root" path=""/> --> <external-files-path name="opensdk_external" path="Images/tmp"/> <!-- (如果包含) 新浪 共享路径 --> <!-- <external-files-path name="share_files" path="."/> --> </paths>
-
MainActivity.java 添加
import android.content.Intent; import com.umeng.socialize.UMShareAPI; public class MainActivity extends ReactActivity{ @Override public void onActivityResult(int requestCode, int resultCode, Intent data) { super.onActivityResult(requestCode, resultCode, data); UMShareAPI.get(this).onActivityResult(requestCode, resultCode, data); } }
-
错误列表
- 错误码：2003 错误信息：分享失败----Unable to show the provided content via the web or the installed version of the
Facebook app. Some dialogs are only supported starting API 14.
- 错误码：2003 错误信息：分享失败----Unable to show the provided content via the web or the installed version of the
Facebook app. Some dialogs are only supported starting API 14.
如果你的应用使用了如SSO授权登录或跳转到第三方分享功能，在iOS9/10下就需要增加一个可跳转的白名单，即LSApplicationQueriesSchemes， 否则将在SDK判断是否跳转时用到的canOpenURL时返回NO，进而只进行webview授权或授权/分享失败。
在项目中的info.plist中加入应用白名单，右键info.plist选择source code打开(plist具体设置在Build Setting -> Packaging -> Info.plist File可获取plist路径)请根据选择的平台对以下配置进行裁剪：
重要 iOS 15限制了配置的URL Scheme不可以超过50个
注释不能拷贝, 删掉注释
<key>LSApplicationQueriesSchemes</key>
<array>
<!--微信 URL Scheme白名单-->
<string>wechat</string>
<string>weixin</string>
<string>weixinULAPI</string>
<string>weixinURLParamsAPI</string>
<!-- 钉钉 -->
<string>dingtalk</string>
<string>dingtalk-openauth</string>
<string>dingtalk-openauth2</string>
<!-- QQ、Qzone URL Scheme白名单--->
<!-- <string>mqqopensdklaunchminiapp</string>-->
<!-- <string>mqqopensdkminiapp</string>-->
<!-- <string>mqqapi</string>-->
<!-- <string>mqq</string>-->
<!-- <string>mqqOpensdkSSoLogin</string>-->
<!-- <string>mqqconnect</string>-->
<!-- <string>mqqopensdkapi</string>-->
<!-- <string>mqqopensdkapiV2</string>-->
<!-- <string>mqqopensdkapiV3</string>-->
<!-- <string>mqqopensdkapiV4</string>-->
<!-- <string>mqqopensdknopasteboard</string>-->
<!-- <string>mqqopensdknopasteboardios16</string>-->
<!-- <string>tim</string>-->
<!-- <string>timapi</string>-->
<!-- <string>timopensdkfriend</string>-->
<!-- <string>timwpa</string>-->
<!-- <string>timgamebindinggroup</string>-->
<!-- <string>timapiwallet</string>-->
<!-- <string>timOpensdkSSoLogin</string>-->
<!-- <string>wtlogintim</string>-->
<!-- <string>timopensdkgrouptribeshare</string>-->
<!-- <string>timopensdkapiV4</string>-->
<!-- <string>timgamebindinggroup</string>-->
<!-- <string>timopensdkdataline</string>-->
<!-- <string>wtlogintimV1</string>-->
<!-- <string>timapiV1</string>-->
<!---->
<!--新浪微博 URL Scheme白名单--->
<!-- <string>sinaweibohd</string>-->
<!-- <string>sinaweibo</string>-->
<!-- <string>sinaweibosso</string>-->
<!-- <string>weibosdk</string>-->
<!-- <string>weibosdk2.5</string>-->
<!-- <string>weibosdk3.3</string>-->
</array>URL Scheme 是通过系统找到并跳转对应app的一类设置, 通过向项目中的 info.plist 文件中加入 URL
types 可使用第三方平台所注册的 appkey 信息向系统注册你的 app, 当跳转到第三方应用授权或分享后, 可直接跳转回你的app
添加 URL Types 可工程设置面板设置, 配置第三方平台URL Scheme未列出则不需设置
- 钉钉
-
- 微信需要添加两项URL Scheme
- 'tencent' + 腾讯 QQ 互联应用 appID
- 'QQ' + 腾讯 QQ 互联应用 appID 转换成十六进制（不足8位前面补0）
如 appID: 100424468
- tencent100424468
- QQ05fc5b14
- QQ05fc5b14 为 100424468 转十六进制而来, 因不足8位向前补0, 然后加 'QQ' 前缀
- 新浪
- 'wb' + 新浪 appKey -> wb3921700954
#import "UMShare/UMSocialGlobal.h"
#import "UMShare/UMSocialManager.h"
-(BOOL)application:(UIApplication*)application handleOpenURL:(NSURL *)url
{
BOOL result =[[UMSocialManager defaultManager] handleOpenURL:url];
if(!result){
// 其他如支付等SDK的回调
}
return result;
}