카카오모빌리티 디벨로퍼스 문서 카카오내비 길찾기 SDK with UI 릴리스 노트
표 릴리스 노트
버전 배포 날짜 변경 이력
v1.12.8-hotfix01 2025.11.18 [기능 개선]

1. KakaoSDK(v2-common) 버전 변경:
• 기존: 2.21.4
• 변경 후: 2.23.0


[오류 수정]

1. 전체경로에서 상세경로 확인 시 발생하는 크래시 수정

2. 주행 중 전체 경로 화면에서 교통 정보 버튼 연속 클릭 시 동작 오류 수정

3. 주행 화면에서 TalkBack 사용 시 발생하는 크래시 수정

4. 가로 모드에서 하단 메뉴 스크롤 오류 수정

5. 화면 축소 시 POI 깜빡임 현상 수정
v1.12.8 2025.09.30 [신규 기능]

1. appUserId 변경 API 추가 (KNSDK.setAppUserId(String?))


[기능 개선]

1. Android Target API 버전 변경:
🔹 기존: targetSDKVersion 33 (Android 13)
🔸 변경 후: targetSDKVersion 34 (Android 14)

2. 구간 단속 카메라 및 안전 운행 안내 기능 고도화
• 회전 구간 및 과속 단속 카메라 안내 시작 거리 조정 옵션 제공
• 과속 단속 카메라 위반 여부 및 과속 경고음 기준값 옵션 제공
• 이동식 과속 단속 카메라 경고음 옵션 제공
• 카메라 종별 추가: 노후 경유차 운행 제한 단속카메라
• 구간 단속 카메라 안내 및 표출 방식 개선:
- 카메라 통과 후 구간 단속 UI 표출
- 안전 운행 모드 ↔ 길 안내 모드 전환 시 구간 단속 카메라 안내 유지
- 구간 단속 거리 기준 개선
- 애플리케이션 종료 후 재시작 시 또는 경로 이탈 시에도 구간 단속 UI 유지
• 후면 단속 카메라 안내 개선: 카메라의 실제 위치를 통과한 후에도 일정 거리 동안 카메라 심벌 안내 유지
• 안전 운행 데이터 관련 개선:
- 후면 구간 단속 시/종점 코드 추가 및 표출 개선
- 후면 과속/신호 과속 단속 카메라 심벌 표출 개선
- 구간 단속 시점, 종점의 미니 심벌 표출 개선: 시작과 종료를 심벌 위에 명시
• 안전 운행 모드 시 수신 위치 정보(KNLocation)에 roadType, facilityType 추가

3. 경로 안내(RG) 및 음성 정책 개선
• 신규 경로 안내 추가: 비보호 좌회전, 직진, 도로시설물(터널, 지하차도, 고가차도)
• 경로 안내 시 노면 유도선 정보 추가
• 고속도로 근거리 안내 거리 조정 (500 m → 600 m)
• 기본 음성 파일 교체 및 문구 변경: 기본 음성 파일(default.snd) 교체
🔹 기존: 지하차도 침수 주의 구간입니다. 안전 운행하세요.
🔸 변경 후: 상습 도로 침수 구간입니다. 안전 운행하세요.
• 경로 음성 안내 정책 변경: '이어서', '추가 안내' 발화 순서 변경 및 스킵 정책 추가
🔹 기존: 기본 안내 → 이어서 안내 → 추가 안내(예: 500 m 앞 좌회전입니다. 이어서 우회전입니다. 첫 번째 출구입니다.)
🔸 변경 후: 기본 안내 → 추가 안내 → 이어서 안내(예: 500 m 앞 좌회전입니다. 첫 번째 출구입니다. 이어서 우회전입니다.)

4. 경로 탐색 및 매칭 정확도 개선
• KNDirection class에 회전각 정보 추가
• 시뮬레이션 시 매칭 속도 조정
• 네트워크 맵매칭 지연 시 경로 트리 재확장 로직 추가
• 도착 예정 시간 및 교통정보 상태 갱신 구조 개선: 경로 재탐색 프로세스와 독립적으로 도착 예정 시간과 교통정보 상태 갱신 주기를 서버에서 제어할 수 있도록 구조 변경
• 경로 요청 시 KNPOI.linkFilterInfo 추가
• KNTrip에 선호 경로 사용 여부 추가

