Saltare al contenuto principale
@capgo/capacitor-wechat Comunicazione Sorgente aperta

WeChat Plugin Capacitor

WeChat SDK per Capacitor - abilita l'autenticazione, la condivisione, i pagamenti e i mini-programmi

Installa

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

Guida

Come utilizzare WeChat in Capacitor

Utilizzare @capgo/capacitor-wechat

Capacitor Plugin WeChat - integrazione WeChat SDK per l'autenticazione, la condivisione, i pagamenti e i mini-programmi.

Installare

bun add @capgo/capacitor-wechat
bunx cap sync

bunx cap sync copia il plugin nativo code nei tuoi progetti nativi. Esegui nuovamente dopo ogni aggiornamento del plugin.

Importare

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

API in un colpo di dito

Metodo Descrizione
initialize Inizializza il SDK WeChat con le tue credenziali di applicazione.
isInstalled Controlla se l'app WeChat è installata sul dispositivo.
auth Autentica l'utente con OAuth WeChat.
share Condividi contenuti su WeChat.
sendPaymentRequest Invia richiesta di pagamento a WeChat Pay.
openMiniProgram Apre il mini-programma di WeChat.
chooseInvoice Scegli fattura da WeChat.

Esempi

initialize()

Avvia il WeChat SDK con le tue credenziali dell'applicazione.

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

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

isInstalled()

Controlla se l'app di WeChat è installata sul dispositivo.

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

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

auth()

Autenticazione dell'utente con 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()

Condividi contenuti su 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()

Invia richiesta di pagamento a 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()

Apre il mini-programma di 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 tabella sopra elenca le 7 metodologie di base. I listener e gli aiuti di versione, nonché il contratto completo di ogni metodo, sono documentati nella GitHub repository.

Riferimento completo

Continua da Utilizzo di @capgo/capacitor-wechat

Se stai utilizzando Utilizzo di @capgo/capacitor-wechat Per pianificare l'autenticazione e i flussi di account, connettilo con @capgo/capacitor-wechat per i dettagli di implementazione in @capgo/capacitor-wechat Getting Started per i dettagli di implementazione in Getting Started, @capgo/capacitor-login sociale per i dettagli di implementazione in @capgo/capacitor-social-login, @capgo/capacitor-chiave passiva per i dettagli di implementazione in @capgo/capacitor-passkey, e @capgo/capacitor-biometria nativa per i dettagli di implementazione in @capgo/capacitor-native-biometric.

FAQ

Domande frequenti del plugin WeChat

Come posso installare il plugin WeChat in un'app Capacitor?

Esegui "bun add @capgo/capacitor-wechat" (o "npm install @capgo/capacitor-wechat"), quindi esegui "bunx cap sync" affinché i progetti iOS e Android recuperino i nativi code. Importalo da "@capgo/capacitor-wechat" nella tua app code.

Funziona @capgo/capacitor-wechat con React, Vue e Angular?

Sì. WeChat è un pacchetto Capacitor, quindi funziona con qualsiasi framework web che esegue all'interno di Capacitor, compresi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Qual è la versione di Capacitor supportata da @capgo/capacitor-wechat?

I plugin Capgo seguono la versione maggiore di Capacitor: utilizza la versione del plugin maggiore che corrisponde alla tua versione maggiore di Capacitor (ad esempio plugin v8 con Capacitor 8). La tabella di compatibilità nel README del GitHub elenca le versioni mantenute.

È @capgo/capacitor-wechat gratuito e open source?

Sì. Il codice sorgente code è pubblico su GitHub in https://github.com/Cap-go/capacitor-wechat/ e il pacchetto è gratuito per l'installazione da npm. I rapporti di bug e le richieste di pull sono benvenuti.

Posso aggiornare code che utilizza WeChat senza una revisione dell'App Store?

L'installazione o l'aggiornamento del plugin modifica il codice nativo code, quindi richiede una nuova costruzione dello store. Dopo di che, le modifiche JavaScript, HTML e CSS che chiamano il plugin possono essere distribuite immediatamente con gli aggiornamenti live di Capgo.

Invia modifiche a WeChat senza dover attendere la revisione dell'app

Una volta che il plugin è presente nella tua store build, le Capgo aggiornamenti live inviano le tue modifiche JavaScript, HTML e CSS agli utenti in pochi minuti.

Inizia con Capgo