Native SDK

네이티브 렌더링과 성능

내장 엔진이 모든 인터페이스를 실제 OS 창에 직접 그립니다. 스크롤 물리 효과, 메뉴, 대화 상자, 시스템 트레이 등 사용자가 상호작용하는 요소는 운영 체제가 제공합니다. 마크업은 빌드 시 실행 파일로 컴파일되어 파서나 인터프리터가 포함되지 않으므로, 스크래프olding된 카운터 앱도 몇 MB 크기의 단일 바이너리로 빌드됩니다.

선언적 개발 모델

이벤트가 메시지를 생성하고, 메시지가 상태를 업데이트하며, 상태가 인터페이스를 렌더링하는 명확한 상태 머신 기반의 개발 모델을 제공합니다. 타입스크립트 코어는 순수 함수로 상태 변경을 관리하며, ‘update’ 함수가 유일한 상태 변경 지점입니다. ‘native dev’를 실행하는 동안 ‘.native’ 파일을 편집하면 상태를 유지한 채 윈도우가 즉시 업데이트됩니다.

빌트인 컴포넌트 카탈로그

버튼, 탭, 텍스트 필드, 대화 상자, 차트, 가상 목록 등 고려된 타이포그래피와 색상으로 제공되는 내장 컴포넌트 카탈로그가 포함되어 있습니다. 앱을 초기화하면 의도적으로 설계된 인터페이스가 즉시 표시됩니다.

AI 통합 워크플로우

각 앱은 자동화 서버를 내장하여 AI 에이전트가 접근성 스냅샷을 읽고, 위젯을 제어하고, 라이브 상태를 확인하고, 실행 중인 창의 결정론적 스크린샷을 촬영할 수 있습니다. ‘native check’ 명령은 모든 뷰를 유효성 검사하며, ‘native automate record/replay’를 사용하여 세션을 녹화하고 재현할 수 있습니다.

다운로드·설치 방법

Node.js 환경에서 npm을 사용하여 CLI를 전역 설치할 수 있습니다. 터미널에서 ‘npm install -g @native-sdk/cli’ 명령을 실행하면 CLI가 설치됩니다.

기본 사용법/명령어

‘native init my_app’ 명령으로 새 앱을 생성하고, ‘cd my_app’ 후 ‘native dev’를 실행하면 실제 창이 열리며 작업할 수 있습니다. 앱의 구조는 뷰(src/app.native), 로직(src/core.ts), 매니페스트의 세 가지 파일로 구성됩니다. ‘native dev –core’는 타입스크립트 코어를 node에서 실행하여 로직을 빠르게 확인할 수 있고, ‘native check’는 밀리초 단위로 코어와 모든 뷰를 검증합니다. ‘native build’는 최적화된 릴리스 바이너리를 생성합니다.

이런 경우에 유용합니다

웹 기술의 개발 속도와 자유로움을 원하면서도 브라우저나 WebView의 오버헤드 없이 빠르고 가벼운 네이티브 데스크톱 앱을 만들어야 하는 개발자에게 유용합니다. 특히 음악 플레이어, 메모 앱, 계산기, 프로세스 모니터 같은 다양한类型的의 데스크톱 앱을 빠르게 프로토타이핑하고 빌드해야 하는 경우 도움이 됩니다. AI 에이전트와 함께 코드를 생성하고 테스트하는 워크플로우를 구축하려는 경우에도 적합합니다.

지원 환경·시스템 요구사항

macOS가 주요 개발 플랫폼으로 가장 깊은 지원을 제공합니다. Linux는 실제 창에서 전체 쇼케이스를 실행할 수 있고, Windows는 Win32 호스트에서 IME 합성을 지원하며 CI 환경에서 검증됩니다. 모바일 지원은 실험적 단계로, iOS는 시뮬레이터에서 검증되었고 Android는 전체 임베드 ABI로 크로스 컴파일됩니다. 각 플랫폼이 지원하는 기능은 공식 문서의 플랫폼 지원 매트릭스에서 확인할 수 있습니다.

최신 버전·업데이트

현재 버전은 0.10.1이며, Apache-2.0 라이선스로 제공됩니다. 프로젝트는 pre-1.0 단계로 API가 빠르게 발전하고 있으며, 버그 리포트와 집중적인 풀 리퀘스트가 환영받습니다.

화면으로 보는 주요 기능

앨범 보기 화면

Soundboard 예제 앱의 앨범 격자 뷰. 'Blue Season' 앨범이 재생 중으로 표시되며, 하단 상태 표시줄에서 현재 재생 곡 정보를 보여줍니다.

스테레오 데크 인터페이스

Deck 예제 앱의 하드웨어 스타일 재생 인터페이스. 볼륨 조절, 스펙트럼 분석기, 곡 정보와 함께 정교한 레트로 디자인이 적용되어 있습니다.

작업 목록 화면

기본 타이머 앱의 작업 관리 인터페이스. 탭 필터링, 체크박스, 상태 표시 등 실용적인 UI 컴포넌트들이 구성되어 있습니다.

마크다운 뷰어 에디터

좌측 편집기와 우측 미리보기가 분할된 마크다운 뷰어. 위젯으로 렌더링된 제목, 표, 목록 등이 실시간으로 반영됩니다.