환경 구성

Setting Up the Development Environment

💡 핵심 용어 미리보기

• Sui CLI: Move 패키지 빌드, 테스트, 배포를 담당하는 기본 명령줄 도구
• VS Code Extension: GUI 기반 Move 개발 및 PTB 실행 도구
• Workspace: VS Code Extension에서 관리하는 프로젝트 단위
• Explorer 뷰: VS Code에서 프로젝트 탐색 및 생성 메뉴 제공

1. Sui CLI 설치

macOS / Linux / WSL

brew install sui

Windows

choco install sui

설치 확인:

sui --version

⚠️ Sui CLI는 Move 코드의 빌드와 실행에 반드시 필요합니다. CLI를 먼저 설치해야 이후 단계가 정상적으로 동작합니다.

2. VS Code - Sui Extension 설치

Sui Extension은 VS Code에서 Move 스마트 컨트랙트를 컴파일, 배포, 테스트하고, Programmable Transaction Blocks를 시각적으로 구성하고 실행할 수 있는 확장 도구입니다.

주요 기능

• 컴파일 및 배포
• 업그레이드 지원 (upgrade.toml)
• 오브젝트 탐색기 / 패키지 탐색기
• PTB Builder 내장 (드래그 앤 드롭 지원)

설치 방법

1. VS Code 열기 → Extensions (⇧⌘X / Ctrl+Shift+X)
2. Sui Extension 검색 후 설치
3. 설치 후 VS Code 재시작

⚠️ 필수 조건: Sui CLI가 먼저 설치되어 있어야 합니다.

3. Sui Extension 인터페이스

VS Code 왼쪽의 Activity Bar에서 Sui Extension 아이콘을 클릭하면, 기존 탐색기 영역(Primary Side Bar)이 Sui Extension 전용 인터페이스로 전환됩니다.

• Workspace: 새 Move 프로젝트 생성, 빌드, 테스트, 배포
• Owned Objects Explorer: 특정 Account가 소유한 오브젝트의 상태 확인
• Object Explorer: 특정 오브젝트의 상태 조회
• Package Explorer: 배포된 패키지를 로드해, 모듈별 실행 가능한 함수 목록을 표시하고 직접 실행 가능

4. Sui Extension의 Workspace 개념

Sui Extension은 각 Move 프로젝트를 Workspace로 관리합니다. Workspace는 Move 패키지, 설정 파일(Move.toml), 빌드 결과를 하나의 단위로 묶습니다.

구성 요소	설명
Move.toml	패키지 이름, 의존성, 주소 정의
sources/	Move 모듈(.move) 파일 폴더
build/	컴파일된 결과물 저장 경로

💡 한 Workspace 안에 여러 패키지를 구성할 수 있으며, Extension에서 손쉽게 전환 가능합니다.

💡 다음 장에서는 Sui CLI와 Extension을 함께 사용해 Move 프로젝트를 직접 빌드하고 테스트하는 방법을 배웁니다.