CEF CefSettings 結構體 詳解

1. single_process：

        設置爲ture時，browser和render使用同一個進程。Chromium 不正是支持此運行模式，而且不如默認的多進程穩定。

 

2. no_sandbox：

        沙盒是在受限的安全環境中運行應用程序的一種作法，這種作法是要限制授予應用程序的代碼訪問權限。沙盒中的全部改動對操做系統不會形成任何損失。設置爲ture(1) 以禁止子進程的沙箱。

 

3. multi_threaded_message_loop:

        多線程消息循環,爲false時，能夠調用CefRunMessageLoop或者CefDoMessageLoopWork函數來觸發Cef消息循環，這時瀏覽器進程的UI線程就是調用CefRunMessageLoop或者CefDoMessageLoopWork函數的線程。當爲true時。瀏覽器進程的UI線程是另外的線程。設置multi_threaded_message_loop爲true則使用多線程消息循環。通常默認爲false，使用定時器進行事件觸發CefDoMessageLoopWork來進行事件處理。（僅在windows上支持此選項）

 

4. external_message_pump：

        設置爲true（1）來控制瀏覽器進程主（UI）線程消息泵，經過CefBrowserProcessHandler :: OnScheduleMessagePumpWork（）回調進行調度。若是必須將CEF消息循環集成到現有的應用程序消息循環中，建議將此選項與CefDoMessageLoopWork（）函數結合使用。對於大多數用戶，建議不要啓用此選項;禁用此選項並使用 CefRunMessageLoop（）函數或multi_threaded_message_loop（若是可能）。

 

5. windowless_rendering_enabled：

        離屏渲染，須要在CefRenderHandler裏實現OnPaint。設置爲true（1）以啓用無窗口（屏幕外）渲染支持。若是應用程序不使用無窗口渲染，請不要啓用此值，它可能會下降某些系統上的渲染性能。

 

6. command_line_args_disabled：

        cef3和chromium中的許多特性均可以用命令行參數來設置。這些參數使用」–some-argument[=optional-param]」的格式並經過CefExecuteProcess()和CefMainArgs結構體傳遞給cef。

禁用命令行參數，在調用CefInitialize()函數以前，將CefSettings.command_line_args_disabled設爲true。

指定主應用程序的命令行參數，須要實現CefApp::OnBeforeCommandLineProcessing()方法。

指定傳遞給子進程的命令行參數，須要實現CefApp::OnBeforeCommandLineProcessing()方法。

 

7. persist_session_cookies：

        在使用全局cookie管理器時，默認狀況下， 要保持會話cookie（沒有到期日期或有效期的間隔），將此值設置爲true（1）。會話cookie一般是暫時的，大多數Web瀏覽器不會持久化。A | cache_path | 還必須指定值以啓用此功能。也可使用「persist-session-cookies」命令行開關進行配置。能夠經過CefRequestContextSettings.persist_session_cookies值覆蓋各個CefRequestContext實例。

 

8. persist_user_preferences：

      將用戶首選項做爲JSON文件保存在緩存路徑目錄中將此值設置爲true（1）。A | cache_path | 還必須指定以啓用此功能。也可使用「persist-user-preferences」命令行開關進行配置。能夠經過 CefRequestContextSettings.persist_user_preferences值覆蓋各個CefRequestContext實例。

 

 

9. log_severity :

        此項設置日誌級別。只有此等級、或者比此等級高的日誌的纔會被記錄。此項能夠經過命令行參數「log-severity」配置，能夠設置的值爲「verbose」，「info」，「warning」，「error」，「error-report」，「disable」。

 

10. pack_loading_disabled :

        設置爲true（1）以禁用資源和區域設置的包文件加載。若是禁用了包文件的加載，則必須爲瀏覽器提供資源包處理程序並經過CefApp :: GetResourceBundleHandler（）呈現進程。也可使用「disable-pack-loading」命令 進行開關進行配置。

 

11.remote_debugging_port :

        此項能夠設置1024-65535之間的值，用於在指定端口開啓遠程調試。例如，若是設置的值爲8080，遠程調試的URL爲http://localhost:8080。CEF或者Chrome瀏覽器可以調試CEF。此項也能夠經過命令行參數「remote-debugging-port」配置。

 

12. uncaught_exception_stack_size ：

        捕獲未捕獲異常的堆棧跟蹤幀數。指定一個正值以啓用CefRenderProcessHandler::OnUncaughtException（）回調。指定0（默認值）和不會調用OnUncaughtException（）。也可使用uncaught-exception-stack-size」命令行開關進行配置。

 

