fix: initialize selected runtime for live playout
This commit is contained in:
@@ -11,6 +11,12 @@
|
||||
이 문서는 개발 PC의 Visual Studio 2026에서 `MBN_STOCK_WEBVIEW.LegacyParityApp`을
|
||||
명확한 시작 대상으로 실행하고, 개발 Tornado2에 연결하는 방법을 설명한다.
|
||||
|
||||
솔루션 루트의 `.vsconfig`는 **WinUI 애플리케이션 개발**
|
||||
(`Microsoft.VisualStudio.Workload.Universal`) 워크로드를 요구한다. Visual Studio가 누락
|
||||
구성 요소 설치를 안내하면 먼저 설치를 완료하고 Visual Studio를 다시 시작한다.
|
||||
`GetLatestMSVCVersion`이 `...\VC\Tools\MSVC`를 찾지 못하는 오류는 이 WinUI 워크로드가
|
||||
빠진 설치에서 발생하는 사전 조건 오류이며 앱 코드나 K3D 연결 오류가 아니다.
|
||||
|
||||
지정 개발 PC의 Debug와 Release 전체 앱은 모두 보호된 `Live`로만 기동한다. 개발 Live는
|
||||
다음 조건이 동시에 맞을 때 기존 Live 게이트를 설정한다.
|
||||
|
||||
@@ -24,21 +30,22 @@
|
||||
|
||||
새 clone처럼 아직 검증된 runtime 연결이 없는 경우의 첫 F5는 예외적으로 소스 전용 설정
|
||||
앱을 연다. 이 프로세스는 `--development-live`를 적용하지 않고 DB와 송출을 모두 차단한다.
|
||||
화면에서 기존 코더의 `Cuts`와 `Res` 폴더, 두 개만 선택한다. 설정 버튼은 폴더 안의 파일을
|
||||
열거·파싱·복사하지 않고 두 경로와 로컬 MSBuild binding만 저장한다. PowerShell,
|
||||
`dotnet build`, DB 복사, K3D 검사와 Live 승인 발급도 실행하지 않으므로 즉시 완료되어야
|
||||
한다. 설정을 완료한 뒤 창을 닫고 F5를 한 번 더 누르면 전체 앱 빌드가 시작된다.
|
||||
화면에서 기존 코더의 `Cuts`와 `Res` 폴더, 두 개만 선택한다. 설정 버튼은 선택한
|
||||
`Res\MmoneyCoder.ini`의 DB 형식을 확인하고, 검증된 PowerShell 초기화기를 통해 두 경로,
|
||||
로컬 MSBuild binding, `C:\K3DAsyncEngine` x64 등록/파일, 지속 K3D pin, Development Live
|
||||
승인 및 Debug x64 빌드를 함께 검증한다. 이 작업은 시간이 걸릴 수 있다.
|
||||
|
||||
기존 유효한 Live 승인 파일이 없는 PC는 두 번째 F5에서 전체 앱 기동이 차단된다.
|
||||
DB overlay, K3D pin과 Development Live 승인이 필요하면 아래 수동 초기화 절차를 별도로
|
||||
완료한다. 자세한 절차는
|
||||
설정 중에는 DB 연결, K3D COM 활성화, Tornado2/PGM 연결 또는 송출 명령을 실행하지 않는다.
|
||||
설정을 완료한 뒤 창을 닫고 F5를 한 번 더 누르면 검증된 전체 앱이 시작된다. 기존 로컬
|
||||
설정과 충돌하거나 K3D pin이 달라 자동 설정이 중단되면 대상을 검토한 뒤 아래 수동 교체
|
||||
절차를 사용한다. 자세한 절차는
|
||||
[개발 PGM 인수 절차](DEVELOPMENT_LIVE_HANDOFF.md#2-기존-자산-보유-pc-clone-후-1회-초기화)를
|
||||
따른다.
|
||||
|
||||
`MmoneyCoder.ini`의 DB 자격증명은 테스트 개발 서버용이라도 Git에 넣지 않는다. 첫 실행
|
||||
경로 저장은 이 파일을 복사하거나 읽지 않는다. 빌드 출력, 선택 경로 설정과 MSIX에도
|
||||
포함하지 않는다. 보호된 LocalAppData DB overlay와 Live 설정이 필요할 때만
|
||||
`Initialize-ExistingDevelopmentPc.ps1`을 수동으로 사용한다.
|
||||
설정은 파일을 복사하지 않고 형식만 검증한다. 빌드 출력, 선택 경로 설정과 MSIX에도
|
||||
포함하지 않는다. 전체 앱은 저장된 `Res`의 정확한 `MmoneyCoder.ini`를 매 실행 직접 읽으며,
|
||||
누락·손상된 파일을 LocalAppData나 환경 변수로 대체하지 않고 Live 기동을 차단한다.
|
||||
|
||||
## Visual Studio 시작 대상과 프로필
|
||||
|
||||
@@ -71,9 +78,9 @@ Studio의 시작 드롭다운에는 다음 프로필 하나만 표시된다.
|
||||
|
||||
### 지속 K3D pin
|
||||
|
||||
수동 Development Live 초기화는 K3D의 HKLM x64 등록, CLSID·ProgID·TypeLib, AMD64와 vendor 배치를 먼저
|
||||
검증한다. 검사를 통과한 최초 native/Interop DLL의 SHA-256은 다음 사용자 전용 파일에
|
||||
지속 저장한다.
|
||||
첫 실행 자동 설정과 수동 Development Live 초기화는 모두 `C:\K3DAsyncEngine`의 HKLM x64
|
||||
등록, CLSID·ProgID·TypeLib, AMD64와 회사 표준 vendor 배치를 먼저 검증한다. 검사를 통과한
|
||||
최초 native/Interop DLL의 SHA-256은 다음 사용자 전용 파일에 지속 저장한다.
|
||||
|
||||
```text
|
||||
%LOCALAPPDATA%\MBN_STOCK_WEBVIEW\Config\k3d-pins.local.json
|
||||
@@ -123,9 +130,10 @@ Studio의 시작 드롭다운에는 다음 프로필 하나만 표시된다.
|
||||
`authorization-unavailable` 결과로 처리하며 경로와 값은 로그에 표시하지 않는다.
|
||||
|
||||
수동 생성·교체 시에는 현재 설치 파일의 해시를 그 자리에서 계산했다는 이유만으로 승인 값으로
|
||||
사용해서는 안 된다. 벤더 배포본 또는 기존에 독립 검수된 증적과 대조한 값을 사용한다. 일반
|
||||
수동 Development Live 초기화에서는 위 지속 K3D pin을 먼저 만들거나 대조한 뒤 같은 기준값으로 이 승인 파일을
|
||||
발급한다. 파일 ACL은 현재 개발 사용자와 관리자만 수정할 수 있도록 유지한다.
|
||||
사용해서는 안 된다. 벤더 배포본 또는 기존에 독립 검수된 증적과 대조한 값을 사용한다. 첫 실행
|
||||
자동 설정과 일반 수동 Development Live 초기화는 위 지속 K3D pin을 먼저 만들거나 대조한 뒤
|
||||
같은 기준값으로 이 승인 파일을 발급한다. 파일 ACL은 현재 개발 사용자와 관리자만 수정할 수
|
||||
있도록 유지한다.
|
||||
|
||||
## 기존 playout.local.json
|
||||
|
||||
|
||||
Reference in New Issue
Block a user