본문으로 건너뛰기
버전: 4.6.2-saas

iOS Agent FAQ

Q. 에이전트가 빌드되지 않아요. (Invalid privacy manifest 오류)​

A. NetFUNNEL iOS 에이전트는 버전 4.2.5부터 Apple의 정책 변경에 따라 privacyInfo 파일이 수정되었습니다. 해당 오류가 발생하는 경우, 에이전트 버전이 최신인지 확인해 주세요.

Q. 델리게이트에서 앱 크래시가 발생해요.​

A. UI 관련 로직이 메인 스레드에서 실행되지는 않았는지 확인해 주세요.

Q. 디버깅용 로그 메시지를 확인하고 싶어요.​

A. NetFUNNEL iOS 에이전트에서 발생하는 로그 메시지를 확인하는 방법은 다음과 같습니다:

  1. 초기화 함수의 printLog: true 설정
정보

앱 배포 시 printLog: false 사용을 권장합니다.

Q. 대기실이 노출되지 않아요.​

A. 대기실을 활성화한 상태에서 진입 허용 수를 0으로 설정하면 실제 사용자 진입 없이 대기실을 노출시킬 수 있습니다.

콘솔의 [세그먼트 설정 → 기본 설정 → 진입 허용 수] 항목을 0으로 설정해 주세요.

Q. 델리게이트에서 UI를 업데이트하고 싶어요.​

A. 콜백 함수 사용 중 UI 업데이트를 하고자 한다면 주의가 필요합니다. 비동기로 동작하는 NetFUNNEL 콜백 함수 내에서 Alert 등의 UI 요소를 직접 호출하면 앱이 비정상적으로 동작하거나 크래시가 발생할 수 있습니다.

NetFUNNEL 콜백 함수를 사용할 때에는 DispatchQueue.main.async {}로 UI 업데이트를 비동기 스레드에서 메인 스레드로 전환해야 합니다.

아래는 UI 관련 작업을 메인 스레드에서 안전하게 실행할 수 있는 예시입니다.

DispatchQueue.main.async {
    let alert = UIAlertController(title: "알림", message: "성공적으로 진입하였습니다.", preferredStyle: .alert)
    alert.addAction(UIAlertAction(title: "확인", style: .default, handler: nil))
    activity.present(alert, animated: true, completion: nil)
}

Q. 에이전트 버전을 확인하고 싶어요.​

A. 에이전트의 버전을 확인하기 위해 getVersion() 함수를 사용할 수 있습니다.

함수명파라미터반환 값설명
getVersionN/AStringNetFUNNEL 에이전트의 버전을 반환(확인)하는 함수