Skip to content

Play your own Switch games on iPhone/iPad — one-click macOS app, no terminal. | 把 Switch 游戏装进 iPhone:图形界面一键构建,不用命令行。Bring your own game.

Merge remote-tracking branch 'origin/main' into s-tail

v0lumehib7d83e957d39
diff --cc AGENTS.md
index d8cb336a,86c62307..3b93aa3e
--- a/AGENTS.md
+++ b/AGENTS.md
@@@ -13,5 -13,7 +13,6 @@@ This is the fork's guide. The engine ha
- **Merging with admin rights.** An admin merge never goes over a red check. That holds even when @LNPANDY overrides an objection. If a re-review is slow, the other maintainer pings the reviewer and does not merge with admin rights.
- **Mac launcher layers.** `frontend/` is four SwiftPM targets (`NXCore`, `NXModel`, `NXLauncher`, `NX2Apple`) and the compiler enforces which may import which. Read [frontend/ARCHITECTURE.md](frontend/ARCHITECTURE.md) before you add a file to `frontend/Sources`. It says where a new feature goes. `BuildModel` is gone: the stores are in `NXModel` and `LauncherStores` only wires them. No Swift file there is above 800 lines (`SourceSizeTests`), and the larger ones may only shrink.
- **Checks.** `cd frontend && swift build && swift test` for the Mac launcher (its tests read `engine/`, so sync first), `python3 -m unittest discover -s frontend-qt/tests` for the Qt front end, `python3 -m unittest discover tools/tests` for the tools. The engine's own tests run in `engine/` as `tests.yml` does. The pre-commit hook runs `python3 tools/engine.py check` when `patches/` or `.upstream-ref` is staged. The pre-push hook runs the checks above for the files the push changes, `tools/githooks.py` has the list. Fix the failure, do not bypass the hook.
+ - **CI on stacks.** The heavy macOS jobs (Mac launcher with `swift test`, Tool tests, the engine jobs) run on the tip of a stack only, and the app build runs only for a packaging change or the label `full-build`. A lower PR of a stack shows them as skipped, which counts as passed. Never skip a whole workflow with a `paths:` filter, a required check must always report. Merge a stack through its top PR with the async API. [CONTRIBUTING.md](CONTRIBUTING.md), section "CI on stacks", has the details.
-- **No long sleeps.** A command never sleeps longer than 60 seconds. Poll a build, a workflow or a download with sleeps of 60 seconds or less, do other useful work in between, and report interim progress instead of leaving the chat silent.
- **Language and text.** Everything is in English except the Chinese pages (`*.zh-CN.md`) and the launcher's strings. No semicolons in UI strings, READMEs and docs. The launcher's strings are not in Swift or Python code. They are one JSON file per language in `frontend/l10n/`, read by the Mac launcher and the Windows launcher. A new string is a line in `en.json` and `zh.json` (English and Chinese have every key, the other languages may miss one and then show English). The language list is in the files too (the `_language` entry: name, locale prefixes, order). `Lang` is not an enum, so a new language is one new file under `frontend/l10n/` for the Mac and Windows launchers (the iOS shell's texts are in the same files under `ios.ui.` and `ios.host.`, and `python3 tools/l10n_shell_catalogs.py` writes the shell's `Localizable.xcstrings` from them, never edit those by hand). The files go into the apps by the build workflows, see `frontend/README.md`, section "Language".
- **Release notes.** They follow `.github/release_notes_template.md`, English first, then Chinese, no emojis.