jhaizhou-ops/d2r-mobile v1.0.5

on GitHub

A newer shell is available: v1.0.18. The shell and the repository must be from the same version; with the current main please use v1.0.18.

已有更新的壳：v1.0.18。壳和仓库必须是同一版，配合现在的 main 请用 v1.0.18。

English

A new shell for the current main, and the first version of a native macOS App.

Playing on a Mac (new)

On an Apple silicon Mac, after the same ./setup.sh, one more command builds a native macOS App that starts on double-click and works with keyboard, mouse and gamepad — no developer account, no device registration:

source ~/dm-work/build/cache/dm/venv/bin/activate
dm/tools/mac_app.sh        # produces ~/dm-work/out/macapp/D2R Mobile.app

The App contains only our own program and points at what your machine built from your game files, so it runs only on the Mac that built it. Key mapping, first launch and what is not there yet: docs/MAC.md.

This is a first version and nobody has actually sat down and played it yet: keyboard keys, a physical gamepad, the resource-folder dialog, ⌘Q and menu clicks, and how it feels in the hand have not been operated by a person. What was verified was run unattended. If you try it, please tell us how it went.

iPhone / iPad

If you use the no-Xcode route, replace your shell with the one on this page and update the repository to this version. If you build with Xcode, pull main and rebuild. The shell carries the same program changes as main (the Mac work touched files that are also compiled into the iOS program); there is no change in iOS behaviour to call out in this round.

Docs

• The game version is now named as the console shows it: 1.0.34.0 (it corresponds to PC version 3.3.94012, the number used in directory names and tools).
• The tools only check the version of the main program and do not distinguish package formats (.xci / .nsp).
• A note on community ports to other game versions, which are welcome as contributions.

Assets

• D2RMobile-shell.ipa: the shell (for both iPhone and iPad). Its checksum is in SHA256SUMS.txt. Use it with the source of this version.

How this release was checked

Built from the public tree in an empty working directory, in a normal Terminal environment (UTF-8 locale, no DOTNET_ROOT set); packaged once with exactly what you get — this shell, this tree, another empty working directory — and an install package was written; on the same fresh tree, the host build, the three unit-test suites and the Mac smoke run; then the macOS App was built with dm/tools/mac_app.sh and started unattended into a game (saves in a separate test directory). All on a Mac.

中文

配合现在的 main 的新一版壳，以及原生 macOS App 的第一版。

在 Mac 上玩（新增）

Apple 芯片的 Mac 上，同一份 ./setup.sh 做完之后，再跑一条命令就能出一个原生的 macOS App，双击启动，键盘、鼠标、手柄都能用，不需要开发者账号，也不需要登记设备：

source ~/dm-work/build/cache/dm/venv/bin/activate
dm/tools/mac_app.sh        # 产出 ~/dm-work/out/macapp/D2R Mobile.app

App 里只有我们自己的程序，指向你这台机器用你的游戏文件做出来的东西，所以只能在构建它的这台 Mac 上跑。键位、第一次打开要做的事、这一版还没有的东西，见 docs/MAC.zh-CN.md。

这是第一版，还没有人真的坐下来玩过：键盘按键、实体手柄、选资源文件夹的对话框、⌘Q 与菜单点击、真人手感，都没有人实际操作过；验过的部分是无人值守跑出来的。试过的朋友请告诉我们结果。

iPhone / iPad

**走「不用 Xcode」那条路的，请把壳换成本页这一份，并把仓库更新到这一版。**用 Xcode 构建的，拉取 main 重新构建即可。壳带的是和 main 相同的程序改动（Mac 这部分工作动到了 iOS 程序里也会编进去的文件）；这一轮没有需要单独说明的 iOS 行为变化。

说明

• 游戏版本改用主机上显示的叫法：1.0.34.0（它对应 PC 版的 3.3.94012，目录名和工具里用的是后一个号）。
• 工具只核对主程序的版本，不区分游戏包的格式（.xci / .nsp）。
• 加了一段关于社区适配其他游戏版本的说明，欢迎贡献。

附件

• D2RMobile-shell.ipa：壳（同时面向 iPhone 与 iPad），校验值见 SHA256SUMS.txt。请与这一版的源码一起用。

这一版是怎么验的

在空的工作目录里、按普通终端的环境（UTF-8 区域、不设 DOTNET_ROOT）从公开的代码出壳；用你拿到的那一套——这份壳、这份代码、另一个空的工作目录——原样做一次包，写出了安装包；在同一棵全新的代码上跑了宿主构建、三套单测和 Mac 冒烟；随后用 dm/tools/mac_app.sh 出 macOS App，并无人值守地起到进游戏（存档放在单独的测试目录）。以上都在 Mac 上完成。