WindowsAppSDK Samples

Beispiele für Windows App SDK

Dieses Repository hostet Beispiele für das Windows App SDK. Beispiele für verschiedene Funktionen, die im Windows App SDK enthalten sind, werden diesem Repository hinzugefügt. Weitere Informationen zum Windows App SDK finden Sie in der Windows App SDK-Dokumentation. Um mehr über das Windows App SDK-Design zu erfahren oder zum Projekt beizutragen, Funktionsvorschläge zu machen oder Diskussionen zu starten, besuchen Sie die Windows App SDK-GitHub-Seite.

Liste der Proben

App-Lebenszyklus und Systemdienste

• App-Lebenszyklus: Diese Beispiele veranschaulichen die App-Instanzierung mithilfe der AppLifecycle-APIs. Sie umfassen die folgenden Funktionen:
  • Aktivierung: Diese Beispiele demonstrieren die Unterstützung für umfangreiche Aktivierungsarten.
  • Instanziierung: Diese Beispiele demonstrieren die Unterstützung für Einzelinstanzierung und selektive Mehrfachinstanzierung.
  • Energiebenachrichtigungen: Diese Beispiele veranschaulichen die Energie-/Systemstatusbenachrichtigungen für die Verwaltung der App-Arbeitslast.
  • Neustart: Diese Beispiele veranschaulichen den synchronen Neustart einer App mit Befehlszeilen-Neustartargumenten.
  • Freigabeziel: Dieses Beispiel zeigt eine App, die als Freigabeziel aktiviert werden kann.

Daten und Dateien

• Ressourcenverwaltung: Diese Beispiele demonstrieren die App-Ressourcenverwaltung mithilfe der MRT-Kern-APIs.

Einsatz

• Bereitstellungs-Manager: Dieses Beispiel zeigt, wie Sie Bereitstellungsinformationen für die Windows App SDK-Laufzeit initialisieren und darauf zugreifen.
• Installationsprogramm: Dieses Beispiel zeigt, wie das Windows App SDK-Installationsprogramm ohne Konsolenfenster gestartet wird.
• Ungepackt: Diese Beispiele demonstrieren die automatische Initialisierung mit dem Windows App SDK-Paket aus einer Nicht-MSIX-Anwendung (ungepackt).

Dynamische Abhängigkeiten

• DirectX: Dieses Beispiel zeigt, wie Sie die Dynamic Dependencies API verwenden, um das DirectX Runtime MSIX-Frameworkpaket dynamisch zu laden.

Grafik

• Textwiedergabe: Dieses Beispiel ist eine Galerie der DWriteCore-APIs, die die Textwiedergabe demonstriert.

Benachrichtigungen

• Push-Benachrichtigungen: Dies ist eine Beispiel-App, die Push-Benachrichtigungen präsentiert.
• App-Benachrichtigungen: Dies ist eine Beispiel-App, die App-Benachrichtigungen präsentiert.

Laufzeitkomponenten

• Benutzerdefinierte Steuerelemente: Dieses Beispiel zeigt, wie Sie eine Windows-Runtime-Komponente in C# mit benutzerdefinierten WinUI-Steuerelementen erstellen.

Benutzeroberfläche und Eingabe

• Windowing: Dieses Beispiel zeigt, wie App-Fenster mithilfe der Windowing-APIs verwaltet werden.
• Windows-Eingabe- und Kompositionsgalerie: Diese Sammlung von Beispielen stellt die APIs Microsoft.UI.Composition und Microsoft.UI.Input vor.
• WinUI 3-Galerie: Dies ist eine Beispiel-App, die alle WinUI 3-Steuerelemente in Aktion zeigt.

Anforderungen

Für diese Windows App SDK-Beispiele gelten die folgenden Systemanforderungen:

• Windows 10, Version 1809 (Build 17763) oder höher.

• Visual Studio 2022 oder Visual Studio 2019 Version 16.9 oder höher, mit den folgenden Workloads und Komponenten:

  • Entwicklung der universellen Windows-Plattform
  • .NET-Desktop-Entwicklung (erforderlich, auch wenn Sie nur C++-Win32-Apps erstellen)
  • Desktop-Entwicklung mit C++ (erforderlich, auch wenn Sie nur .NET-Apps erstellen)
  • Windows SDK Version 2004 (Build 19041) oder höher. Dies wird standardmäßig mit Visual Studio installiert.

• Zum Erstellen von .NET C#-Beispielen mit Windows App SDK 1.1 ist außerdem eine der folgenden .NET SDK-Versionen oder höher erforderlich:

  • 6.0.202
  • 6.0.104
  • 5.0.407
  • 5.0.213

Eine detaillierte Liste der Anforderungen für die Entwicklung von Apps mit dem Windows App SDK finden Sie in den Dokumenten zu Systemanforderungen und Tools für die Windows-App-Entwicklung.

Verwendung der Proben

Um die Beispiele mit Git zu verwenden, klonen Sie das WindowsAppSDK-Samples-Repository, indem Sie git clone https://github.com/microsoft/WindowsAppSDK-Samples.git an einer Eingabeaufforderung ausführen. Anschließend können Sie zum Verzeichnis eines Beispiels navigieren und die Lösungsdatei in Visual Studio öffnen.

Der einfachste Weg, diese Beispiele ohne Git zu verwenden, besteht darin, die ZIP-Datei herunterzuladen. Wählen Sie im Download-Dropdown die Option ZIP herunterladen aus, entpacken Sie das gesamte Archiv und öffnen Sie die Beispiele in Visual Studio.

Beispielversionierung

Die Beispiele werden mit GA-Versionen des Windows App SDK aktualisiert. Der main enthält die neuesten Beispiele, die möglicherweise auch experimentelle oder Vorschaufunktionen enthalten. Bestimmte Release-Zweige heißen release/xy und enthalten Beispiele, die auf die entsprechende GA-Version des Windows App SDK verweisen. Dieses Repository umfasst derzeit die folgenden Release-Zweige:

• Release/1.0
• Release/0.8
• Release/0,5

Mitwirken

Diese Beispiele werden von Feature-Teams bereitgestellt und wir freuen uns über Ihren Beitrag zu Problemen und Vorschläge für neue Beispiele. Wir empfehlen Ihnen, für Rückmeldungen oder Fragen ein neues Problem einzureichen!

Probenautoren sollten die Beispielrichtlinien befolgen, um mit der Entwicklung ihrer Proben zu beginnen. Für WinUI-basierte Windows App SDK-Beispiele verwenden Sie die Beispielvorlagen. Die VSIX-Datei steht hier auf der Github-Release-Seite zum Download bereit.

Dieses Projekt hat den Microsoft Open Source Verhaltenskodex übernommen. Weitere Informationen finden Sie in den häufig gestellten Fragen zum Verhaltenskodex oder wenden Sie sich bei weiteren Fragen oder Kommentaren an [email protected].

Sobald eine neue Beispiel-App hinzugefügt wurde, sollten Microsoft-Entwickler eine Aktualisierung der internen Aggregator-Pipeline in Betracht ziehen, um:

• Aktivieren Sie regelmäßig die Erstellung der neuen Beispiel-App.
• Fügen Sie einen neuen Testfall zum vorhandenen SampleTests TAEF-Testtreiber hinzu, um regelmäßig den erfolgreichen Start der Beispiel-App anhand der neuesten Windows App SDK-Version zu überprüfen.

Anweisungen finden Sie in der Dokumentation zum internen Aggregator-Repository in den Phasen „BuildSampleApps“ und „TestSampleApps“.