React Foundation

React 설치 가이드

1. Node.js 설치

React를 사용하기 위해선 Node.js가 필수로 설치 되어 있어야 하며, 필요한 Package 설치 및 Build, 배포에 사용된다.
아래 사이트를 방문하여 OS에 맞는 버전으로 설치한다. 설치 후 Console(CMD)에서 커맨드를 입력한다.

Node.js 소개 - http://d2.naver.com/helloworld/4994500

Node.js 설치 - https://nodejs.org/ko/

2. 프로젝트 생성

프로젝트 폴더로 이동해서 Node.js 프로젝트를 생성한다.
$ npm init
package.json 파일이 생성된다.

React 설치 가이드

3. Javascript Moduler Webpack 설치

Javascript 모듈화 도구 - http://d2.naver.com/helloworld/0239818

npm(node pacakge manager)으로 패키지 설치

$ npm install --save-dev webpack

설치가 완료된 후 프로젝트 폴더에 webpack.config.js 파일 생성

module.exports = {
    entry: './src/app.js',
 
    output: {
        path: __dirname + '/build',
        filename: 'bundle.js'
    },
 
    module: {
        loaders: [
            { 
                test: /\.js$/, 
                exclude: /node_modules/, 
                loader: 'babel-loader',
                query: {
                    presets: ['react', 'es2015'],
                    cacheDirectory: true
                }
            }
        ]
    }
}

React 설치 가이드

4. Build Tool Gulp 설치

Gulp - http://programmingsummaries.tistory.com/356

$ npm install --global gulp-cli

$ npm install --save-dev gulp

$ npm install --save-dev gulp-webpack

설치가 완료된 후 프로젝트 폴더에 gulpfile.js 파일 생성

var gulp = require('gulp');
var webpack = require('gulp-webpack');
var webpackConfig = require('./webpack.config.js');
 
gulp.task('build', function() {
  return gulp.src('./src/app.js')
      .pipe(webpack(webpackConfig))
      .pipe(gulp.dest('build/'));
});
 
gulp.task('default', ['build']);

React 설치 가이드

5. React 설치

React 소개 - http://d2.naver.com/news/7030975

React 튜토리얼 - https://facebook.github.io/react/docs/tutorial-ko-KR.html

Javascript와 Babel - http://nodejs.github.io/nodejs-ko/articles/2015/05/11/story-about-js-and-babel/

$ npm install --save-dev react

$ npm install --save-dev react-dom

$ npm install --save-dev babel-preset-react

$ npm install --save-dev babel-preset-es2015

$ npm install --save-dev babel-loader

$ npm install --save-dev babel-core

-- 한줄요약
$ npm install --save-dev react react-dom babel-preset-react babel-preset-es2015 babel-loader babel-core

설치가 완료되면 package.json에 설치된 목록을 확인할 수 있고, node_modules 디렉토리에서도 설치된 패키지를 확인 할 수 있다.

 

React 설치 가이드

6. 테스트 코드 작성

React 테스트 코드를 작성한 다음 Gulp로 Build를 수행하고 테스트 페이지를 확인한다.

React 설치에 대한 테스트 코드이므로, 숙련자의 경우 다음 단계로 넘어가셔도 됩니다.

프로젝트 폴더에 최상위에 index.html 파일과 src/app.js 파일을 생성하고 아래의 코드를 작성한다.

-- src/app.js 파일
var React = require('react');
var ReactDom = require('react-dom');
 
var Main = React.createClass({
    render: function() {
        return (
            <div>Hello World</div>
        )
    }
});
ReactDom.render(<Main />, document.getElementById('app'));

-- index.html 파일
<body>
<div id="app"></div>
<script type="text/javascript" src="build/bundle.js"></script>
</body>

$ gulp

정상적으로 build가 되면 index.html 페이지를 Browser에서 확인(Hello World)한다.

여기 까지가 기본 가이드 이며, 뒤에 내용은 확장된 라이브러리 설치나 빌드 방법등에 대해 다루고 있다.

React 설치 가이드

7. Gulp Watch

파일을 수정하고 gulp 명령어를 통해 빌드를 수행하지만, 매번 번거롭고 하기 때문에 gulp watch를 통해 감지하여

auto build가 되게 해주는 기능.

gulpfile.js 에 아래 내용을 추가한 다음, $ gulp watch 명령어로 확인(파일 수정 - Auto Build)한다.

gulp.task('watch', ['build'], function () {
    gulp.watch('./src/**/*.js', ['build']);
});

React 설치 가이드

8. React Bootstrap 설치

React-bootstrap 소개 - https://react-bootstrap.github.io/

매우 대중화 된(?) 반응형 CSS 프레임워크로 React 버전으로 제공되고 있으며,

아래의 명령어로 설치하거나, 사이트에 설치 가이드를 참고해도 된다.

$ npm install --save-dev react-bootstrap

React 설치 가이드

9. Node 서버 설치

Node서버로 기동하여 웹 어플리케이션을 볼 수 있다.

$ npm install --save-dev http-server concurrently

package.json에 아래의 http-server, ws, start 구문을 기술

$ npm start

브라우저에서 http://localhost:8080 으로 확인해본다.

"scripts": {
    "test": "echo \"Error: no test specified\" && exit 1",
    "http-server": "http-server ./ -p 8080 -o /index.html",
    "ws": "ws -d ./ -p 8080",
    "start": "concurrent \"npm run gulp\" \"npm run demo\" \"npm run http-server\" "
  }

React 설치 가이드

10. React Router 설치

React Route는 UI와 URL을 동기화 하여, 사용자가 URL을 변경하면 컴포넌트가 자동으로 언마운트 및 마운트 되는 역할을 한다. - History 관리

$ npm install --save-dev react-router

React Route에 관한 설명은 React 기초 가이드를 참고한다.

React 설치 가이드

11. React Hot Loader

webpack-dev-server와 react-hot-loader를 이용하여 코딩 후 바로 변경되는 Hot Module Reload를 사용할 수 있다.

$ npm install --save--dev react-hot-loader webpack-dev-server

webpack.config.js 파일에 서버환경 설정 추가

devServer: {
    hot: true,
    inline: true,
    host: '0.0.0.0',
    port: 4000,
    contentBase: __dirname + '/public/',
},

plugins: [
    new webpack.HotModuleReplacementPlugin()
]

package.json 파일에 webpack-dev-server 기동 스크립트 추가

"scripts": {
    "hot-server": "webpack-dev-server"
  }

커맨드창에 기동 명령어 입력 후 http://localhost:4000 으로 확인

$ npm run hot-server

React Foundation - Install Guide

By jungyoungtai

React Foundation - Install Guide

React Foundation 문서

  • 861