Skip to content

iOS shell README: a shell built from the scripts alone puts the shaders on the game image (#1327) - #1341

Open
Haseenesss wants to merge 1 commit into
LNPANDY:mainfrom
Haseenesss:fix/1327-script-shell-shader-trailer
Open

Haseenesss wants to merge 1 commit into
LNPANDY:mainfrom
Haseenesss:fix/1327-script-shell-shader-trailer

Conversation

@Haseenesss

@Haseenesss Haseenesss commented Nov 15, 2026 •

Copy link
Copy Markdown
Contributor

Fix or feature

  • Fix
  • Feature

What and why

Fixes #1327.

Problem. A shell app built from the scripts alone (build_ipa_from_nsp.py --shell-framework, then build_shell.sh, no launcher) lists the game, but tapping it shows "Update game data" and the game does not start.
Cause. A framework-only build strips msl/ from the framework, so the shell finds the shaders only as a DMMSLTR1 trailer on the game image. The Mac and Qt launchers add it with romfs_image.py --append-msl; nothing tells someone on the script path that this step is needed.
Change. Documentation only, as asked in review. frontend-ios/README.md gets "A shell built from the scripts alone": the three steps, and for step 2 how to read lib_path, gfx_api, chain and multi_program from <work>/fw/.msl-cache/<title ID>.json into romfs_image.py --append-msl (with --replace-msl when the image already has a trailer). The engine patch on scripts/build_ipa_from_nsp.py from the first version is dropped.

Checked

  • Tests: none apply (README only); the pre-push hook passed.
  • The field names and options were checked against the writer of the record (dm/ios/tools/build_ipa.sh, framework-only build), the Qt reader (nspb_qt/model.py _locate_ios_msl_source) and romfs_image.py --help.
  • Run on a device or Mac: not run with a real game.

Screenshots

None, no visible change.

Scope

  • No engine file (dm/, scripts/, docs/, ref/) is added to the repository: no engine change
  • A fix to the engine or a game profile also goes to seedds/nxnative as a PR in parallel: not applicable, README only
  • A change to a launcher view has before and after screenshots above: no launcher view changes
  • No keys, game files or data extracted from a game in the change or the attachments

🤖 Generated with Claude Code

@github-actions github-actions Bot added documentation Improvements or additions to documentation ios iPhone or iPad patch-queue Changes the patch queue or the upstream pin labels Nov 15, 2026

LNPANDY commented Nov 15, 2026

Copy link
Copy Markdown
Owner

Hi @Haseenesss, thanks for tracking down #1327!

Let's keep this as a frontend-ios/README.md documentation update only and drop the engine patch on scripts/build_ipa_from_nsp.py:

  1. Both the Mac and Qt launchers also invoke build_ipa_from_nsp.py --shell-framework for shared-shell builds, so printing CLI instructions (or <romfs.img> placeholders on fast refresh, or [RED] when .msl-cache is absent) pollutes normal GUI launcher runs.
  2. scripts/build_ipa_from_nsp.py is a high-churn upstream file where fork-only additions conflict on nearly every engine bump, and --shell-framework itself is fork-only.

Could you drop the patch from patches/ and update frontend-ios/README.md step 2 to show how to read lib_path, gfx_api, chain, and multi_program from <work>/fw/.msl-cache/<title ID>.json when running romfs_image.py --append-msl? Thanks!

…rs on the game image (LNPANDY#1327)

A framework-only build strips msl/ from the framework and records the shaders in
<work>/fw/.msl-cache/<title ID>.json. The shell then finds them only as a trailer
on the game image, which the launchers add and a build from the scripts alone
must add with romfs_image.py --append-msl. The README lists the three steps and
how to read lib_path, gfx_api, chain and multi_program from the record.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@Haseenesss
Haseenesss force-pushed the fix/1327-script-shell-shader-trailer branch from b221e31 to deef6d2 Compare November 15, 2026 22:36
@Haseenesss Haseenesss changed the title Patch 0060: a shell built from the scripts alone gets the command that puts the shaders on the game image (#1327) iOS shell README: a shell built from the scripts alone puts the shaders on the game image (#1327) Nov 15, 2026
@Haseenesss

Copy link
Copy Markdown
Contributor Author

Done: the engine patch is dropped, and the PR is now a frontend-ios/README.md change only, rebased onto the latest main. Step 2 shows how to read lib_path, gfx_api, chain and multi_program from <work>/fw/.msl-cache/<title ID>.json into romfs_image.py --append-msl (and --replace-msl when the image already has a trailer). Title and description are updated.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation ios iPhone or iPad patch-queue Changes the patch queue or the upstream pin

Projects

None yet

Development

Successfully merging this pull request may close these issues.

iOS shell built without a launcher shows "Update game data": nothing on the script path adds the shader trailer to romfs.img

2 participants