deltachat core rust

Delta聊天的核心库，用Rust写的

安装铁锈和货物

要下载并安装Rust编程语言的官方编译器，而货物包管理器请在您的用户环境中运行命令：

 $ curl https://sh.rustup.rs -sSf | sh

在Windows上，您可能还需要安装PERL才能编译Deltachat核心。

使用CLI客户端

使用cargo ：编译和运行Delta Chat Core命令行实用程序：

 $ cargo run --locked -p deltachat-repl -- ~/deltachat-db

其中〜/deltachat-db是数据库文件。如果不存在，Delta Chat将创建它。

可选地，使用deltachat-repl二进制

 $ cargo install --locked --path deltachat-repl/

并运行

 $ deltachat-repl ~/deltachat-db

配置您的帐户（如果尚未配置）：

 Delta Chat Core is awaiting your commands.
> set addr [email protected]
> set mail_pw yourpassword
> configure

连接到您的邮件服务器（如果已经配置）：

 > connect

创建联系人：

 > addcontact [email protected]
Command executed successfully.

列表联系人：

 > listcontacts
Contact#10: <name unset> <[email protected]>
Contact#1: Me √√ <[email protected]>

与您的朋友创建聊天并发送消息：

 > createchat 10
Single#10 created successfully.
> chat 10
Single#10: [email protected] [[email protected]]
> send hi
Message sent.

如果[email protected]使用deltachat，但没有收到仅发送的消息，建议检查Spam文件夹。众所周知，至少gmx.com将此类测试消息视为垃圾邮件，除非另外用Web界面告知。

在聊天中列出消息：

 > chat

有关更多命令类型：

 > help

安装libdeltachat系统宽

 $ git clone https://github.com/deltachat/deltachat-core-rust.git
$ cd deltachat-core-rust
$ cmake -B build . -DCMAKE_INSTALL_PREFIX=/usr
$ cmake --build build
$ sudo cmake --install build

发展

 # run tests
$ cargo test --all
# build c-ffi
$ cargo build -p deltachat_ffi --release

调试环境变量

• DCC_MIME_DEBUG ：如果将传出和传入的消息打印

• RUST_LOG=async_imap=trace,async_smtp=trace ：启用IMAP和SMTP跟踪。

昂贵的测试

有些测试很昂贵，并标有#[ignore] ，以运行这些测试，使用--ignored参数到测试二进制文件（不是货物本身）：

$ cargo test -- --ignored

模糊

cargo-bolero

$ cargo install cargo-bolero

与

$ cd fuzz
$ cargo bolero test fuzz_mailparse --release=false -s NONE

语料库是在fuzz/fuzz_targets/corpus上创建的，您可以在此处添加初始输入。对于fuzz_mailparse目标语料库，可以用../test-data/message/*.eml 。

用AFL而不是libfuzzer运行：

$ cargo bolero test fuzz_format_flowed --release=false -e afl -s NONE

特征

• vendored ：在将OpenSSL用于TLS时，这将捆绑一个供应商版本。

更新提供商数据

要将从提供商DB的更新添加到核心，请运行：

 ./src/provider/update.py ../provider-db/_providers/ > src/provider/data.rs

语言绑定和前端项目

语言绑定可用于：

• C [来源|文档]
• node.js
  • 通过JSON-RPC：[来源| ？ npm |文档]
  • 超过CFFI ¹ ：[来源| ？ npm |文档]
• Python [来源| ？ PYPI |文档]
• 去
  • 通过JSONRPC：[源]
  • 超过CFFI ¹ ：[源]
• 免费pascal ¹ [来源]
• Java和Swift （包含在Android/iOS存储库中）

以下“前端”项目利用了锈蚀图或其语言绑定：

• 安卓
• ios
• 桌面
• pidgin
• 心灵感应
• Ubuntu触摸
• 几个机器人

脚注

1. 如果您喜欢这些语言，请过期 /未受欢迎，可以随意开始维护它们。如果您有疑问，我们会为您提供帮助，请在问题中询问。 ^{↩↩2↩3​}