WebView2 통합 및 Fixed Version 배포 방식 구현
- 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>
This commit is contained in:
		
							
								
								
									
										135
									
								
								claudedocs/WebView2_Deployment_Guide.md
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										135
									
								
								claudedocs/WebView2_Deployment_Guide.md
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,135 @@ | ||||
| # 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/ | ||||
		Reference in New Issue
	
	Block a user