Streamingle_URP/Streamdeck/DEPLOY_README.md

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

📦 자동 배포 스크립트

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

🚀 사용 방법

방법 1: 배치 파일 실행 (가장 쉬움)

1. deploy-plugin.bat 파일을 더블클릭
2. 자동으로 배포 완료!

방법 2: PowerShell 스크립트 직접 실행

1. PowerShell을 관리자 권한으로 실행
2. 다음 명령어 입력:

   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에서 다음 명령어를 실행:

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 스크립트에서 각 단계별 로그를 확인할 수 있습니다

---

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

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