5. 휴게소 판단 구역 조정 (진출 없는 진입 시 2 km → 1 km)

6. AudioAttributes 속성 중 Usage와 ContentType 설정 기능 추가
• 기본값
- AudioAttributes.USAGE_MEDIA
- AudioAttributes.CONTENT_TYPE_MUSIC
• 변경 함수
- KNGuide_Voice.setUSAGE(aUsage: Int)
- KNGuide_Voice.SetContentType(aContentType: Int)

7. 메모리 사용 및 성능 개선
• 다수 마커 등록 시 발생하는 메모리 스파이크 개선
• 렌더링 리소스 할당 시 메모리 스파이크 방어 코드 추가
• 저사양 단말 메모리 절감
• 지도 성능 개선

8. 카플레이(CarPlay), 클러스터 뷰 지도 스케일 통일

9. Fade 애니메이션 종료 시점 직접 핸들링을 통해 FrameDraw 갱신 모니터링 인터페이스 추가하여 최적화

10. 경로 내 화살표 꼬리 길이 조정

11. 안내 정보 표출 강화
• 하단 바에 버스전용차로 운영 여부 안내 문구 추가
• 구간 단속 구간 내 레드스크린 정책 개선:
🔹 기존: 구간 단속 평균 속도 기준으로 레드스크린 발생
🔸 변경 후: 구간 단속 내 과속 단속 카메라 및 구간 단속 종점 카메라 기준으로 레드스크린 발생하도록 변경. 레드스크린은 과속 단속 유형 카메라 안내 시작 거리 설정에 따라 과속 경고음과 동기화되어 표출
• 유고 심볼 표출 시 중복 제거
- 부분 통제일 때, 동일한 유고 정보에 대하여 경로상 최초 1회만 표출되도록 수정 요청. 전면 통제일 경우, 기존과 동일하게 중복 표출 유지
- 부분 통제 시 동일한 유고 정보는 경로상 최초 1회만 표출되도록 수정. 전면 통제의 경우 기존과 동일하게 중복 표출 유지
• 후면 과속 단속 카메라 통과 후 표지판 유지
• 차로 정보, 신규 경로 안내, 디렉션 뷰에 노면 유도선 색상 적용

12. 사용자 옵션 추가
• 주행 화면의 교통정보 표출 여부를 설정할 수 있는 on/off 옵션 제공
• 지도 부분 롱터치 시 좌표 콜백 기능
• 복합 교차로 이미지 on/off 옵션
• 지도 확대 비율 옵션

13. Android 16 KB 페이지 크기 대응


[오류 수정]

1. 경로 이탈 및 재탐색 관련
• 경로 이탈 시 재탐색 요청이 되지 않는 오류 수정
• 휴게소 이탈 방지 조건 오류 수정 (makeCandidate 중 topScoreCandidate가 갱신되지 못하는 오류)
• 재탐색 이후, 후면 단속 구간에서 카메라 통과 후 표출 구간이 사라지는 증상 수정

2. 도착 판단 및 도착 예정 시간(ETA) 관련
• 도착 판단이 과도하게 빠르게 동작하는 오류 수정
• 주행 중 KNTrip 객체를 통한 경로 요청 시 경로 캐싱이 동작하지 않는 오류 수정
• 경로 병합 판정 오류로 인한 크래시 수정
• eta 및 dynamic 정보 중복 요청 문제 수정
• eta 갱신 중지 현상 수정
• 휴게소 진입 시 ETA 초기화 오류 수정
• ETA 관련 Timer refresh 오류 수정

3. 위치 매칭 관련
• GPS가 부정확할 경우 터널 매칭 체크 로직 오류 수정
• 최초 구동 후 invalid gpsData가 지속 수신될 경우, 최초 좌표가 유지되는 오류 수정
• 휴게소 내 네트워크 매칭 부정확 시, 마지막 네트워크 매칭 위치로 경로 매칭 위치가 전달되는 증상 수정

4. 구간 단속 시 평균 속도가 미계산되거나, 터널 진입 시 평균 속도가 감소하는 현상 수정

