Cross compiling for Win32 under Linux/it: what changed
Revision 3 to 4. Removed lines have a minus sign; added lines have a plus sign.
| Old | New | Line | |
|---|---|---|---|
| 1 | 1 | ## Suggerimenti per la Cross-Compilazione - creazione di binari per Win32 in ambiente Linux | |
| 2 | 2 | ||
| 3 | 3 | Dalla versione 0.9.10 esiste un rpm 'fpc-crosswin32', che installa i *binutils* necessari (p.e. cross assembler, cross linker), i file .ppu di fpc cross-compilati per win32 e modifica il file /etc/fpc.cfg. | |
| 4 | 4 | ||
| 5 | 5 | Tuttavia non include i file cross-compilati .ppu dell'LCL. É necessario che questi siano compilati dall'utente dopo l'installazione dell'fpc-crosswin32. | |
| 6 | 6 | ||
| 7 | 7 | ## Lazarus ed il Compilatore Free Pascal | |
| 8 | 8 | ||
| 9 | 9 | ### La Cross-compilazione - cosa bisogna sapere | |
| 10 | 10 | ||
| 11 | 11 | Questo è una breve introduzione per i novizi. | |
| 12 | 12 | ||
| 13 | 13 | La sezione seguente descrive come impostare il sistema per la cross-compilazione, in modo tale che lavori sotto linux e crei eseguibili per win32 (o freebsd o dawin, o ...). Perché usare la cross-compilazione: il FreePascal è un compilatore con l'obiettivo di convertire un programma sorgente in uno binario (in linguaggio macchina). Questi file binari contengono numerose informazioni, ad esempio la descrizione di come il sistema operativo deve avviare l'eseguibile. Nella maggior parte dei casi i file binari sono specifici per una determinata piattaforma e possono essere utilizzati solo sulla piattaforma per la quale sono stati scritti. | |
| 14 | 14 | ||
| 15 | 15 | Di per sé il FreePascal non richiede un setup complesso. Esso è in grado di creare binari per molte piattaforme. Ed in pratica può già farlo. Tuttavia il compilatore è solo una parte. Bisogna anche tener conto dell'assembler ed del linker. E purtroppo questi strumenti non sono in grado di creare direttamente codice multipiattaforma. Ecco è necessario far riferimento a linker 'ld' e assembler 'as' specifici per ciascuna piattaforma di destinazione. Fortunatamente, per risolvere tali problemi, è possibile ricorrere alle *binutils*. Dopo aver creato gli strumenti "cross", tutte le unit pascal di fpc saranno cross-compilate. Ad esempio, ci sarà un file system.ppu per ciascuna piattaforma di destinazione. Quindi sarà necessario settare il file di config dell'fpc, così che la compilazione multipiattaforma avvenga tanto facilmente da dimenticarsi tutti i noiosi dettagli. La stessa cosà dovrà essere fatta per l'LCL - la *lazarus component library*. Infine sarà possibile compilare programmi per win32 su Linux. Successivamente i programmi realizzati si potranno testare con wine, con una macchina virtuale o copiandoli direttamente su una macchina reale windows. | |
| 16 | 16 | ||
| 17 | 17 | ### Percé da *nix a windows e non viceversa. | |
| 18 | 18 | ||
| 19 | 19 | La ragione principale di ciò è che generare binari unix su una piattaforma estranea (un'altra unix o anche un'altra distribuzione Linux) è più complicato. Il linking statico è complicato di suo, maggiormente quello *shared*. | |
| 20 | 20 | ||
| 21 | 21 | You would need the used libraries from the target platform's (gtk, glib,libc etc), and a lot of additional configuring for ld. (library paths, dynlinker path etc) | |
| 22 | 22 | ||
| 23 | 23 | This has been partially done (for the static case), but it is hard since it needs manual postediting of linker files and linker commandline, and a deep understanding about what makes Unix binaries tick. | |
| 24 | 24 | ||
| 25 | 25 | ### Download del codice sorgente del FPC | |
| 26 | 26 | ||
| 27 | 27 | Per realizzare programmi multipiattaforma purtroppo i binari non sono sufficienti, è dunque necessario scaricare i sorgenti completi del fpc. Si veda www.freepascal.org. Per ottenere i sorgenti è possibile usare SVN o una [daily snapshot](http://www.hu.freepascal.org/lazarus/). | |
| 28 | 28 | ||
| 29 | 29 | Per gli esempi che seguono si suppone che i sorgenti siano stati scaricati nella cartella *~/sources/fpc*. | |
| 30 | 30 | ||
| 31 | 31 | ### Scaricare le gnu binutils. | |
| 32 | 32 | ||
| 33 | 33 | É possibile scaricare l'ultima versione delle binutils da [<http://ftp.gnu.org/gnu/binutils/>](http://ftp.gnu.org/gnu/binutils/)\ | |
| 34 | 34 | Supponiamo di scaricare le binutils-2.xx.tar.gz nella cartella *~/download/*. | |
| 35 | 35 | ||
| 36 | 36 | ### Cross build binutils | |
| 37 | 37 | ||
| 38 | 38 | Nel repository di fpcbuild c'é uno script per creare le binutils per tutte le piattaforme: install/cross/buildcrossbinutils Prima di procedere visitate [<http://svn.freepascal.org/svn/fpcbuild/branches/>](http://svn.freepascal.org/svn/fpcbuild/branches/) e individuate la versione di vostro interesse. | |
| 39 | 39 | ||
| 40 | 40 | Per scaricare la cartella install da fpcbuild: | |
| 41 | 41 | ||
| 42 | - | ||
| 43 | - | ||
| 42 | + | ```text | |
| 43 | + | []$ cd ~ | |
| 44 | + | []$ svn co http://svn.freepascal.org/svn/fpcbuild/branches/fixes_2_2/install install | |
| 45 | + | ``` | |
| 44 | 46 | ||
| 45 | 47 | (nota: verrà creata una nuova cartella *install* nella vostra home - la cartella NON deve esistere!) | |
| 46 | 48 | ||
| 47 | 49 | Creare una copia dello script: | |
| 48 | 50 | ||
| 49 | - | ||
| 50 | - | ||
| 51 | + | ```text | |
| 52 | + | []$ cd ~/install/cross/ | |
| 53 | + | []$ cp buildcrossbinutils buildcrossbinutils.sh | |
| 54 | + | ``` | |
| 51 | 55 | ||
| 52 | 56 | Modificare le variabili all'inizio dello script. | |
| 53 | 57 | ||
| 54 | 58 | La variabile BASE punta ad una directori di lavoro ed installazione. Essa dovrebbe essere vuota. Per esempio: | |
| 55 | 59 | ||
| 56 | - | ||
| 60 | + | ```text | |
| 61 | + | BASE=~/cross_fpc | |
| 62 | + | ``` | |
| 57 | 63 | ||
| 58 | 64 | Ora il file binutils scaricato. se per esempio è stato scaricato in ~/download/binutils-2.18.tar.gz allora impostare le variabili come segue | |
| 59 | 65 | ||
| 60 | - | ||
| 61 | - | ||
| 62 | - | ||
| 63 | - | ||
| 66 | + | ```text | |
| 67 | + | BINUTILSPATH=~/download/ | |
| 68 | + | BINUTILSBASE=binutils | |
| 69 | + | BINUTILSVERSION=2.18 | |
| 70 | + | BINUTILS_GZIP=yes | |
| 71 | + | ``` | |
| 64 | 72 | ||
| 65 | 73 | Lo script aggancerà questo automaticamente a ~/download/binutils-2.18.tar.gz. Le variabili restanti da modificare definizcono la piattaforma di destinazione desiderata. Per default verranno considerate tutti i sistemi operativi supportati, ma cò richiede molto tempo (anche alcune ore su macchine lente). Per compilazioni per Windows, è necessario solo | |
| 66 | 74 | ||
| 67 | - | ||
| 68 | - | ||
| 75 | + | ```text | |
| 76 | + | TARGETS_WIN="mingw32" | |
| 77 | + | ``` | |
| 69 | 78 | ||
| 70 | 79 | e possono essere commentate le altre righe: | |
| 71 | 80 | ||
| 72 | - | ||
| 73 | - | ||
| 74 | - | ||
| 75 | - | ||
| 76 | - | ||
| 77 | - | ||
| 81 | + | ```text | |
| 82 | + | #BSD="freebsd netbsd openbsd" | |
| 83 | + | #TARGETS_WIN="cygwin mingw32 msdosdjgpp" | |
| 84 | + | #TARGETS_I386="${BSD} linux solaris darwin" | |
| 85 | + | #TARGETS_POWERPC="${BSD} linux darwin" | |
| 86 | + | #TARGETS_SPARC="${BSD} linux solaris" | |
| 87 | + | #TARGETS_M68k= | |
| 88 | + | ``` | |
| 78 | 89 | ||
| 79 | 90 | Quindi lanciare lo script: | |
| 80 | 91 | ||
| 81 | - | ||
| 82 | - | ||
| 92 | + | ```text | |
| 93 | + | []$ sh buildcrossbinutils.sh | |
| 94 | + | ``` | |
| 83 | 95 | ||
| 84 | 96 | Lo script crea una sottocartella 'logs' contenente una serie di file di log. nel caso in cui ci dovessero essere errori partire osservando il contenuto di questi log. | |
| 85 | 97 | ||
| 86 | 98 | Si noti che per molte piattaforme (Linux,FreeBSD, win32) queste sono disponibili già in forma compilata. Si veda: <ftp://freepascal.stack.nl/pub/fpc/contrib/cross/> | |
| 87 | 99 | ||
| 88 | 100 | ### Cross build FPC | |
| 89 | 101 | ||
| 90 | 102 | Nel repositorio scaricato è presente uno script per costruire l'fpc snapshot per tutte le piattaforme: install/cross/buildcrosssnapshot Creare una copia dello script: | |
| 91 | 103 | ||
| 92 | - | ||
| 93 | - | ||
| 104 | + | ```text | |
| 105 | + | []$ cd ~/install/cross/ | |
| 106 | + | []$ cp buildcrosssnapshot buildcrosssnapshot.sh | |
| 107 | + | ``` | |
| 94 | 108 | ||
| 95 | 109 | Modificare le variabili all'inizio del nuovo script. | |
| 96 | 110 | ||
| 97 | 111 | Normalmente è sufficiente modificare almeno le seguenti: CROSSTOOLSROOT, FPCCVS, DESTDIR, TARGETS_OS e TARGETS_CPU. Ad esempio: | |
| 98 | 112 | ||
| 99 | - | ||
| 100 | - | ||
| 101 | - | ||
| 102 | - | ||
| 103 | - | ||
| 104 | - | ||
| 113 | + | ```text | |
| 114 | + | CROSSTOOLSROOT=~/cross_fpc/cross | |
| 115 | + | FPCCVS=~/sources/fpc | |
| 116 | + | TARGETS_OS="win32" | |
| 117 | + | TARGETS_CPU="i386" | |
| 118 | + | DESTDIR=~/cross_fpc/ | |
| 119 | + | ``` | |
| 105 | 120 | ||
| 106 | 121 | Lanciare lo script: | |
| 107 | 122 | ||
| 108 | - | ||
| 123 | + | ```text | |
| 124 | + | []$ sh buildcrosssnapshot.sh | |
| 125 | + | ``` | |
| 109 | 126 | ||
| 110 | 127 | Fatto ciò le unit compilate si troveranno in ~/cross_fpc/ | |
| 111 | 128 | ||
| 112 | 129 | ### Configure your fpc.cfg | |
| 113 | 130 | ||
| 114 | 131 | Aprire come root il file /etc/fpc.cfg o creare una copia di /etc/fpc.cfg in ~/fpc.cfg ed editare questo file. Cercare nel config le stringhe seguenti: | |
| 115 | 132 | ||
| 116 | 133 | Nota: Su versioni obsolete di \$version e \$target sono ustae al posto di \$fpcversion e \$fpctarget | |
| 117 | 134 | ||
| 118 | - | ||
| 119 | - | ||
| 120 | - | ||
| 135 | + | ```text | |
| 136 | + | -Fu/usr/lib/fpc/$fpcversion/units/$fpctarget | |
| 137 | + | -Fu/usr/lib/fpc/$fpcversion/units/$fpctarget/* | |
| 138 | + | -Fu/usr/lib/fpc/$fpcversion/units/$fpctarget/rtl | |
| 139 | + | ``` | |
| 121 | 140 | ||
| 122 | 141 | Rimpiazzarle con il seguente codice (l'esempio è riferito ad una piattaforma linux per compilazioni win32): | |
| 123 | 142 | ||
| 124 | - | ||
| 125 | - | ||
| 126 | - | ||
| 127 | - | ||
| 128 | - | ||
| 129 | - | ||
| 130 | - | ||
| 131 | - | ||
| 132 | - | ||
| 133 | - | ||
| 134 | - | ||
| 135 | - | ||
| 143 | + | ```text | |
| 144 | + | #IFDEF win32 | |
| 145 | + | -Fu~/cross_fpc/lib/fpc/$fpcversion/cross/units/i386-win32/ | |
| 146 | + | -Fu~/cross_fpc/lib/fpc/$fpcversion/cross/units/i386-win32/* | |
| 147 | + | -Fu~/cross_fpc/lib/fpc/$fpcversion/cross/units/i386-win32/rtl | |
| 148 | + | -XPi686-mingw32- | |
| 149 | + | -FD~/cross_fpc/cross/bin | |
| 150 | + | #ELSE linux | |
| 151 | + | -Fu/usr/lib/fpc/$fpcversion/units/$fpctarget | |
| 152 | + | -Fu/usr/lib/fpc/$fpcversion/units/$fpctarget/* | |
| 153 | + | -Fu/usr/lib/fpc/$fpcversion/units/$fpctarget/rtl | |
| 154 | + | #-Fu~/fpc/packages/*;~/fpc/rtl/linux | |
| 155 | + | #ENDIF | |
| 156 | + | ``` | |
| 136 | 157 | ||
| 137 | 158 | Infine: Testare e risolvere gli eventuali problemi | |
| 138 | 159 | ||
| 139 | 160 | ### Compilazione multipiattaforma dell'LCL e dei componenti lazarus | |
| 140 | 161 | ||
| 141 | 162 | Sulla linea di comando: | |
| 142 | 163 | ||
| 143 | - | ||
| 144 | - | ||
| 164 | + | ```text | |
| 165 | + | cd lazarus; make clean all OS_TARGET=win32 | |
| 166 | + | cd lazarus/lcl; make clean all | |
| 167 | + | ``` | |
| 145 | 168 | ||
| 146 | 169 | Questo compilerà tutti i file per win32 (incluso l'IDE, che non è necessario, ma questo semplifica il tutto) | |
| 147 | 170 | ||
| 148 | 171 | O nell'IDE: impostare LCL, Synedit, Codetools, Package Registration e IDE Interface a Clean+Build, impostare LCL interface a win32/win64 ed impostare 'Target OS' a win32. Quindi 'build lazarus'. | |
| 149 | 172 | ||
| 150 | 173 | These four parts have splitted output directories, so your linux .ppu/.o files are *not* overwritten and you don't need to recompile them. | |
| 151 | 174 | ||
| 152 | 175 | ### Cross compiling a project | |
| 153 | 176 | ||
| 154 | 177 | Set in Project-\>Compiler Options-\>Code the Target OS to 'win32' and in Paths the 'LCL Widget Type' to win32. That's all. The next time you build, you will create a win32 executable. The IDE will rescan for win32 units, so that 'Find declaration' and code completion features will now work with the win32 rtl instead of the linux rtl. When you open another project or reopen this project the IDE will automatically switch. | |
| 155 | 178 | ||
| 156 | 179 | ### Hints for Cross compiling and Lazarus | |
| 157 | 180 | ||
| 158 | 181 | If you create an application/package for multiple targets, you will often do the following: Fix a bug, compile and test it under linux, then compile and test it under win32, .. . Because normally you overwrite your .ppu files, you have to recompile everything, everytime you switch. This is not necessary. The Lazarus IDE supports macros. | |
| 159 | 182 | ||
| 160 | 183 | Example 1: Cross compiling a project for linux and win32. | |
| 161 | 184 | ||
| 162 | 185 | Set Project -\> Compiler Options -\> Paths -\> Unit Output directory to \$(TargetOS). This macro will be replaced by the value in Code -\> TargetOS in lowercase (i.e. "linux" for Linux and "win32" for Win32). The output directory is relative to your project directory (the directory where your .lpi is). Create a linux and win32 directory in your project directory. When you click on the "Show Options" button at the bottom of the compiler options, you will see a -FElinux/ or -FEwin32/. This option tells the compiler where to write the output (e.g. .ppu/.o files). | |
| 163 | 186 | ||
| 164 | 187 | Example 2: Cross compiling a project for various platforms and widget sets. | |
| 165 | 188 | ||
| 166 | 189 | Set the Unit output directory to \$(TargetCPU)/\$(TargetOS)/\$(LCLWidgetType) and create the sub directories for all targets. This path construction is also used by the LCL. | |
| 167 | 190 | ||
| 168 | 191 | The same can be done for packages. | |
| 169 | 192 | ||
| 170 | 193 | ### Cross compiling and Lazarus Packages | |
| 171 | 194 | ||
| 172 | 195 | Lazarus packages are not limited to libraries. They can be used to compile nearly everything. And the IDE automatically recompiles them if needed. Packages can inherit compiler options. For example: A project that uses a package inherits the output directory of the package. In other words: the output directory of the package is added to unit search path of the project. See in the IDE: Project -\> Compiler options -\> Inherited. Inheritance normally works only one way. But there are exceptions: The target platform (OS and CPU) of the project overrides the target for all used packages. That means, if you set the Target OS of the project to "win32" and compile the project, the IDE will check if the used packages need to be recompiled for this Target OS. | |
| 173 | 196 | ||
| 174 | 197 | For example: | |
| 175 | 198 | ||
| 176 | 199 | Package A has as output directory: lib/\$(TargetOS) Project uses A. | |
| 177 | 200 | ||
| 178 | 201 | 1. The project is built for linux. The IDE compiles A for linux in \<PackageDirOfA\>/lib/linux/, then it compiles the project for linux. | |
| 179 | 202 | 2. The project is built for win32. The IDE compiles A for win32 in \<PackageDirOfA\>/lib/win32/, then it compiles the project for win32. | |
| 180 | 203 | 3. The project is built again for linux. The IDE checks A for linux and does not recompile it. Then it compiles the project for linux. | |
| 181 | 204 | ||
| 182 | 205 | So, using the macros saves a lot of time. | |
| 183 | 206 | ||
| 184 | 207 | ## For Unix (general) | |
| 185 | 208 | ||
| 186 | 209 | Option -XLA is used to rename library dependencies specified in pascal units. Format is -XLAold=new, to modify ld link option -l\<old\> to -l\<new\>. | |
| 187 | 210 | ||
| 188 | 211 | Option -XR\<sysroot\> (recent trunk) that can be used to specify the target system root. It's used for: | |
| 189 | 212 | ||
| 190 | 213 | - adding a prefix to the default added library paths; in the past you used to specify -Xd and these paths manually. E.g. for i386-linux instead of passing /lib, /usr/lib, and /usr/X11R6/lib to ld, it will pass \<sysroot\>/lib, \<sysroot\>/usr/lib, and \<sysroot\>/usr/X11R6/lib to ld. | |
| 191 | 214 | - detecting the C library (linux specific): glibc or uclibc. E.g. for uclibc detection '\<sysroot\>/lib/ld-uClibc.so.0' is tried. | |
| 192 | 215 | ||
| 193 | 216 | ## Per Linux sotto Win32 | |
| 194 | 217 | ||
| 195 | 218 | É possibile reperire su tale argomento (meno importante del precedente) alcune informazioni nelle [[buildfaq]] | |
| 196 | 219 | ||
| 197 | 220 | ## FreeBSD to sparc | |
| 198 | 221 | ||
| 199 | 222 | I managed to crosscompile from x86 to Sparc Solaris 9. However the result doesn't work very well, but here is my cmdline: | |
| 200 | 223 | ||
| 201 | 224 | in compiler/ execute: | |
| 202 | 225 | ||
| 203 | - | ||
| 226 | + | ```text | |
| 227 | + | gmake cycle CPU_TARGET=sparc OS_TARGET=solaris CROSSBINUTILPREFIX=solaris-sparc- CROSSOPT='-Xd -Fl~/src/sollib' | |
| 228 | + | ``` | |
| 204 | 229 | ||
| 205 | 230 | ~/src/sollib is a directory that contains: | |
| 206 | 231 | ||
| 207 | 232 | - a set of .o's from /usr/local/gcc-3.3-32bit/lib/gcc-lib/sparc-sun-solaris/3.3 | |
| 208 | 233 | - libgcc.a from /usr/local/gcc-3.3-32bit/lib/gcc-lib/sparc-sun-solaris/3.3 | |
| 209 | 234 | - a set of lib*.so from /usr/lib: libaio.so libmd5.so libc.so libelf.so librt.so libdl.so libm.so | |
| 210 | 235 | ||
| 211 | 236 | Problem is illustrated by the following binary. | |
| 212 | 237 | ||
| 213 | - | ||
| 214 | - | ||
| 215 | - | ||
| 216 | - | ||
| 217 | - | ||
| 238 | + | ``` pascal | |
| 239 | + | Free Pascal Compiler version 2.1.1 [2006/03/17] for sparc | |
| 240 | + | Copyright (c) 1993-2005 by Florian Klaempfl | |
| 241 | + | Target OS: Solaris for SPARC | |
| 242 | + | Compiling system.pp | |
| 243 | + | system.pp(15,1) Fatal: Syntax error, "BEGIN" expected but "identifier UNIT" found | |
| 244 | + | ``` | |
| 218 | 245 | ||
| 219 | 246 | I suspect wrong .o's are taken. | |
| 220 | 247 | ||
| 221 | 248 | ## Per Mac OS X | |
| 222 | 249 | ||
| 223 | 250 | Si veda [forum post](http://www.lazarus.freepascal.org/index.php?name=PNphpBB2&file=viewtopic&p=7222#7222). | |
| 224 | 251 | ||
| 225 | 252 | ## Contributi Originali | |
| 226 | 253 | ||
| 227 | 254 | Questa pagina è una traduzione dall'inglese di [Cross compiling for Win32 under Linux](http://wiki.lazarus.freepascal.org/Cross_compiling_for_Windows_under_Linux). | |
| 228 | 255 | ||
| 229 | 256 | --- | |
| 230 | 257 | *From the Free Pascal wiki, page "Cross compiling for Win32 under Linux/it", as it stood on 2021-07-20 after a change by Dbannon, 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).* |