configuring-tauri-apps

Tauri 設定ファイル

Tauri v2 アプリケーションでは、アプリケーションの動作、依存関係、ビルドプロセスを管理するために、主に3つの設定ファイルを使用します。

設定ファイルの概要

ファイル	用途	形式
tauri.conf.json	Tauri 固有の設定	JSON、JSON5、または TOML
Cargo.toml	Rust の依存関係とメタデータ	TOML
package.json	フロントエンドの依存関係とスクリプト	JSON

tauri.conf.json

src-tauri/ にあるメインの設定ファイルです。アプリケーションのメタデータ、ウィンドウの動作、バンドルオプション、プラグイン設定を定義します。

サポートされている形式

• JSON（デフォルト）：tauri.conf.json
• JSON5：tauri.conf.json5（config-json5 Cargo 機能が必要です）
• TOML：Tauri.toml（config-toml Cargo 機能が必要です）

完全な設定構造

{
  "$schema": "https://schema.tauri.app/config/2",
  "productName": "MyApp",
  "version": "1.0.0",
  "identifier": "com.company.myapp",
  "mainBinaryName": "my-app",
  "build": {
    "devUrl": "http://localhost:3000",
    "frontendDist": "../dist",
    "beforeDevCommand": "npm run dev",
    "beforeBuildCommand": "npm run build",
    "features": ["custom-feature"],
    "removeUnusedCommands": true
  },
  "app": {
    "withGlobalTauri": false,
    "macOSPrivateApi": false,
    "windows": [
      {
        "title": "My Application",
        "width": 1200,
        "height": 800,
        "minWidth": 800,
        "minHeight": 600,
        "resizable": true,
        "fullscreen": false,
        "center": true,
        "visible": true,
        "decorations": true,
        "transparent": false,
        "alwaysOnTop": false,
        "focus": true,
        "url": "index.html"
      }
    ],
    "security": {
      "capabilities": [],
      "assetProtocol": {
        "enable": true,
        "scope": ["$APPDATA/**"]
      },
      "pattern": { "use": "brownfield" },
      "freezePrototype": false
    },
    "trayIcon": {
      "id": "main-tray",
      "iconPath": "icons/tray.png",
      "iconAsTemplate": true
    }
  },
  "bundle": {
    "active": true,
    "targets": "all",
    "icon": ["icons/32x32.png", "icons/128x128.png", "icons/icon.icns", "icons/icon.ico"],
    "resources": ["assets/**/*"],
    "copyright": "Copyright 2024",
    "category": "Utility",
    "shortDescription": "A short app description",
    "longDescription": "A longer description",
    "licenseFile": "../LICENSE",
    "windows": {
      "certificateThumbprint": null,
      "timestampUrl": "http://timestamp.digicert.com",
      "nsis": { "license": "../LICENSE", "installerIcon": "icons/icon.ico", "installMode": "currentUser" }
    },
    "macOS": {
      "minimumSystemVersion": "10.13",
      "signingIdentity": null,
      "dmg": { "appPosition": { "x": 180, "y": 170 }, "applicationFolderPosition": { "x": 480, "y": 170 } }
    },
    "linux": {
      "appimage": { "bundleMediaFramework": false },
      "deb": { "depends": ["libwebkit2gtk-4.1-0"] },
      "rpm": { "depends": ["webkit2gtk4.1"] }
    },
    "android": { "minSdkVersion": 24 },
    "iOS": { "minimumSystemVersion": "13.0" }
  },
  "plugins": {
    "updater": {
      "pubkey": "YOUR_PUBLIC_KEY",
      "endpoints": ["https://releases.example.com/{{target}}/{{arch}}/{{current_version}}"]
    }
  }
}

ルートレベルのフィールド

フィールド	型	必須	説明
productName	string	いいえ	アプリケーションの表示名
version	string	いいえ	Semver バージョン、または package.json へのパス
identifier	string	はい	逆ドメイン形式の識別子（例：com.tauri.example）
mainBinaryName	string	いいえ	メインバイナリのファイル名を上書きします

