Cross compiling/zh TW: what changed

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

Old	New		Line
1	1		# 前言
2	2
3	3		這是一個為新手寫的簡短的引言。接下來的章節將說明如何設置你的系統以進行交叉編譯，這表示用一個電腦平臺編譯出用於不同平臺的可執行程式——例如，在Linux平臺上編譯出在win32平臺上的可執行程式（或者FreeBSD或Darwin等等）。既然這樣，這個運行編譯器的平臺通常被稱為“host”（上述的Linux就是個例子，在上述情況下，Linux就被稱為host），而那個你希望你編譯出的程式能得以運行的平臺就稱為“target”。Free Pascal是個編譯器，基本原理就是將源代碼翻譯成可執行檔（機器語言）。這些可執行檔通常也包含了指示作業系統如何開始執行這個檔的資訊（比如，入口點資訊，段資訊，重定位表等等）。再者可執行檔也可能提及特定系統上的APIs（應用程式介面）的資訊，那就是為什麼不同作業系統必須用不同實現的（但幾乎同樣的介面）運行時庫。因此，這些可執行檔是平臺相關的。Free Pascal本身並不需要什麼設置。它能夠為不同平臺編譯可執行檔。只需要告訴它要怎麼幹就行。
4	4
5	5		## host和target運行於同樣的CPU
6	6
7	7		FPC被設計以可以編譯出適用於某種CPU的機器語言（因為不同CPU需要不同的機器語言），它也知道所有的被支援的平臺（作業系統）上的，架構上的（CPU及其機器的體系結構）具體需要的，能用到的東西。這表示你可以用為運行於同一類CPU的不同程式使用同一個編譯器執行交叉編譯。
8	8
9	9		## host和target運行於不同的CPU
10	10
11	11		如果你要編譯出一個運行於不同CPU上的可執行檔，你需要一個特殊的交叉編譯器，例如，運行於一種平臺上的編譯器，能夠翻譯出不同的適用於不同CPU上的機器語言（就FPC來說，這樣一個交叉編譯器同樣能夠為所有支持的平臺和CPU架構編譯出適用的可執行檔）。因此這個交叉編譯器通常存放於同一個目錄內作為本機的編譯器。你可以自己編譯出這樣一個交叉編譯器，或者你可以直接使用由FPC團隊提供的已經為一些平臺完成的發佈版（這些平臺通常用於移動平臺，像arm-linux或者arm-wince，因為它們通常不會被作為host平臺）。當你使用了 -P 參數後，FPC程式就會target CPU架構選擇正確的編譯器（本機編譯器或者交叉編譯器之一）。
12	12
13	13		## 彙編器和連接器
14	14
15	15		編譯器只是一部分，我們需要彙編器和鏈結器。FPC僅僅為某些平臺提供內嵌的彙編器和鏈結器，其他平臺需要外部工具以提供支援。通常，這些工具不能夠為不同平臺編譯出二進位檔。那就是為什麼我們必須為每一個不同target平臺使用不同的鏈結器‘ld’和彙編器‘as’。它們是binutils。
16	16
17	17		## 用於target的單元
18	18
19	19		裝好了交叉編譯工具後（這樣的一個工具需要FPC RTL和其他為相應target平臺編譯好的單元檔）。例如，每種不同的target平臺需要不同的system.ppu檔（系統單元）等等。這些單元檔要麼是你自己為了target平臺編譯出來的，要麼可能是官方為某個版本的FPC編譯並發行的。
20	20
21	21		## 配置
22	22
23	23		你要設置你的FPC的配置檔，以使得交叉編譯變得容易，你可以忘記所有無聊的細節問題。對LCL（lazarus cpmponent library）也可以這樣做（如果你用Lazarus）。然後你就可以為不同的target編譯出Pascal程式了。編譯出的可執行檔就可以拷貝到一台運行target的機器上，或者在模擬器上運行（例如：wine，bochs，xbox，vmware等等）。
24	24
25	25		## 基本步驟
26	26
27	27		有一些交叉編譯時通常的步驟你必須做的：
28	28
29	29		1. 有一個可運行於你的host平臺的Free Pascal編譯器。
30	30		2. 你需要Free Pascal的源代碼。
31	31		3. 你要麼從源碼構建，要麼從別人那兒獲得運行你的host系統但卻是為target系統設計的cross-binutils可執行檔。
32	32		4. 有時，你需要一些target上的檔。
33	33
34	34		# 從Linux
35	35
36	36		## 到Linux
37	37
38	38		事先說明，以下文字說的是在linux（x86_64）上編譯出linux（i386）程式。關於以運行於ARM的Linux為目標的編譯（例如：Zaurus）應該可以在[[Setup Cross Compile For ARM\|設置編譯器為ARM編譯程序]]找到。
39	39
40	40		如果你的64位的Linux發行版已經可以編譯32位元程式，那麼事情就好辦了。由於FPC的設計的緣故，你還得做兩件事。
41	41
42	42		- 首先檢查你是否擁有兩個檔：i386-linux-ld和i386-linux-as：
43	43
44		-	~~` bash $ which i386-linux-ld`~~
	44	+	```text
	45	+	bash $ which i386-linux-ld
	46	+	```
