Files
d2r-mobile/docs/DEPENDENCIES.zh-CN.md
T

5.0 KiB
Raw Blame History

依赖一览

构建需要的东西都在这一页:每一项是什么、用来做什么、去哪里拿、怎么装。表里的版本是我们实际构建用过的版本;更新的版本一般也能用,出问题时先换回表里的版本。

English: DEPENDENCIES.md

你自己要准备的

需要什么 用来做什么 说明
一台 Apple 芯片的 Mac 构建与运行宿主 需要 macOS 与下面的 Xcode
你自己的游戏文件 主程序与全部游戏资源 本仓库不含任何游戏文件。需要 Switch 版 3.3.94012 的程序文件(ExeFS)与更新包资源(RomFS),从你自己购买并拥有的游戏导出,见 GAME_FILES.zh-CN.md
Apple 开发者账号 给 App 签名并装到自己的设备上 付费账号可用全部功能。免费账号(个人团队)签不了 iCloud、持续执行、加大内存上限这几项:出包时加 DM_FREE_ACCOUNT=1 会去掉它们,少的是 iCloud 存档同步,游戏照常运行;免费账号签的 App 每 7 天要重装一次。用免费账号时:构建前把手机用数据线连上并解锁、在本机配置里填 DM_IOS_UDID(构建以这台手机为目标,苹果才肯给免费团队生成描述文件);装好后第一次打开前,到手机「设置 → 通用 → VPN 与设备管理」里信任你的开发者账号。这一档已真拿免费账号签过、装机进局(12 GB 内存的机器);6 GB / 8 GB 的机器没验

构建工具

工具 版本 用来做什么 官方地址 安装
Xcode(含 Metal 编译器) 26.6 编译 App、把着色器编成 Metal 库 https://developer.apple.com/xcode/ 从 App Store 或开发者网站安装
Homebrew — 安装下面几个命令行工具 https://brew.sh 按官网首页的一行命令
XcodeGen 2.45.4 由 project.yml 生成 Xcode 工程 https://github.com/yonaskolb/XcodeGen brew install xcodegen
.NET SDK 10.0 编译着色器翻译工具 https://dotnet.microsoft.com/download brew install dotnet
SPIRV-Cross 1.4.357 把翻译出的 SPIR-V 转成 Metal 着色语言 https://github.com/KhronosGroup/SPIRV-Cross brew install spirv-cross
Python 3 3.14 运行生成与验证脚本 https://www.python.org/downloads/ macOS 自带或 brew install python

Python 包

包 版本 用来做什么 地址
Pillow 12.1.1 由游戏文件生成界面图 https://pypi.org/project/pillow/
numpy 2.4.4 同上 https://pypi.org/project/numpy/
lz4 4.4.5 解开主程序文件 https://pypi.org/project/lz4/
capstone 5.0.9 反汇编,用于改写主程序与验证 https://pypi.org/project/capstone/
unicorn 2.1.4 逐处核对改写前后行为等价 https://pypi.org/project/unicorn/

一次装齐:python3 -m pip install pillow numpy lz4 capstone unicorn(./setup.sh 会自动建独立环境并装好,不用手动执行)

可选

工具 用来做什么 官方地址
astcenc 给不支持 BC 贴图格式的旧机型转换贴图 https://github.com/ARM-software/astc-encoder
hactool 用 dm/tools/extract_game.sh 从你的游戏包取文件时要用;游戏文件已经用别的办法备好时不用装。我们实测用的是上游提交 1d64a83 https://github.com/SciresM/hactool

真机与验证脚本额外需要

只出包、在 Mac 上冒烟用不到这些;跑真机冒烟、界面回归或 dm/verify/ 下的验证脚本时才要。

工具 用来做什么 安装
timeout 给跑局和构建设墙钟上限(多个脚本用到) brew install coreutils
iproxy、ideviceinfo 真机冒烟经 USB 转发日志端口、读设备电量 brew install libimobiledevice
llvm-objdump、llvm-objcopy 改写等价核对里反汇编与取段 brew install llvm

随仓库的第三方代码

这些已经在仓库里,不用另外下载;各自的许可证在对应目录。

位置 内容 许可证 上游
dm/third_party/bcdec BC 贴图解压 MIT 或 Unlicense(任选) https://github.com/iOrange/bcdec
dm/third_party/flip 画面差异度量 BSD 3-Clause https://github.com/NVlabs/flip
dm/third_party/libdeflate 解压 MIT https://github.com/ebiggers/libdeflate
dm/third_party/ryujinx Ryujinx 1.3.2 的着色器翻译库(三个项目,未修改),把 Switch 原版着色器翻译成 SPIR-V MIT https://github.com/Ryubing
dm/gfx/nvn/include/nvn.h 图形接口声明 MIT 文件头注明作者
dm/gfx/nvn/nvn_tex.c 中的排布尺寸算法 移植自 deko3d zlib https://github.com/devkitPro/deko3d
dm/tools/patch_nso.py 里让游戏离线运行的 7 处改写 取自社区的离线修复补丁(LFS Mod Offline Fix) 未知 首发处与作者我们没有确切记录,知道的请开 Issue,见 DERIVED.zh-CN.md