• 先决条件
  • Visual Studio 2026 (18.0.0+)
  • .NET 8.0 SDK
  • .NET 9.0 SDK
  • .NET 10.0 SDK
  • 在 powershell 中运行命令 dotnet --info 查看您当前安装的版本
• Visual Studio 2026 工作负载
  • .Net 桌面开发
  • .Net desktop development with .NET Framework 4.7.2 目标包
  • 可选 (目标 iOS/Android): .NET Multi-paltform App UI 开发 和 单个组件 Android SDK 设置 (默认勾选), 然后在 Visual Studio 中跳转到 工具 > Android > Android SDK 管理器 并从工具选项卡安装 NDK (版本 20.1+).
  • 可选 (构建 VSIX package): Visual Studio 扩展开发
• 编译 Miko
  • 从Git客户端或命令行克隆仓库到指定目录: git clone url
  • 使用Visual Studio 2026打开 <MikoDir>\src\Miko.sln 并构建 Demo 项目 (它应该是默认启动项) 或从VS工具栏运行它.
  • 也支持使用Rider和VSCode进行编译

可以通过两种方式使用Miko.一种是通过源码构建Miko，然后项目引用编译后的包，另一种是通过NuGet包方式，下面将详细介绍第二种方式。

1·安装 Miko Visual Studio 扩展,此扩展将安装Miko项目模板和新建项模板,项目模板将通过NuGet安装Miko包

2·打开Visual Studio 2026 在,进入创建新项目界面，在右侧项目类型列表中找到【Miko Application】 条目，点击下一步直至完成。

如果您没有安装Miko项目模板，则需要进行以下步骤：

• 创建一个标准的.Net10 WinForms项目
• 通过NuGet安装Miko包 或 执行命令 nuget install Miko
• 将窗体改为继承自Miko.Window
• 跳转到Program.cs，将Main方法内容替换为如下内容：

internal static class Program
{
    [STAThread]
    static void Main(string[] args)
    {
        MikoApp.Create()
            .UseDesktopPlatform()
            .UseMainWindow<Form1>()
            .Build();
        /* Here we go! */
        MikoApp.Run();
    }
}

internal static class Program
{
    [STAThread]
    static void Main(string[] args)
    {
        MikoApp.Create()
            .UseDesktopPlatform()
            .UseMainWindow<Form1>()
            .Build();
        /* Here we go! */
        MikoApp.Run();
    }
}

3·现在开始，使用Miko的所有操作和WinForm项目完全一样！双击【Form1】,打开窗体设计器，从VS左侧工具栏选择【Miko】分类下的控件进行窗体设计，编辑项目属性等等

4·如果您想制作自定义控件，只需要在【解决方案资源管理器】中选中项目，右键选择【添加项】>【新增项】,在列表中选择【Miko UserControl】条目并确定，VS会使用指定模板向您的项目添加一个自定义控件，现在您可以像使用WinForms一样设计您的自定义控件了

5·编译并分发您的应用程序

如果使用Rider和VSCode进行开发，将暂时不支持窗体设计器