5. 종점이 여러 개인 경우 구간 단속 정보 중복 제거

6. 링크 끝에 있는 카메라 알림음 미발생 오류 수정

7. 마지막 링크에 있는 카메라의 구간이 실제 위치보다 앞으로 설정되는 오류 수정

8. 마커 및 경로 선 관련
• 마커 삭제 시 카메라 업데이트가 있어야만 사라지는 현상 수정
• 마커 오브젝트 업데이트 시 발생하는 오류 수정
• 경로 선형 두께 업데이트 시 발생하는 오류 수정

9. 카플레이 첫 실행 시 마젠타 색상이 노출되는 현상 수정

10. POI 겹침 처리 시 간헐적으로 발생하는 크래시 문제 수정

11. KNConnection 객체에서 발생하는 NPE(Null Pointer Exception) 오류 수정

12. KNTrip 객체의 remain 함수에서 발생하는 오류 수정

13. 애니메이션 동작이 끝까지 동작하지 않는 오류 수정

14. 유턴 경로에서 경로가 제대로 표시되지 않는 오류 수정

15. RequestRenderer를 통해 FrameDraw 핸들링 기능의 오류 수정

16. 관심 지점(POI, Point of Interest) 갱신 관련 오류 수정

17. 지도 Style parser에서 특정 데이터가 중간에 빠진 경우, (데이터 불일치) 파싱을 시도하지 않도록 변경
v1.10.5-hotfix01 2024.09.05 [기능 개선]

1. 안전 운행 유형 추가
• 고의성 교통사고 다발지점 (26)
• 지하차도 침수구간 (40)

2. 접근성 대응

3. KNSDK.reqPOiDetail 요청 시 aIdList 인자에 대한 유효성 검사 추가


[오류 수정]

1. 맵 매칭 예외 상황 처리 개선

2. 지도상 다중 경로 표출 시 경로간 겹치는 부분 제거 로직 오류 수정
• 주 경로와 보조 경로의 시작점을 개별 처리하여 경로 미표시 문제 해결
v1.10.4
Beta.2		 2024.08.16 [기능 개선]

1. API 34 이상에서 KNSDK.handleWillEnterForeground() 호출 시, BroadcastReceiver Context.RECEIVER_NOT_EXPORTED 파라미터 추가
v1.10.4
Beta.1		 2024.06.28 [오류 수정]

1. 맵 매칭 과정에서 발생하는 성능 저하 문제 수정

2. 특정 상황에서 경로 이탈이 지속되는 문제 수정

3. 경로 선형 가장자리 색상이 잘못 표출되는 문제 수정

4. 등록된 마커 이미지 변경 후, 마커 영역을 가져올 때 변경 전 이미지 기준으로 마커 영역이 전달되던 문제 수정
v1.10.3
Beta.1		 2024.06.10 [기능 개선]

1. 위치 계산 로직 고도화

2. 초기화 이전 Trip 생성 요청(makeTripWithStart 호출) 시 전달되는 에러 코드 변경: C000 → C116


[오류 수정]

1. 경로 이탈 시 톨게이트 시점 정보가 연계되지 않아 요금 산출이 제대로 이루어지지 않는 문제 수정

2. 지도 타일이 회색으로 표출되는 문제 수정

3. 지도 리소스의 비정상적 요청 문제 수정
• 네트워크 불안정 시 지도 리소스를 반복 요청하는 문제 수정
v1.10.2
Beta.1		 2024.05.10 [기능 개선]

1. 위치 및 속도 성능 개선

2. 라우팅 성능 개선

3. 메모리 누수(Memory leak) 수정
• shouldPlayVoiceGuide의 리턴 값이 false 일 경우, KNVoice_Guide에 대한 릴리스 처리 추가


[오류 수정]

1. 터널 내 모의주행 관련 크래시 수정

2. 구간 단속 시 특정 상황에서 구간 속도가 업데이트 되지 않는 문제 수정

3. SQLite 데이터베이스 업데이트 문제 수정

4. 경로 안내 중 길 안내 정보가 늦게 갱신되는 문제 수정
v1.10.1
Beta.1		 2024.04.15 [기능 개선]

