WindowsAppSDK Samples

Windows 應用程式 SDK 範例

此儲存庫託管 Windows 應用程式 SDK 的範例。 Windows App SDK 中提供的各種功能的範例將會新增至此儲存庫。有關 Windows 應用程式 SDK 的更多信息，請訪問 Windows 應用程式 SDK 文件。若要了解更多有關 Windows 應用程式 SDK 設計的資訊或為該專案做出貢獻、提出功能建議或開始討論，請造訪 Windows 應用程式 SDK GitHub 頁面。

樣品清單

應用程式生命週期和系統服務

• 應用程式生命週期：這些範例示範了使用 AppLifecycle API 進行應用程式實例化。它們包括以下功能：
  • 激活：這些範例演示了對豐富激活類型的支援。
  • 實例化：這些範例演示了對單一實例和選擇性多實例的支援。
  • 電源通知：這些範例示範了用於管理應用程式工作負載的電源/系統狀態通知。
  • 重新啟動：這些範例示範了使用命令列重新啟動參數同步重新啟動應用程式。
  • 共享目標：此範例示範了一個可以作為共享目標啟動的應用程式。

數據和文件

• 資源管理：這些範例示範了使用 MRT Core API 進行應用程式資源管理。

部署

• 部署管理器：此範例示範如何初始化和存取 Windows 應用程式 SDK 執行階段的部署資訊。
• 安裝程式：此範例示範如何在沒有控制台視窗的情況下啟動 Windows App SDK 安裝程式。
• 未打包：這些範例示範了使用 Windows 應用程式 SDK 套件從非 MSIX（未打包）應用程式進行自動初始化。

動態依賴

• DirectX：此範例示範如何使用動態相依性 API 動態載入 DirectX 執行時期 MSIX 框架套件。

圖形

• 文字渲染：此範例是示範文字渲染的 DWriteCore API 庫。

通知

• 推播通知：這是一個展示推播通知的範例應用程式。
• 應用程式通知：這是一個展示應用程式通知的範例應用程式。

運行時組件

• 自訂控制項：此範例示範如何使用自訂 WinUI 控制項在 C# 中創作 Windows 執行階段元件。

使用者介面和輸入

• 視窗化：此範例示範如何使用視窗化 API 管理應用程式視窗。
• Windows 輸入和組合庫：此範例集合展示了 Microsoft.UI.Composition 和 Microsoft.UI.Input API。
• WinUI 3 Gallery：這是一個範例應用程序，展示了所有正在運行的 WinUI 3 控制項。

要求

這些 Windows App SDK 範例具有以下系統需求：

• Windows 10 版本 1809（內部版本 17763）或更高版本。

• Visual Studio 2022 或 Visual Studio 2019 版本 16.9 或更高版本，具有下列工作負載和元件：

  • 通用Windows平台開發
  • .NET 桌面開發（即使您只建立 C++ Win32 應用程式也需要）
  • 使用 C++ 進行桌面開發（即使您只建立 .NET 應用程式也需要）
  • Windows SDK 版本 2004（內部版本 19041）或更高版本。預設情況下，它會隨 Visual Studio 一起安裝。

• 使用 Windows App SDK 1.1 建置 .NET C# 範例還需要以下 .NET SDK 版本之一或更高版本：

  • 6.0.202
  • 6.0.104
  • 5.0.407
  • 5.0.213

請參閱有關 Windows 應用程式開發的系統需求和工具的文檔，以了解使用 Windows 應用程式 SDK 開發應用程式的詳細要求清單。

使用樣本

若要透過 Git 使用範例，請透過從命令提示字元執行git clone https://github.com/microsoft/WindowsAppSDK-Samples.git來複製 WindowsAppSDK-Samples 儲存庫。然後，您可以導航到範例目錄並在 Visual Studio 中開啟解決方案檔案。

在沒有 Git 的情況下使用這些範例的最簡單方法是下載 ZIP 檔案。從下載下拉清單中選擇「下載 ZIP」 ，解壓縮整個檔案並在 Visual Studio 中開啟範例。

樣本版本控制

這些範例將隨 Windows App SDK 的 GA 版本進行更新。 main分支包括最新範例，其中可能還包括實驗或預覽功能。特定發布分支名為release/xy ，並包含引用Windows App SDK對應GA版本的範例。此儲存庫目前包含以下發行分支：

• 發布/1.0
• 發布/0.8
• 釋放/0.5

貢獻

這些範例由功能團隊提供，我們歡迎您就新範例的問題和建議提出意見。我們鼓勵您針對任何回饋或問題提交新問題！

範例作者應遵循範例指南來開始開發範例。基於 WinUI 的 Windows App SDK 範例，請使用範例範本。 VSIX 檔案可在此處的 Github 版本頁面下載。

該專案採用了微軟開源行為準則。有關詳細信息，請參閱行為準則常見問題解答或聯繫 [email protected] 提出任何其他問題或意見。

新增新的範例應用程式後，Microsoft 開發人員應考慮更新內部聚合器管道以：

• 定期建立新的範例應用程式。
• 將新的測試案例新增至現有的 SampleTests TAEF 測試驅動程式中，以根據最新的 Windows 應用程式 SDK 版本定期驗證範例應用程式是否成功啟動。

請參閱內部聚合器儲存庫上的文件以取得 BuildSampleApps 和 TestSampleApps 階段中的說明。