ビルド設定フィールド

フィールド	型	説明
devUrl	string	ホットリロード用の開発サーバー URL
frontendDist	string	ビルド済みフロントエンドアセットのパス、またはリモート URL
beforeDevCommand	string	tauri dev の前に実行するスクリプト
beforeBuildCommand	string	tauri build の前に実行するスクリプト
features	string[]	ビルド時に有効にする Cargo 機能
removeUnusedCommands	boolean	未使用のプラグインコマンドをバイナリから削除します

ウィンドウ設定オプション

フィールド	型	デフォルト	説明
title	string	"Tauri"	ウィンドウタイトル
width / height	number	800 / 600	ウィンドウのピクセル単位のサイズ
minWidth / minHeight	number	-	最小サイズ
maxWidth / maxHeight	number	-	最大サイズ
x / y	number	-	ウィンドウの位置
resizable	boolean	true	ウィンドウのサイズ変更を許可します
fullscreen	boolean	false	全画面表示で起動します
center	boolean	false	ウィンドウを画面中央に配置します
visible	boolean	true	起動時のウィンドウの表示状態
decorations	boolean	true	ウィンドウの装飾を表示します
transparent	boolean	false	ウィンドウの透明化を有効にします
alwaysOnTop	boolean	false	ウィンドウを常に最前面に表示します
url	string	"index.html"	最初に読み込む URL

セキュリティ設定

フィールド	型	説明
capabilities	string[]	アプリケーションの権限機能
assetProtocol.enable	boolean	カスタムアセットプロトコルを有効にします
assetProtocol.scope	string[]	アセットプロトコルで許可するパス
pattern.use	string	セキュリティパターン（デフォルトは"brownfield"）
freezePrototype	boolean	プロトタイプの変更を防止します

プラットフォーム別のバンドルターゲット

プラットフォーム	ターゲット
Windows	nsis、msi
macOS	app、dmg
Linux	appimage、deb、rpm
Android	apk、aab
iOS	app

プラットフォーム固有の設定

JSON Merge Patch（RFC 7396）を使用して基本設定を上書きする、プラットフォーム固有のファイルを作成します。

プラットフォーム	ファイル名
Linux	tauri.linux.conf.json
Windows	tauri.windows.conf.json
macOS	tauri.macos.conf.json
Android	tauri.android.conf.json
iOS	tauri.ios.conf.json

src-tauri/tauri.windows.conf.json の例：

{
  "app": {
    "windows": [{ "title": "My App - Windows Edition" }]
  },
  "bundle": {
    "windows": { "nsis": { "installMode": "perMachine" } }
  }
}

src-tauri/tauri.macos.conf.json の例：

{
  "app": { "macOSPrivateApi": true },
  "bundle": {
    "macOS": { "minimumSystemVersion": "11.0", "entitlements": "entitlements.plist" }
  }
}

CLI 設定の上書き

# Development with custom config
tauri dev --config src-tauri/tauri.dev.conf.json

# Build with beta configuration
tauri build --config src-tauri/tauri.beta.conf.json

# Inline configuration override
tauri build --config '{"bundle":{"identifier":"com.company.myapp.beta"}}'

Cargo.toml の設定

src-tauri/Cargo.toml にあり、Rust の依存関係を管理します。

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

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

[dependencies]
serde = { version = "1.0", features = ["derive"] }
serde_json = "1.0"
tauri = { version = "2.0", features = [] }
tauri-plugin-shell = "2.0"
tauri-plugin-opener = "2.0"

[features]
default = ["custom-protocol"]
custom-protocol = ["tauri/custom-protocol"]

Tauri の一般的な機能

[dependencies]
tauri = { version = "2.0", features = [
  "config-json5",      # Enable JSON5 config format
  "config-toml",       # Enable TOML config format
  "devtools",          # Enable WebView devtools
  "macos-private-api", # Enable macOS private APIs
  "tray-icon",         # Enable system tray support
  "image-png",         # PNG image support
  "image-ico",         # ICO image support
  "protocol-asset"     # Custom asset protocol
] }

