Android接入指南
1、在build.gradle文件中,添加如下依赖:
dependencies { compile 'com.tencent.mm.opensdk:wechat-sdk-android-with-mta:+' }或
dependencies { compile 'com.tencent.mm.opensdk:wechat-sdk-android-without-mta:+' }
2、 AndroidManifest.xml 设置
添加必要的权限支持:
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
<uses-permission android:name="android.permission.READ_PHONE_STATE"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
3、注册到微信
4、WXEntryActivity类使用
a、在你的包名相应目录下新建一个wxapi目录,并在该wxapi目录下新增一个WXEntryActivity类,该类继承自Activity
在AndroidManifest.xml添加
b、实现IWXAPIEventHandler接口,微信发送的请求将回调到onReq方法,发送到微信请求的响应结果将回调到onResp方法
c. 在WXEntryActivity中将接收到的intent及实现了IWXAPIEventHandler接口的对象传递给IWXAPI接口的handleIntent方法
当微信发送请求到你的应用,将通过IWXAPIEventHandler接口的onReq方法进行回调,
类似的,应用请求微信的响应结果将通过onResp回调。.
5、混淆
-keep class com.tencent.mm.opensdk.** {
*;
}
-keep class com.tencent.wxop.** {
*;
}
-keep class com.tencent.mm.sdk.** {
*;
}
Android分享小程序到微信
1、在你要分享小程序的位置加入如下代码
WXMiniProgramObject miniProgramObj = new WXMiniProgramObject();
miniProgramObj.webpageUrl = "http://www.qq.com"; // 兼容低版本的网页链接
miniProgramObj.miniprogramType = WXMiniProgramObject.MINIPTOGRAM_TYPE_RELEASE;// 正式版:0,测试版:1,体验版:2
miniProgramObj.userName = "gh_xxxxxxxx"; // 小程序原始id
miniProgramObj.path = "/pages/media"; //小程序页面路径
WXMediaMessage msg = new WXMediaMessage(miniProgramObj);
msg.title = "小程序消息Title"; // 小程序消息title
msg.description = "小程序消息Desc"; // 小程序消息desc
msg.thumbData = getThumb(); // 小程序消息封面图片,小于128k
SendMessageToWX.Req req = new SendMessageToWX.Req();
req.transaction = buildTransaction("webpage");
req.message = msg;
req.scene = SendMessageToWX.Req.WXSceneSession; // 目前支持会话
api.sendReq(req);
注意:
支持从APP分享小程序类型消息至微信,用户接收后可打开进入小程序。
要求:
发起分享的App与小程序属于同一微信开放平台帐号。
支持分享小程序类型消息至会话,暂不支持分享至朋友圈。
若客户端版本低于6.5.6,小程序类型分享将自动转成网页类型分享。开发者必须填写网页链接字段,确保低版本客户端能正常打开网页链接。
2、在WXEntryActivity添加如下代码
/**
* 发送到微信请求的响应结果将回调到onResp,app调起微信回调
* @param baseResp
*/
@Override
public void onResp(BaseResp baseResp) {
if (baseResp.getType() == ConstantsAPI.COMMAND_LAUNCH_WX_MINIPROGRAM) {
WXLaunchMiniProgram.Resp launchMiniProResp = (WXLaunchMiniProgram.Resp) baseResp;
String extraData = launchMiniProResp.extMsg; // 对应JsApi navigateBackApplication中的extraData字段数据
}
}
小程序打开App
1、小程序端添加如下代码
<button open-type="launchApp" app-parameter="wechat" binderror="launchAppError">打开APP</button>
Page({
launchAppError (e) {
console.log(e.detail.errMsg)
}
})
2、在WXEntryActivity添加如下代码
Android 第三方 app 需要处理 ShowMessageFromWX.req 的微信回调
/**
* 微信发送的请求将回调到onReq方法,小程序调起app回调
* @param req
*/
@Override
public void onReq(BaseReq req) {
switch (req.getType()) {
case ConstantsAPI.COMMAND_GETMESSAGE_FROM_WX:
break;
case ConstantsAPI.COMMAND_SHOWMESSAGE_FROM_WX:
goToShowMsg((ShowMessageFromWX.Req) req);
break;
default:
break;
}
}
3、接收小程序数据,并处理相关逻辑
/**
* 接收从小程序跳转到app的数据,并进行处理
*
* @param showReq
*/
@Subscribe
private void goToShowMsg(ShowMessageFromWX.Req showReq) {
WXMediaMessage wxMsg = showReq.message;
Intent intent = new Intent(this, MainActivity.class);
startActivity(intent);
finish();
}
小程序无法主动打开app,必须指定打开的页面
完整代码
public class YApplication extends MultiDexApplication {
private static IWXAPI api;
private void registerWeixin() {
api = WXAPIFactory.createWXAPI(this, WECHAT_KEY);
api.registerApp(WECHAT_KEY);
}
public static IWXAPI getWeiXinApi() {
return api;
}
}
public class WXEntryActivity extends WXCallbackActivity implements IWXAPIEventHandler {
@Override
protected void onCreate(Bundle bundle) {
super.onCreate(bundle);
//注意:
//第三方开发者如果使用透明界面来实现WXEntryActivity,需要判断handleIntent的返回值
//如果返回值为false,则说明入参不合法未被SDK处理,应finish当前透明界面,避免外部通过传递非法参数的Intent导致停留在透明界面,引起用户的疑惑
try {
if (!YApplication.getWeiXinApi().handleIntent(getIntent(), this)) {
finish();
}
} catch (Exception e) {
e.printStackTrace();
}
}
@Override
protected void onNewIntent(Intent intent) {
super.onNewIntent(intent);
setIntent(intent);
YApplication.getWeiXinApi().handleIntent(intent, this);
}
/**
* 微信发送的请求将回调到onReq方法,小程序调起app回调
* @param req
*/
@Override
public void onReq(BaseReq req) {
switch (req.getType()) {
case ConstantsAPI.COMMAND_GETMESSAGE_FROM_WX:
break;
case ConstantsAPI.COMMAND_SHOWMESSAGE_FROM_WX:
goToShowMsg((ShowMessageFromWX.Req) req);
break;
default:
break;
}
}
/**
* 发送到微信请求的响应结果将回调到onResp,app调起微信回调
* @param baseResp
*/
@Override
public void onResp(BaseResp baseResp) {
if (baseResp.getType() == ConstantsAPI.COMMAND_LAUNCH_WX_MINIPROGRAM) {
WXLaunchMiniProgram.Resp launchMiniProResp = (WXLaunchMiniProgram.Resp) baseResp;
String extraData = launchMiniProResp.extMsg; // 对应JsApi navigateBackApplication中的extraData字段数据
}
}
/**
* 接收从小程序跳转到app的数据,并进行处理
*
* @param showReq
*/
private void goToShowMsg(ShowMessageFromWX.Req showReq) {
WXMediaMessage wxMsg = showReq.message;
Intent intent = new Intent(this, MainActivity.class);
startActivity(intent);
finish();
}
}
public void shareToWXMiniProgram() {
WXMiniProgramObject miniProgramObj = new WXMiniProgramObject();
miniProgramObj.webpageUrl = "http://www.qq.com"; // 兼容低版本的网页链接
miniProgramObj.miniprogramType = WXMiniProgramObject.MINIPROGRAM_TYPE_PREVIEW;// 正式版:0,测试版:1,体验版:2
miniProgramObj.userName = "gh_XXXXXXXX"; // 小程序原始id
// miniProgramObj.path = "/pages/media"; //小程序页面路径
WXMediaMessage msg = new WXMediaMessage(miniProgramObj);
msg.title = title;
msg.description = desc;
Bitmap bmp = FileUtils.returnBitmap(image);
Bitmap thumbBmp = Bitmap.createScaledBitmap(bmp, 250, 150, true);
bmp.recycle();
msg.setThumbImage(thumbBmp); // 小程序消息封面图片,小于128k
SendMessageToWX.Req req = new SendMessageToWX.Req();
req.transaction = buildTransaction("webpage");
req.message = msg;
req.scene = SendMessageToWX.Req.WXSceneSession; // 目前支持会话
YApplication.getWeiXinApi().sendReq(req);
}
注:体验版需要在小程序设置页面添加开发者的微信账号,才可以体验