Electron을 활용해 빠르게 프로토타입을 구축

AI 비즈니스 컨설턴트로서, VS Code 환경에서 Electron을 활용해 빠르게 프로토타입을 구축하고 실제 설치 파일(.exe)까지 추출하는 실무 프로세스를 3단계로 정리해 드립니다.


1. 초기 환경 구축 (Setting Up)

가장 먼저 VS Code 터미널(Ctrl + `)을 열고 프로젝트 폴더에서 아래 명령어를 순서대로 입력하세요.

  1. 프로젝트 초기화: package.json 파일을 생성합니다.Bashnpm init -y
  2. Electron 설치: 개발 도구로 사용할 일렉트론을 설치합니다.Bashnpm install electron --save-dev

2. 프로토타입 핵심 코드 작성

프로토타입 가동을 위해 최소 2개의 파일이 필요합니다.

main.js (창을 띄우는 두뇌 역할)

프로젝트 루트 폴더에 새 파일을 만들고 아래 코드를 복사해 넣으세요.

JavaScript

const { app, BrowserWindow } = require('electron');

function createWindow() {
  const win = new BrowserWindow({
    width: 1200,
    height: 800,
    webPreferences: {
      nodeIntegration: true
    }
  });

  // 만들어둔 웹 페이지(index.html)를 불러옵니다.
  win.loadFile('index.html'); 
}

app.whenReady().then(createWindow);

package.json 수정 (실행 명령 설정)

scripts 부분을 찾아 아래처럼 수정합니다. 이제 npm start만 치면 앱이 실행됩니다.

JSON

"main": "main.js",
"scripts": {
  "start": "electron ."
}

3. 설치 파일(.exe)로 변환하기

프로토타입이 완성되었다면, 이제 고객이나 사용자가 깔아서 쓸 수 있는 파일로 포장해야 합니다. Electron Builder라는 도구를 추천합니다.

  1. 빌더 설치:Bashnpm install electron-builder --save-dev
  2. 빌드 설정: package.json 파일 맨 아래에 다음 내용을 추가합니다.JSON"build": { "appId": "com.yourname.app", "win": { "target": "nsis", "icon": "icon.ico" } }
  3. 최종 추출: 아래 명령어를 입력하면 dist라는 폴더가 생기며 그 안에 설치용 .exe 파일이 생성됩니다.Bashnpx electron-builder

💡 컨설턴트의 핵심 팁

  • 실시간 반영: 개발 중에 코드를 고칠 때마다 앱을 껐다 켜기 귀찮다면 npm install electron-reloader --save-dev를 설치해 사용하세요. 코드를 저장하자마자 앱 화면이 바로 갱신됩니다.
  • 아이콘 주의: .exe 파일에 들어갈 아이콘은 반드시 256×256 픽셀 이상의 .ico 파일이어야 에러가 나지 않습니다.

개발서버 명령어 npm run dev

Gemini said

개발 서버를 실행하는 명령어는 사용 중인 프레임워크나 런타임 환경에 따라 다릅니다. 컨설팅 현장에서 가장 많이 접하게 되는 주요 스택별 명령어는 다음과 같습니다.


1. JavaScript / TypeScript 계열

가장 보편적인 웹 개발 환경입니다. package.json 파일 내에 정의된 스크립트를 실행합니다.

  • Node.js (NPM): npm run dev 또는 npm start
  • React / Vue / Next.js: 보통 npm run dev를 사용하며, 기본적으로 Hot Module Replacement(HMR) 기능이 작동하여 코드 수정 시 즉시 화면에 반영됩니다.
  • Yarn: yarn dev

2. Python 계열

데이터 사이언스나 AI API 서버 구축 시 자주 사용됩니다.

  • Django: python manage.py runserver
  • Flask: flask run
  • FastAPI:uvicorn main:app --reload
    • --reload 옵션은 코드가 바뀔 때마다 서버를 자동으로 재시작해주는 핵심 옵션입니다.

3. Java 계열

엔터프라이즈 급 백엔드 시스템에서 주로 활용됩니다.

  • Spring Boot: ./gradlew bootRun (Gradle 기준) 또는 ./mvnw spring-boot:run (Maven 기준)

터미널 명령어정리

아래는 터미널(리눅스·macOS·윈도우 PowerShell 공통 개념) 에서 가장 많이 쓰이는 디렉토리·파일 관리 명령어 핵심 요약이다.
실무에서 쓰는 흐름 기준으로 단계적으로 정리했다.


① 현재 위치 확인

명령어의미
pwd지금 내가 있는 경로 출력
whoami현재 로그인 사용자

② 폴더(디렉토리) 보기

명령어설명
ls현재 폴더 안 파일·폴더 목록
ls -l상세 정보 (권한, 크기, 날짜)
ls -a숨김파일 포함
ls -la실무에서 가장 많이 쓰는 조합

③ 디렉토리 이동

명령어의미
cd 폴더명해당 폴더로 이동
cd ..상위 폴더로 이동
cd /최상위 루트 이동
cd ~사용자 홈으로 이동
cd -직전에 있던 폴더로 이동

④ 디렉토리 만들기

명령어설명
mkdir testtest 폴더 생성
mkdir a b c여러 폴더 생성
mkdir -p project/src/img중간 폴더까지 한번에 생성

⑤ 파일 만들기

명령어의미
touch file.txt빈 파일 생성
echo hello > a.txt내용과 함께 생성
cat > b.txt직접 내용 입력 후 Ctrl+D

⑥ 파일 / 폴더 복사

명령어의미
cp a.txt b.txt파일 복사
cp a.txt folder/폴더로 복사
cp -r dir1 dir2폴더 전체 복사

⑦ 파일 / 폴더 이동(이름 변경 포함)

명령어의미
mv a.txt folder/파일 이동
mv old.txt new.txt이름 변경
mv dir1 dir2폴더 이름 변경

⑧ 삭제

명령어의미
rm a.txt파일 삭제
rm -r folder폴더 삭제
rm -rf folder강제 삭제 (되돌릴 수 없음)

⑨ 파일 내용 보기

명령어의미
cat file.txt전체 출력
less file.txt스크롤 보기
head file.txt처음 10줄
tail file.txt마지막 10줄
tail -f log.txt실시간 로그

⑩ 경로 자동 완성 핵심

기능
Tab파일·폴더 자동 완성
Ctrl + C실행 중지
Ctrl + L화면 클리어
↑ ↓이전 명령어

⑪ 실무 기본 작업 흐름 예시

pwd
mkdir project
cd project
mkdir src img
touch index.html
ls -la

→ 프로젝트 폴더 만들고 내부 구조 생성


⑫ 절대경로 vs 상대경로

/home/user/project   ← 절대경로
./project           ← 현재 위치 기준
../project          ← 한 단계 위 기준