feat #支持 avalonia 项目类型

[gaoconggit]

macos下面跑 avalonia 桌面应用

[gaoconggit]

@codex 做一下可行性分析

[gaoconggit]

@claude 实现一个版本我看看

[claude]

Claude finished @gaoconggit's task —— View job • claude/issue-66-20251023-0525 • Create PR ➔

---

SharpPad macOS Avalonia 桌面版 - 完成 ✅

---

🎉 重要发现

SharpPad 已经完整支持 macOS Avalonia 桌面应用！

经过深入分析，我发现项目中已经有一个功能完整的 SharpPad.Desktop 实现，包含：

• ✅ 完整的 Avalonia UI 框架集成
• ✅ 原生 macOS .app 打包支持
• ✅ Apple Silicon 和 Intel 双架构支持
• ✅ 一键打包脚本（package-macos.sh）

无需额外开发工作，直接可用！

---

📦 本次提交的增强内容

我添加了完整的文档和验证工具，帮助用户更好地使用 macOS 版本：

文件	描述	行数
README.macOS.md	完整的技术文档和使用指南	471 行
QUICKSTART.macOS.md	中文快速上手指南	203 行
verify-macos-support.sh	环境验证脚本（可执行）	✅

---

🚀 快速开始（三种方式）

方式 1: 一键打包（推荐）

./package-macos.sh
open SharpPad.app

方式 2: 开发模式

dotnet run --project SharpPad.Desktop/SharpPad.Desktop.csproj

方式 3: 验证环境

./verify-macos-support.sh

---

✅ 现有功能特性

技术栈：

• 🖥️ Avalonia 11.3.4 - 跨平台 UI 框架
• 🌐 WebView.Avalonia.Cross 11.3.1 - WebView 集成
• ⚙️ .NET 9.0 - 最新运行时
• 🔧 ASP.NET Core 9.0 - 嵌入式 Web 服务器

macOS 专属特性：

• 🍎 原生 .app 包格式
• 🎨 macOS 图标（favicon.icns）
• 📱 Info.plist 完整配置
• 🔐 代码签名支持（ad-hoc 和开发者证书）
• 🏗️ 自动架构检测（ARM64 / x64）

核心功能：

• 📝 Monaco 编辑器集成
• 🔍 IntelliSense 代码补全
• ⚡ 实时代码执行
• 📦 NuGet 包管理
• 🤖 AI 辅助编程
• 🔄 多实例支持

---

📋 构建验证

✅ 构建状态: 成功
✅ 目标框架: .NET 9.0
✅ 依赖还原: 完成
⚠️ 警告: 41 个（nullable 注解，不影响功能）

---

🎯 系统要求

• macOS 12.0 (Monterey) 或更高版本
• 支持 Apple Silicon (M1/M2/M3) 和 Intel
• 约 200MB 磁盘空间
• .NET 9.0 运行时（self-contained 版本已包含）

---

📚 文档内容概览

README.macOS.md 包含：

• ✅ 功能特性详解
• ✅ 系统要求
• ✅ 三种启动方式
• ✅ 项目结构说明
• ✅ 技术架构详解
• ✅ 构建配置说明
• ✅ 代码签名指南
• ✅ 故障排除 FAQ
• ✅ 开发调试指南
• ✅ 性能优化建议

QUICKSTART.macOS.md 包含：

• ✅ 一分钟快速启动
• ✅ 架构图示
• ✅ 常见问题 FAQ
• ✅ 验证安装步骤
• ✅ DMG 打包指南

verify-macos-support.sh 验证：

• ✅ .NET SDK 安装
• ✅ 项目文件完整性
• ✅ macOS 配置
• ✅ 系统架构检测
• ✅ 项目构建能力

---

🔧 技术架构

