Visual Studio 코드용 Blockchain App Builder 확장 설치 및 구성

필요 조건

로컬 시스템에 Blockchain App Builder를 설치하기 전에 필수 조건을 설치해야합니다.

주:

Blockchain App Builder는 Oracle Blockchain Platform 및 해당 컴파일러와 조율됩니다. 다음 절에서 언급한 것 이외의 다른 사전 요구 사항 버전을 사용하는 경우 원격 Oracle Blockchain Platform 네트워크에 체인 코드를 배포하지 못할 수 있습니다.

Blockchain App Builder를 설치하면 필수 조건 검사가 먼저 실행됩니다. 필요 조건 검사를 실패하면 설치 프로세스가 중지됩니다.

필요 조건

Rancher Desktop(1.4.1로 테스트됨) Blockchain App Builder는 또한 Docker와 함께 작동 할 수 있지만 Rancher Desktop을 사용하여 테스트 및 검증되었습니다. Rancher Desktop을 사용하려면 Rancher Desktop을 설치하기 전에 Docker를 완전히 제거하십시오. Rancher Desktop을 설치한 후 컨테이너 런타임이 dockerd (moby)로 설정되었는지 확인합니다. Rancher Desktop 1.4.1에서 컨테이너 런타임을 확인하려면 Kubernetes 설정, 컨테이너 런타임을 차례로 누릅니다.
Node.js 버전 18(18.15.0 및 18.16.0으로 테스트됨) 및 npm v8.x 또는 9.x(9.5.0 및 9.5.1로 테스트됨)의 최신 릴리스
node --version 명령을 실행하여 Node.js 버전을 확인합니다.

다음 명령을 실행하여 npm 버전을 확인합니다. npm --version

nvm 또는 nodenv와 같은 관리자를 사용하여 Node.js 및 npm을 설치하는 경우 기본/전역 버전을 설정한 다음 Visual Studio Code를 다시 시작하여 전제 조건 페이지에서 버전이 감지되도록 합니다.

Node.js 이전 버전 또는 18 이후 버전에서는 사용하지 마십시오.
가기 버전 v1.20.10. Blockchain App Builder를 설치한 후 Additional Setup for Go Chaincode Projects을 참조하십시오.
다음 명령을 실행하여 Go 버전을 확인합니다. go version
Blockchain App Builder의 동기화 기능을 사용하려면 다음 명령과 같이 Git을 설치하고 사용자 이름과 이메일을 구성하십시오. <your_name> 및 <email> 위치에 사용자 이름과 전자 메일 주소를 지정합니다.
```
git config --global user.name "<your_name>" 
```
```
git config --global user.email "<email>"
```
Visual Studio Code 버전 1.66.0 이상
다음 명령을 실행하여 Visual Studio Code 버전을 확인합니다. code --version

nvm을 사용하여 Node.js 및 npm 설치

nvm을 사용하여 Node.js 및 npm을 설치하면 sudo 없이 더 많은 명령을 실행할 수 있습니다.

다음 명령을 입력하여 nvm을 설치합니다.

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh | bash

~/.bash_profile, ~/.profile, ~/.bashrc 또는 ~/.zshrc 코드 조각을 해당 파일에 추가합니다.

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"  # This loads nvm
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  # This loads nvm bash_completion

로그아웃했다가 운영 체제에 다시 로그인합니다.
다음 명령을 입력하여 nvm 설치를 확인합니다.
```
nvm version
```
다음 명령을 입력하여 Node.js 및 npm을 설치합니다.
```
nvm install 18.16.0
```
다음 명령을 입력하여 nvm에서 Node.js 18.16.0을 기본값으로 설정합니다.
```
nvm alias default 18.16.0
```
명령 출력은 다음 텍스트입니다.
```
default -> 18.16.0 (-> v18.16.0)
```

필요 조건

