@gyjshow/react-native-wechat 1.0.0

package/README.md

@@ -0,0 +1,245 @@
+# @gyjshow/react-native-wechat
+
+A lightweight **React Native** plugin for integrating **WeChat Pay & WeChat Share** on both **iOS** and **Android**.
+
+Supports:
+
+- ✅ WeChat Pay
+- ✅ Share Text
+- ✅ Share Webpage
+- ✅ Share Image
+- ✅ Share to Friends & Moments
+- ✅ Get WeChat SDK Version
+
+Compatible with **React Native >= 0.83**
+
+---
+
+# Features
+
+- 🔹 Unified API for iOS & Android
+- 🔹 Supports WeChat Pay
+- 🔹 Share text / webpage / image
+- 🔹 Share to friends (`session`) & Moments (`timeline`)
+- 🔹 Fetch WeChat SDK version
+- 🔹 Lightweight & easy to integrate
+
+---
+
+# Installation
+
+```bash
+# Using npm
+npm install @gyjshow/react-native-wechat
+
+# Using pnpm
+pnpm add @gyjshow/react-native-wechat
+```
+
+---
+
+# Platform Setup
+
+---
+
+## iOS Setup
+
+### 1️⃣ Add URL Scheme (WeChat AppID)
+
+Open `ios/YourProject/Info.plist` and add:
+
+```xml
+<key>CFBundleURLTypes</key>
+<array>
+  <dict>
+    <key>CFBundleURLSchemes</key>
+    <array>
+      <string>wx1234567890abcdef</string>
+    </array>
+  </dict>
+</array>
+```
+
+⚠️ Replace `wx1234567890abcdef` with your real WeChat AppID.
+
+---
+
+### 2️⃣ Install Pods
+
+```bash
+cd ios
+pod install
+```
+
+---
+
+## Android Setup
+
+No additional configuration required beyond normal React Native setup.
+
+Make sure:
+
+- Your AppID is registered in WeChat Open Platform
+- You are using official SDK version `6.8.0`
+- Your package name matches the one registered in WeChat
+
+---
+
+# Usage
+
+---
+
+## Import
+
+```ts
+import WeChat from '@gyjshow/react-native-wechat';
+```
+
+---
+
+## Register App (Required)
+
+You must register your AppID before using any feature.
+
+```ts
+WeChat.registerApp('wx1234567890abcdef');
+```
+
+Call this once when your app starts.
+
+---
+
+# WeChat Pay
+
+WeChat Pay requires server-side order generation.
+
+```ts
+const payParams = {
+  appId: 'wx123456',
+  partnerId: '1900000109',
+  prepayId: 'wx201411101639507cbf6ffd8b0779950874',
+  nonceStr: '1101000000140429eb40476f8896f4c9',
+  timeStamp: '1398746574',
+  package: 'Sign=WXPay',
+  sign: 'C380BEC2BFD727A4B6845133519F3AD6'
+};
+
+try {
+  const result = await WeChat.pay(payParams);
+  console.log('Pay result:', result);
+} catch (error) {
+  console.error('Pay failed:', error);
+}
+```
+
+---
+
+# Share Text
+
+```ts
+await WeChat.shareText('Hello WeChat!', 'session');   // Share to friend
+await WeChat.shareText('Hello Moments!', 'timeline'); // Share to Moments
+```
+
+---
+
+# Share Webpage
+
+```ts
+await WeChat.shareWebpage(
+  'https://your-website.com',
+  'Website Title',
+  'Website description',
+  null,               // optional thumbnail (base64, ≤32KB)
+  'session'
+);
+```
+
+---
+
+# Share Image
+
+```ts
+await WeChat.shareImage(base64ImageString, 'timeline');
+```
+
+> Image must be Base64 format.
+
+---
+
+# Get WeChat SDK Version
+
+```ts
+const version = await WeChat.getVersion();
+console.log('WeChat SDK version:', version);
+```
+
+---
+
+# API Reference
+
+| Method | Params | Returns | Description |
+|--------|--------|---------|------------|
+| `registerApp(appId: string)` | WeChat AppID | `void` | Register WeChat App |
+| `pay(params)` | WeChat pay params | `Promise<string>` | Initiate WeChat payment |
+| `shareText(text, scene)` | text, `session` / `timeline` | `Promise<string>` | Share text |
+| `shareWebpage(url, title, desc, thumbBase64, scene)` | webpage params | `Promise<string>` | Share webpage |
+| `shareImage(base64, scene)` | base64 image | `Promise<string>` | Share image |
+| `getVersion()` | - | `Promise<string>` | Get WeChat SDK version |
+
+---
+
+# Example
+
+```ts
+import React, { useEffect } from 'react';
+import { Button, View, Alert } from 'react-native';
+import WeChat from '@gyjshow/react-native-wechat';
+
+export default function App() {
+
+  useEffect(() => {
+    WeChat.registerApp('wx1234567890abcdef');
+  }, []);
+
+  const handlePay = async () => {
+    try {
+      const result = await WeChat.pay({
+        appId: 'wx123456',
+        partnerId: '1900000109',
+        prepayId: 'prepay_id',
+        nonceStr: 'nonce',
+        timeStamp: '1234567890',
+        package: 'Sign=WXPay',
+        sign: 'xxxx'
+      });
+
+      Alert.alert('Pay Result', result);
+    } catch (e: any) {
+      Alert.alert('Pay Failed', e.message);
+    }
+  };
+
+  return (
+    <View>
+      <Button title="Pay with WeChat" onPress={handlePay} />
+    </View>
+  );
+}
+```
+
+---
+
+# Notes
+
+- You must register your app in WeChat Open Platform.
+- WeChat Pay requires backend order generation.
+- Thumbnail size must be ≤ 32KB (WeChat official requirement).
+- Ensure your AppID matches your bundle identifier (iOS) and package name (Android).
+- Test in sandbox before production.
+
+---
+
+# License
+
+MIT

