Installation (Korean)

English · 한국어

---

설치

요구사항

• Windows의 Obsidian Desktop + Bluetooth LE 지원 (저울 기능 사용 시)
• Acaia Pearl S 저울
• 모바일에도 설치할 수 있지만 기록 관리 기능만 동작합니다 — 홈 참고

macOS/Linux 지원은 @stoprocent/noble의 플랫폼 호환성에 따라 다르며, 아직 테스트되지 않았습니다.

릴리즈 zip으로 설치

1. 최신 릴리즈에서 cubicj-brewing.zip 다운로드
2. 압축을 해제하면 다음 파일이 있어야 합니다:

   main.js
   manifest.json
   styles.css
   noble/
   

3. 모든 내용을 <볼트 경로>/.obsidian/plugins/cubicj-brewing/에 복사
4. Obsidian 재시작 → 설정 → 커뮤니티 플러그인 → CubicJ Brewing 활성화

noble/ 폴더는 네이티브 BLE 애드온입니다. 없어도 플러그인은 로드되지만 저울 연결이 불가능해집니다 — 빠뜨리지 마세요.

소스에서 빌드

git clone https://github.com/cubicj/CubicJ-Brewing.git
cd CubicJ-Brewing
npm install
npm run build

npm run build는 테스트, 타입체크, 프로덕션 esbuild 번들을 순서대로 실행합니다. main.js, manifest.json, styles.css를 플러그인 폴더에 복사하고, @stoprocent/noble 네이티브 의존성이 담긴 noble/ 폴더도 함께 넣어야 합니다.

개발 스크립트

npm run dev          # 워치 모드, 리포 내부만
npm run build        # 테스트 → 타입체크 → 프로덕션 빌드
npm run test         # vitest (단일 실행)
npm run test:watch   # vitest (워치 모드)
npm run check        # 타입체크만
npm run lint         # eslint

업데이트

플러그인 폴더 내용을 새 릴리즈 zip 내용으로 교체하고 Obsidian을 재시작하면 됩니다. 데이터는 플러그인 폴더가 아닌 볼트에 저장되므로 업데이트해도 기록은 그대로 유지됩니다 — 시작하기 참고.