IT BACKUP

FCM (Firebase Cloud Messaging Service)는 Andriod 2.3 이상이 설치된 장치와 그 장치에 Google Play Store 앱이 설치되어 있어야 동작합니다. (Android 장치는 기본적으로 구글 플레이 앱이 설치되어 있으므로, 앱 설치는 신경 쓰지 않아도 됩니다.)

파이어 베이스 SDK와 FCM SDK 설치.

만약 Firebase SDK가 설치되어 있지않다면, 설치해 줍니다. (공식문서 링크, 블로그 설명 링크 중 하나를 참고 하면됩니다.)

안드로이드 스튜디오 속 app-Level build.gradle 파일을 다음과 같이 수정합니다.

앱속의 Manifest 파일을 수정합니다.

공식 문서에서의 설명은 FCM 서비스를 확장하는 것 이라고 합니다. 백그라운드 앱에의 알림을 지나온 메시지를 핸들링 하기 원한다면, 다음과 같은 작업이 요구됩니다. 알림 받기를 대기하고 있는 포그라운드 앱(실행되는 메인 앱), 받을 데이터, 포그라운드로 보낼 업스트림 메시지, 그렇게 하기 위해서는 서비스 확장이 필요하다고 합니다.

FCM 서비스 확장은 등록된 토큰의 생성, (대기하고 있는 장치들에) 순환, 업데이트를 핸들링 합니다. 이것은 장치그룹 생성과 특정 장치에 (메시지 혹은 토큰)을 보내기위해 요구됩니다.

만약 앱의 기능에 FCM이 크리티컬한 경우(error) 매니페이스트에 'android:minSdkVersion="8"' 또는 그 이상의 값으로 셋팅해야 합니다. 이 설정은 확실히 동작하지 않은 한 기능, 앱의 기능을 설치할 수 없는 것에 대한 보장을 합니다. (기능이 없는 경우 버전을 올리므로써, 해결 할 수 있다는 의미 같음).

Google Play Services APK를 위한 확인.

Google Play Service의 기능에 접근하기 전 Google Play Service 설계를 위해 Play Service SDK에 의존하는 앱은 항상 장치를 확인해야 합니다. 이것은 MainActivity 속 OnCreate() 메소드와 OnResume() 메소드 2곳에서 이 것을 하기 위한 권한 입니다. OnCreate() 메소드 속에서 성공적인 확인 없이 앱은 이 것을 이용할 수 없습니다. OnResume()에서의 확인은 유저가 백버튼등을 통해 앱을 재 실행할 경우 여전히 동작됨을 확인합니다. 만약 장치에 Google Play Service 앱의 기능이 구축되지 않은 경우, 여러분이 만들고 있는 앱은 GooglePlayServicesUtil.GetErrorDialog()를 불러 Google Play Store 통해 APK 다운로드 허용 또는 장치에서 허용하도록 합니다. 해당 정보는 https://developers.google.com/android/guides/setup 링크를 참고 하세요. 저도 보지 않았습니다.

장치 등록토큰 접근

여러분의 앱이 초기화 구동을 할 때, FCM SDK는 클라이언트 앱을 위한 등록토큰을 생성합니다. 만약 지정한 하나의 장치 또는 장치 그룹 생성을 위해서, 여러분은 FirebaseInstanceIDService를 확장할 필요가 있습니다. (아마 기기를 특정하지 않고, 전체 기기에 보낼 때는 설정할 필요가 없을 듯 보입니다.) 자세한 내용은 https://firebase.google.com/docs/reference/android/com/google/firebase/iid/FirebaseInstanceIdService 문서를 참고 하면되며, 매니패스트 정도 수정하면될 듯 합니다.

이 섹션에서는 토큰을 회수하는 방법, 교환되는 토큰을 회수하는 방법을 설명합니다. 초기화 이후 순환된 토큰을 더 강한 권한으로 마지막으로 업데이트된 토큰을 회수 해야 하기 때문입니다.

토큰이 변경될 때 :

앱의 인스턴스 아이디 제거

새로운 장치에서 앱이 복원될 때

유저가 앱을 언인스톨 하고 다시 인스톨 할 때

앱에서 유저 데이터가 삭제 될 때

현재의 등록 토큰을 회수

현재의 토큰 회수가 필요할 때, FirebaseInstanceID.getToken() 메소드를 호출 합니다. 생성된 토큰이 없었을 경우 null을 반환합니다.
해당 메소드의 정보는 https://firebase.google.com/docs/reference/android/com/google/firebase/iid/FirebaseInstanceId#public-methods 를 참조 합니다.

토큰 생성을 모니터

새로운 토큰이 생성될때 항상 onTokenRefresh 콜백이 호출(본문에서는 Fires 를 동사처럼 사용함, 아마 점화되다는 의미 처럼 보임)됩니다. 그렇게 컨텍스트에서 불려진 getToken 는 토큰에 접근하고, 등록된 토큰의 활성화를 보장 봤습니다. onTokenRefresh속에서 getToken 호출되려면 매니페스트에 서비스가 추가되어 있어야 합니다. (위에서 이미 하였음)

