본문으로 건너뛰기
가이드

빠른 시작

앱을 생성하고 샌드박스에서 첫 Note를 저장합니다.

빠른 시작

Node.js 22.12+, npm 11.x, PHP 8.5.12+, Composer를 준비하세요. Console에서 개발자 계정을 만들고 시작합니다.

1. 도구 설치와 프로젝트 연결

터미널의 원하는 작업 위치에서 실행하세요.

코드 예시
Shell
npm install -g @nexia/cli@alpha
nexia setup --devtools
nexia create project my-project
cd my-project

열린 브라우저에서 프로젝트 연결을 승인합니다. Console에서 이미 프로젝트를 만들었다면 create project 대신 빈 프로젝트 폴더에서 nexia connect <project-id>를 실행하세요. 프로젝트 ID가 포함된 명령은 Console의 개발 환경에서 복사할 수 있습니다.

2. 앱과 Note 생성

연결된 프로젝트 폴더에서 실행합니다. 각 명령의 질문을 완료하고 다음 명령으로 넘어가세요. my-app은 원하는 폴더명으로 바꿔도 됩니다. vendor에는 본인의 패키지 소유자 이름을 입력합니다.

코드 예시
Shell
nexia create app my-app
cd my-app
composer install --no-scripts
npm install
nexia make resource Note --label-ko 노트
nexia dev

dev는 켜 두세요. 새 앱은 두 번째 터미널의 같은 앱 폴더에서 nexia db migrate를 실행하고 완료된 뒤 엽니다. 이후 파일 저장만으로 migration을 적용하지 않으며, 준비되면 같은 명령을 다시 실행합니다.

dev가 앱 등록·샌드박스 준비·소스 반영을 진행합니다. 터미널을 켜 둔 채 위의 첫 migration을 별도 터미널에서 실행하세요.

3. 권한 설정과 저장 확인

  1. Console의 개발 환경에서 워크스페이스를 열고 설정 → 자격 증명 및 접근으로 이동합니다.
  2. 샌드박스 소유자는 준비가 끝난 개발 앱의 활성 권한을 자동으로 받습니다. 권한별 차이는 아래의 테스트 사용자로 확인합니다.
  3. CLI가 출력한 워크스페이스 URL을 엽니다. Console에서 열었다면 CLI의 로컬 주소를 연결합니다.
  4. 내 앱 → 운영 → 노트에서 새 노트를 저장합니다. 메뉴를 다르게 지정했다면 지정한 위치에서 엽니다.
  5. 새로고침 후 노트를 다시 열어 저장한 값이 유지되는지 확인합니다.

앱 실행 준비가 끝난 뒤 워크스페이스에서 권한을 설정하세요. 권한 목록에 Note가 없으면 앱 선언 반영 문제 해결을 확인하세요. 연결이나 실행이 실패하면 CLI 설치와 연결 오류 해결을 따르세요.

다른 사용자 권한으로 테스트

  1. 디렉터리 → 사용자에서 테스트 사용자를 준비합니다. 이메일 인증을 완료한 활성 사용자여야 합니다.
  2. 역할에서 앱의 개별 권한을 선택하고, 접근에서 테스트 사용자에게 역할과 적용 범위를 부여합니다. 권한이 없는 경우를 확인하려면 역할을 부여하지 않습니다.
  3. 사용자 상세의 이 사용자로 테스트를 선택합니다. 기존 개발 앱 연결은 유지되고, 화면과 API에는 선택한 사용자의 실제 권한이 적용됩니다.
  4. 조회·저장·차단 동작을 확인한 뒤 상단의 개발자로 복귀를 선택합니다. 권한을 바꾸고 다시 테스트할 수 있습니다.

이 기능은 개발 샌드박스에서만 제공됩니다. 전환 시 같은 샌드박스의 브라우저 탭도 새로고침되므로 작성 중인 내용을 먼저 저장하세요. 테스트 중 저장·삭제는 샌드박스 데이터에 반영됩니다. 테스트 중에는 초기 비밀번호·2단계 인증 설정 화면으로 이동하지 않으며, 계정의 실제 보안 설정은 변경되지 않습니다.

다음 작업

개발을 마칠 때 Ctrl+C로 로컬 감시를 종료합니다. 원격 앱 실행과 샌드박스는 Console에서 관리하며, Ctrl+C로 저장한 데이터가 삭제되지는 않습니다.

CLI 명령과 옵션은 공개 CLI 문서에서도 확인할 수 있습니다.

원본 위치: docs/developers/content/ko/getting-started/quickstart.md