설치하기
바나나 프레임워크에 오신 것을 환영합니다!🎉
이번 챕터에서는 바나나 프레임워크를 설치하는 두 가지 방법에 대해 소개합니다.
선행 설치 사항
바나나 프레임워크는 LTSLong Term Support 및 최신 버전의 Node.js에서 동작하며, Git을 필요로 합니다! 아직 Node.js 및 Git을 설치하지 않았다면 아래 가이드를 참고해주세요.
Node.js
바나나 프레임워크는 v20.18.0(^20.18.0) 및 v22.3.0(>= 22.3.0) 이상의 Node.js에서 동작합니다. (v21등 최신이 아닌 홀수 버전은 공식 지원하지 않습니다.)
아직 Node.js를 설치하지 않았다면, Node.js 공식 홈페이지에서 가능한 최신 LTS 버전을 설치해주세요.
주목해주세요!
바나나 프레임워크는 짝수 번호로 시작하는 LTS 버전 및 최신 버전(홀수 버전 포함)의 Node.js에 대해서만 테스트를 진행합니다! 안정적인 환경에서의 사용을 위해 최신 LTS 버전을 사용하는 것을 권장합니다.
설치 후, 아래 명령어를 터미널에 입력하여 Node.js가 정상 설치되었는지 확인해주세요.
입력
sh$ node -v올바른 출력 예시
shv20.18.0
Git
아직 Git을 설치하지 않았다면, Git 공식 홈페이지에서 가능한 최신 버전을 설치해주세요.
설치 후, 아래 명령어를 터미널에 입력하여 Git이 정상 설치되었는지 확인해주세요.
입력
sh$ git -v올바른 출력 예시
shgit version 2.46.0
설치가 모두 완료되었나요? 그럼 이제 바나나 프레임워크를 설치해봅시다!
create-bananass로 시작하기
가장 빠르게 바나나 프레임워크를 만나는 방법은 create-bananass 명령어를 이용하는 것입니다!
React의 create-react-app, Next.js의 create-next-app처럼 create-bananass를 통해 지금 바로 바나나 프레임워크를 시작할 수 있습니다. 이 명령어는 바나나 프레임워크를 위한 프로젝트 템플릿을 생성합니다. 아래 명령어 중 하나를 통해 create-bananass를 실행해주세요.
$ npx create-bananass@latest
# 또는
$ npm create bananass@latest
# 또는
$ npm init bananass@latest주의하세요!
create-bananass는 아직 yarn 및 pnpm 등 npm 이외의 패키지 매니저를 지원하지 않습니다. 반드시 npm을 사용해주세요.
추가로, yarn 및 pnpm 등의 패키지 매니저를 이용하실 계획이 있으시다면, 하단의 직접 설치해서 시작하기를 참고해주세요.
더 알아보기: create-bananass 명령어는 어떤 과정을 거쳐 프로젝트를 생성하나요?
create-bananass 명령어는 아래와 같은 일을 수행합니다.
- 사용자의 입력을 받아 프로젝트 템플릿을 결정합니다.
- 자바스크립트 또는 타입스크립트 템플릿을 복사하여 프로젝트 디렉토리를 생성합니다.
- Visual Studio Code를 위한 확장 프로그램을 설치합니다.
git init명령어를 실행하여 Git 저장소를 초기화합니다.npm install명령어를 실행하여 의존성을 설치합니다.
템플릿 복사를 제외한 모든 과정은 선택적이며, CLI(터미널, 콘솔)에 옵션 인자를 전달하여 생략할 수 있습니다. 자세한 내용은 create-bananass CLI 문서를 참고해주세요.