バージョン管理

tauri = { version = "2.0" }       # Semver-compatible (recommended)
tauri = { version = "=2.0.0" }    # Exact version
tauri = { version = "~2.0.0" }    # Patch updates only

package.json との統合

{
  "name": "my-tauri-app",
  "version": "1.0.0",
  "scripts": {
    "dev": "vite",
    "build": "vite build",
    "tauri": "tauri"
  },
  "dependencies": { "@tauri-apps/api": "^2.0.0" },
  "devDependencies": { "@tauri-apps/cli": "^2.0.0" }
}

環境固有の設定

開発環境（src-tauri/tauri.dev.conf.json）

{
  "build": { "devUrl": "http://localhost:5173" },
  "app": {
    "withGlobalTauri": true,
    "windows": [{ "title": "My App [DEV]" }]
  }
}

本番環境（src-tauri/tauri.prod.conf.json）

{
  "build": { "frontendDist": "../dist", "removeUnusedCommands": true },
  "bundle": { "active": true, "targets": "all" }
}

ベータ環境（src-tauri/tauri.beta.conf.json）

{
  "identifier": "com.company.myapp.beta",
  "productName": "MyApp Beta",
  "plugins": {
    "updater": {
      "endpoints": ["https://beta-releases.example.com/{{target}}/{{arch}}/{{current_version}}"]
    }
  }
}

TOML 設定形式

Tauri.toml を使用する場合、設定にはケバブケースを使用します。

[build]
dev-url = "http://localhost:3000"
before-dev-command = "npm run dev"
before-build-command = "npm run build"

[app]
with-global-tauri = false

[[app.windows]]
title = "My Application"
width = 1200
height = 800
resizable = true
center = true

[app.security]
freeze-prototype = false

[app.security.asset-protocol]
enable = true
scope = ["$APPDATA/**"]

[bundle]
active = true
targets = "all"
icon = ["icons/32x32.png", "icons/128x128.png", "icons/icon.icns", "icons/icon.ico"]

[plugins.updater]
pubkey = "YOUR_PUBLIC_KEY"
endpoints = ["https://releases.example.com/{{target}}/{{arch}}/{{current_version}}"]

一般的な設定パターン

マルチウィンドウアプリケーション

{
  "app": {
    "windows": [
      { "label": "main", "title": "Main Window", "width": 1200, "height": 800, "url": "index.html" },
      { "label": "settings", "title": "Settings", "width": 600, "height": 400, "url": "settings.html", "visible": false }
    ]
  }
}

システムトレイアプリケーション

{
  "app": {
    "trayIcon": { "id": "main-tray", "iconPath": "icons/tray.png", "iconAsTemplate": true },
    "windows": [{ "visible": false }]
  }
}

プラグイン設定

{
  "plugins": {
    "updater": {
      "pubkey": "YOUR_PUBLIC_KEY",
      "endpoints": ["https://releases.example.com/{{target}}/{{arch}}/{{current_version}}"],
      "windows": { "installMode": "passive" }
    },
    "shell": {
      "open": true,
      "scope": [{ "name": "open-url", "cmd": "open", "args": [{ "validator": "\\S+" }] }]
    },
    "deep-link": {
      "mobile": ["myapp"],
      "desktop": { "schemes": ["myapp"] }
    }
  }
}

ロックファイル

再現可能なビルドを実現するため、ロックファイルをコミットしてください。

ファイル	用途
Cargo.lock	Rust の依存関係のバージョンを固定します
package-lock.json	npm の依存関係のバージョンを固定します
yarn.lock	Yarn の依存関係のバージョンを固定します
pnpm-lock.yaml	pnpm の依存関係のバージョンを固定します

設定の検証

エディターの自動補完には JSON スキーマを使用してください。

{ "$schema": "https://schema.tauri.app/config/2" }

tauri info を実行して、設定と環境のセットアップを確認してください。