Publier¶
Produire un exécutable que l'on peut distribuer.
Commandes de base¶
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>
Native AOT¶
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.gzdu dossierpublish, ou paquets.deb/.rpm, Flatpak, AppImage. - Fichier
.desktoppour 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 publishles affiche)