Javascript 개발 가이드
zep-script-SDK 라이브러리를 사용해 폴더 구조를 깔끔하게 유지하고, 프로젝트 압축 및 배포를 명령어만으로 간단하게 진행 할 수 있습니다. zep-script-SDK 사용 방법을 알아보겠습니다.

1. node.js 설치

2. 프로젝트 폴더 구성하기
라이브러리 사용을 위해 프로젝트 폴더는 다음과 같이 구성합니다.
res 폴더는 앱에서 쓰일 이미지, 사운드, html 파일 등을 넣는 폴더입니다.
→ 폴더 이름을 res로 지정해야합니다.

3. CLI를 사용해 프로젝트를 .zip 파일로 만들기
CLI를 사용해 명령어로 프로젝트를 .zip 파일로 만들 수 있습니다.
CLI는 MacOS의 경우 터미널, Windows의 경우 Windows PowerShell 또는 Windows 11부터 제공되는 터미널 환경에서 실행하실 수 있습니다.
Windows에서 PowerShell 실행하기
main.js가 있는 폴더 빈 공간에 Shift + 오른쪽클릭을 해서
여기에 PowerShell 창 열기또는여기서 명령창 열기메뉴를 누르면
다음과 같이 Windows PowerShell 또는 명령 프롬프트 창이 실행됩니다.
main.js 파일이 있는 폴더에서 명령 창을 열어서 다음과 같이 압축 파일을 만들기 위한 명령어를 입력합니다.
npx zep-script archive
압축 과정이 성공했다면 다음과 같이 폴더에 압축 파일이 생긴 것을 확인 할 수 있습니다.

압축 파일을 만드는 것을 마지막으로, 앱을 배포할 준비가 끝났습니다.
4. 프로젝트 배포하기
1.홈페이지에서 배포하기
위에서 만든 압축(ZIP) 파일을 업로드 하는 방식으로 앱을 배포할 수 있습니다.
ZEP Script 배포 가이드 페이지를 참고해서 앱을 배포해보세요!
2. 명령어(CLI)로 배포하기
CLI를 사용해 위에서 만든 압축(ZIP) 파일을 배포할 수 있습니다.
다음과 같이 zep-script.json 파일을 생성해 업로드 될 앱을 설정합니다. (이름이 동일해야 합니다.)

{
"appId": "Zjkgoj", // app ID
"name": "Template", // app 이름
"description": "Template application" , // app 설명
"type": "normal" // app 타입 ( "normal" or "minigame" or "sidebar" )
}⭐ appID: 업로드할 앱의 ID를 입력합니다
기존 앱을 변경하시려면 https://zep.us/me/apps/에 접속해서 업로드할 앱을 선택 후 주소창에 apps/뒤에 붙는 값을 입력하시면 됩니다.(아래 예시 이미지에서 Zjkoj입니다)
main.js 파일이 있는 폴더에서 명령 창을 열어서 다음과 같이 압축 파일을 만들기 위한 명령어를 입력합니다.
npx zep-script publish앱 업로드 과정에서 계정 인증이 필요합니다.
다음과 같이 email을 입력하는 부분이 나오면 배포 할 앱을 소유하고 있는 계정의 email을 입력합니다.

Sending login code to your email이라는 메시지가 나오면 위에서 입력한 이메일의 메일 함에서 인증 코드를 확인한 뒤 입력해주면 배포가 시작됩니다.

다음 그림과 같이 Publishing… 텍스트 좌측에 초록색 체크 표시가 생기면 배포가 완료된 것 입니다.

위에서 zep-script.json 파일에 작성한 내용대로 나의 앱 페이지에 앱이 배포된 것을 확인 할 수 있습니다.

배포에 실패하는 경우 아래의 단계를 따라 재시도 해보세요.
npx 명령어를 사용하는 경우
터미널에서 "
npm i zep-script -g"명령 실행하여 SDK 패키지를 최신화root 폴더에서 "
.zscsession"파일 삭제"npx zep-script publish" 명령어로 배포 시도
npm 명령어를 사용하는 경우
package.json 파일의 "zep-script" 버전이 최신이 아니라면 최신 버전으로 업데이트
root 폴더에서 "
.zscsession"파일 삭제"npm run deploy" 명령어로 배포 시도
라이브러리 관련하여 보다 자세한 내용은 아래 github 레포지토리 내용을 참고해주세요.
👏zep-script-sdk/packages/zep-script-cli at main · zep-us/zep-script-sdk
Last updated
Was this helpful?