45	47
46		-	~~` bash $ which i386-linux-as`~~
	48	+	```text
	49	+	bash $ which i386-linux-as
	50	+	```
47	51
48	52		如果你有這兩個檔，那麼你就可以跳過下面"Compile FPC"標題所說的內容。
49	53
50	54		我沒有這兩個檔所以我做了一對腳本：
51	55
52		-	~~`#!/bin/bash`\~~
53		-	~~`# name this file /usr/bin/i386-linux-ld`\~~
54		-	~~`ld -A elf32-i386 $@`~~
	56	+	```text
	57	+	#!/bin/bash
	58	+	# name this file /usr/bin/i386-linux-ld
	59	+	ld -A elf32-i386 $@
	60	+	```
55	61
56		-	~~`#!/bin/bash`\~~
57		-	~~`# name this file /usr/bin/i386-linux-as`\~~
58		-	~~`as --32 $@`~~
	62	+	```text
	63	+	#!/bin/bash
	64	+	# name this file /usr/bin/i386-linux-as
	65	+	as --32 $@
	66	+	```
59	67
60	68		- 使它們可以被執行:
61	69
62		-	~~`bash $ chmod +x /usr/bin/i386-linux-as`\~~
63		-	~~`bash $ chmod +x /usr/bin/i386-linux-ld`~~
	70	+	```text
	71	+	bash $ chmod +x /usr/bin/i386-linux-as
	72	+	bash $ chmod +x /usr/bin/i386-linux-ld
	73	+	```
64	74
65	75		- 編譯FPC:
66	76
67		-	~~`bash $ make all CPU_TARGET=i386`~~
	77	+	```text
	78	+	bash $ make all CPU_TARGET=i386
	79	+	```
68	80
69	81		然後：
70	82
71		-	~~`bash $ su -c "make install CPU_TARGET=i386"`~~
	83	+	```text
	84	+	bash $ su -c "make install CPU_TARGET=i386"
	85	+	```
72	86
73	87		就這樣了。之後如果必要，你還可以編輯你的 /etc/fpc.cfg 文件。
74	88
75	89		## 到Windows
76	90
77	91		關於用Lazarus做交叉編譯的資訊你可以在[[Cross compiling for Windows under Linux\|在Linux下為Win32交叉編譯]]找到。
78	92
79	93		如果你在編譯FPC的2.1.1版本或者或更新的分支版本，你可以這樣做：
80	94
81		-	~~`bash $ make all OS_TARGET=win32 CPU_TARGET=i386`~~
	95	+	```text
	96	+	bash $ make all OS_TARGET=win32 CPU_TARGET=i386
	97	+	```
82	98
83	99		然後
84	100
85		-	~~`bash $ su -c "make crossinstall OS_TARGET=win32 CPU_TARGET=i386"`~~
	101	+	```text
	102	+	bash $ su -c "make crossinstall OS_TARGET=win32 CPU_TARGET=i386"
	103	+	```
86	104
87	105		注意：為win64編譯的話，用的命令是： make all OS_TARGET=win64 CPU_TARGET=x86_64
88	106
89	107		如此簡單的原因是因為內部的鏈結器已經包含這個版本的FPC。
90	108
91	109		## 到Darwin或者macOS
92	110
93	111		- 首先你需要擁有用於target平臺的binutils。從下面這個站點下載odcctools（使用CVS）。根據他們的指示安裝：http://www.opendarwin.org/projects/odcctools/
94	112		- 你需要建一個虛假的根目錄，就像：\$HOME/darwinroot至少從你的蘋果或Darwin（蘋果的開源版本）系統拷貝/System和/Frameworks/usr目錄（你可能必須拷貝更多東西）到\$HOME/darwinroot
95	113		- now that you have these files make a folder in \$HOME/darwinroot called cross. where ever you installed the odcctools you need to make links for the cross tools to be more fpc friendly. there are a bunch of files from odcc tools called powerpc-apple-darwin-* you need to make links (or rename them) so powerpc-apple-darwin-ld becomes powerpc-darwin-ld, do the same for -ar and -as.
96	114		- now you are ready to crosscompile fpc. basically you need to have the fpc source and have a terminal open there.
97	115
98	116		type:
99	117
100		-	~~`$PATH=$PATH:$HOME/darwinroot/cross (or whereever you made the symlinks)`~~
	118	+	```text
	119	+	$PATH=$PATH:$HOME/darwinroot/cross (or whereever you made the symlinks)
	120	+	```
