本文檔對比 Tauri v1 和 v2 版本的配置結構和內容差異，幫助開發者了解版本變更并進行遷移。

配置結構變化

v1 配置結構

{"package": { ... },"tauri": { "allowlist": { ... },"bundle": { ... },"security": { ... },"updater": { ... },"windows": [ ... ]},"build": { ... },"plugins": { ... }
}

v2 配置結構

{"identifier": "...","productName": "...", "version": "...","app": {"security": { ... },"windows": [ ... ]},"build": { ... },"bundle": { ... }, "plugins": { ... }
}

主要變化

根級配置

v1	v2	說明
package.productName	productName	移至根級
package.version	version	移至根級
-	identifier	新增，必填項，應用唯一標識符
-	mainBinaryName	新增，可選，主二進制文件名

根級配置示例

v1 配置:

{"package": {"productName": "我的Tauri應用","version": "0.1.0"},"tauri": { ... }
}

v2 配置:

{"identifier": "com.example.myapp","productName": "我的Tauri應用","version": "0.1.0","app": { ... }
}

核心配置項

v1	v2	說明
tauri	app	重命名
tauri.allowlist	app.security.capabilities	權限系統重構
tauri.bundle	bundle	移至根級
tauri.security	app.security	移動位置
tauri.updater	bundle.createUpdaterArtifacts	簡化為布爾值
tauri.windows	app.windows	移動位置

開發構建配置

v1	v2	說明
build.devPath	build.devUrl	重命名
build.distDir	build.frontendDist	重命名
build.withGlobalTauri	app.withGlobalTauri	移至app配置
-	build.removeUnusedCommands	新增

構建配置示例

v1 配置:

{"build": {"devPath": "http://localhost:3000","distDir": "../dist","withGlobalTauri": true}
}

v2 配置:

{"build": {"devUrl": "http://localhost:3000","frontendDist": "../dist","removeUnusedCommands": true},"app": {"withGlobalTauri": true}
}

安全配置

v1	v2	說明
tauri.security.csp	app.security.csp	位置變更
tauri.security.freezePrototype	app.security.freezePrototype	位置變更
tauri.security.dangerousDisableAssetCspModification	app.security.dangerousDisableAssetCspModification	位置變更
tauri.security.dangerousRemoteDomainIpcAccess	-	已移除
tauri.security.dangerousUseHttpScheme	-	已移除
-	app.security.pattern	新增安全模式配置
-	app.security.assetProtocol	新增資源協議安全配置

安全配置示例

v1 配置:

{"tauri": {"security": {"csp": "default-src 'self'","freezePrototype": true,"dangerousDisableAssetCspModification": false}}
}

v2 配置:

{"app": {"security": {"csp": "default-src 'self'","freezePrototype": true,"dangerousDisableAssetCspModification": false,"pattern": {"use": "brownfield"},"assetProtocol": {"enable": true,"scope": ["**/*.html", "**/*.js", "**/*.css", "**/*.png"]}}}
}

權限系統（Capabilities）

v2 引入了全新的權限系統，替代了 v1 的 allowlist。新系統更靈活、更安全，使用 capabilities 配置。

v1 權限配置 (allowlist):

{"tauri": {"allowlist": {"fs": {"all": true,"readFile": true,"writeFile": true,"scope": ["$APPDATA/**", "$APPCONFIG/**"]},"dialog": {"all": true},"shell": {"execute": true,"scope": [{ "name": "node", "cmd": "node", "args": true }]}}}
}

v2 權限配置 (capabilities):

{"app": {"security": {"capabilities": [{"identifier": "fs:default","allow": [{ "path": "$APPDATA/**" },{ "path": "$APPCONFIG/**" }]},{"identifier": "dialog:default"},{"identifier": "shell:allow-execute","permissions": ["allow-execute-command"],"commands": [{ "name": "node", "args": true }]}]}}
}

打包配置

v1	v2	說明
tauri.bundle.active	bundle.active	位置變更
tauri.bundle.targets	bundle.targets	位置變更
tauri.bundle.icon	bundle.icon	位置變更
-	bundle.createUpdaterArtifacts	新增，替代v1的updater配置
-	bundle.useLocalToolsDir	新增

平臺特定配置

v1	v2	說明
tauri.bundle.windows	bundle.windows	位置變更
tauri.bundle.macOS	bundle.macOS	位置變更
tauri.bundle.linux	bundle.linux	位置變更
-	bundle.android	新增，支持Android平臺
-	bundle.iOS	新增，支持iOS平臺

移動平臺配置

v2新增了對移動平臺的支持，下面是移動平臺特有的配置示例：

Android 配置:

{"bundle": {"android": {"versionCode": 1,"minSdkVersion": 24,"targetSdkVersion": 33,"icon": "icons/android-icon.png","packageName": "com.example.myapp","useCustomStatusBarColor": true,"statusBarColor": "#FFFFFF","keystore": {"path": "keystore.jks","keyAlias": "key0","password": "${ENV_PASSWORD}"}}}
}

