【RT-Thread學(xué)習(xí)筆記】使用scons命令生成靜態(tài)庫

1 問題來源

本問題來源于RT-Thread的技術(shù)論壇的一個常見問題，當時我回答了這個問題，很榮幸拿了一個最佳答案，為了能夠再次消化并進行知識點沉淀，我把這個問題再次拋到這里。 原問題，請戳這里：scons 命令buildlib使用方法

2 實踐分析

2.1 不懂就要問

既然不知道怎么用scons，那么我們先看到它的幫助信息，以下命令在scons的主目錄執(zhí)行，即可以找到Sconscript的目錄下執(zhí)行：

1. rt-thread/bsp/qemu-vexpress-a9$ scons -h
2. scons: Reading SConscript files ...
3. drivers/SConscript
4. applications/SConscript
5. [, , ]
6. scons: done reading SConscript files.
7. usage: scons [OPTION] [TARGET] ...
9. SCons Options:
10. -b, -d, -e, -m, -S, -t, -w, --environment-overrides, --no-keep-going,
11. --no-print-directory, --print-directory, --stop, --touch
12. Ignored for compatibility.
13. -c, --clean, --remove Remove specified targets and dependencies.
14. -C DIR, --directory=DIR Change to DIR before doing anything.
15. --cache-debug=FILE Print CacheDir debug info to FILE.
16. --cache-disable, --no-cache
17. Do not retrieve built targets from CacheDir.
18. --cache-force, --cache-populate
19. Copy already-built targets into the CacheDir.
20. --cache-readonly Do not update CacheDir with built targets.
21. --cache-show Print build actions for files from CacheDir.
22. --config=MODE Controls Configure subsystem: auto, force,
23. cache.
24. -D Search up directory tree for SConstruct,
25. build all Default() targets.
26. --debug=TYPE Print various types of debugging information:
27. count, duplicate, explain, findlibs, includes,
28. memoizer, memory, objects, pdb, prepare,
29. presub, stacktrace, time, action-timestamps.
30. --diskcheck=TYPE Enable specific on-disk checks.
31. --duplicate=DUPLICATE Set the preferred duplication methods. Must be
32. one of hard-soft-copy, soft-hard-copy,
33. hard-copy, soft-copy, copy
34. --enable-virtualenv Import certain virtualenv variables to SCons
35. -f FILE, --file=FILE, --makefile=FILE, --sconstruct=FILE
36. Read FILE as the top-level SConstruct file.
37. -h, --help Print defined help message, or this one.
38. -H, --help-options Print this message and exit.
39. -i, --ignore-errors Ignore errors from build actions.
40. -I DIR, --include-dir=DIR Search DIR for imported Python modules.
41. --ignore-virtualenv Do not import virtualenv variables to SCons
42. --implicit-cache Cache implicit dependencies
43. --implicit-deps-changed Ignore cached implicit dependencies.
44. --implicit-deps-unchanged Ignore changes in implicit dependencies.
45. --interact, --interactive Run in interactive mode.
46. -j N, --jobs=N Allow N jobs at once.
47. -k, --keep-going Keep going when a target can't be made.
48. --max-drift=N Set maximum system clock drift to N seconds.
49. --md5-chunksize=N Set chunk-size for MD5 signature computation to
50. N kilobytes.
51. -n, --no-exec, --just-print, --dry-run, --recon
52. Don't build; just print commands.
53. --no-site-dir Don't search or use the usual site_scons dir.
54. --profile=FILE Profile SCons and put results in FILE.
55. -q, --question Don't build; exit status says if up to date.
56. -Q Suppress "Reading/Building" progress messages.
57. --random Build dependencies in random order.
58. -s, --silent, --quiet Don't print commands.
59. --site-dir=DIR Use DIR instead of the usual site_scons dir.
60. --stack-size=N Set the stack size of the threads used to run
61. jobs to N kilobytes.
62. --taskmastertrace=FILE Trace Node evaluation to FILE.
63. --tree=OPTIONS Print a dependency tree in various formats: all,
64. derived, prune, status, linedraw.
65. -u, --up, --search-up Search up directory tree for SConstruct,
66. build targets at or below current directory.
67. -U Search up directory tree for SConstruct,
68. build Default() targets from local SConscript.
69. -v, --version Print the SCons version number and exit.
70. --warn=WARNING-SPEC, --warning=WARNING-SPEC
71. Enable or disable warnings.
72. -Y REPOSITORY, --repository=REPOSITORY, --srcdir=REPOSITORY
73. Search REPOSITORY for source and target files.
75. Local Options:
76. --dist make distribution
77. --dist-strip make distribution and strip useless files
78. --dist-ide make distribution for RT-Thread Studio IDE
79. --project-path=PROJECT-PATH
80. set dist-ide project output path
81. --project-name=PROJECT-NAME
82. set project name
83. --reset-project-config reset the project configurations to default
84. --cscope Build Cscope cross reference database. Requires
85. cscope installed.
86. --clang-analyzer Perform static analyze with Clang-analyzer.
87. Requires Clang installed. It is recommended to
88. use with scan-build like this: `scan-build
89. scons --clang-analyzer` If things goes well,
90. scan-build will instruct you to invoke
91. scan-view.
92. --buildlib=BUILDLIB building library of a component
93. --cleanlib clean up the library by --buildlib
94. --target=TARGET set target project: mdk/mdk4/mdk5/iar/vs/vsc/ua/
95. cdk/ses/makefile/eclipse/codelite/cmake
96. --stackanalysis thread stack static analysis
97. --genconfig Generate .config from rtconfig.h
98. --useconfig=USECONFIG make rtconfig.h from config file.
99. --verbose print verbose information during build
100. --menuconfig make menuconfig for RT-Thread BSP
101. --pyconfig Python GUI menuconfig for RT-Thread BSP
102. --pyconfig-silent Don`t show pyconfig window

精準匹配下：

1. rt-thread/bsp/qemu-vexpress-a9$ scons -h | grep buildlib
2. --buildlib=BUILDLIB building library of a component
3. --cleanlib clean up the library by --buildlib

2.2 實踐出整理

從上面的幫助信息，我們已經(jīng)找到關(guān)鍵信息了，我們來實踐下：

1. rt-thread/bsp/qemu-vexpress-a9$ scons --buildlib=BUILDLIB
2. scons: Reading SConscript files ...
3. b''
4. drivers/SConscript
5. applications/SConscript
6. [, , ]
7. scons: done reading SConscript files.
8. scons: Building targets ...
9. scons: building associated VariantDir targets: build
10. scons: `.' is up to date.
11. scons: done building targets.