1. 초기화 관련 함수(KNSDK.initializeWithAppKey())의 식별자 이름 변경 및 신규 식별자 추가
• 기존 식별자 이름 변경: aUserKey -> aCsId
• 신규 식별자 추가: aAppUserId. 설치된 단말 또는 사용자 식별을 위한 변경되지 않는 값

2. 안전 운행 모드로 주행 중 터널 진입 시 터널 내 위치 시뮬레이션 기능 추가

3. 맵 매칭 개선

4. KNLocation 클래스 내 roadType, facilityType의 초깃값 변경: '_unknown(알 수 없음)' 값 추가 및 초깃값으로 설정

5. KNGuide_Voice 클래스의 voiceCode가 KNVoiceCode_BusLaneGuide일 경우, guideObj에 KNBusLane(버스 전용차로) 정보 전달


[오류 수정]

1. 지나간 RoadEvent 정보가 삭제되지 않고 계속 전달되는 문제 수정

2. 경로 컬러 설정 관련 애플리케이션 응답 없음(ANR) 문제 수정
v1.10.0
Beta		 2024.02.29 [신규 기능]

1. 안전 운행 데이터 매칭 고도화


[기능 개선]

1. Android 최소 지원 버전 상향:
• 기존: API 23: Android 6.0(Marshmallow) 이상
• 변경 후: API 26: Android 8.0(Oreo) 이상

2. KakaoSDK(v2-common) 버전 변경:
• 기존: 2.11.1
• 변경 후: 2.19.0

3. 위치 관련
• FIN(융합 실내 측위, Fused Indoor localizatioN) 터널 내 측위 기능 개선

4. 구간 단속 카메라 음성 안내 세분화
• 구간 단속 시점만 통과하고 종점을 통과하지 않는 경우에 대한 음성 안내 제공

5. 신호 정보 표출 기준 변경

6. 안전 운행 모드로 주행 시 안전 운행 정보의 표출 제외 옵션 추가

7. 경로 이탈 시 요금 정보가 사라지는 문제 수정

8. 경로 표시 내 화살표 디자인 개선

9. 경로 탐색 중 에러 발생 시 안내 팝업 메시지 표출

10. 안전 운행 모드 관련 안내 정책 개선
• 표지판 최대 노출 개수 변경(3개 -> 2개)
• 표지판 노출 우선순위 조정
• 과속 경고음과 과속 경고 화면 노출 기준 변경
• 심벌 표출 범위 확장
• 신규 유고 코드 및 심벌 추가: 기상 정보(5)

11. 메뉴 화면에 스크롤 적용


[오류 수정]

1. changeRoute() 호출 시 guidanceRouteChanged 콜백이 호출되지 않는 문제 수정
v1.9.4 2024.02.05 [기능 개선]

1. KMLocation SDK 1.103.63 버전 적용
• 위치 계산 로직 고도화

2. 기본 음성 파일 교체

3. 차로 안내 정보 개선
• KNLane_Laneinfo: 정보 전달 형식 변경
• 차로 안내 색상 표출 방식 개선

4. guidanceRouteChanged: 경로 변경 콜백 함수 수정
• 경로 변경 시 기존 경로 및 새로운 경로 정보와 경로 변경 사유 전달

5. 차량용 인포테인먼트(In-Vehicle Infotainment) 시스템을 사용할 때 길 안내 정보와 인접한 차로 정보만을 전달해 주던 방식에서 모든 차로 정보를 전달하도록 수정


[오류 수정]

1. 맵 매칭 시 동일 좌표에 대해 유효(valid) 값이 다른 경우, 동일한 매칭 결과로 인식하는 문제 수정

2. 매칭 리셋 조건 추가

3. 사용자 재탐색 시 링크 아이디 전달 조건 문제 수정

4. 재탐색 시 기본 좌표를 사용하여 경로를 요청하는 문제 수정
v1.9.3 2023.11.27 [기능 개선]

1. KMLocation SDK 1.3.57 버전 적용
• 외부 사용자 위치 콜백 설정을 위한 API 추가

2. 목적지 도착 및 주행 종료 팝업 메시지가 표시될 때 하단에 종료 버튼 추가


[오류 수정]

