专栏首页Rust语言学习交流【Rust每周一知】Rust 中的 bin, lib, rlib, a, so 概念介绍

【Rust每周一知】Rust 中的 bin, lib, rlib, a, so 概念介绍

写了这么久的 Rust 代码了,可能很多人还对 Rust 的编译后的文件格式不是很清晰。本篇我们就来理一下,Rust 中的 bin, lib, rlib, a, so 是什么,如何生成,以及其它一些细节。

从 cargo new 说起

我们创建一个新工程,通常从下面两句入手:

cargo new foobar

cargo new --lib foobar

前者创建一个可执行工程,而后者创建一个库工程。

实际上,你去探索上述命令行生成的文件,发现它们的 Cargo.toml 完全一样,区别仅在于 src 目录下,可执行工程是一个 main.rs,而库工程是一个 lib.rs。

这是因为 main.rs 和 lib.rs 对于一个 crate 来讲,是两个特殊的文件名。rustc 内置了对这两个特殊文件名的处理(当然也可以通过 Cargo.toml 进行配置,不详谈),我们可以认为它们就是一个 crate 的入口。

可执行 crate 和库 crate 是两种不同的 crate。下面我们就来一并说一下它们的兄弟姐妹及其之间的异同。

crate type

执行

rustc --help|grep crate-type

可得到如下输出

       --crate-type [bin|lib|rlib|dylib|cdylib|staticlib|proc-macro]

才发现,原来有这么多种 crate type。下面挨个看一下。

bin

二进制可执行 crate,编译出的文件为二进制可执行文件。必须要有 main 函数作为入口。这种 crate 不需要在 Cargo.toml 中或 --crate-type 命令行参数中指定,会自动识别。

lib

库 crate。它其实并不是一种具体的库,它指代后面各种库 crate 中的一种,可以认为是一个代理名称(alias)。

通常来讲,如果什么都不配置,默认指的是 rlib, 会生成 .rlib 的文件。

rlib

rlib 是 Rust Library 特定静态中间库格式。如果只是纯 Rust 代码项目之间的依赖和调用,那么,用 rlib 就能完全满足使用需求。

rlib 实现为一个 ar 归档文件。

> file target/debug/libfoobar.rlib
target/debug/libfoobar.rlib: current ar archive

rlib 中包含很多 metadata 信息(比如可能的上游依赖信息),用来做后面的 linkage。

在 Cargo.toml 中配置:

[lib]
name = "foobar"
crate-type = ["rlib"]

可以指定生成 rlib,但是一般没必要设置,因为默认 lib 就是 rlib。

rlib 是平台(Linux, MacOS, Windows ...)无关的。

dylib

动态库。

在 Cargo.toml 中配置:

[lib]
name = "foobar"
crate-type = ["dylib"]

会在编译的时候,生成动态库(Linux 上为 .so, MacOS 上为 .dylib, Windows 上为 .dll)。

动态库是平台相关的库。动态库在被依赖并链接时,不会被链接到目标文件中。这种动态库只能被 Rust 写的程序(或遵循 Rust 内部不稳定的规范的程序)调用。这个动态库可能依赖于其它动态库(比如,Linux 下用 C 语言写的 PostgreSQL 的 libpq.so,或者另一个编译成 "dylib" 的 Rust 动态库)。

cdylib

C规范动态库。

在 Cargo.toml 中配置:

[lib]
name = "foobar"
crate-type = ["cdylib"]

与 dylib 类似,也会生成 .so, .dylib 或 .dll 文件。但是这种动态库可以被其它语言调用(因为几乎所有语言都有遵循 C 规范的 FFI 实现),也就是跨语言 FFI 使用。这个动态库可能依赖于其它动态库(比如,Linux 下用 C 语言写的 PostgreSQL 的 libpq.so)。

staticlib

静态库。

在 Cargo.toml 中配置:

[lib]
name = "foobar"
crate-type = ["staticlib"]

编译会生成 .a 文件(在 Linux 和 MacOS 上),或 .lib 文件(在 Windows 上)。

编译器会把所有实现的 Rust 库代码以及依赖的库代码全部编译到一个静态库文件中,也就是对外界不产生任何依赖了。这特别适合将 Rust 实现的功能封装好给第三方应用使用。

proc-macro

过程宏 crate.

在 Cargo.toml 中配置:

[lib]
name = "foobar"
crate-type = ["proc-macro"]

这种 crate 里面只能导出过程宏,被导出的过程宏可以被其它 crate 引用。


Crate type 以及它们之间的区别就介绍到这里了,有些细节还是需要仔细理解的。本篇意在阐述一些基础知识,而不打算成为一篇完整的参考文件,如要查看 Rust Linkage 的详细内容,直接访问 Rust Reference。

https://doc.rust-lang.org/reference/linkage.html

这一篇帖子非常有用:

https://users.rust-lang.org/t/what-is-the-difference-between-dylib-and-cdylib/28847

本文分享自微信公众号 - Rust语言学习交流(rust-china),作者:Mike Tang

原文出处及转载信息见文内详细说明,如有侵权,请联系 yunjia_community@tencent.com 删除。