發(fā)現(xiàn)并沒有生成，仔細一看，這個buildlib=后面跟的名稱不是亂填的，是需要填寫你當前目錄下，已經(jīng)使用scons語法配置好的組件，這個東西在scons里面是叫Group。 通俗來說，就是使用buildlib，一個Gourp就可以生成一個庫。 我們再來實踐下，以bsp/qemu-vexpress-a9的Application這個Group為例，在其applications目錄有定義Sconsript:

那么就可以輸入scons--buildlib=Applications

就可以將Applications那個group定義的C文件編譯打包成一個靜態(tài)庫，輸出也是位于bsp的目錄中。

3 經(jīng)驗總結(jié)

• 任何命令行指令，千萬不要放過它的help信息
• scons 使用--buildlib=xxx輕松生存庫文件，庫名稱為libxxx.a

4 更多分享

架構(gòu)師李肯

一個專注于嵌入式IoT領(lǐng)域的架構(gòu)師。有著近10年的嵌入式一線開發(fā)經(jīng)驗，深耕IoT領(lǐng)域多年，熟知IoT領(lǐng)域的業(yè)務(wù)發(fā)展，深度掌握IoT領(lǐng)域的相關(guān)技術(shù)棧，包括但不限于主流RTOS內(nèi)核的實現(xiàn)及其移植、硬件驅(qū)動移植開發(fā)、網(wǎng)絡(luò)通訊協(xié)議開發(fā)、編譯構(gòu)建原理及其實現(xiàn)、底層匯編及編譯原理、編譯優(yōu)化及代碼重構(gòu)、主流IoT云平臺的對接、嵌入式IoT系統(tǒng)的架構(gòu)設(shè)計等等。擁有多項IoT領(lǐng)域的發(fā)明專利，熱衷于技術(shù)分享，有多年撰寫技術(shù)博客的經(jīng)驗積累，連續(xù)多月獲得RT-Thread官方技術(shù)社區(qū)原創(chuàng)技術(shù)博文優(yōu)秀獎，榮獲CSDN博客專家、CSDN物聯(lián)網(wǎng)領(lǐng)域優(yōu)質(zhì)創(chuàng)作者、2021年度CSDN&RT-Thread技術(shù)社區(qū)之星、RT-Thread官方嵌入式開源社區(qū)認證專家、RT-Thread 2021年度論壇之星TOP4、華為云云享專家（嵌入式物聯(lián)網(wǎng)架構(gòu)設(shè)計師）等榮譽。堅信【知識改變命運，技術(shù)改變世界】！

歡迎關(guān)注我的github倉庫01workstation，日常分享一些開發(fā)筆記和項目實戰(zhàn)，歡迎指正問題。

同時也非常歡迎關(guān)注我的專欄：有問題的話，可以跟我討論，知無不答，謝謝大家。