Android에서 시작하기

Google 계정 만들기

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

Google Play 서비스 설치

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

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

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

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

프로젝트 생성 및 구성

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

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

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

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

...

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

apply plugin: 'com.android.application'

...

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

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

필요한 Android 권한 가져오기

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

OAuth 권한 가져오기

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

API 클라이언트 만들기

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

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

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

결과 사용자 승인 흐름

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

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