콘텐츠로 건너뛰기

Capacitor SDK 빠른 시작

이 빠르고 간단한 예제를 사용하여 Pushwoosh Capacitor SDK를 시작해 보세요.

사전 요구 사항

Anchor link to

Pushwoosh Capacitor SDK를 앱에 통합하려면 다음이 필요합니다:

예제 프로젝트 다운로드

Anchor link to

SDK 리포지토리를 복제합니다:

Terminal window
git clone https://github.com/Pushwoosh/pushwoosh-capacitor-plugin.git

플러그인 디렉토리로 이동합니다:

Terminal window
cd pushwoosh-capacitor-plugin

플러그인 빌드

Anchor link to

예제 앱을 실행하기 전에 Capacitor 플러그인을 빌드해야 합니다.
플러그인 종속성을 설치합니다:

Terminal window
npm i

플러그인을 빌드합니다:

Terminal window
npm run build

예제 앱 구성

Anchor link to

예제 앱 디렉토리로 이동합니다:

Terminal window
cd example

앱 종속성을 설치합니다:

Terminal window
npm i

웹 에셋을 빌드합니다:

Terminal window
npm run build

src/js/example.js를 열고 Pushwoosh.onDeviceReady 호출을 업데이트합니다:

Pushwoosh.onDeviceReady({
projectid: "__YOUR_FCM_SENDER_ID__",
appid: "__YOUR_APP_CODE__"
});

여기서:

__YOUR_APP_CODE__는 Pushwoosh Control Panel의 애플리케이션 코드입니다. __YOUR_FCM_SENDER_ID__는 Firebase Console의 Firebase 프로젝트 번호입니다.

1. CocoaPods 종속성 설치
Anchor link to

iOS 플랫폼 디렉토리로 이동하여 CocoaPods 종속성을 설치합니다:

Terminal window
cd ios/App
pod install --repo-update
cd ../..
2. Capacitor를 iOS에 동기화
Anchor link to

CocoaPods를 설치한 후 Capacitor 구성을 동기화합니다:

Terminal window
npx cap sync ios
3. iOS 프로젝트 열기
Anchor link to

Xcode에서 프로젝트를 엽니다:

Terminal window
npx cap open ios
3. Bundle Identifier 설정
Anchor link to

Xcode에서 Bundle Identifier를 앱의 패키지 이름(예: com.example.pushwoosh)으로 설정합니다.

5. 기능 추가
Anchor link to

푸시 알림을 활성화하려면 특정 기능을 추가해야 합니다.

Signing & Capabilities 섹션에서 다음 기능을 추가합니다:

  • Push Notifications
  • Background Modes. 이 기능을 추가한 후 Remote notifications 확인란을 선택합니다.
6. API 토큰 설정
Anchor link to

Xcode에서 ios/App/App/Info.plist를 열고 Pushwoosh Device API Token으로 다음 항목을 추가합니다:

Info.plist
<key>Pushwoosh_API_TOKEN</key>
<string>__YOUR_PUSHWOOSH_DEVICE_API_TOKEN__</string>
1. Capacitor를 Android에 동기화
Anchor link to

Capacitor 구성을 Android 플랫폼에 동기화합니다:

Terminal window
npx cap sync android
2. google-services.json 설정
Anchor link to

google-services.json 파일을 android/app 디렉토리로 복사합니다.

3. 패키지 이름 설정
Anchor link to

android/app/build.gradle을 열고 applicationId를 앱의 패키지 이름(예: com.example.pushwoosh)으로 설정합니다.

4. API 토큰 설정
Anchor link to

android/app/src/main/AndroidManifest.xml 파일을 열고 <application> 태그 안에 다음 메타데이터를 추가합니다:

AndroidManifest.xml
<meta-data android:name="com.pushwoosh.apitoken" android:value="__YOUR_PUSHWOOSH_DEVICE_API_TOKEN__" />

__YOUR_PUSHWOOSH_DEVICE_API_TOKEN__Pushwoosh Device API Token으로 바꾸세요.

5. Android 프로젝트 열기
Anchor link to

Android Studio에서 프로젝트를 엽니다:

Terminal window
npx cap open android

프로젝트 실행

Anchor link to
  1. 프로젝트를 빌드하고 실행합니다.
  2. “Click Me!” 버튼을 탭합니다.
  3. 푸시 알림 권한을 부여합니다. 기기가 Pushwoosh에 등록됩니다.

푸시 알림 보내기

Anchor link to

Pushwoosh Control Panel로 돌아가 등록된 기기로 푸시 알림을 보냅니다.