mirror of
https://github.com/bryanthaboi/gen1recomp.git
synced 2026-08-18 03:35:56 +02:00
Andrew Quenehen
84e1a5177b
Enable HTTPS peer checks via a romfs CA bundle, remove existing NROs before rename on sdmc, and surface launcher replace failures before writing version.txt.
75 lines
2.3 KiB
Markdown
75 lines
2.3 KiB
Markdown
# Native Switch OTA launcher
|
|
|
|
In-console updates for Gen1Recomp on Nintendo Switch. This NRO is the **hbmenu
|
|
entry** (`gen1recomp.nro`). It checks GitHub Releases quietly (no UI when you
|
|
are already up to date or offline). Only if a newer release exists does it show
|
|
a **launcher-style screen** (black + RGB rail + project logo + flat A/B
|
|
buttons), download the same `gen1recomp-*-switch.zip` used for install, verify
|
|
SHA-256 from `sha256sums.txt`, replace **both** `gen1recomp-game.nro` and
|
|
`gen1recomp.nro` (matching NACP version for hbmenu/Sphaira), then load the game
|
|
with `envSetNextLoad`.
|
|
|
|
The LÖVE self-updater (`src/update/Check.lua`) stays **disabled** on NX.
|
|
Wire format (also in Lua): `src/update/SwitchOta.lua`.
|
|
NACP icon: `assets/switch/icon.jpg`.
|
|
|
|
## Layout on microSD
|
|
|
|
```text
|
|
sdmc:/switch/gen1recomp/gen1recomp.nro <- this launcher
|
|
sdmc:/switch/gen1recomp/gen1recomp-game.nro <- fused LÖVE game
|
|
sdmc:/switch/gen1recomp/version.txt <- installed X.Y.Z
|
|
sdmc:/switch/gen1recomp/pokemon-love2d/ <- saves (never touched by OTA)
|
|
```
|
|
|
|
## Host tests (no DEVKITPRO)
|
|
|
|
```bash
|
|
cd native/switch-ota-launcher
|
|
make host-test
|
|
```
|
|
|
|
## Switch build (DEVKITPRO)
|
|
|
|
Needs `DEVKITPRO` with packages roughly:
|
|
|
|
```bash
|
|
(dkp-)pacman -S --needed switch-curl switch-mbedtls switch-zlib switch-zziplib
|
|
# or: bash scripts/switch/install_devkitpro_deps.sh
|
|
```
|
|
|
|
```bash
|
|
export DEVKITPRO=/opt/devkitpro # typical
|
|
cd native/switch-ota-launcher
|
|
make
|
|
# -> gen1recomp.nro
|
|
```
|
|
|
|
Or from repo root (as part of `--fused`):
|
|
|
|
```bash
|
|
scripts/build_switch.sh --fetch --fused --version X.Y.Z
|
|
```
|
|
|
|
Standalone launcher build:
|
|
|
|
```bash
|
|
scripts/switch/build_ota_launcher.sh
|
|
```
|
|
|
|
Docker fallback uses the same pin as fused builds (`scripts/switch/dkp-docker.image`).
|
|
|
|
## Packaging
|
|
|
|
`scripts/switch/pack_sd_zip.sh GAME_NRO VERSION OUT_ZIP LAUNCHER_NRO` writes both
|
|
NROs into the SD zip. That zip is also what OTA downloads.
|
|
Manifest: `scripts/switch/ota_launcher.manifest`.
|
|
|
|
## Status / known gaps
|
|
|
|
- Zip extraction uses `switch-zziplib` (`ota_unzip.c`) on device.
|
|
- OTA replaces launcher + game from the install zip (NACP versions stay aligned).
|
|
- HTTPS uses Mozilla CA bundle in romfs (`cacert.pem`, fetched at build time).
|
|
- Sphaira HOME forwarders cache metadata until reinstalled (see docs/switch-install.md).
|
|
- Release runner: `switch-dev` + (`install_devkitpro_deps.sh` **or** Docker)
|