SDK란? API·라이브러리·프레임워크와의 차이

안녕하세요. 사랑받는 IT 프로덕트의 첫걸음, 똑똑한개발자입니다.

SDK(Software Development Kit)는 특정 플랫폼이나 서비스를 개발에 활용하도록 제공하는 도구 묶음입니다. 라이브러리, 문서, 예제 코드 등이 포함될 수 있습니다. 함께 쓰이는 API·라이브러리·프레임워크의 뜻과 차이를 살펴보겠습니다.

SDK란 말, 회의에서 왜 자꾸 나올까

견적서를 받으면 "결제 SDK 연동", "Next.js 프레임워크 기반 구축" 같은 줄이 보입니다. 대표나 PM, 디자이너에게는 비슷한 영어로 들려 질문을 미루기 쉽습니다. 그런데 일정과 비용을 정하는 게 바로 이 단어들입니다.

SDK란 무엇인가, 요리 비유로 네 단어 정리

식당 주방 하나를 떠올리면 네 단어가 금방 갈립니다.

API는 다른 주방에 주문을 넣는 창구입니다.

정해진 양식으로 주문서를 내면 결과만 받아 옵니다. 그 주방 안은 몰라도 됩니다.

라이브러리는 미리 손질해 둔 재료입니다.

언제 꺼내 어떤 순서로 쓸지는 요리사가 정합니다.

프레임워크는 동선과 순서가 정해진 프랜차이즈 주방입니다.

요리사는 정해진 자리에서 정해진 단계를 채웁니다. 순서는 주방이 정하고 차례가 오면 요리사를 부르는 식입니다.

SDK는 밀키트 상자입니다.

재료(라이브러리), 레시피(문서), 계량컵 같은 도구, 주문 창구 연결법(API)까지 한 상자에 들어 있습니다. Software Development Kit의 줄임말이니 개발 키트인 셈입니다.

라이브러리 프레임워크 차이는 '누가 누구를 부르나'

호출 흐름의 주도권은 라이브러리와 프레임워크를 설명할 때 자주 사용하는 기준입니다. 다만 라이브러리도 콜백이나 렌더링 흐름을 제어할 수 있어 단일 호출 방향만으로 구분되지는 않습니다. 제공하는 구조와 책임 범위를 함께 보면 이해하기 쉽습니다.

React는 UI 라이브러리입니다.

React 공식 사이트는 스스로를 웹과 네이티브 사용자 인터페이스를 위한 라이브러리라고 소개합니다. 화면 조각만 맡을 뿐 나머지 구조는 개발팀 몫입니다.

Next.js는 내 코드를 부르는 프레임워크입니다.

Next.js 공식 사이트는 스스로를 웹을 위한 React 프레임워크라고 부릅니다. 정해진 폴더에 파일을 두면 그 파일이 페이지가 됩니다. 언제 화면을 그릴지는 Next.js가 정하고 개발자는 빈칸만 채우면 됩니다.

SDK와 API는 어떤 관계일까

API가 주문 창구라면 SDK는 그 창구를 쉽게 쓰게 해 주는 상자입니다. API를 직접 불러도 되지만 SDK를 쓰면 인증·오류 처리 같은 반복 작업이 줄어듭니다.

토스페이먼츠 SDK는 결제 화면을 통째로 가져옵니다.

토스페이먼츠 JavaScript SDK 하나면 결제위젯, 결제창, 브랜드페이, 자동결제까지 붙습니다.

카카오 SDK와 Firebase SDK도 같은 구조입니다.

카카오는 JavaScript·Android·iOS·Flutter SDK로 카카오 로그인과 카카오톡 공유를 제공합니다. Firebase JavaScript SDK는 인증, Firestore, 스토리지, 푸시 메시지를 모듈별로 나눠 담았습니다.

비개발자가 SDK를 알면 좋은 세 순간

견적을 볼 때 공수가 왜 짧은지 이해됩니다.

SDK가 제공하는 기능을 재사용하면 일부 구현 작업을 줄일 수 있습니다. 실제 작업량은 SDK가 지원하는 범위와 서비스 요구사항에 따라 달라집니다. API만 열어 둔 서비스는 그 몫을 직접 만들어야 합니다.

기술 선택에서 무엇을 물을지 정해집니다.

프레임워크는 한번 고르면 폴더 구조와 배포 방식까지 따라옵니다. 라이브러리는 부분만 갈아 끼우기 쉬운 편입니다.

락인을 미리 계산할 수 있습니다.

특정 회사 SDK에 깊이 기대면 나중에 결제사나 백엔드를 바꿀 때 코드를 크게 고쳐야 합니다.

세부 설정과 지원 범위는 React 공식 소개를 참고해 보세요.

필요한 기능을 자연스럽게 연결합니다

결제나 로그인 같은 기능을 붙이다 보면 도구 이름보다 실제로 어떤 화면과 동작이 필요한지 궁금해집니다. 사용자가 거치는 흐름을 함께 보면 연동 범위도 구체화됩니다.

똑똑한개발자는 UX/UI 디자인과 웹·앱 개발을 함께 진행합니다. 필요한 화면과 기능을 정리하고, 실제 이용과 운영을 고려해 서비스를 만들어가는 과정을 돕습니다.

지금 만들고 있는 서비스나 개선하고 싶은 부분이 있다면 아래 똑똑한개발자 링크로 편하게 이야기 남겨주세요. 함께 살펴보겠습니다. 감사합니다. :)