參考:
〓https://github.com/NetDimension/NanUI/wiki/%E5%BC%80%E5%A7%8B%E4%BD%BF%E7%94%A8NanUI
〓https://github.com/NetDimension/NanUI/wiki/%E6%89%93%E5%8C%85%E5%B9%B6%E4%BD%BF%E7%94%A8%E5%86%85%E5%B5%8C%E5%BC%8F%E7%9A%84HTML-CSS-JS%E8%B5%84%E6%BA%90
〓https://github.com/NetDimension/NanUI/wiki/%E4%BD%BF%E7%94%A8%E7%BD%91%E9%A1%B5%E6%9D%A5%E8%AE%BE%E8%AE%A1%E6%95%B4%E4%B8%AA%E7%AA%97%E5%8F%A3
〓https://github.com/NetDimension/NanUI/wiki/%E5%A6%82%E4%BD%95%E5%AE%9E%E7%8E%B0C%23%E4%B8%8EJavascript%E7%9A%84%E7%9B%B8%E4%BA%92%E9%80%9A%E4%BF%A1
前言:NetDimension.NanUI 集成的 CEF 框架開發工作,僅限於VS2017下進行開發
------------------------------------------------------------
001、引用 NetDimension.NanUI.dll
------------------------------------------------------------
002、通過 NuGet 包管理器添加則會自動加載相應的CEF框架,不然則需要自行下載CEF框架
------------------------------------------------------------
003、需要將 CEF 框架的資源放置於應用程序根目錄當中:
(1) 自適應 x86[32位] 或 x64[64位] 運行環境,將“fx”目錄放置於程序根目錄
(2) 如果是特定的運行環境,則需要將“fx”目錄下,
除“x64”和“x86”外的所有目錄全部放置於程序根目錄,
然后再將相應的運行環境目錄,同樣放置於程序根目錄
------------------------------------------------------------
004、使用 Bootstrap.Load 對CEF框架進行初始化操作
如:禁用日志、默認語言、禁用跨域安全檢測等
示例代碼:
//指定CEF架構和文件目錄結構,並初始化CEF
var loadFlag = Bootstrap.Load(settings => {
//禁用日志
settings.LogSeverity = Chromium.CfxLogSeverity.Disable;
//指定中文為當前CEF環境的默認語言
settings.AcceptLanguageList = "zh-CN";
settings.Locale = "zh-CN";
}, commandLine => {
//在啟動參數中添加disable-web-security開關,禁用跨域安全檢測
commandLine.AppendSwitch("disable-web-security");
});
if (loadFlag) {
Application.Run(new MainForm());
}
else {
MessageBox.Show("對不起!CEF框架未能正常加載,請檢查配置環境,確認無誤后再重試。", "系統提示", MessageBoxButtons.OK, MessageBoxIcon.Warning);
}
------------------------------------------------------------
005、如果是特定的運行環境使用,則需要使用如下的初始化方式,同時,
在VS的配置管理器中添加平台設置,將項目的目標平台指定為所需要的平台。
示例代碼:
//指定對應系統架構,如果省略指定CEF目錄結構的參數,那么需要手動調整CEF目錄結構。
var loadFlag = Bootstrap.Load(PlatformArch.x86);
if(loadFlag)
{
Application.Run(new MainForm());
}
------------------------------------------------------------
006、將 WinForm 的窗體繼承變更為 NanUI 的窗體類型
(1) Formium NanUI使用無邊框窗體引擎
(2) WinFormium NanUI使用原生的窗體樣式
(3) 繼承的窗體構造函數中,傳入需要顯示的網頁地址,即可開啟 NanUI 的 CEF 框架之旅
示例代碼:
//原生的窗體樣式
public partial class MainForm : WinFormium {
public MainForm()
: base("http://cn.bing.com") {
InitializeComponent();
}
}
//無邊框窗體引擎
public partial class MainForm : Formium {
public MainForm()
: base("http://cn.bing.com") {
InitializeComponent();
}
}
------------------------------------------------------------
007、在項目中添加一個應用程序清單文件: app.manifest,
並且取消**啟用 Windows 公共控件和對話框的主題(Windows XP 和更高版本) **段中的注釋:
<!-- 啟用 Windows 公共控件和對話框的主題(Windows XP 和更高版本) -->
<dependency>
<dependentAssembly>
<assemblyIdentity
type="win32"
name="Microsoft.Windows.Common-Controls"
version="6.0.0.0"
processorArchitecture="*"
publicKeyToken="6595b64144ccf1df"
language="*"
/>
</dependentAssembly>
</dependency>
然后在項目屬性的應用程序選項卡中找到清單項目,並指定其中內容為剛才的app.manifest,
重新運行項目,這時網頁中的所有帶title屬性的標簽就能正常顯示工具提示了
------------------------------------------------------------
008、將WEB前端的HTML/CSS/JS等文件作為嵌入資源編譯到項目中,既可提高加載速度,同時能避免惡意修改
------------------------------------------------------------
009、在使用 Bootstrap.Load 對CEF框架進行初始化操作時,需要同時注冊好項目所使用的內嵌資源信息
示例代碼:
if (loadFlag) {
//注冊嵌入資源,並為指定資源指定一個假的域名 my.resource.local
Bootstrap.RegisterAssemblyResources(System.Reflection.Assembly.GetExecutingAssembly(), domainName: "my.resource.local");
//加載分離式的資源
var separateAssembly = System.Reflection.Assembly.LoadFile(System.IO.Path.Combine(Application.StartupPath, "EmbeddedResourcesInSplitAssembly.dll"));
//注冊外部的嵌入資源,並為指定資源指定一個假的域名 separate.resource.local
Bootstrap.RegisterAssemblyResources(separateAssembly , domainName: "separate.resource.local");
Application.Run(new MainForm());
}
可以在項目中注冊多個程序中的嵌入式資源,但必需指定不同的域名(domainName參數),在使用時通過域名指向方式。
------------------------------------------------------------
010、完成資源文件的嵌入后,我們就可以跟平常瀏覽網頁一樣,
按照指定的虛假域名加上資源嵌入的目錄層級路徑,就可以在 NanUI 中順利使用我們的嵌入資源
(1) 通過 http://my.resource.local/index.html 訪問主項目中的 index.html 文件
(2) 通過 http://separate.resource.local/index.html 訪問外部程序集 EmbeddedResourcesInSplitAssembly.dll 中的 index.html 文件
項目中使用示例代碼:
public partial class MainForm : Formium
{
public MainForm()
: base("http://my.resource.local/index.html")
{
InitializeComponent();
}
}