1. 맵 매칭 점수 계산 관련 수정

2. 지도 데이터를 로드할 때 Realm 로더에서 메모리 부족 오류(Out of Memory)가 발생하는 문제 수정

3. scaleToMbr 호출 시 자동차 아이콘이 카메라 중점 위치로 이동하는 문제 수정

4. 정북 모드 관련 자동차 아이콘 애니메이션 수정
• useNorthHeadingMode 플래그 추가
v1.9.2 2023.10.26 [기능 개선]

1. CarApp 라이브러리 버전 변경
• 기존: 1.1.0-rc01
• 변경 후: 1.3.0-rc01

2. KMLocation SDK 1.103.55 버전 적용

3. KNNetworkLinkMatching 및 KNMapMatching 매칭 로직 고도화

4. 대안 경로 선택 및 확정 로직 개선


[오류 수정]

1. GPS 수신이 불가한 상태에서 경로 재탐색 시 기본 좌표(광화문)로 안내되는 문제 수정

2. 경로 이어하기 시 현재 위치를 기반으로 경로를 요청했음에도 출발지 위치를 기준으로 경로가 요청되는 문제 수정

3. KNGPSData의 speedTrust 및 angleTrust 설정 오류
• KNGPSData 생성 시 전역 변수에 의해 값이 부정확해지는 문제 수정
v1.9.1 2023.09.19 [기능 개선]

1. Android Target API 버전 변경
• 기존: targetSDKVersion 31 (Android 12)
• 변경 후: targetSDKVersion 33 (Android 13)

2. KMLocation SDK 1.3.51 버전 적용
• OpenSky Accuracy 로직 고도화
• 실내 진·출입 로직 고도화
• 실내 측위 라이브러리 업데이트

3. 네트워크 맵 매칭 및 경로 맵 매칭 로직 고도화

4. 차로 정보 표출 방법 개선
• 기존: 550 m 이내에 직진 이외의 길 안내 정보(우회전, 좌회전, 유턴 등)가 있을 경우 해당 길 안내가 있는 지점의 차로 정보 제공
• 변경 후: 현재 위치의 차로 정보 제공

5. 안전 운행 시 안내되는 표지판 정보와 음성 안내 추가
• 과속 단속 카메라(후면)
• 신호·과속 단속 카메라(후면)
• 버스 전용차로·과속 단속 카메라
• 실시간 안개 주의 구간
• 실시간 결빙 주의 구간

6. 지도 설정 옵션 추가
• POI 글자 크기 조절 옵션 추가(0.1~2.0)
• 3D 건물 표시 여부 설정 추가

7. POI 간 겹침 이슈 개선

8. 화물차 경로 탐색 에러 코드 세분화에 따른 에러 표출 문구 추가

9. 안전 운행을 위한 신규 코드 UI 반영

10. SDK 초기화 완료 전 SDK Manager 접근 제한 코드 추가

11. KNGPSData
• OpenSky Accuracy 추가


[오류 수정]

1. 맵 매칭 오류 수정

2. 주행이 종료된 후에도 종료 안내 팝업 메시지가 표시되지 않는 문제 수정

3. 경로(KNRoute) 내 경유지 위치 정보(KNLocation) 획득 시 발생하던 문제 수정

4. 맵 매칭 문제 수정

5. 언어 변경 시 POI 텍스트에 즉각 반영되지 않는 문제 수정

6. 경로 생성 시 잔상이 남는 문제 수정

7. 주행 UI 표출 정책 및 관련 문제 수정

8. 기타 크래시 수정
v1.8.1 2023.06.22 [새로운 기능]

1. Map Matching V2 적용
• 현재 위치 주변 도로 데이터를 활용하여 매칭 성능 보완
• 매칭 정보를 활용 경로 이탈 판정 개선(예: 이탈 방지, 매칭 오류 방지) 효과
• 경로가 없는 상황에서도 기본적인 맵 매칭 수행
• 안전 운행의 안내 데이터를 도로에 매칭시켜 현재 위치의 도로와 대상 도로간의 라우팅을 기반으로 안전 운행 안내 판단
• 안전 운행 안내 거리 확장 및 부정확한 안내 필터링

