블록체인 앱 빌더 Visual Studio Code Extension으로 체인코드 프로젝트 생성

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

배경

Blockchain App Builder는 즉시 사용 가능한 체인코드 프로젝트를 초기화하고 스캐폴딩합니다. 새 체인코드 생성 명령은 간단한 입력을 기반으로 다음과 같은 기능을 사용하여 복잡한 체인코드 프로젝트를 생성할 수 있습니다.
  • 여러 자산(모델) 및 해당 동작(컨트롤러)
  • CRUD(생성/읽기/업데이트/삭제) 및 비CRUD 메소드 자동 생성
  • 인수 자동 검증
  • 인수 마셜링/마셜링 해제
  • 투명 지속성 기능(ORM)
  • 풍부한 쿼리 지원
  • 단기 및 개인 데이터 지원
  • 신원 관리

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

사양 파일 생성

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

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

사양 파일 임포트

기존 사양 파일이 있는 경우 가져올 수 있습니다.
  1. 사양 창에서 추가 작업을 누른 다음 사양 임포트를 선택합니다.
  2. 파일을 찾아서 임포트 사양을 누릅니다.
사양 파일이 임포트되고 사양 창에 표시됩니다. 편집기에서 열려면 이 단추를 누릅니다.

사양 파일 복제

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

사양 파일의 내용에 대한 자세한 내용은 입력 사양 파일을 참조하십시오. 이 정보와 샘플 사양 템플릿을 사용하여 사양 컨텐츠를 작성합니다.

사양 파일 검증

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

체인코드 프로젝트 스캐폴딩

사양 파일을 작성한 후 체인코드 프로젝트를 생성할 수 있습니다.
  1. 체인코드 창에서 새 체인코드 생성을 선택합니다.
  2. 체인코드 세부정보 창에서 다음 단계를 완료합니다.
    • 체인코드 프로젝트의 이름을 입력합니다.
    • TypeScript 또는 Go 중에서 언어를 선택합니다.
    • 체인코드를 생성하는 데 사용하는 사양 파일을 선택하십시오.
    • 로컬 개발 환경에서 프로젝트를 생성할 위치 또는 이동 도메인을 입력합니다.
    생성을 누릅니다.
프로젝트가 생성되면 체인코드 창에 표시됩니다. 체인 코드에 필요한 모든 파일이 프로젝트에 포함됩니다. 생성된 파일에 대한 자세한 개요는 다음을 참조하십시오. 토큰 기반 프로젝트에 대한 자세한 개요는 다음을 참조하십시오.

주:

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

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

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