# wine-uwp：在修改版 Wine 上运行打包的 Windows 商店应用

> 扩展 Wine 11.17，使已签名的 MSIX 商店应用（主要目标为 Shapr3D）无需源码或符号即可在 Linux 上安装运行。约 49,000 行改动新增了 DirectComposition 实现、合成交换链和应用模型宿主；微软自己的 XAML 与应用模型 DLL 则在使用者机器上从 Windows 11 镜像中提取后原样运行。作者称大部分逆向工程和代码由 Claude 完成；各应用支持程度不一，由项目回归测试检查。

- 类型：案例
- 目标：应用
- 类别：独立重建案例
- 关联：独立重建项目
- 来源复核于：2026-10-18
- 收录于：2026-10-18
- 原始资源：<https://github.com/designgears/wine-uwp>
- 一手来源：<https://github.com/designgears/wine-uwp/blob/1cf79d025e0c18167de803820345a1c5f82fd17d/README.md>
- 目录页面：<https://awesomerea.org/zh/resources/wine-uwp-store-apps-case/>
- 记录 JSON：<https://awesomerea.org/resources/wine-uwp-store-apps-case/record.json>
- 英文版：[English](https://awesomerea.org/resources/wine-uwp-store-apps-case/index.md)

## 使用条件与局限

- **前提条件：**需要使用者自己的应用包（.msix 或 .msixbundle，或 Shapr3D 的 .appinstaller，安装程序据此下载约 1.8 GB），以及从微软免费的 Windows 11 评估版 ISO 或其他 Windows 11 镜像中提取的 Windows 组件。仓库和发布包均不含这些内容，提交钩子会拒绝 Windows 二进制文件。Shapr3D 还需要账号并通过浏览器登录。
- **前提条件：**构建时把仓库内的 wine/ 文件复制到 Wine 11.17 源码之上，再运行 autoreconf、带 --enable-archs=x86_64 的 configure 和 make；WinRT 替身组件使用 clang-cl 与 lld-link，针对 xwin 获取的 Windows SDK 头文件构建。Shapr3D for Linux 需要 glibc 2.38+ 的 64 位 Linux、可用的 Vulkan 驱动，安装期间约需 11 GB 空闲空间；其发布包用 flatpak-builder 在 freedesktop 25.08 SDK 中构建。
- **测试证据：**README 的应用列表报告：Shapr3D 的草图、建模、菜单、云同步、登录及 STL／PDF 导出可用；Solitaire 可游玩；Media Player 能从自身界面播放音频；Calculator 完全可用；Feedback Hub 可交互；Camera 只能进入它自己的错误页面。Shapr3D for Linux（58d9173）将同一固定版本的 wine-uwp 打包为测试版 AppImage 和 Flatpak；它是非官方项目，与 Shapr3D 无关。
- **测试证据：**regress.sh 要求 Calculator 与仓库中保存的基线逐像素一致，并要求其他应用能在私有 Xvfb 显示上启动；release.sh 的冒烟测试检查全新安装能否进入 Shapr3D 的首个界面。Findings 日志既记录修复，也记录失败的尝试。这些检查均为项目自报。
- **许可：**两个仓库都没有顶层许可证文件，GitHub 也未识别出许可证。仓库内的 Wine 文件带有 LGPL-2.1-or-later 声明，安装程序的 Cargo 清单也声明相同许可；替身组件和调查工具未声明许可证。提取的微软组件和商店应用各自保留条款，项目计划也指出，可分发的产品需要以净室方式替换这些组件。作者在 X 帖子中披露大量借助 Claude。

## 一手来源

1. <https://github.com/designgears/wine-uwp/blob/1cf79d025e0c18167de803820345a1c5f82fd17d/README.md>
2. <https://github.com/designgears/wine-uwp/blob/1cf79d025e0c18167de803820345a1c5f82fd17d/AGENTS.md>
3. <https://github.com/designgears/wine-uwp/blob/1cf79d025e0c18167de803820345a1c5f82fd17d/docs/Plan.md>
4. <https://github.com/designgears/wine-uwp/blob/1cf79d025e0c18167de803820345a1c5f82fd17d/docs/Findings-M4.md>
5. <https://github.com/designgears/wine-uwp/blob/1cf79d025e0c18167de803820345a1c5f82fd17d/wine/README.md>
6. <https://github.com/designgears/wine-uwp/blob/1cf79d025e0c18167de803820345a1c5f82fd17d/wine/BASE.txt>
7. <https://github.com/designgears/wine-uwp/blob/1cf79d025e0c18167de803820345a1c5f82fd17d/wine/dlls/dcomp/composition.c>
8. <https://github.com/designgears/wine-uwp/blob/1cf79d025e0c18167de803820345a1c5f82fd17d/regress.sh>
9. <https://github.com/designgears/wine-uwp/blob/1cf79d025e0c18167de803820345a1c5f82fd17d/packaging/harvest/manifest.txt>
10. <https://github.com/designgears/shapr3d-linux/blob/58d91731a3cef9f9279a9f277f0f6d87e3ec7e41/README.md>
11. <https://github.com/designgears/shapr3d-linux/blob/58d91731a3cef9f9279a9f277f0f6d87e3ec7e41/.gitmodules>
12. <https://github.com/designgears/shapr3d-linux/blob/58d91731a3cef9f9279a9f277f0f6d87e3ec7e41/installer/Cargo.toml>
13. <https://x.com/DesignGears/status/2109530620321788301>
14. <https://x.com/DesignGears/status/2109532140907921698>

## 同分区更多条目：应用

- [RKD Telemetry Extractor：解读 Race-Keeper 赛道日录制数据](https://awesomerea.org/zh/resources/rkd-telemetry-extractor-case/index.md) · 案例
- [Elgato HDR：为 Elgato 4K X 的 10 位模式提供用户态采集通路](https://awesomerea.org/zh/resources/elgato-hdr-uvc-capture-case/index.md) · 案例
- [LGwebOS-menubar：LG webOS 电视的原生 macOS 遥控器](https://awesomerea.org/zh/resources/lgwebos-menubar-remote-case/index.md) · 案例
- [Galaxy Buds Client：基于三星耳机协议的非官方管理器](https://awesomerea.org/zh/resources/galaxy-buds-client-protocol-case/index.md) · 案例
- [Wino Mail：重建 Windows 邮件与日历体验](https://awesomerea.org/zh/resources/wino-mail-case/index.md) · 案例
- [ScooterLink：重建 Honda RoadSync 车把按键协议](https://awesomerea.org/zh/resources/scooterlink-honda-roadsync-case/index.md) · 案例

## 关于此条目

说明已依据一手来源复核。
原创说明采用 MIT 许可；外部项目、论文与素材保留各自的权利和许可。