Flutter for Android 사용 가이드

※ Flutter 1.20.0 기반

1. Flutter 프로젝트 생성

 

– Flutter 프로젝트를 생성합니다.


cordova_manual_for_android_1
2. Flutter 핑거푸시 SDK 파일 다운로드 및 SDK 적용

 

1. Flutter 핑거푸시 SDK 파일을 여기 에서 다운로드합니다.


2. Flutter 핑거푸시 SDK 파일을 Flutter 프로젝트와 같은 위치에 이동시킵니다.






2. 아래의 스크린샷에 표기되어있는 pubspec.yaml 파일에 아래의 스크린샷과 같이 입력합니다.









4. 아래 스크린샷과 같이 “flutter pub get” 명령어를 이용하여 SDK를 적용합니다.




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. 프로젝트/android/app/src/main 에 asset 폴더를 만든 후 그 안에 FingerPush.properties 파일을 이동시킵니다. 이 파일에 핑거푸시의 App Key, Secret Key를 입력 후 저장합니다.


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를
프로젝트/android/app/src/main/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’파일을 다운로드 합니다.

프로젝트/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. 아래 스크린샷의 android/build.gradle 파일을 아래 스크린샷과 같이 입력합니다.


cordova_manual_for_android_4_5


cordova_manual_for_android_4_5




2. 아래 스크린샷의 android/app/build.gradle 파일을 아래 스크린샷과 같이 입력합니다.


cordova_manual_for_android_5_2



cordova_manual_for_android_5_2




3. 아래 스크린샷의 프로젝트/android/app/src/main/AndroidManifest.xml 파일을 아래 스크린샷과 같이 입력합니다.


cordova_manual_for_android_5_1


cordova_manual_for_android_5_1



4. 아래 스크린샷의 프로젝트/android/app/src/main/kotlin/패키지명/MainActivity.kt 파일을 아래 스크린샷과 같이 입력합니다.


cordova_manual_for_android_5_1


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

 

1. 핑거푸시 플러그인 폴더 내의 example 파일을 이용하여 빌드하면 예제파일을 실행할 수 있습니다.



fp_plugin_008




2. 가이드 3-4를 확인하여 asset 폴더 내의 FingerPush.properties 파일에 핑거푸시 APP KEY, SECRET KEY, GCM Sender ID를 입력합니다. 가이드 4-7를 확인하여 google-services.json 파일읍 프로젝트/android/app 위치에 이동시킵니다.


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

7. Flutter 핑거푸시 플러그인 API Reference

 

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