infrablockchain-docs
ko
ko
  • 인프라블록체인
    • 배우기
      • 아키텍처
        • 아키텍처
        • 네트워크 참여자
        • 파라체인
          • 시스템 파라체인
      • 프로토콜
        • 시스템 토큰
        • 트랜잭션 수수료
        • Proof of Transaction
      • Substrate
        • 배우기
          • 기초 지식
            • 암호학
            • 블록체인 기본 개념
            • 합의
            • 네트워크와 노드
            • 트랜잭션과 블록 기본 사항
            • 트랜잭션 수명주기
            • 오프체인 작업
            • 라이트 클라이언트
            • Substrate를 위한 Rust
            • 라이브러리 소개
            • 아키텍처와 Rust 라이브러리
            • 파일 구조
            • 계정, 주소 및 키
            • 트랜잭션 형식
            • 난수 생성
          • 프레임
            • FRAME 팔레트
            • FRAME 매크로
            • 커스텀 팔레트
            • 팔레트 커플링
            • Origin
            • 이벤트와 에러
            • 런타임 스토리지 구조
            • 상태 전이와 스토리지
            • SCALE 인코딩
            • 트랜잭션, Weight 및 수수료
            • 런타임 API
            • 런타임 업그레이드
            • 런타임 개발
          • 계정 데이터 구조
          • 주소 형식
          • 용어집
          • cli
            • 아카이브
            • 메모리 프로파일러
            • 노드 템플릿
            • 사이드카
            • srtool
            • 서브키
            • subxt
            • try-runtime
            • tx-wrapper
          • 런타임 개발
            • 기본
              • Genesis 상태 구성하기
              • 런타임 상수 구성
              • 체인 스펙을 커스텀하기
              • 팔레트 가져오기
              • 도우미 함수 사용하기
            • 합의 모델
              • 작업 증명을 사용하는 체인 구성
              • 하이브리드 노드 생성하기
            • 오프체인 워커
              • 오프체인 HTTP 요청하기
              • 오프체인 인덱싱
              • 오프체인 로컬 스토리지
            • 팔레트 설계
              • 크라우드펀딩 구성하기
              • 스토리지 구조체 (struct) 생성하기
              • 잠금 가능한 통화 구현
              • 무작위성 적용하기
              • 느슨한 팔레트 결합 사용하기
              • 타이트한 팔레트 결합 사용하기
            • 파라체인 개발
              • HRMP 채널 추가하기
              • 로컬 파라체인 노드 추가하기
              • 릴레이 체인에 연결하기
              • 솔로 체인을 변환하기
              • 론칭 준비
              • 콜레이터 선택
              • 파라체인 업그레이드
            • 스토리지 마이그레이션
              • 기본 저장소 마이그레이션
              • 스토리지 마이그레이션 트리거
            • 테스트
              • 기본 테스트 설정하기
              • 전송 함수 테스트하기
            • 도구
              • 체인을 위한 txwrapper 생성
              • REST 엔드포인트를 사용하여 체인 데이터 가져오기
              • try-runtime 사용하기
              • Wasm 바이너리 검증하기
            • 가중치
              • 벤치마크 추가
              • 수수료 계산하기
              • 조건부 가중치 사용
              • 사용자 정의 가중치 사용하기
        • 빌드하기
          • 제작할 것을 결정하세요
          • 빌드 프로세스
          • 결정론적 런타임 빌드
          • 체인 스펙
          • Genesis 구성
          • 애플리케이션 개발
          • RPC
          • 문제 해결
        • 튜토리얼
          • 설치하기
            • 개발자 도구
            • 리눅스 개발 환경
            • macOS 개발 환경
            • Rust 툴체인
            • Rust 문제 해결 방법
            • Windows 개발 환경
          • 빠른 시작
            • 코드 탐색하기
            • 런타임 수정하기
            • 노드 시작하기
            • Substrate 한눈에 보기
          • 블록체인 구축
            • 신뢰할 수 있는 노드 추가
            • 특정 노드 승인
            • 로컬 블록체인 구축하기
            • 네트워크 시뮬레이션
            • 실행 중인 네트워크 업그레이드
          • 애플리케이션 로직 구축
            • 런타임에 팔레트 추가하기
            • 오프체인 워커 추가
            • 사용자 정의 팔레트 게시
            • 함수 호출의 출처 지정하기
            • 사용자 정의 팔레트에서 매크로 사용하기
          • 유용한 도구들
            • EVM 계정에 접근하기
            • 이더리움 통합
            • 사이드카 엔드포인트 탐색하기
            • 경량 클라이언트 노드 통합
          • 스마트 컨트랙트
            • 스마트 컨트랙트
            • 토큰 계약 작성하기
            • 스마트 컨트랙트 개발하기
            • 첫 번째 계약 준비하기
            • 스마트 컨트랙트 문제 해결
            • 값 저장을 위한 맵 사용
      • XCM
        • XCM
        • XCM 형식
    • 서비스 체인
      • 인프라DID
      • 인프라EVM
      • URAuth(Universal Resource Auth)
    • 데브 옵스
      • 체인 빌드
      • 배포
      • 모니터링
    • 튜토리얼
      • 기초
        • 시스템 토큰 관리 프로세스
        • 시스템 토큰을 트랜잭션 수수료로 사용해보기
        • 트랜잭션에 투표 포함 시키기
        • 밸리데이터 보상 받기
      • 구축하기
        • 인프라릴레이체인 구축하기
        • 파라체인 구축하기
        • 메시지 전달 채널 열기
        • XCM을 이용하여 토큰 전송하기
        • Asynchronous Backing 적용하기
      • 테스트
        • 벤치마크
        • 런타임 확인
        • 디버그
        • 테스트 네트워크에서 파라체인 시뮬레이션하기
        • 단위 테스트
      • 서비스체인
        • 인프라DID
          • 구축하기
          • 공개키 추가하기
          • 서비스 엔드포인트 등록하기
          • DID 생성하기
        • 인프라EVM
          • 구축하기
          • EVM에 자금 입금 및 인출하기
          • ERC20 토큰 컨트랙트 배포하기
          • ERC721 토큰 컨트랙트 배포하기
          • ERC1155 토큰 컨트랙트 배포하기
  • 뉴날 데이터 마켓
