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