Android에서 시작하기

이 가이드에서는 Android에서 Google 피트니스 개발을 시작하는 방법을 설명합니다.

설정

앱 빌드를 시작하기 전에 다음 단계를 완료하세요. 섹션으로 이동합니다.

Google 피트니스 API를 사용하려면 Google 계정이 필요합니다. 새 계정을 만들거나 기존 계정 사용 테스트를 위해 별도의 계정을 만드는 것이 앱을 만드는 것입니다.

개발 중인 Google Play 서비스용 최신 클라이언트 라이브러리 가져오기 호스트:

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

Fitness API를 사용 설정하려면 OAuth 2.0 클라이언트 ID를 가져옵니다.

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

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

Kotlin DSL그루비 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")
}
 
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를 생성할 때 앱을 빌드할 수 있습니다.

앱 빌드 및 테스트

설정 단계를 완료하면 앱 빌드를 시작할 수 있습니다. 얻기 위해 앱에서 데이터를 저장하고사용할 수 있는데이터의 유형에 대해 read입니다. 데이터를 기록합니다.

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

앱에서 액세스할 수 있는 데이터 유형이 승인 범위를 참조하세요. 물어보기 이러한 권한에 대해 앱이 FitnessOptions에서 액세스해야 하는 데이터 유형 인스턴스를 참조하세요. 앱에서 Google 피트니스 데이터 사용을 요청하는 경우 Android SDK는 어떤 범위에 속하는지 자동으로 확인하고 이러한 범위에 대한 승인을 받을 사용자

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

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

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

다음은 사용자가 경험하는 승인 흐름의 결과입니다. 다음과 같습니다.

<ph type="x-smartling-placeholder">
</ph>
그림 1. 사용자를 위한 승인 흐름
  1. Android 권한: 사용자가 앱에 표시된 Android 권한을 확인할 수 있습니다. 을 사용해야 합니다. 앱이 다운로드되면 필요한 모든 런타임 권한을 요청하고 사용자가 권한을 부여하거나 거부합니다. 권한을 부여할 수 있습니다
  2. 확인 및 연결: 앱에서 다른 데이터 유형에 대한 액세스를 요청하기 전에 부여됩니다.
  3. OAuth 범위 요청: Google에서 사용자에게 앱을 부여하라는 메시지를 표시합니다. 액세스하려는 데이터 유형에 필요한 OAuth 범위여야 합니다.
  4. 액세스 권한 적용됨: 사용자가 권한을 부여하면 앱에서 다음 작업을 할 수 있습니다. 사용자가 부여한 범위에 속한 데이터 유형에 액세스 권한을 부여할 수 있습니다.

인증 신청

앱을 빌드하고 테스트한 후에는 인증을 타당성을 확보해야 하는 이유를 민감한 범위 및 제한된 범위가 포함될 수 있습니다.