추가
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