Saltar al contenido principal
@capgo/capacitor-wechat Comunicación Fuente abierta

WeChat Plugin de Capacitor

WeChat SDK para Capacitor - permite la autenticación, compartir, pagos y mini-aplicaciones

Instalar

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

Guía

¿Cómo usar WeChat en Capacitor

Usando @capgo/capacitor-wechat

Capacitor WeChat Plugin - Integración de WeChat SDK para autenticación, compartición, pagos y mini-aplicaciones.

Instalar

bun add @capgo/capacitor-wechat
bunx cap sync

bunx cap sync Copia el plugin nativo code en tus proyectos nativos. Correlo nuevamente después de cada actualización del plugin.

Importar

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

API en resumen

Método Descripción
initialize Inicializa el WeChat SDK con tus credenciales de aplicación.
isInstalled Verifica si la aplicación WeChat está instalada en el dispositivo.
auth Autentica al usuario con OAuth de WeChat.
share Compartir contenido en WeChat.
sendPaymentRequest Enviar solicitud de pago a WeChat Pay.
openMiniProgram Abrir programa mini de WeChat.
chooseInvoice Elegir factura de WeChat.

Ejemplos

initialize()

Configurar el programa WeChat SDK con tus credenciales de aplicación.

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

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

isInstalled()

Verificar si el programa WeChat está instalado en el dispositivo.

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

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

auth()

Autenticar al usuario con OAuth de 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()

Compartir contenido en 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()

Enviar solicitud de pago 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()

Abrir programa mini de 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 tabla anterior muestra los 7 métodos básicos. Los ayudantes de escucha y versión, y la completa contratación de cada método, se documentan en el GitHub repositorio.

Referencia completa

Sigue adelante desde Usando @capgo/capacitor-wechat

Si estás utilizando Usando @capgo/capacitor-wechat para planificar la autenticación y los flujos de cuenta, conecta con @capgo/capacitor-wechat para los detalles de implementación en @capgo/capacitor-wechat Inicio rápido Para los detalles de implementación en Getting Started, @capgo/capacitor-login-social Para los detalles de implementación en @capgo/capacitor-social-login, @capgo/capacitor-clave-llave Para los detalles de implementación en @capgo/capacitor-passkey, y @capgo/capacitor-biometría-nativa Para los detalles de implementación en @capgo/capacitor-native-biometric.

FAQ

FAQ del plugin de WeChat

¿Cómo instalo el plugin de WeChat en una aplicación Capacitor?

Ejecuta "bun add @capgo/capacitor-wechat" (o "npm install @capgo/capacitor-wechat"), luego ejecuta "bunx cap sync" para que los proyectos iOS y Android capturen el nativo code. Importa desde "@capgo/capacitor-wechat" en tu aplicación code.

¿Funciona @capgo/capacitor-wechat con React, Vue y Angular?

Sí. WeChat es un paquete Capacitor, por lo que funciona con cualquier framework web que se ejecute dentro de Capacitor, incluyendo Ionic, React, Vue, Angular, Svelte y JavaScript puro.

¿Qué versión de Capacitor soporta @capgo/capacitor-wechat?

Los plugins de Capgo siguen la versión mayor de Capacitor: utiliza la versión mayor del plugin que coincida con la versión mayor de Capacitor (por ejemplo, plugin v8 con Capacitor 8). La tabla de compatibilidad en el README del GitHub lista las versiones mantenidas.

¿Es capgo/capacitor-wechat gratuito y de código abierto?

¡Sí. El código fuente de code está disponible en GitHub en https://github.com/Cap-go/capacitor-wechat/ y el paquete es gratuito para instalar desde npm. Se agradecen los informes de errores y solicitudes de extracción.

Puedo actualizar code que utiliza WeChat sin una revisión de la Tienda de Aplicaciones?

Al instalar o actualizar el plugin, se cambia el code nativo, por lo que necesita una nueva compilación de la tienda. Después de eso, los cambios en JavaScript, HTML y CSS que llaman al plugin pueden enviar actualizaciones en vivo con Capgo instantáneamente.

Envíe cambios de WeChat sin esperar a la revisión de la aplicación

Una vez que el plugin esté en tu tienda de construcción, Capgo actualizaciones en vivo envían tus cambios de JavaScript, HTML y CSS a los usuarios en minutos.

Comienza con Capgo