Health | Appbox iOS SDK 가이드

Health

Health runtime 확인

앱 target에 Health runtime이 포함되어 있는지 확인합니다.

Health runtime 확인

AppBox.isHealthAvailable() -> Bool

Swift
1 guard AppBox.isHealthAvailable() else {
2 return
3 }
1 if (![AppBox isHealthAvailable]) {
2 return;
3 }

Request 항목 정의

인자가 없습니다.

Response 항목 정의

Response 결과값
BoolHealth runtime 포함 여부. 즉시 반환됩니다


true는 HealthKit 권한 허용 상태를 의미하지 않습니다. HealthKit capability와 NSHealthShareUsageDescription을 별도로 설정합니다. 실제 호출 전 AppBoxInitResult.health.status도 확인합니다.

걸음 수 조회

지정한 날짜 범위의 HealthKit 일별 걸음 수를 조회합니다.

걸음 수 조회

AppBox.getHealthSteps(fromDate: String, toDate: String, completion: @escaping ([AppBoxDailyStep]?, NSError?) -> Void)

Swift
1 AppBox.getHealthSteps(
2 fromDate: "2026-07-01",
3 toDate: "2026-07-07"
4 ) { steps, error in
5 if let error {
6 let code = AppBoxHealthErrorCode(rawValue: error.code) ?? .unknown
7 handleHealthError(code)
8 return
9 }
10
11 for item in steps ?? [] {
12 showSteps(date: item.date, step: item.step)
13 }
14 }
1 [AppBox getHealthStepsFromDate:@"2026-07-01"
2 toDate:@"2026-07-07"
3 completion:^(NSArray<AppBoxDailyStep *> *steps, NSError *error) {
4 if (error != nil) {
5 AppBoxHealthErrorCode code = (AppBoxHealthErrorCode)error.code;
6 [self handleHealthError:code];
7 return;
8 }
9
10 for (AppBoxDailyStep *item in steps ?: @[]) {
11 [self showStepsWithDate:item.date step:item.step];
12 }
13 }];

Request 항목 정의

Request 항목필수여부설명기본값
fromDate필수조회 시작일. yyyy-MM-dd 형식-
toDate필수조회 종료일. yyyy-MM-dd 형식-
completion필수조회 결과 callback-

Response 항목 정의

Response 결과값
steps날짜 오름차순의 AppBoxDailyStep 배열
steps[].date일자 문자열
steps[].step해당 일자의 걸음 수
error날짜, 권한, 기능 지원 또는 HealthKit 조회 실패 원인


별도의 Health 권한 요청 함수는 없습니다. 이 함수가 필요한 읽기 권한을 요청합니다.

  • 앱 시작 직후가 아니라 사용자가 걸음 수 기능을 선택한 화면에서 호출합니다.
  • 시작일과 종료일을 포함하며 기록이 없는 날짜는 0으로 채우지 않고 배열에서 빠집니다.
  • 조회 범위는 기기 local time zone으로 해석하지만 반환 날짜 key는 KST를 사용합니다. UTC+9보다 동쪽인 기기에서는 반환 날짜가 하루 앞당겨질 수 있습니다.
  • 오류 domain은 kr.co.mobpa.appbox.health입니다.
  • 건강 데이터는 필요한 기간만 조회하고 로그나 분석 도구에 기록하지 않습니다.
www.naver.com
QR 코드를 촬영하면 입력하신 주소의
앱 예시 화면을 테스트할 수 있습니다.
* 스캔 후 바로 앱 다운로드 이동합니다.