embedded resources

嵌入式艺术公共资源

包含 https://embeddedartistry.com 上引用的模板、文档和源代码示例。

目录

1. 要求
   1. git-lfs
   2. 介子
2. 结构
3. 建筑
4. 测试

要求

该存储库使用子模块。您可以递归地克隆存储库以自动设置子模块：

 $ git clone https://github.com/embeddedartistry/embedded-resources.git --recursive

您还可以在克隆后初始化子模块：

 $ git submodule update --init --recursive

git-lfs

该存储库需要 git-lfs。如果您没有安装，请访问 https://git-lfs.github.com

如果您在安装 git-lfs 之前克隆了此存储库，请运行git lfs pull 。否则，clone 将自动执行git lfs pull 。

介子

该存储库使用介子构建，需要 Python 3 和 Ninja。

在 Ubuntu 上，可以使用以下命令轻松安装它们：

 $ sudo apt-get install python3 python3-pip ninja-build

对于OSX，您可以使用brew ：

 $ brew install python3 ninja

获取 Meson 的最佳方式是通过 pip：

 $ pip3 install meson

结构

• build/
  • 常见的构建脚本和定义
• docs
  • 开源项目模板和参考文档
• examples/
  • c/
    • Embedded Artistry 网站的 C 示例
  • cpp/
    • Embedded Artistry 网站的 C++ 示例
  • libc/
    • libc 实现示例
  • libcpp/
    • libcpp 实现示例
• interview/
  • 面试问题实施示例
• manufacturing/
  • 对于嵌入式世界的制造方面有用的文档和模板。

建筑

您可以从顶层运行make来构建所有示例。输出将放置在顶层名为buildresults/的文件夹中。

您还可以使用正确的介子语法：

 $ meson buildresults
$ cd buildresults
$ ninja

可以使用buildresults/目录中的 ninja 界面单独构建目标。

 $ cd buildresults
$ ninja interview/bad_c

要清理构建，请从项目根目录运行make clean或在buildresults/目录中运行ninja clean 。

二进制文件将存储在与源树中相同层次结构的buildresults/文件夹下。例如， bad_c面试演示应用程序将位于buildresults/interview/中。

测试

该存储库现在包含测试。可以使用make test运行测试，它将构建项目，运行测试，并为您提供来自 Meson 测试运行程序的摘要报告。在这种情况下，测试结果存储在buildresults/test中的 XML 文件中

要查看人类可读的输出，请像平常一样构建项目（ make或make test ），然后发出以下命令：

 $ ninja -C buildresults/ embedded-resources-tests
ninja: Entering directory `buildresults/'
[0/1] Running external command embedde...es-tests (wrapped by meson to set env)
[==========] Running 1 test(s).
[ RUN      ] test_case
[       OK ] test_case
[==========] 1 test(s) run.
[  PASSED  ] 1 test(s).

进一步阅读

• 介子
• 完整的嵌入式 Artistry libc 实现
• 嵌入式Artistry libmemory