package/android/build.gradle

@@ -0,0 +1,33 @@
+buildscript {
+    def kotlinVersion = rootProject.ext.has('kotlinVersion')
+            ? rootProject.ext.get('kotlinVersion')
+            : '2.1.20'
+
+    repositories {
+        google()
+        mavenCentral()
+    }
+
+    dependencies {
+        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlinVersion"
+    }
+}
+
+apply plugin: 'com.android.library'
+apply plugin: 'kotlin-android'
+
+android {
+    namespace "com.gyj.wechat"
+    compileSdkVersion rootProject.ext.compileSdkVersion
+
+    defaultConfig {
+        minSdkVersion rootProject.ext.minSdkVersion
+        targetSdkVersion rootProject.ext.targetSdkVersion
+    }
+}
+
+dependencies {
+    implementation "com.facebook.react:react-android"
+    implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlinVersion"
+		api 'com.tencent.mm.opensdk:wechat-sdk-android:+'
+}

package/android/src/main/java/com/gyj/wechat/RNWeChatModule.kt

@@ -0,0 +1,103 @@
+// Kotlin 模块实现
+package com.gyj.wechat
+
+import com.facebook.react.bridge.*
+import com.tencent.mm.opensdk.modelpay.PayReq
+import com.tencent.mm.opensdk.modelmsg.*
+import com.tencent.mm.opensdk.openapi.WXAPIFactory
+import com.tencent.mm.opensdk.openapi.IWXAPI
+import android.util.Base64
+
+class RNWeChatModule(private val reactContext: ReactApplicationContext) :
+    ReactContextBaseJavaModule(reactContext) {
+
+    private var wxApi: IWXAPI? = null
+
+    override fun getName() = "RNWeChat"
+
+    @ReactMethod
+    fun registerApp(appId: String) {
+        wxApi = WXAPIFactory.createWXAPI(reactContext, appId, true)
+        wxApi?.registerApp(appId)
+    }
+
+    @ReactMethod
+    fun getVersion(promise: Promise) {
+        promise.resolve(wxApi?.WXAppSupportAPI?.toString() ?: "unknown")
+    }
+
+    @ReactMethod
+    fun pay(payInfo: ReadableMap, promise: Promise) {
+        val req = PayReq()
+        req.appId = payInfo.getString("appId")
+        req.partnerId = payInfo.getString("partnerId")
+        req.prepayId = payInfo.getString("prepayId")
+        req.nonceStr = payInfo.getString("nonceStr")
+        req.timeStamp = payInfo.getString("timeStamp")
+        req.packageValue = payInfo.getString("package")
+        req.sign = payInfo.getString("sign")
+
+        val result = wxApi?.sendReq(req) ?: false
+        if (result) promise.resolve("success")
+        else promise.reject("PAY_FAILED", "支付请求失败")
+    }
+
+    @ReactMethod
+    fun shareText(text: String, scene: Int, promise: Promise) {
+        val textObj = WXTextObject()
+        textObj.text = text
+
+        val msg = WXMediaMessage()
+        msg.mediaObject = textObj
+
+        val req = SendMessageToWX.Req()
+        req.transaction = System.currentTimeMillis().toString()
+        req.message = msg
+        req.scene = scene
+
+        val result = wxApi?.sendReq(req) ?: false
+        if (result) promise.resolve("success")
+        else promise.reject("SHARE_FAILED", "分享失败")
+    }
+
+    @ReactMethod
+    fun shareWebpage(url: String, title: String, desc: String, thumbBase64: String?, scene: Int, promise: Promise) {
+        val webpage = WXWebpageObject()
+        webpage.webpageUrl = url
+
+        val msg = WXMediaMessage(webpage)
+        msg.title = title
+        msg.description = desc
+
+        thumbBase64?.let {
+            msg.thumbData = Base64.decode(it, Base64.DEFAULT)
+        }
+
+        val req = SendMessageToWX.Req()
+        req.transaction = System.currentTimeMillis().toString()
+        req.message = msg
+        req.scene = scene
+
+        val result = wxApi?.sendReq(req) ?: false
+        if (result) promise.resolve("success")
+        else promise.reject("SHARE_FAILED", "分享失败")
+    }
+
+    @ReactMethod
+    fun shareImage(base64: String, scene: Int, promise: Promise) {
+        val imgObj = WXImageObject()
+        imgObj.imageData = Base64.decode(base64, Base64.DEFAULT)
+
+        val msg = WXMediaMessage()
+        msg.mediaObject = imgObj
+
+        val req = SendMessageToWX.Req()
+        req.transaction = System.currentTimeMillis().toString()
+        req.message = msg
+        req.scene = scene
+
+        val result = wxApi?.sendReq(req) ?: false
+        if (result) promise.resolve("success")
+        else promise.reject("SHARE_FAILED", "分享失败")
+    }
+}

