Zum Hauptinhalt springen
@capgo/capacitor-wechat Kommunikation Open Source

WeChat Capacitor Plugin

WeChat SDK für Capacitor – ermöglicht Authentifizierung, Sharing, Zahlungen und Mini-Programme

Installieren

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

Anleitung

WeChat in Capacitor nutzen

So nutzt du @capgo/capacitor-wechat

Capacitor WeChat-Plugin – WeChat-SDK-Integration für Authentifizierung, Teilen, Zahlungen und Mini-Programme.

Installieren

bun add @capgo/capacitor-wechat
bunx cap sync

bunx cap sync kopiert den nativen code des Plugins in deine nativen Projekte. Nach jedem Plugin-Upgrade erneut ausführen.

Importieren

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

API auf einen Blick

Methode Beschreibung
initialize Initialisiere das WeChat SDK mit deinen App-Zugangsdaten.
isInstalled Prüft, ob die WeChat-App auf dem Gerät installiert ist.
auth Authentifiziert den Nutzer via WeChat OAuth.
share Teilt Inhalte mit WeChat.
sendPaymentRequest Zahlungsanfrage an WeChat Pay senden.
openMiniProgram WeChat Mini-Programm öffnen.
chooseInvoice Rechnung aus WeChat auswählen.

Beispiele

initialize()

Initialisiere das WeChat SDK mit deinen Anwendungs-Credentials.

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

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

isInstalled()

Prüft, ob die WeChat-App auf dem Gerät installiert ist.

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

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

auth()

Authentifiziert den Nutzer via WeChat OAuth.

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()

Teilt Inhalte mit 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()

Zahlungsanfrage an WeChat Pay senden.

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()

WeChat Mini-Programm öffnen.

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
});

Die obige Tabelle listet die 7 Kernmethoden auf. Listener, Version-Helper und der vollständige Contract jeder Methode sind in der GitHub Repository.

Vollständige Referenz

Weiter mit @capgo/capacitor-wechat verwenden

Wenn du es nutzt So nutzt du @capgo/capacitor-wechat Um Authentifizierungs- und Account-Flows zu planen, verbinde es mit @capgo/capacitor-wechat für die Implementierungsdetails in @capgo/capacitor-wechat, Erste Schritte für die Implementierungsdetails in Erste Schritte, @capgo/capacitor-social-login für die Implementierungsdetails in @capgo/capacitor-social-login, @capgo/capacitor-passkey für die Implementierungsdetails in @capgo/capacitor-passkey, und @capgo/capacitor-native-biometric für die Implementierungsdetails in @capgo/capacitor-native-biometric.

FAQ

WeChat Plugin FAQ

Wie installiere ich das WeChat Plugin in einer Capacitor App?

Führe "bun add @capgo/capacitor-wechat" (oder "npm install @capgo/capacitor-wechat") aus und danach "bunx cap sync", damit die iOS- und Android-Projekte das native code übernehmen. Importiere es in deiner App code aus "@capgo/capacitor-wechat".

Funktioniert @capgo/capacitor-wechat mit React, Vue und Angular?

Ja. WeChat ist ein Capacitor Package und funktioniert daher mit jedem Web-Framework, das in Capacitor läuft, einschließlich Ionic, React, Vue, Angular, Svelte und reinem JavaScript.

Welche Version von Capacitor unterstützt @capgo/capacitor-wechat?

Capgo Plugins folgen der Major-Version von Capacitor: Nutze die Plugin-Major-Version, die zu deiner Capacitor Major-Version passt (z. B. Plugin v8 bei Capacitor 8). Die Kompatibilitätstabelle im GitHub README listet die gepflegten Versionen auf.

Ist @capgo/capacitor-wechat kostenlos und Open Source?

Ja. Der Source-code ist auf GitHub unter https://github.com/Cap-go/capacitor-wechat/ öffentlich einsehbar und das Package lässt sich kostenlos über npm installieren. Bug-Reports und Pull Requests sind willkommen.

Kann ich code mit WeChat aktualisieren, ohne ein App Store Review?

Die Installation oder ein Upgrade des Plugins ändert den nativen code, weshalb ein neuer Store-Build nötig ist. Danach können JavaScript-, HTML- und CSS-Änderungen, die das Plugin aufrufen, sofort per Capgo Live Updates ausgeliefert werden.

WeChat-Änderungen veröffentlichen, ohne auf den App-Review zu warten

Sobald das Plugin in deinem Store-Build ist, bringt Capgo mit Live-Updates deine JavaScript-, HTML- und CSS-Änderungen in Minuten zu den Nutzern.

Starte mit Capgo