Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Ein funktionierendes Beispiel finden Sie im dotnet-file-app sample. Die vollständige Referenz finden Sie unter Single-File-Modus in der CLI-Referenz.
.NET 10 kann eine einzelne .cs Datei ohne Projektdatei ausführen. In diesem Handbuch wird gezeigt, wie Sie diese Datei mit Paketidentität unter Verwendung von winapp run ausführen, sodass APIs wie Windows.ApplicationModel.Package.Current, App-Benachrichtigungen und gerätebasierte KI funktionieren. Sie erstellen keine Manifest- oder Bildressourcen: winapp generiert sie für Sie.
Die Paketidentität ist ein Kernkonzept im Windows app-Modell. Sie ermöglicht Ihrer Anwendung, auf bestimmte Windows-APIs zuzugreifen, eine reibungslose Installation und Deinstallation zu ermöglichen und vieles mehr. Eine dateibasierte App, die mit dotnet run ausgeführt wird, hat keine Paketidentität.
Prerequisites
.NET SDK 10.0.300 oder höher: Installieren Sie das .NET 10 SDK (erfordert einen Neustart nach der Installation):
winget install Microsoft.DotNet.SDK.10 --source wingetwinapp CLI: Installieren Sie das
winappTool über winget (oder aktualisieren Sie, falls bereits installiert):winget install Microsoft.winappcli --source winget
1. Erstellen Sie eine dateibasierte App
Erstellen Sie einen Ordner mit einer Datei mit dem Namen hello.cs:
#:property OutputType=Exe
#:property TargetFramework=net10.0-windows10.0.19041.0
using Windows.ApplicationModel;
try
{
Console.WriteLine($"Package Family Name: {Package.Current.Id.FamilyName}");
}
catch (InvalidOperationException)
{
// Thrown when the app doesn't have package identity
Console.WriteLine("Not packaged");
}
Die #:property Zeilen konfigurieren die App so, wie es ein .csproj tun würde. Das Windows-TargetFramework gewährt dem Code Zugriff auf Windows-Runtime APIs wie z. B. Package.
Führen Sie es mit dotnet run aus:
dotnet run hello.cs
Die Ausgabe ist Not packaged: Die App wird ohne Paketidentität ausgeführt.
2. Ausführen mit Paketidentität
Führen Sie dieselbe Datei mit winapp aus:
winapp run hello.cs
winapp erstellt die App, generiert ein Manifest und Standardimageressourcen in der Buildausgabe, registriert die App als Paket und startet sie. Die Ausgabe zeigt nun die Paketidentität an:
Package Family Name: hello-<hash>_<publisher-hash>
Der Quellordner enthält weiterhin nur hello.cs. Da es sich um eine Konsolen-App (OutputType=Exe) handelt, startet winapp sie über einen Ausführungsalias, sodass die Ausgabe in Ihrem Terminal angezeigt wird.
Die Registrierung bleibt nach dem Beenden der App aktiv, sodass beim erneuten Ausführen von winapp run hello.cs dieselbe Identität wiederverwendet wird. Sie entfernen es in Schritt 5.
3. Paket benennen
Standardmäßig ist der Paketname der Dateiname sowie ein kurzer Hash des Pfads der Datei. Um Ihren eigenen Namen auszuwählen, melden Sie das aktuelle Paket zuerst ab, da ein neuer Name ein neues Paket registriert:
winapp unregister hello.cs
Fügen Sie dann #:property-Anweisungen am Anfang von hello.cs ein:
#:property WinAppPackageName=com.contoso.hello
#:property WinAppDisplayName=Contoso Hello
#:property Version=1.0.0
Führen Sie den Vorgang erneut aus:
winapp run hello.cs
Die Ausgabe zeigt den neuen Namen an, z. B Package Family Name: com.contoso.hello_<publisher-hash>. . Die App wird auch im Startmenü als Contoso Hello angezeigt.
Für jede Identitätseigenschaft und ihren Standardwert siehe Manifest-Eigenschaften.
4. Ausführen mit dotnet run
Um den gleichen verpackten Start aus einfachem dotnet run zu erhalten, verweisen Sie oben in hello.cs auf das Microsoft.Windows.SDK.BuildTools.WinApp-Paket:
#:package Microsoft.Windows.SDK.BuildTools.WinApp@*
dotnet run hello.cs
Die Ausgabe zeigt die gleiche Paketidentität wie winapp run. Da dotnet run in einem anderen Ausgabeordner erstellt wird, warnt es, dass eine vorhandene Registrierung, die von einem anderen Speicherort installiert wurde, ersetzt wird. Dies wird erwartet, und Sie können es ignorieren.
Das Paket gibt der App außerdem ein Platzhalterfenstersymbol, sodass eine App im Fenstermodus ein Symbol in der Titelleiste anzeigt. Wenn Sie Ihre eigene verwenden möchten, verweisen Sie ApplicationIcon auf eine .ico-Datei:
#:property ApplicationIcon=Assets\MyApp.ico
Informationen zu den Eigenschaften, die diesen Start steuern, finden Sie unter Ausführen mit dotnet run.
5. Bereinigen
Entfernen Sie die Registrierung, indem Sie die .cs-Datei an winapp unregister übergeben:
winapp unregister hello.cs
Hinzufügen von Funktionen oder eines benutzerdefinierten Manifests
Einige APIs benötigen eine deklarierte Funktion. Beispielsweise benötigen systemAIModelsdie Windows KI-APIs Folgendes:
#:property WinAppCapabilities=systemAIModels
winapp schreibt jede Berechtigung in das richtige Manifestelement. Unter Capabilities finden Sie die vollständige Liste sowie die Benennungsregeln.
Protokollhandler, Dateizuordnungen und andere Shellintegrationen benötigen ein autoriertes Manifest. Platzieren Sie eine hello.appxmanifest neben hello.cs und winapp verwendet sie, anstatt eine zu generieren. Siehe Eigenes Manifest mitbringen.
Nächste Schritte
-
Paket zur Distribution:
winapp runregistriert die App nur für die Entwicklung. Um eine MSIX zu erstellen, die Sie versenden können, verschieben Sie Ihren Code in ein Projekt, und folgen Sie "Package with MSIX" im .NET Guide. - Explore Windows-APIs: Mit Paketidentität können Sie jetzt Benachrichtigungen, gerätenahe KI und andere identitätsabhängige APIs verwenden.
Windows developer