로그 사용법

iOS

Xcode 로 로컬 빌드가 가능한 경우
Console 앱을 사용하는 경우

로그 콜백 등록

SDK 초기화 시 로그 콜백이 붙어 있는지 확인합니다.

OneS1ght.onDebugLog = { level, line in print("[OneS1ght][\(level)] \(line)") }

initialize 보다 먼저 등록해야 초기화 단계의 로그가 남습니다.

등급으로 걸러낼 수 있습니다. LogLevel 은 Comparable 입니다.

OneS1ght.onDebugLog = { level, line in
    guard level >= .warn else { return }      // 확인이 필요한 것만
    print("[OneS1ght][\(level)] \(line)")
}

0.1.12 이전에는 글자만 왔습니다 — { line in ... }. 마이그레이션 가이드 참고.

디바이스 연결

iOS 기기를 Mac 에 연결합니다.

앱 빌드 및 실행

Xcode 에서 앱을 빌드하여 연결된 기기에 설치 및 실행합니다.

콘솔 필터 설정

Xcode 하단의 Console 탭을 엽니다. 우측 하단의 필터 입력란에 OneS1ght 를 입력하여 OneS1ght 로그만 표시되도록 설정합니다.

이슈 재현

문제가 발생하는 상황을 재현합니다.

로그 저장

약 30초 동안 앱을 활성화 상태로 유지합니다. Console 의 모든 로그를 선택 후 복사하고, 텍스트 에디터에 붙여넣어 파일로 저장합니다.

iOS 기기에서 직접 Xcode 로 빌드할 수 없는 경우, Mac 의 Console 앱으로 로그를 수집할 수 있습니다.

디바이스 연결

iOS 기기를 Mac 에 연결합니다.

Console 앱 열기

Spotlight 검색(Cmd + Space)에서 “Console” 을 검색하여 앱을 실행합니다.

로그 스트림 시작

Console 앱 좌측 사이드바의 장치 목록에서 연결된 iOS 기기를 선택합니다. 상단의 검색/필터 입력란에 앱의 번들 ID 를 입력하여 필터링합니다.

로그 초기화

이전 로그를 제거하기 위해 Console 창을 우클릭하여 Clear Console 을 선택합니다.

이슈 재현

문제가 발생하는 상황을 재현합니다.

로그 저장

약 30초 동안 앱을 활성화 상태로 유지합니다. 표시된 모든 로그를 선택 후 복사하고, 텍스트 에디터에 붙여넣어 파일로 저장합니다.

Console 앱은 print 로 찍은 줄을 잡지 못할 수 있습니다. 기기에서만 재현되는 문제를 볼 때는 onDebugLog 안에서 os.Logger 로도 남겨 두면 확실합니다.

import os
let log = Logger(subsystem: "com.yourcompany.yourapp", category: "OneS1ght")
OneS1ght.onDebugLog = { level, line in
    switch level {
    case .error: log.error("\(line, privacy: .public)")
    case .warn:  log.warning("\(line, privacy: .public)")
    default:     log.info("\(line, privacy: .public)")
    }
}

Console 앱 필터에는 subsystem(com.yourcompany.yourapp)을 넣으세요.

로그 등급

등급	뜻
`.log`	흐름 기록 — 평상시엔 안 봐도 됩니다
`.info`	알아두면 좋은 것 — 정상이지만 눈에 띄면 도움이 됩니다
`.warn`	확인이 필요한 것 — 고장은 아니지만 이대로면 기대한 대로 안 돌아갑니다
`.error`	고장 — 손대지 않으면 그 기능이 동작하지 않습니다

문제를 신고하실 때는 등급으로 거르지 말고 전부 보내주세요 — 고장 직전의 흐름이 원인을 가리키는 경우가 많습니다.

Android

준비 중입니다.

시작하기

측위 인프라 (GeoSpace)(모바일)

측위 인프라 (GeoSpace)(태그)

OneS1ght 콘솔

개발자 가이드 (SDK)

iOS

로그 등급

Android

​iOS

​로그 등급

​Android

iOS

로그 등급

Android