iOS 配置:

{"bundle": {"iOS": {"developmentTeam": "ABCDE12345","minimumOsVersion": "13.0","deviceFamily": ["iphone", "ipad"],"infoPlist": {"NSCameraUsageDescription": "此應用需要訪問您的相機","NSPhotoLibraryUsageDescription": "此應用需要訪問您的照片庫","CFBundleURLTypes": [{"CFBundleURLName": "com.example.myapp","CFBundleURLSchemes": ["myapp"]}]}}}
}

窗口配置

v1和v2的窗口配置選項基本相同，但在v2中有以下新增屬性：

新增屬性	說明
shadow	窗口是否有陰影
theme	窗口主題（light/dark）
incognito	是否使用隱身模式
fileDropEnabled	是否允許文件拖放
label	窗口標簽，用于API引用

窗口配置示例

v1 配置:

{"tauri": {"windows": [{"title": "我的應用","width": 800,"height": 600,"resizable": true,"fullscreen": false}]}
}

v2 配置:

{"app": {"windows": [{"title": "我的應用","width": 800,"height": 600,"resizable": true,"fullscreen": false,"shadow": true,"theme": "light","incognito": false,"fileDropEnabled": true,"label": "main"}]}
}

插件系統變更

Tauri v2 的插件系統相比 v1 有重大更新，支持更靈活的插件配置：

v1 插件配置:

{"plugins": {"fs": {"scope": ["$APPDATA/**"]},"sql": {}}
}

v2 插件配置:

{"plugins": {"local-fs": {"scope": ["$APPDATA/**"]},"sql": {"allowedPaths": ["$APPDATA/database.sqlite"]}}
}

文件格式與平臺特定配置

文件格式

兩個版本都支持：

• JSON: tauri.conf.json（默認）
• JSON5: tauri.conf.json或tauri.conf.json5
• TOML: Tauri.toml

平臺特定配置

v1	v2	說明
tauri.linux.conf.json	tauri.linux.conf.json	無變化
tauri.windows.conf.json	tauri.windows.conf.json	無變化
tauri.macos.conf.json	tauri.macos.conf.json	無變化
-	tauri.android.conf.json	新增，Android平臺配置
-	tauri.ios.conf.json	新增，iOS平臺配置

遷移指南

從 Tauri v1 遷移到 v2 時，建議按照以下步驟操作：

1. 必填字段添加：

   • 添加必需的identifier字段，使用反向域名表示法（如com.company.app）

2. 基本結構調整：

   • 將package配置移至根級
   • 將tauri更改為app
   • 將bundle移至根級

3. 構建配置更新：

   • 將devPath更新為devUrl
   • 將distDir更新為frontendDist
   • 將withGlobalTauri移至app配置

4. 權限系統遷移：

   • 將allowlist遷移到新的capabilities權限系統
   • 對每個權限定義identifier和具體的權限范圍

5. 安全配置更新：

   • 將所有安全相關配置移至app.security
   • 添加新的pattern和assetProtocol配置

6. 窗口配置更新：

   • 調整窗口配置路徑為app.windows
   • 考慮使用新增的窗口屬性增強功能

7. 更新器配置：

   • 將復雜的updater配置替換為簡單的bundle.createUpdaterArtifacts布爾值

8. 移動平臺支持（如需）：

   • 添加bundle.android和bundle.iOS配置

遷移示例

以下是一個完整的遷移示例，展示從 v1 到 v2 的具體配置變化：

v1 配置文件:

{"package": {"productName": "我的Tauri應用","version": "0.1.0"},"tauri": {"allowlist": {"fs": {"all": true,"scope": ["$APPDATA/**"]},"dialog": {"all": true}},"bundle": {"active": true,"icon": "icons/icon.png","targets": ["deb", "msi", "dmg"]},"security": {"csp": "default-src 'self'"},"updater": {"active": true,"endpoints": ["https://example.com/update-feed.json"]},"windows": [{"title": "我的應用","width": 800,"height": 600}]},"build": {"devPath": "http://localhost:3000","distDir": "../dist"}
}

v2 配置文件:

{"identifier": "com.example.myapp","productName": "我的Tauri應用","version": "0.1.0","app": {"security": {"csp": "default-src 'self'","capabilities": [{"identifier": "fs:default","allow": [{ "path": "$APPDATA/**" }]},{"identifier": "dialog:default"}]},"windows": [{"title": "我的應用","width": 800,"height": 600,"label": "main"}]},"build": {"devUrl": "http://localhost:3000","frontendDist": "../dist"},"bundle": {"active": true,"icon": "icons/icon.png","targets": ["deb", "msi", "dmg"],"createUpdaterArtifacts": true}
}

參考資料

• Tauri v1配置文檔
• Tauri v2配置文檔
• Tauri v1配置Schema
• Tauri v2配置Schema