使用 Windows 應用程式 SDK 的控制台應用程式

你可以建立使用 Windows 應用程式 SDK 功能（如應用程式生命週期管理、豐富啟用、推播通知等）的主控台應用程式。 與需要特殊範本與 C++/WinRT 的 UWP 主控台應用程式不同，桌面主控台應用程式使用標準的 .NET 或 C++ 專案類型。

用 Windows 應用程式 SDK 建立主控台應用程式

步驟 1：建立 .NET 控制台專案

使用標準的 .NET 控制台應用程式範本：

dotnet new console -n MyConsoleApp
cd MyConsoleApp

步驟 2：新增 Windows 應用程式 SDK NuGet 套件

dotnet add package Microsoft.WindowsAppSDK

步驟 3：使用 Windows 應用程式 SDK API

using Microsoft.Windows.AppLifecycle;

class Program
{
    static async Task Main(string[] args)
    {
        Console.WriteLine("Console app with Windows App SDK");

        // Check activation kind
        var activatedArgs = AppInstance.GetCurrent().GetActivatedEventArgs();
        Console.WriteLine($"Activation kind: {activatedArgs.Kind}");

        // Use single-instance pattern
        var instance = AppInstance.FindOrRegisterForKey("my-console-app");
        if (!instance.IsCurrent)
        {
            Console.WriteLine("Another instance is running. Redirecting...");
            await instance.RedirectActivationToAsync(activatedArgs);
            return;
        }

        // Your app logic here
        Console.WriteLine("Press Enter to exit.");
        Console.ReadLine();
    }
}

主控台應用程式的套件識別碼

部分 Windows 應用程式 SDK 功能需要 MSIX 套件識別碼。 您可以透過兩種方式為您的主控台應用程式指定套件識別：

• 以 MSIX 格式打包 — 建立一個 Windows 應用程式打包 Project，並將你的主控台應用程式作為參考。
• 使用外部識別碼 — 註冊一個不包含完整 MSIX 封裝的稀疏封包作為識別碼。

與 UWP 控制台應用程式的差異

常見場景

具備 Windows 整合的命令列工具

建立能與 Windows 功能整合的 CLI 工具：

using Microsoft.Windows.AppNotifications;

// Send a notification from a console app (requires package identity)
var builder = new AppNotificationBuilder()
    .AddText("Build complete")
    .AddText("Your project built successfully.");

AppNotificationManager.Default.Show(builder.BuildNotification());

背景處理

主控台應用程式很適合用於背景處理工作：

• 資料匯入/匯出工具
• 檔案監視器與處理器
• 排程任務執行檔
• 開發人員工具與自動化指令碼

相關內容

• Windows 應用程式 SDK 的應用程式生命週期
• 多實例應用程式
• Windows 應用程式 SDK 概觀