2. KNGPSData, KNLocation: pos 프로퍼티의 자료형 변경
• 기존: IntPoint
• 변경 후: DoublePoint

3. 안전 운행 데이터 포맷 변경

4. 가변형 과속 단속 카메라 안내 추가

5. 기존 KNLocation 내 함수 추가
• isSameToLocation: 두 객체의 위치 정보를 비교하여 동일한 위치에 있는지와 동일한 위치 정보를 가지고 있는지 판단

6. 지도 내 표시되는 정보 추가
• 관심 지점(POI, Point of Interest) 주기 외 건물 동, 건물 입출구 지점 표시, 추가 POI 등의 정보 제공

7. 기존 KNNaviView 내 함수 추가:
• guideNewDestinations: 안전 운행을 취소 후 새로운 길 안내를 시작
• guideCancel: 기존의 길 안내를 취소 후 안전 운행으로 전환

8. 기존 KNNaviView_StateDelegate 내 함수 추가:
• naviViewPopupOpenCheck: 팝업 메시지의 열림 또는 닫힘 상태 전달
• naviViewScreenState: 현재 화면 상태 전달


[기능 개선]

1. Google Play Service 버전 업데이트
• 기존: 18.0.0
• 변경 후: 21.0.1

2. compileSdkVersion 버전 업데이트
• compileSdkVersion 33
• Kotlin 1.7.20
• Kotlinx 1.6.4
• compileOptions JavaVersion 11 (기존: JavaVersion 1.8)
• buildToolsVersion 30.0.3 (기존: buildToolsVersion 30.0.1)
• gradle 7.2.2 (기존: gradle 7.0.3)
• gradle-7.2-all (기존: gradle-7.5-bin)

3. KMLocation SDK 1.3.36 버전 적용
• 실내 측위 개선

4. 첫 번째 길 안내 지점에서 방면 명칭 관련 표출 방식 개선

5. KNGuide_Voice: 길 안내 음성이 표출되는 경로 요청 타입 추가

6. 경유지에 대한 방면 정보 표기 방법 개선

7. 길 안내 음성 조합 방식 개선

8. 맵 로더 개선:
• 지도 데이터 베이스에서 데이터를 읽고 파싱하는 방법 개선
• 지도 데이터 로딩 시간 감소
• 기존의 맵 데이터베이스를 sqlite에서 Realm으로 변경(10.38.3 버전 적용)
• 서버에 의해 초기 데이터베이스 유형(sqlite, Realm) 설정 가능

9. 지도 글꼴 변경

10. POI 주기 노출 수 증가

11. 고속모드 및 고속 도로 정보 표시 화면 개선
• 졸음 쉼터 및 상세 정보(화장실 유무 등) 표기
• 휴게소 내 주유소, 충전소의 가격 및 정보 표기
• 휴게소 내 경정비 정보 표기
• 화물차용 휴게소 아이콘 별도 표시

12. 경로 취소 버튼의 활성화 여부 설정 옵션 추가

13. 목적지 도착 알림 팝업 메시지 활성화 여부 설정 옵션 추가

14. 주행 시작 시 GPS 방향각을 빠르게 반영하도록 개선

15. 주행 화면 내 메뉴 개편 및 메뉴 내 사용자 정의 버튼 등 추가 기능 제공

16. 안전 운행 관련 주행 오류 제보 기능 추가
• 안전 운전 표지판, 차로 안내 영역 터치 시 관련 기능 활성화

17. 화물차 경로 상세 옵션 설정 추가

18. 애플리케이션 인증 시간 단축


[오류 수정]

1. 주행 시작 시 초기 매칭 시간이 오래 걸리는 문제 수정

2. 주행 시작 시 초기 매칭 상태에서 경로 이탈이 반복되는 문제 수정

3. 안전 운행 중에 발생하는 일부 카메라 정보의 매칭 문제 수정

4. 자차 이미지가 왜곡되어 표시되는 문제 수정

5. POI가 비정상적으로 표출되는 문제 수정

6. 지도 초기화 직후 간헐적으로 지도가 로드되지 않는 문제 수정

7. 차량 정차 시 목적지 도착 시간이 갱신되지 않는 문제 수정

