Rust如何引入源码作为依赖

Rust,源码 · 浏览次数 : 271

小编点评

**解决方法:** 1. 在j4rs的`Cargo.toml`文件中更改`crate-type`的值。 ```toml [package] name = "j4rs" version = "0.15.4" edition = "2021" dependencies = { j4rs = { git = "https://github.com/astonbitecode/j4rs" } } ``` 2. 在项目构建之前,确保`Cargo.toml`文件在被编译的目录中。 ```bash cargo config --edit ``` 3. 重新构建项目以使用最新版本。

正文

问题描述

通常我们在rust项目中引入第三方依赖包时,会直接指定包的版本,这种方式指定后,Cargo在编译时会从crates.io这个源中下载这些依赖包。

[package]
name = "foo"
version = "0.1.0"
edition = "2021"

[dependencies]
j4rs = 0.15.3

比如这里我们就在项目中引用了j4rs这个包,这个包的主要作用是可以实现从Rust代码中调用Java代码。

博主在使用这个包时发现,crates.io上发布的最新版本0.15.3有bug,这个版本依赖了logback的新版本,而logback的新版本使用了Java 11进行编译。这就导致了j4rs 0.15.3这个版本不支持Java 8。

于是博主在github上向作者提了issue,作者很快就做了修改,并更新到了github项目的master分支上。然而作者却没有向crates.io推送最新版本的包,我们想用最新版本就不能直接引用crates.io上的版本。

想要解决这个问题也很简单,我们可以直接引用源码作为依赖,主要有一下两种方式。

方式一

Cargo支持直接引用git最新版本的代码

[package]
name = "foo"
version = "0.1.0"
edition = "2021"

[dependencies]
j4rs = { git = "https://github.com/astonbitecode/j4rs" }

方式二

引用本地源码

[package]
name = "foo"
version = "0.1.0"
edition = "2021"

[dependencies]
j4rs = { path = "../j4rs/rust" }

当我们引用三方包的源码后,编译时Cargo也会根据三方包的Cargo配置编译这些三方包的源码,然后把编译的结果输出到本项目的target/[debug/release]/deps目录下,这样本项目就可以使用这些三方包了。

博主在引用j4rs这个三方包时遇到了这个问题:release编译时,编译器提示,j4rs编译的输出命名冲突

解决方法

查看j4rs源码中的Cargo.toml文件

[package]
name = "j4rs"
version = "0.15.4"
...

[badges]
travis-ci = { repository = "astonbitecode/j4rs", branch = "master" }

[lib]
name = "j4rs"
crate-type = ["rlib", "cdylib"]
path = "src/lib.rs"

可以发现crate-type这里配置了两种编译结果crate类型。

crate类型

bin: 二进制可执行 crate,编译出的文件为二进制可执行文件。必须要有 main 函数作为入口。这种 crate 不需要在 Cargo.toml 中或 --crate-type 命令行参数中指定,会自动识别。
lib: 库crate。它其实并不是一种具体的库,它指代后面各种库 crate 中的一种,可以认为是一个代理名称(alias)。通常来讲,如果什么都不配置,默认指的是 rlib, 会生成 .rlib 的文件。
dylib: 会在编译的时候,生成动态库(Linux 上为 .so, MacOS 上为 .dylib, Windows 上为 .dll)。动态库是平台相关的库。动态库在被依赖并链接时,不会被链接到目标文件中。这种动态库只能被 Rust 写的程序(或遵循 Rust 内部不稳定的规范的程序)调用。这个动态库可能依赖于其它动态库(比如,Linux 下用 C 语言写的 PostgreSQL 的 libpq.so,或者另一个编译成 "dylib" 的 Rust 动态库)。
staticlib: 静态库。编译会生成 .a 文件(在 Linux 和 MacOS 上),或 .lib 文件(在 Windows 上)。编译器会把所有实现的 Rust 库代码以及依赖的库代码全部编译到一个静态库文件中,也就是对外界不产生任何依赖了。这特别适合将 Rust 实现的功能封装好给第三方应用使用。
cdylib: C规范动态库。与 dylib 类似,也会生成 .so, .dylib 或 .dll 文件。但是这种动态库可以被其它语言调用(因为几乎所有语言都有遵循 C 规范的 FFI 实现),也就是跨语言 FFI 使用。这个动态库可能依赖于其它动态库(比如,Linux 下用 C 语言写的 PostgreSQL 的 libpq.so)。
rlib: rlib 是 Rust Library 特定静态中间库格式。如果只是纯 Rust 代码项目之间的依赖和调用,那么,用 rlib 就能完全满足使用需求。rlib 实现为一个 ar 归档文件。rlib 中包含很多 metadata 信息(比如可能的上游依赖信息),用来做后面的 linkage。可以指定生成 rlib,但是一般没必要设置,因为默认 lib 就是 rlib。rlib 是平台(Linux, MacOS, Windows ...)无关的。
proc-marco: 这种 crate 里面只能导出过程宏,被导出的过程宏可以被其它 crate 引用。