@Override
public void onTokenRefresh() {
    // Get updated InstanceID token.
    String refreshedToken = FirebaseInstanceId.getInstance().getToken();
    Log.d(TAG, "Refreshed token: " + refreshedToken);

    // If you want to send messages to this application instance or
    // manage this apps subscriptions on the server side, send the
    // Instance ID token to your app server.
    sendRegistrationToServer(refreshedToken);
}

토큰을 획득한 뒤, 여러분은 그것을 우선권이 있는 메소드의 여러분의 앱과 스토어로 보낼 수 있습니다. Instance ID API 참고의 자세히 모두 나와 있는 페이지 주소는 https://firebase.google.com/docs/reference/android/com/google/firebase/iid/FirebaseInstanceId 입니다.

다음 단계

한번의 클라이언트 셋업으로 Firebase Console로 다운 스트림 메시지 보내기와 Firebase Console로 토픽 메시지 보내기를 시작할 준비를 완료 하였습니다. (지금까지의 작업으로). 이 기능은 검증된 퀵스타트 샘플 (https://github.com/firebase/quickstart-android/tree/master/messaging) 을 다운로드 하고 실행하고 검토할 수 있습니다.

또 다른, 더 강력한 행동을 앱에 추가하기위해, 메시지를 받을 작업을 위한 intent filter와 액티비티에 상속을 정의 할 수 있습니다. 앱서버로 부터 더 메시지를 보내기 위한 자세한 가이드는 아래와 같습니다.

다운 메시지 보내기 : https://firebase.google.com/docs/cloud-messaging/downstream

토픽 메시지 보내기 : https://firebase.google.com/docs/cloud-messaging/topic-messaging

디바이스 그룹에 보내기 : https://firebase.google.com/docs/cloud-messaging/notifications

업스트림 메시지 보내기 : https://firebase.google.com/docs/cloud-messaging/upstream

파이어 베이스 프로젝트 만들기

창업자닉군 — Wed, 3 Aug 2016 20:37:00 +0900

먼저 파이어 베이스 콘솔에 접속 합니다. https://console.firebase.google.com/ <- 클릭

위와 같은 화면이 뜨면, 버튼을 눌러 줍니다.

그럼 아래와 같이 프로젝트 만들기 창이 뜨는 데, 각 항목에 알맞은 값을 넣어주고, 프로젝트 만들기 버튼을 클릭해 완료 합니다.

콘솔에 프젝트 만들기가 완료되 었습니다.

안드로이드 프로젝트에 파이어 베이스 추가하기 (Add Firebase to Your Android Project)

창업자닉군 — Wed, 3 Aug 2016 19:16:40 +0900

본 정보는 파이어 베이스 공식 문서 : https://firebase.google.com/docs/android/setup 페이지를 참고 하여 작성 하였습니다.

그리고, http://yookn.tistory.com/244 페이지도 참고 하였습니다.

전제조건

디바이스에서 Android 2.3(진저브레이드) 이상, 구글 서비스 9.4.0 이상이 동작할 것. (설치되어 있을 것)

쉽게 확인 가능한 사항이므로 설명하지 않겠습니다.

구글 플레이 서비스 SDK

설치가 되어 있는지 확인하기 위해서는 https://developer.android.com/studio/intro/update.html 페이지에 나와 있고, 이 페이지를 바탕으로 설명 드리겠습니다.

일단 안드로이드 스튜디오의 Preferences 창을 열어 줍니다.

사용환경이 윈도우 라면, 안드로이드 스튜디오의 Help > Check for Update 을 통해서, 맥 이라면, Android Studio > Check for Update 를 통해서 오픈할 수 있습니다.

왼쪽 패널의 Appearance & Behavior > System Settings > Updates 를 차례로 선택해 주면 아래와 같이 구글 플레이 서비스 SDK가 설치되어 있는지 확인할 수 있습니다. (저는 설치되지 않았습니다. 그래서 설치해 주었습니다.)

안드로이드 스튜디오 1.5 이상

아직 설치 하지 않았다면, https://developer.android.com/studio/index.html 링크를 클릭해서 설치해 주세요.

안드로이드 스튜디오 프로젝트와 페키지명. (그냥 안드로이드 프로젝트를 생성하면됨).

프로젝트 생성방법은 http://it-backup.tistory.com/112 페이지를 참고 해 주세요.

앱에 파이어 베이스 추가하기

파이에 베이스 콘솔에서 파이어 베이스 앱을 생성하기 위해, https://console.firebase.google.com/ 링크를 클릭해 만들어 줍니다. 설명이 필요하시다면, http://it-backup.tistory.com/115 페이지를 참고해 주세요.

Android앱에 Firebase 추가 항목을 선택해 줍니다.

안로이드 앱에 파이어 베이스 추가 설정의 첫 단계가 시작됩니다.

아래처럼 패키지 이름 항목에 자신의 앱의 패키지를 넣어 주고, 하단의 버튼을 눌러 다음 단계로 넘어 갑니다.

자신의 앱의 패키지 명을 모르는 경우, 아래와 같이 app > app > build.gradle 파일을 열어 확인해 줍니다.

구성 파일 추가 항목에서는 보기와 같이 파일에 추가 해 주면됩니다. 완료 했다면, 화면 하단의 버튼을 눌러 다음 단계로 넘어 갑니다.

다만 예전 버전의 안드로이드 스튜디오 이미지로 설명창에 나와 있으므로, 추가 위치를 파악하기 힘들 수 있는 데, 아래 이미지를 참고해 넣어 주면됩니다.

마지막으로 gradle 파일들을 수정해 줍니다.

위 설명 역시 오래된 이미지를 참고 했으므로, 헷갈릴 수 있는 데 아래와 같이 추가 해 주면 됩니다.

동기화 버튼은 처음 부터 찾을 필요 없습니다. build.gradle 파일을 수정하는 순간 나타 납니다.

그리고, 설명한 것 처럼 완료하고, 싱크를 하면 오류가 날 수 있습니다. 이럴 경우, 모든 모듈들의 버전이 달라서 생기는 오류 입니다. 최신 버전의 안드로이드 스튜디오를 다운 받았는데, 버전이 다르겠어 라고 생각했는데, 안드로이드 스튜디오를 다운 받아도 이전에 받아 놓은 안드로이드 sdk를 사용합니다. 그래서 버전이 다를 수 있으니 위에서 설명 하였던 업데이트 창을 열어 확인해 주세요.

저 같은 경우 아래의 그림과 같이 Google Repository 모듈의 버전이 달라 그런 현상이 있었습니다. 업데이트 후 싱크하였더니 문제가 해결되었습니다.

Firebase 기본 정보

창업자닉군 — Tue, 2 Aug 2016 22:09:23 +0900

파이어 베이스 사이트 : firebase.google.com

파이어 베이스 개발 문서 : firebase.google.com/docs/

Android Hello World 만들기.

창업자닉군 — Tue, 2 Aug 2016 20:19:38 +0900

어떤 프로그래밍 툴이던, 설정을 완료했다면, 잘 동작하는지 여부를 파악하기 위해 가장 먼저 만들어 보는 것은 Hello World 프로그램인 것 같다. 일단 프로그램을 실행하고 프로젝트를 만들어 보자.

프로젝트 생성.

프로젝트 생성창 호출 : File > New > New Proect

프로젝트 생성창

Application Name : 해당 프로젝트로 생성될 앱의 이름이다.

Company Domain : 자신이 가진 홈페이지의 도메인을 넣으면된다. (없으면 아무거나).

Package Name : 해당 앱의 패키지 (일종의 가상 디렉터리로, 소스를 넣어 두는 탑 디렉토리)명. Company Domain을 기준으로 작성되며, Company 도메인이 공인 도메인이라면, 유일성을 보장 받을 수 있다. 구글 플레이등의 앱 마켓에서는 해당 패키지 명으로, 앱을 구분한다.

Project location : 해당 앱의 파일들이 있는 물리적인 폴더.

설정이 끝났다면, 하단의 'Next' 버튼을 눌러 다음으로 넘어 간다.

다음 창은 어떤 장치용 프로젝트를 생성할 것이지와 SDK 버전을 선택해 줍니다. 특별한 기능 없이 일반적인 기능만 사용한다면, 최소 버전을 설정해 주면 됩니다. 현재 설정되어 있는 API 15인 경우 모바일 기기의 97.4%가 이 이상의 버전을 가지고 있어, 본 버전을 설치할 경우 97.4%의 기기에서 동작할 수 있다고 나와 있어 설정하였습니다. (사실, 처음부터 선택되어 있었음.)

그 다음은 메인 Activity의 템플릿을 선택합니다. 자신이 앱을 만들고자 하는 앱의 모양에 가장 가까운 템플릿을 선택하고, 'Next' 버튼을 눌러 줍니다.

주요 컴포넌트들의 이름을 정해 주면 됩니다. 대체로 그냥 놔두고 쓰면 됩니다.

Activity Name : Main Activity의 이름을 정해 줍니다.

Layout Name : 레이아웃의 이름 입니다.

Title : 액티비티의 타이틀에 표시되는 이름 입니다.

Menu Resource Name : 메뉴 리소스의 이름 입니다.

'Finish' 버튼을 눌러서 프로젝트 생성을 마무리 해 줍니다.

실행하기

툴바의 런 앱 버튼을 눌러 실행을 시켜 봅니다.

앱을 동작 시키기 위한 기기를 선택합니다. 기기가 없다면 아래의 에뮬레이터를 선택해도 됩니다.

그렇다면 모바일 기기에 다음과 같은 앱 실행화면을 볼 수 있습니다.