Mbed OS 文档翻译 之 参考（贡献（工具（构建工具）））

构建工具

Mbed OS 包含用于在 tools 目录中构建自身的工具。这些构建工具包括特定于目标的后构建脚本。添加目标时，可能需要添加postbuild 脚本。使用 postbuild 脚本以链接器无法修改链接的应用程序二进制文件，例如在特定偏移量处插入校验和。Postbuild 脚本很少可以导出，只有在用完所有其他选项后才能使用它们。

Postbuild 脚本

这些工具包括用于在链接后修改应用程序二进制文件的任务的 postbuild 脚本。这些任务是用 Python 编写的，作为 tools.targets 模块中类的静态方法。任务在 targets.json 中指定为 Class.method。

这些工具使用 4 个参数调用静态方法：

1. 工具链对象。您可以使用此对象进行日志记录。
2. 用于此构建的资源对象。它包含所有 C，C++ 和 ASM 源码。
3. 链接器生成的 .elf 文件的路径。
4. 链接后生成的二进制文件的路径，如果代码未生成二进制文件，则生成 .elf 文件的路径。

实施

要添加 postbuild 脚本，请使用单个方法将类添加到 tools/ targets/__ init__.py python 文件中，例如：

class LPCTargetCode(object):
    """General LPC Target patching"""
    @staticmethod
    def lpc_patch(t_self, resources, elf, binf):
        """Patch an elf file"""
        t_self.debug("LPC Patch: %s" % os.path.split(binf)[1])
        from .LPC import patch
        patch(binf)

需要此 postbuild 脚本运行的目标必须在 targets/targets.json 中包含此代码段：

"post_binary_hook": {"function": "LPCTargetCode.lpc_patch"},

在实现 postbuild 脚本时，请注意以下注意事项：

• 你可以用一个。在项目名称中。
• 您可以将输出文件类型更改为二进制，Intel Hex 和 .elf 中的任何一个。
• 当有多个可加载部分时，Arm 编译器为每个可加载部分生成一个包含 .bin 文件的目录。