abimap 0.3.2

为什么使用符号版本控制？

主要原因是能够保持库的稳定。

如果库打算长期使用，则需要更新 最终的错误修复和/或改进。 这可能会导致 [api] 中的更改，并且在最坏的情况下，更改为 [abi]

使用符号版本控制，可以进行兼容的更改并保持 无需重新编译即可工作的应用程序。 如果进行了不兼容的更改（中断 [abi] ），则符号版本控制允许 在同一个系统中生活的不兼容版本没有冲突。 甚至更不常见的情况，如要链接到的应用程序 同一个库的不同（不兼容）版本。

有关更多信息，我强烈建议阅读：

• [如何] 如何编写共享库，由ulrich dreper提供

如何将符号版本控制添加到我的库中？

向符号中添加版本信息很容易。 不幸的是，保持 [abi] 稳定并非如此。本项目旨在帮助第一部分。

要将版本信息添加到库的符号中，可以使用版本脚本（在Linux中）。 版本脚本是链接器用来将符号映射到给定版本的文件。 它包含由库导出的符号，这些符号按引入它们的版本分组。例如：

LIB_EXAMPLE_1_0_0
  {
    global:
      symbol;
      another_symbol;
    local:
      *;
  };

在本例中，release lib_1_0_0 引入了符号 symbol 和 另一个符号。 local 中的 * 通配符捕获所有其他符号，这意味着只有 符号 和 另一个符号 作为库的一部分全局导出。

如果进行了兼容的更改，则会引入新版本，如：

LIB_EXAMPLE_1_0_0
{
    global:
        symbol;
        another_symbol;
    local:
        *;
};

LIB_EXAMPLE_1_1_0
{
    global:
        new_symbol;
} LIB_EXAMPLE_1_0_0;

LIB_EXAMPLE_2_0_0
{
    global:
        a_newer_symbol;
        another_symbol;
        new_symbol;
    local:
        *;
};

运行abimap -h 将得到：

LIB_EXAMPLE_1_0_0
  {
    global:
      symbol;
      another_symbol;
    local:
      *;
  };

调用传递'-h'的子命令以查看其特定选项 有四个子命令， update ， new ， check 和 version

运行abimap update会得到：

LIB_EXAMPLE_1_0_0
  {
    global:
      symbol;
      another_symbol;
    local:
      *;
  };

运行abimap new将得到：

LIB_EXAMPLE_1_0_0
  {
    global:
      symbol;
      another_symbol;
    local:
      *;
  };

运行abimap check将给出：

LIB_EXAMPLE_1_0_0
  {
    global:
      symbol;
      another_symbol;
    local:
      *;
  };

运行abimap版本将得到：

LIB_EXAMPLE_1_0_0
  {
    global:
      symbol;
      another_symbol;
    local:
      *;
  };

作为库导入：

将项目中的abimap用作库：

LIB_EXAMPLE_1_0_0
  {
    global:
      symbol;
      another_symbol;
    local:
      *;
  };

文档：

签入 阅读文档

参考文献：