distributing-tauri-for-macos

Configures Tauri v2 macOS distribution including DMG installers, app bundles, entitlements, and Info.plist files.

Updated Jun 7, 2026
One-click install
npx skills add https://github.com/dt418/better-shot-x --skill distributing-tauri-for-macos-dt418
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: distributing-tauri-for-macos
Source: https://github.com/dt418/better-shot-x/tree/main/.agents/skills/distributing-tauri-for-macos
Command: npx skills add https://github.com/dt418/better-shot-x --skill distributing-tauri-for-macos-dt418

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Distributing a Tauri application on macOS requires correctly configuring app bundles, DMG installers, entitlements, and Info.plist metadata, and mistakes in any of these cause signing failures, App Store rejections, or broken installers. ## Core Features & Use Cases - DMG Installer Configuration: Customize DMG window size, background image, and icon positions in tauri.conf.json for drag-and-drop installation. - Info.plist Customization: Add privacy usage descriptions, document types, URL schemes, and localized strings via src-tauri/Info.plist and InfoPlist.strings files. - Entitlements Setup: Define sandbox, network, hardware, and hardened runtime entitlements in Entitlements.plist for code-signed builds. - Use Case: You are shipping a Tauri v2 desktop app to macOS users and need a branded DMG with camera and microphone permission prompts, proper entitlements for notarization, and a minimum system version of macOS 12. ## Quick Start Configure my Tauri app's macOS bundle with a custom DMG background, camera and microphone usage descriptions, and sandbox entitlements.

Frequently Asked Questions about distributing-tauri-for-macos

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build a DMG installer for a Tauri app on macOS?

Run the Tauri CLI build command with the dmg bundle target, for example npm run tauri build -- --bundles dmg. The output DMG is written to src-tauri/target/release/bundle/dmg alongside the .app bundle in the macos directory.

How do I customize the DMG window layout in Tauri?

Set the bundle.macOS.dmg options in tauri.conf.json, including background image, windowSize, windowPosition, appPosition, and applicationFolderPosition. Note that icon positions may not apply correctly when building on headless CI/CD environments.

How do I add camera and microphone permission prompts to a Tauri macOS app?

Create src-tauri/Info.plist with NSCameraUsageDescription and NSMicrophoneUsageDescription string keys explaining why access is needed. The Tauri CLI merges this file with the generated Info.plist during the build.

Does Tauri support entitlements for macOS app sandboxing?

Yes, create src-tauri/Entitlements.plist with keys like com.apple.security.app-sandbox and network or hardware entitlements, then reference it via bundle.macOS.entitlements in tauri.conf.json. Entitlements only take effect when the app is code-signed.

Why are my DMG icon positions wrong when building on CI?

This is a known issue with headless CI/CD environments where icon sizes and positions do not apply correctly. Build DMGs locally or accept the default positioning for CI-produced artifacts.

How do I localize Info.plist strings in a Tauri app?

Create InfoPlist.strings files under src-tauri/infoplist/<lang>.lproj/ directories for each locale, then add a bundle.resources mapping like "infoplist/**": "./" in tauri.conf.json so the localized folders are bundled.