xmake-docs/docs/zh/api/scripts/extension-modules/utils/binary.md

utils.binary

二进制工具模块。

utils.binary.deplibs

获取依赖库列表。

函数原型

::: tip API

local deps = deplibs(binaryfile: <string>, opt: <table>)

:::

参数说明

参数	描述
binaryfile	必需。输入二进制文件路径
opt	可选。选项： - plat: 平台 - arch: 架构 - recursive: 递归获取所有依赖 (默认: false) - resolve_path: 解析完整路径 (默认: false) - resolve_hint_paths: 查找提示路径 - resolve_search_paths: 搜索库路径 (如 LD_LIBRARY_PATH) - check_cycle: 检测循环依赖

返回值说明

返回值	描述
<table>	依赖库列表

utils.binary.readsyms

读取对象文件符号。

函数原型

::: tip API

local syms = readsyms(binaryfile: <string>)

:::

参数说明

参数	描述
binaryfile	必需。输入对象文件路径

返回值说明

返回值	描述
<table>	符号列表

utils.binary.extractlib

解压静态库到目录。

函数原型

::: tip API

extractlib(libraryfile: <string>, outputdir: <string>, opt: <table>)

:::

参数说明

参数	描述
libraryfile	必需。输入静态库文件路径
outputdir	必需。输出目录路径
opt	可选。选项

utils.binary.rpath.list

获取 rpath 列表。

函数原型

::: tip API

local rpaths = rpath.list(binaryfile: <string>, opt: <table>)

:::

参数说明

参数	描述
binaryfile	必需。输入二进制文件路径
opt	可选。选项

返回值说明

返回值	描述
<table>	rpath 列表

utils.binary.rpath.insert

插入 rpath。

函数原型

::: tip API

rpath.insert(binaryfile: <string>, rpath_path: <string>, opt: <table>)

:::

参数说明

参数	描述
binaryfile	必需。输入二进制文件路径
rpath_path	必需。插入的 rpath 路径
opt	可选。选项

utils.binary.rpath.change

修改 rpath。

函数原型

::: tip API

rpath.change(binaryfile: <string>, rpath_old: <string>, rpath_new: <string>, opt: <table>)

:::

参数说明

参数	描述
binaryfile	必需。输入二进制文件路径
rpath_old	必需。旧的 rpath 路径
rpath_new	必需。新的 rpath 路径
opt	可选。选项

utils.binary.rpath.remove

删除 rpath。

函数原型

::: tip API

import("utils.binary.rpath")
import("utils.binary.rpath")
rpath.remove(binaryfile: <string>, rpath_path: <string>, opt: <table>)

:::

参数说明

参数	描述
binaryfile	必需。输入二进制文件路径
rpath_path	必需。删除的 rpath 路径
opt	可选。选项

utils.binary.rpath.clean

清除所有 rpath。

函数原型

::: tip API

rpath.clean(binaryfile: <string>, opt: <table>)

:::

参数说明

参数	描述
binaryfile	必需。输入二进制文件路径
opt	可选。选项