본문으로 건너뛰기
Version: 5.5

PlanetKit 초기화 및 로그 설정

애플리케이션에서 LINE Planet의 기능을 사용하기 전에 PlanetKit을 초기화해야 합니다. 여기서는 PlanetKit을 초기화하고 로그를 설정하는 예제 코드를 제공합니다.

초기화

PlanetKitInitialSettingBuilder 객체를 인자로 PlanetKitManagerinitialize()를 호출해 PlanetKit을 초기화하세요. 이때 반드시 planet_base_url을 설정해야 합니다.

Note

환경별 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)
...
}
}

로그 설정

디버깅하려면 PlanetKitInitialSettingBuilderwithEnableKitLogKey(level:enable:logSize)를 사용하여 초기화 중에 로깅을 활성화하고 설정해야 합니다.

로깅 활성화

로깅을 활성화하려면 withEnableKitLogKey(level:enable:logSize)를 호출하면서 enable: true로 설정하세요. 기본적으로 로깅은 비활성화되어 있습니다.

Note

PlanetKit 5.1부터는 파일로만 로그를 출력할 수 있습니다.

로그 수준 설정

로그 수준을 설정하여 디버그 정보 출력 수준을 조정할 수 있습니다.

로그 수준을 설정하려면 withEnableKitLogKey(level:enable:logSize)level 파라미터를 PlanetKitLogLevel의 값 중 하나로 설정하세요. 사용 가능한 로그 수준 설정은 다음과 같습니다.

  • silent: PlanetKit이 디버그 정보를 출력하지 않습니다. (기본 값)
  • simple: PlanetKit이 간단한 디버그 정보를 출력합니다.
  • detailed: PlanetKit이 자세한 디버그 정보를 출력합니다.
Note
  • PlanetKit 5.2부터 로그 수준이 변경되었습니다.
  • LINE Planet 팀에 디버깅을 요청하려면 detailed 수준으로 생성된 로그 파일을 전달해 주어야 합니다.

로그 크기 제한 설정

로그 파일의 전체 크기 제한을 설정하려면 withEnableKitLogKey(level:enable:logSize)logSize 파라미터를 PlanetKitLogSizeLimit의 값 중 하나로 설정하세요. 사용 가능한 로그 크기 제한 설정은 다음과 같습니다.

  • small: 로그 파일의 전체 크기 제한은 16MB입니다.
  • medium: 로그 파일의 전체 크기 제한은 64MB입니다.
  • large: 로그 파일의 전체 크기 제한은 256MB입니다. (기본 값)
  • unlimited: 로그 파일의 전체 크기에 제한이 없습니다.

관련 예제 코드

관련 문서