플러그인 배포하기

커밋된 시드

시드가 있는 이유는 리포에 오프라인이면서 스키마가 올바른 RegistryIndex 픽스처를 두기 위함입니다. Rust 드리프트 가드 테스트(test_committed_registry_seed_deserializes)가 테스트를 돌릴 때마다 그것을 역직렬화하고, 모양이 살아 있는 레지스트리와 달라지면 실패합니다 — trust가 없는 것도 포함해서입니다. 티어가 없는 항목은 앱이 설치를 거부하는 플러그인을 기술하는 것이기 때문입니다.

지금은 시드에서 설치가 되지 않고, 그 이유는 시드가 아닙니다. 시드는 다음 릴리스 (baram-word-count 2.1.0)를 가리키면서 checksum을 0 예순네 개로 두고 있어서, 그 릴리스가 나올 때까지 설치 시도는 없는 ZIP에서 실패합니다. 이미 배포된 옛 ZIP도 도움이 되지 않습니다 — §260의 티어 모델은 모든 매니페스트가 trust를 선언하도록 요구하는데, 그 전에 배포된 것들 (baram-word-count 1.0.0/1.0.1, baram-ai-summary 1.0.0)은 그 필드가 생기기 전의 매니페스트를 갖고 있어서, 색인이 무엇이라 말하든 validateManifest가 내려받기를 거부합니다. 그 릴리스가 나올 때까지는 시드로 마켓플레이스 UI를 시험하고(목록, 권한·티어 배지, 레거시 상태, 새로고침), 플러그인이 실제로 도는 것은 소스에서 개발 모드로 불러와(설정 → 플러그인 → 개발자) 시험하십시오.

시드가 아닌 것 두 가지를 더 적어 둡니다.

살아 있는 색인의 바이트 단위 사본이 아닙니다. Prettier로 서식이 잡혀 있고(살아 있는 파일은 update-registry-index.mjs가 씁니다), 배포할 만한 항목만 담습니다 — baram-ai-summary는 배포되지 않았으므로 없습니다.
자리표시자 체크섬은 자동으로 채워지지 않습니다. 릴리스 워크플로는 sayinel/baram-plugins를 클론해 그 리포의 index.json만 갱신하고, 여기로 되쓰는 것은 없습니다. 버전을 배포한 뒤 관리자가 워크플로의 sha256sum 출력을 이 파일에 손으로 옮깁니다. 잊는 것은 이제 보고되지만 막히지는 않습니다 — validate-index.ts가 npm run lint마다 전부 0인 체크섬을 경고하면서도, ZIP이 아직 없는 릴리스를 가리키는 시드는 허용합니다. 16진수 64자 모양 검사만으로는 이것을 결코 볼 수 없습니다 — 0도 그 모양을 만족하기 때문입니다.

내 플러그인 배포하기

플러그인용 GitHub 저장소를 만듭니다.
플러그인을 빌드합니다 — npm run build.
baram-plugin.json, 빌드된 main 번들(예: dist/index.mjs), 그리고 assets/(있다면)를 담은 ZIP을 만듭니다.
그 ZIP을 자산으로 붙인 GitHub 릴리스를 만들고 SHA-256 체크섬을 계산합니다 (예: shasum -a 256 your-plugin-1.0.0.zip).
배포하려는 RegistryIndex에 RegistryEntry를 추가합니다. ⚠️ 오늘은 그것이 1군 레지스트리만을 뜻합니다 — Baram이 고정된 URL을 가져오고 직접 호스팅한 index.json을 가리킬 수 없으므로 (Baram이 레지스트리를 불러오는 방식 참조), 자기 색인에 넣은 항목은 아무 사용자에게도 닿지 않습니다. 커뮤니티 제출이 열리기 전까지 누군가에게 플러그인을 건넬 유일한 방법은 설정 → 플러그인의 개발자 구역이고, 그것은 개발 빌드 전용이므로 릴리스 빌드 사용자는 아예 불러올 수 없습니다. (이 리포의 1군 플러그인은 항목을 손으로 넣지 않습니다 — plugin-<dir>-v<version> 태그를 밀면 위에 적은 대로 sayinel/baram-plugins의 index.json이 자동으로 갱신됩니다.)

{
  "id": "my-word-count",
  "name": "Word Count",
  "description": "Displays word and character count",
  "version": "1.0.0",
  "author": "Your Name",
  "license": "MIT",
  "downloadUrl": "https://github.com/user/my-word-count/releases/download/v1.0.0/my-word-count-1.0.0.zip",
  "checksum": "sha256-hash-of-zip",
  "capabilities": ["editor:readonly", "events", "statusbar"],
  "trust": "sandboxed",
  "keywords": ["word", "count"],
  "engines": { "baram": ">=0.5.0" }
}