webview_windows

패키지 개요

공개 정보를 바탕으로 생성한 선택 가이드입니다.

Windows용으로 WebView2 기반 웹 뷰 구현을 제공하는 플러터 패키지로, 데스크톱 애플리케이션 내에서 웹 콘텐츠를 원활하게 통합할 수 있습니다. Windows 플랫폼 전용으로 개발되었으며, 크롬ium 기반의 마이크로소프트의 WebView2 컨트롤을 활용하여 최신 웹 호환성과 성능을 보장합니다. 이 패키지는 웹 페이지 표시, 네비게이션 처리, Dart에서 자바스크립트와 상호작용하는 것을 가능하게 합니다. URL 로딩, 네비게이션 이벤트, 기본 스크립팅과 같은 일반적인 웹뷰 기능을 지원합니다. 플러터로 제작된 Windows 데스크톱 앱에 웹 기반 UI나 콘텐츠를 임베드하는 데 이상적입니다.

사용 사례

Windows 데스크톱 앱에 웹 콘텐츠 삽입
동적 웹 기반 인터페이스 표시
데스크톱 애플리케이션에 웹 서비스 통합
웹 컴포넌트를 사용하여 하이브리드 데스크톱 애플리케이션 구축
임베디드 웹 뷰를 사용하여 풍부한 사용자 경험 만들기

주요 기능

Windows에서 WebView2 기반 렌더링
크롬 기반 웹 엔진
자바스크립트 상호작용 지원
네비게이션 이벤트 처리
Flutter 데스크톱과 크로스 플랫폼 호환

적합한 대상

윈도우 데스크톱을 대상으로 하는 플러터 개발자
임베디드 웹 콘텐츠가 필요한 앱
웹 컴포넌트를 사용한 하이브리드 데스크톱 애플리케이션
Windows에서 현대적인 웹 렌더링이 필요한 개발자
Windows 고유 기능을 위한 WebView2 사용 프로젝트

고려 사항

윈도우 전용 플랫폼 지원
WebView2 런타임 설치가 필요합니다
Windows 데스크톱 환경에 제한됨
생산 배포를 위해 추가 설정이 필요할 수 있습니다
대상 시스템에서 WebView2 컨트롤 사용 가능 여부에 따라 다름

원본 README

연결된 소스 저장소의 README 원문 스냅샷입니다. 최신 내용은 저장소에서 확인하세요.

A Flutter WebView plugin for Windows built on Microsoft Edge WebView2.

Target platform requirements

WebView2 Runtime
Before initializing the webview, call getWebViewVersion() to check whether the required WebView2 Runtime is installed or not on the current system. If getWebViewVersion() returns null, guide your user to install WebView2 Runtime from this page.
Windows 10 1809+

Development platform requirements

Visual Studio 2019 or higher
Windows 11 SDK (10.0.22000.194 or higher)
(recommended) nuget.exe in your $PATH (The makefile attempts to download nuget if it's not installed, however, this fallback might not work in China)

Demo

https://user-images.githubusercontent.com/720469/116716747-66f08180-a9d8-11eb-86ca-63ad5c24f07b.mp4

Limitations

This plugin provides seamless composition of web-based contents with other Flutter widgets by rendering off-screen.

Unfortunately, Microsoft Edge WebView2 doesn't currently have an explicit API for offscreen rendering. In order to still be able to obtain a pixel buffer upon rendering a new frame, this plugin currently relies on the Windows.Graphics.Capture API provided by Windows 10. The downside is that older Windows versions aren't currently supported.

Older Windows versions might still be targeted by using BitBlt for the time being.

See: