본문으로 건너뛰기

추가

셸
npx blockstudio add <blocks...> [options]

레지스트리에서 블록을 다운로드해 프로젝트의 블록 디렉터리에 기록합니다.

인수

인수 설명
blocks 추가할 블록 하나 이상입니다. 형식: namespace/block 또는 block만 입력합니다.

옵션

옵션 설명
-y, --yes 덮어쓰기 및 충돌 해결을 포함한 모든 확인 절차를 건너뜁니다.
--dry-run 파일을 쓰지 않고 설치될 항목을 미리 봅니다.

네임스페이스 확인

네임스페이스를 지정하면 CLI은 해당 레지스트리에서 검색합니다:

셸
npx blockstudio add ui/tabs

네임스페이스를 생략하면 CLI은 구성된 모든 레지스트리에서 검색합니다:

셸
npx blockstudio add tabs

블록이 정확히 하나의 레지스트리에서 발견되면 자동으로 해당 블록을 사용합니다. 여러 곳에서 발견되면 CLI은 선택을 위한 대화형 프롬프트를 표시합니다.

--yes을 사용하면 blocks.json 순서에서 처음 일치하는 레지스트리를 사용합니다. 터미널이 없고 --dry-run를 사용하면 이름이 모호할 때 레지스트리 목록을 표시하며 오류와 함께 명령을 중단합니다:

코드
Block "hero" found in multiple registries: acme, starter. Specify one: blockstudio add acme/hero

블록을 확인하기 전에 add은 구성된 모든 레지스트리를 가져옵니다. 레지스트리 중 하나라도 연결할 수 없거나 유효하지 않으면 명시적 네임스페이스가 지정된 블록이라도 명령이 실패합니다.

종속 항목

블록은 같은 레지스트리에 있는 다른 블록에 대한 종속성을 선언할 수 있습니다. 블록을 추가하면 종속성을 확인해 자동으로 설치합니다.

셸
npx blockstudio add ui/tabs

tabs이 tab-item에 종속되어 있다면 두 블록을 모두 다운로드하고 설치합니다. 종속 블록은 항상 해당 블록에 의존하는 블록보다 먼저 설치됩니다.

순환 종속성이 감지되면 오류와 함께 거부됩니다.

덮어쓰기 동작

대상 디렉터리에 블록 폴더가 이미 있는 경우:

  • 대화형 모드: 덮어쓸지 확인하는 메시지가 표시됩니다
  • --yes 플래그: 확인 없이 덮어씁니다
  • --dry-run 플래그: 덮어쓸 항목을 표시합니다
  • --yes 없이 실행하는 비대화형 모드: 다운로드 전에 중단하고 Block "<name>" already exists at <path>. Use --yes to overwrite.을 표시합니다

이 검사는 종속성에도 적용되므로 tab-item이 이미 설치된 상태에서 tabs을 추가하려면 --yes가 필요합니다.

여러 블록

한 명령에 전달된 블록은 순서대로 처리됩니다. 블록 하나가 실패하면 명령은 그 지점에서 중단되며, 같은 실행에서 앞서 설치된 블록은 디스크에 그대로 남습니다.

예시

블록 하나 추가:

셸
npx blockstudio add ui/hero

블록 여러 개 추가:

셸
npx blockstudio add ui/tabs ui/hero ui/accordion

파일을 쓰지 않고 미리보기:

셸
npx blockstudio add ui/tabs --dry-run

모든 확인 절차 건너뛰기:

셸
npx blockstudio add ui/tabs --yes