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. 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. 프로젝트 메인 화면으로 이동 후, ‘Android 앱에 Firebase 추가’ 를 선택합니다.


manual_for_android_2-4




manual_for_android_2-5




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

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


manual_for_android_2-6




7. 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




4. 코르도바 프로젝트/config.xml 파일에서 아래와 같이 작성하여 AndroidX 사용을 허용합니다.



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에서 확인할 수 있습니다.