Files
d2r-mobile/docs/DEPENDENCIES.zh-CN.md
T
jhaizhou b50b976523 Older devices (A16 and earlier): a start-to-finish guide for the Legacy Device Pack
docs/LEGACY_DEVICES.md explains why older chips need an extra texture pack, how to build the astcenc encoder, the three commands that make the pack from your own game files, how to build the App with it and where the folder goes on the phone. The README links to it from the performance section and the status table. astc_pack.py now names the output folder "Legacy Device Pack", the name the App asks for.
2026-10-13 19:23:29 +08:00

5.2 KiB
Raw Blame History

依赖一览

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

English: DEPENDENCIES.md

你自己要准备的

需要什么 用来做什么 说明
一台 Apple 芯片的 Mac 构建与运行宿主 需要 macOS 与下面的 Xcode
你自己的游戏文件 主程序与全部游戏资源 本仓库不含任何游戏文件。需要 Switch 版 1.0.34.0(对应 PC 版 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 贴图格式的旧机型(A16 及更早)转换贴图;从源码编,编法与整条做法见 LEGACY_DEVICES.zh-CN.md。我们用的是 v5.2.0 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