FAQ와 문제 해결
앱이 "인쇄 대기"만 보여 줍니다 — 제 데이터는 어디 있나요?
흔한 원인은 두 가지입니다.
- 건강 접근 권한. iOS는 읽기 접근이 허용되었는지 앱에 절대 알려 주지 않습니다 — 거부는 "데이터 없음"과 똑같이 보입니다. 건강 → 프로필 → 개인정보 보호 → 앱 → Courier에서 카테고리를 켜 주세요. (편집부 → 데이터 소스에서 바로 이동할 수 있습니다.)
- Apple 건강에 데이터가 없음. 수면에는 소스가 필요합니다 (Apple Watch 또는 건강에 기록하는 수면 앱). iOS 시뮬레이터에는 건강 데이터가 사실상 없으니 실제 기기를 사용하세요.
운동이 경로 없이 도착했어요. / 운동이 왜 "대기 중"인가요?
GPS 트랙은 운동 요약보다 조금 늦게 Apple 건강에 도착하는 일이 잦습니다. Courier는 불완전한 기록을 발행하는 대신 트랙이 도착할 때까지 야외 운동을 의도적으로 awaitingRoute 상태로 붙잡아 둡니다. 경로가 끝내 오지 않으면 (예: 실내 운동이 잘못 감지되었거나 Watch가 기록하지 않은 경우) 항목은 주의 필요로 이동해 수동 발행을 기다립니다.
백그라운드 발행이 즉시 되지 않아요. 고장인가요?
아닙니다 — iOS가 백그라운드 배달을 제한합니다. 몇 분에서 한 시간 정도가 정상이며, 최악의 경우 다음에 앱을 열 때 이루어집니다. 즉시 확실하게 보내려면 앱을 열거나 지금 발행 단축어를 실행하세요. 발행과 동기화를 참조하세요.
재시도가 서버에 중복을 만들지 않나요?
서버가 Idempotency-Key 헤더를 존중하거나 data.id로 upsert한다면 만들지 않습니다. 자동 재시도와 수동 재전송은 같은 키를 재사용하고, 의도적인 "한 부 더 보내기"는 키를 회전시킵니다 (id#2, id#3, …). 발행과 동기화를 참조하세요.
일반 HTTP를 쓸 수 있나요?
실제 엔드포인트에는 https://가 필수입니다 (iOS App Transport Security). http://localhost와 로컬 네트워크 주소는 개발용으로 허용됩니다.
제 엔드포인트는 다른 형태의 페이로드가 필요해요.
바로 그럴 때 쓰라고 JavaScript 변환이 있습니다 — 어떤 문자열이든 JSON 구조든 반환할 수 있습니다. 정적 필드 몇 개만 추가하면 된다면 구독자의 본문 매개변수만으로 코드 없이 해결됩니다.
전송이 왜 실패했는지 어디서 보나요?
편집부 → 발행 내역에 모든 시도가 HTTP 상태와 응답 스니펫과 함께 기록됩니다. 변환 스크립트 오류도 스크립트의 오류 메시지와 함께 거기에 나타납니다.
위젯이 실시간으로 업데이트되나요?
앱이 데이터를 읽거나 발행할 때마다(백그라운드 동기화 포함) 업데이트되고, 30분마다 예비 새로고침도 있습니다. 오래돼 보이나요? 앱을 한 번 열어 보세요. 위젯을 참조하세요.
제 데이터가 어딘가의 클라우드에 있나요?
Courier가 그렇게 만드는 일은 없습니다. 계정도, 개발자 서버도, CloudKit도 없습니다. 유일한 네트워크 목적지는 당신이 설정한 엔드포인트(그리고 선택했다면 전사 서비스)뿐입니다. 개인정보 처리방침을 참조하세요.
새 iPhone으로 어떻게 옮기나요?
편집부 → 설정 백업 → 이전 휴대폰에서 내보내고, 새 휴대폰에서 가져온 뒤, 각 구독자의 비밀 값을 다시 입력하세요 (비밀 값은 절대 키체인을 떠나지 않습니다). 주석은 노트 아카이브에서 JSON으로 내보낼 수 있습니다.
다른 문제가 있어요.
편집부 푸터의 앱 버전과 함께 이슈를 등록해 주세요: github.com/Xheldon/Export-Data-From-Apple/issues.