LGram16
40842778e0
- WebView2 Fixed Version 지원 추가 (오프라인 환경 대응) - Frm_WebManual에 InitializeWebView2Async() 구현 - WebView2Runtime 폴더 우선 사용 (Fixed Version) - 시스템 런타임으로 폴백 - MdiMain에 CheckWebView2Runtime() 추가 - Setup1.vdproj에 .NET Framework 4.8 배포 설정 반영 - .gitignore에 WebView2Runtime/, WebView2Data/ 추가 - claudedocs/WebView2_Deployment_Guide.md 배포 가이드 추가 - Fixed Version 다운로드 및 배포 방법 - 테스트 및 문제 해결 가이드 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
136 lines
4.6 KiB
Markdown
136 lines
4.6 KiB
Markdown
# WebView2 Fixed Version 배포 가이드
|
|
|
|
## 개요
|
|
|
|
ECO2 프로그램은 WebView2 Fixed Version 방식을 사용하여 오프라인 환경에서도 매뉴얼 뷰어를 사용할 수 있습니다.
|
|
|
|
## Fixed Version 다운로드
|
|
|
|
### 1. 다운로드 위치
|
|
https://developer.microsoft.com/microsoft-edge/webview2/#download-section
|
|
|
|
"Fixed Version" 섹션에서 다운로드합니다.
|
|
|
|
### 2. 버전 선택
|
|
- **플랫폼**: x86 (32-bit) - ECO2는 x86 타겟입니다
|
|
- **추천 버전**: 최신 Stable 버전
|
|
- 파일 크기: 약 100-150MB
|
|
|
|
### 3. 다운로드 파일 예시
|
|
- `Microsoft.WebView2.FixedVersionRuntime.{version}.x86.cab`
|
|
- 또는 압축 해제된 폴더 형태
|
|
|
|
## 배포 방법
|
|
|
|
### 1. 폴더 구조
|
|
```
|
|
{프로그램 설치 폴더}/
|
|
├── ECO2_2025V1.exe
|
|
├── WebView2Runtime/ ← Fixed Version 런타임 폴더
|
|
│ ├── msedge.exe
|
|
│ ├── msedgewebview2.exe
|
|
│ └── [기타 WebView2 파일들]
|
|
└── WebView2Data/ ← 사용자 데이터 폴더 (자동 생성됨)
|
|
└── [캐시, 쿠키 등]
|
|
```
|
|
|
|
### 2. 설치 단계
|
|
|
|
#### 방법 1: 수동 배포 (개발/테스트)
|
|
1. Fixed Version CAB 파일 또는 폴더 다운로드
|
|
2. CAB 파일인 경우 압축 해제
|
|
3. 압축 해제된 내용을 `WebView2Runtime` 폴더로 복사
|
|
4. `WebView2Runtime` 폴더를 프로그램 실행 파일과 같은 위치에 배치
|
|
|
|
#### 방법 2: 설치 프로그램 포함 (프로덕션)
|
|
Setup1 프로젝트에 WebView2Runtime 폴더를 포함:
|
|
1. Setup1.vdproj 열기
|
|
2. WebView2Runtime 폴더를 프로젝트에 추가
|
|
3. 설치 시 Application Folder에 복사되도록 설정
|
|
|
|
## 동작 방식
|
|
|
|
### 런타임 검색 순서
|
|
1. **Fixed Version 우선**: `{실행폴더}\WebView2Runtime` 폴더 검색
|
|
2. **시스템 런타임 폴백**: 시스템에 설치된 WebView2 Runtime 사용
|
|
3. **없을 경우**: 매뉴얼 기능 사용 시 오류 메시지 표시
|
|
|
|
### 프로그램 시작 시 검사
|
|
- MdiMain 로드 시 `CheckWebView2Runtime()` 메서드가 Fixed Version 존재 여부 확인
|
|
- Debug.WriteLine으로 경고 출력 (사용자에게는 미표시)
|
|
- 실제 사용 시점(매뉴얼 열기)에만 오류 표시
|
|
|
|
### 오프라인 환경
|
|
- Fixed Version이 배포되어 있으면 인터넷 연결 불필요
|
|
- 모든 런타임 파일이 로컬에 포함되어 있음
|
|
- 폐쇄망 환경에서도 정상 작동
|
|
|
|
## 버전 업데이트
|
|
|
|
### Fixed Version 업데이트 방법
|
|
1. 새 Fixed Version 다운로드
|
|
2. 기존 `WebView2Runtime` 폴더 백업 (선택사항)
|
|
3. 새 버전으로 `WebView2Runtime` 폴더 교체
|
|
4. 프로그램 재시작
|
|
|
|
### 주의사항
|
|
- WebView2Runtime 폴더는 약 100-150MB이므로 Git에 커밋하지 않음
|
|
- .gitignore에 이미 추가되어 있음
|
|
- 설치 프로그램에는 반드시 포함해야 함
|
|
|
|
## 테스트 방법
|
|
|
|
### 1. Fixed Version 테스트
|
|
```
|
|
1. WebView2Runtime 폴더가 있는 상태에서 프로그램 실행
|
|
2. "Manual" 메뉴 클릭
|
|
3. http://localhost:58123/ 페이지가 정상적으로 로드되는지 확인
|
|
```
|
|
|
|
### 2. 폴백(Fallback) 테스트
|
|
```
|
|
1. WebView2Runtime 폴더 임시 이름 변경 (예: WebView2Runtime_backup)
|
|
2. 프로그램 실행 (시스템 런타임 사용 시도)
|
|
3. "Manual" 메뉴 클릭
|
|
4. 시스템에 런타임이 있으면 정상 작동, 없으면 오류 메시지
|
|
```
|
|
|
|
### 3. 오프라인 테스트
|
|
```
|
|
1. 네트워크 연결 끊기
|
|
2. Fixed Version 배포된 상태에서 프로그램 실행
|
|
3. 매뉴얼 기능이 정상 작동하는지 확인
|
|
```
|
|
|
|
## 문제 해결
|
|
|
|
### "WebView2 구성 요소를 찾을 수 없습니다" 오류
|
|
**원인**: Fixed Version도 없고 시스템 런타임도 설치되지 않음
|
|
|
|
**해결**:
|
|
1. WebView2Runtime 폴더가 실행 파일과 같은 위치에 있는지 확인
|
|
2. WebView2Runtime 폴더 내에 msedgewebview2.exe 파일이 있는지 확인
|
|
3. 또는 시스템에 WebView2 Runtime 설치: https://go.microsoft.com/fwlink/p/?LinkId=2124703
|
|
|
|
### 페이지 로딩 실패
|
|
**원인**: 로컬 웹서버(http://localhost:58123/)가 실행되지 않음
|
|
|
|
**해결**:
|
|
1. 로컬 웹서버가 실행 중인지 확인
|
|
2. 포트 58123이 열려 있는지 확인
|
|
3. Frm_WebManual.vb의 Navigate URL 수정 필요 시 수정
|
|
|
|
### WebView2Data 폴더 문제
|
|
**원인**: 캐시 또는 쿠키 문제
|
|
|
|
**해결**:
|
|
1. 프로그램 종료
|
|
2. WebView2Data 폴더 삭제
|
|
3. 프로그램 재시작 (자동으로 새 폴더 생성됨)
|
|
|
|
## 참고 자료
|
|
|
|
- WebView2 공식 문서: https://learn.microsoft.com/microsoft-edge/webview2/
|
|
- Fixed Version 배포 가이드: https://learn.microsoft.com/microsoft-edge/webview2/concepts/distribution
|
|
- WebView2 다운로드: https://developer.microsoft.com/microsoft-edge/webview2/
|