Skip to main content
iOS SDK 최신 버전을 찾으신다면 SDK 다운로드를 눌러주세요

​
0.1.12 — 2026-08-27

로그에 등급이 생겼습니다.
깨는 변경 — onDebugLog 와 onLog 의 클로저 인자가 둘로 늘었습니다. 마이그레이션 가이드를 참고하세요.
예전에는 글자만 전달돼서, 받는 쪽이 맨 앞 이모지를 보고 등급을 짐작해야 했습니다. 문구가 바뀌면 조용히 오분류됐고, 실제로 “이 층에 구역이 없다”는 정상 상태가 오류로 표시되고 있었습니다.
Comparable 이라 level >= .warn 처럼 걸러낼 수 있습니다. 84개 문구의 등급을 전수로 정했습니다 — 구역이 없는 층은 info, 호출 순서를 틀린 것 (세션 ID 미주입·층 미지정)은 error 입니다.

​
0.1.11 — 2026-08-27

구역을 지우면 판정도 함께 멈춥니다. SDK 문구의 언어를 앱이 지정할 수 있습니다.
  • 빈 구역 목록이 판정 엔진까지 전달됩니다. 내부에서 빈 목록을 걸러내는 바람에, 콘솔에서 구역을 전부 지워도 엔진이 지운 구역을 계속 물고 있었습니다. 지도에서 사라진 자리에서 없어진 시책이 계속 발화했고, 층을 갈아탔을 때 새 층에 구역이 없으면 옛 층 구역으로 판정했습니다.
  • setLanguage(_:) — 앱이 자체 언어 설정을 가지고 있을 때 씁니다.
    안 부르면 예전 그대로 기기 언어를 씁니다.
  • 판정 미가동 경고가 원인을 말합니다. “존 미주입 또는 start 실패” 한 줄이라 어느 쪽인지 알 수 없었는데, 둘은 할 일이 완전히 다릅니다 — 앞은 콘솔에서 구역을 그리면 되고, 뒤는 엔진 문제입니다.

​
0.1.10 — 2026-08-27

중단됐다 돌아온 측위가 다시 시작됩니다. 한 번 중단되면 좌표가 그 자리에서 멈춘 채 돌아오지 않았습니다. NearbyInteraction 은 중단이 풀렸다고 알아서 다시 재지 않습니다 — sessionSuspensionEnded 가 오는 것 자체가 “이제 다시 run 해도 된다”는 신호이고, 재실행은 SDK 몫인데 그것을 빠뜨렸습니다. 오류도 없고 상태는 “측위 중” 이라, 화면상으로는 점만 안 움직였습니다. 중단은 앱이 잠깐 백그라운드로 갔다 오는 것만으로도 일어나므로, 증상이 간헐적으로 보였습니다.

​
0.1.9 — 2026-08-26

측위 불가 기기에서도 도면과 존을 볼 수 있습니다.
깨는 변경 — initialize 가 더 이상 기기 미지원으로 실패하지 않습니다.
기기 게이트가 initialize 첫 단계에 있어서, UWB 칩이 없으면 세션이 아예 만들어지지 않았습니다. 그러면 buildings·floors·zones·locators 가 전부 막혀 화면에 그릴 것이 하나도 남지 않았습니다. 측위 불가와 지도 표시 불가는 다른 문제인데 하나로 묶여 있었습니다.
initialize 의 성공을 “이 기기에서 측위 가능” 으로 읽고 있었다면 OneS1ght.deviceAvailability 로 묻거나 begin() 의 throw 를 받으세요. 또한 실시간 변경 이벤트가 하나도 도착하지 않던 것을 고쳤습니다. SSE 는 빈 줄로 프레임이 끝나는데 읽기에 쓰던 API 가 그 빈 줄을 돌려주지 않아, 프레임이 하나도 완성되지 않았습니다. 연결 직후의 재동기화는 파서를 거치지 않아 연결도 되고 첫 갱신도 정상으로 보였고, 증상은 “새로고침을 눌러야 갱신된다” 뿐이었습니다. 층 목록을 부를 때 층마다 도면을 통째로 받던 것(한 층당 888KB)도 함께 고쳤습니다.

​
0.1.8 — 2026-08-25

실시간 수신이 측위를 시작하기 전에도 붙습니다. onConfigChanged 가 측위 세션 구간에만 연결돼 있어서, 층을 골라 도면만 보는 동안에는 콘솔에서 무엇을 바꿔도 앱이 알지 못했습니다. 이제 층을 지정하면 그 시점부터 연결되고, 측위를 껐다고 끊지 않습니다.

​
0.1.7 — 2026-08-24

빌딩을 골라도 층이 뜨지 않던 것을 고쳤습니다. GeoSpace 건물 트리는 층 ID 를 숫자로 보내는데("floorId": 14) 디코더가 문자열로 선언돼 있어 JSON 디코딩이 통째로 실패했습니다. 호출부가 오류를 삼켜 증상은 “층 목록이 비어 있다” 뿐이었습니다. 이제 숫자로 오든 문자열로 오든 받습니다.

​
0.1.6 — 2026-08-21

코드 변경 없음. 연동 예제가 컴파일되지 않던 것을 고쳤습니다. ?? 오른쪽은 autoclosure 라 try/await 를 담을 수 없습니다.

​
0.1.5 — 2026-08-21

코드 변경 없음. 저장소 주소가 바뀌었습니다.
package: 식별자도 함께 바꿔야 합니다. SPM 은 패키지 식별자를 저장소 이름에서 뽑으므로, URL 만 고치면 unknown package 'onesight-mobile-swift' 로 빌드가 깨집니다. Xcode 프로젝트라면 패키지 의존성을 지웠다가 새 주소로 다시 추가하세요.

​
0.1.4 이하 — 2026-08-20 ~ 08-21

초기 배포와 그 직후의 수정입니다. 전체 내역은 CHANGELOG를 참고하세요.
0.1.3 이하는 현재 운영 서버와 초기화가 실패합니다. 0.1.12 이상을 쓰세요.