インストール

PRX-EmailはRustライブラリ依存関係として使用するか、スタンドアロン使用のためにソースからビルドするか、PRXランタイム用のWASMプラグインとしてコンパイルできます。

推奨

ほとんどのユーザーにとって、PRX-EmailをCargo依存関係として追加することがRustプロジェクトにメール機能を統合する最も速い方法です。

前提条件

要件	最小	備考
Rust	1.85.0 (2024 edition)	すべてのインストール方法に必要
Git	2.30+	リポジトリをクローンするため
SQLite	bundled	`rusqlite` bundledフィーチャーで含まれる。システムSQLiteは不要
`wasm32-wasip1`ターゲット	latest	WASMプラグインのコンパイルにのみ必要

方法1：Cargo依存関係（推奨）

プロジェクトのCargo.tomlにPRX-Emailを追加します：

toml

[dependencies]
prx_email = { git = "https://github.com/openprx/prx_email.git" }

これはライブラリとすべての依存関係（rusqlite（bundled SQLite）、imap、lettre、mail-parser）を取得します。

ビルド依存関係

rusqlite bundledフィーチャーはCソースからSQLiteをコンパイルします。Debian/Ubuntuでは以下が必要な場合があります：

bash

sudo apt install -y build-essential pkg-config

macOSではXcode Command Line Toolsが必要です：

bash

xcode-select --install

方法2：ソースからビルド

リポジトリをクローンしてリリースモードでビルドします：

bash

git clone https://github.com/openprx/prx_email.git
cd prx_email
cargo build --release

すべてが動作することを確認するためにテストスイートを実行します：

bash

cargo test

lint検証のためにclippyを実行します：

bash

cargo clippy -- -D warnings

方法3：WASMプラグイン

WASMプラグインにより、PRX-EmailはPRXランタイム内でサンドボックス化されたWebAssemblyモジュールとして実行できます。プラグインはWIT（WebAssembly Interface Types）を使用してホスト呼び出しインターフェースを定義します。

WASMプラグインをビルドする

bash

cd prx_email

# Add the WASM target
rustup target add wasm32-wasip1

# Build the plugin
cd wasm-plugin
cargo build --release --target wasm32-wasip1

コンパイルされたプラグインはwasm-plugin/target/wasm32-wasip1/release/prx_email_plugin.wasmにあります。

または、ビルドスクリプトを使用します：

bash

chmod +x scripts/build_wasm_plugin.sh
./scripts/build_wasm_plugin.sh

プラグイン設定

WASMプラグインにはwasm-plugin/ディレクトリにプラグインメタデータと機能を定義するplugin.tomlマニフェストが含まれています。

ネットワーク安全スイッチ

デフォルトでは、WASMプラグインは実際のネットワーク操作が無効な状態で実行されます。WASMコンテキストから実際のIMAP/SMTP接続を有効にするには：

bash

export PRX_EMAIL_ENABLE_REAL_NETWORK=1

無効な場合、ネットワーク依存の操作（email.sync、email.send、email.reply）はガードヒント付きの制御されたエラーを返します。これはサンドボックス化されたプラグインからの意図しないネットワークアクセスを防ぐための安全措置です。

依存関係

PRX-Emailは以下の主要な依存関係を使用します：

クレート	バージョン	目的
`rusqlite`	0.31	bundled Cコンパイルを持つSQLiteデータベース
`imap`	2.4	受信トレイ同期用IMAPクライアント
`lettre`	0.11	メール送信用SMTPクライアント
`mail-parser`	0.10	MIMEメッセージパース
`rustls`	0.23	IMAP接続用TLS
`rustls-connector`	0.20	TLSストリームラッパー
`serde` / `serde_json`	1.0	モデルとAPIレスポンスのシリアライゼーション
`sha2`	0.10	フォールバックメッセージIDのためのSHA-256
`base64`	0.22	添付ファイルのBase64エンコード
`thiserror`	1.0	エラー型の導出

すべてのTLS接続はrustls（Pure Rust）を使用します。OpenSSLの依存関係なし。