package/android/src/main/java/com/gyj/wechat/RNWeChatPackage.kt

@@ -0,0 +1,18 @@
+// Kotlin 包实现
+
+package com.gyj.wechat
+
+import com.facebook.react.ReactPackage
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.uimanager.ViewManager
+import com.facebook.react.bridge.ReactApplicationContext
+
+class RNWeChatPackage : ReactPackage {
+    override fun createNativeModules(reactContext: ReactApplicationContext): List<NativeModule> {
+        return listOf(RNWeChatModule(reactContext))
+    }
+
+    override fun createViewManagers(reactContext: ReactApplicationContext): List<ViewManager<*, *>> {
+        return emptyList()
+    }
+}

package/ios/RNWeChat/RNWeChat.h

@@ -0,0 +1,5 @@
+#import <React/RCTBridgeModule.h>
+
+@interface RNWeChat : NSObject <RCTBridgeModule>
+
+@end

package/ios/RNWeChat/RNWeChat.m

@@ -0,0 +1,83 @@
+#import "RNWeChat.h"
+#import <WechatOpenSDK/WXApi.h>
+
+@implementation RNWeChat
+
+RCT_EXPORT_MODULE();
+
+RCT_EXPORT_METHOD(registerApp:(NSString *)appId) {
+    [WXApi registerApp:appId];
+}
+
+RCT_EXPORT_METHOD(getVersion:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject) {
+    resolve([WXApi getApiVersion]);
+}
+
+RCT_EXPORT_METHOD(pay:(NSDictionary *)params resolver:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject) {
+    PayReq *req = [[PayReq alloc] init];
+    req.appId = params[@"appId"];
+    req.partnerId = params[@"partnerId"];
+    req.prepayId = params[@"prepayId"];
+    req.nonceStr = params[@"nonceStr"];
+    req.timeStamp = [params[@"timeStamp"] intValue];
+    req.package = params[@"package"];
+    req.sign = params[@"sign"];
+
+    BOOL result = [WXApi sendReq:req];
+    result ? resolve(@"success") : reject(@"PAY_FAILED", @"支付失败", nil);
+}
+
+RCT_EXPORT_METHOD(shareText:(NSString *)text scene:(NSInteger)scene resolver:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject) {
+    SendMessageToWXReq *req = [[SendMessageToWXReq alloc] init];
+    req.text = text;
+    req.bText = YES;
+    req.scene = (int)scene;
+
+    BOOL result = [WXApi sendReq:req];
+    result ? resolve(@"success") : reject(@"SHARE_FAILED", @"分享失败", nil);
+}
+
+RCT_EXPORT_METHOD(shareWebpage:(NSString *)url title:(NSString *)title description:(NSString *)desc thumbBase64:(NSString *)thumb scene:(NSInteger)scene resolver:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject) {
+
+    WXWebpageObject *webpage = [WXWebpageObject object];
+    webpage.webpageUrl = url;
+
+    WXMediaMessage *msg = [WXMediaMessage message];
+    msg.title = title;
+    msg.description = desc;
+    msg.mediaObject = webpage;
+
+    if (thumb) {
+        NSData *data = [[NSData alloc] initWithBase64EncodedString:thumb options:0];
+        msg.thumbData = data;
+    }
+
+    SendMessageToWXReq *req = [[SendMessageToWXReq alloc] init];
+    req.bText = NO;
+    req.message = msg;
+    req.scene = (int)scene;
+
+    BOOL result = [WXApi sendReq:req];
+    result ? resolve(@"success") : reject(@"SHARE_FAILED", @"分享失败", nil);
+}
+
+RCT_EXPORT_METHOD(shareImage:(NSString *)base64 scene:(NSInteger)scene resolver:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject) {
+
+    NSData *data = [[NSData alloc] initWithBase64EncodedString:base64 options:0];
+
+    WXImageObject *imgObj = [WXImageObject object];
+    imgObj.imageData = data;
+
+    WXMediaMessage *msg = [WXMediaMessage message];
+    msg.mediaObject = imgObj;
+
+    SendMessageToWXReq *req = [[SendMessageToWXReq alloc] init];
+    req.bText = NO;
+    req.message = msg;
+    req.scene = (int)scene;
+
+    BOOL result = [WXApi sendReq:req];
+    result ? resolve(@"success") : reject(@"SHARE_FAILED", @"分享失败", nil);
+}
+
+@end