13. ignore_certificate_errors：

        設置爲true（1）以忽略與無效SSL證書相關的錯誤。啓用此設置可能會致使潛在的安全漏洞，例如「中間人」攻擊。從Internet 加載內容的應用程序不該啓用此設置。也可使用「ignore-certificate-errors」命令行開關進行配置。能夠經過 CefRequestContextSettings.ignore_certificate_errors值覆蓋各個CefRequestContext實例。

 

14. enable_net_security_expiration ： 

        設置爲true（1）以啓用內置網絡安全信息的日期到期（即證書透明度日誌，HSTS預加載和固定信息）。啓用此選項可提升網絡安全性

 

15. background_color：

        在加載文檔以前和沒有指定文檔顏色時用於瀏覽器的背景顏色。alpha份量必須是徹底不透明（0xFF）或徹底透明（0x00）。若是alpha份量徹底是不透明的，則RGB份量將用做背景顏色。若是 alpha組件對於窗口瀏覽器徹底透明，則使用默認值opaque white。若是alpha組件對於無窗口（屏幕外）瀏覽器是徹底透明的，那麼將啓用透明繪製

 

16. browser_subprocess_path：

        設置用於啓動子進程單獨執行器的路徑。（cefprocess.exe）。若是在windows上或者linux上爲空，則使用祝金程的可執行文件。

 

17.framework_dir_path ：

   macOS上的cef目錄路徑。若是此值爲空，那麼狂姐必須存在於頂級應用程序包中。

 

18. cache_path : 

        設置磁盤上用於存放緩存數據的位置。若是爲空則將以「隱身模式」建立瀏覽器，其中內存緩存用於存儲，而且沒有數據持久保存到磁盤。若是指定了緩存路徑，則 localStorage 等HTML5數據庫將僅在會話中保持不變。能夠經過CefRequestContextSettings.cache_path值覆蓋單個CefRequestContext實例。

 

19. user_data_path ：

        將拼寫檢查字典文件等用戶數據存儲在磁盤上的位置。若是爲空，則將使用默認的特定於平臺的用戶數據目錄（Linux上的「〜/ .cef_user_data」目錄，

「Mac OS X上的〜/ Library / Application Support / CEF / User Data」目錄，   

Windows上用戶「Local Settings\Application Data\CEF\User Data」目錄）。

 

20. user_agent：

        設置客戶端標識，服務器能夠識別是從哪裏發來的請求。

 

21. product_version：

       將做爲默認User-Agent字符串的產品部分插入的值。若是爲空，將使用Chromium產品版本。若是 | userAgent | 指定此值將被忽略。也能夠配置使用「product-version」命令行開關。

 

22. locale : 

        此設置項將傳遞給Blink。若是此項爲空，將使用默認值「en-US」。在Linux平臺下此項被忽略，使用環境變量中的值，解析的依次順序爲：LANGUAE，LC_ALL，LC_MESSAGES和LANG。此項也能夠經過命令行參數「lang」配置。

 

23. log_file : 

        此項設置的文件夾和文件名將用於輸出debug日誌。若是此項爲空，默認的日誌文件名爲debug.log，位於應用程序所在的目錄。此項也能夠經過命令參數「log-file」配置。

 

24. javascript_flags : 

        初始化V8 JavaScript引擎時將使用的自定義標誌。使用自定義標誌的後果可能未通過充分測試。也使用「JS-標誌」命令行開關//配置。

 

25. resources_dir_path :

        此項設置資源文件夾的位置。若是此項爲空，Windows平臺下cef.pak、devtools_resourcs.pak、Mac OS X下的app bundle Resources目錄必須位於組件目錄。此項也能夠經過命令行參數「resource-dir-path」配置。

 

26. locales_dir_path : 

        此項設置locale文件夾位置。若是此項爲空，locale文件夾必須位於組件目錄，在Mac OS X平臺下此項被忽略，pak文件從app bundle Resources目錄。此項也能夠經過命令行參數「locales-dir-path」配置。

 

27. accept_language_list ：

        逗號分隔的有序語言代碼列表，沒有任何空格將在「Accept-Language」HTTP標頭中使用。可使用CefBrowserSettings.accept_language_list值在每一個瀏覽器的基礎上覆蓋。若是兩個值都爲空，則使用「en-US，en」。能夠經過CefRequestContextSettings.accept_language_list值覆蓋各個CefRequestContext實例。
---------------------
 
原文：https://blog.csdn.net/xiezhongyuan07/article/details/84402083
 

https://magpcss.org/ceforum/apidocs3/projects/(default)/_cef_settings_t.html