- 같은 테스트 환경을 위해 VueJS를
^2
버전으로 설치하도록 문서를 수정했습니다.- 강의 영상의 VueJS 버전은
2.6.10
버전입니다.
- 강의 영상의 VueJS 버전은
- 모든 모듈의 버전은 Package.json 파일을 참고해주세요.
- 강의 영상의 NodeJS 버전은
10.15.0
이며, 그 이상의 LTS 버전(짝수 버전)을 사용하시길 권장합니다. - 강의 영상의 NPM 버전은
6.5.0
이며, 역시 그 이상의 버전을 사용하시길 권장합니다. - 버그 및 수정/건의 사항 등은 Issues 혹은 [email protected]으로 문의 부탁드립니다.
웹팩(Webpack)을 이용해 개발 환경을 구성합니다.
Vue CLI를 사용하지 않음으로 Vue 기반 프로젝트가 기본적으로 어떻게 동작하는지 이해합니다.
각 코드에 주석이 작성되어 있으니, 완성된 코드도 꼭 참고하세요.
Vue.js를 사용해 스타일 없이 기본적인 Todo App를 만듭니다.
패키지의 배포 시 포함될 의존성 모듈을 지정합니다.
$ npm install --save MODULE_NAME
# or
$ npm i MODULE_NAME
패키지의 개발 시 사용될 의존성 모듈을 지정합니다.(배포 시 포함되지 않습니다)
$ npm install --save-dev MODULE_NAME
# or
$ npm i -D MODULE_NAME
다음은 'Chapter 1'의 '한 번에 설치하기' 입니다!
$ npm i vue@^2 @babel/polyfill
$ npm i -D webpack webpack-cli webpack-dev-server webpack-merge @babel/core @babel/preset-env babel-loader vue-template-compiler vue-loader vue-style-loader css-loader node-sass sass-loader@^7 eslint@^5 babel-eslint eslint-config-standard@^12 eslint-plugin-import eslint-plugin-node eslint-plugin-promise eslint-plugin-standard eslint-plugin-vue html-webpack-plugin copy-webpack-plugin clean-webpack-plugin postcss-loader autoprefixer
webpack은 웹팩(Webpack)의 핵심 패키지이며,
webpack-cli는 터미널에서 웹팩 명령(Commands)를 실행할 수 있게 해주는 도구입니다.
$ npm i -D webpack webpack-cli
개발용으로 실시간 Reload 서버를 실행하기 위해 webpack-dev-server를 설치합니다.
$ npm i -D webpack-dev-server
webpack-merge는 웹팩 Config 객체를 병합(merge)하기 위해 설치합니다.
웹팩을 개발용(dev
)과 배포용(build
)으로 구분해 실행할 수 있습니다.
$ npm i -D webpack-merge
webpack.config.js
파일을 생성합니다.
자세한 설정 내용은 완성된 파일(webpack.config.js)을 참고하세요.
터미널에서
webpack --mode production
명령이 동작하지 않아요!
우선 첫 번째 방법부터 시도해 보세요.
아래 내용으로 해결되지 않으면, 다른 문제가 있을 수 있습니다.
package.json
파일의 "scripts"
항목에 다음과 같이 내용을 추가하세요.
"scripts"
항목에 추가된 스크립트는 실행될 때 이미 설치된 패키지를 참조합니다.
{
"scripts": {
"build": "webpack --mode production"
}
}
그리고 터미널에서 다음과 같이 입력하세요.
$ npm run build
터미널에서 다음과 같이 npx
로 시작해서 명령을 입력하세요.
npx
은 해당 명령을 패키지 설치 없이도 실행할 수 있는 명령입니다.
NPX는 [email protected] 버전부터 사용할 수 있습니다.
$ npx webpack --mode production
webpack
명령이 어디서나 동작할 수 있도록 다음과 같이 -g
플래그를 사용해 전역으로 설치합니다.
## 전역 설치
$ npm install -g webpack webpack-cli
## 동작
$ webpack --mode production
바벨(Babel)은 ES6 이상의 코드를 ES5 이하 버전으로 변환하기 위해 사용합니다.
- @babel/core: 바벨이 실제 동작하는 모듈입니다.
- @babel/preset-env: 바벨의 지원 스펙을 지정합니다.
- babel-loader: 웹팩(Webpack) 지원을 위해 사용합니다.
$ npm i -D @babel/core @babel/preset-env babel-loader
.babelrc
파일을 생성하고 다음 옵션을 추가합니다.
{
"presets": ["@babel/preset-env"]
}
구형 및 일부 브라우저에서 지원하지 않는 기능들을 지원할 수 있도록 @babel/polyfill을 의존성 모듈로 설치합니다.(-D
(--save-dev
)가 없어야 합니다!)
@babel/ployfill
$ npm i @babel/polyfill
설치 후 webpack.config.js
에 다음과 같이 설정합니다.
// ...
require('@babel/polyfill')
const config = {
// ...
entry: {
app: [
'@babel/polyfill',
path.join(__dirname, 'main.js')
]
}
// ...
}
vue를 설치합니다.(-D
(--save-dev
)가 없어야 합니다!)
$ npm i vue@^2
웹팩에서 .vue
파일을 해석할 수 있도록 다음 모듈들을 설치합니다.
$ npm i -D vue-template-compiler vue-loader vue-style-loader css-loader
만약 CSS Preprocessor Sass(SCSS)를 사용하려면 다음 모듈을 추가로 설치합니다.
sass-loader는 8버전의 호환성 모듈(Peer Dependency) 이슈로 7버전을 설치합니다.
$ npm i -D node-sass sass-loader@^7
.vue
파일 내에서 다음과 같이 사용할 수 있습니다.
<style lang="scss"></style>
<!-- or -->
<style lang="sass"></style>
'ESLint'는 코드 품질과 코딩 스타일 문제를 식별하기 위한 정적 코드 분석 도구입니다.
eslint는 6버전의 호환성 모듈(Peer Dependency) 이슈로 5버전을 설치합니다.
npm i -D eslint@^5 babel-eslint eslint-config-standard@^12 eslint-plugin-import eslint-plugin-node eslint-plugin-promise eslint-plugin-standard eslint-plugin-vue
.eslintrc.js
파일을 생성하고 다음 옵션을 추가합니다.
코드 규칙을 검사하기 위한 옵션을 제공합니다.
module.exports = {
root: true,
parserOptions: {
parser: 'babel-eslint',
ecmaVersion: 2015,
sourceType: 'module'
},
env: {
browser: true,
node: true
},
extends: [
// https://github.com/standard/eslint-config-standard
'standard',
// https://eslint.vuejs.org/rules/
// 'plugin:vue/base'
'plugin:vue/essential'
// 'plugin:vue/strongly-recommended'
// 'plugin:vue/recommended'
],
plugins: [
'vue'
],
rules: {
// 예외 규칙을 추가할 수 있습니다
'vue/html-self-closing': ['error', {
'html': {
'void': 'always',
'normal': 'always',
'component': 'always'
},
'svg': 'always',
'math': 'always'
}]
}
}
.eslintignore
파일을 생성하고 다음 내용을 추가합니다.
코드 규칙을 검사할 때 무시할 파일이나 디렉터리를 지정합니다.
node_modules/
dist/
assets/
일부 'ESLint' 규칙을 비활성화해야 하는 경우 'rules' 옵션 대신 다음과 같이 작성할 수 있습니다.
자세한 사용법은 Disabling Rules with Inline Comments에서 확인할 수 있습니다.
// eslint-disable-next-line
if (true) console.log("ESLint");
최초 실행될 index.html
을 사용하기 위해 html-webpack-plugin을 설치합니다.
$ npm i -D html-webpack-plugin
파비콘(Favicon)을 배포용으로 복사하기 위해 copy-webpack-plugin을 설치합니다.
$ npm i -D copy-webpack-plugin
clean-webpack-plugin를 사용해 빌드(build)시 발생할 수 있는 충돌을 최소화하기 위해 output.path
에 설정된 디렉터리 내 기존 모든 파일 삭제합니다.
$ npm i -D clean-webpack-plugin
CSS에 자동으로 공급 업체 접두사(Vendor prefix)를 적용하기 위해 autoprefixer를 설치합니다.
$ npm i -D postcss-loader autoprefixer
postcss.config.js
파일을 생성하고 다음과 같이 autoprefixer 모듈을 플러그인으로 지정합니다.
module.exports = {
plugins: [
require('autoprefixer')
]
}
package.json
파일에 다음 옵션을 추가해 대상 브라우저를 설정합니다.
설정에 대한 자세한 내용은 Browserslist에서 확인할 수 있습니다.
{
"browserslist": [
"last 2 versions",
"ie >= 10"
]
}
npm run dev
: 개발용 서버를 실행합니다.npm run build
: 배포용 파일을 빌드할 수 있습니다.npm run lint
: 코드 규칙을 검사합니다.npm run lint:fix
: 코드 규칙을 검사하고 수정합니다.
{
"scripts": {
"dev": "webpack-dev-server --mode development",
"build": "webpack --mode production",
"lint": "eslint --ext .js,.vue .",
"lint:fix": "eslint --fix --ext .js,.vue ."
}
}
버전 관리 시 필요하지 않은 파일이나 디렉터리를 지정할 수 있습니다.
# 기본 디렉터리 혹은 파일
.DS_Store
node_modules
/dist
# 로컬 환경변수 파일
.env.local
.env.*.local
# 로그 파일
npm-debug.log*
yarn-debug.log*
yarn-error.log*
# 에디터 디렉터리 혹은 파일들
.idea
.vscode
*.suo
*.ntvs*
*.njsproj
*.sln
*.sw?
개발에 필요한 각 모듈의 간단한 사용법을 정리합니다.
https://github.com/typicode/lowdb
JSON 형식으로 데이터를 저장하는 심플한 DB(데이터베이스)입니다.
사용자 환경의 LocalStorage를 DB로 구성하기 위해 사용합니다.
기본적으로 제공되는 몇 가지 API를 제외하면, 대부분 Lodash API를 사용할 수 있습니다.
import low from 'lowdb'
import LocalStorage from 'lowdb/adapters/LocalStorage'
const adapter = new LocalStorage(DB_NAME)
const db = low(adapter)
// Lodash API를 사용하기 때문에(Lodash chain), A, B, C는 모두 같은 결과를 가집니다.
const A = db.get('todos').value()
const B = _.get(this.db.value(), 'todos')
const C = db.getState().todos // `getState()` is Lowdb API
// Lodash `get` - https://lodash.com/docs/4.17.15#get
// Lodash `value` - https://lodash.com/docs/4.17.15#prototype-value
https://github.com/sindresorhus/crypto-random-string
todo
객체에서 ID로 사용할 고유한 랜덤 문자열을 생성합니다.
import cryptoRandomString from 'crypto-random-string'
cryptoRandomString({ length: 10 })
// E.g. '2cf05d94db'
다양한 유틸리티 기능을 제공 하는 자바스크립트 라이브러리입니다.
필요하지 않은 기능을 추후 번들에 포함하지 않기 위해서 다음과 같이 개별적으로 가져와 사용합니다.
import _find from 'lodash/find'
import _findIndex from 'lodash/findIndex'
import _assign from 'lodash/assign'
import _cloneDeep from 'lodash/cloneDeep'
import _forEachRight from 'lodash/forEachRight'
https://github.com/iamkun/dayjs
날짜 및 시간을 분석, 유효성 검사, 표시 등의 기능을 제공하는 경량화된 자바스크립트 라이브러리입니다.
Momentjs를 사용하는 경우 사용 방법은 매우 쉽습니다.
dayjs().format('YYYY년 MM월 DD일')
스타일을 적용하고, 그에 따라 일부 구조를 변경합니다.
브라우저의 기본 스타일을 초기화합니다.
<link href="https://cdnjs.cloudflare.com/ajax/libs/meyer-reset/2.0/reset.min.css" rel="stylesheet">
Google Material Design에서 제공하는 무료 아이콘을 사용합니다.
Google Material Icons(머티리얼 아이콘)은 일반적인 동작과 아이템을 위한 유쾌하고 아름답게 제작된 심볼입니다.
Apache license version 2.0.
<link href="https://fonts.googleapis.com/icon?family=Material+Icons" rel="stylesheet">
<i class="material-icons">done</i>
<i class="material-icons">close</i>
사용할 폰트를 정의합니다.
<link href="https://fonts.googleapis.com/css?family=Noto+Sans+KR:400,700&display=swap&subset=korean" rel="stylesheet">
scss/_style.scss
을 생성하고 완성된 스타일 내용을 사용해 다음과 같이 TodoApp.vue
에 적용합니다.
<!-- TodoApp.vue -->
<template>...</template>
<script>...</script>
<style lang="scss">
@import "../scss/style";
</style>
SPA 라우터 구성을 위해 Vue Router를 사용합니다.
$ npm i vue-router
상태 관리 패턴(Store)을 사용하기 위해 Vuex를 설치합니다.
$ npm i vuex
웹 사이트 호스팅을 위해 Netlify를 사용합니다.
회원가입 후 무료로 사용할 수 있습니다.