微信SDK for Android框架的Java类库实例教程
微信SDK for Android框架的Java类库实例教程
微信SDK（Software Development Kit）为开发者提供了一套方便快捷地集成微信功能到Android应用中的工具。本教程将向您展示如何使用微信SDK的Java类库来实现在Android应用中集成微信登录、分享及支付功能。
步骤1：创建新的Android项目
首先，创建一个新的Android项目，并确保已设置好相关的包名及应用签名。
步骤2：下载并导入微信SDK
从官方网站下载最新版本的微信SDK，并将其导入到Android项目中。可通过在Android Studio的项目根目录的build.gradle文件中添加以下代码来导入：
groovy
dependencies {
implementation files('libs/XXX.jar') // 请替换为实际的微信SDK的jar包路径
}
步骤3：配置AndroidManifest.xml文件
在AndroidManifest.xml文件中，添加以下权限和组件声明：
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<application>
<!-- 微信登录和分享的回调Activity -->
<activity
android:name="com.tencent.mm.opensdk.openapi.IntentHandlerActivity"
android:exported="false"
android:screenOrientation="portrait"
android:theme="@android:style/Theme.Translucent.NoTitleBar" />
<!-- 微信支付的回调Activity -->
<activity
android:name="YOUR_PACKAGE_NAME.wxapi.WXPayEntryActivity"
android:exported="true"
android:screenOrientation="portrait"
android:theme="@android:style/Theme.Translucent.NoTitleBar" />
<!-- 注册微信appId -->
<meta-data
android:name="com.tencent.mm.sdk.openapi.WXAPIFactory.APPID"
android:value="YOUR_WECHAT_APPID" />
</application>
请将YOUR_PACKAGE_NAME替换为您的应用包名，并将YOUR_WECHAT_APPID替换为您申请的微信App ID。
步骤4：初始化微信SDK
在您的应用的入口Activity中，通过以下代码来初始化微信SDK：
public class MainActivity extends AppCompatActivity {
// 微信App ID，从微信开放平台申请获取
private static final String APP_ID = "YOUR_WECHAT_APPID";
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
// 将微信SDK注册到应用中
IWXAPI api = WXAPIFactory.createWXAPI(this, APP_ID, true);
api.registerApp(APP_ID);
}
}
确保将YOUR_WECHAT_APPID替换为您申请的微信App ID。
步骤5：实现微信登录功能
以下是一个简单示例代码，演示如何使用微信SDK来实现微信登录功能。该代码需要添加到您的登录Activity中。
public class LoginActivity extends AppCompatActivity {
private IWXAPI api; // 微信API对象
private static final int REQUEST_CODE_LOGIN_WECHAT = 1001;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_login);
// 初始化微信API对象
api = WXAPIFactory.createWXAPI(this, APP_ID, true);
api.registerApp(APP_ID);
// 登录按钮点击事件
findViewById(R.id.btn_login_wechat).setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
// 发送微信登录请求
SendAuth.Req req = new SendAuth.Req();
req.scope = "snsapi_userinfo"; // 请求用户授权的作用域
req.state = "login_wechat"; // 用于保持请求和回调的状态，可自定义
api.sendReq(req);
}
});
}
@Override
protected void onResume() {
super.onResume();
// 处理微信登录回调
handleWechatLoginCallback(getIntent());
}
@Override
protected void onNewIntent(Intent intent) {
super.onNewIntent(intent);
// 处理微信登录回调
handleWechatLoginCallback(intent);
}
private void handleWechatLoginCallback(Intent intent) {
// 判断是否为微信登录回调
if (intent != null && intent.hasExtra("_wxapi_sendauth_resp")) {
SendAuth.Resp resp = new SendAuth.Resp(intent.getBundleExtra("_wxapi_sendauth_resp"));
if (resp.errCode == BaseResp.ErrCode.ERR_OK) {
// 用户同意授权
String code = resp.code; // 获取授权code，可用于换取access_token
// TODO: 通过code向服务器请求用户信息，完成登录逻辑
} else {
// 用户取消授权或发生错误
showToast("微信登录失败");
}
}
}
// 显示Toast消息
private void showToast(String message) {
Toast.makeText(this, message, Toast.LENGTH_SHORT).show();
}
}
以上代码中，首先在登录按钮的点击事件中调用`api.sendReq(req)`发送微信登录请求，然后在`handleWechatLoginCallback`方法中处理微信登录回调。
步骤6：实现微信分享功能
以下是一个简单示例代码，演示如何使用微信SDK来实现微信分享功能。该代码需要添加到您的分享Activity中。
public class ShareActivity extends AppCompatActivity {
private IWXAPI api; // 微信API对象
private static final int REQUEST_CODE_SHARE_WECHAT = 1002;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_share);
// 初始化微信API对象
api = WXAPIFactory.createWXAPI(this, APP_ID, true);
api.registerApp(APP_ID);
// 分享按钮点击事件
findViewById(R.id.btn_share_wechat).setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
// 构造一个WXTextObject对象
WXTextObject textObj = new WXTextObject();
textObj.text = "要分享的文本内容";
// 用WXTextObject对象初始化一个WXMediaMessage对象
WXMediaMessage msg = new WXMediaMessage();
msg.mediaObject = textObj;
msg.description = "要分享的文本描述";
// 构造一个Req
SendMessageToWX.Req req = new SendMessageToWX.Req();
req.transaction = buildTransaction("text"); // 用于唯一标识一个请求
req.message = msg;
req.scene = SendMessageToWX.Req.WXSceneTimeline; // 分享到朋友圈
// 发送分享请求
api.sendReq(req);
}
});
}
@Override
protected void onResume() {
super.onResume();
// 处理微信分享回调
handleWechatShareCallback(getIntent());
}
@Override
protected void onNewIntent(Intent intent) {
super.onNewIntent(intent);
// 处理微信分享回调
handleWechatShareCallback(intent);
}
private void handleWechatShareCallback(Intent intent) {
// 判断是否为微信分享回调
if (intent != null && intent.hasExtra("_wxapi_sendmessagetowx_req")) {
// 获取分享结果
int result = intent.getIntExtra("_wxapi_baseresp_errcode", BaseResp.ErrCode.ERR_OK);
if (result == BaseResp.ErrCode.ERR_OK) {
// 分享成功
} else {
// 分享失败
showToast("微信分享失败");
}
}
}
// 生成唯一标识
private String buildTransaction(final String type) {
return type + System.currentTimeMillis();
}
// 显示Toast消息
private void showToast(String message) {
Toast.makeText(this, message, Toast.LENGTH_SHORT).show();
}
}
以上代码中，首先在分享按钮的点击事件中构造一个`WXTextObject`对象，并用它初始化一个`WXMediaMessage`对象。然后，构造一个`Req`对象，在`req.scene`中指定分享到朋友圈，并调用`api.sendReq(req)`发送分享请求。
步骤7：实现微信支付功能
以下是一个简单示例代码，演示如何使用微信SDK来实现微信支付功能。该代码需要添加到您的支付Activity中。
public class PayActivity extends AppCompatActivity {
private IWXAPI api; // 微信API对象
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_pay);
// 初始化微信API对象
api = WXAPIFactory.createWXAPI(this, APP_ID, true);
api.registerApp(APP_ID);
// 支付按钮点击事件
findViewById(R.id.btn_pay_wechat).setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
// 构建微信支付请求
PayReq req = new PayReq();
req.appId = APP_ID; // 微信App ID
req.partnerId = "YOUR_PARTNER_ID"; // 商户号
req.prepayId = "YOUR_PREPAY_ID"; // 预支付交易会话ID
req.nonceStr = "YOUR_NONCE_STR"; // 随机字符串
req.timeStamp = "YOUR_TIMESTAMP"; // 时间戳
req.packageValue = "Sign=WXPay"; // 扩展字段，暂填写固定值
req.sign = "YOUR_SIGN"; // 签名
// 发送支付请求
api.sendReq(req);
}
});
}
@Override
protected void onResume() {
super.onResume();
// 处理微信支付回调
handleWechatPayCallback(getIntent());
}
@Override
protected void onNewIntent(Intent intent) {
super.onNewIntent(intent);
// 处理微信支付回调
handleWechatPayCallback(intent);
}
private void handleWechatPayCallback(Intent intent) {
// 判断是否为微信支付回调
if (intent != null && intent.hasExtra("_wxapi_payresp")) {
PayResp resp = new PayResp(intent.getBundleExtra("_wxapi_payresp"));
if (resp.errCode == BaseResp.ErrCode.ERR_OK) {
// 支付成功
} else if (resp.errCode == BaseResp.ErrCode.ERR_USER_CANCEL) {
// 用户取消支付
} else {
// 支付失败
showToast("微信支付失败");
}
}
}
// 显示Toast消息
private void showToast(String message) {
Toast.makeText(this, message, Toast.LENGTH_SHORT).show();
}
}
在以上代码中，构建一个`PayReq`对象，并填入相应的支付参数。然后，调用`api.sendReq(req)`发送支付请求。
完成以上步骤后，您的Android应用将能够成功集成微信登录、分享及支付功能。请根据实际需求进行适当调整和完善。
Read in English