TOAST > TOAST SDK 사용 가이드 > 시작하기 > Android

지원 환경

  • Android 4.0.3 이상
  • Android Studio 최신 버전 (버전 2.2 이상)

TOAST SDK의 구성

Android 용 TOAST SDK의 구성은 다음과 같습니다.

TOAST SDK가 제공하는 서비스 중 원하는 기능을 선택하여 적용할 수 있습니다.

Gradle Dependency Service
com.toast.android:toast-common:0.9.0 TOAST Common
com.toast.android:toast-core:0.9.0 TOAST Core
com.toast.android:toast-logger:0.9.0 TOAST Log & Crash

TOAST SDK를 Android Studio 프로젝트에 적용하기

1. Gradle을 사용해서 TOAST SDK 적용하기

build.gradle 파일에 TOAST SDK에 대한 종속성을 추가합니다.

dependencies {
  // ...
  implementation 'com.toast.android:toast-sdk:0.9.0'
  // ...
}

2. 바이너리 다운로드로 TOAST SDK 적용하기

TOAST의 Downloads 페이지에서 전체 Android SDK를 다운로드할 수 있습니다.

TOAST SDK 초기화하기

TOAST SDK 사용을 위한 초기화를 Application#onCreate에서 수행합니다.

public class YourApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        // Initialize TOAST SDK
        ToastSdk.initialize(getApplicationContext());
        // ...
    }
}

UserID 설정하기

ToastSdk에 사용자 아이디를 설정할 수 있습니다. 설정한 UserID는 ToastSdk의 각 모듈에서 공통으로 사용됩니다. ToastLogger의 로그 전송 API를 호출할 때마다 설정한 사용자 아이디를 로그와 함께 서버로 전송합니다.

UserID API 명세

// ToastSdk class
public static void setUserId(String userId);

UserID 설정 사용 예

// Set User ID.
ToastSdk.setUserId("user_identifier");

디버그 모드 설정하기

TOAST SDK의 내부 로그 확인을 위해서 디버그 모드를 설정할 수 있습니다. TOAST SDK 문의를 하실 경우, 디버그 모드를 활성화해서 전달해주시면 빠른 지원을 받을 수 있습니다.

디버그 모드 설정 API 명세

// ToastSdk class
public static void setDebugMode(boolean debug);

디버그 모드 설정 사용 예

// Set Debug Mode.
ToastSdk.setDebugMode(true); // or false

(주의) 앱을 릴리즈할 경우, 반드시 디버그 모드를 비활성화 해야 합니다.

TOAST Service 사용하기