Langsung ke konten utama
@capgo/capacitor-wechat Komunikasi Open source

WeChat plugin Capacitor

SDK WeChat untuk Capacitor - mendukung autentikasi, sharing, pembayaran, dan mini-programs

Instal

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

Panduan

Cara menggunakan WeChat di Capacitor

Menggunakan @capgo/capacitor-wechat

Plugin Capacitor WeChat - Integrasi SDK WeChat untuk autentikasi, sharing, pembayaran, dan mini-program.

Instal

bun add @capgo/capacitor-wechat
bunx cap sync

bunx cap sync menyalin code native plugin ke dalam proyek native Anda. Jalankan kembali setiap kali melakukan upgrade plugin.

Impor

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

Sekilas tentang API

Metode Deskripsi
initialize Inisialisasi SDK WeChat dengan kredensial aplikasi Anda.
isInstalled Cek apakah aplikasi WeChat terinstal di perangkat.
auth Autentikasi pengguna dengan WeChat OAuth.
share Bagikan konten ke WeChat.
sendPaymentRequest Kirim permintaan pembayaran ke WeChat Pay.
openMiniProgram Buka mini-program WeChat.
chooseInvoice Pilih invoice dari WeChat.

Contoh

initialize()

Inisialisasi SDK WeChat dengan kredensial aplikasi Anda.

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

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

isInstalled()

Cek apakah aplikasi WeChat terinstal di perangkat.

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

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

auth()

Autentikasi pengguna dengan 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()

Bagikan konten ke 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()

Kirim permintaan pembayaran ke 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()

Buka mini-program 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
});

Tabel di atas mencantumkan 7 metode inti. Listener, helper versi, dan kontrak lengkap setiap metode didokumentasikan di repositori GitHub.

Referensi lengkap

Lanjutkan dari Menggunakan @capgo/capacitor-wechat

Jika Anda menggunakan Menggunakan @capgo/capacitor-wechat untuk merencanakan alur autentikasi dan akun, hubungkan dengan @capgo/capacitor-wechat untuk detail implementasi di @capgo/capacitor-wechat, Panduan Memulai untuk detail implementasi di Getting Started, @capgo/capacitor-social-login untuk detail implementasi di @capgo/capacitor-social-login, @capgo/capacitor-passkey untuk detail implementasi di @capgo/capacitor-passkey, dan @capgo/capacitor-native-biometric untuk detail implementasi di @capgo/capacitor-native-biometric.

FAQ

FAQ plugin WeChat

Bagaimana cara install plugin WeChat di aplikasi Capacitor?

Jalankan "bun add @capgo/capacitor-wechat" (atau "npm install @capgo/capacitor-wechat"), lalu jalankan "bunx cap sync" agar proyek iOS dan Android memuat code native. Import dari "@capgo/capacitor-wechat" di code aplikasi Anda.

Apakah @capgo/capacitor-wechat bisa digunakan dengan React, Vue, dan Angular?

Ya. WeChat adalah package Capacitor, jadi bisa digunakan dengan framework web apa pun yang berjalan di dalam Capacitor, termasuk Ionic, React, Vue, Angular, Svelte, dan JavaScript biasa.

Versi Capacitor mana yang didukung oleh @capgo/capacitor-wechat?

Plugin Capgo mengikuti versi mayor Capacitor: gunakan versi mayor plugin yang sesuai dengan versi mayor Capacitor Anda (contoh: plugin v8 dengan Capacitor 8). Tabel kompatibilitas di README GitHub mencantumkan versi yang masih di-maintain.

Apakah @capgo/capacitor-wechat gratis dan open source?

Ya. Source code publik di GitHub pada https://github.com/Cap-go/capacitor-wechat/ dan package ini gratis di-install dari npm. Laporan bug dan pull request sangat kami terima.

Bisakah saya update code yang menggunakan WeChat tanpa review App Store?

Instalasi atau upgrade plugin akan mengubah native code, jadi butuh build store baru. Setelah itu, perubahan JavaScript, HTML, dan CSS yang memanggil plugin bisa langsung dikirim lewat live updates Capgo.

Rilis perubahan WeChat tanpa menunggu review aplikasi

Setelah plugin ada di build store Anda, live updates Capgo akan mengirim perubahan JavaScript, HTML, dan CSS ke pengguna dalam hitungan menit.

Mulai dengan Capgo