React Native WeChat 模块 Android 平台集成指南

前言

React Native WeChat 是一个用于在 React Native 应用中集成微信功能的模块，支持微信登录、分享、支付等功能。本文将详细介绍在 Android 平台上的集成步骤，帮助开发者快速完成配置。

基础集成步骤

1. 添加 Gradle 配置

首先需要在项目的 Gradle 配置文件中添加模块依赖：

settings.gradle 添加：

include ':RCTWeChat'
project(':RCTWeChat').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-wechat/android')

app/build.gradle 添加依赖：

dependencies {
  implementation project(':RCTWeChat')
}

2. 配置混淆规则

为了保护微信 SDK 不被混淆，需要在 proguard-rules.pro 文件中添加：

-keep class com.tencent.mm.sdk.** {
  *;
}

3. 注册 React Native 包

在 MainApplication.java 中注册 WeChatPackage：

import com.theweflex.react.WeChatPackage;

@Override
protected List<ReactPackage> getPackages() {
  List<ReactPackage> packages = new PackageList(this).getPackages();
  packages.add(new WeChatPackage());
  return packages;
}

高级功能配置

微信登录与分享功能

要实现微信登录和分享功能，需要创建特定的 Activity 来处理回调：

1. 创建 wxapi 包和 WXEntryActivity 类：

package your.package.wxapi;

import android.app.Activity;
import android.os.Bundle;
import com.theweflex.react.WeChatModule;

public class WXEntryActivity extends Activity {
  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    WeChatModule.handleIntent(getIntent());
    finish();
  }
}

2. 在 AndroidManifest.xml 中注册：

<activity
  android:name=".wxapi.WXEntryActivity"
  android:label="@string/app_name"
  android:exported="true"
/>

微信支付功能

微信支付需要单独配置回调 Activity：

1. 创建 WXPayEntryActivity 类：

package your.package.wxapi;

import android.app.Activity;
import android.os.Bundle;
import com.theweflex.react.WeChatModule;

public class WXPayEntryActivity extends Activity {
  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    WeChatModule.handleIntent(getIntent());
    finish();
  }
}

2. 在 AndroidManifest.xml 中注册：

<activity
  android:name=".wxapi.WXPayEntryActivity"
  android:label="@string/app_name"
  android:exported="true"
/>

注意事项

1. 包名一致性：确保 wxapi 包名与你的应用包名一致，这是微信 SDK 的硬性要求。

2. 导出属性：exported="true" 是必须的，否则微信无法回调你的应用。

3. 微信开发者平台配置：在微信开放平台配置应用时，需要填写正确的包名和签名，否则功能将无法正常使用。

4. 多模块冲突：如果项目中集成了其他包含微信 SDK 的模块，可能会引起冲突，需要注意版本一致性。

常见问题排查

1. 回调不生效：检查包名是否正确，以及 AndroidManifest.xml 中的配置是否完整。

2. 功能无法使用：确认已在微信开放平台申请了相应权限（登录、分享或支付）。

3. 混淆问题：如果发布版本出现问题，检查混淆配置是否正确应用。

通过以上步骤，你应该能够成功在 Android 应用中集成 React Native WeChat 模块的所有功能。如果在集成过程中遇到问题，建议仔细检查每一步配置，特别是包名和回调 Activity 的配置。