CEF4Delphi/es: what changed

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

Old	New		Line
1	1		## Contents
2	2
3	3		* 1 Acerca de
4	4		* 2 Links
5	5		* 3 Installation
6	6		* 4 Usage
7	7		* 4.1 Quick Starters
8	8		* 4.2 Event properties
9	9		* 4.3 Linux
10	10		* 4.4 macOS (Cocoa) - NSPrincipalClass
11	11		* 4.4.1 Cocoa on Lazarus 2.0.12
12	12
13	13		## Acerca de
14	14
15	15		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	16
17	17		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	18
19	19		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	20
21	21		CEF4Delphi está basado en [[fpCEF3]]
22	22
23	23		## Links
24	24
25	25		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	26
27	27		Forum: <https://www.briskbard.com/forum/>
28	28
29	29		The CEF documentation is at <https://magpcss.org/ceforum/apidocs3/>
30	30
31	31		Forum: <https://magpcss.org/ceforum/>
32	32
33	33		## Installation
34	34
35	35		CEF4Delphi is available in the Online Package Manager.
36	36
37	37		In order to get the full feature set, you may need to install from the "external repository".
38	38
39	39		The git repository can be found here: <https://github.com/salvadordf/CEF4Delphi>
40	40
41	41		The framework binaries can be found here: <https://cef-builds.spotifycdn.com/index.html>
42	42
43	43		There version need to match the version expected by the CEF4Delphi package. See git commit log <https://github.com/salvadordf/CEF4Delphi/commits/master>
44	44
45	45		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	46
47	47		## Usage
48	48
49	49		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	50
51	51		### Quick Starters
52	52
53	53		The simplest way is to look at the following 2 demos:
54	54
55	55		demos/Lazarus_any_OS/BrowserWindow
56	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	57		demos/Lazarus_any_OS/BrowserWindowEx
58	58		A demo that shows how to dynamically create and close browsers in your application
59	59
60	60		Make sure to read:
61	61
62	62		* the part of the documentation (link) on downloading and installing the "CEF binaries".
63	63		* The README.txt in each demo-app's folder
64	64
65	65		Before writing your own app, read the comments on top of uCEFBrowesWindow.pas
66	66
67	67		Optionally explore the settings in each demo-app's GlobalCefApplication.pas
68	68
69	69		### Event properties
70	70
71	71		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	72
73	73		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	74
75	75		You can check the CEF documentation for each event.
76	76
77	77		### Linux
78	78
79	79		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	80
81	81		This requires modifications to the project.lpr file.
82	82
83	83		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	84
85	85		### macOS (Cocoa) - NSPrincipalClass
86	86
87	87		On macOS the application [[macOS property list files\|Info.plist]] file must be modified to set NSPrincipalClass to TCrCocoaApplication.
88	88
89	89		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	90
91	91		Under Lazarus 2.1 (trunk) the NSPrincipalClass can be set in the "Project options".
92	92
93	93		#### Cocoa on Lazarus 2.0.12
94	94
95	95		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	96
97	97		[Human readable Patch](<https://github.com/User4martin/lazarus/commit/cccd9460506e42d97fc726faba730ad1a65aa035>).
98	98
99	99		---
100		-	From the Free Pascal wiki, page "CEF4Delphi/es", as the Internet Archive kept it on 2025-05-16. 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).
	100	+	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