준비사항: NodeJS 환경, 그리고 NPM 또는 Yarn
리스크립트를 전역으로 설치하려면 다음처럼 합니다.
npm install -g bs-platform
새 프로젝트
git clone https://github.com/rescript-lang/rescript-project-templatecd rescript-project-templatenpm installnpm run buildnode 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 코드를 리스크립트로 가져오는 법을 알아볼 수 있습니다.