.NET 8框架依赖控制台应用启动时自检运行时并引导下载

因为依赖.NET运行时的exe在未安装对应运行时的系统中会直接触发系统级错误弹窗，无法自主执行检查逻辑，最可靠的解决方式是编写一个轻量的引导程序，由它来完成运行时检测、主应用启动或提示下载的逻辑。

方案步骤 #

1. 创建自包含的引导程序
   用C#编写一个小型控制台应用，发布时选择自包含模式（无需依赖系统.NET运行时），核心功能是检测系统是否安装了.NET 8.0运行时。
2. 运行时检测逻辑
   通过调用dotnet --list-runtimes命令解析输出，或直接读取系统注册表/文件路径来判断运行时是否存在。
3. 分支处理
   • 检测到运行时：启动你的主应用程序
   • 未检测到运行时：显示自定义提示和下载地址，等待用户操作后退出

引导程序代码示例 #

using System;
using System.Diagnostics;
using System.IO;

namespace RuntimeBootstrapper
{
    class Program
    {
        static void Main(string[] args)
        {
            bool hasDotNet8 = CheckForDotNet8Runtime();

            if (hasDotNet8)
            {
                // 替换为你的主应用程序文件名
                string mainAppPath = Path.Combine(AppDomain.CurrentDomain.BaseDirectory, "YourMainApp.exe");
                if (File.Exists(mainAppPath))
                {
                    Process.Start(new ProcessStartInfo(mainAppPath) { UseShellExecute = true });
                }
                else
                {
                    Console.WriteLine("主应用程序文件不存在，请检查文件完整性。");
                    Console.WriteLine("按任意键退出...");
                    Console.ReadKey();
                }
            }
            else
            {
                Console.WriteLine("未检测到.NET 8.0运行时环境，请先安装后再运行程序。");
                Console.WriteLine("下载地址：https://dotnet.microsoft.com/zh-cn/download/dotnet/8.0");
                Console.WriteLine("按任意键退出...");
                Console.ReadKey();
            }
        }

        static bool CheckForDotNet8Runtime()
        {
            try
            {
                using var process = new Process
                {
                    StartInfo = new ProcessStartInfo
                    {
                        FileName = "dotnet",
                        Arguments = "--list-runtimes",
                        RedirectStandardOutput = true,
                        UseShellExecute = false,
                        CreateNoWindow = true
                    }
                };

                process.Start();
                string runtimeList = process.StandardOutput.ReadToEnd();
                process.WaitForExit();

                // 匹配.NET 8.x运行时版本
                return runtimeList.Contains("Microsoft.NETCore.App 8.");
            }
            catch
            {
                // 若dotnet命令不存在，直接判定未安装
                return false;
            }
        }
    }
}

发布引导程序 #

在Visual Studio中发布时，选择：

• 目标框架：.NET 8.0
• 部署模式：自包含
• 目标运行时：根据用户的系统选择（如win-x64、linux-x64等）

发布后将引导程序exe和你的主应用exe放在同一目录，交付给用户时让用户运行引导程序即可。

替代方案：利用.NET官方的运行时检测机制 #

如果你不想额外编写引导程序，可以尝试使用dotnet publish命令生成框架依赖的单个文件应用：

dotnet publish -c Release -r win-x64 --self-contained false --publish-single-file true

但这种方式在未安装运行时的情况下，会弹出.NET官方的错误提示框（而非自定义提示），用户体验不如引导程序灵活。

内容的提问来源于stack exchange，提问作者leotsing