8. 기타 크래시 수정
v1.6.10 2023.03.24 [오류 수정]

1. KNGuide_Voice의 메모리 부족(OOM, Out of Memory) 현상 발생에 대한 예외 처리

2. 지도 다운로드 시작과 동시에 네트워크가 끊기는 경우, 에러 콜백이 호출되지 않는 문제 수정

3. 경로 설정 없이 KNLocation의 guideLineGoal 속성을 이용하여 목표 지점을 설정할 경우 지시선이 보여지지 않는 문제 수정

4. 네트워크 스레드(thread)의 라이프 사이클(life cycle)이 정상적으로 동작되지 않아 발생한 크래시(crash) 수정
v1.6.9 2023.03.03 [오류 수정]

1. 음성 안내 중 발생하는 크래시(Crash) 문제 수정
• KNSoundPlayer, KNGuidance MediaPlayer 크래시에 대한 예외 처리

2. KNComponentBottomView: 주행 도중 정차 시 도착 시간이 갱신되지 않은 문제 수정
v1.6.8 2022.12.16 [새로운 기능]

1. KNComponentBottomMenuView: 경로 취소 버튼 활성화 여부 설정


[기능 개선]

1. 고속도로 경로 안내 시 표출 정보 추가: 졸음 쉼터, 유가 정보, 화물차 휴게소, 경정비소 등의 정보 추가

2. 방면 명칭 관련 표출 정보 추가:
a. 첫 번째 길 안내 지점에서 안내할 방면 명칭이 존재할 경우 해당 정보 표출
b-1. 방향을 안내하는 지점에서 안내할 방면 명칭이 존재하지 않을 경우 도로명 표출
b-2. 시설물 진입을 안내하는 지점에서 안내할 방면 명칭이 존재하지 않을 경우 시설물 명칭 표출
b-3. 어떠한 장소의 입구 또는 출구나 원톨링 시스템 진입, 분기 후 합류 등을 안내하는 지점에서 안내할 방면 명칭이 존재하지 않을 경우 길 안내 정보 표출
b-4. 톨게이트를 안내하는 지점에서 안내할 방면 명칭이 존재하지 않을 경우 노드 명칭 표출
c. b의 항목에서 첫 번째 길 안내에 표출할 명칭이 없으면 방면 명칭을 표지하지 않거나 기존의 방식대로 안내함. 또는, 다음 길 안내 지점 기준으로 노드 명칭이나 방면 명칭 표출
v1.6.6 2022.11.28 [새로운 기능]

1. 길 안내 종료를 안내하는 팝업 메시지 표시 여부 설정 추가


[기능 개선]

1. KMLocation SDK 1.2.18 버전 적용

2. 안정화 작업: 메모리 누수(Memory leak) 및 크래시(Crash) 문제

3. Android Target API 버전 변경
• 기존: targetSDKVersion 30 (Android 11)
• 변경 후: targetSDKVersion 31 (Android 12)
v1.6.5 2022.10.24 [새로운 기능]

1. 카카오내비 길찾기 SDK 배포 방식 변경
• 기존: Android Archive package (.arr) 파일을 통한 배포
• 변경 후: Maven을 통한 배포

2. 백그라운드 주행 기능 추가: 길 안내 중 3rd-party 서비스의 UI 화면과 같이 다른 화면으로의 전환 시 현재 경로의 음성 안내를 유지하며, 다시 길 안내 화면으로 돌아왔을 때에도 기존 경로를 이어서 안내

3. KNCitsDataType 클래스 추가: 주행 중인 도로의 신호등, 사고, 응급 차량 등의 정보 제공

4. 2차원(2D) 평면 지도와 3차원(3D) 입체 지도 간 전환 기능 추가

5. 주행 낮 테마와 주행 밤 테마 간 전환 기능 추가

6. KNNaviView_StateDelegate 델리게이트 추가: KNNaviView의 상태(주야간 모드 전환, 2D/3D 지도 간의 전환 등)를 나타내는 델리게이트

7. 주행 주야간 테마와 교통량에 따른 경로 라인 설정 기능 추가


[기능 개선]

1. KMLocation SDK 1.2.16 버전 적용

2. 지도 배경색을 파란색에서 하얀색으로 변경하여 로딩 시 발생하는 이질감 개선

