目前很多應用都存在網頁端和客戶端形式,例如常用的:釘釘、微信等。按傳統的開發形式,需要為客戶端開發一套界面。基於當前Web應用可以利用三大前端框架和UI框架快速開發出各種酷炫的界面,於是出現了客戶端嵌瀏覽器的方式,它不僅可以重用Web應用,而且以客戶端內嵌瀏覽器的形式,不用擔心用戶用IE瀏覽器打開你的Web應用(滑稽);
下面展示Winform客戶端+ChromiumFX嵌Vue應用頁面效果:
https://zbj-bucket1.oss-cn-shenzhen.aliyuncs.com/2.mp4
一、下載資源文件
(1)Chromiumfx下載(目前最新版本73.1.13.0,發布時間2019-04-18)
下載鏈接:https://bitbucket.org/chromiumfx/chromiumfx/downloads/
解壓后打開cef文件夾中的readme.txt文件,查看依賴的cef的版本。
(2)下載依賴的cef(這里對應的版本為73.1.13+g6e3c989+chromium-73.0.3683.75)
下載鏈接:http://opensource.spotify.com/cefbuilds/index.html#windows32_builds
根據不同的操作系統版本下載相應的Sample Application即可
解壓后的文件如下:
二、新建Winfrom項目
(1)編譯ChromiumFX程序
打開ChromiumFX.sln解決方案(我用的是VS2015),按平台需求選擇Release x86或者其他,依次生成libcfx、ChromiumFX、ChromiumWebBrowser項目生。
在\Build\ Release中復制我們需要的三個文件libcfx.dll、ChromiumFX.dll、ChromiumWebBrowser.dll(這里要編譯libcfx C項目,有點麻煩,源碼中已經編譯好了,這步可以省略)
(2)新建Winform項目,項目中引用ChromiumFX.dll、ChromiumWebBrowser.dll
添加初始化頁面窗體
private string mUrl = ""; ChromiumWebBrowser testWeb; public InitForm(string url) { InitializeComponent(); mUrl = url; } private void Form1_Load(object sender, EventArgs e) { testWeb = new ChromiumWebBrowser(mUrl); testWeb.GlobalObject.AddFunction("newpage").Execute += NewPage;//定義JS調用C#事件 testWeb.GlobalObject.AddFunction("userLogin").Execute += UserLogin; testWeb.Dock = DockStyle.Fill;//鋪滿 this.WindowState = FormWindowState.Maximized; this.Controls.Add(testWeb); CEFHelper.cefevent(testWeb, this.Handle);//F12調試窗口,方便開發,生產環境可去掉 } //彈出新窗體 private void NewPage(object sender, Chromium.Remote.Event.CfrV8HandlerExecuteEventArgs e) { //獲取js傳入的參數,需對應到參數類型 if (e.Arguments.Length > 0) { ShadowForm shadow = new ShadowForm(e.Arguments[0].StringValue); shadow.Show(); } ////設置返回值,可為基本類型,js將接收到此返回值,如不需返回值,則此處可省略 //e.SetReturnValue("這是調用c#函數的結果"); } //JS調用后台的登錄方法,獲取token private void UserLogin(object sender, Chromium.Remote.Event.CfrV8HandlerExecuteEventArgs e) { ResponseInfo response = new ResponseInfo(); try { //獲取js傳入的參數,需對應到參數類型 if (e.Arguments.Length > 0) { if (e.Arguments[0].StringValue == "test" && e.Arguments[1].StringValue == "123") { UserInfo user = new UserInfo(); user.userName = "admin"; user.token = "JWT.token"; response.success = true; response.data = JsonConvert.SerializeObject(user); e.SetReturnValue(JsonConvert.SerializeObject(response));//返回數據 } else { response.success = false; response.errMsg = "用戶名或密碼錯誤!"; e.SetReturnValue(JsonConvert.SerializeObject(response)); } } } catch (Exception ex) { response.success = false; response.errMsg = ex.Message; e.SetReturnValue(JsonConvert.SerializeObject(response)); } }
三、新建彈出窗體
(1)創建蒙層窗體
private string mUrl = ""; public ShadowForm(string url) { InitializeComponent(); mUrl = url; } private void timer1_Tick(object sender, EventArgs e) { timer1.Enabled = false; NewPageForm page = new NewPageForm(mUrl); page.StartPosition = FormStartPosition.CenterScreen; page.ShowInTaskbar = false; page.ShowDialog(this); Close(); } private void ShadowForm_Load(object sender, EventArgs e) { this.WindowState = FormWindowState.Maximized; timer1.Enabled = true; }
(2)創建彈出窗體
ChromWebHelper cwh; ChromiumWebBrowser webBrowser; private string mUrl = ""; public NewPageForm(string url) { InitializeComponent(); mUrl = url; } private void NewPageForm_Load(object sender, EventArgs e) { webBrowser = new ChromiumWebBrowser(mUrl); webBrowser.GlobalObject.AddFunction("newpage").Execute += NewPage; webBrowser.GlobalObject.AddFunction("closefrm").Execute += CloseFrm; webBrowser.Dock = DockStyle.Fill;//鋪滿 this.Controls.Add(webBrowser);//加入窗體 cwh = new ChromWebHelper(webBrowser); CEFHelper.cefevent(webBrowser, this.Handle); } private void NewPage(object sender, Chromium.Remote.Event.CfrV8HandlerExecuteEventArgs e) { //獲取js傳入的參數,需對應到參數類型 if (e.Arguments.Length > 0) { ShadowForm shadow = new ShadowForm(e.Arguments[0].StringValue); shadow.Show(); } ////設置返回值,可為基本類型,js將接收到此返回值,如不需返回值,則此處可省略 //e.SetReturnValue("這是調用c#函數的結果"); } private void CloseFrm(object sender, Chromium.Remote.Event.CfrV8HandlerExecuteEventArgs e) { this.Close(); }
四、編譯Winform窗體程序
(1)把依賴的cef庫文件夾中的Release文件夾更名為cef
並把它復制到Winform程序的\bin\Release\目錄下
(2)把上述編譯生成的libcfx.dll也復制到\bin\Release\,然后編譯程序,以Release方式運行。
五、總結
Winform客戶端嵌Web應用的方式不僅可以簡化開發,而且做出來的應用界面美觀。
源碼地址:https://github.com/Bingjian-Zhu/ChromeiumFXDemo.git (喜歡的記得star)