CEF4Delphi/es: what changed

Revision 2 to 3. Removed lines have a minus sign; added lines have a plus sign.

Old	New		Line
1		-	~~## Contents~~
2		-
3		-	* 1 Acerca de
4		-	* 2 Links
5		-	* 3 Installation
6		-	* 4 Usage
7		-	* 4.1 Quick Starters
8		-	* 4.2 Event properties
9		-	* 4.3 Linux
10		-	* 4.4 macOS (Cocoa) - NSPrincipalClass
11		-	* 4.4.1 Cocoa on Lazarus 2.0.12
12		-
13	1		## Acerca de
14	2
15	3		CEF4Delphi es un envoltorio, una interfaz, en Pascal para el "Chromium Embedded Framework". Este permite a Lazarus para embeber un navegador web basado en la maquinaria de Chromium.
16	4
17	5		En estos momentos está soportado para aplicaciones creadas con Lazarus para Windows y Linux(GTK-2) con objetivo x86_64 (para i386 están pendientes las pruebas).
18	6
19	7		Desde la versión 2.1 (trunk) de Lazarus hay soportr para Cocoa x86_64. (Cocoa no incluye toda la funcionalidad del modo OSR, pero en modo normal de ventanas todas las funciones están disponibles).
20	8
21	9		CEF4Delphi está basado en [[fpCEF3]]
22	10
23	11		## Links
24	12
25	13		The CEF4Delphi documentation can be found at [https://www.briskbard.com/index.php?lang=en&pageid=cef](<https://www.briskbard.com/index.php?lang=en&pageid=cef>)
26	14
27	15		Forum: <https://www.briskbard.com/forum/>
28	16
29	17		The CEF documentation is at <https://magpcss.org/ceforum/apidocs3/>
30	18
31	19		Forum: <https://magpcss.org/ceforum/>
32	20
33	21		## Installation
34	22
35	23		CEF4Delphi is available in the Online Package Manager.
36	24
37	25		In order to get the full feature set, you may need to install from the "external repository".
38	26
39	27		The git repository can be found here: <https://github.com/salvadordf/CEF4Delphi>
40	28
41	29		The framework binaries can be found here: <https://cef-builds.spotifycdn.com/index.html>
42	30
43	31		There version need to match the version expected by the CEF4Delphi package. See git commit log <https://github.com/salvadordf/CEF4Delphi/commits/master>
44	32
45	33		The version check can be disabled for basic testing: "GlobalCEFApp.CheckCEFFiles := false;". However this should not be done for releases or more complex projects.
46	34
47	35		## Usage
48	36
49	37		The usage is described in the documentation at [https://www.briskbard.com/index.php?lang=en&pageid=cef](<https://www.briskbard.com/index.php?lang=en&pageid=cef>)
50	38
51	39		### Quick Starters
52	40
53	41		The simplest way is to look at the following 2 demos:
54	42
55		-	~~demos/Lazarus_any_OS/BrowserWindow~~
56		-	~~A demo to show how to use a browser that will exist for the life-time of the application. (I.e. the browser is only closed, when the application exits)~~
57		-	~~demos/Lazarus_any_OS/BrowserWindowEx~~
58		-	~~A demo that shows how to dynamically create and close browsers in your application~~
	43	+	demos/Lazarus_any_OS/BrowserWindow
	44	+
	45	+	A demo to show how to use a browser that will exist for the life-time of the application. (I.e. the browser is only closed, when the application exits)
	46	+
	47	+	demos/Lazarus_any_OS/BrowserWindowEx
	48	+
	49	+	A demo that shows how to dynamically create and close browsers in your application
59	50
60	51		Make sure to read:
61	52
62	53		* the part of the documentation (link) on downloading and installing the "CEF binaries".
63	54		* The README.txt in each demo-app's folder
64	55
65	56		Before writing your own app, read the comments on top of uCEFBrowesWindow.pas
66	57
67	58		Optionally explore the settings in each demo-app's GlobalCefApplication.pas
68	59
69	60		### Event properties
70	61
71	62		Many events (OnSomeEvent), including many of those assignable from the Object-Inspector will be executed in threads created by CEF. Events in threads are not allowed to access any components (Forms, Button, entire LCL...), and also restricted in what calls they may make to the OS. For other data they may need CriticalSections or similar. See the linked documentation.
72	63
73	64		Some events are executed in a different Process. They can not even share Global variables. See the DOM demos on how communication is done.
74	65
75	66		You can check the CEF documentation for each event.
76	67
77	68		### Linux
78	69
79	70		On Linux CEF must be setup before the application creates any threads. Since gtk may create threads, CEF must be initialized before the LCL widgetset initializes gtk2.
80	71
81	72		This requires modifications to the project.lpr file.
82	73
83	74		In the demos, this is done by including a unit in the "uses" clause, before the "unit interfaces". In that unit is a "initialization" section, and that runs before the widgetset (if units are used in the correct order)
84	75
85	76		### macOS (Cocoa) - NSPrincipalClass
86	77
87	78		On macOS the application [[macOS property list files\|Info.plist]] file must be modified to set NSPrincipalClass to TCrCocoaApplication.
88	79
89	80		There are scripts provided to do that. The scripts also put the "Helper apps" in place. (Assuming you compile them first / See the README.txt files).
90	81
91	82		Under Lazarus 2.1 (trunk) the NSPrincipalClass can be set in the "Project options".
92	83
93	84		#### Cocoa on Lazarus 2.0.12
94	85
95	86		In order to use CEF4Delphi with Cocoa x86_64 you must patch your Lazarus 2.0.12 version: [Patch](<https://github.com/User4martin/lazarus/commit/cccd9460506e42d97fc726faba730ad1a65aa035.diff>).
96	87
97	88		[Human readable Patch](<https://github.com/User4martin/lazarus/commit/cccd9460506e42d97fc726faba730ad1a65aa035>).
98	89
99	90		---
100	91		From the Free Pascal wiki, page "CEF4Delphi/es", as the Internet Archive kept it on 2025-05-16, last changed on 2022-02-05. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).

Back to history