Powered by GitBook
On this page
  • 현재 구성 확인하기
  • WebAssembly을 위해 nightly 릴리스 채널 사용하기
  • 툴체인 업데이트하기
  • 특정 nightly 툴체인 사용하기
  • PATH가 올바르게 설정되었는지 확인하기
  • M1 macOS 사용자를 위한 cmake 또는 protobuf 설치
  1. 인프라블록체인
  2. 배우기
  3. Substrate
  4. 튜토리얼
  5. 설치하기

Rust 문제 해결 방법

Rust 및 Substrate 개발 환경 문제를 진단하고 해결합니다.

PreviousRust 툴체인NextWindows 개발 환경

Last updated 1 year ago

만약 을 컴파일하는데 실패한다면, 문제는 개발 환경에서 Rust가 어떻게 구성되어 있는지에 확인 해 봐야 합니다. 이 섹션에서는 구성 문제를 진단하고 해결하는 방법을 제안합니다.

현재 구성 확인하기

현재 사용 중인 Rust 툴체인에 대한 정보를 확인하려면 다음 명령을 실행하세요:

rustup show

이 명령은 다음과 같은 출력을 표시합니다(Ubuntu 예시):

Default host: x86_64-unknown-linux-gnu
rustup home:  /home/user/.rustup

installed toolchains
--------------------

stable-x86_64-unknown-linux-gnu (default)
nightly-2020-10-06-x86_64-unknown-linux-gnu
nightly-x86_64-unknown-linux-gnu

installed targets for active toolchain
--------------------------------------

wasm32-unknown-unknown
x86_64-unknown-linux-gnu

active toolchain
----------------

stable-x86_64-unknown-linux-gnu (default)
rustc 1.50.0 (cb75ad5db 2021-02-10)

이 예시에서는 기본 툴체인이 x86_64 아키텍처에서 실행되는 Linux용 stable 릴리스 채널에서 가져온 것입니다. 샘플 출력은 또한 nightly-x86_64-unknown-linux-gnu 툴체인이 설치되어 있으며, 두 개의 타겟이 설치되어 있는 것을 나타냅니다:

  • x86_64-unknown-linux-gnu: Linux용 네이티브 Rust 타겟.

  • wasm32-unknown-unknown: WebAssembly 타겟.

WebAssembly을 위해 nightly 릴리스 채널 사용하기

툴체인 업데이트하기

일반적으로, Rust stable 및 nightly 빌드의 최신 버전을 항상 사용해야 합니다. Substrate의 변경 사항은 종종 Rust nightly 컴파일러 빌드의 최신 버전에 의존하기 때문입니다. Rust 컴파일러가 항상 최신 상태인지 확인하기 위해 다음 명령을 실행해야 합니다:

rustup update
rustup update nightly
rustup target add wasm32-unknown-unknown --toolchain nightly

특정 nightly 툴체인 사용하기

사용할 특정 nightly 툴체인 버전을 식별한 후, 다음과 유사한 명령을 실행하여 개발 환경에 설치할 수 있습니다:

rustup install nightly-<yyyy-MM-dd>

예를 들어:

