CORDOVA for Android 사용 가이드

※ CORDOVA 8.1.2 기반

1. 코르도바 프로젝트 생성

 

– 코르도바 프로젝트를 생성하고, 안드로이드 플랫폼을 추가합니다.


cordova_manual_for_android_1
2. 코르도바 핑거푸시 플러그인 다운로드

 

1. 코르도바 핑거푸시 플러그인 파일을 / 에서 다운로드합니다.


2. 코르도바 핑거푸시 플러그인을 코르도바 프로젝트 폴더와 같은 위치에 압축을 풉니다.

3. 핑거푸시 관리자 사이트 APP 생성

 

1. 핑거푸시 사이트(https:/www.fingerpush.com)에서 앱 추가를 눌러 핑거푸시 앱을 생성합니다.


manual_for_android_1-1




2. 필수값인 앱 이름, 앱 구분, 앱 카테고릴 입력 또는 선택합니다.



manual_for_android_1-2




3. 설정을 선택하면 App Key, App Secret 을 확인할 수 있습니다.



manual_for_android_1-3




4. 핑거푸시의 App Key, Secret Key를
FingerPushPlugin/src/android/asset/FingerPush.properties 파일에 입력 후
저장합니다.


cordova_manual_for_android_3_4
4. FCM APP 생성

 


※ 기존 GCM 프로젝트가 있는 경우, 반드시 기존 프로젝트를 불러오기를 해서 사용해야 합니다.



1. Firebase사이트(https:/console.firebase.google.com) 에서 프로젝트 추가를 한 뒤, 추가한 프로젝트를 선택합니다.


manual_for_android_2-1




2. ‘설정 > 프로젝트 설정’ 으로 이동합니다.


manual_for_android_2-2






3. 서버(API)키와 발신자(Sender) ID를 확인할 수 있습니다.


cordova_manual_for_android_4_3




4. Firebase의 서버(API)키를 핑거푸시 사이트 설정화면에 입력합니다.


manual_for_android_3-1




5. Firebase의 발신자(Sender) ID를
FingerPushPlugin/src/android/asset/FingerPush.properties 파일에 입력 후
저장합니다.


cordova_manual_for_android_4_5





※ SDK 3.1.3 부터 Multi Sender ID를 지원합니다.
설정 방법은 콤마(,) 로 구분하여 키를 입력하면 됩니다.
GOOGLE_PROJECT_ID = FCM 발신자 ID 1,FCM 발신자 ID 2,FCM 발신자 ID 3




6. 프로젝트 메인 화면으로 이동 후, ‘Android 앱에 Firebase 추가’ 를 선택합니다.


manual_for_android_2-4




manual_for_android_2-5




7. Android 패키지 이름을 입력 후 앱 등록을 하고 ‘google-services.json’파일을 다운로드 합니다.

코르도바 프로젝트/platforms/android/app 위치에 google-services.json파일을 이동시킵니다.


manual_for_android_2-6




8. Firebase의 서버(API)키를 google-services.json파일의 ‘current_key’에 입력합니다.


cordova_manual_for_android_4_8
5. 코르도바 핑거푸시 플러그인 설치

 

1. 설치한 FingerPushPlugin 파일 안 plugin.xml의 target-dir에 ‘$PACKAGE_NAME’을 사용자 패키지명으로 변경합니다.


cordova_manual_for_android_4_5




2. FingerPushPlugin/src/android/IntentService.java파일 맨 위 package 값을 사용자 패키지명으로 변경합니다.


cordova_manual_for_android_5_2




3. 터미널을 이용하여 코르도바 핑거푸시 플러그인을 코르도바 프로젝트에 추가합니다.


cordova_manual_for_android_5_1
6. 예제 파일 적용 및 푸시메시지 확인

 

1. FingerPushPlugin/example 폴더 내의 하위 폴더와 파일을 코르도바 프로젝트의 www 폴더로 이동시킵니다.



fp_plugin_008




2. setDevice 함수를 통해 앱을 핑거푸시 서버에 등록합니다.


fp_plugin_009



3. 디바이스가 정상적으로 등록됐다면 핑거푸시 사이트에서 확인 가능하고, 푸시메시지를 수신할 수 있습니다.


manual_for_android_10-1
7. 코르도바 핑거푸시 플러그인 안드로이드 API Reference

 

핑거푸시 API의 기능과 변수, 결과값에 대한 정보는 ‘Guide’ > ‘API Reference’ > Android API Reference for AAR에서 확인할 수 있습니다.