본문으로 건너뛰기
가이드

SDK 사용 시작하기

SDK 사용 시작하기

SDK 사용 시작하기

SDK는 앱에서 플랫폼 기능과 공통 화면 요소를 사용하는 도구입니다. 생성된 앱의 SDK 의존성과 예제를 기준으로 개발하세요.

무엇을 수정하나요?

  • 데이터와 저장 규칙: 앱의 모델·Controller·Policy를 수정합니다.
  • 목록과 입력 폼: 생성된 React 화면에서 SDK 컴포넌트를 사용합니다.
  • 메뉴와 권한: 생성된 Resource Module을 수정합니다.
  • 외부 API 키·연동 옵션: 설정을 선언하고 플랫폼의 앱 설정 화면에서 값을 입력합니다.

PHP와 화면 코드

PHP 코드는 Nexia\*의 공개 인터페이스를 사용합니다. 화면 코드는 생성된 앱처럼 @nexia/sdk 또는 @nexia/sdk/host에서 가져옵니다. Core 내부 클래스나 다른 앱의 소스를 직접 가져오지 마세요.

PHP SDK 사용 · 화면 SDK 사용 · 설정과 비밀값

SDK 버전을 바꿀 때

앱의 composer.json과 package.json에서 지원 버전을 확인하세요. 필요한 기능이 현재 버전에 없으면 플랫폼의 지원 여부를 먼저 확인합니다. 버전 숫자만 바꿔서 기능이 생기지는 않습니다. 변경한 의존성 잠금 파일도 함께 관리하세요.

플랫폼이 호환성을 확인한 경우 이전 SDK 요구 버전을 명시적으로 지원할 수 있습니다. Core 0.11.36의 React SDK 0.9.0은 0.8.26을 요구하는 앱을, Runtime PHP SDK 0.11.0은 0.10.36을 요구하는 앱을 지원합니다. 이 전환을 위해 기존 앱의 버전 선언만 변경할 필요는 없습니다. 이 지원은 해당 버전에 한정되며 새 SDK 기능을 사용할 때는 앱과 의존성을 계속 확인하세요.

SDK를 직접 수정하거나 설치된 vendor/·node_modules/를 고치지 않습니다. 필요한 공개 기능이 없다면 개발자 지원으로 요청하세요.

React SDK 0.9.0 · PHP SDK 0.11.0

설치된 SDK 확인

코드 예시
Shell
composer show nexia-cloud-os/sdk-laravel
npm list @nexia/sdk

설치 버전을 앱의 호환성 요구사항과 비교하세요. SDK 호출을 변경했다면 허용·거부 사용자를 각각 사용해 해당 화면을 확인합니다. 패키지 설치만으로 권한이나 저장 동작이 검증되지는 않습니다.

원본 위치: docs/developers/content/ko/app-sdk/overview.md