プロジェクトセットアップ

Tauri v2アプリのCargo.toml、tauri.conf.json、capabilities、ディレクトリ構成の完全ガイド

プロジェクトセットアップ

このページでは、Tauri v2 プロジェクトに必要な設定ファイルについて解説する。すべての例は実際に動作するアプリケーションから抽出したものである。

ディレクトリ構成

典型的な Tauri v2 プロジェクトは以下のレイアウトに従う:

my-app/
  Cargo.toml          # Rust の依存関係とパッケージ設定
  build.rs            # Tauri ビルドスクリプト（必須）
  tauri.conf.json     # Tauri 固有の設定
  capabilities/
    default.json      # パーミッションとセキュリティ capabilities
  src/
    main.rs           # アプリケーションのエントリーポイント
    lib.rs            # オプションのライブラリモジュール
  frontend/           # 静的ローディングページ（frontendDist の対象）
    index.html
  binaries/           # sidecar binary（externalBin 使用時）
    node-aarch64-apple-darwin
  .gitignore

Cargo.toml

最小構成

軽量ラッパーアプリの場合、依存関係は最小限で済む:

[package]
name = "my-app"
version = "0.1.0"
edition = "2021"

[dependencies]
tauri = { version = "2", features = ["devtools"] }
libc = "0.2"

[build-dependencies]
tauri-build = { version = "2", features = [] }

devtools フィーチャーは WebView の開発者ツール切り替えを有効にする。libc クレートは Unix システムでのプロセスシグナル処理（SIGTERM、SIGKILL）に必要である。

フル機能構成

より多くの機能（ダイアログ、シェルアクセス、プライベート API、PTY サポート）を持つアプリの場合:

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

[lib]
name = "zudotext_lib"
path = "src/lib.rs"

[dependencies]
tauri = { version = "2", features = ["devtools", "macos-private-api", "webview-data-url"] }
tauri-plugin-dialog = "2"
tauri-plugin-shell = "2"
serde = { version = "1", features = ["derive"] }
serde_json = "1"
libc = "0.2"
tokio = { version = "1", features = ["sync", "net"] }

[target.'cfg(target_os = "macos")'.dependencies]
objc2-app-kit = { version = "0.3", features = ["NSWindow"] }
objc2-foundation = { version = "0.3", features = ["NSUserDefaults", "NSString"] }

[build-dependencies]
tauri-build = { version = "2", features = [] }

よく使われる Tauri フィーチャー

build.rs

すべての Tauri プロジェクトには build.rs ファイルが必要である。内容は常に同じだ:

fn main() {
    tauri_build::build()
}

これは必須であり省略できない。このファイルがないと、main.rs 内の tauri::generate_context!() がコンパイルに失敗する。

tauri.conf.json

Tauri アプリの中核となる設定ファイルである。構造はアプリの要件によって異なる。

軽量ラッパー（開発サーバー型）

外部の開発サーバーをラップするパターンである。サーバーの起動中は frontendDist のローディングページを表示し、起動完了後に開発サーバーの URL にナビゲートする。

{
  "$schema": "https://schema.tauri.app/config/2",
  "productName": "zmod doc",
  "version": "0.1.0",
  "identifier": "com.takazudo.zmod-doc",
  "build": {
    "frontendDist": "./frontend",
    "beforeDevCommand": "cd ../../doc && pnpm dev",
    "devUrl": "http://localhost:32342/"
  },
  "app": {
    "windows": [],
    "security": {
      "csp": null
    }
  },
  "bundle": {
    "active": true,
    "targets": "all",
    "icon": [],
    "category": "DeveloperTool",
    "macOS": {
      "minimumSystemVersion": "10.15"
    }
  }
}

フル機能アプリ

独自の Vite ビルドフロントエンドを持つアプリ:

{
  "$schema": "https://schema.tauri.app/config/2",
  "productName": "zudotext",
  "version": "0.1.0",
  "identifier": "com.takazudo.zudotext",
  "build": {
    "beforeDevCommand": "pnpm exec vite --config vite.config.ts",
    "beforeBuildCommand": "pnpm exec vite build --config vite.config.ts",
    "devUrl": "http://localhost:37461",
    "frontendDist": "./dist-renderer"
  },
  "app": {
    "macOSPrivateApi": true,
    "windows": [],
    "security": {
      "csp": null
    }
  },
  "bundle": {
    "active": true,
    "targets": "all",
    "category": "DeveloperTool",
    "macOS": {
      "minimumSystemVersion": "10.15"
    }
  }
}

バンドル済み sidecar アプリ

Node.js binary を外部 sidecar としてバンドルするアプリ:

{
  "$schema": "https://schema.tauri.app/config/2",
  "productName": "Claude Resources",
  "version": "0.1.0",
  "identifier": "com.takazudo.claude-resources",
  "build": {
    "frontendDist": "./frontend"
  },
  "app": {
    "windows": [],
    "security": {
      "csp": null
    }
  },
  "bundle": {
    "active": true,
    "targets": "all",
    "icon": [],
    "category": "DeveloperTool",
    "externalBin": ["binaries/node"],
    "macOS": {
      "minimumSystemVersion": "10.15"
    }
  }
}

主要フィールドの解説

build

app

bundle

Capabilities (capabilities/default.json)

Capabilities はアプリに許可される操作を定義する。capabilities/default.json を作成する:

{
  "identifier": "default",
  "windows": ["main"],
  "remote": {
    "urls": ["http://localhost:*/**"]
  },
  "permissions": ["core:default", "dialog:default", "shell:default"]
}

フィールド

.gitignore

Tauri プロジェクトでは以下のエントリを追加する:

/target/
/gen/
/binaries/