package/lib/index.d.ts

@@ -0,0 +1,10 @@
+export type Scene = 'session' | 'timeline';
+declare const WeChat: {
+    registerApp(appId: string): void;
+    getVersion(): Promise<string>;
+    wxpay(params: Record<string, string>): Promise<string>;
+    shareText(text: string, scene: Scene): Promise<string>;
+    shareWebpage(url: string, title: string, description: string, thumbBase64: string | null, scene: Scene): Promise<string>;
+    shareImage(base64: string, scene: Scene): Promise<string>;
+};
+export default WeChat;

package/lib/index.js

@@ -0,0 +1,24 @@
+import { NativeModules } from 'react-native';
+const { RNWeChat } = NativeModules;
+const getScene = (scene) => (scene === 'session' ? 0 : 1);
+const WeChat = {
+    registerApp(appId) {
+        RNWeChat.registerApp(appId);
+    },
+    getVersion() {
+        return RNWeChat.getVersion();
+    },
+    wxpay(params) {
+        return RNWeChat.pay(params);
+    },
+    shareText(text, scene) {
+        return RNWeChat.shareText(text, getScene(scene));
+    },
+    shareWebpage(url, title, description, thumbBase64, scene) {
+        return RNWeChat.shareWebpage(url, title, description, thumbBase64, getScene(scene));
+    },
+    shareImage(base64, scene) {
+        return RNWeChat.shareImage(base64, getScene(scene));
+    }
+};
+export default WeChat;

package/package.json

@@ -0,0 +1,36 @@
+{
+	"name": "@gyjshow/react-native-wechat",
+	"version": "1.0.0",
+	"private": false,
+	"description": "React Native WeChat plugin for WeChat Pay and Share (iOS & Android)",
+	"main": "lib/index.js",
+	"types": "lib/index.d.ts",
+	"files": [
+		"lib",
+		"ios",
+		"android",
+		"*.podspec",
+		"README.md"
+	],
+	"scripts": {
+		"build": "tsc",
+		"prepare": "npm run build"
+	},
+	"keywords": [
+		"react-native",
+		"wechat",
+		"wechatpay",
+		"share"
+	],
+	"author": "Allen.ge",
+	"license": "MIT",
+	"peerDependencies": {
+		"react": "*",
+		"react-native": ">=0.60.0"
+	},
+	"devDependencies": {
+		"@types/react": "^19.2.13",
+		"react-native": "^0.83.1",
+		"typescript": "^5.9.3"
+	}
+}

package/react-native-wechat.podspec

@@ -0,0 +1,21 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name         = "react-native-wechat"
+  s.version      = package['version']
+  s.summary      = package['description']
+  s.license      = package['license']
+
+  s.authors      = package['author']
+  s.homepage     = package['homepage']
+  s.platform     = :ios, "9.0"
+ 
+	s.source = { :http => 'file://' + __dir__ }
+
+  s.source_files = "ios/**/*.{h,m}"
+
+  s.dependency 'React-Core'
+  s.dependency 'WechatOpenSDK-XCFramework'
+end