具体解释

根据文档j4rs设置的两种crate类型,rlib表示rust本身定义的中间结果,如果rust代码互相引用,直接使用这种类型就可以。cdylib是符合c标准的动态链接库,这种方式编译的结果可以被其他语言作为动态库使用。

当我们进行release编译时,Cargo会根据配置帮我们编译j4rs这两种格式的目标输出。
这时Cargo就会提示我们输出了一个libj4rs.rlib文件,又要输出一个libj4rs.so文件,这两个库文件名字一样,冲突了。这会导致我们的代码在链接j4rs时无法选择应该使用哪个库。

因此解决方法是:只要在j4rs的源码里将Cargo.toml文件中的配置crate-type = ["rlib", "cdylib"]改为crate-type = ["rlib"]就可以了。

与Rust如何引入源码作为依赖相似的内容:

Rust如何引入源码作为依赖

问题描述 通常我们在rust项目中引入第三方依赖包时,会直接指定包的版本,这种方式指定后,Cargo在编译时会从crates.io这个源中下载这些依赖包。 [package] name = "foo" version = "0.1.0" edition = "2021" [dependencies]

文盘Rust -- 本地库引发的依赖冲突

clickhouse 的原生 rust 客户端目前比较好的有两个clickhouse-rs 和 clickhouse.rs 。两个库在单独使用时没有任何问题,但是,在同一工程同时引用时会报错。本篇内容主要讲解如何用rust语言解决本地库引发的依赖冲突问题

文盘Rust -- rust 连接云上数仓 starwift

最近想看看 rust 如何集成 clickhouse,又犯了好吃懒做的心理(不想自己建环境),刚好京东云发布了兼容ck 的云原生数仓 Starwfit,于是搞了个实例折腾一番。 Starwfit 是京东云自主研发的新一代云原生数据仓库,通过存算分离降低了存储成本,同时兼具性能和扩展弹性。其写入和查询速度可达到传统数据仓库的数倍,为用户提供实时数据分析能力。广泛应用于流量分析、精准营销、用户画像、广

【保姆级教程】如何用Rust编写一个ChatGPT桌面应用

为什么我们需要一个桌面应用?原因实在太多,我们需要便捷地导出记录,需要在回答长度超长的时候自动加上“继续”,需要收藏一些很酷很实用的prompt...... (首先我假设你是一名如我一样习惯用IDEA开发的java仔)

文盘Rust -- 给程序加个日志

日志是应用程序的重要组成部分。无论是服务端程序还是客户端程序都需要日志做为错误输出或者业务记录。在这篇文章中,我们结合log4rs聊聊rust 程序中如何使用日志。

文盘Rust -- 给程序加个日志

作者:贾世闻 日志是应用程序的重要组成部分。无论是服务端程序还是客户端程序都需要日志做为错误输出或者业务记录。在这篇文章中,我们结合[log4rs](https://github.com/estk/log4rs)聊聊rust 程序中如何使用日志。 [log4rs](https://github.co

文盘Rust -- 领域交互模式如何实现

书接上文,上回说到如何通过interactcli-rs四步实现一个命令行程序。但是 shell 交互模式在有些场景下用户体验并不是很好。比如我们要连接某个服务,比如 mysql 或者 redis 这样的服务。如果每次交互都需要输入地址、端口、用户名等信息,交互起来太麻烦。通常的做法是一次性输入和连接相关的信息或者由统一配置文件进行管理,然后进入领域交互模式,所有的命令和反馈都和该领域相关。inte

文盘Rust——起手式,CLI程序

我们来看看如何通过几个步骤快速的实现一个功能相对齐全的CLI程序。和做饭一样,能够快速获得成就感的方式是找半成品直接下锅炒一盘

9. 用Rust手把手编写一个wmproxy(代理,内网穿透等), HTTP2改造篇之HPACK示例, 了解http2头信息如何处理

9. 用Rust手把手编写一个wmproxy(代理,内网穿透等), HTTP2改造篇之HPACK示例, 了解http2头信息如何处理 项目 ++wmproxy++ gite: https://gitee.com/tickbh/wmproxy github: https://github.com/ti

文盘Rust -- r2d2 实现redis连接池

作者:贾世闻 我们在开发应用后端系统的时候经常要和各种数据库、缓存等资源打交道。这一期,我们聊聊如何访问redis 并将资源池化。 在一个应用后端程序访问redis主要要做的工作有两个,单例和池化。 在后端应用集成redis,我们主要用到以下几个crate:​ ​once_cell​​​、​ ​re