가이드
Capacitor에서 WeChat 사용하는 방법
@capgo/capacitor-wechat 사용하기
Capacitor WeChat Plugin - 인증, 공유, 결제, 미니프로그램을 위한 WeChat SDK 연동
설치
bun add @capgo/capacitor-wechat
bunx cap sync
bunx cap sync 플러그인의 네이티브 code를 네이티브 프로젝트에 복사합니다. 플러그인을 업그레이드할 때마다 다시 실행하세요.
가져오기
import { CapacitorWechat } from '@capgo/capacitor-wechat';
API 한눈에 보기
| 메서드 | 설명 |
|---|---|
initialize |
애플리케이션 자격 증명으로 WeChat SDK를 초기화하세요. |
isInstalled |
기기에 WeChat 앱이 설치되어 있는지 확인합니다. |
auth |
WeChat OAuth로 사용자를 인증합니다. |
share |
WeChat으로 콘텐츠를 공유합니다. |
sendPaymentRequest |
WeChat Pay로 결제 요청을 보냅니다. |
openMiniProgram |
WeChat 미니프로그램을 실행합니다. |
chooseInvoice |
WeChat에서 결제할 인보이스를 선택하세요. |
예시
initialize()
애플리케이션 자격 증명으로 WeChat SDK를 초기화하세요.
import { CapacitorWechat } from '@capgo/capacitor-wechat';
await CapacitorWechat.initialize({
appId: 'wx1234567890',
universalLink: 'https://example.com/app/'
});
isInstalled()
기기에 WeChat 앱이 설치되어 있는지 확인합니다.
import { CapacitorWechat } from '@capgo/capacitor-wechat';
const { installed } = await CapacitorWechat.isInstalled();
if (installed) {
console.log('WeChat is installed');
}
auth()
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()
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()
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()
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
});
위 표에는 7가지 핵심 메서드가 나와 있습니다. 리스너와 버전 헬퍼, 각 메서드의 전체 스펙은 다음 문서에 정리되어 있습니다. GitHub 리포지토리.
전체 레퍼런스
@capgo/capacitor-wechat 사용하기부터 이어서
사용 중이라면 @capgo/capacitor-wechat 사용하기 인증 및 계정 흐름을 설계할 때, 이를 다음 항목과 연결하세요: @capgo/capacitor-wechat @capgo/capacitor-wechat의 구현 세부 사항은, 시작하기 Getting Started의 구현 상세 내용은 @capgo/capacitor-social-login @capgo/capacitor-social-login의 구현 세부 사항은, @capgo/capacitor-passkey @capgo/capacitor-passkey의 구현 세부 사항과 @capgo/capacitor-native-biometric @capgo/capacitor-native-biometric.의 구현 세부 사항은