fpcupdeluxe: what changed
Revision 3 to 4. Removed lines have a minus sign; added lines have a plus sign.
| Old | New | Line | |
|---|---|---|---|
| 1 | - | ||
| 2 | - | ||
| 3 | - | ||
| 4 | - | ||
| 5 | - | ||
| 1 | + | **FPCUPdeluxe** is a GUI installer for FPC and Lazarus. It's based on [[fpcup]]. | |
| 6 | 2 | ||
| 7 | - | ||
| 8 | - | ||
| 9 | - | ||
| 3 | + | * [GitHub repository](<https://github.com/LongDirtyAnimAlf/fpcupdeluxe>) | |
| 4 | + | * [Latest releases on GitHub](<https://github.com/LongDirtyAnimAlf/fpcupdeluxe/releases/latest>) | |
| 5 | + | * [Lazarus Forum Topic](<https://forum.lazarus.freepascal.org/index.php/topic,34645.0.html>) | |
| 10 | 6 | ||
| 11 | 7 | ## Installation of FPC and Lazarus | |
| 12 | 8 | ||
| 13 | - | ||
| 14 | - | ||
| 15 | - | ||
| 9 | + | The main purpose of fpcdeluxe is to provide a means for installing and updating multiple versions of FPC and Lazarus in a self-contained manner. Self-contained meaning that an install by fpcupdeluxe will have no influence on (interference with) your system: Hence you can install multiple versions of FPC and Lazarus. | |
| 16 | 10 | ||
| 17 | - | ||
| 11 | + | In order to have the installation working **you MUST use the generated link to start the install** ! | |
| 18 | 12 | ||
| 19 | - | ||
| 13 | + | That launcher link contains a line like: | |
| 14 | + | ``` | |
| 20 | 15 | Exec=/P/s/lazarus/lazarus --pcp="/P/s/config_lazarus" | |
| 21 | 16 | ``` | |
| 22 | 17 | ||
| 23 | - | ||
| 18 | + | directing Lazarus to use the [[pcp]] , i.e. **primary configuration** setting **path** of "/P/s/config_lazarus" or a similar subdir under /home/ depending on you choice made from the GUI. No fpc or anything is required in the searchpath. | |
| 24 | 19 | ||
| 25 | 20 | ### Prerequisites | |
| 26 | 21 | ||
| 27 | 22 | #### Debian, Raspbian, Mint gtk2 | |
| 28 | 23 | ||
| 29 | - | ||
| 24 | + | actual working with Debian Buster and Raspbian Buster | |
| 25 | + | ``` | |
| 26 | + | #!/bin/bash | |
| 27 | + | sudo apt-get update | |
| 28 | + | sudo apt-get upgrade | |
| 29 | + | ||
| 30 | + | # Missing Packages | |
| 31 | + | sudo apt-get install libx11-dev | |
| 32 | + | sudo apt-get install libgdk-pixbuf2.0-dev | |
| 33 | + | sudo apt-get install libpango1.0-dev | |
| 34 | + | sudo apt-get install libgtk2.0-dev | |
| 35 | + | ||
| 36 | + | # if gdb is not installed (eg. Lubuntu) | |
| 37 | + | sudo apt-get install gdb | |
| 38 | + | ||
| 39 | + | # GIT is the new SVN | |
| 40 | + | sudo apt-get install git | |
| 41 | + | ``` | |
| 30 | 42 | ||
| 31 | - | ||
| 43 | + | #### Debian qt5 | |
| 44 | + | ``` | |
| 32 | 45 | #!/bin/bash | |
| 33 | - | ||
| 34 | - | ||
| 46 | + | sudo apt-get update | |
| 47 | + | sudo apt-get upgrade | |
| 48 | + | ||
| 49 | + | # Missing Packages | |
| 50 | + | sudo apt install libqt5pas-dev | |
| 51 | + | ||
| 52 | + | # GIT is the new SVN | |
| 53 | + | sudo apt-get install git | |
| 54 | + | ``` | |
| 35 | 55 | ||
| 36 | - | ||
| 37 | - | ||
| 38 | - | ||
| 39 | - | ||
| 40 | - | ||
| 56 | + | See [[Qt5 Interface|Qt5_Interface#Linux]] | |
| 41 | 57 | ||
| 42 | - | ||
| 43 | - | ||
| 58 | + | #### ALT Linux Sisyphus | |
| 44 | 59 | ||
| 45 | - | ||
| 46 | - | ||
| 60 | + | Actual working with Alt Linux p11. | |
| 47 | 61 | ``` | |
| 48 | - | ||
| 49 | - | ||
| 50 | - | ||
| 51 | - | ||
| 52 | 62 | #!/bin/bash | |
| 53 | - | ||
| 54 | - | ||
| 55 | - | ||
| 56 | - | ||
| 57 | - | ||
| 63 | + | sudo apt-get update | |
| 64 | + | sudo apt-get dist-upgrade | |
| 65 | + | ||
| 66 | + | # Missing Packages | |
| 67 | + | sudo apt-get install libX11-devel | |
| 68 | + | sudo apt-get install libgdk-pixbuf-devel | |
| 69 | + | sudo apt-get install libpango-devel | |
| 70 | + | sudo apt-get install libgtk+2-devel | |
| 71 | + | ||
| 72 | + | # gdb | |
| 73 | + | sudo apt-get install gdb | |
| 74 | + | ||
| 75 | + | # GIT | |
| 76 | + | sudo apt-get install git | |
| 77 | + | ``` | |
| 58 | 78 | ||
| 59 | - | ||
| 60 | - | ||
| 79 | + | In one line | |
| 61 | 80 | ``` | |
| 81 | + | #!/bin/bash | |
| 82 | + | sudo apt-get update && apt-get dist-upgrade | |
| 83 | + | ||
| 84 | + | # Missing Packages | |
| 85 | + | sudo apt-get install libX11-devel libgdk-pixbuf-devel libpango-devel libgtk+2-devel gdb git | |
| 86 | + | ``` | |
| 62 | 87 | ||
| 63 | - | ||
| 88 | + | For p10, there is no default binutils required for the assembler. So you need to install this package: | |
| 89 | + | ``` | |
| 90 | + | sudo apt-get install binutils | |
| 91 | + | ``` | |
| 64 | 92 | ||
| 65 | 93 | #### Raspbian on RPi2 | |
| 66 | 94 | ||
| 67 | 95 | You need to extend the swap see [[Lazarus on Raspberry Pi]] | |
| 68 | 96 | ||
| 69 | 97 | ## Advanced settings | |
| 70 | 98 | ||
| 71 | - | ||
| 99 | + | [](</File:fpcupdeluxe_advanced.png>) | |
| 72 | 100 | ||
| 73 | - | ||
| 101 | + | [](</File:fpcupdeluxe_advanced.png> "Увеличить") | |
| 74 | 102 | ||
| 75 | - | ||
| 103 | + | FPCUPdeluxe advanced settings screen | |
| 76 | 104 | ||
| 77 | - | ||
| 78 | - | ||
| 105 | + | The above screenshot (click Setup+ on mainscreen) shows the advanced settings of FPCUPdeluxe. | |
| 79 | 106 | ||
| 107 | + | Some examples of advanced settings: | |
| 108 | + | ||
| 109 | + | * for debugging FPC itself, add "-g -gl -O-" into the "FPC options" field. | |
| 110 | + | * to apply a fix for FreeBSD x64 cross-compiler (which fixes FileExists/DirectoryExists functions on FreeBSD 12), press "Add FPC patch" and browse for relevant patch file. | |
| 111 | + | ||
| 80 | 112 | ## Cross-compiling | |
| 81 | 113 | ||
| 82 | - | ||
| 114 | + | FPCUPdeluxe makes cross-compiling easy: activate "cross" UI tab, select a CPU and an OS, and press "Install compiler". If libraries and/or binary tools are needed, fpcupdeluxe will try to get them online. | |
| 83 | 115 | ||
| 84 | - | ||
| 116 | + | Use the link to see what is available at the moment: | |
| 85 | 117 | ||
| 86 | - | ||
| 87 | - | ||
| 88 | - | ||
| 89 | - | ||
| 118 | + | * [Linux 64bit binary toolchains](<https://github.com/newpascal/fpcupdeluxe/releases/tag/linuxx64crossbins_v1.0>) | |
| 119 | + | * [Linux 32bit binary toolchains](<https://github.com/newpascal/fpcupdeluxe/releases/tag/linuxi386crossbins_v1.0>) | |
| 120 | + | * [Windows binary toolchains](<https://github.com/newpascal/fpcupdeluxe/releases/tag/wincrossbins_v1.0>) | |
| 121 | + | * [System libraries](<https://github.com/newpascal/fpcupdeluxe/releases/tag/crosslibs_v1.0>) | |
| 90 | 122 | ||
| 91 | 123 | ### Cross-compiling from Windows and Linux towards Darwin: the hard way | |
| 92 | 124 | ||
| 93 | - | ||
| 125 | + | With the help of fpcupdeluxe, NewPascal or FPC trunk, and a toolset called osxcross/cctools-port, you can crosscompile towards Darwin. This help will concentrate on manually setting up crossing from Windows/Linux towards Darwin (fpcupdeluxe can also do all the auto-magic for you for crossing towards Darwin; see above). | |
| 94 | 126 | ||
| 95 | - | ||
| 127 | + | First, you will need to get osxcross/cctools-port, and compile it yourself. | |
| 96 | 128 | ||
| 97 | - | ||
| 98 | - | ||
| 99 | - | ||
| 100 | - | ||
| 129 | + | * [osxcross original](<https://github.com/tpoechtrager/osxcross>) | |
| 130 | + | [osxcross for FPC](<https://github.com/LongDirtyAnimAlf/osxcross>) | |
| 131 | + | * [cctools-port original](<https://github.com/tpoechtrager/cctools-port>) | |
| 132 | + | [cctools-port for FPC](<https://github.com/LongDirtyAnimAlf/cctools-port>) | |
| 101 | 133 | ||
| 102 | - | ||
| 134 | + | For macOS, you will need the [osxcross for FPC](<https://github.com/LongDirtyAnimAlf/osxcross>) that has been adapted for use by FPC. | |
| 103 | 135 | ||
| 104 | - | ||
| 136 | + | For iOS/iPhone, you will need the [cctools-port for FPC](<https://github.com/LongDirtyAnimAlf/cctools-port>) that has been adapted for use by FPC. | |
| 105 | 137 | ||
| 106 | - | ||
| 138 | + | Get yourself a SDK, either from your own Mac, or from online sources: [Various Mac SDK's](<https://github.com/phracker/MacOSX-SDKs/releases>) | |
| 107 | 139 | ||
| 108 | - | ||
| 140 | + | SDKs for iPhone can also be obtained from online sources: [Various iPhone SDK's](<https://github.com/theos/sdks>) | |
| 109 | 141 | ||
| 110 | - | ||
| 142 | + | Build osxcross/cctools-port according to the instructions. For example, on Windows with Cygwin. | |
| 111 | 143 | ||
| 112 | - | ||
| 144 | + |  **Note:** Please note: to be able to cross from Windows towards Darwin, you need to have NewPascal or FPC trunk installed ! | |
| 113 | 145 | ||
| 114 | - | ||
| 146 | + | Use fpcupdeluxe to install NewPascal or FPC trunk. | |
| 115 | 147 | ||
| 116 | - | ||
| 148 | + | Before building the cross-compiler, you need to inform fpcupdeluxe where to find the Darwin libs (SDK) and the binary tools (build by osxcross/cctools-port). The two screenshot below show how to proceed: | |
| 117 | 149 | ||
| 118 | - | ||
| 150 | + | * Choose a CPU-type and an OS (Darwin). Select custom. You should now be able to use the buttons and point fpcupdeluxe to the right locations. | |
| 119 | 151 | ||
| 120 | - | ||
| 152 | + | [](</File:fpcupdeluxe_darwinlibs.JPG>) | |
| 121 | 153 | ||
| 122 | - | ||
| 123 | - | ||
| 154 | + | [](</File:fpcupdeluxe_darwinlibs.JPG> "Увеличить") | |
| 124 | 155 | ||
| 125 | - | ||
| 156 | + | Point fpcupdeluxe towards the library location | |
| 126 | 157 | ||
| 127 | - | ||
| 128 | - | ||
| 129 | - | ||
| 130 | - | ||
| 131 | - | ||
| 132 | - | ||
| 158 | + | [](</File:fpcupdeluxe_darwinbins.JPG>) | |
| 133 | 159 | ||
| 134 | - | ||
| 160 | + | [](</File:fpcupdeluxe_darwinbins.JPG> "Увеличить") | |
| 135 | 161 | ||
| 136 | - | ||
| 162 | + | Point fpcupdeluxe towards the binary tools location | |
| 137 | 163 | ||
| 138 | - | ||
| 139 | - | ||
| 140 | - | ||
| 141 | - | ||
| 164 | + | * Now, on the mainscreen, you can select your CPU and OS (Darwin) and build the cross-compiler ! | |
| 142 | 165 | ||
| 143 | - | ||
| 166 | + | * **Again, fpcupdeluxe also has pre-built tools for crossing towards Darwin: using the fpcupdeluxe-auto-magic will be the easiest !!!** | |
| 144 | 167 | ||
| 145 | - | ||
| 146 | - | ||
| 147 | - | ||
| 148 | - | ||
| 149 | - | ||
| 150 | - | ||
| 168 | + | ### Caveats, observations, troubleshooting | |
| 169 | + | ||
| 170 | + | * It was observed, that **f.** often times works on first run on an empty install dir, but subsequents runs, i.e. in order to add controls to the pallette, add the .chm [[help]] system asf., often times fail. In case of failure to recompile / [[make]] the IDE, the Lazarus binary may be gone, so unless you made a file backup earlier, you cannot start Lazarus anymore. | |
| 171 | + | * copy and save the logfile for reference / troubleshoot. | |
| 172 | + | * adding the [[help]] system is easy: just tag it under "advanced settings", saving some manual labour. | |
| 173 | + | * it takes about 10 minutes to make a full new install of fpc + Laz. | |
| 174 | + | * try out new --pcp settings to get a feeling for it, you can always delete the config and start anew (save the pristine fresh content of the --pcp dir right after install). | |
| 175 | + | * Sometimes, fpcupdeluxe hangs when it cannot download OpenSSL library. It's chicken-egg problem - OpenSSL is needed to download from https, so fpcupdeluxe cannot download OpenSSL without OpenSSL. Fpcupdeluxe has its strategy to overcome this, but sometimes it fails. Then, try this workaround - in fpcupdeluxe go to "Extras" tab and click on "get OpenSSL by browser", then unpack the downloaded file to fpcupdeluxe folder (where fpcupdeluxe.exe is located). Now, try again. | |
| 176 | + | ||
| 177 | + | ## Launching an installed Lazarus and fpc instance | |
| 178 | + | ||
| 179 | + | For launching the Lazarus GUI, a script is created (in the users home directory) and a launcher (on the desktop) which opens Lazarus with the correct config path & environment. Example, on Linux if installing to a folder named "/home/user/trunk", fpcupdeluxe creates: | |
| 151 | 180 | ``` | |
| 181 | + | /home/user/Desktop/Lazarus_trunk.desktop (launcher) | |
| 182 | + | /home/user/Lazarus_trunk (shell script) | |
| 183 | + | ``` | |
| 152 | 184 | ||
| 153 | - | ||
| 185 | + | For Linux FPC/lazbuild command line work the following shell script can be used (assumes a bash shell and using example install dir of "/home/user/trunk"): | |
| 186 | + | ``` | |
| 187 | + | #!/bin/sh | |
| 188 | + | # fpcupdeluxe: FPC home startlink script | |
| 189 | + | export PATH="/home/user/trunk/fpc/bin/x86_64-linux:/home/user/trunk/lazarus:${PATH}" | |
| 190 | + | export PPC_CONFIG_PATH="/home/user/trunk/fpc/bin/x86_64-linux" | |
| 191 | + | exec /bin/bash | |
| 192 | + | ``` | |
| 154 | 193 | ||
| 155 | - | ||
| 156 | - | ||
| 157 | - | ||
| 158 | - | ||
| 159 | - | ||
| 194 | + | Windows equivalent batch file for setting up environment for working from command line (using example install dir of "f:\trunk"): | |
| 160 | 195 | ``` | |
| 196 | + | REM fpcupdeluxe: FPC home startlink script | |
| 197 | + | SET PATH=F:\trunk\fpc\bin\x86_64-win64;F:\trunk\lazarus;%PATH% | |
| 198 | + | SET PPC_CONFIG_PATH=F:\trunk\fpc\bin\x86_64-win64 | |
| 199 | + | cmd.exe | |
| 200 | + | ``` | |
| 161 | 201 | ||
| 162 | - | ||
| 202 | + |  **Note:** Setting the paths this way is not global and only effects the current terminal shell and child shells. | |
| 163 | 203 | ||
| 164 | 204 | ## clang compilation error | |
| 165 | 205 | ||
| 166 | - | ||
| 167 | - | ||
| 168 | - | ||
| 206 | + | On compiling for macOS target on Linux, you can see this error: | |
| 207 | + | ``` | |
| 169 | 208 | clang: error: invalid version number in '-target arm64-apple-macosx11.0.0' | |
| 170 | 209 | ``` | |
| 171 | 210 | ||
| 172 | - | ||
| 211 | + | Usually it happens on old systems, e.g. Ubuntu 20.04. This is fixable. | |
| 173 | 212 | ||
| 174 | - | ||
| 175 | - | ||
| 213 | + | * Install package "clang-12" in package manager | |
| 214 | + | * Go to /usr/bin and see all clang* symlinks. "clang" is symlink to Clang-10, and "clang-12" is symlink to Clang-12. Adjust symlinks so that "clang" points to Clang-12. | |
| 176 | 215 | ||
| 177 | - | ||
| 216 | + | ``` | |
| 217 | + | user@PC:~$ ls -l /usr/bin/clang* | |
| 178 | 218 | lrwxrwxrwx 1 root root 24 ноя 7 22:00 /usr/bin/clang -> ../lib/llvm-12/bin/clang | |
| 179 | 219 | lrwxrwxrwx 1 root root 26 мар 20 2020 /usr/bin/clang++ -> ../lib/llvm-10/bin/clang++ | |
| 180 | 220 | lrwxrwxrwx 1 root root 26 апр 20 2020 /usr/bin/clang++-10 -> ../lib/llvm-10/bin/clang++ | |
| 181 | 221 | lrwxrwxrwx 1 root root 24 апр 20 2020 /usr/bin/clang-10 -> ../lib/llvm-10/bin/clang | |
| 182 | 222 | lrwxrwxrwx 1 root root 26 мар 8 2022 /usr/bin/clang++-12 -> ../lib/llvm-12/bin/clang++ | |
| 183 | 223 | lrwxrwxrwx 1 root root 24 мар 8 2022 /usr/bin/clang-12 -> ../lib/llvm-12/bin/clang | |
| 184 | 224 | lrwxrwxrwx 1 root root 28 апр 20 2020 /usr/bin/clang-cpp-10 -> ../lib/llvm-10/bin/clang-cpp | |
| 185 | 225 | lrwxrwxrwx 1 root root 28 мар 8 2022 /usr/bin/clang-cpp-12 -> ../lib/llvm-12/bin/clang-cpp | |
| 226 | + | ``` | |
| 186 | 227 | ||
| 187 | 228 | ## External links | |
| 188 | 229 | ||
| 189 | - | ||
| 190 | - | ||
| 191 | - | ||
| 192 | - | ||
| 193 | - | ||
| 230 | + | * See in depth guide for _BUILD / MAKE_ : [Build FAQ](<http://www.stack.nl/~marcov/buildfaq.pdf>) | |
| 231 | + | * [[fpcup|Fpcup by Reinier]] | |
| 232 | + | * [Fpcupdeluxe source](<https://github.com/newpascal/fpcupdeluxe>) | |
| 233 | + | * [Latest release](<https://github.com/newpascal/fpcupdeluxe/releases/latest>) | |
| 234 | + | * [NewPascal](<http://newpascal.org>) | |
| 194 | 235 | ||
| 195 | 236 | --- | |
| 196 | - | ||
| 237 | + | *From the Free Pascal wiki, page "fpcupdeluxe", as the Internet Archive kept it on 2025-04-28, last changed on 2024-12-28. 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).* |