111 lines
3.9 KiB (Stored with Git LFS)
Markdown
111 lines
3.9 KiB (Stored with Git LFS)
Markdown
# 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 스크립트에서 각 단계별 로그를 확인할 수 있습니다
|
|
|
|
---
|
|
|
|
## 🎉 이제 개발이 훨씬 편해졌습니다!
|
|
|
|
수정 → 배포 → 테스트 사이클이 단 몇 초로 단축됩니다.
|