Android SDK

플레어레인을 통해 안드로이드(Android) 앱푸시 알림을 가장 쉽게 구현할 수 있습니다. 푸시 토큰 및 구독 관리부터 딥링크 등 클릭 URL 처리까지 코드 1줄에 모든 것이 포함되어 있습니다.
실제 연동이 완료된 예시를 참고하실 수 있도록 샘플 코드가 준비되어 있습니다.
1. 사전 준비
﻿플레어레인 관리자 에서 회원가입 후 프로젝트 생성
﻿
2. 인증 값 설정
아래 가이드를 참고하여 플레어레인에 푸시 발송에 필요한 인증 값을 입력합니다.
﻿Android: FCM 인증 정보 설정﻿﻿
﻿
3. Gradle을 사용하여 SDK 연동
repositories 블록이 있는 파일을 확인하여 추가하세요.
최신 Android Studio 를 통해 생성된 프로젝트의 경우 settings.gradle -> dependencyResolutionManagement 에 있습니다.
과거 프로젝트의 경우 build.gradle -> allprojects 에 있습니다. 2번째 탭을 눌러 확인하세요.
settings.gradle.kts
settings.gradle
build.gradle
dependencyResolutionManagement {
  repositories {
    // 아래 줄 추가
    maven("https://jitpack.io")
  }
}
dependencyResolutionManagement {
  repositories {
    // 아래 줄 추가
    maven("https://jitpack.io")
  }
}
﻿
app 수준의 build.gradle (<project>/<app>/build.gradle) 에 다음 항목들을 입력합니다
build.gradle.kts
build.gradle
dependencies {
  // 아래 줄 추가
  implementation("com.github.flarelane:FlareLane-Android-SDK:1.8.0")
}
dependencies {
  // 아래 줄 추가
  implementation("com.github.flarelane:FlareLane-Android-SDK:1.8.0")
}
﻿
﻿
4. 초기화 코드 추가
초기화 코드는 Application Class (Activity가 아님) 의 onCreate 에 추가합니다. 따라서 Application Class 를 먼저 만드는 것부터 시작하며, 이미 Application Class 가 있는 경우 해당 과정은 넘어가셔도 좋습니다.
AndroidManifest.xml 파일에서 android.name=".MainApplication" 을 입력하고 에디터 도우미를 통해 
MainApplication클래스 파일을 생성합니다. 직접 클래스 파일을 만드셔도 상관 없습니다.
﻿
onCreate 함수에서 FlareLane.initWithContext 함수를 추가합니다. 프로젝트 ID는 콘솔의 [프로젝트] 페이지에서 확인할 수 있습니다.
플레어레인 SDK가 제공하는 함수 리스트는  Mobile SDK Reference﻿ 에서 확인할 수 있습니다.
Kotlin (MainApplication.kt)
Java (MainApplication.java)
import com.flarelane.FlareLane

class MainApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        
        // 아래 코드 추가
        // 알림 권한 팝업 타이밍을 제어하려면 세 번째 파라미터를 false로 설정 후 적절한 시점에 .subscribe() 함수 실행
        FlareLane.initWithContext(this, "PROJECT_ID", true)
    }
}
import com.flarelane.FlareLane

class MainApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        
        // 아래 코드 추가
        // 알림 권한 팝업 타이밍을 제어하려면 세 번째 파라미터를 false로 설정 후 적절한 시점에 .subscribe() 함수 실행
        FlareLane.initWithContext(this, "PROJECT_ID", true)
    }
}
﻿
﻿
5. 테스트
여기까지 모두 완료하셨으면 앱 빌드, 실행 시 자동으로 플레어레인 전체 기기 리스트에 추가됩니다.
실제 배포 전, 푸시를 실제 발송하여 기기에 잘 오는지, 푸시 클릭 시 통계에 잘 잡히는지 반드시 직접 확인하시기 바랍니다.
﻿
6. (선택) 웹뷰 기반 앱 추가 연동
한국에서는 웹뷰 기반 앱이 운영되는 경우가 많으며 플레어레인은 그러한 특성을 반영하여 웹뷰 기반 앱을 위한 다양한 편의 기능을 제공하고 있습니다.
﻿웹뷰 기반 모바일 앱 브릿지 연동﻿ 가이드를 참고하여 웹사이트에서 일어나는 행동을 앱에서도 인식할 수 있도록 합니다.
﻿
7. 유저ID 연동
앱 설치 시 플레어레인에 생성된 기기는 '익명의 기기'이며 고객사가 별도로 관리하는 고유한 유저 ID﻿를 연동함으로써 플레어레인의 기기와 고객사의 유저ID를 매칭할 수 있습니다.
유저ID가 연동되어있으면 많은 이점이 있습니다. 회원과 비회원을 구분할 수 있고, 고객사는 언제든지 유저ID를 기준으로 푸시 알림 발송이 가능하기 때문에 초기 연동시 권장드리고 있습니다.
보통 유저가 회원가입이나 로그인 성공 시, setUserId 함수를 통해 유저ID를 연동합니다.
웹뷰 기반 앱인 경우 로그인은 웹사이트에서 일어나므로 브릿지 연동이 되어있다면 Web SDK에서 setUserId를 호출하여도 무방합니다.
Kotlin/Java
FlareLane.setUserId(this, "USER_ID")
FlareLane.setUserId(this, "USER_ID")
﻿
﻿
(심화) 추가 연동
자동 URL 처리
플레어레인은 기본적으로 푸시 알림 클릭 시 https, 딥링크 등 URL에 대해 자동 처리를 지원하고 있습니다. 만약 별도의 클릭 핸들러 구현이 필요한 경우 URL 자동 처리 비활성화﻿를 참고하세요.
알림 색상 설정
values/strings.xml
<resources>
    <!-- 알림 색상 변경  -->
    <string name="flarelane_notification_accent_color">#BC0000</string>
</resources>
<resources>
    <!-- 알림 색상 변경  -->
    <string name="flarelane_notification_accent_color">#BC0000</string>
</resources>
﻿
알림 채널 설정
﻿Android: 알림 채널 설정﻿ 을 참고하여 우리 서비스에 적합한 안드로이드 알림 채널 설정을 합니다.
알림 아이콘 설정
﻿Android: 알림 아이콘 설정﻿ 을 참고하여 아이콘 애셋 세팅을 합니다.
기타 리소스
가이드
﻿Mobile SDK Reference﻿﻿
﻿Android SDK Release Notes﻿﻿
﻿
가이드
Mobile SDK Reference
Android SDK Release Notes
멤버 초대
iOS SDK