Shopify 앱 개발을 위한 전체 준비 가이드 (초보자용)
Shopify 앱을 개발하려면 몇 가지 중요한 준비 작업과 필수 도구 설치가 필요합니다. 순서대로 따라 하면 개발 환경을 완벽하게 세팅할 수 있습니다.
1단계: Shopify Partner 계정 등록
이유: 왜 필요한가요?
Shopify 앱을 만들기 위해서는 일반 스토어 계정이 아닌, Shopify Partner 계정이 필요합니다.
이 계정을 통해서만 다음 작업이 가능합니다:
- 개발용 스토어(Development Store) 생성
- 커스텀 앱 및 퍼블릭 앱 등록
- 앱을 Shopify 관리화면에서 테스트
- Shopify App Store에 앱 배포
가입 방법:
- 아래 사이트로 이동합니다:
https://partners.shopify.com - “Join now” 버튼 클릭
- Shopify 계정으로 로그인 또는 새로 생성
- 파트너 정보 입력 후 완료
2단계: 개발용 스토어(Development Store) 만들기
이유: 왜 필요한가요?
Shopify 앱을 테스트하고 실제 환경처럼 개발하기 위해서는 실제 운영 중인 상점이 아니라, 무료로 제공되는 개발용 스토어가 필요합니다.
이 개발용 스토어에서는 다음과 같은 작업이 가능합니다:
- 앱 테스트 및 미리보기
- 고객/제품/주문 데이터 생성
- 결제 시뮬레이션
- 앱 설치 및 제거 테스트
생성 방법:
- Shopify Partner 대시보드에 로그인
- 왼쪽 메뉴에서 “Stores > Add store” 클릭
- Store type은 “Development store” 선택
- 스토어 이름, 주소 등 입력 후 생성
3단계: 필수 도구 설치
3-1. Node.js 설치
Node.js는 무엇인가요?
Node.js는 자바스크립트로 만든 앱을 컴퓨터에서 실행할 수 있게 해주는 프로그램입니다.
Shopify CLI는 자바스크립트로 작성되어 있기 때문에, Node.js가 없으면 실행할 수 없습니다.
다운로드 링크:
https://nodejs.org/en
설치 후 확인 (명령어 입력):
node -v
npm -v
node는 Node.js 본체이고, npm은 관련 패키지를 설치해주는 도구입니다.
3-2. Git 설치
Git은 무엇인가요?
Git은 버전 관리 도구로, 소스코드를 관리하고 협업할 때 필수입니다.
Shopify CLI는 앱 템플릿을 다운로드할 때 Git을 사용하므로 반드시 설치되어야 합니다.
다운로드 링크:
https://git-scm.com/downloads
설치 후 확인:
git --version
4단계: Shopify CLI 설치
Shopify CLI는 무엇인가요?
Shopify CLI는 앱 개발을 위해 Shopify에서 공식 제공하는 명령어 도구입니다.
이걸 사용하면 앱을 생성하고, 테스트하고, 배포까지 빠르게 진행할 수 있습니다.
설치 명령어:
[Windows (CMD 또는 PowerShell)]
npm install -g @shopify/cli
[Mac (Terminal)]
sudo npm install -g @shopify/cli
설치 완료 후 확인:
shopify version
버전이 출력되면 정상 설치된 것입니다.
5단계: Shopify CLI 로그인
설치가 완료되면 Shopify Partner 계정으로 CLI에서 로그인해야 합니다.
명령어 (공통):
shopify login
- 명령어 실행 시 브라우저가 열리며 로그인 화면이 나옵니다.
- 로그인하면 터미널에 “Logged in as …” 메시지가 나옵니다.
6단계: 앱 개발을 위한 프로젝트 생성
CLI 명령어는 반드시 앱을 만들고 싶은 폴더에서 실행해야 합니다.
예를 들어, 바탕화면에서 앱 폴더를 만들고 그 안에서 실행하려면 다음처럼 진행하세요.
[Windows]
cd Desktop
mkdir banzai-app
cd banzai-app
shopify app create remix
[Mac]
cd ~/Desktop
mkdir banzai-app
cd banzai-app
shopify app create remix
remix외에도node,php템플릿을 선택할 수 있지만, 최신 트렌드는remix입니다.
7단계: 개발용 스토어에 앱 설치
앱을 개발한 후, 아래 명령어로 개발용 스토어에 설치할 수 있습니다.
shopify app dev
- 앱 미리보기 서버가 열리고, Shopify Admin에 자동 연결됩니다.
- 개발용 스토어에 설치 여부를 묻는 창이 나타납니다.
요약: 실제 작업 순서
| 순서 | 항목 | 설명 |
|---|---|---|
| 1 | Shopify Partner 계정 생성 | 앱 개발을 위한 필수 조건 |
| 2 | 개발용 스토어 생성 | 앱 테스트 환경 구축 |
| 3 | Node.js, Git 설치 | CLI 실행 환경 준비 (설치 필수 도구 설명 포함) |
| 4 | Shopify CLI 설치 | 앱 생성 도구 설치 |
| 5 | CLI에서 로그인 | Partner 계정 연동 |
| 6 | 앱 프로젝트 생성 | 로컬 폴더에서 실행 |
| 7 | 개발용 스토어에 설치 | 앱 테스트 시작 |
| 8 | 기능 개발 & 배포 | 본격적인 개발 진행 |
