# Javascript 개발 가이드



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

<div align="left"><figure><img src="https://2461137890-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiW553XSGeKCAPpImxXi3%2Fuploads%2FoXeriQAgRXPeKzGScr9f%2Fimage.png?alt=media&#x26;token=7e20348e-32f2-4c11-9f09-61de08a730c4" alt=""><figcaption></figcaption></figure></div>

### 1. **node.js 설치**

{% hint style="info" %}
[https://nodejs.org/ko/](https://nodejs.org/ko/) 링크로 이동해 node.js를 설치합니다.

안정적인 버전인 LTS 버전으로 설치하는 것을 추천 드립니다.
{% endhint %}

<div align="left"><figure><img src="https://2461137890-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiW553XSGeKCAPpImxXi3%2Fuploads%2FnMi8ny2QPlnoWIDUoEyy%2FUntitled%202.png?alt=media&#x26;token=b8f8e96d-4fe7-412c-8efc-a0eb4ef0e709" alt=""><figcaption></figcaption></figure></div>



### 2. **프로젝트 폴더 구성하기**

라이브러리 사용을 위해 프로젝트 폴더는 다음과 같이 구성합니다.

res 폴더는 앱에서 쓰일 이미지, 사운드, html 파일 등을 넣는 폴더입니다.

→ 폴더 이름을 **res**로 지정해야합니다.

<div align="left"><figure><img src="https://2461137890-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiW553XSGeKCAPpImxXi3%2Fuploads%2FiA6FKeQY1Liyx8KIIpos%2FUntitled%203.png?alt=media&#x26;token=f599ac9b-f90c-47f8-924e-87a713ec446d" alt=""><figcaption></figcaption></figure></div>



### 3. CLI를 사용해 프로젝트를 .zip 파일로 만들기

CLI를 사용해 명령어로 프로젝트를 **.zip** 파일로 만들 수 있습니다.

CLI는 MacOS의 경우 터미널, Windows의 경우 Windows PowerShell 또는 Windows 11부터 제공되는 터미널 환경에서 실행하실 수 있습니다.

> **Windows에서 PowerShell 실행하기**
>
> main.js가 있는 폴더 빈 공간에 **Shift + 오른쪽클릭**을 해서
>
> **`여기에 PowerShell 창 열기`** 또는 **`여기서 명령창 열기`** 메뉴를 누르면
>
> ![](https://2461137890-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiW553XSGeKCAPpImxXi3%2Fuploads%2FhUNtzM9jyhMcSvPAk5r7%2FUntitled%204.png?alt=media\&token=b0291ba8-6092-4476-9157-0aaeba1aa741)
>
> 다음과 같이 **Windows PowerShell** 또는 **명령 프롬프트** 창이 실행됩니다.
>
> ![](https://2461137890-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiW553XSGeKCAPpImxXi3%2Fuploads%2FigNx7hFgThBPdPhrK03M%2FUntitled%205.png?alt=media\&token=e8211f46-bcf0-4d9a-b9fb-7da934018362)



**main.js** 파일이 있는 폴더에서 명령 창을 열어서 다음과 같이 압축 파일을 만들기 위한 명령어를 입력합니다.

<pre class="language-powershell"><code class="lang-powershell"><strong>npx zep-script archive
</strong></code></pre>

<figure><img src="https://2461137890-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiW553XSGeKCAPpImxXi3%2Fuploads%2F7oPbBUbAWBtlqj2wRYfg%2FUntitled%206.png?alt=media&#x26;token=126fa5b2-f4ad-49fb-a78b-a7253a08e7a8" alt=""><figcaption></figcaption></figure>

압축 과정이 성공했다면 다음과 같이 폴더에 압축 파일이 생긴 것을 확인 할 수 있습니다.

<div align="left"><figure><img src="https://2461137890-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiW553XSGeKCAPpImxXi3%2Fuploads%2F2ujCz1u9fktGZxKkg8QR%2FUntitled%207.png?alt=media&#x26;token=2bc9ad7d-f88a-4b8b-a9cf-6538394080c4" alt=""><figcaption></figcaption></figure></div>

압축 파일을 만드는 것을 마지막으로, 앱을 배포할 준비가 끝났습니다.





### 4. 프로젝트 배포하기

**1.홈페이지에서 배포하기**

위에서 만든 압축(ZIP) 파일을 업로드 하는 방식으로 앱을 배포할 수 있습니다.

[<mark style="color:purple;">**ZEP Script 배포 가이드**</mark>](zep-script) 페이지를 참고해서 앱을 배포해보세요!



**2. 명령어(CLI)로 배포하기**

CLI를 사용해 위에서 만든 압축(ZIP) 파일을 배포할 수 있습니다.

다음과 같이 <mark style="color:purple;">`zep-script.json`</mark> 파일을 생성해 업로드 될 앱을 설정합니다. (이름이 동일해야 합니다.)

<div align="left"><figure><img src="https://2461137890-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiW553XSGeKCAPpImxXi3%2Fuploads%2FprZio3MdJjZ0EyXq3Foo%2FUntitled%208.png?alt=media&#x26;token=60b673a4-b54f-4a32-90c5-29b453cbac94" alt=""><figcaption></figcaption></figure></div>

```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/](https://zep.us/me/apps/)에 접속해서 업로드할 앱을 선택 후 주소창에 apps/뒤에 붙는 값을 입력하시면 됩니다.(아래 예시 이미지에서 **Zjkoj입**니다)

<div align="center"><figure><img src="https://2461137890-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiW553XSGeKCAPpImxXi3%2Fuploads%2FehxORm4TL2gzyFypblXE%2FUntitled%209.png?alt=media&#x26;token=9b330830-0a39-4ad4-ba6f-2f3a4b6a5c97" alt=""><figcaption></figcaption></figure></div>

**main.js** 파일이 있는 폴더에서 명령 창을 열어서 다음과 같이 압축 파일을 만들기 위한 명령어를 입력합니다.

```powershell
npx zep-script publish
```

앱 업로드 과정에서 계정 인증이 필요합니다.

다음과 같이 email을 입력하는 부분이 나오면 배포 할 앱을 소유하고 있는 계정의 email을 입력합니다.

<div align="left"><figure><img src="https://2461137890-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiW553XSGeKCAPpImxXi3%2Fuploads%2FZj8fFeE5JiXVJeAwAZTM%2FUntitled%2010.png?alt=media&#x26;token=f052cd94-27a9-4363-a023-5ed3a006ce5a" alt=""><figcaption></figcaption></figure></div>

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

<div align="left"><figure><img src="https://2461137890-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiW553XSGeKCAPpImxXi3%2Fuploads%2FlJIg7SSQdXq3jmuDXxbk%2FUntitled%2011.png?alt=media&#x26;token=07f5de5b-74e5-4f9e-937b-1ec3c4dcfff9" alt=""><figcaption><p>인증 메일 예시</p></figcaption></figure></div>

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

<div align="left"><figure><img src="https://2461137890-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiW553XSGeKCAPpImxXi3%2Fuploads%2FtwrcvPunhGbTQQapEno0%2FUntitled%2012.png?alt=media&#x26;token=44084a59-16a1-4261-8d3e-d3c5e4ed7b93" alt=""><figcaption></figcaption></figure></div>

위에서 **zep-script.json 파일**에 작성한 내용대로 [**나의 앱**](https://zep.us/me/apps) 페이지에 앱이 배포된 것을 확인 할 수 있습니다.

<figure><img src="https://2461137890-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiW553XSGeKCAPpImxXi3%2Fuploads%2F4Dgb29gvPyEWg7cGGX1b%2FUntitled%2013.png?alt=media&#x26;token=9b153256-5647-4095-b762-43150aad0f87" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**배포에 실패하는 경우 아래의 단계를 따라 재시도 해보세요.**

**npx 명령어를 사용하는 경우**

1. 터미널에서 "`npm i zep-script -g"` 명령 실행하여 SDK 패키지를 최신화
2. root 폴더에서 "`.zscsession"`  파일 삭제
3. "npx zep-script publish" 명령어로 배포 시도

**npm 명령어를 사용하는 경우**

1. package.json 파일의 "zep-script" 버전이 최신이 아니라면 최신 버전으로 업데이트
2. root 폴더에서 "`.zscsession"`  파일 삭제
3. "npm run deploy" 명령어로 배포 시도
{% endhint %}



라이브러리 관련하여 보다 자세한 내용은 아래 github 레포지토리 내용을 참고해주세요.

:clap:[zep-script-sdk/packages/zep-script-cli at main · zep-us/zep-script-sdk](https://github.com/zep-us/zep-script-sdk/tree/main/packages/zep-script-cli)

***
