블록체인 앱 빌더 VS 코드 확장으로 체인코드 프로젝트 생성

블록체인 앱 빌더를 사용할 때 체인코드 프로젝트를 생성하려면 세부 사양 파일에서 체인코드 프로젝트를 스캐폴딩해야 합니다. 그러면 필요한 모든 파일이 포함된 프로젝트가 생성됩니다.

배경

Blockchain App Builder는 즉시 사용할 수있는 체인 코드 프로젝트를 초기화하고 비계합니다. 새 체인코드 생성은 간단한 입력을 기반으로 다음과 같은 기능을 사용하여 복잡한 체인코드 프로젝트를 생성할 수 있습니다.
  • 여러 자산(모델) 및 해당 동작(컨트롤러)
  • CRUD(Create/Read/Update/Delete) 및 비CRUD 메소드 자동 생성
  • 인수 자동 검증
  • 인수 마셜링/언마셜링
  • 투명한 지속성 기능(ORM)
  • Rich Query 호출
  • 임시 및 개인 데이터 지원
  • ID 관리

생성된 프로젝트는 모델/컨트롤러 및 데코레이터 패턴을 따르며, 이를 통해 원장에서 유지 관리되는 자산의 속성을 입력 필드로 지정하고 특정 동작 및 검증 규칙으로 확장할 수 있습니다. 이렇게 하면 가독성과 확장성에 도움이 되는 코드 행 수가 줄어듭니다.

사양 파일 생성

먼저 입력 사양 파일을 작성해야 합니다. Blockchain App Builder의 일부로 설치된 샘플 사양 파일은 변경할 수 없지만 복제하거나 자체 사양 파일에 대한 참조 파일로 사용할 수 있습니다.

  1. 사양 창에서 새 사양 파일 생성을 선택합니다.
  2. 사양 세부정보 창이 열립니다.
    • 사양 파일의 이름을 입력합니다.
    • 파일 유형 선택 - YAML 및 JSON이 지원됩니다.
    • 선택적으로 파일에 대한 설명을 입력합니다.
    • 참조 파일 드롭다운을 사용하면 템플리트로 사용할 파일이 있는 경우 작업 영역의 기존 파일에서 사양 파일을 생성할 수 있습니다. 아무 것도 선택하지 않으면 생성된 파일이 비어 있으므로 처음부터 사양을 입력할 수 있습니다.
    • 사양 파일을 시스템에 저장할 위치를 입력합니다.
    저장을 누릅니다.
새 사양 파일이 생성되고 사양 창에 나타납니다. 이 단추를 눌러 편집기에서 엽니다.

사양 파일 임포트

기존 사양 파일이 있는 경우 다음을 가져올 수 있습니다.
  1. 사양 창에서 추가 작업을 누르고 사양 임포트를 선택합니다.
  2. 파일을 찾아 사양 임포트를 누릅니다.
사양 파일이 임포트되고 사양 창에 나타납니다. 이 단추를 눌러 편집기에서 엽니다.

사양 파일 복제

사양 창에 이미 있는 사양 파일을 마우스 오른쪽 버튼으로 누르고 복제를 선택하여 복제할 수도 있습니다. 파일을 마우스 오른쪽 단추로 누르고 이름 바꾸기를 선택하여 이름을 업데이트합니다.

사양 파일의 콘텐츠에 대한 세부정보는 입력 사양 파일에 설명되어 있습니다. 이 정보와 샘플 사양 템플리트를 사용하여 사양 내용을 생성합니다.

사양 파일 검증

YAML 언어 지원 확장자를 설치한 경우 입력 시 사양 파일이 자동으로 검증됩니다. 다음 검증 기능은 자동으로 지원됩니다.
  • 명령 완료
  • 스키마 기본값에 대한 스칼라 노드 완료
  • 속성 또는 메소드 위로 커서를 가져갈 때 문맥에 따른 도움말
  • 입력할 때 배열 항목에 대한 들여쓰기
  • 구문 오류 감지

체인코드 프로젝트(Chaincode Project)

요구 사항에 맞는 사양 파일이 있는 경우 체인코드 프로젝트를 생성합니다.
  1. Chaincodes(체인 코드) 창에서 Create New Chaincode(새 체인 코드 만들기)를 선택합니다.
  2. Chaincode Details 창이 열립니다.
    • 체인코드 프로젝트의 이름을 입력합니다.
    • TypeScript 또는 Go 언어를 선택합니다.
    • 체인 코드를 생성하는 데 사용할 사양 파일을 선택하십시오.
    • 로컬 개발 환경 내에서 프로젝트를 생성할 위치 또는 이동 도메인을 입력합니다.
    생성을 누릅니다.
프로젝트가 생성되면 체인코드 창에 표시됩니다. 체인 코드에 필요한 모든 파일이 프로젝트에 있습니다. 생성된 파일에 대한 자세한 개요는 다음을 참조하십시오. 토큰 기반 프로젝트에 대한 자세한 개요는 다음을 참조하십시오.

주:

  • 체인코드 창에서는 체인코드 프로젝트 내에서 콘텐츠를 열고 작업할 수 있지만 프로젝트 내에서 파일을 추가, 삭제 또는 이름을 바꿀 수는 없습니다. 이렇게 하려면 프로젝트를 마우스 오른쪽 버튼으로 누르고 탐색기에서 열기를 선택합니다. 그러면 VS Code Explorer 뷰에서 프로젝트가 열립니다.
  • 체인코드 프로젝트에서 파일을 삭제하거나 이름을 바꾸면 프로젝트 파일과 파일을 만드는 데 사용된 사양 파일 간의 링크가 손상될 수 있습니다. 둘 사이에 코드를 동기화하려면 파일 이름을 변경하지 마십시오.

기존 체인코드 프로젝트 임포트

CLI를 통해 체인코드 프로젝트를 생성했거나 VS Code 블록체인 콘텐츠를 정리하고 로컬에 저장된 프로젝트를 임포트하려는 경우 체인코드 창에서 작업 더 보기... 아이콘을 누르고 체인코드 임포트를 선택합니다. 프로젝트를 찾아보고 체인코드 임포트를 누릅니다.