比Wine更牛逼一点
活跃的社区分支。 原项目 whisky-app/whisky 已于 2025 年 4 月 9 日归档，并发布了最终维护公告。主分支由 @frankea 维护，继续开发;本分支由 虚幻将会主宰世界 @Uewdtw发布改进版本 —— 处理上游积压的 问题并添加新功能。与原项目或 getwhisky.app 无关联。
Whisky 使用原生 SwiftUI 为 Wine 提供了一个简洁易用的图形化封装。你可以创建和管理容器（bottle）、安装并运行 Windows 应用与游戏，无需任何技术知识即可充分释放 Mac 的潜力。
熟悉的 UI，与 macOS 无缝集成
一键创建和管理 Bottle
轻松调试与性能分析
- Wine 11.0 - 最新稳定版 Wine，兼容性与网络功能均有改进
- DXMT 与 DXVK 图形 - 开箱即用的 DirectX 11 原生 Metal 转译（DXMT），并以 DXVK over MoltenVK 作为通用后备方案
- 启动器兼容 - 内置支持 Steam、Epic、EA App、Rockstar、Battle.net 等
- 手柄支持 - 通过 SDL 环境变量控制手柄检测与映射问题
- 稳定性诊断 - 一键生成诊断报告，便于排查崩溃与卡死
- 原生 SwiftUI - 美观且熟悉的 macOS 界面
- CPU：Apple Silicon（M 系列芯片）
- 操作系统：macOS Sequoia 15.0 或更高版本
- 下载最新的 Whisky-X.Y.Z.dmg。
- 打开 zip 并将 Whisky.app 拖入 /Applications。
- 启动 Whisky。首次运行时会下载 Wine 运行时（约 330 MB）并设置默认 bottle，完成后退出 Whisky。
- 下载最新的GPTK，Game Porting Toolkit - Games - Apple Developer 下载文件应为"Game_Porting_Toolkit_X.X(_beta X).dmg"。
- 下载兼容 GPTK 的 Wine 引擎引擎，找到类似"Wine Libraries vX.X.X-beta.X (GPTK-capable)" 的 release，下载"Libraries.tar.gz"文件。
- 打开 mac 终端，执行
cd /path/to/Libraries.tar.gz/ #将目录替换为你下载Libraries.tar.gz的根目录
tar -xzf Libraries.tar.gz -C ~/Library/Application\ Support/com.franke.Whisky/- 再次启动 Whisky，点击 apple 图标旁边的"Whisky"，进入设置--Game Porting Tookit--从Game Porting Tookit导入--选择您下载的Game_Porting_Toolkit_X.X(_beta X).dmg文件。
- 好好玩吧!
将 Whisky.app 拖到废纸篓只会移除应用本身，而保留 Wine 运行时、你的 bottle 以及应用数据 —— 这是有意为之，这样重装时不必重新下载约 330 MB 的文件，也不会丢失你的 bottle。
⚠️ 如果想保留 bottle，请先备份。 删除下面的容器目录会清除所有存储在默认位置的 bottle。若你把 bottle 创建在自定义文件夹中，它们就在你指定的位置 —— 删除前请先查看 Bottle → 在 Finder 中显示。
要彻底移除 Whisky，请删除应用，然后删除以下路径（均位于 ~/Library 下）：
# 1. 应用本体
rm -rf "/Applications/Whisky.app"
# 2. Bottle 及 bottle 列表（默认 bottle 位置位于此容器内）
rm -rf ~/Library/Containers/com.uewd.Whisky
rm -rf ~/Library/Containers/com.uewd.Whisky.WhiskyThumbnail
# 3. Wine 运行时（约 330 MB）及其他应用支持文件
rm -rf ~/Library/Application\ Support/com.uewd.Whisky
# 4. 缓存、日志、偏好设置与保存的状态
rm -rf ~/Library/Caches/com.uewd.Whisky
rm -rf ~/Library/Logs/com.uewd.Whisky
rm -rf ~/Library/HTTPStorages/com.uewd.Whisky
rm -f ~/Library/Preferences/com.uewd.Whisky.plist如果你还在自定义位置安装了 bottle，也请一并删除那些文件夹。从原应用迁移过来、仍属于原应用的 bottle 位于 ~/Library/Containers/com.isaacmarovitz.Whisky，上述步骤不会动它们。
Whisky 默认不发送任何数据。在首次运行设置时，你可以选择开启匿名使用遥测 —— 这是一个默认关闭的勾选框，只有你主动勾选才会启用，并且可以随时在 设置 → 隐私 中切换。
当且仅当启用时，Whisky 会发送五个与首次运行流程相关的事件，以便维护者了解新安装在哪里失败：
| 事件 | 属性 |
|---|---|
runtime_install_started |
— |
runtime_install_succeeded |
— |
runtime_install_failed |
reason：取值之一为 download_failed、verify_failed、tarball_missing、extract_failed、runtime_incomplete |
first_bottle_created |
— |
first_program_launch_attempted |
— |
runtime_install_started 在每次安装尝试时发送一次；_succeeded / _failed 事件按每次安装尝试发送（因此重试会被计数）。两个 first_… 事件每个安装最多发送一次。
不会发送任何个人数据、文件名、路径、原始错误文本或与你的身份相关联的标识符。事件携带一个随机的、按安装生成的匿名 ID（若你选择退出则会重置）。Whisky 能发送的所有事件就是上面列出的这些，且全部声明在一个文件 Whisky/Utils/Telemetry.swift 中，分析 SDK 的所有自动采集功能均已禁用，也从不创建任何用户画像（identify() 从未被调用）。每个事件还携带 SDK 的标准上下文 —— 应用与 macOS 版本、硬件型号、区域设置等；完整列表见 SECURITY.md。与任何 HTTPS 请求一样，PostHog 的接入端会看到连接的 IP（GeoIP 增强已禁用）；这些信息都不会与你的身份关联。
按问题逐一说明本分支如何处理已归档上游仓库中的开放问题。阅读 docs/AUDIT.md 了解方法 —— 包括如何理解 addressed-direct 与 addressed-categorical 的区别，以及 unverified 的 GameDB 条目究竟意味着什么。
上方的覆盖率徽章范围限定为 whiskykit 标记 —— 即承载 bottle、Wine、GameDB 与 PE 解析器逻辑的框架的代码行覆盖率，由 swift test --enable-code-coverage 按 .github/workflows/CI.yml 测量。Codecov 仪表盘 上显示的项目整体混合数字要低得多，因为它把 SwiftUI 应用目标也纳入平均，而该目标只尽力进行 UI 测试覆盖。请将此徽章理解为「WhiskyKit 的单元测试覆盖率」，而非整个应用的覆盖率。
WhiskyUITests 为 SwiftUI 界面（工具栏、新建 bottle 表单、依赖 fixture 的流程）提供行为覆盖。CI 现在使用 -enableCodeCoverage YES 运行它们，并将生成的应用目标覆盖率以单独的 whiskyapp 标记上传到 Codecov（尽力而为 —— 上传从不阻塞 CI）。由于 UI 测试覆盖的应用范围远小于单元测试对 WhiskyKit 的覆盖，预期应用目标数字会低于上方的 WhiskyKit 徽章。
Whisky 的诞生离不开以下项目的魔力：
- msync by marzent
- DXVK-macOS by Gcenx and doitsujin
- DXMT by 3Shain
- MoltenVK by KhronosGroup
- Sparkle by sparkle-project
- SemanticVersion by SwiftPackageIndex
- swift-argument-parser by Apple
- CrossOver by CodeWeavers and WineHQ
- D3DMetal by Apple
特别感谢 Gcenx、ohaiibuzzle、Nat Brown 以及 Isaac Marovitz（原作者）的支持与贡献！
|
没有 CrossOver 就没有 Whisky。如果你想在 macOS 上获得完全受商业支持的 Wine 体验，请查看 CodeWeavers 的 CrossOver。（本分支与 CrossOver 无任何联盟关系，也不会从 CrossOver 的销售中获得任何收益。） |