공통 규칙 | Appbox iOS SDK 가이드
공통 규칙
- 모든 예제는
import AppBoxSDK또는@import AppBoxSDK;후 사용할 수 있습니다. - 일반 서비스 앱에서는
AppBox.함수명(...)형태의 정적 API를 사용합니다. - 기기와 OS 기능 47개만
AppBox.shared.함수명(...)형태의 인스턴스 API입니다. 기기 기능 공통 규칙 이하에서 다룹니다. - completion 기반 함수는 main thread에서 최대 한 번 callback합니다.
success == true는 SDK가 요청을 처리했다는 의미입니다. 서버 저장 완료나 화면 표시 완료를 항상 보장하지 않으므로 함수별 주의사항을 확인하세요.- 선택형 completion에는
nil을 전달할 수 있습니다. 필수 completion은 반드시 전달합니다. - 기능 Product가 없거나 초기화되지 않은 경우 앱을 중단시키지 않고
NSError,false또는 빈 결과로 실패를 전달합니다. - 오류를 기록할 때는
domain,code,localizedDescription을 함께 남기되 project ID, provider secret, APNs, Firebase token, 건강 데이터는 로그에 포함하지 않습니다.
공통 completion 해석
| 형태 | 성공 | 실패 |
|---|---|---|
(Bool, NSError?) | true, 일반적으로 error == nil | false, 실패 원인이 있으면 error 제공 |
(String?, NSError?) | 문자열 값, error == nil | nil, 실패 원인이 있으면 error 제공 |
([Model]?, NSError?) | 모델 배열, error == nil | nil, 실패 원인이 있으면 error 제공 |
(Model?, NSError?) | 모델 값, error == nil | nil, 실패 원인이 있으면 error 제공 |