Aller directement au contenu principal
@capgo/capacitor-wechat La communication Source

WeChat plugin Capacitor

WeChat SDK pour Capacitor - permet l'authentification, la partage, les paiements et les mini-applications

Installer

bun add @capgo/capacitor-wechat bunx cap sync
npm, pnpm ou yarn
  • npm install @capgo/capacitor-wechat
  • pnpm add @capgo/capacitor-wechat
  • yarn add @capgo/capacitor-wechat

Guide

Comment utiliser WeChat dans Capacitor

Tester sur appareil

Téléchargez l'application Capgo puis scannez le QR code.

Lien QR de prévisualisation du plugin WeChat code

Utilisation de @capgo/capacitor-wechat

Capacitor Plugin WeChat - Intégration WeChat SDK pour l'authentification, la partage, les paiements et les mini-applications

Installer

bun add @capgo/capacitor-wechat
bunx cap sync

bunx cap sync copie le plugin natif code dans vos projets natifs. Exécutez-l’à nouveau après chaque mise à jour du plugin

Importer

import { CapacitorWechat } from '@capgo/capacitor-wechat';

Vue d'ensemble de API

Méthode Description
initialize Initialisez le WeChat SDK avec vos informations d'identification d'application.
isInstalled Vérifiez si l'application WeChat est installée sur le dispositif.
auth Authentifier l'utilisateur avec OAuth WeChat.
share Partagez du contenu vers WeChat.
sendPaymentRequest Envoyez une demande de paiement vers WeChat Pay.
openMiniProgram Ouvrez le programme mini WeChat.
chooseInvoice Choisissez une facture de WeChat.

Exemples

initialize()

Initialisez le WeChat SDK avec vos informations d'identification d'application.

import { CapacitorWechat } from '@capgo/capacitor-wechat';

await CapacitorWechat.initialize({
  appId: 'wx1234567890',
  universalLink: 'https://example.com/app/'
});

isInstalled()

Vérifiez si l'application WeChat est installée sur le dispositif.

import { CapacitorWechat } from '@capgo/capacitor-wechat';

const { installed } = await CapacitorWechat.isInstalled();
if (installed) {
  console.log('WeChat is installed');
}

auth()

Authentifier l'utilisateur avec OAuth WeChat.

import { CapacitorWechat } from '@capgo/capacitor-wechat';

const { code, state } = await CapacitorWechat.auth({
  scope: 'snsapi_userinfo',
  state: 'my_state'
});
// Use code to get access token from your server

share()

Partagez le contenu sur WeChat.

import { CapacitorWechat } from '@capgo/capacitor-wechat';

// Share text
await CapacitorWechat.share({
  scene: 0, // 0 = Session, 1 = Timeline, 2 = Favorite
  type: 'text',
  text: 'Hello WeChat!'
});

// Share link
await CapacitorWechat.share({
  scene: 1,
  type: 'link',
  title: 'My Website',
  description: 'Check out my website',
  link: 'https://example.com',
  imageUrl: 'https://example.com/image.jpg'
});

sendPaymentRequest()

Envoyez une demande de paiement à WeChat Pay.

import { CapacitorWechat } from '@capgo/capacitor-wechat';

// Get payment params from your server first
const paymentParams = await fetchPaymentParamsFromServer();

await CapacitorWechat.sendPaymentRequest({
  partnerId: paymentParams.partnerId,
  prepayId: paymentParams.prepayId,
  nonceStr: paymentParams.nonceStr,
  timeStamp: paymentParams.timeStamp,
  package: paymentParams.package,
  sign: paymentParams.sign
});

openMiniProgram()

Ouvrez le mini-programme WeChat.

import { CapacitorWechat } from '@capgo/capacitor-wechat';

const { extMsg } = await CapacitorWechat.openMiniProgram({
  username: 'gh_xxxxxxxxxxxxx',
  path: 'pages/index/index',
  type: 0 // 0 = Release, 1 = Test, 2 = Preview
});

La table ci-dessus liste les 7 méthodes de base. Les écouteurs et les assistants de version, ainsi que la pleine convention de chaque méthode, sont documentés dans le GitHub dépôt.

Référence complète

Continuez à partir de l'utilisation de @capgo/capacitor-wechat

Si vous utilisez Utilisation de @capgo/capacitor-wechat planifier l'authentification et les flux de compte, connectez-l’avec @capgo/capacitor-wechat pour les détails d'implémentation dans @capgo/capacitor-wechat, Prise en main pour les détails d'implémentation dans Prise en main, @capgo/capacitor-connexion-social pour les détails d'implémentation dans @capgo/capacitor-social-login, @capgo/capacitor-passkey pour les détails d'implémentation dans @capgo/capacitor-passkey, et @capgo/capacitor-native-biometrique pour les détails d'implémentation dans @capgo/capacitor-native-biometric.

FAQ

FAQ du plugin WeChat

Comment installer le plugin WeChat dans une application Capacitor?

Exécutez la commande « bun add @capgo/capacitor-wechat » (ou « npm install @capgo/capacitor-wechat »), puis exécutez « bunx cap sync » afin que les projets iOS et Android prennent en compte le code natif. Importez-l’à partir de « @capgo/capacitor-wechat » dans votre application code.

Fonctionne-t-il @capgo/capacitor-wechat avec React, Vue et Angular ?

Oui. Le package WeChat est un Capacitor, il fonctionne donc avec tout framework web qui tourne à l'intérieur de Capacitor, y compris Ionic, React, Vue, Angular, Svelte et JavaScript pur.

Quelle version de Capacitor supporte @capgo/capacitor-wechat ?

Les plugins Capgo suivent la version majeure de Capacitor : utilisez la version majeure du plugin qui correspond à votre version majeure de Capacitor (par exemple, plugin v8 avec Capacitor 8). La table de compatibilité dans le README du GitHub liste les versions maintenues.

Est-ce que @capgo/capacitor-wechat est gratuit et open source ?

Oui. Le code source de code est public sur GitHub à https://github.com/Cap-go/capacitor-wechat/ et le package est gratuit pour l'installer depuis npm. Les rapports de bugs et les demandes de pull sont les bienvenus.

Puis-je mettre à jour code qui utilise WeChat sans passer par une revue de l'App Store ?

L'installation ou la mise à niveau du plugin change la version native de code, elle nécessite donc une nouvelle construction de l'application. Après cela, les modifications JavaScript, HTML et CSS qui appellent le plugin peuvent être envoyées instantanément avec les mises à jour Capgo.

Envoyer les modifications de WeChat sans attendre la revue de l'application

Une fois le plugin est dans votre magasin de construction, les mises à jour en direct Capgo envoient vos modifications de JavaScript, HTML et CSS aux utilisateurs en quelques minutes.

Commencez avec Capgo