Docker v18.09.0 이상
Docker Compose v1.23.0 이상
Node.js 버전 18(18.15.0 및 18.16.0으로 테스트됨) 및 npm v8.x 또는 v9.x(9.5.0 및 9.5.1로 테스트됨)의 최신 릴리스
node --version 명령을 실행하여 Node.js 버전을 확인합니다.

다음 명령을 실행하여 npm 버전을 확인합니다. npm --version

nvm 또는 nodenv와 같은 관리자를 사용하여 Node.js 및 npm을 설치하는 경우 기본/전역 버전을 설정한 다음 Visual Studio Code를 다시 시작하여 전제 조건 페이지에서 버전이 감지되도록 합니다.

Node.js 이전 버전 또는 18 이후 버전에서는 사용하지 마십시오.
가기 버전 v1.20.10. Blockchain App Builder를 설치한 후 Additional Setup for Go Chaincode Projects을 참조하십시오.
다음 명령을 실행하여 Go 버전을 확인합니다. go version
Blockchain App Builder의 동기화 기능을 사용하려면 다음 명령과 같이 Git을 설치하고 사용자 이름과 이메일을 구성하십시오. <your_name> 및 <email> 위치에 사용자 이름과 전자 메일 주소를 지정합니다.
```
git config --global user.name "<your_name>" 
```
```
git config --global user.email "<email>"
```
Visual Studio Code 버전 1.66.0 이상
다음 명령을 실행하여 Visual Studio Code 버전을 확인합니다. code --version

nvm을 사용하여 Node.js 및 npm 설치

nvm을 사용하여 Node.js 및 npm을 설치하면 sudo 없이 더 많은 명령을 실행할 수 있습니다.

다음 명령을 입력하여 nvm을 설치합니다.

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh | bash

~/.bash_profile, ~/.profile, ~/.bashrc 또는 ~/.zshrc 코드 조각을 해당 파일에 추가합니다.

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"  # This loads nvm
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  # This loads nvm bash_completion

로그아웃했다가 운영 체제에 다시 로그인합니다.
다음 명령을 입력하여 nvm 설치를 확인합니다.
```
nvm version
```
다음 명령을 입력하여 Node.js 및 npm을 설치합니다.
```
nvm install 18.16.0
```
다음 명령을 입력하여 nvm에서 Node.js 18.16.0을 기본값으로 설정합니다.
```
nvm alias default 18.16.0
```
명령 출력은 다음 텍스트입니다.
```
default -> 18.16.0 (-> v18.16.0)
```

필요 조건

Rancher Desktop(1.4.1로 테스트됨) Blockchain App Builder는 또한 Docker와 함께 작동 할 수 있지만 Rancher Desktop을 사용하여 테스트 및 검증되었습니다.
Node.js 버전 18(18.15.0 및 18.16.0으로 테스트됨)의 최신 릴리스입니다. Node.js 이전 버전 또는 18 이후 버전에서는 사용하지 마십시오.
npm v8.x 또는 v9.x(9.5.0 및 9.5.1로 테스트됨)
v1.20.10으로 이동합니다. Blockchain App Builder를 설치한 후 Additional Setup for Go Chaincode Projects을 참조하십시오.
Blockchain App Builder의 동기화 기능을 사용하려면 다음 명령과 같이 Git을 설치하고 사용자 이름과 이메일을 구성하십시오. <your_name> 및 <email> 위치에 사용자 이름과 전자 메일 주소를 지정합니다.
```
git config --global user.name "<your_name>" 
```
```
git config --global user.email "<email>"
```

Rancher Desktop 설치

Microsoft Windows에 Rancher Desktop을 설치하려면 다음 단계를 완료하십시오.

Docker가 로컬 컴퓨터에 설치된 경우 완전히 제거합니다.
Rancher Desktop을 다운로드하여 설치합니다.
설치 마법사가 완료되면 Rancher Desktop을 열기 전에 다음 명령을 실행합니다.
```
wsl --install
wsl --set-default-version 2
wsl --setdefault rancher-desktop
```
Rancher Desktop을 열어 설정 프로세스를 완료합니다.
Rancher Desktop을 설치한 후 컨테이너 런타임이 dockerd (moby)로 설정되었는지 확인합니다. Rancher Desktop 1.4.1에서 컨테이너 런타임을 확인하려면 Kubernetes 설정, 컨테이너 런타임을 차례로 누릅니다.

