# StreamDeck 플러그인 자동 배포 가이드

## 📦 자동 배포 스크립트

플러그인을 수정한 후 StreamDeck에 자동으로 배포하는 스크립트입니다.

### 🚀 사용 방법

#### 방법 1: 배치 파일 실행 (가장 쉬움)
1. `deploy-plugin.bat` 파일을 **더블클릭**
2. 자동으로 배포 완료!

#### 방법 2: PowerShell 스크립트 직접 실행
1. PowerShell을 관리자 권한으로 실행
2. 다음 명령어 입력:
   ```powershell
   cd "C:\Users\qscft\OneDrive\문서\Streamingle_URP\Streamdeck"
   .\deploy-plugin.ps1
   ```

### 🔄 스크립트가 하는 일

1. **관리자 권한 자동 획득**
   - UAC 프롬프트가 뜨면 "예" 클릭만 하면 됩니다

2. **StreamDock 종료**
   - 실행 중인 StreamDock 프로세스를 안전하게 종료합니다

3. **기존 플러그인 백업**
   - 기존 플러그인을 날짜/시간 포함된 이름으로 백업합니다
   - 예: `com.mirabox.streamingle.sdPlugin.backup_20241027_143025`

4. **새 플러그인 복사**
   - 현재 폴더의 플러그인을 StreamDock 플러그인 폴더로 복사합니다
   - 경로: `%APPDATA%\Hotspot\StreamDock\plugins\`

5. **StreamDock 재시작**
   - StreamDock을 자동으로 다시 실행합니다

6. **2초 후 자동 종료**
   - CMD 창이 자동으로 닫힙니다 (에러 발생 시에만 일시정지)

### 📍 경로 정보

- **소스 플러그인**: `.\com.mirabox.streamingle.sdPlugin`
- **대상 플러그인**: `%APPDATA%\Hotspot\StreamDock\plugins\com.mirabox.streamingle.sdPlugin`
- **StreamDock 실행 파일**: `C:\Program Files\Hotspot\StreamDock\StreamDock.exe`

### ⚠️ 주의사항

1. **관리자 권한 필요**
   - StreamDock 프로세스 종료를 위해 관리자 권한이 필요합니다
   - 배치 파일이 자동으로 권한 상승을 요청합니다

2. **StreamDock 경로가 다른 경우**
   - 스크립트가 자동으로 대체 경로를 찾습니다
   - 찾지 못하면 수동으로 경로를 지정해야 합니다

3. **플러그인 수정 후**
   - 파일을 저장한 후 배포 스크립트를 실행하세요
   - StreamDeck이 자동으로 플러그인을 다시 로드합니다

4. **기존 버튼 삭제 필요**
   - 플러그인 구조를 크게 변경한 경우 기존 버튼을 삭제하고 다시 추가해야 할 수 있습니다
   - 특히 action UUID나 설정 구조가 변경된 경우

### 🐛 문제 해결

#### "실행 정책" 오류가 발생하는 경우
PowerShell에서 다음 명령어를 실행:
```powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
```

#### StreamDock이 재시작되지 않는 경우
수동으로 StreamDock을 실행하세요:
- 시작 메뉴에서 "StreamDock" 검색 후 실행
- 또는 실행 파일 직접 실행

#### 플러그인이 보이지 않는 경우
1. StreamDock 완전 종료 후 재시작
2. 플러그인 폴더 확인: `%APPDATA%\Hotspot\StreamDock\plugins\`
3. manifest.json 파일이 올바른지 확인

### 🔧 개발 워크플로우

1. Unity 씬 수정
2. 플러그인 코드 수정 (`plugin/index.js`, `manifest.json` 등)
3. `deploy-plugin.bat` 실행
4. StreamDeck에서 새 기능 테스트
5. 반복!

### 📝 백업 관리

백업 폴더가 쌓이면 수동으로 삭제하세요:
```
%APPDATA%\Hotspot\StreamDock\plugins\com.mirabox.streamingle.sdPlugin.backup_*
```

### 💡 팁

- **빠른 테스트**: `deploy-plugin.bat`를 바탕화면에 바로가기 만들기
- **자동 배포**: 파일 저장 시 자동으로 배포하는 스크립트도 만들 수 있습니다
- **디버깅**: PowerShell 스크립트에서 각 단계별 로그를 확인할 수 있습니다

---

## 🎉 이제 개발이 훨씬 편해졌습니다!

수정 → 배포 → 테스트 사이클이 단 몇 초로 단축됩니다.