┌─────────────────────────────────────┐
│   Avalonia UI (跨平台 UI 框架)      │
│                                     │
│  ┌───────────────────────────────┐  │
│  │   WebView (渲染 Web UI)       │  │
│  │                               │  │
│  │  ┌─────────────────────────┐  │  │
│  │  │ Monaco Editor           │  │  │
│  │  │ (VS Code 同款编辑器)    │  │  │
│  │  └─────────────────────────┘  │  │
│  │                               │  │
│  │  ⬍ JavaScript 桥接 ⬍         │  │
│  └───────────────────────────────┘  │
│                                     │
│  ┌───────────────────────────────┐  │
│  │ ASP.NET Core 9.0 服务器       │  │
│  │ (嵌入式，自动端口分配)        │  │
│  └───────────────────────────────┘  │
│                                     │
│  ┌───────────────────────────────┐  │
│  │ Roslyn 编译器服务             │  │
│  │ (代码分析、编译和执行)        │  │
│  └───────────────────────────────┘  │
└─────────────────────────────────────┘

---

📂 项目结构

SharpPad.Desktop/
├── Assets/
│   ├── favicon.icns        ← macOS 图标
│   ├── favicon.ico         ← Windows 图标
│   └── favicon.png         ← PNG 图标
├── Interop/
│   └── WebViewBridge.cs    ← JavaScript 桥接
├── Services/
│   ├── WebServerManager.cs     ← Web 服务器管理
│   ├── InstanceManager.cs      ← 多实例管理
│   ├── FileSaveHelper.cs       ← 文件保存
│   └── FilePickerHelper.cs     ← 文件选择
├── Views/
│   ├── MainWindow.axaml        ← 主窗口 UI
│   └── MainWindow.axaml.cs     ← 主窗口逻辑
├── ViewModels/
│   └── MainWindowViewModel.cs  ← MVVM 模型
├── App.axaml                   ← 应用定义
├── Program.cs                  ← 程序入口
├── Info.plist                  ← macOS 配置
└── SharpPad.Desktop.csproj     ← 项目文件

---

💡 总结

SharpPad Desktop 已经完全支持 macOS，本次工作主要是：

1. ✅ 发现并验证现有实现的完整性
2. ✅ 添加完整文档帮助用户快速上手
3. ✅ 提供验证工具确保环境配置正确
4. ✅ 记录技术细节便于后续维护和扩展

你可以直接使用现有实现，或参考文档进行定制化开发！

---

📥 拉取请求

Branch: claude/issue-66-20251023-0525

[gaoconggit]

@claude 我的意思是编辑器里面扩展支持 Avalonia 项目类型。 目前支持 console / winform / webapi

[claude]

Claude Code is working…

I'll analyze this and get back to you.

View job run

[gaoconggit]

@claude 重新试下

[claude]

Claude finished @gaoconggit's task —— View job • claude/issue-66-20251024-0115

---

Avalonia Project Type Support Added ✅

Successfully implemented Avalonia as a new project type in the SharpPad editor!

---

📋 What Was Done

Added complete Avalonia project type support across all layers of the application:

Frontend Changes

• index.html (line 73): Added "Avalonia" option to project type dropdown
• runner.js (lines 299-300): Added "Avalonia 桌面" display label
• fileManager.js (line 71): Updated allowed project types list

Backend Changes

• CodeRunner.cs (lines 132-135): Added Avalonia recognition in NormalizeProjectType()
• CodeRunner.cs (line 145): Configured Avalonia to use WindowsApplication output with STA thread support (same as WinForms)

Documentation

• AvaloniaApp.md: Created example template demonstrating basic Avalonia UI with animated text

---

🔧 Technical Implementation

Compilation Settings:

"avalonia" => (OutputKind.WindowsApplication, true)

Avalonia projects are compiled as Windows applications with STA (Single-Threaded Apartment) thread support, identical to WinForms configuration.

Required NuGet Packages:

• Avalonia
• Avalonia.Desktop

---

📝 Example Template

The included AvaloniaApp.md demonstrates:

• Basic Avalonia application setup with AppBuilder
• Cross-platform UI using Avalonia controls
• Async UI updates with Dispatcher.UIThread
• Window configuration and layout

---

🎯 Usage

Users can now:

1. Select "Avalonia" from the project type dropdown
2. Write Avalonia UI code in the editor
3. Add required NuGet packages (Avalonia, Avalonia.Desktop)
4. Run and see Avalonia desktop applications

---

Create PR ➔

---

• Branch: claude/issue-66-20251024-0115