설치

준비사항: NodeJS 환경, 그리고 NPM 또는 Yarn

리스크립트를 전역으로 설치하려면 다음처럼 합니다.

npm install -g bs-platform

새 프로젝트

git clone https://github.com/rescript-lang/rescript-project-template
cd rescript-project-template
npm install
npm run build
node src/Demo.bs.js

리스크립트 파일을 자바스크립트로 컴파일 한 다음 NodeJS를 사용해 컴파일된 자바스크립트 파일을 실행합니다. 우리는 다른 한쪽 탭에 작업중인 .bs.js 열어놓고 작업하는 것을 강력 추천합니다. 이렇게 하면 리스크립트가 어떤 형태의 자바스크립트 코드로 변경되는지 알 수 있습니다. 개발자가 읽을 수 있는 자바스크립트 결과물을 만들어주는 환경은 그다지 많지 않습니다!

개발하는 동안에 npm run build 스크립트로 매번 컴파일하기보다 npm run start 스크립트로 파일이 변경되면 자동으로 재컴파일되도록 하는 것이 편합니다.

새 프로젝트를 시작하는 다른 방법으로는 ReasonReact로 설치하는 방법을 따라해도 무방합니다.

기존 JS 프로젝트와 통합

다음 단계를 따라하면 기존 자바스크립트 프로젝트에 리스크립트 환경을 구축할 수 있습니다.

리스크립트 설치

npm install rescript --save-dev 

환경 파일 생성

프로젝트 루트 디렉토리에 bsconfig.json 파일을 만듭니다.

{
  "name": "your-project-name",
  "bsc-flags": ["-bs-super-errors"],
  "sources": [
    {
      "dir": "src",
      "subdirs": true
    }
  ],
  "package-specs": [
    {
      "module": "es6",
      "in-source": true
    }
  ],
  "suffix": ".bs.js",
  "namespace": true,
  "bs-dependencies": [],
  "ppx-flags": [],
  "refmt": 3
}

사용자의 디렉토리 구조에 따라 sources 필드의 정보를 리스크립트 파일이 존재하는 위치로 알맞게 수정하세요.

bsconfig.json의 자세한 설명은 빌드 환경설정 페이지를 참고하세요.

package.json에 스크립트 추가

리스크립트 컴파일에 도움이 되도록 package.json에 2가지 스크립트를 추가합니다.

"scripts": {
  "re:build": "rescript",
  "re:start": "rescript build -w"
}

React JS 사용

리스크립트 프로젝트에 리액트를 사용하려면 다음 단계를 추가하세요.

ReasonReact를 설치합니다.

npm install reason-react

bsconfig.json 파일에 다음 설정을 추가합니다.

"reason": { "react-jsx": 3 },
"bs-dependencies": ["reason-react"],

컴파일 된 코드 사용하기

리스크립트는 읽기 쉬운 JS로 컴파일되고 이 파일을 바벨이나 웹팩같은 기존 도구모음에 적용하는 것은 어렵지 않습니다.

JS로 내보내기 문서에 컴파일 된 모듈을 JS에서 사용하는 법을 배울 수 있습니다.

JS에서 가져오기 문서에서 기존 JS 코드를 리스크립트로 가져오는 법을 알아볼 수 있습니다.