macOS 应用程序包
应用程序包是在 macOS 上执行的包格式。它是一个简单的目录,其中包含应用程序成功运行所需的一切,包括您的应用程序可执行文件、资源、Info.plist 文件和其他文件,例如 macOS 框架。
要将您的应用程序打包为 macOS 应用程序包,您可以使用 Tauri CLI 并在 Mac 计算机中运行 tauri build
命令
npm run tauri build -- --bundles app
yarn tauri build --bundles app
pnpm tauri build --bundles app
deno task tauri build --bundles app
bun tauri build --bundles app
cargo tauri build --bundles app
文件结构
macOS 应用程序包是一个具有以下结构的目录
├── <productName>.app│ ├── Contents│ │ ├── Info.plist│ │ ├── ...additional files from [`tauri.conf.json > bundle > macOS > files`]│ ├── MacOS│ │ ├── <app-name> (app executable)│ ├── Resources│ │ ├── icon.icns (app icon)│ │ ├── ...resources from [`tauri.conf.json > bundle > resources`]│ ├── _CodeSignature (codesign information generated by Apple)│ ├── Frameworks│ ├── PlugIns│ ├── SharedSupport
有关更多信息,请参阅官方文档。
原生配置
应用程序包由 Info.plist
文件配置,该文件包含键值对,其中包含您的应用程序标识和 macOS 读取的配置值。
Tauri 会自动配置最重要的属性,例如您的应用程序二进制文件名称、版本、bundle 标识符、最低系统版本等等。
要扩展配置文件,请在 src-tauri
文件夹中创建一个 Info.plist
文件,并包含您想要的键值对
<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"><plist version="1.0"><dict> <key>NSCameraUsageDescription</key> <string>Request camera access for WebRTC</string> <key>NSMicrophoneUsageDescription</key> <string>Request microphone access for WebRTC</string></dict></plist>
此 Info.plist
文件与 Tauri CLI 生成的值合并。 覆盖应用程序版本等默认值时要小心,因为它们可能会与其他配置值冲突并引入意外行为。
有关更多信息,请参阅官方 Info.plist 文档。
Info.plist 本地化
Info.plist
文件本身仅支持一种语言,通常是英语。 如果您想支持多种语言,您可以为每种其他语言创建 InfoPlist.strings
文件。 每个文件都属于其自己特定于语言的 lproj
目录,该目录位于应用程序包的 Resources
目录中。
要自动捆绑这些文件,您可以利用 Tauri 的资源功能。 为此,请在您的项目中创建一个遵循以下模式的文件结构
├── src-tauri│ ├── tauri.conf.json│ ├── infoplist│ │ ├── de.lproj│ │ │ ├── InfoPlist.strings│ │ ├── fr.lproj│ │ │ ├── InfoPlist.strings
虽然 infoplist
目录名称可以自由选择,只要您在下面的资源配置中更新它,lproj
目录必须遵循 <lang-code>.lproj
命名,并且字符串目录文件必须命名为 InfoPlist.strings
(大写 i 和 p)。 在大多数情况下,语言代码应为遵循 BCP 47 的两位字母代码。
对于上面显示的 Info.plist
示例,de.lproj > InfoPlist.strings
文件可能如下所示
NSCameraUsageDescription = "Kamera Zugriff wird benötigt für WebRTC Funktionalität";NSMicrophoneUsageDescription = "Mikrofon Zugriff wird benötigt für WebRTC Funktionalität";
最后,通过使用上面提到的资源功能,使 Tauri 拾取这些文件
{ "bundle": { "resources": { "infoplist/**": "./" } }}
Entitlements
授权是 Apple 特殊的配置键值对,它充当权利或特权,授予您的应用程序特定功能,例如充当用户的默认电子邮件客户端和使用 App Sandbox 功能。
授权在您的应用程序签名时应用。 有关更多信息,请参阅代码签名文档。
要定义您的应用程序所需的授权,您必须创建授权文件并配置 Tauri 以使用它。
- 在
src-tauri
文件夹中创建一个Entitlements.plist
文件,并配置您的应用程序所需的键值对
<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"><plist version="1.0"><dict> <key>com.apple.security.app-sandbox</key> <true/></dict></plist>
- 配置 Tauri 以使用 Entitlements.plist 文件
{ "bundle": { "macOS": { "entitlements": "./Entitlements.plist" } }}
有关更多信息,请参阅官方文档。
最低系统版本
默认情况下,您的 Tauri 应用程序支持 macOS 10.13 及更高版本。 如果您正在使用需要更新的 macOS 系统的 API,并且想要在您的应用程序包中强制执行该要求,您可以配置 tauri.conf.json > bundle > macOS > minimumSystemVersion
值
{ "bundle": { "macOS": { "minimumSystemVersion": "12.0" } }}
包含 macOS 框架
如果您的应用程序需要其他 macOS 框架才能运行,您可以在 tauri.conf.json > bundle > macOS > frameworks
配置中列出它们。 框架列表可以包括系统框架或自定义框架和 dylib 文件。
{ "bundle": { "macOS": { "frameworks": [ "CoreAudio", "./libs/libmsodbcsql.18.dylib", "./frameworks/MyApp.framework" ] } }}
添加自定义文件
您可以使用 tauri.conf.json > bundle > macOS > files
配置将自定义文件添加到您的应用程序包,该配置将目标路径映射到其相对于 tauri.conf.json
文件的源。 这些文件被添加到 <product-name>.app/Contents
文件夹中。
{ "bundle": { "macOS": { "files": { "embedded.provisionprofile": "./profile-name.provisionprofile", "SharedSupport/docs.md": "./docs/index.md" } } }}
在上面的示例中,profile-name.provisionprofile
文件被复制到 <product-name>.app/Contents/embedded.provisionprofile
,docs/index.md
文件被复制到 <product-name>.app/Contents/SharedSupport/docs.md
。
© 2025 Tauri Contributors. CC-BY / MIT