블록체인 앱 빌더 확장 설치

Oracle Blockchain Platform 콘솔의 Blockchain App Builder 창에 있는 개발자 도구 탭에서 확장을 다운로드합니다. 블록체인 앱 작성기 창의 다운로드 섹션에서 Visual Studio 코드 확장을 선택합니다.
Visual Studio Code에서 확장 패널을 연 다음 추가 작업 메뉴에서 VSIX에서 설치를 선택합니다.
다운로드한 oracle-ochain-extension-x.x.x.vsix 파일을 찾아 Install을 누릅니다. (설치 중인 버전에 맞게 .vsix 파일의 이름을 조정합니다.)
Visual Studio Code를 다시 시작하여 확장 프로그램 설치를 완료합니다.Restart Visual Studio Code to complete installation of the extension.
입력 시 사양 파일을 자동으로 검증하는 사양 파일 검증 기능을 사용하려면 Red Hat에서 YAML 확장명을 설치합니다. 확장 패널을 열고 YAML을 검색하고 YAML 언어 지원 확장을 설치한 다음 Visual Studio 코드를 다시 시작합니다.

설치 후 Visual Studio 코드 왼쪽에 있는 Oracle Blockchain App Builder 아이콘을 사용하여 Blockchain App Builder 패널을 열 수 있습니다.

또한 블록체인 앱 빌더 CLI(명령행 인터페이스)는 별도로 설치하지 않은 경우 Visual Studio Code 확장의 일부로 자동으로 설치됩니다. CLI 명령은 Visual Studio Code 콘솔 창을 포함한 모든 터미널 응용 프로그램에서 실행할 수 있습니다. Blockchain App Builder는 전역적으로 설치되므로 파일 시스템의 모든 위치에서 CLI 명령을 실행할 수 있습니다.

Go Chaincode Projects에 대한 추가 설정

Go 프로젝트를 개발하려면 GOPATH 환경 변수를 설정해야 합니다. 이렇게 하면 Go에서 작업 영역을 찾고 코드를 실행할 수 있습니다.

GOPATH 환경 변수를 설정하기 전에 go/ 폴더가 $HOME 디렉토리에 있는지 확인합니다. 그렇지 않은 경우 다음 명령을 입력하여 홈 디렉토리에 go/ 디렉토리를 만듭니다.

mkdir $HOME/go

~/.bash_profile, ~/.profile, ~/.bashrc 또는 ~/.zshrc 변수를 추가하여 GOPATH 환경 변수를 설정합니다.

export PATH=$PATH:/usr/local/go/bin
export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin

파일을 편집한 후 다음 명령을 실행하여 변경 사항을 즉시 적용합니다.

source ~/.bash_profile

또는 이전 변수를 /etc/bashrc 파일에 추가하여 시스템 차원의 변경 사항을 적용할 수 있습니다.

GOPATH 환경 변수를 설정하기 전에 go/ 폴더가 $HOME 디렉토리에 있는지 확인합니다. 그렇지 않은 경우 다음 명령을 입력하여 홈 디렉토리에 go/ 디렉토리를 만듭니다.

mkdir $HOME/go

~/.bash_profile, ~/.profile, ~/.bashrc 또는 ~/.zshrc 변수를 추가하여 GOPATH 환경 변수를 설정합니다.

export PATH=$PATH:/usr/local/go/bin
export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin

파일을 편집한 후 다음 명령을 실행하여 변경 사항을 즉시 적용합니다.

source ~/.bash_profile

또는 이전 변수를 /etc/bashrc 파일에 추가하여 시스템 차원의 변경 사항을 적용할 수 있습니다.

홈 디렉토리에 go/ 디렉토리를 생성합니다. C:\Users\<username>\go.