101	121
102	122		type (iirc):
103	123
104		-	~~`make all TARGET_OS=darwin TARGET_CPU=powerpc OPT="-Xd -Fl/$HOME/darwinroot/usr/lib"`~~
	124	+	```text
	125	+	make all TARGET_OS=darwin TARGET_CPU=powerpc OPT="-Xd -Fl/$HOME/darwinroot/usr/lib"
	126	+	```
105	127
106	128		if that succeded you can install it to whereever you want with:
107	129
108		-	~~`make install TARGET_OS=darwin TARGET_CPU=powerpc PREFIX=/cross/fpc`~~
	130	+	```text
	131	+	make install TARGET_OS=darwin TARGET_CPU=powerpc PREFIX=/cross/fpc
	132	+	```
109	133
110	134		now copy the file ./compiler/ppccross somewhere you will be able to find it as it's the compiler you'll need to build powerpc programs
111	135
112	136		- configure your /etc/fpc.cfg file.
113	137
114	138		add a section like this:
115	139
116		-	~~`#IFDEF powerpc`\~~
117		-	~~`-Fu/cross/fpc/lib/fpc/$fpcversion/units/$fpctarget/`\~~
118		-	~~`-Fu/cross/fpc/lib/fpc/$fpcversion/units/$fpctarget/rtl`\~~
119		-	~~`-Fu/cross/fpc/lib/fpc/$fpcversion/units/$fpctarget/*`\~~
120		-	~~`-k-systemroot $HOME/darwin/cross`\~~
121		-	~~`#ENDIF`~~
	140	+	```text
	141	+	#IFDEF powerpc
	142	+	-Fu/cross/fpc/lib/fpc/$fpcversion/units/$fpctarget/
	143	+	-Fu/cross/fpc/lib/fpc/$fpcversion/units/$fpctarget/rtl
	144	+	-Fu/cross/fpc/lib/fpc/$fpcversion/units/$fpctarget/*
	145	+	-k-systemroot $HOME/darwin/cross
	146	+	#ENDIF
	147	+	```
122	148
123	149		whenever you want to crosscompile you have to have ppccross and the symlinks to powerpc-darwin-* in the PATH and you should be able to just do ppccross someprogie.pas and it will create a darwin executable.
124	150
125	151		I may have missed some things (or most everything) as it's been a while since I did this.
126	152
127	153		# 從Windows
128	154
129	155		## 到Linux
130	156
131	157		這很簡單，你可以在[[buildfaq]]看到相關資訊。
132	158
133	159		## 到GO32v2
134	160
135	161		你可以在[[Cross-compilation from Win32 to GO32v2\|從Win32到GO32v2的交叉編譯]]找到詳細資訊。
136	162
137	163		# 從Darwin（macOS）i386
138	164
139	165		## 從i386到PowerPC
140	166
141	167		- 交叉binutils
142	168
143	169		首先檢查你是否已經有了以下檔powerpc-darwin-ld和powerpc-darwin-as：
144	170
145		-	~~` $ which powerpc-darwin-ld`\~~
146		-	~~` $ which powerpc-darwin-as`~~
	171	+	```text
	172	+	$ which powerpc-darwin-ld
	173	+	$ which powerpc-darwin-as
	174	+	```
147	175
148	176		如果你已經有了上述檔就可以跳過創建符號鏈結，直接跳到“編譯FPC”標題。
149	177
150	178		事實上，“normal”binutils能夠使用，因為它們是通用的。因此簡單的符號鏈結就夠了：
151	179
152		-	~~` $ sudo ln -s /usr/bin/as /usr/bin/powerpc-darwin-as`\~~
153		-	~~` $ sudo ln -s /usr/bin/ld /usr/bin/powerpc-darwin-ld`~~
	180	+	```text
	181	+	$ sudo ln -s /usr/bin/as /usr/bin/powerpc-darwin-as
	182	+	$ sudo ln -s /usr/bin/ld /usr/bin/powerpc-darwin-ld
	183	+	```
154	184
155	185		這些符號鏈結可以存其他目錄，只要她們在你的\$PATH（for example /sw/bin when installing through fink）環境變數中就可以了。
156	186
157	187		- 編譯FPC：
158	188
159		-	~~` $ cd fpc/compiler`\~~
160		-	~~` $ make cycle CPU_TARGET=powerpc`~~
	189	+	```text
	190	+	$ cd fpc/compiler
	191	+	$ make cycle CPU_TARGET=powerpc
	192	+	```
