Carbon interface FAQ: what changed

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

Old	New		Line
1	1		(macOS only)
2	2
3	3		(iOS only)
4	4
5	5		> Warning: The 32 bit Carbon interface is no longer under development since Apple removed all support for it and the ability to run 32 bit software in the release of macOS 10.15 Catalina in 2019. You should now use the 64 bit [[Cocoa Interface]].
6	6
7	7		This is a list of frequently asked questions and problems about Carbon interface.
8	8
9	9		## What's the state of Carbon interface?
10	10
11	11		You can find out current status at [[Roadmap\|Roadmap#Status of features on each widgetset]] and [[Roadmap\|Roadmap#Status of components on each widgetset]]. You should also look at [[Carbon interface internals\|Carbon interface internals#Compatibility issues]].
12	12
13	13		## What's the state of Lazarus IDE under Carbon interface?
14	14
15	15		The Lazarus IDE with a Carbon interface is as good or better than others. You can still help by reporting bugs at [[Carbon interface internals\|Carbon interface internals#Carbon IDE Bugs]].
16	16
17	17		## When I execute application compiled for Carbon interface, it can't be focused
18	18
19	19		You have to execute Carbon application via Application Bundle. See [[Carbon Interface\|Carbon Interface#Creating the Apple resource files]] how to create one.
20	20
21	21		## I got a linking error when building Carbon application
22	22
23	23		You have forgotten to pass options to the linker to use Carbon Framework. See [[Carbon Interface\|Carbon Interface#Compiler Options]].
24	24
25	25		## How can I rebuild LCL or Lazarus IDE for Carbon interface via terminal?
26	26
27	27		You can use the following command in Lazarus directory:
28	28
29	29		- for LCL:
30	30
31		-	~~`make lcl LCL_PLATFORM=carbon`~~
	31	+	```
	32	+	make lcl LCL_PLATFORM=carbon
	33	+	```
32	34
33	35		- for Lazarus IDE:
34	36
35		-	~~`make all LCL_PLATFORM=carbon OPT="-k-framework -kCarbon -k-framework -kOpenGL"`~~
	37	+	```
	38	+	make all LCL_PLATFORM=carbon OPT="-k-framework -kCarbon -k-framework -kOpenGL"
	39	+	```
36	40
37	41		under Leopard (10.5.x):
38	42
39		-	~~`make all LCL_PLATFORM=carbon OPT="-k-framework -kCarbon -k-framework -kOpenGL -k'-dylib_file' \`\~~
40		-	~~` -k'/System/Library/Frameworks/OpenGL.framework/Versions/A/Libraries/libGL.dylib:/System/Library/Frameworks/OpenGL.framework/Versions/A/Libraries/libGL.dylib'"`~~
	43	+	```
	44	+	make all LCL_PLATFORM=carbon OPT="-k-framework -kCarbon -k-framework -kOpenGL -k'-dylib_file' \
	45	+	-k'/System/Library/Frameworks/OpenGL.framework/Versions/A/Libraries/libGL.dylib:/System/Library/Frameworks/OpenGL.framework/Versions/A/Libraries/libGL.dylib'"
	46	+	```
41	47
42	48		## I get error "make: -iVSPTPSOTO: Command not found" when I try to rebuild LCL or Lazarus IDE for Carbon interface via terminal.
43	49
44	50		The reason of this error is, that Free Pascal Compiler executables are not found in search path. You must add their path to the terminal profile, which is located at your home directory:
45	51
46	52		- for Bash terminal in ".profile" file (e.g. use command "open -e ~/.profile" in terminal). At the end of file add this line:
47	53
48		-	~~`export PATH=$PATH:/usr/local/bin`~~
	54	+	```
	55	+	export PATH=$PATH:/usr/local/bin
	56	+	```
49	57
50	58		- for tcsh terminal in ".tcshrc" or ".cshrc" or ".login" file (e.g. use command "open -e ~/.cshrc" in terminal). At the end of file add this line:
51	59
52		-	~~`append_path PATH /usr/local/bin`~~
	60	+	```
	61	+	append_path PATH /usr/local/bin
	62	+	```
53	63
54	64		, where "/usr/local/bin" is path to FPC executables. Save the result. It should work after terminal restart.
55	65
56	66		## Unknown Stabs
57	67
58	68		The Unknown Stabs warnings are caused by a bug in the Leopard 10.5+ Linker and most Lazarus users can simply ignore them and they don't cause any harm in the software execution.
59	69
60	70		<http://www.mail-archive.com/fpc-pascal@lists.freepascal.org/msg13235.html>
61	71
62	72		That's because it also has to be partly fixed in the linker (which I didn't realise when I posted that message). The unknown stabs warnings (they're not errors afaik) are caused by stabs for local constants in functions/procedures (the linker interprets them as function stabs, because they have a very similar format and gcc does not generate stabs for constants).
63	73
64	74		If you want, you can download a patched linker from <http://trappist.elis.ugent.be/~jmaebe/cctools/> (extract it to some directory, add a symbolic link to /usr/bin/as in the same directory, and point FPC to it using the -FD command line switch). That linker corresponds to the one shipped with Xcode 3.0 (+ the patches in that directory).
65	75
66	76		But since end users most likely won't have that patched linker (and because stabs has been deprecated by Apple), you may want to switch to dwarf instead on Leopard 10.5+
67	77
68	78		### Dwarf issues
69	79
70	80		Compiling a project with -gw3 might crash the linker.
71	81
72	82		-gw3 crashes the linker because of a bug in the linker. It can be worked around by setting the version number of the DWARF debug info to 2 even though version 3 is generated, but that's a hack.
73	83
74	84		-gw2 does add debug information, just try debugging. On macOS, DWARF debug information however remains in the object files and is not added to the main binary by the linker (to speed up linking). You can compile with -Xg to collect all DWARF debug information for an application into a .dSYM bundle using dsymutil.
75	85
76	86		Note that Apple's gdb crashes if you try to debug Lazarus after compiling it with -Xg, so that's not a good idea there.
77	87
78	88		## Why my project doesn't work on earlier operating system versions?
79	89
80	90		It's common situation when a project you've compiled works on your operating system version, but not on earlier ones. For example, you're developing using version 10.6. The project runs fine for you, but not for your user using version 10.5. If you look to the console output you'd probably see the error like (or similar):
81	91
82		-	~~`/Applications/ProjApp.app/Contents/MacOS/projapp ; exit; dyld: unknown`\~~
83		-	~~`required load command 0x80000022`\~~
84		-	~~`Trace/BPT trap`\~~
85		-	~~`logout`~~
	92	+	```
	93	+	/Applications/ProjApp.app/Contents/MacOS/projapp ; exit; dyld: unknown
	94	+	required load command 0x80000022
	95	+	Trace/BPT trap
	96	+	logout
	97	+	```
86	98
87	99		It's caused, because you have compiled the project without earlier OS version compatibility. To add support for it, you need to specify the linker option (Project-\>Project Options-\>Linking-\>Options:
88	100
89		-	~~`-macosx_version_min 10.5`~~
	101	+	```
	102	+	-macosx_version_min 10.5
	103	+	```
90	104
91	105		"Pass Options to the Linker (Delimiter is space)" must be checked.
92	106
93	107		If you compile for 10.4 target, you should specify the 10.4 minimal version, and so on.
94	108
95	109		Remember, if your installed Xcode doesn't contain the backward compatibility SDK, the project linking would probably fail. You can always obtain the required SDKs from the free Apple Xcode downloads.
96	110
97	111		You can find more linkers options at [ld man page](http://developer.apple.com/mac/library/documentation/Darwin/Reference/ManPages/man1/ld.1.html)
98	112
99	113		### User friendly OS version requirement
100	114
101	115		If your application requires a specific OS version and you don't want your app just to crash, you should provide the OS requirement version in bundle's Info.plist.
102	116
103	117		### Which is the minimum macOS version required by LCL-Carbon?
104	118
105	119		This information is documented here: [[LCL Internals\|Minimum Toolkit Versions]]
106	120
107	121		---
108	122		From the Free Pascal wiki, page "Carbon interface FAQ", as it stood on 2021-08-04 after a change by Trev, out of the wiki's dump of 2024-05-26. 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).
109	123		Category: Carbon
110	124		Category: FAQs
111	125		Category: Historical
112	126		Category: Mac OS Classic
113	127		Category: macOS

Back to history