Lines of script/ygopro_编译.md from check-in 6f99fc6a2a that are changed by the sequence of edits moving toward check-in d8be18d9bf:
1: # ygopro_编译
2:
3: ## 前言
4:
5: 来，走起，我们来编译一个小且可用的 ygopro 。
6:
7: 功能不求全，<b>只要有</b>残局功能就够了。
8:
9: ## 新建文件夹
10:
11: 万事第一步，先新建个文件夹……
12:
13: 然后，不做了，等一年后再来看，进度 0%，哈哈，这才是正常轨迹。
14:
15: 上面虽然是玩笑话，但也估摸着是我的真实经历，只不过我这个拖延王<b>拖延了</b>大概六年。
16:
17: 好了，给这个文件夹改名吧。
18:
19: 我则取名叫：
20:
21: ~~~
22: ygopro
23: ~~~
24:
25: ## 编译器
26:
27: 编译时，一个<b>很麻烦</b>的东西就是编译器。
28:
29: 很长一段时间，我都不知道到哪里去下编译器，也不知道编译器的名字叫什么。
30:
31: 像这种基础性的东西难道不应该有某某一个人把它们汇总起来让人随便下吗？
32:
33: 后来我发现，诶，还真有，但那人的网站在百度上很难搜。
34:
35: 现在的搜索引擎，早不名副其实了。
36:
37: 我们要下载的编译器叫 msvc ，准确点，应该叫 MSVC 。
38:
39: 不过我懒得换大小写，后文直接叫 msvc 了。
40:
41: msvc 是一家叫微软的公司出的，这公司现在很鸡贼，把 msvc 的下载页面给隐藏了，狂推 vs 的下载。
42:
43: ~~~
44: https://visualstudio.microsoft.com/zh-hans/visual-cpp-build-tools
45: ~~~
46:
47: 下载下来之后，会有一个 exe ，直接进行执行。
48:
49: 然后就会有一大堆东西让你选，你挑着系统 sdk 与 c++编译工具安装就行了。
50:
51: 但这里会冒出来一个大问题：
52:
53: 下不动！
54:
55: 网络问题，我还真没法解决。
56:
57: 中国的网络封锁太强，自己看情况想办法绕过去吧。
58:
59: 就算我这写了一点解决网络问题的方法，以现在的封锁趋势，过一段时间也就不能用了。
60:
61: 不过，你还是有可能下得动的，因为彻底封死网络会伤某些人的心，所以现在是采用人群分化的方法来封锁网络，顺便还能挑起人群之间的内部矛盾。
62:
63: 安装好编译器之后，桌面上又没快捷方式，不知道该怎么打开。
64:
65: 这时应该打开 windows 的搜索功能，用快捷键就能打开了，我用的是 win8.1 系统，可以用 win+s 组合键打开。
66:
67: 然后输入：
68:
69: ~~~
70: comm
71: ~~~
72:
73: 你查字典大概是查不到这单词的，因为这是我记不住那个完整名称而记下来的简写。
74:
75: 全名应该是「命令行」这三个字的英文版。
76:
77: 你输入这单词之后会出现一堆黑框框，选「不带 x64 」的黑框框打开。
78:
79: 你这样打开之后，看起来它仅仅只是打开个 cmd 控制台而已，其实它调用了一堆脚本来设置各组件的环境变量。
80:
81: 比较可惜的是，这些它设置的环境变量它不会告诉你，这就导致很多人其实做了无用功去重复做了这些脚本已经帮他们做好的事。
82:
83: 到这里，编译器就准备好了。
84:
85: 而且它也设置了 32 位的环境。
86:
87: ## lua
88:
89: 先下载 lua 的源码：
90:
91: ~~~
92: https://www.lua.org/download.html
93: ~~~
94:
95: 直接下最新版本。
96:
97: 顺便一说， lua5.3 有 bug ，性能也不如 lua5.4 。
98:
99: 下完之后，解压，会出现一大堆文件，别怕。
100:
101: 先在 ygopro 下建一个文件夹：
102:
103: ~~~
104: lib
105: ~~~
106:
107: 现在的目录结构是：
108:
109: ~~~
110: ygopro
111: |——|—— lib
112: ~~~
113:
114: 再建一个文件夹：
115:
116: ~~~
117: ygopro
118: |—— lib
119: |——|—— lua
120: ~~~
121:
122: 把 lua 源码的 src 文件夹复制过来：
123:
124: ~~~
125: ygopro
126: |—— lib
127: |——|—— lua
128: |——|——|—— src
129: ~~~
130:
131: 注意哦，不是光把文件复制过来就可以了，你自己本身也需要对这些源码的特性有一个基本的了解。
132:
133: 比如 lua 的这个源码，就需要删除两个文件：
134:
135: ~~~
136: lua.c
137: luac.c
138: ~~~
139:
140: 这是因为这两个文件里都有主函数。
141:
142: 这里要特别讲一下，什么叫主函数。
143:
144: 主函数就是应用程序的入口函数，相当于一座城堡的大门，想进城堡旅游，就得进门，不然进不去的。
145:
146: 有些人学程序学四个学期了仍然不知道什么是主函数，这其实都很正常，因为各人有各人的局限性。
147:
148: 好了，接下来就要开始编译了。
149:
150: 你也许会奇怪，这不是 lua 吗？
151:
152: 又不是 ygopro 。
153:
154: 怎么现在就要开始编译了？
155:
156: 编译其实分两步，一步是编译，一步是连接。
157:
158: 我们先编译，等到了最后再进行连接。
159:
160: 打开之前下载的 msvc ，把它的目录转到 ygopro ，然后输入：
161:
162: ~~~
163: cl
164: ~~~
165:
166: 然后应该会报错。
167:
168: 加个参数：
169:
170: ~~~
171: cl /c ./lib/lua/src/*.c
172: ~~~
173:
174: 那个梅花号是通配符，这样子会把那个目录下的所有后缀名为「 c 」的文件都给编译了。
175:
176: 也许你会奇怪，这就编译完了？
177:
178: 原来编译这么简单。
179:
180: 别人都封装好了，当然简单了。
181:
182: 其实就这么简单的事，窗户纸不捅破，就一直<b>做不了</b>。
183:
184: 接下来，我们开优化：
185:
186: ~~~
187: cl /O2 /c ./lib/lua/src/*.c
188: ~~~
189:
190: 代码速度慢一点，没啥大关系，还有编译器优化可以帮我们。
191:
192: 接下来讲点底层。
193:
194: 电脑里其实啥也没有，只有 01 ，我再强调一下，「 0 」、「 1 」。
195:
196: 那这些 01 是怎么运行的？
197:
198: 01 根本就运行不了，必须有东西承载着它们，而承载它们的那个东西理所应当就是计算机的底层吧？
199:
200: 你可以把那个东西看成是一个开关，它明显有两种状态，一种是开，一种关。
201:
202: 于是我们可以「把开叫做 0 ，把关叫做 1 」，也可以「把开叫做 1 ，把关叫做 0 」
203:
204: 但这样子，我们人与人之间就不好互相交流了，于是有些组织就给这些名字定了规范。
205:
206: 好了，你现在已经把 01 与实物联系起来了，懂了。
207:
208: 然后再把刚才的忘掉。
209:
210: 因为刚才这个模型虽然合理，但其实是用来描述继电器的。
211:
212: 计算机内部使用的是半导体——它会有一个高电平，一个低电平。
213:
214: 于是我们可以像把开关的开关状态与 01 联系起来一样，把半导体的电平高低状态与 01 联系起来。
215:
216: 这个所谓的电平具体是指啥，我已经忘了，不过总不外乎是「电压」、「电流」这些与电相关的量度。
217:
218: 你小时候家里经常停电吗？
219:
220: 如果有过停电或电烧电器的经历，那么应该会有「电不稳定」的印象。
221:
222: 电平受制于电的不稳定，所以它是不精确的。
223:
224: 电平是低于某个临界点，就属于低电平，高于某个临界点，就属于高电平。
225:
226: 这个临界点是人定的。
227:
228: 接下来，不讲底层了。
229:
230: 01 往上可以组建逻辑门，而汇编编程语言可以指导逻辑门的运行。
231:
232: 但问题在于各个商家给逻辑门定的汇编语言是不一样的，于是我们需要一个通用的汇编语言，而这就是 c 语言的别称——「便携式汇编语言」。
233:
234: 一门编程语言可以大致分为三部分：
235:
236: 语法、标准库、自定义库。
237:
238: lua 会用到 c 语言的标准库，而我们从上面的过程可以看到系统肯定会有 c 语言标准库。
239:
240: 加个参数：
241:
242: ~~~
243: cl /MD /O2 /c ./lib/lua/src/*.c
244: ~~~
245:
246: 这样子， lua 就会采用系统自带的 c 语言标准库了。
247:
248: 但仅仅是这样子还不行，因为 ygopro 不是一个纯 c 语言的项目。
249:
250: 这里的 lua 需要采用 cpp ，也就是 c++的方式进行编译：
251:
252: ~~~
253: cl /TP /MD /O2 /c ./lib/lua/src/*.c
254: ~~~
255:
256: 然后由于 cpp 的特性，你会收到一堆报错，此时编译器会提醒你再加个参数：
257:
258: ~~~
259: cl /EHsc /TP /MD /O2 /c ./lib/lua/src/*.c
260: ~~~
261:
262: 好，大功告成，这就算把 lua 编译完了。
263:
264: 不过，这时候，你的目录下会有一大堆的 obj 文件，不好看。
265:
266: 于是输入：
267:
268: ~~~
269: lib /OUT:lua.lib *.obj
270: ~~~
271:
272: 这就把所有的 obj 文件合成了一个文件了。
273:
274: 所以可以把 obj 文件全部删了：
275:
276: ~~~
277: del *.obj
278: ~~~
279:
280: 也就是说，我们由一堆文件中编译出了一个文件：
281:
282: ~~~
283: lua.lib
284: ~~~
285:
286: ## sqlite3
287:
288: 接下来，我们需要下载一个很厉害的软件，作者是理查德·希普。
289:
290: 这一回应该不会遇到网络问题了：
291:
292: ~~~
293: https://www.sqlite.org/index.html
294: ~~~
295:
296: 虽然，这一回我们不会再遇到网络问题，但可能会遇到这个网站的质疑：
297:
298: 你到底是不是<b>人</b>？
299:
300: 这是因为有些中国人恶意进攻这个网站，于是理查德专门把防范机器人的机制加强了。
301:
302: 把解压后的目录复制过来：
303:
304: ~~~
305: ygopro
306: |—— lib
307: |——|—— lua
308: |——|——|—— src
309: |——|—— sqlite3
310: ~~~
311:
312: 然后编译：
313:
314: ~~~
315: cl /MD /O2 /c ./lib/sqlite3/*.c
316: ~~~
317:
318: 然后再连接与清理一下即可。
319:
320: 其实 sqlite3 非常强，但是 ygopro 并没有对它擅加利用，这一点也体现在，你看这次的编译非常简单吧。
321:
322: 编译简单是因为没有设置那些解放 sqlite3 力量的宏。
323:
324: ## freetype
325:
326: 下载：
327:
328: ~~~
329: http://www.freetype.org
330: ~~~
331:
332: 目录结构：
333:
334: ~~~
335: ygopro
336: |—— lib
337: |——|—— lua
338: |——|——|—— src
339: |——|—— sqlite3
340: |——|—— freetype
341: |——|——|—— src
342: |——|——|—— include
343: |——|——|—— builds
344: ~~~
345:
346: 编译：
347:
348: ~~~
349: cl /MD /O2 /c /D FT2_BUILD_LIBRARY -I ./lib/freetype/include
350: ~~~
351:
352: 可以发现，上面添加了头文件所在的文件夹。
353:
6f99fc6a2a 2023-10-14 354: 但奇怪的是，怎么没看到c文件？
355:
356: 因为这一次要编译的文件太多了：
357:
358: ~~~
359: str["freetype_文件表"] = {
360:
361: "src/autofit/autofit.c"
362: , "src/base/ftbase.c"
363: , "src/base/ftbbox.c"
364: , "src/base/ftbdf.c"
365: , "src/base/ftbitmap.c"
366: , "src/base/ftcid.c"
367: , "src/base/ftfstype.c"
368: , "src/base/ftgasp.c"
369: , "src/base/ftglyph.c"
370: , "src/base/ftgxval.c"
371: , "src/base/ftinit.c"
372: , "src/base/ftmm.c"
373: , "src/base/ftotval.c"
374: , "src/base/ftpatent.c"
375: , "src/base/ftpfr.c"
376: , "src/base/ftstroke.c"
377: , "src/base/ftsynth.c"
378: , "src/base/fttype1.c"
379: , "src/base/ftwinfnt.c"
380: , "src/bdf/bdf.c"
381: , "src/cache/ftcache.c"
382: , "src/cff/cff.c"
383: , "src/cid/type1cid.c"
384: , "src/gzip/ftgzip.c"
385: , "src/lzw/ftlzw.c"
386: , "src/pcf/pcf.c"
387: , "src/pfr/pfr.c"
388: , "src/psaux/psaux.c"
389: , "src/pshinter/pshinter.c"
390: , "src/psnames/psmodule.c"
391: , "src/raster/raster.c"
392: , "src/sfnt/sfnt.c"
393: , "src/sdf/sdf.c"
394: , "src/smooth/smooth.c"
395: , "src/truetype/truetype.c"
396: , "src/type1/type1.c"
397: , "src/type42/type42.c"
398: , "src/winfonts/winfnt.c"
399: , "src/svg/ftsvg.c"
400: , "builds/windows/ftsystem.c"
401: , "builds/windows/ftdebug.c"
402: }
403: ~~~