Aller au contenu

Publier

Produire un exécutable que l'on peut distribuer.

Commandes de base

dotnet publish -c Release -r win-x64 --self-contained
dotnet publish -c Release -r osx-arm64 --self-contained
dotnet publish -c Release -r osx-x64   --self-contained
dotnet publish -c Release -r linux-x64 --self-contained

Résultat dans bin/Release/net10.0/<rid>/publish/.

Option Effet
--self-contained embarque le runtime .NET : rien à installer chez l'utilisateur
-p:PublishSingleFile=true un seul exécutable
-p:PublishTrimmed=true retire le code inutilisé (taille réduite)
-p:PublishAot=true compilation native : démarrage rapide, pas de JIT
flowchart TD
  Q1{"Le runtime .NET est-il<br/>installé chez l'utilisateur ?"} -- non / je ne sais pas --> SC["--self-contained"]
  Q1 -- oui --> FD["dépendant du framework<br/>(plus léger)"]
  SC --> Q2{"Un seul fichier<br/>à distribuer ?"}
  Q2 -- oui --> SF["PublishSingleFile"]
  Q2 -- non --> DIR["dossier publish/"]
  SF --> Q3{"Démarrage ultra-rapide,<br/>pas de JIT ?"}
  Q3 -- oui --> AOT["PublishAot"]
Option Taille Démarrage Prérequis
dépendant du framework ⭐ très petite normal .NET installé
--self-contained grosse normal aucun
+ PublishTrimmed moyenne normal aucun
PublishAot moyenne ⭐ très rapide aucun (pas de réflexion)

Fichier unique

MonApp.csproj
<PropertyGroup Condition="'$(Configuration)' == 'Release'">
  <PublishSingleFile>true</PublishSingleFile>
  <SelfContained>true</SelfContained>
  <IncludeNativeLibrariesForSelfExtract>true</IncludeNativeLibrariesForSelfExtract>
</PropertyGroup>
dotnet publish -c Release -r win-x64

Native AOT

MonApp.csproj
<PropertyGroup>
  <PublishAot>true</PublishAot>
</PropertyGroup>
dotnet publish -c Release -r win-x64

Compiled bindings et AOT

Les compiled bindings (par défaut en v12) n'utilisent pas la réflexion : ils sont compatibles avec le trimming et l'AOT. Évitez ReflectionBinding et x:DataType manquants dans une appli AOT.

Icône et métadonnées

MonApp.csproj
<PropertyGroup>
  <ApplicationIcon>Assets\app.ico</ApplicationIcon>
  <AssemblyName>MonApp</AssemblyName>
  <Version>1.2.0</Version>
  <Company>Mon équipe</Company>
  <Product>Mon application</Product>
</PropertyGroup>

macOS : bundle .app

Un exécutable publié n'est pas une application macOS. Structure minimale :

MonApp.app/
└── Contents/
    ├── Info.plist
    ├── MacOS/        ← contenu de publish/
    └── Resources/
        └── MonApp.icns
Info.plist (extrait)
<key>CFBundleName</key>            <string>MonApp</string>
<key>CFBundleIdentifier</key>      <string>fr.exemple.monapp</string>
<key>CFBundleExecutable</key>      <string>MonApp</string>
<key>CFBundleIconFile</key>        <string>MonApp.icns</string>
<key>NSHighResolutionCapable</key> <true/>

Pour distribuer hors App Store : signature (codesign) puis notarisation (notarytool).

Linux

  • Archive .tar.gz du dossier publish, ou paquets .deb / .rpm, Flatpak, AppImage.
  • Fichier .desktop pour l'intégration au menu :
monapp.desktop
[Desktop Entry]
Name=MonApp
Exec=/opt/monapp/MonApp
Icon=/opt/monapp/icon.png
Type=Application
Categories=Utility;

Android et iOS

dotnet publish MonApp.Android -c Release -f net10.0-android    # .aab / .apk
dotnet publish MonApp.iOS     -c Release -f net10.0-ios        # .ipa (sur macOS)

La signature se configure dans le .csproj (AndroidSigningKeyStore, CodesignKey…).

Vérifier avant de publier

  • Version mise à jour dans le .csproj
  • Outils de développement désactivés en Release (#if DEBUG)
  • Testé sur chaque OS cible
  • Pas d'avertissement de trimming (dotnet publish les affiche)