Installing Lazarus on MacOS X
Installing Lazarus on a Mac is not particularly difficult but it is critical that you do the install in the correct order. Skipping steps will almost certainly lead to tears. In brief, here is what you do -
- Download and install Xcode.
- Install the global command line tools for Xcode.
- Install Free Pascal Compiler and FPC Source
- Install Lazarus
- Configure LLDB - the Apple supplied (and signed) debugger from within Lazarus.
Note : if installing versions of Lazarus prior to 2.0.0 you almost certainly also need gdb, refer to the Legacy section.
- 1 Installation
- 2 Compatibility
- 3 Cocoa 64 bit vs Carbon 32 bit
- 4 Download the sources via svn
- 5 Download stable sources
- 6 Legacy Information
- 6.1 Install gdb
- 6.2 Xcode Compatability
- 6.3 Install Packages / Released version
- 6.4 Install from Source / Development version
- 7 Uninstalling Lazarus and Free Pascal
- 8 Known issues
- 9 See Also
The detailed instructions assume a recent version of macOS on you Mac, a recent version of Xcode from Apple and recent version of Lazarus. Further down the page, under Legacy Information, you will see older information that may be relevant if you are using older components. You can assist by replacing out of date info, either deleting it, or, if it may help someone working with a legacy project, moving it to the bottom of the page.
In general, this is about using both the Carbon and Cocoa Widget Set. While Carbon may still be seen as a little more stable, as of release 2.0.0 the 64 bit Cocoa is very close and certainly should be considered. Carbon was intentionally (by Apple) limited to 32 bits and you should be aware that it has been removed completely from macOS 10.15 Catalina which only supports 64 bit Cocoa.
Step 1. Download Xcode.
You need the Apple Developer tools, which are a part of the Xcode development environment.
Xcode 11.1 for use on MacOSX Catalina 10.15 can be installed from the Apps store, but you must first move any old Xcode versions from the Applications folder into the trash.
Older systems: The developer tools can be installed from the original macOS installation disks or a newer copy downloaded from the Apple Developer Connection (ADC), which requires free registration. Download the Xcode file, it will end up in your Downloads directory as a zip file. Click it. It is unarchived into your Downloads directory. You may be happy with it there but maybe not. Other users will see the path to it but be unable to use it. And it is untidy there. So I moved mine and then told xcode-select where it was moved to (in a terminal) -
mv Downloads/Xcode.app /Developer/. sudo xcode-select -s /Developer/Xcode.app/Contents/Developer
Step 2. Xcode Command Line Tools
This is shown here as a separate step because it really is a separate step in addition to Step 1. Don't confuse this with the internal Xcode command line tools that the Xcode GUI will tell you are already installed. Lazarus cannot use those Xcode internal command line tools, so do the following (it is quick and easy)-
Step 3 FPC, FPC Source
Get and install the Free Pascal Compiler (FPC) and source. A compatible FPC (and source) must be installed before you install Lazarus. You have a number of options.
To install the Free Pascal Compiler (FPC), get the installer and source from the official Free Pascal website. Lazarus mirrors these installers, but their copies are sometimes outdated. In particular, if you have macOS Mojave (10.14), make sure that you use the FPC 3.0.4a installer. Earlier installers (including the original FPC 3.0.4 installer) will not be able to identify the fact that you installed the command line tools.
Get the other files (Lazarus installer) from the official Lazarus website. These binary install kits are built by the FPC/Lazarus developers and track formal releases. As these install kits are not approved by Apple, you need to hold down the Control key, click the package and choose Open and confirm you want to install from an Unknown Developer.
For authoritative/more detailed instructions for FPC, please go to 
You might like to apply a simple and quick test of FPC at this stage - Testing FPC installation.
Other FPC Options
You could also consider using fpcupdeluxe to install fpc and, perhaps Lazarus, fpcupdeluxe.
Alternatively, you can use fink, a package manager for macOS to install FPC. Note at the time of writing (Late 2019) fink offers Lazarus 2.0.4. The extra bonus of fink is easy installation as well as clean removal of a huge number of other open source software packages, including FreePascal crosscompilers for many processors and systems. The choice for Lazarus is between a Carbon or Cocoa look, a gtk2 look, a Qt4-based and a Qt5-based version:
$ fink install lazarus-aqua // or $ fink install lazarus-cocoa // or $ fink install lazarus-gtk2 // or $ fink install lazarus-qt4 // or $ fink install lazarus-qt5
You will be asked, whether to install a number of dependencies, including the Free Pascal Compiler, the Lazarus sources. Simply hit RETURN at the prompt and go for a coffee. It may take quite some time to build all packages, in particular on older Macs.
After installation, Lazarus can be started from the folder /Applications/Fink/. The actual details of FPC and Lazarus are in subdirectories of /sw
With any Lazarus package from fink, these widget sets are supported for your program on macOS:
carbon (Aqua), cocoa, gtk2, qt4 (Aqua), qt5 (Aqua), nogui, win32, win64 and wince.
If you install FPC from fink, you will be fine downloading Lazarus source and compiling as detailed below. However, its possibly not a good idea to mix fink FPC with the Sourceforge binary install of Lazarus.
At time of writing (early 2019), there are a number of reasons why you may be better off using a non release version of Lazarus, specifically, fixes_2_0. Particularly:
- You almost certainly need to target Cocoa, macOS 10.15 Catalina does not support 32 bit Carbon at all.
- You almost certainly want to use lldb instead of gdb - far easier install.
- The Cocoa widget set is steadily improving and lldb interface is rapidly improving since even v2.0.0.
- Fixes_2_0 is a safer and more stable than trunk, but gets the new stuff much faster than release version.
Precompiled binaries based on fixes_2_0 are not available from SourceForge but can be obtained from fpcupdeluxe. But here we will discuss downloading source and building. A little slow initially but very reliable and a great test of your compiler install ! You will need svn (its not preinstalled on early macOS, use brew or fink to install).
cd ~ mkdir -p bin/lazarus cd bin/lazarus svn checkout https://svn.freepascal.org/svn/lazarus/branches/fixes_2_0 laz_fixes // wait some time .... cd laz_fixes make LCL_PLATFORM=cocoa CPU_TARGET=x86_64 bigide // wait some time ..... open startlazarus.app --args "--pcp=~/.laz_fixes"
- Note I pass a parameter to use a config directory that is based on the name of the actual install directory. It makes some scripting easy.
- It is also quite feasible (and perhaps a touch safer) to build a 32 bit Carbon Lazarus IDE and use it to build 64bit Cocoa applications unless you are running macOS 10.15 Catalina which has removed support for 32 bit Carbon. Replace above make line with "make LCL_PLATFORM=carbon CPU_TARGET=i386 bigide " and setup your project as mentioned in the Carbon_and_Cocoa section below.
You might like to put a small script in your $HOME/bin directory and even set a path to it (very UNIX!)
#!/bin/bash LAZDIR="laz_fixes" cd ~/bin/lazarus/"$LAZDIR" open ~/bin/lazarus/"$LAZDIR"/lazarus.app --args "--pcp=~/.$LAZDIR"
Configure the Debugger
In versions of Lazarus 1.8.4 and earlier, you needed to use gdb as a debugger, slow to install and hard to sign. Since Lazarus 2.0.0 you can (and should) use LLDB, a debugger provided by Apple, no signing required.
Assuming you have installed what is necessary and started Lazarus, all that remains is configuring the debugger. If you don't do this now, Lazarus will try to use GDB and fail.
First, click Tools->Options->Debugger. Top right of the window now open has a label, "Debugger type and path", you must set both. Select "LLDB debugger (with fpdebug) (Beta)".
If it is not show in the selection list, see below (Installing LazDebuggerFpLLdb".) Note that the image above has a path to LLDB that may well be different to yours, depends on where the XCode tools were installed, in my case /Library . Save those settings and you can now try to compile the almost nothing program that Lazarus has kindly provided for you (click the small green triangle near top left).
Next you see a puzzling question, see image below. Choose a "Debug Format" from one of the offered -
Martin_fr, the person who has given us this interface between Lazarus and LLDB, suggests you use "dwarf3". Then, you need to enter your password, a macOS cuteness because one application appears to be interfering with another. In this case, that's fine!
Extra Information on using LLDB
A great deal of information about using LLDB appears in this forum thread https://forum.lazarus.freepascal.org/index.php/topic,42869.0.html Here is a few gems, again, from Martin_fr:
In the unexpected case of problems, it may be worth trying "dwarf with sets" instead of just "dwarf3".
The "debug info" setting only affects the units directly in your project. However units in packages may have debug info too. This can be:
- set per package
- for many, but not all packages in menu Tools > Configure build Lazarus
- project settings > Additions and Overrides
If you change settings for a package, you may as well check into which package you expect to step. Packages you do not step into, do not need debug info.
If you use a type from a package (such as TForm from LCL) it is enough that your unit (in which you declare the variable / must declare and use a variable to include the type) has debug info. Reducing the number of packages with debug info (including those that default to have debug info), can shorten the debuggers start-up time.
Also it may be worth comparing (it has not been tested) the debuggers start up time for the same settings, only changing the checkbox "use external debug info".
This needs to be only set in your project. If set in your project it will affect all packages. (If set in a package it will do nothing / at least should...)
If you installed from source and used the bigide parameter to make, then the correct debugger will be installed, as a package, and ready to go. If, however, you installed in another way, it may, or may not be there. From the main IDE screen, click Packages->Install/UninstallPackages. Shown is two lists of packages, the list on the left is installed, the list on the right is available to install. Look for LazDebuggerFpLldb (exactly that, there are some similar named but less suitable packages). If it is on the right hand side, click it, press "Install Selection" and then "Save and rebuild IDE". This will take a little time, the IDE will shutdown and restart and all should be well. Now jump back up the page and continue configuring the debugger.
Not every combination of Lazarus and Free Pascal is compatible with every installation of macOS. Please refer to the following table in order to find the correct version for your development environment:
|Lazarus 1.0.0||Lazarus 1.0.2||Lazarus 1.0.4||Lazarus 1.0.6||Lazarus 1.0.8||Lazarus 1.0.10||Lazarus 1.0.12||Lazarus 1.0.14||Lazarus 1.2.0|
|Free Pascal (FPC) 2.6.0||FPC 2.6.2|
|Mac OS X 10.4 (Tiger)||Incompatible||Incompatible||N/A||Compatible||Incompatible||Incompatible||Compatible*||Compatible*||Not tested|
|Mac OS X 10.5 (Leopard)||Compatible||Compatible||N/A||Compatible||Compatible||Compatible||Compatible||Compatible||Compatible**|
|Mac OS X 10.4 (Tiger)||Incompatible||Incompatible||Compatible||Compatible||Incompatible||Incompatible||With hack only||Not tested||Not tested|
|Mac OS X 10.5 (Leopard)||Compatible||Compatible||Compatible||Compatible||Compatible||Compatible||Compatible||Not tested||Not tested|
|Mac OS X 10.6 (Snow Leopard)||Compatible||Compatible||Compatible||Compatible||Compatible||Compatible||Compatible||Compatible||Compatible|
|Mac OS X 10.7 (Lion)||Compatible||Compatible||Compatible||Compatible||Compatible||Compatible||Compatible||Compatible||Compatible|
|OS X 10.8 (Mountain Lion)||Compatible||Compatible||Compatible||Compatible||Compatible||Compatible||Compatible||Compatible||Compatible|
|OS X 10.9 (Mavericks)||Not tested||Not tested||Not tested||Not tested||Not tested||Not tested||Compatible*||Compatible*||Compatible*|
|OS X 10.10 (Yosemite)||Not tested||Not tested||Not tested||Not tested||Not tested||Not tested||Not tested||Not tested||Not tested|
|OS X 10.11 (El Capitan)||Not tested||Not tested||Not tested||Not tested||Not tested||Not tested||Not tested||Not tested||Not tested|
|macOS 10.12 (Sierra)||Not tested||Not tested||Not tested||Not tested||Not tested||Not tested||Not tested||Not tested||Not tested|
|macOS 10.13 (High Sierra)||Not tested||Not tested||Not tested||Not tested||Not tested||Not tested||Not tested||Not tested||Not tested|
|macOS 10.14 (Mojave)||Not tested||Not tested||Not tested||Not tested||Not tested||Not tested||Not tested||Not tested||Not tested|
|macOS 10.15 (Catalina)||Not tested||Not tested||Not tested||Not tested||Not tested||Not tested||Not tested||Not tested||Not tested|
|Lazarus 1.2.2||Lazarus 1.2.4||Lazarus 1.2.6||Lazarus 1.4.0||Lazarus 1.4.2||Lazarus 1.4.4||Lazarus 1.6.0||Lazarus 1.6.2||Lazarus 1.6.4||Lazarus 1.8.x||Lazarus 2.0.y|
|FPC 2.6.4||FPC 3.0.0||FPC 3.0.2||FPC 3.0.4||FPC 3.0.4|
|Mac OS X 10.4 (Tiger)||Compatible||N/A||Compatible||Incompatible||Incompatible||Incompatible||Incompatible||Incompatible||Incompatible||Incompatible||Incompatible|
|Mac OS X 10.5 (Leopard)||Compatible||Compatible**||Compatible||Compatible**||Compatible**||Compatible**||Not tested||Not tested||Not tested||Not tested||Incompatible|
|Mac OS X 10.4 (Tiger)||Not tested||Not tested||Not tested||Incompatible||Incompatible||Incompatible||Incompatible||Incompatible||Incompatible||Incompatible||Incompatible|
|Mac OS X 10.5 (Leopard)||Compatible||Not tested||Not tested||Not tested||Not tested||Not tested||Not tested||Not tested||Not tested||Not tested||Not tested|
|Mac OS X 10.6 (Snow Leopard)||Compatible||Compatible||Compatible||Compatible||Compatible||Compatible||Compatible||Compatible||Compatible||Compatible*||Not tested|
|Mac OS X 10.7 (Lion)||Compatible||Compatible||Compatible||Not tested||Not tested||Not tested||Compatible||Compatible||Compatible||Not tested||Not tested|
|OS X 10.8 (Mountain Lion)||Compatible||Compatible||Compatible||Compatible*||Compatible*||Compatible*||Compatible*||Compatible*||Compatible*||Not tested||Not tested|
|OS X 10.9 (Mavericks)||Compatible*||Compatible*||Compatible*||Compatible*||Compatible*||Compatible*||Compatible*||Compatible*||Compatible*||Not tested||Not tested|
|OS X 10.10 (Yosemite)||Not tested||Not tested||Compatible*||Compatible*||Compatible*||Compatible*||Compatible*||Compatible*||Compatible*||Not tested||Not tested|
|OS X 10.11 (El Capitan)||Not tested||Not tested||Not tested||Not tested||Not tested||Compatible*||Compatible*||Compatible*||Compatible*||Not tested||Not tested|
|macOS 10.12 (Sierra)||Not tested||Not tested||Not tested||Not tested||Not tested||Not tested||Compatible*||Compatible*||Compatible*||Compatible*||Compatible***|
|macOS 10.13 (High Sierra)||Not tested||Not tested||Not tested||Not tested||Not tested||Not tested||Not tested||Not tested||Not tested||Not tested||
|macOS 10.14 (Mojave)||Not tested||Not tested||Not tested||Not tested||Not tested||Not tested||Not tested||Not tested||Not tested||Not tested||Compatible***|
|macOS 10.15 (Catalina)||Not tested||Not tested||Not tested||Not tested||Not tested||Not tested||Not tested||Not tested||Not tested||Not tested||Compatible#|
** Not available as pre-built installer. Compiling from source required.
*** LLDB debugger required.
# Download files from here.
x = 0, 2 or 4; y = 0 or 2
Cocoa 64 bit vs Carbon 32 bit
Lazarus using the Apple 64 bit Cocoa framework will meet the needs of many users. The Apple 32 bit Carbon framework works pretty much as expected but you are advised to try Cocoa first, because Apple has dropped support for 32 bit applications and the Carbon framework from macOS 10.15 Catalina which was released in October 2019.
Alternatives include QT and GTK2+, both requiring additional libraries and GTK2+ on the Mac appears to get little attention these days. QT on the Mac does have some strong supporters on the Lazarus forum.
Cocoa is now undeniably the future on the Mac. It is possible to build an all Cocoa version of Lazarus with release 2.0.0 and later. It is also possible to make a Carbon install of Lazarus (unless you are running macOS 10.15 Catalina) and use that to generate Cocoa 64 bit binaries.
In the Carbon or Cocoa IDE, you need to set the Target to the 64 bit processor and select the Cocoa Widget set:
- Open your project with Lazarus and click Project/Project Options
- In the "Config and Target" panel set the "Target CPU family" to be "x86_64"
- In the "Additions and Overrides" panel click on "Set LCLWidgetType" pulldown and set the value to "Cocoa"
- For some reason Lazarus sets the compiler to "/usr/local/bin/ppc386" - which results in 32 bit apps. Make sure under Tools->Options that "Compiler Executable" is set to "/usr/local/bin/fpc" to get 64 bit apps.
- Now compile your project - and please feed back any problems you experience.
Download the sources via svn
The sources are kept in a version control system called subversion or short svn:
- 10.5 and higher already contains svn clients. Users of earlier versions must install SVN for macOS. You can also use fink. SVN clients with GUI (graphical user interface) are available from Versiontracker. A quite handy client, which integrates in Finder, is SCPlugin.
Create a directory, where you would like to put the sources. You don't need to be root to do this. Any normal user can do this. First create a directory for fpc
- (e.g. /Users/username/freepascal)
then open a terminal and do the following:
$ svn co http://svn.freepascal.org/svn/fpc/trunk fpc
This will create a directory called 'fpc', which can be later used in the IDE. Hint: To download/update the latest changes you can simply do
$ cd /Users/username/freepascal/fpc $ svn up
$ make clean all $ sudo make install
Then download Lazarus
$ svn co http://svn.freepascal.org/svn/lazarus/trunk lazarus
This will create a directory called 'lazarus'.
To update the latest changes:
$ cd /Users/username/freepascal/lazarus $ svn up
Building Lazarus (Cocoa 64 bit version)
$ make clean LCL_PLATFORM=cocoa CPU_TARGET=x86_64 bigide
Building Lazarus (Carbon 32 bit version)
$ make clean bigide
Then start lazarus either via command line (or by double click in the finder):
$ open lazarus.app
Download stable sources
Source code of stable versions is available in the Lazarus Zip - GZip archives. This is e.g. an option for users, who want to run the latest official Lazarus versions on "unsupported" machines, e.g. PPC-based Macs. Provided that you have installed the latest stable FPC version together with sources, it is sufficient to download and unpack the zip archive. Move it to the desired location (e.g. your /Developer folder), open a terminal window and change the shell's path to this folder (the easiest way to do this is to type "cd " and then to drag the icon of the freshly unpacked Lazarus folder to the position after this command in the Terminal window). If necessary enter <return> and then
$ make clean bigide
and <return> again. Subsequently, FreePascal will use the makefile in this folder to build the Lazarus IDE. This may take a few minutes, but the process is fully automated. Therefore, you might want to look for a cup of coffee, while FPC is working. If the compiler is ready it prints the number of processed lines and the required time to the shell's output.
The last step is to right-klick on the Lazarus bundle icon and to select "Show Package Contents" from the context menu. Then drag the executable "lazarus" to the folder "Contents/MacOS" of the bundle. That's it.
As of the Lazarus 2.0.0 release this is entirely optional. The IDE now supports LLDB directly. See http://forum.lazarus-ide.org/index.php/topic,42869.0.html and http://wiki.lazarus.freepascal.org/Lazarus_2.0.0_release_notes#LLDB_based_Debugger_.28New.29
Getting gdb to run can be a bit tedious but is worthwhile in the end if using Lazarus < V2.0 or have some specific requirement for gdb. You probably don't !
This step should be done after installing XCode and before installing FPC/Lazarus.
- Install fink or brew and use them to install gdb- http://wiki.freepascal.org/GDB_on_OS_X_Mavericks_and_Xcode_5
- Self sign the gdb binary using tools already on your Mac - https://sourceware.org/gdb/wiki/BuildingOnDarwin This is the tedious part. The instructions are clear except, perhaps they could have mentioned that after you have set the Keychain to ’System’ you need click ‘Create’ and ‘Done’ on the next screen. Then go and find the cert in your overall list of certs to do the next instruction “using the contextual menu…”. Don’t worry about step “2.1.4 Disable starting the debuggee…”, we’ll address that once Lazarus itself is installed and working.
- Once Lazarus is installed and fired up, tell it how it should start gdb, that is step 5.
Note that as of April 2018, there may be issues with newest gdb and High Sierra. https://forum.lazarus.freepascal.org/index.php/topic,40874.0.html According to https://stackoverflow.com/questions/49001329/gdb-doesnt-work-on-macos-high-sierra-10-13-3, gdb 8.1 does not work on High Sierra, but 8.0.1 does.
Part 2 of gdb install, Tell Lazarus about starting gdb
Again, this step is not necessary with Lazarus V2.0 and Later. See http://wiki.lazarus.freepascal.org/Lazarus_2.0.0_release_notes#LLDB_based_Debugger_.28New.29 If you do install (and use) gdb, you must tell Lazarus about how to call gdb. Obviously, this step happens after Lazarus is installed.
OK, now you should be able to start Lazarus, it should display the various parts and paths it needs (including gdb) in the little opening screen. You will get an alert there if you chose to not use a debugger. Proceed to the IDE and we now need to tell Lazarus to tell gdb to not open a shell, as noted by a number of Forum people (http://forum.lazarus.freepascal.org/index.php/topic,37310.0.html). Within Lazarus, click Tools->Options->Debugger->General In the “Debugger specific Options” there is a field labeled Debugger_Startup_Options. Type in "--eval-command=set startup-with-shell off" (including the inverted commas) AND press the return key, click OK. Note you cannot copy and paste into this box (##$!). See screen shot.
Information relating to older versions of FPC, Lazarus and Apple Developer Tools
Compatibility with Xcode 5.0 and newer versions (Mac OS X 10.8, 10.9, 10.10 and 10.11)
Like Xcode 4.3+, Xcode 5 and subsequent versions no longer install the command line tools by default. These are required by FPC/Lazarus, however. Unlike in Xcode 4 the installation option is no longer accessible in Xcode 5 via the Downloads tab. Additionally, the "Locations" tab of the preferences dialog may be confusing, as it mentions that the command line tools are installed:
The first dialog box shows that by default the command line tools are only installed inside the Xcode.app bundle itself. To install them globally, as required by FPC/Lazarus, execute the following terminal command:
Depending from your Xcode version alternative steps to install the command line developer tools may be to download them directly in the Xcode preferences window (see screenshots above) or to download them from developer.apple.com (please take care to install the command line tools that are correct exactly for your Xcode version).
- You can compile and install the normal gdb. See GDB on OS X Mavericks and Xcode 5.
Xcode 4.3+ compatibility (Mac OS X 10.7/10.8)
Xcode 4.3 and later no longer install the command line tools by default. These are required by FPC/Lazarus.
To install them manually, open Xcode, go to Preferences, select "Downloads;" and install the "Command Line Tools". Afterwards, FPC will install and function correctly.
It will be necessary to reinstall the command line tools after each upgrade of Xcode (especially when it's a new major version, the installer may delete the old copies of the command line tools), and also after switching to a new major version of the system software (idem). You may also download the command line tools from Apple Developer.
Xcode 3.2.x compatibility (Mac OS X 10.6)
FPC 2.6.0: there is an issue when compiling dynamic libraries with FPC under Mac OS X 10.6 due to a bug in the Xcode 3.2.x linker. This bug has been fixed in Xcode 4. You can work around the bug in Xcode 3.2.x by using the -k-no_order_inits command line parameter when compiling a dynamic library.
Xcode 3.1.x compatibility (Mac OS X 10.5)
Most versions of Lazarus and FPC are compatible with Xcode 3.1 (see the compatibility matrix for detailed reference). The Xcode integration kit is provided as an optional install to allow for developing with Free Pascal directly from Xcode. It is not required for development with Lazarus, however.
Xcode 2.x compatibility (Mac OS X 10.4)
Most versions of Lazarus and FPC are compatible with Xcode 2.3 or newer (see the compatibility matrix for detailled reference). The Xcode integration kit is provided as an optional install to allow for developing with Free Pascal directly from Xcode. It is not required for development with Lazarus, however. Xcode 2.0 was compatible with Lazarus 0.9.x, but it is no longer supported by newer versions of the Lazarus IDE.
Install Packages / Released version
Installation from disk images
Download the three disk images (.dmg files) for fpc, fpcsrc and lazarus from either of the following links:
Open up each disk image and install in this order:
After installation the Lazarus application can be found in /Developer/lazarus/, the FPC source files in /usr/local/share/fpcsrc.
If you receive a "Can't find unit Interfaces used by Project1" error on trying to compile a blank form, check the following settings in Lazarus (should be set by default):
Lazarus directory: /Developer/lazarus Compiler path: /usr/local/bin/ppc386 (PowerPC Macs: /usr/local/bin/ppcppc) FPC Source: /usr/local/share/fpcsrc
Project | Options
All paths blank LCL Widget Type: default (Carbon beta)
Project | Inspector
Required Packages LCL
Note - different versions of Lazarus depend on particular versions of the FreePascal compiler and will not work with other versions.
Another common problem is that the versions of fpc and fpcsrc are different.
This is the easiest way to install Lazarus on Mac OS X.
Install from Source / Development version
You need the latest stable released FPC installed in order to compile the development version.
Download and install a compiler
Download and install the FPC package: https://sourceforge.net/project/showfiles.php?group_id=89339
There are two development versions of the compiler: 2.6.x is stable version without new features - only bug fixes. The unstable version 2.7.x comes with lots of new features but sometimes also with bugs. Best is to download and install fpc 2.6.x. Some daily snapshots can be found here. Keep in mind that these are daily snapshots and that you can have bad luck and get a buggy version. The probability is about 1:30. So if the version is buggy try another day or use the released packages instead.
Uninstalling Lazarus and Free Pascal
Installed using fink
The complete uninstall of all fpc and lazarus packages is done with:
fink purge --recursive fpc-config
If you want to preserve changes to the preference file /sw/etc/fpc.cfg, do:
fink remove --recursive fpc-config
For the removal of the Lazarus preference folder and files in your home directory, see below ( Lazarus preference folder).
Installed from disk images or sources
Normally you uninstall an application on OS X simply by dragging it from the Applications folder to the trash. But because Lazarus and Free Pascal are development tools, they're installed in several folders that you don't normally see in Finder.
You can copy and save the commands below to file uninstallLaz.sh and run it if you need to uninstall Lazarus and Free Pascal. You can usually install newer versions of Lazarus and Free Pascal over older versions, but as with most software it's not a bad idea to clean out everything before you install a newer version. This list of commands should also give you a sense of where the various pieces of Lazarus and Free Pascal are located.
bin=/usr/local/bin share=/usr/local/share lib=/usr/local/lib receipts=/Library/Receipts private=/private/etc rm -fv $bin/ppcppc rm -fv $bin/ppc386 rm -fv $bin/bin2obj rm -fv $bin/data2inc rm -fv $bin/delp rm -fv $bin/fd2pascal rm -fv $bin/fpc rm -fv $bin/fpcmake rm -fv $bin/fpcmkcfg rm -fv $bin/fpcsubst rm -fv $bin/fpdoc rm -fv $bin/fprcp rm -fv $bin/h2pas rm -fv $bin/h2paspp rm -fv $bin/makeskel rm -fv $bin/mkxmlrpc rm -fv $bin/plex rm -fv $bin/postw32 rm -fv $bin/ppdep rm -fv $bin/ppudump rm -fv $bin/ppufiles rm -fv $bin/ppumove rm -fv $bin/ptop rm -fv $bin/pyacc rm -fv $bin/rstconv rm -fv $bin/unitdiff rm -r $private/lazarus rm -r $bin/lazarus rm -r $share/lazarus rm -r $share/fpcsrc rm -r $share/doc/fpc-2.2.2 rm -r $share/examples/fpc-2.2.2 rm -r $lib/fpc rm -r $receipts/lazarus-*.pkg rm -r $receipts/fpcsrc-*.pkg rm -r $receipts/fpc-*.pkg rm -fv /etc/fpc.cfg
Note that this assumes you have version 2.2.2 snapshot of Free Pascal installed. If you have a different version, change the two relevant commands to specify your version.
To run this script, change to the directory where it's stored and enter:
chmod +x uninstallLaz.sh sudo ./uninstallLaz.sh
Then enter your password when prompted.
Lazarus preference folder .lazarus in the home directory
Note: Lazarus also creates a .lazarus folder in your home directory where it stores environment settings and a list of recently opened projects and files. You can leave this folder alone if you want the new version of Lazarus you're installing to use your old settings. macOS normally doesn't show files or folders whose names start with a dot (.). To see this folder and its contents, enter the following in a terminal window:
cd ~/ ls -al cd .lazarus ls
To remove it, execute the following commands:
cd ~/ rm -rv .lazarus
- FPC 2.4.4 has a bug. You can not compile the IDE with the range check flag -Cr.
- On OS X 10.4 you have to manually uninstall any previous version before installing a new dmg. Delete the following files and folders:
- If installing FPC on macOS Mojave (10.14) with an FPC Installer before v3.0.4a you need to also manually install the SDK headers.
- open /Library/Developer/CommandLineTools/Packages/macOS_SDK_headers_for_macOS_10.14.pkg
Upgrading from Mojave (10.14) to Catalina (10.15)
- run "xcode-select --install"
- to find the crt1.10.5 change in /etc/fpc.cfg the -Fl behind "#ifdef cpux86_64" from
- Lazarus known issues (things that will never be fixed) - A list of interface compatibility issues
- Win32/64 Interface - The winapi interface for Windows 95/98/Me/2K/XP/Vista, but not CE
- Windows CE Interface - For Pocket PC and Smartphones
- Carbon Interface - The Carbon interface for macOS
- Cocoa Interface - The Cocoa interface for macOS
- Qt Interface - The Qt4 interface for Unixes, macOS, Windows, and Linux-based PDAs
- Qt5 Interface - The Qt5 interface for Unixes, macOS, Windows, and Linux-based PDAs
- GTK1 Interface - The gtk1 interface for Unixes, macOS (X11), Windows
- GTK2 Interface - The gtk2 interface for Unixes, macOS (X11), Windows
- GTK3 Interface - The gtk3 interface for Unixes, macOS (X11), Windows
- fpGUI Interface - Based on the fpGUI library, which is a cross-platform toolkit completely written in Object Pascal
- Custom Drawn Interface - A cross-platform LCL backend written completely in Object Pascal inside Lazarus. The Lazarus interface to Android.
Platform specific Tips
- Android Programming - For Android smartphones and tablets
- iPhone/iPod development - About using Objective Pascal to develop iOS applications
- FreeBSD Programming Tips - FreeBSD programming tips
- Linux Programming Tips - How to execute particular programming tasks in Linux
- macOS Programming Tips - Lazarus tips, useful tools, Unix commands, and more...
- WinCE Programming Tips - Using the telephone API, sending SMSes, and more...
- Windows Programming Tips - Desktop Windows programming tips
Interfaces Development Articles
- Carbon interface internals - If you want to help improving the Carbon interface
- Windows CE Development Notes - For Pocket PC and Smartphones
- Adding a new interface - How to add a new widget set interface
- LCL Defines - Choosing the right options to recompile LCL
- LCL Internals - Some info about the inner workings of the LCL
- Cocoa Internals - Some info about the inner workings of the Cocoa widgetset