How to set up react-native-wechat for iOS?

Follow the iOS build setup guide in the docs, which involves adding the WeChat SDK via CocoaPods or manual linking, and configuring the app ID. Ensure you have Xcode and the correct SDK version installed.

Why does sharing an image URL fail in react-native-wechat?

The README notes that sharing raw HTTP(s) images from the web can fail for unknown reasons. It recommends using local image files or resources instead, as demonstrated in the code examples with react-native-fs.

react-native-wechat vs other WeChat libraries: which one should I use?

React-native-wechat is well-established with comprehensive documentation and active maintenance. Compare based on SDK version support, ease of setup, and community activity; this library is often preferred for its reliability and feature completeness.

How to handle WeChat login with async/await in react-native-wechat?

Use the sendAuthRequest method, which returns a Promise. You can await it and handle the response object containing fields like openId and code for OAuth2 flow, as shown in the API docs with error handling examples.

Is react-native-wechat compatible with Expo?

No, it requires linking native modules, so it's not compatible with the Expo Go client. You would need to eject to a bare workflow or use a development build to integrate it.

How to share a local file like a PDF to WeChat using this library?

Use the shareToSession method with type 'file', providing the filePath and fileExtension. Save the file locally using a package like react-native-fs, as detailed in the README examples for both iOS and Android paths.

react-native-wechat — React Native WeChat SDK Bridge

What is react-native-wechat?

React-Native-Wechat is a bridging library that integrates the official WeChat SDK into React Native applications for iOS and Android. It provides a unified JavaScript interface for essential WeChat functionalities like login, sharing, and payment, allowing developers to incorporate WeChat services seamlessly into their mobile apps. The library simplifies the integration of WeChat's native SDKs while adhering to React Native's design principles.

Target Audience

React Native developers building mobile applications for the Chinese market that require integration with WeChat services such as authentication, social sharing, or payments. This includes teams creating apps for e-commerce, social networking, or any service needing WeChat login or sharing capabilities.

Value Proposition

Developers choose React-Native-Wechat because it offers a reliable, well-documented bridge to the official WeChat SDK with full feature compatibility, including support for the latest iOS and Android SDK versions. Its promise-based API provides a modern, clean interface for async/await patterns, reducing the complexity of native module integration compared to building custom bridges.

🚀 WeChat login, share, favorite and payment for React-Native on iOS and Android platforms (QQ: 336021910)

Use Cases

Best For

Adding WeChat OAuth2 login to a React Native app for user authentication in China.
Implementing social sharing to WeChat Timeline or Sessions from a React Native app, supporting text, images, videos, files, and web links.
Integrating WeChat Pay for processing in-app payments within React Native e-commerce or service applications.
Checking WeChat app installation and SDK support to conditionally enable features in a React Native app.
Sharing local files (e.g., documents or images) from a React Native app to WeChat chats or groups.
Opening the WeChat app directly from a React Native application for seamless user transitions.

Not Ideal For

Expo-managed projects that rely on the Expo Go client and avoid ejecting for native modules, as this library requires linking the WeChat SDK.
Applications targeting global markets without a significant user base in China, where WeChat integration is unnecessary or low-priority.
Teams needing a social sharing library that supports multiple platforms (e.g., Facebook, Twitter) beyond WeChat, as this is WeChat-only.

Pros & Cons

Pros

Official SDK Bridge

Integrates the latest official WeChat SDKs (iOS 1.7.2, Android 221), ensuring full feature compatibility and reliability for WeChat services like login, sharing, and pay.

Comprehensive WeChat Features

Supports all core WeChat functionalities including OAuth2 login, social sharing to Timeline/Sessions, WeChat Pay, and app integration checks, as detailed in the API documentation.

Modern Promise-based API

All methods return Promises, enabling clean async/await patterns and straightforward error handling with WechatError instances, as shown in the code examples.

Detailed Code Examples

Provides extensive, practical code snippets for various sharing scenarios, such as sharing images from files or resources, which helps in implementation and debugging.

Cons

Platform-Specific Sharing Issues

The README admits that sharing raw HTTP(s) image URLs from the web can fail unpredictably, forcing developers to use local files or resources instead, adding complexity.

Complex Native Setup

Requires separate build setup for iOS and Android with manual linking of the WeChat SDK, which can be error-prone and time-consuming, as indicated by the separate documentation files.

Limited to WeChat Only

Focuses exclusively on WeChat integration, so teams needing multi-platform social features must integrate additional libraries, increasing project dependency management overhead.

Frequently Asked Questions

What is react-native-wechat?

Target Audience

Value Proposition

Use Cases

Best For

Adding WeChat OAuth2 login to a React Native app for user authentication in China.
Implementing social sharing to WeChat Timeline or Sessions from a React Native app, supporting text, images, videos, files, and web links.
Integrating WeChat Pay for processing in-app payments within React Native e-commerce or service applications.
Checking WeChat app installation and SDK support to conditionally enable features in a React Native app.
Sharing local files (e.g., documents or images) from a React Native app to WeChat chats or groups.
Opening the WeChat app directly from a React Native application for seamless user transitions.

Not Ideal For

Expo-managed projects that rely on the Expo Go client and avoid ejecting for native modules, as this library requires linking the WeChat SDK.
Applications targeting global markets without a significant user base in China, where WeChat integration is unnecessary or low-priority.
Teams needing a social sharing library that supports multiple platforms (e.g., Facebook, Twitter) beyond WeChat, as this is WeChat-only.

Pros & Cons

Pros

Official SDK Bridge

Integrates the latest official WeChat SDKs (iOS 1.7.2, Android 221), ensuring full feature compatibility and reliability for WeChat services like login, sharing, and pay.

Comprehensive WeChat Features

Supports all core WeChat functionalities including OAuth2 login, social sharing to Timeline/Sessions, WeChat Pay, and app integration checks, as detailed in the API documentation.

Modern Promise-based API

All methods return Promises, enabling clean async/await patterns and straightforward error handling with WechatError instances, as shown in the code examples.

Detailed Code Examples

Provides extensive, practical code snippets for various sharing scenarios, such as sharing images from files or resources, which helps in implementation and debugging.

Cons

Platform-Specific Sharing Issues

The README admits that sharing raw HTTP(s) image URLs from the web can fail unpredictably, forcing developers to use local files or resources instead, adding complexity.

Complex Native Setup

Requires separate build setup for iOS and Android with manual linking of the WeChat SDK, which can be error-prone and time-consuming, as indicated by the separate documentation files.

Limited to WeChat Only

Focuses exclusively on WeChat integration, so teams needing multi-platform social features must integrate additional libraries, increasing project dependency management overhead.

Frequently Asked Questions

react-native-wechat

What is react-native-wechat?

Overview

Use Cases

Best For

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions

Related Projects

Found a gem we're missing?

react-native-wechat

What is react-native-wechat?

Overview

Use Cases

Best For

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions

Related Projects

Found a gem we're missing?