3. 경로와 건물의 이미지 표출 순서를 수정하여 건물에 경로가 가려지는 현상 개선

4. KNGuidance 클래스의 aroundSafeties의 접근 제한자를 private에서 public으로 변경

5. KNNaviView_GuideStateDelegate 델리게이트 추가: KNNaviView의 상태를 나타내는 델리게이트


[오류 수정]

1. 백그라운드 모드에서 주행 시작 후 포그라운드 모드로 전환 시 마커가 노출되지 않는 문제 수정
v1.5.6 2022.08.19 [기능 개선]

1. 경로 테마의 변경이 즉각적으로 반영될 수 있도록 개선

2. KNGuidance:
• 주행 종료 후 안전 운행 모드 실행 시 신규 transId 발급
• 목적지 도착으로 종료 시 trip을 null로 설정하도록 변경. 이에 따라 guidanceGuideEnded()가 전달하는 guidance 내 trip이 null이 될 수 있음
• 동일한 transId를 가지고 중복으로 연결하지 않도록 개선
• 경로 요청 시 네트워크 통신 문제로 transId를 전달 받지 못하는 경우 기존의 연결을 해제하고 다시 네트워크에 연결하지 않도록 개선

3. KNTrip: 크래시 등에 의해 앱이 비정상적으로 종료된 후 다시 기존 경로를 계속 이어 나가는 ‘경로 이어하기’ 기능을 사용할 때 현재 위치를 기준으로 경로를 요청하도록 개선

4. 내비게이션 화면에서 경로 우선순위(Priority)를 선택할 경우 거리 우선 옵션이 표시되도록 개선

5. 목적지의 가이드라인 갱신 시 멀티 스레드에서 발생되는 크래시 방어 코드 추가

6. 함수 이름 변경:
• 기존: KNNaviView enableVolumeSetting
• 변경 후: isEnabledVolumeSetting


[오류 수정]

1. KNConnection:
• 네트워크 오류로 연결이 종료될 경우 다시 연결이 되지 않는 문제 수정
• KNConnection의 델리게이트에서 발생하는 nullPointException 문제 수정

2. KNGuidance: 커넥션 로그가 중복으로 업로드되는 문제 수정

3. KNCitsManager: 매칭 시 오버플로(Overflow)가 발생하는 문제 수정

4. 경로 생성 시 발생하는 인덱스 참조 문제 수정

5. 백그라운드 상태에서 주행을 하다가 내비게이션 화면으로 돌아올 때 출발, 경유, 도착 등을 표시하는 마커가 제대로 표시되지 않던 문제 수정

6. 주행 중 화면에서 다른 경로를 선택할 경우 거리 우선 옵션이 표시되지 않던 문제 수정
v1.5.0 2022.06.24 [새로운 기능]

1. 필수 라이브러리 및 프레임워크 추가
• ReactiveX
• Koin
• Efficient Java Matrix Library (EJML)

2. 기존 KNRouteConfiguration 클래스 내 프로퍼티 추가
• usage: 차량 용도 설정

3. 카카오내비 브랜드 사운드 적용


[기능 개선]

1. KMLocation SDK 탑재
• KMLocation SDK 탑재에 따른 GPS 활성화 상태 및 퍼미션 확인 로직 변경

2. onGPSSettingStatus 전달 방식 개선
• 기존: KNGPSManager의 checkGPSSettingStatus()를 호출할 경우 onGPSSettingStatus 전달
• 개선 후: 별도의 호출 없이 상태 변화를 감지하여 onGpsSettingStatus 전달

3. 지도 초기화 시 주간/야간 지도 테마를 바로 바꿀 수 있도록 개선

4. 가로 모드로 지도를 볼 때 비정상적으로 멀리 보이는 현상 개선

5. 장거리 경로 생성 속도 개선

6. 과속 단속 알림 음성이 안내 코드에 따라 다르게 표출하도록 개선

7. 경유지 추가 시 linkId를 전달하도록 변경

8. 인증 에러 관련 C103 메시지 별도 분리


[기능 삭제]

1. KNGPSSettingsReceiver 내 onConnectionFailed 함수 삭제