PlanetKit 초기화 및 로그 설정
애플리케이션에서 LINE Planet의 기능을 사용하기 전에 PlanetKit을 초기화해야 합니다. 여기서는 PlanetKit을 초기화하고 로그를 설정하는 예제 코드를 제공합니다.
초기화
PlanetKitInitialSettingBuilder
객체를 인자로 PlanetKitManager
의 initialize()
를 호출해 PlanetKit을 초기화하세요. 이때 반드시 planet_base_url
을 설정해야 합니다.
환경별 planet_base_url
정보는 개발 환경에서 찾을 수 있습니다.
class YourApplication {
func initializePlanetKit() {
let logLevel: PlanetKitLogLevel = .simple
let logSizeLimit: PlanetKitLogSizeLimit = .small
let settingBuilder = PlanetKitInitialSettingBuilder()
.withEnableKitLogKey(level: logLevel, enable: true, logSize: logSizeLimit)
.withSetKitServerKey(serverUrl: planet_base_url)
let initialSettings = settingBuilder.build()
PlanetKitManager.shared.initialize(initialSettings: initialSettings)
...
}
}
로그 설정
디버깅하려면 PlanetKitInitialSettingBuilder
의 withEnableKitLogKey(level:enable:logSize)
를 사용하여 초기화 중에 로깅을 활성화하고 설정해야 합니다.
로깅 활성화
로깅을 활성화하려면 withEnableKitLogKey(level:enable:logSize)
를 호출하면서 enable: true
로 설정하세요. 기본적으로 로깅은 비활성화되어 있습니다.
PlanetKit 5.1부터는 파일로만 로그를 출력할 수 있습니다.
로그 수준 설정
로그 수준을 설정하여 디버그 정보 출력 수준을 조정할 수 있습니다.
로그 수준을 설정하려면 withEnableKitLogKey(level:enable:logSize)
의 level
파라미터를 PlanetKitLogLevel
의 값 중 하나로 설정하세요. 사용 가능한 로그 수준 설정은 다음과 같습니다.
silent
: PlanetKit이 디버그 정보를 출력하지 않습니다. (기본 값)simple
: PlanetKit이 간단한 디버그 정보를 출력합니다.detailed
: PlanetKit이 자세한 디버그 정보를 출력합니다.
- PlanetKit 5.2부터 로그 수준이 변경되었습니다.
- LINE Planet 팀에 디버깅을 요청하려면
detailed
수준으로 생성된 로그 파일을 전달해 주어야 합니다.
로그 크기 제한 설정
로그 파일의 전체 크기 제한을 설정하려면 withEnableKitLogKey(level:enable:logSize)
의 logSize
파라미터를 PlanetKitLogSizeLimit
의 값 중 하나로 설정하세요. 사용 가능한 로그 크기 제한 설정은 다음과 같습니다.
small
: 로그 파일의 전체 크기 제한은 16MB입니다.medium
: 로그 파일의 전체 크기 제한은 64MB입니다.large
: 로그 파일의 전체 크기 제한은 256MB입니다. (기본 값)unlimited
: 로그 파일의 전체 크기에 제한이 없습니다.