특정 버전이 필요하거나 빠른 설치가 성공적으로 완료되지 않는 경우 각 의존성을 개별적으로 설치하세요. 새 환경에서는 섹션을 순서대로 따라 진행하고, 그렇지 않은 경우에는 설치하거나 문제를 해결해야 하는 도구로 바로 이동하세요.
사전 요구사항
Rust 설치하기
개발자들은 Rust 프로그래밍 언어를 사용하여 Solana 프로그램을 구축합니다.
- 터미널에 다음 명령어를 입력하여 rustup을 사용해 Rust를 설치하세요:
$curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
설치가 성공적으로 완료되면 다음과 같은 메시지가 표시됩니다:
- Cargo의 bin 디렉토리를 포함하도록 PATH 환경 변수를 다시 로드하세요:
$. "$HOME/.cargo/env"
- 설치가 성공적으로 완료되었는지 확인하세요.
$rustc --version
이 명령은 설치된 Rust 버전을 출력합니다. 예:
rustc x.y.z (...)
Solana CLI 설치하기
Solana CLI는 Solana 프로그램을 빌드하고 배포하는 데 필요한 모든 도구를 제공합니다.
- 공식 설치 명령어를 사용하여 Solana CLI 도구 모음을 설치하세요:
$sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"
stable를 특정 Agave 릴리스 태그 또는 beta나 edge 릴리스 채널로
바꿀 수 있습니다.
- 현재 터미널에서 Solana CLI를 사용할 수 있도록 설정하세요.
설치 프로그램이 셸 구성을 업데이트하고 현재 세션을 갱신하는 데 필요한 명령어를 출력합니다. 일반적으로 다음 명령어입니다:
$export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"
solana를 여전히 사용할 수 없다면 터미널을 재시작하세요. 설치 프로그램이 어떤 셸
구성 파일을 업데이트했는지 확인하려면 현재 셸을 확인하세요:
$echo $SHELL
- 출력에
/bash가 포함되어 있으면 터미널을 재시작하거나source ~/.bashrc를 실행하세요. - 출력에
/zsh가 포함되어 있으면 터미널을 재시작하거나source ~/.zshrc를 실행하세요.
- 설치가 성공했는지 확인하세요:
$solana --version
이 명령은 설치된 Solana CLI 버전을 출력합니다. 예:
solana-cli x.y.z (..., client:Agave)
사용 가능한 모든 버전은 Agave GitHub 저장소에서 확인할 수 있습니다. Agave는 Anza의 validator 클라이언트이며, 이전에는 Solana Labs validator 클라이언트로 알려져 있었습니다.
- 나중에 Solana CLI를 업데이트하려면 다음을 실행하세요:
$agave-install update
Anchor CLI 설치하기
Anchor는 Solana 프로그램을 개발하기 위한 프레임워크입니다. Anchor 프레임워크는 Rust 매크로를 활용하여 Solana 프로그램 작성 과정을 단순화합니다.
사전 요구사항
Node.js와 JavaScript 패키지 관리자는 Mocha나 Jest와 같은 TypeScript 테스트 템플릿을 선택하는 경우에만 필요합니다. 기본 LiteSVM 테스트 템플릿은 Rust에서 실행되며 Node.js 도구가 필요하지 않습니다.
설치
Anchor CLI와 도구를 설치하는 두 가지 방법이 있습니다:
- Anchor 버전 관리자(AVM) — 권장 설치 방법
- AVM 없이 — GitHub에서 직접 설치
Anchor 버전 관리자(AVM)를 사용하면 시스템에 다양한 Anchor 버전을 설치하고 관리할 수 있으며, 향후 Anchor 버전을 쉽게 업데이트할 수 있습니다. AVM을 사용하여 Anchor를 설치하려면 아래 단계를 따르세요:
- 다음 명령어로 AVM을 설치하세요:
$curl -sSfL https://raw.githubusercontent.com/otter-sec/anchor/master/avm/install | sh
- AVM이 성공적으로 설치되었는지 확인하세요:
$avm --version
- AVM을 사용하여 Anchor CLI를 설치하세요:
최신 버전을 설치하려면:
$avm install latest$avm use latest
특정 버전을 설치하려면 버전 번호를 지정하세요:
$avm install 1.1.2$avm use 1.1.2
Linux 또는 WSL에서 Anchor CLI를 설치할 때 다음 오류가 발생할 수 있습니다:
error: could not exec the linker cc = note: Permission denied (os error 13)
이 오류 메시지가 표시되면 다음 단계를 따르세요:
- 이 페이지 상단의 Linux 섹션에 나열된 종속성을 설치하세요.
- Anchor CLI 설치를 다시 시도하세요.
- 다음과 같이 Anchor CLI 버전을 확인하여 설치가 성공했는지 확인하세요:
$anchor --version
이 명령은 현재 활성화된 Anchor CLI 버전을 출력합니다. 예:
anchor-cli 1.1.2
avm use를 실행하여 시스템에서 사용할 Anchor CLI 버전을 선택하세요.
- 최신 버전을 설치한 경우
avm use latest를 실행하세요. 1.1.2버전을 설치한 경우avm use 1.1.2를 실행하세요.
Surfpool CLI 설치하기
Surfpool은 로컬 개발을 위한 도구이며
solana-test-validator를 개선한 대체 도구입니다.
- 다음 명령어로 Surfpool을 설치하세요:
$curl --proto '=https' --tlsv1.2 -sSfL https://run.surfpool.run/ | bash
- Surfpool CLI 버전을 확인하여 설치가 성공적으로 완료되었는지 확인하세요:
$surfpool --version
이 명령은 설치된 Surfpool CLI 버전을 출력합니다. 예:
surfpool x.y.z
Is this page helpful?