Stores: installs go to internal storage by default, a card is offered at Install time

The default root for all three stores is the app's own storage, whatever
the session's Game storage says. With a card in the device, Install asks
where first - internal or the card, free space per target, pad-focusable,
last pick only as the dialog's default. A card that is not the Steam
library is bound at its own fixed place, so a game's guest path and appid
hold from one session to the next; a library card keeps the library's
bind and the installs already registered there keep their appid. Every
root is scanned and uninstall works for either.

The Downloads row carries the game's art as a small thumbnail and names
where the game is going; the game page names where it went. Epic installs
on a card keep their in-flight chunks in the app's cache (the Java pool
and the assembly; the engine's own cache stays beside the game until its
contract takes a cache path), cleaned on cancel and uninstall.
This commit is contained in:
The412Banner committed 2026-10-08 19:24:12 -04:00
1 parent 2d70341214
commit 6ca3052eb7
20 files changed
+358 -57

No files matched your search

+15 -6
View File
@@ -13,12 +13,20 @@ the rest of the app, and the on-disk contract that makes a store game an ordinar
.droiddeck-epic-code one-shot, written right before an Epic launch, read and deleted by the .bat
```
`<Games storage>` is the second Steam library when one is chosen (the SD card's app folder, bound
into the session at `/mnt/droiddeck-sd`), else the runtime's own tree, where the folder is
`/root/Games/Stores` (`StoreInstallRoot`). Both roots are always scanned; new installs go to the
current one. `<Store>` is `GOG`, `Epic` or `Amazon`; `<title>` is the title with unsafe characters
dropped, at most 60 characters (`StoreInstallRoot.folderName`), chosen once and read back from the
sidecar afterwards.
The default root is the app's internal storage - the runtime's tree, `/root/Games/Stores`, no bind
needed - whatever the session's Game storage setting says. When a card the app may write is in the
device (`GameStorage.options`), Install asks "Install to" (internal / the card, free space shown;
the last pick is only the dialog's default). A card's root is `<card app folder>/Games`; when the
card is the Steam library the library's bind (`/mnt/droiddeck-sd`) already covers it, otherwise
`SessionService` binds the root at `/mnt/droiddeck-stores/<volume uuid>`, so a shortcut's guest
path - and its appid - is the same from one session to the next. Every root is
scanned (`StoreInstallRoot.roots`): internal, every card, and the Steam library's `Games` folder for
installs an earlier build put there. `<Store>` is `GOG`, `Epic` or `Amazon`; `<title>` is the title
with unsafe characters dropped, at most 60 characters (`StoreInstallRoot.folderName`), chosen once;
a rerun (repair, update) lands on the folder whose sidecar carries the game's id, wherever it is.
An Epic install on a card keeps its in-flight chunks in `cacheDir/stores/epic/<id>/` (the Java pool
and the assembly honour it; the native engine's own cache stays `<installDir>/.chunks` until its
contract takes a cache path); the scratch folder is removed on cancel and uninstall.
## The sidecar
@@ -88,6 +96,7 @@ each manager runs its Java fetch loop.
| Open a store on: Library · Store | `SessionPrefs.storesOpenTab` (library) | the chip row's cog, Setup › Stores |
| Download speed tier | `SessionPrefs.gameStoresSpeedTier` (fast) | the cog, Setup › Stores, Downloads |
| Downloads at a time | `SessionPrefs.gameStoresParallel` (1) | Downloads |
| Install to (last pick, dialog default only) | `SessionPrefs.storesInstallTarget` | the Install dialog |
Credentials live in `filesDir/stores/<store>/credentials.json` only (`StoreAccounts`); store URLs
are logged through `StoreLog.redactUrl`, which drops the query string where the signed tokens live.
+11
View File
@@ -103,6 +103,17 @@ without it and Setup says "Stores engine not built").
from it, for all three stores; the engine's own figure stays in its log lines, and the detail
line under the bar has it stripped. The tier and downloads-at-a-time controls sit on one compact
row with a single caption, on the Downloads page and in the cog's popup.
- **Install location (user decision):** the default is the app's internal storage for all three
stores, whatever the session's Game storage says. With a card in the device, Install asks
"Install to" first (internal / the card, free space per target, pad-focusable, last pick as the
default only). A card that is not the Steam library gets a bind of its own in the session
(`/mnt/droiddeck-stores/<volume uuid>`; the library's own bind covers a library card, so installs
already registered there keep their appid); every root is scanned and uninstall works for
either. The Downloads
row shows where a game is going, with its art as a small 16:9 thumbnail; the game page names the
place. Epic installs on a card keep their in-flight chunks in the app's cache (Java pool and
assembly; the native engine's `chunkCacheDir` parameter is not in JNI.md yet and is wired the
moment it lands), cleaned on cancel and uninstall.
- **Device-proven on the AYANEO Pocket FIT, 2026-10-08 (GOG):** sign-in, the library (33 owned),
DOOM I Enhanced installed through the GOG engine to the SD Games root, shown in Games with the
GOG chip and real art, registered as a non-Steam game in the Steam client (grid art present), and