콘텐츠로 건너뛰기

Capacitor SDK 빠른 시작

Capacitor SDK 는 Capacitor 앱에 푸시 알림 기능을 제공합니다.

이 빠르고 간단한 예제를 사용하여 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

Push Notifications 를 활성화하려면 특정 기능을 추가해야 합니다.

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

  • Push Notifications
  • Background Modes. 이 기능을 추가한 후 Remote notifications 확인란을 선택합니다.
6. API Token 설정
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 Token 설정
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 로 돌아가 푸시 알림 을 등록된 장치로 전송합니다.