NewLife/XCoder

README.md
# XCoder for macOS(Newlife.XCoder) 当前整理版本:**0.3.3 · 2026-10-19**。官方上游:[NewLifeX/XCoder](https://github.com/NewLifeX/XCoder)。本工程仅维护 `XCoderMac/`,通过 `../XCoderAv/XCoderAv.csproj` 复用原项目,不修改 Windows / XCoderAv 上游源码。 **先读这里:** [项目现状、已完成和未完成 26 项清单](/NewLife/XCoder/Blob/master/XCoderMac/Docs/项目现状与任务总清单.md) · [项目文档导航](/NewLife/XCoder/Blob/master/XCoderMac/Docs/文档索引.md) · [界面截图](/NewLife/XCoder/Blob/master/XCoderMac/Docs/软件界面/截图目录.md)。 ## 当前可以使用什么 - **26 个工具入口、4 个分类**,主窗口多标签、左侧「已打开工具」、快速搜索与可管理的快捷入口。 - 统一亮色主题和日志/SQL 结果专用黑底;针对悬停/焦点有 UI 检查。 - 数据建模:数据库连接配置、表/字段展示、生成实体;XML 模型离线导入导出、表字段索引编辑、建表 SQL 预览/保存、架构管理和 SQL 查询器入口。 - 数据同步:源/目标库配置、连接状态、表选择 UI;尚未进行真实跨库数据一致性验证。 - RPC API 调试、加密解密异常保护、正则表达式、网络工具、Redis、USB 信息、声卡信息、语音助手等 Mac 适配界面/局部实现。 **重要:** 目前 **26/26 有 A 级界面入口,只有部分 B 级局部功能已验证**。SQL/DDL 真正执行、数据库同步、硬件写入、文件覆盖等没有完整生产验收。详见[进度分级和未完成项](/NewLife/XCoder/Blob/master/XCoderMac/Docs/项目现状与任务总清单.md),不要直接把高风险操作用于生产库或生产设备。 ### Windows “数据工具”的 Mac 入口 无需额外的「数据工具」侧栏按钮。现在: - 「**开发与数据 → 数据建模**」:在连接设置和代码生成设置下方,找到「模型与数据库工具」的 XML/模型管理/SQL/架构操作。 - 「**开发与数据 → 数据同步**」:使用既有同步页面。 - 「**设备与运维 → Redis 管理**」。 详见 [Windows 数据工具迁移说明](/NewLife/XCoder/Blob/master/XCoderMac/Docs/Windows数据工具Mac版功能迁移与验收.md)。 ## 工程结构 ```text XCoderMac/ ├── Views/ # Mac 原生窗口和适配视图 ├── Services/ # 用户配置、Keychain、模型工具、快捷入口等 ├── Styles/ # 统一颜色和深色控制台样式 ├── Dialogs/ # 统一操作确认 ├── Docs/ # 当前进度、专题说明及实际界面截图 ├── package-macos.sh # Mac 自包含 App / DMG 制作 ├── XCoderMac.csproj # .NET 10 / Avalonia 12.1.1 └── bin/ obj/ dist/ # 本地生成产物(git 忽略) ``` ## 编译、测试与发布 在仓库根目录执行: ```bash dotnet build XCoderMac/XCoderMac.csproj -c Debug --no-restore # 2026-10-20 上游 XCoderAv 暂有 CS0103(L 未定义)时,临时复用已有上游编译产物: dotnet build XCoderMac/XCoderMac.csproj -c Debug --no-restore -p:BuildProjectReferences=false dotnet run --project XCoderMac/XCoderMac.csproj -c Debug --no-build # 只测刚修改的模块,例如: dotnet run --project XCoderMac/XCoderMac.csproj -c Debug --no-build -- --smoke-sql-ui dotnet run --project XCoderMac/XCoderMac.csproj -c Debug --no-build -- --smoke-modeling-layout # 文件编码窗口专项布局测试(不会进行扫描或文件转换): dotnet run --project XCoderMac/XCoderMac.csproj -c Debug --no-build -- --smoke-file-encoding-layout # RPC Action 空状态 / 网络默认绑定地址 / 消息调试长地址与分组/控件间距(1050/900): dotnet run --project XCoderMac/XCoderMac.csproj -c Debug --no-build -- --smoke-debug-input-layout # MQTT 顶部连接/发布/订阅三列、底部全宽加高日志、右下清空按钮、hover 黑底(无网络连接): dotnet run --project XCoderMac/XCoderMac.csproj -c Debug --no-build -- --smoke-mqtt-ui # API 发现按钮不重叠、hover 变色、服务列表/日志圆角(无 UDP 广播): dotnet run --project XCoderMac/XCoderMac.csproj -c Debug --no-build -- --smoke-api-discover-ui # 全项目分组留白及加密解密 WrapPanel 两列/按钮间距: dotnet run --project XCoderMac/XCoderMac.csproj -c Debug --no-build -- --smoke-spacing-ui # 全 26 工具初始化(仅窗口,不执行协议或文件写入): dotnet run --project XCoderMac/XCoderMac.csproj -c Debug --no-build -- --smoke-all # 需要生成安装包时: ./XCoderMac/package-macos.sh # 上游 XCoderAv 无法重新编译的临时打包方式(需已有上游编译产物): BuildProjectReferences=false ./XCoderMac/package-macos.sh ``` - Mac 安装包:`XCoderMac/dist/XCoder.app`、`XCoderMac/dist/XCoder-arm64.dmg`,仅 ARM64,自签未公证。 - 用户配置:`~/Library/Application Support/Newlife.XCoder/Config/`;日志:`~/Library/Logs/Newlife.XCoder/`。 - Git:在 `master` 上工作;**未获明确要求不提交、不推送**。每次小界面改动只跑相关模块测试,不必重复全量回归。 - **开发交接硬性规则:每次完成代码或样式修改,必须在同一次任务中更新对应专题文档和 `Docs/项目现状与任务总清单.md`,说明改动位置、原因、验证范围及未解决问题;后续开发先读文档。** - 历史评估保留作参考,不作为现行完成状态;本 README 不再滚动堆叠互相矛盾的逐版本说明。