原始发表时间:2020-01-16

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

我来说两句

0 条评论
登录 后参与评论

相关文章

  • Rust 视界 | 为 Rust 编译器提速

    #68914 : 增量编译使用「SipHasher128」哈希算法来确定自上一次编译器调用以来更改了哪些代码。此PR极大地改善了从输入字节流中提取字节的过程(...

    张汉东
  • 【Rust日报】2020-07-28 SO:在命令行下浏览StackOverflow

    在过去的几个星期,作者通过GDB调试了他们的动态链接器(ld.so)并找到了不少共享库的问题。

    MikeLoveRust
  • Rust入坑指南:智能指针

    在了解了Rust中的所有权、所有权借用、生命周期这些概念后,相信各位坑友对Rust已经有了比较深刻的认识了,今天又是一个连环坑,我们一起来把智能指针刨出来,一探...

    Jackeyzhe
  • 这次只学一点 Rust 语法大概不会怀孕了吧(1)

    本文来自喵哥 CrLF0710 的知乎:https://zhuanlan.zhihu.com/p/105181947

    MikeLoveRust
  • 周末学了点 Rust简介工具链宏(macros)返回值和错误处理Ownership 和生命周期闭包小结参考文档

    Rust 是最近几年开始兴起的编程语言,虽然目前还没看到要像 Go 一样”大火“的趋势。但是,官网的一些 featuring 看着就很让人心动(虽然还不知道现实...

    linjinhe
  • 这个周末,要不要学点 Rust?

    最近写了不少和 Rust 有关的文章,还在朋友圈分享了不少我在公司做 Rust training 时用 excalidraw 画的图,因而不少小伙伴们希望我能做...

    tyrchen
  • 【Rust日报】2020-07-30 fixed_vec减少Rust数组冗余边界检查

    rust的Vec在使用索引的时候总会触发边界检查,在某些时候降低了程序的性能。通常解决方法是尽可能使用迭代器来处理数组。

    MikeLoveRust
  • Rust入坑指南:朝生暮死

    在Rust入坑指南:核心概念一文中我们介绍了Rust的几个核心概念:所有权(Ownership)、所有权转移和所有权借用。今天就来介绍Rust中的另外一个核心概...

    Jackeyzhe
  • 系统编程语言Rust特点介绍(1)

    最近在学习Rust语言,感觉这门语言有点意思,因此写一篇文章分享。我不会去介绍Rust的基本语法,什么变量声明,if..else..,循环等等。这些东西,文档介...

    glinuxer
  • 系统编程语言Rust特点介绍(1)

    最近在学习Rust语言,感觉这门语言有点意思,因此写一篇文章分享。我不会去介绍Rust的基本语法,什么变量声明,if..else..,循环等等。这些东西,文档介...

    glinuxer
  • Rust入坑指南:万物初始

    有没有同学记得我们一起挖了多少个坑?嗯…其实我自己也不记得了,今天我们再来挖一个特殊的坑,这个坑可以说是挖到根源了——元编程。

    Jackeyzhe
  • 【深度知识】Rust语言入门、关键技术与实战经验

    编者按:高可用架构分享及传播在架构领域具有典型意义的文章,本文由唐刘在高可用架构群分享。转载请注明来自高可用架构公众号「 ArchNotes 」。

    辉哥
  • Rust入门之严谨如你

    Rust作为一门快速发展的编程语言,已经在很多知名项目中使用,如firecracker、libra、tikv,包括Windows和Linux都在考虑Rust【1...

    Radar3
  • rust 开发编译 Android 动态库实践

    rust 的学习曲线比较陡峭,在开始学习之前建议看看王垠的这篇文章 《如何掌握所有的编程语言》,地址如下:

    音视频开发进阶
  • 【翻译】Rust生命周期常见误区

    我曾经有过的所有这些对生命周期的误解,现在有很多初学者也深陷于此。我用到的术语可能不是标准的,所以下面列了一个表格来解释它们的用意。

    MikeLoveRust
  • 【Rust日报】2020-08-09:1Paasword Linux版本

    1Password Linux版本,后端完全使用Rust重写,并且项目中使用了ring crypto库。使用下面的命令可以在ubuntu上安装1Password...

    MikeLoveRust
  • 【Rust日报】 2019-06-12:PingCAP人才计划培训课程 - Rust网络应用实践

    继续公开测试,检查是否有错别字、或表意错误等问题,然后在Pontoon上面进行审校。

    MikeLoveRust
  • Rust FFI 编程 - 其它语言调用 Rust 代码 - Python

    随着 Rust 生态的发展,一些 Rust 语言实现的优秀工具或基础协议库,受到越来越多的企业或开发者青睐。与此同时,使用 Rust 语言对已有产品和工具进行性...

    MikeLoveRust
  • Rust到底值不值得学--Rust对比、特色和理念

    其实我一直弄不明白一点,那就是计算机技术的发展,是让这个世界变得简单了,还是变得更复杂了。 当然这只是一个玩笑,可别把这个问题当真。

    俺踏月色而来

扫码关注云+社区

领取腾讯云代金券