Maplair 4.0이 Leaflet을 확장하고 마이그레이션 변경점을 공개했다

Leaflet에서 갈라진 Maplair가 4.0.0을 첫 안정 버전으로 출시했습니다. 지도 회전·검색·전체 화면·히트맵을 플러그인이나 우회 방법 없이 제공합니다. 저는 첫 안정 버전이라는 말에 오래 멈췄습니다. 실제 프로젝트가 검토할 단계에 들어왔다는 반가움과 기존 코드가 그대로 이어지지 않는 부담이 함께 보였기 때문입니다.

Leaflet은 데이터 시각화 도구를 다룬 글에서도 다른 라이브러리와 함께 언급됩니다. Maplair는 지도 기능을 넓히지만, 새 기능과 함께 기존 플러그인을 옮기는 비용도 생긴다는 점에서 도구 선택의 현실적인 면을 보여 줍니다.

Leaflet에서는 플러그인이나 우회책이 필요했던 기능을 Maplair는 기본 제공하고, 번들러(bundler)는 쓰지 않는 기능을 제외합니다. 타일 레이어만 사용할 때 압축 자바스크립트(JavaScript)는 약 34KB입니다. 기능이 늘어도 필요한 것만 묶을 수 있다는 점이 실용적으로 반갑습니다.

다만 Leaflet 1.9.4에서 옮기려면 가져오기 방식과 스타일 클래스, 객체 생성 코드를 점검해야 합니다. Maplair는 이름이 지정된 ES 모듈(ECMAScript module) 내보내기만 제공합니다. 기본 내보내기나 전역 L을 기대하는 코드는 그대로 이어지지 않습니다. 기존 플러그인 대부분도 수정 없이 작동하지 않을 수 있어, 플러그인에 기대는 프로젝트는 이식 작업량이 먼저 눈앞에 옵니다.

기존 지도를 전부 바꾸기 전에 플러그인 의존성이 적은 화면 하나를 골라 Maplair로 옮겨 보십시오. 검색에 공개 Nominatim 서버를 쓴다면 사용 정책을 확인하고 acceptUsagePolicy: true 설정도 하십시오. 화면이 뜨는지만 보지 말고 기존 플러그인이 실제로 작동하는지까지 확인하면 전환 비용이 드러납니다.

새 지도 기능을 검토할 때, 기존 플러그인 호환성과 직접 옮길 코드 중 무엇을 먼저 살피십니까?