Android에서 시작하기

이 가이드에서는 Android에서 Google Fit으로 개발을 시작하는 방법을 설명합니다.

참고: Google 피트니스는 Google Play 서비스의 일부입니다. Google Play 서비스를 사용하면 앱에 어떤 이점이 있는지 알아보세요.

설정

앱 빌드를 시작하기 전에 다음 섹션의 단계를 완료하세요.

Google 계정 만들기

Google Fit API를 사용하려면 Google 계정이 필요합니다. 새 계정을 만들거나 기존 계정을 사용할 수 있습니다. 사용자의 관점에서 앱을 테스트할 수 있도록 별도의 계정을 만드는 것이 좋습니다.

Google Play 서비스 설치

개발 호스트에서 Google Play 서비스의 최신 클라이언트 라이브러리를 가져옵니다.

1. Android SDK Manager를 엽니다.
2. SDK Tools에서 Google Play 서비스를 찾습니다.
3. 이러한 패키지의 상태가 설치됨이 아닌 경우 두 패키지를 모두 선택하고 패키지 설치를 클릭합니다.

OAuth 2.0 클라이언트 ID 가져오기

Fitness API를 사용 설정하려면 OAuth 2.0 클라이언트 ID를 가져오세요.

프로젝트 만들기 및 구성

Fitness API로 앱을 빌드하려면 Android 스튜디오 개발 환경을 사용하는 것이 좋습니다. Android 스튜디오에서 새 프로젝트를 만들고 구성하는 방법에 관한 자세한 내용은 프로젝트 만들기를 참고하세요.

Google Play 서비스 클라이언트 라이브러리 추가

Android 스튜디오에서 모듈의 build.gradle 파일을 열고 Google Play 서비스 클라이언트 라이브러리를 종속 항목으로 추가합니다.

Kotlin DSL

plugin {
    id("com.android.application")
}

...

dependencies {
        implementation("com.google.android.gms:play-services-fitness:21.2.0")
        implementation("com.google.android.gms:play-services-auth:21.3.0")
}

Groovy DSL

apply plugin: 'com.android.application'

...

dependencies {
    implementation 'com.google.android.gms:play-services-fitness:21.2.0'
    implementation 'com.google.android.gms:play-services-auth:21.3.0'
}

이렇게 하면 Gradle이 앱을 빌드할 때 피트니스 SDK를 자동으로 다운로드합니다.

앱 빌드 및 테스트

설정 단계를 완료하면 앱 빌드를 시작할 수 있습니다. 시작하려면 앱에서 저장하고 읽을 수 있는 데이터 유형을 알아보세요. Google 피트니스에서 데이터를 사용하는 방법을 자세히 알아보세요.

필요한 Android 권한 가져오기

일부 데이터 유형을 읽고 쓰려면 앱에서 Android 권한을 요청해야 합니다.

OAuth 권한 가져오기

앱에 액세스 권한이 있는 데이터 유형은 승인 범위에 해당합니다. 이러한 권한을 요청하려면 FitnessOptions 인스턴스에서 앱에 액세스해야 하는 데이터 유형을 추가해야 합니다. 앱에서 Google 피트니스 데이터 유형을 사용하도록 요청하면 Android SDK는 자동으로 해당 유형이 속한 범위를 확인하고 사용자에게 해당 범위에 대한 승인을 요청합니다.

API 클라이언트 만들기

API 클라이언트를 만들고 데이터를 쓰거나 읽기 위해 앱에서 액세스해야 하는 데이터 유형을 추가합니다. 다음 엔드포인트를 사용할 수 있습니다.

• SensorsClient: 로컬 기기 및 호환 기기의 하드웨어 센서에서 다양한 건강 및 웰빙 데이터 소스에 액세스합니다.
• RecordingClient: 저전력, 상시 사용 설정된 백그라운드 센서 데이터 수집용입니다.
• HistoryClient: Google 피트니스에서 이전 데이터를 삽입, 삭제, 읽습니다.
• SessionsClient: 사용자 활동의 세션을 만들고 관리합니다.
• GoalsClient: 사용자가 Google 피트니스에서 만든 하트 포인트 및 걸음 수 목표를 읽습니다.
• ConfigClient: Google 피트니스 플랫폼에서 맞춤 데이터 유형 및 설정에 액세스합니다.

Fitness API 클라이언트를 빌드하는 방법의 예를 확인하세요.

결과로 발생하는 사용자 승인 흐름

다음은 사용자에게 권한 요청이 표시될 때 발생하는 승인 흐름을 보여줍니다.

그림 1.사용자의 승인 흐름

1. Android 권한: 사용자가 앱을 다운로드하기 전에 앱에서 요청한 Android 권한을 확인할 수 있습니다. 앱이 다운로드되면 필요한 런타임 권한을 요청하고 사용자는 이러한 권한을 부여하거나 거부합니다.
2. 확인 및 연결: 앱이 다른 데이터 유형에 대한 액세스를 요청하기 전에 권한이 부여되었는지 확인합니다.
3. OAuth 범위 요청: Google에서 사용자에게 앱이 액세스하려는 데이터 유형에 필요한 OAuth 범위를 부여하도록 메시지를 표시합니다.
4. 액세스 적용됨: 사용자가 권한을 부여하면 앱은 사용자가 권한을 부여한 범위에 속하는 데이터 유형에 액세스할 수 있습니다.

인증 신청

앱을 빌드하고 테스트한 후에는 민감한 범위 및 제한된 범위에 필요한 다양한 수준의 근거를 포함하여 인증을 신청해야 합니다.