Carbon interface FAQ: what changed

Revision 2 to 3. 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		-	~~```~~
	31	+	```text
32	32		make lcl LCL_PLATFORM=carbon
33	33		```
34	34
35	35		- for Lazarus IDE:
36	36
37		-	~~```~~
	37	+	```text
38	38		make all LCL_PLATFORM=carbon OPT="-k-framework -kCarbon -k-framework -kOpenGL"
39	39		```
40	40
41	41		under Leopard (10.5.x):
42	42
43		-	~~```~~
	43	+	```text
44	44		make all LCL_PLATFORM=carbon OPT="-k-framework -kCarbon -k-framework -kOpenGL -k'-dylib_file' \
45	45		-k'/System/Library/Frameworks/OpenGL.framework/Versions/A/Libraries/libGL.dylib:/System/Library/Frameworks/OpenGL.framework/Versions/A/Libraries/libGL.dylib'"
46	46		```
47	47
48	48		## I get error "make: -iVSPTPSOTO: Command not found" when I try to rebuild LCL or Lazarus IDE for Carbon interface via terminal.
49	49
50	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:
51	51
52	52		- for Bash terminal in ".profile" file (e.g. use command "open -e ~/.profile" in terminal). At the end of file add this line:
53	53
54		-	~~```~~
	54	+	```text
55	55		export PATH=$PATH:/usr/local/bin
56	56		```
57	57
58	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:
59	59
60		-	~~```~~
	60	+	```text
61	61		append_path PATH /usr/local/bin
62	62		```
63	63
64	64		, where "/usr/local/bin" is path to FPC executables. Save the result. It should work after terminal restart.
65	65
66	66		## Unknown Stabs
67	67
68	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.
69	69
70	70		<http://www.mail-archive.com/fpc-pascal@lists.freepascal.org/msg13235.html>
71	71
72	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).
73	73
74	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).
75	75
76	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+
77	77
78	78		### Dwarf issues
79	79
80	80		Compiling a project with -gw3 might crash the linker.
81	81
82	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.
83	83
84	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.
85	85
86	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.
87	87
88	88		## Why my project doesn't work on earlier operating system versions?
89	89
90	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):
91	91
92		-	~~```~~
	92	+	```text
93	93		/Applications/ProjApp.app/Contents/MacOS/projapp ; exit; dyld: unknown
94	94		required load command 0x80000022
95	95		Trace/BPT trap
96	96		logout
97	97		```
98	98
99	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:
100	100
101		-	~~```~~
	101	+	```text
102	102		-macosx_version_min 10.5
103	103		```
104	104
105	105		"Pass Options to the Linker (Delimiter is space)" must be checked.
106	106
107	107		If you compile for 10.4 target, you should specify the 10.4 minimal version, and so on.
108	108
109	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.
110	110
111	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)
112	112
113	113		### User friendly OS version requirement
114	114
115	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.
116	116
117	117		### Which is the minimum macOS version required by LCL-Carbon?
118	118
119	119		This information is documented here: [[LCL Internals\|Minimum Toolkit Versions]]
120	120
121	121		---
122	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).
123	123		Category: Carbon
124	124		Category: FAQs
125	125		Category: Historical
126	126		Category: Mac OS Classic
127	127		Category: macOS

Back to history