161	193
162	194		這樣就能創建一個PowerPC編譯器（fpc/compiler/ppcppc）和rtl的單元。
163	195
164	196		事實上，創建PowerPC的binaries不需要交叉編譯器。使用Rosetta，powerpc fpc和ppcppc在IntelMacs上運行得很好。
165	197
166	198		關於兩者的平行的安裝和使用需要更多的測試和文檔（希望你來做測試和寫些文檔吧）。
167	199
168	200		如果缺少單元檔，檢查你的配置檔，\$HOME/.fpc.cfg或者/etc/fpc.cfg或者/sw/etc/fpc.cfg You may have to add something like or where ever your units are located.
169	201
170		-	~~`-Fu/usr/local/lib/fpc/lib/fpc/$fpcversion/units/$fpctarget/`\~~
171		-	~~`-Fu/usr/local/lib/fpc/lib/fpc/$fpcversion/units/$fpctarget/rtl`\~~
172		-	~~`-Fu/usr/local/lib/fpc/lib/fpc/$fpcversion/units/$fpctarget/*`~~
	202	+	```text
	203	+	-Fu/usr/local/lib/fpc/lib/fpc/$fpcversion/units/$fpctarget/
	204	+	-Fu/usr/local/lib/fpc/lib/fpc/$fpcversion/units/$fpctarget/rtl
	205	+	-Fu/usr/local/lib/fpc/lib/fpc/$fpcversion/units/$fpctarget/*
	206	+	```
173	207
174	208		Reminder: Universal binaries are created from the individual (i386 and powerpc) binaries using lipo.
175	209
176	210		## 到Windows和Linux（32位）
177	211
178	212		包管理器[fink](http://finkproject.org/) 已經包含為Windows和linux（32位）交叉編譯的包了.
179	213
180	214		用
181	215
182		-	~~`$ fink install fpc-win32`~~
	216	+	```text
	217	+	$ fink install fpc-win32
	218	+	```
183	219
184	220		和
185	221
186		-	~~`$ fink install fpc-i386-linux`~~
	222	+	```text
	223	+	$ fink install fpc-i386-linux
	224	+	```
187	225
188	226		安裝交叉編譯器。
189	227
190	228		``` bash
191	229		fpc-cross-arm-gba
192	230		fpc-cross-arm-linux
193	231		fpc-cross-arm-nds
194	232		fpc-cross-arm-wince
195	233		fpc-cross-arm-armv4t-embedded
196	234		fpc-cross-arm-armv7m-embedded
197	235		fpc-cross-i386-darwin
198	236		fpc-cross-i386-freebsd
199	237		fpc-cross-i386-go32v2
200	238		fpc-cross-i386-linux
201	239		fpc-cross-i386-nativent
202	240		fpc-cross-i386-netbsd
203	241		fpc-cross-i386-solaris
204	242		fpc-cross-i386-win32
205	243		fpc-cross-i386-wince
206	244		fpc-cross-jvm-android
207	245		fpc-cross-jvm-java
208	246		fpc-cross-m68k-linux
209	247		fpc-cross-mipsel-linux
210	248		fpc-cross-powerpc-linux
211	249		fpc-cross-sparc-linux
212	250		fpc-cross-x86-64-dragonfly
213	251		fpc-cross-x86-64-freebsd
214	252		fpc-cross-x86-64-linux
215	253		fpc-cross-x86-64-win64
216	254		```
217	255
218	256		# Cross compile FAQ
219	257
220	258		## 為什麼要交叉編譯？
221	259
222	260		這樣你就用不著為一個作業系統/系統架構開發一個程式或為另一個作業系統/系統架構編譯而重啟或切換你的電腦。
223	261
224	262		## 為什麼是從UNIX到Windows而不是反過來？
225	263
226	264		主要的原因是因為生成的binaries在其他系統上（另一個UNIX甚至是包括Linux發行版）是非常複雜的。主要的問題是：
227	265
228	266		1. 你在host上需要庫。
229	267		2. 沒有一套庫可以作為越來越複雜的，不斷變化的UNIX版本的最終版本（你很可能按需編譯出一套新的庫來）。
230	268		3. 總是需要更多(linker)參數和設置，這些東西在通常情況下很難描述明白。
231	269
232	270		如果你在這個警告後還是堅持這樣做（從Windows到UNIX），請看一下crossnotes document mentioned further，或者[[buildfaq]]。
233	271
234	272		## 我需要更多構建FreePascal的資訊。哪兒可以找到？
235	273
236	274		有一個通用的pdf格式的FAQ關於如何構建和配置FPC: [[buildfaq]]
237	275
238	276		---
239	277		From the Free Pascal wiki, page "Cross compiling/zh TW", as it stood on 2021-07-19 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).

Back to history