rustup install nightly-2022-02-16

특정 버전의 nightly 툴체인을 설치한 후, 다음과 유사한 명령을 실행하여 WebAssembly 타겟을 사용하도록 구성할 수 있습니다:

rustup target add wasm32-unknown-unknown --toolchain nightly-<yyyy-MM-dd>

예를 들어:

rustup target add wasm32-unknown-unknown --toolchain nightly-2022-02-16

환경 변수로 툴체인 지정하기

WASM_BUILD_TOOLCHAIN 환경 변수를 설정하여 WebAssembly 컴파일을 위해 사용할 nightly 툴체인의 버전을 지정할 수 있습니다. 예를 들어:

WASM_BUILD_TOOLCHAIN=nightly-<yyyy-MM-dd> cargo build --release

이 명령은 지정된 nightly 툴체인을 사용하여 _런타임_을 빌드합니다. 프로젝트의 나머지 부분은 기본 툴체인, 즉 설치된 최신 stable 툴체인을 사용하여 컴파일됩니다.

nightly 툴체인 다운그레이드하기

컴퓨터가 최신 Rust nightly 툴체인을 사용하도록 구성되어 있고 특정 nightly 버전으로 다운그레이드하려면, 먼저 최신 nightly 툴체인을 제거해야 합니다. 예를 들어, 최신 nightly 툴체인을 제거한 후 특정 버전의 nightly 툴체인을 사용하려면 다음과 유사한 명령을 실행하세요:

rustup uninstall nightly
rustup install nightly-<yyyy-MM-dd>
rustup target add wasm32-unknown-unknown --toolchain nightly-<yyyy-MM-dd>

PATH가 올바르게 설정되었는지 확인하기

Rust를 설치한 후에 명령이 작동하지 않고 command not found: rustup과 같은 오류가 표시된다면, PATH가 올바르게 구성되었는지 확인하세요.

현재 rustup 설치 프로그램은 기본적으로 bash 프로필(mac의 경우)에 설치합니다. 다른 쉘을 사용하는 경우 프로필(예: .zshrc)에 다음 줄을 추가해야 합니다:

source "$HOME/.cargo/env"

M1 macOS 사용자를 위한 cmake 또는 protobuf 설치

현재, M1 칩을 사용하는 macOS 컴퓨터에 미리 설치된 패키지를 사용하여 Substrate 노드를 컴파일하는 데 문제가 있습니다.

error: failed to run custom build command for prost-build v0.10.4

이 오류가 발생하는 경우 두 가지 해결 방법이 있습니다.

  • 다음 명령을 실행하여 cmake를 설치하세요:

brew install cmake
  • 다음 명령 세트를 실행하여 올바른 미리 컴파일된 protoc를 설치하세요:

git clone https://github.com/protocolbuffers/protobuf.git
cd protobuf

brew install autoconf
brew install automake
brew install Libtool

autoreconf -i
./autogen.sh
./configure
make
make check
sudo make install

export PATH=/opt/usr/local/bin:$PATH

이 환경에는 nightly-2020-10-06-x86_64-unknown-linux-gnu 툴체인도 설치되어 있지만, 이 툴체인은 명시적으로 명령줄 옵션으로 지정하지 않는 한 사용되지 않습니다. 특정 툴체인을 명령줄 옵션으로 지정하는 예시는 을 참조하세요.

Substrate은 블록체인 런타임을 생성하기 위해 (Wasm)을 사용합니다. Rust 컴파일러를 를 사용하도록 구성해야 Substrate 런타임 코드를 Wasm 타겟으로 컴파일할 수 있습니다.

rustup update 명령은 nightly 및 stable 툴체인을 모두 가장 최신 릴리스로 업데이트합니다. nightly 툴체인을 업데이트한 후에도 WebAssembly 타겟을 컴파일할 수 없는 경우, 이전 버전의 툴체인으로 롤백하고 해당 버전을 명령줄 옵션으로 지정할 수 있습니다. nightly 툴체인의 이전 버전을 설치하여 명령줄 옵션으로 사용할 버전을 지정하는 자세한 정보는 를 참조하세요.

Rust와 다른 종속성을 업데이트하면서 빌드가 컴퓨터에서 작동하는지 보장하려면, 사용 중인 Substrate 버전과 호환되는 특정 Rust nightly 툴체인을 사용해야 합니다. 프로젝트에 대해 특정 nightly 툴체인 버전을 식별하고 전달하는 방법은 다양할 수 있습니다. 예를 들어, Polkadot은 에서 이 정보를 게시합니다.

Substrate 노드 템플릿
WebAssembly
nightly 빌드
릴리스 노트
특정 nightly 버전 지정
툴체인 다운그레이드