Passer au contenu principal

macOS Bundle

Les applications Tauri pour macOS sont distribuées avec un Pack d'Applications (.app fichier) ou une image de disque Apple (fichier .dmg). La CLI Tauri regroupe automatiquement le code de votre application dans ces formats, offrant des options pour concevoir et notarié votre application. Veuillez noter que les bundles .app et .dmg ne peuvent être créés que sur macOS car la compilation croisée ne fonctionne pas encore.

note

Les applications GUI sur macOS et Linux n'héritent pas des $PATH de vos dotfiles shell (.bashrc, .bash_profile, .zshrc, etc.). Consultez la crate fix-path-env-rs de Tauri pour résoudre ce problème.

Pour compiler et construire votre application Tauri en un seul exécutable, exécutez simplement la commande suivante :

npm run tauri build

Il construira votre frontend (si configuré, voir beforeBuildCommand), compilera le binaire Rust, collectera tous les binaires et ressources externes et enfin, produira des paquets et des installateurs spécifiques à la plateforme.

Définir une version minimale du système​

The minimum version of the operating system required for a Tauri app to run on macOS is 10.13. Si vous avez besoin du support pour les nouvelles API macOS comme window.print qui n'est pris en charge que depuis la version macOS 11. à partir de là, vous pouvez changer la tauri.bundle.macOS.minimumSystemVersion. Cela définira la propriété Info.plist LSMinimumSystemVersion et la variable d'environnement MACOSX_DEPLOYMENT_TARGET.

Cibles binaires​

Vous pouvez compiler votre application en ciblant des binaires Apple Silicon, des ordinateurs Mac basés sur Intel, ou des binaires macOS universels. Par défaut, le CLI construit un binaire ciblant l'architecture de votre machine. Si vous voulez construire pour une cible différente, vous devez d'abord installer la cible de Rust manquante pour cette cible en exécutant rustup target ajouter aarch64-apple-darwin ou la cible de rustup ajoute x86_64-apple-darwin, alors vous pouvez construire votre application en utilisant le drapeau --target:

  • tauri build --target aarch64-apple-darwin: cible les machines à silicium Apple.
  • tauri build --target x86_64-apple-darwin: cible les machines Intel.
  • tauri build --target universal-apple-darwin: produces a universal macOS binary that runs on both Apple silicon and Intel-based Macs.

Alors que les machines Apple silicon peuvent exécuter des applications compilées pour Macs basés sur Intel, à travers une couche de traduction appelée Rosetta, Cela conduit à une réduction des performances en raison des traductions des instructions du processeur. Il est courant de permettre à l'utilisateur de choisir la cible correcte lors du téléchargement de l'application, mais vous pouvez également choisir de distribuer un Binaire Universel. Les binaires universels incluent à la fois les exécutables aarch64 et x86_64 , vous donnant la meilleure expérience sur les deux architectures. Notez toutefois que cela augmente considérablement la taille de votre paquet.

Personnalisation du bundle​

Le fichier de configuration de Tauri fournit les options suivantes pour personnaliser votre bundle d'application :

  • Nom l'application : Le nom lisible par l'homme de votre application. Configuré par la propriété package.productName.
  • Bundle version: La version de votre application. Configuré par la propriété package.version.
  • Type d'application : Le type de votre application. Configuré par la propriété tauri.bundle.category. Vous pouvez voir la liste des type d'application macOS ici.
  • Copyright: Une chaîne de caractères composé des auteurs ou entreprises de votre application. Configuré par la propriété tauri.bundle.copyright.
  • Icône de l'application : Icône de votre application. Utilise le premier fichier .icns listé dans le tableau tauri.bundle.icon.
  • Version minimale du système : Configurée par la propriété tauri.bundle.macOS.minimumSystemVersion.
  • Fichier de licence DMG : Une licence qui est ajoutée au fichier .dmg. Configurer par la propriété tauri.bundle.macOS.license.
  • Fichier Entitlements.plist: Les droits pour accéder aux API que votre application aura besoin. Configuré par la propriété tauri.bundle.macOS.entitlements.
  • Domaine d'exception : un domaine non sécurisé auquel votre application peut accéder tel qu'un localhost ou un domaine distant http. C'est une configuration de commodité autour de NSAppTransportSecurity > NSExceptionDomains définissant NSExceptionAllowsInsecureHTTPLoads et NSIncludesSubdomains à true. Voir tauri.bundle.macOS.exceptionDomain pour plus d'informations.
info

Ces options génèrent le bundle d’applications fichier Info.plist.. Vous pouvez étendre le fichier généré avec votre propre fichier Info.plist stocké dans le dossier Tauri (src-tauri par défaut). Le CLI fusionne à la fois les fichiers .plist en production, et la couche centrale les intègre dans le binaire pendant le développement.