mirror of
https://github.com/Droid-Deck/DroidDeck.git
synced 2026-11-20 05:16:01 +00:00
Merge upstream PC input and dual-screen updates
This commit is contained in:
commit
68b0396dfe
819 files changed
+43953
-6186
No files matched your search
+23
-1
@@ -26,7 +26,7 @@ and reports every run.
|
||||
|
||||
Player controls and observations work over authorized ADB on any build: `state`, `start`, `stop`,
|
||||
`resume`, `wait`, `launch`, `quit`, `focus`, `input`, `ui`, `logs`, `screenshot`, `record`, `pacing`,
|
||||
`displays`, `wake`, `glasses` (except `glasses raw`), and `access`.
|
||||
`thermal`, `displays`, `wake`, `glasses` (except `glasses raw`), and `access`.
|
||||
|
||||
**Setup > Diagnostics > Debugging tools** is off by default in every build, including debug builds.
|
||||
It enables `run`, `guest`, `cdp`, all `env` operations, `override`, `prefs`, and `glasses raw`. The
|
||||
@@ -39,6 +39,21 @@ Disabling the toggle clears queued and persistent agent environment settings and
|
||||
overrides. Disabled settings cannot apply at the next session start. Already running commands and
|
||||
effects already applied to a session are not undone; stop and restart that session to discard them.
|
||||
|
||||
Program overrides prepend their directory to the normal session PATH, including `/usr/games`
|
||||
where Ubuntu installs `gamescopereaper`. An explicit `PATH=...` environment entry replaces that
|
||||
default. If an old persistent PATH hides runtime tools, inspect `tools/droiddeckctl env list`
|
||||
and correct only PATH with `env set --persistent`, which preserves other persistent entries.
|
||||
For example, to restore the normal runtime search path:
|
||||
|
||||
```sh
|
||||
tools/droiddeckctl env set --persistent 'PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games'
|
||||
```
|
||||
|
||||
Retain any custom directories you still need alongside these runtime directories, then restart
|
||||
the session. `env clear persistent` removes **all** persistent environment settings, not just
|
||||
PATH; there is no single-entry clear operation. Before clearing that scope, record any other
|
||||
entries you want to keep and reapply them afterward.
|
||||
|
||||
Authorized command execution runs inside the runtime containing Steam's saved login. CDP evaluates
|
||||
JavaScript in the authenticated Steam client, and preferences can contain private values. These
|
||||
capabilities remain unrestricted when enabled: the toggle is an explicit opt-in, not credential
|
||||
@@ -125,6 +140,8 @@ tools/droiddeckctl screenshot ./screen.png --display 4
|
||||
tools/droiddeckctl xr-frame ./xr-capture
|
||||
tools/droiddeckctl record ./clip.mp4 --seconds 8 --display 0
|
||||
tools/droiddeckctl pacing --seconds 30
|
||||
tools/droiddeckctl thermal
|
||||
tools/droiddeckctl wait cool --below 38 --timeout 900
|
||||
tools/droiddeckctl displays
|
||||
tools/droiddeckctl wake
|
||||
|
||||
@@ -162,6 +179,11 @@ the present-to-present histogram and the share of intervals off the usual cadenc
|
||||
counter counts frames handed over, not frames shown, so it can read 60 while one frame in four
|
||||
stays on screen for two refreshes.
|
||||
|
||||
`thermal` reports the battery temperature (`dumpsys battery`), the thermal status
|
||||
(`dumpsys thermalservice`, 0 NONE to 6 SHUTDOWN) and each CPU policy's `scaling_max_freq` against
|
||||
its `cpuinfo_max_freq`, with `capped` when the first is lower. `wait cool --below <°C>` polls it
|
||||
every 10 s until the battery is under that temperature, so runs being compared start equally cool.
|
||||
|
||||
`input` needs a session that has drawn its first frame. Pad input goes through the session screen's
|
||||
virtual pad, the same one the on-screen controls drive, so games that ignore touch still respond.
|
||||
`launch`, `quit` and `cdp` need a Steam session; `focus` and `wait focused` need gamescope (every
|
||||
|
||||
@@ -52,6 +52,23 @@ environment entries and is intentionally narrower than **Reset game profile**.
|
||||
Values are literal strings, with no shell expansion; quotes are only needed when
|
||||
the consuming program expects them.
|
||||
|
||||
## Saved compatibility mappings
|
||||
|
||||
The file-backed `steam-compatibility` writer applies planned changes in a batch,
|
||||
rather than searching and copying the mapping for each game. This covers retired
|
||||
DroidDeck-Proton replacements, default/tool changes and the x86-64 client's Proton
|
||||
repointing. It does not change the planner, manual choices, native/FEX routing,
|
||||
locking or atomic file publication. Unchanged files are still not rewritten.
|
||||
|
||||
Existing entry fields and duplicate entries are preserved, with the same first-match
|
||||
updates and reverse insertion order as the single-game writer. Single changes keep
|
||||
that writer's original path. This reduces bulk configuration work, not steady-state
|
||||
game rendering cost; large-library timings depend on the device and the number of
|
||||
entries actually changed.
|
||||
|
||||
Run the batch/reference and work-budget regressions with
|
||||
`python3 -m unittest discover -s tools/tests -p test_steam_compat_mapping.py`.
|
||||
|
||||
## Game debug logs
|
||||
|
||||
Under **Setup > Diagnostics**, enable **Session logs** and **Game debug logs**
|
||||
@@ -113,6 +130,13 @@ same WSI layer, and with eight images and no frame limit it drew flat out
|
||||
(about 240 frames a second at 120 Hz) and heated the device. Values set in the
|
||||
launch options or the environment editor are kept.
|
||||
|
||||
DOOM (2016) is the exception (`DOOMx64vk.exe` beside the launched program, which
|
||||
is `DOOMx64.exe` for a GOG install). It asks for exactly two images and stops with
|
||||
`FATAL ERROR: getSwapchainImagesKHR failed with error (VK_SUCCESS)` when it gets
|
||||
more, so its fix removes both variables, also from its launch options, and sets
|
||||
`vk_x11_strict_image_count=true`, the option Mesa's driconf gives the game. A
|
||||
per-game value in the environment editor still wins.
|
||||
|
||||
## Defaults and available suggestions
|
||||
|
||||
The initial configuration enables Mesa shader caching with
|
||||
|
||||
@@ -0,0 +1,66 @@
|
||||
# Game Jolt store
|
||||
|
||||
The Game Jolt Store tab mirrors the itch.io one: browse, search, game page, build picker, installs, library, collections and updates.
|
||||
|
||||
## Sign-in
|
||||
|
||||
Game Jolt shows the normal sign-in card until an account is signed in. Signing in opens
|
||||
`StoreLoginActivity` on `https://gamejolt.com/login` (`GameJoltLogin`). The flow is not a token redirect:
|
||||
Game Jolt is a single-page site, so `StoreLoginActivity.Client.doUpdateVisitedHistory` also reports
|
||||
navigations, and any gamejolt.com page outside the sign-in, sign-up and legal paths counts as signed in.
|
||||
`finish` reads the WebView cookies, asks `/web/search/games?q=a` for the top-level `user`, and stores
|
||||
the cookie header and the user through `GameJoltAuth` (encrypted, `StoreAccounts`). The log names the
|
||||
cookies and the user keys, never their values.
|
||||
|
||||
## Data
|
||||
|
||||
`GameJoltApi` talks to `https://gamejolt.com/site-api/web/...` with the stored cookies. Games come back as
|
||||
`{payload, user}`; `GameJoltCatalog` turns a game into a `CatalogItem` (paid only when `sellable.type` is
|
||||
`paid`).
|
||||
|
||||
Browse queries (`GameJoltBrowse.queryString`): `section=` is always sent first (featured, hot, best, new).
|
||||
Game Jolt answers 404 to any browse request without it, even an empty one. The rest are `tag=`, `f_price=`,
|
||||
and `f_os[]`, `f_browser[]`, `f_maturity[]`, `f_status[]`, `f_partners[]`, `page=`. Every page logs its query,
|
||||
status and game count. The filters are drop-down menus (`BrowseDropdown`, shared with the itch bar). Devlog games have no playable
|
||||
copy, so the status filter only offers complete and early access, and a browse always asks for those two. With mature
|
||||
content off, `adult` is stripped from the query, including a stored one.
|
||||
|
||||
## Prices
|
||||
|
||||
`GameJoltPricing.of` reads `sellable.pricings[]` (amounts in cents). The promotional entry is the current price
|
||||
and the regular entry the original, only when the original is higher; the percent uses integer math. USD (or no
|
||||
currency) formats as `$12.34`, another currency as `12.34 EUR`. `CatalogItem` carries `finalPrice`,
|
||||
`originalPrice` and `discountPercent`, so tiles and the game page show prices and sale badges.
|
||||
|
||||
## Library and collections
|
||||
|
||||
`GameJoltLibrary.sync` fetches `/web/library/games/owned/@<user>` (paged, at most every ten minutes, forced by
|
||||
the refresh action) and merges the games into the store library as owned. `GameJoltCollections` lists the
|
||||
read-only collections: followed games (`/web/library/games/followed/@<user>`) and the account's playlists
|
||||
(`/web/library/games/playlist/<id>`). The Library page shows them through the same `CollectionsButton` as itch.
|
||||
Ownership comes from `sellables[0].is_owned`; `packages[0].is_game_owner` is not reliable. Library chips list a store when it has games in
|
||||
the list; a signed-in Itch.io or Game Jolt account keeps its chip, in store order, so its collections stay reachable.
|
||||
|
||||
## Builds and installs
|
||||
|
||||
`GameJoltBuilds.parse` reads the overview payload, keeps the newest release of each package and marks
|
||||
Windows builds installable. The picker (`GameJoltBuildPicker`) installs Windows builds of free games and of paid games the account owns;
|
||||
Linux builds say "Not supported yet" and everything else, including paid games not owned, opens the Game Jolt page.
|
||||
`GameJoltInstaller` asks `builds/get-download-url/<id>` for a signed link on every attempt, resumes with
|
||||
`Range`, unpacks through `StoreArchiveUnpacker` (shared with itch) and picks the launch option or an exe.
|
||||
An update downloads again and merges through `ItchStaging`, like itch.
|
||||
|
||||
## Updates
|
||||
|
||||
`GameJoltUpdates` works like `ItchUpdates` (see `itch-updates.md`). The install record keeps the release
|
||||
`published_on` as `installVersion` and `gameId`, `buildId` and `packageId` in `extra`. `evaluate` compares them
|
||||
with the current builds: a newer release of the same package is an update; if the package is gone, the first
|
||||
installable Windows build is offered as a replaced build. The automatic check runs when the Game Jolt Library
|
||||
source opens, at most every six hours, one game per second. A Check for updates button on an installed game's page
|
||||
checks that game only. Updates stage through `ItchStaging` and the safe folder. Uninstalling or finishing an
|
||||
install clears the record. Install folders use `Store.folder`, so the Itch.io display name never moves them.
|
||||
|
||||
## Controller
|
||||
|
||||
The menus, chips and buttons are the shared components (`MenuItem`, `AnchoredMenu`, `ValueChip`, `BrowseChip`,
|
||||
`IconAction`) that already take focus and confirm from a controller. The first menu entry takes initial focus.
|
||||
@@ -7,7 +7,9 @@ importer as Added Games. Existing Steam manifests are preserved.
|
||||
`droiddeck-steam-games watch` runs beside the client. It identifies a game by an
|
||||
existing manifest's install directory, a `steam_appid.txt` beside the game or selected
|
||||
executable, or a unique normalized title from Steam's store search with an explicit
|
||||
country. Matching also accepts the terminal Windows Edition and INTERGRADE suffixes;
|
||||
country. A `steam_appid.txt` naming 480 (Spacewar, the Steamworks SDK sample that Steam
|
||||
emulators and multiplayer fixes use in place of the game) identifies nothing; the
|
||||
launcher's artwork matching ignores it too. Matching also accepts the terminal Windows Edition and INTERGRADE suffixes;
|
||||
multiple matches still remain unresolved. Artwork's fuzzy matching is deliberately not
|
||||
used for identity. Ambiguous or unresolved titles remain non-Steam games.
|
||||
|
||||
@@ -32,7 +34,8 @@ internal Steam library and writes an installed manifest with `Universe=1` and
|
||||
`StateFlags=4`. Steam ignores manifests without the universe field. A manifest without
|
||||
installed depots makes Steam verify every file, so the importer carries the build another
|
||||
client recorded: WinNative's `.winnative-steam/steamapps` manifest beside the game folder,
|
||||
or a completed download's `.DepotDownloader/depot.config` depot manifest IDs. Steam then
|
||||
or a completed download's depot manifest IDs from `.DepotDownloader/depot.config` or, when
|
||||
that file is gone, the `<depot>_<gid>.manifest` names in `.DepotDownloader/completed`. Steam then
|
||||
only downloads what changed since that build. Bare manifests from earlier imports are
|
||||
upgraded while Steam has not touched them. Without either record Steam still verifies.
|
||||
WinNative's manifest also identifies the folder without a store lookup. Steam updates and uninstall
|
||||
@@ -42,6 +45,13 @@ the earlier importer are migrated, with the matching source symlink still presen
|
||||
registration fails, the game remains a shortcut. Once Steam takes over an install,
|
||||
manage it in Steam; forgetting an Added Games folder only removes its shortcuts.
|
||||
|
||||
An import is undone (its symlink and manifest, never the folder) when the folder was
|
||||
imported as Spacewar, or when a snapshot of the folder's current files names another app.
|
||||
The folder is then imported as that app if the account owns it, else it is a shortcut
|
||||
again. A failed title lookup undoes nothing. The launcher likewise drops artwork it
|
||||
fetched for the app the files named before and fetches it again; pictures the user chose
|
||||
are kept.
|
||||
|
||||
The account's `.droiddeck-routes.json` maps shortcut IDs to real Steam app IDs so the
|
||||
Android launcher uses the same title and Proton prefix as Steam. Other accounts do not
|
||||
inherit those routes. Managed shortcuts are replaced; user-created shortcuts and
|
||||
|
||||
@@ -233,6 +233,30 @@ picker. Its launcher sets five FuelPump variables frozen at install time: `FUEL_
|
||||
`AMAZON_GAMES_FUEL_DISPLAY_NAME` (the account name, `Player` without one). No Amazon Games SDK files
|
||||
are deployed into the prefix and `fuel.json` `PostInstall` steps are not run.
|
||||
|
||||
GOG's registry data reaches the prefix before Proton starts: a `goggame-<id>.script` install action
|
||||
with `setRegistry` becomes a `.reg` import through the game's own Proton (`reg.exe import /reg:32`),
|
||||
once per script revision - `.droiddeck-gog-registry` in the prefix holds the import's hash - and a
|
||||
failed import is retried on the next launch. GOG completes some installs by running a support
|
||||
installer from the game folder (the script's `Execute` action); under ARM64 FEX that 32-bit
|
||||
self-extractor stops at "Path not found", so the values it installs are applied from
|
||||
`GOG_INSTALL_REGISTRY` in `droiddeck-store-launch` instead: The Witcher: Enhanced Edition's
|
||||
`HKLM\Software\CD Projekt Red\The Witcher` block and its text/voice languages (#694), without which
|
||||
`witcher.exe` exits during startup. The language comes from the installed product's
|
||||
`goggame-<id>.info`, and a script's own `setRegistry` entries always win over the built-in table.
|
||||
|
||||
A GOG game's exe comes from its own manifest first: `goggame-<id>.info`'s play task in category
|
||||
`game` (`isPrimary` first), or a primary `launcher` task for launcher games, whose `path` stays
|
||||
inside the folder; any other `goggame-*.info` in the folder supplies the task only when the
|
||||
product's own has none. The task's `workingDir` becomes the shortcut's Start In, and the install root
|
||||
when the task declares none - GOG's own default, and what a game in a subfolder such as
|
||||
`System/witcher.exe` needs to find its `Data` folder. Else the product's `temp_executable`, else a
|
||||
score over the folder's `.exe` files - a word of the game's title in the name first (Blood Omen's
|
||||
`kain.exe` over its `dxconfig.exe`), config and tool names (`config`, `settings`, `launcher`,
|
||||
`editor`, `crashreport`, …) last, shallower and bigger ahead on a tie. GOG's `galaxy_*.exe` support
|
||||
installer is never the game, whatever the manifest or the temp executable says: The Witcher ships it
|
||||
beside `launcher.exe` and its own `temp_executable` names it, and starting it runs the same 32-bit
|
||||
installer that fails under ARM64 with "Path not found" (issue #694).
|
||||
|
||||
A game's web links reach Android: `droiddeck-store-launch` sets the prefix's
|
||||
`HKCU\Software\Wine\WineBrowser` `Browsers` to `/usr/local/bin/droiddeck-open-url`, which is also
|
||||
`xdg-open` first on the game's PATH, and hands http(s) addresses to the app, which opens them in
|
||||
|
||||
@@ -23,7 +23,9 @@ should not dictate which actions it can perform.
|
||||
|
||||
The model separates three concerns:
|
||||
|
||||
- **Source role:** physical, primary screen or secondary screen.
|
||||
- **Source role:** physical controller, game overlay (primary) or auxiliary panel
|
||||
(secondary). Swapping the game and auxiliary panel between displays preserves
|
||||
the panel's role and bindings.
|
||||
- **Profile:** the actions assigned to controls in each role. Game and Desktop are
|
||||
the two editable built-in profiles. Auto selects by session mode; explicit
|
||||
selection supports a game running inside a desktop session.
|
||||
@@ -111,6 +113,13 @@ wholesale. Upstream subsequently merged #1202; the October 30 integration retain
|
||||
its global physical shortcuts, saved assignments and configuration UI alongside
|
||||
the profile bindings.
|
||||
|
||||
The November 4 integration reuses upstream's common bottom-screen bar, extracted
|
||||
trackpad/terminal panels and screen-swap presentation. Custom controls coexist
|
||||
with the dashboard and KDE desktop panels. Routed on-screen stick updates retain
|
||||
upstream's throttled visual redraws without deferring pad publication. Upstream
|
||||
hardware-key translation and mouse capture use the existing output ownership and
|
||||
release capture while the input-profile editor is open.
|
||||
|
||||
Explicit captured bindings in the active profile take precedence over a global
|
||||
physical shortcut for the same key. Otherwise the global shortcut precedes the
|
||||
default Back/QAM handling and logical controller routing. A consumed shortcut
|
||||
|
||||
@@ -216,6 +216,37 @@ This run compiles Android Java/Kotlin and resources. A new APK build, Thor test
|
||||
and latency measurement were not performed for this merge; the full release
|
||||
build remains an upstream CI check.
|
||||
|
||||
### Upstream PC input and bottom-screen integration (2026-11-04 UTC)
|
||||
|
||||
Merged upstream `f0052415` without rewriting the published branch. The merge
|
||||
retains the common bottom-screen bar, dashboard, KDE desktop panel, game-screen
|
||||
swap, hardware mouse/keyboard fixes and on-screen stick redraw optimization.
|
||||
Custom controls use the same bar and preserve their secondary-source bindings
|
||||
when the game and panel swap displays. Pointer handoff now lives in upstream's
|
||||
shared `SessionTrackpadView`, used in either display arrangement.
|
||||
|
||||
Physical/IME key translation reuses `GuestKeys`, including keyboard Escape scan
|
||||
codes and the Desktop right-Ctrl alias, while preserving shared key ownership.
|
||||
The input-profile editor releases upstream's hardware mouse capture. Routed
|
||||
on-screen stick movement uses the same redraw throttling as the native overlay;
|
||||
pad publication remains synchronous, and mapped cursor frame updates keep their
|
||||
existing cadence mechanism.
|
||||
|
||||
The pointer-handoff regression now exercises the extracted trackpad view. Menu
|
||||
tests cover the custom panel alongside upstream's panel choices. A new ownership
|
||||
regression checks that releasing a hardware right-Ctrl alias cannot release Ctrl
|
||||
still held by the active profile. Panel teardown tests now use `ComponentActivity`
|
||||
to supply the lifecycle required by upstream's Compose bar.
|
||||
|
||||
The complete `:app:testDebugUnitTest` run passes **3,281 tests across 464 suites,
|
||||
zero failures/errors/skips**, using Java 17, NDK `28.2.13676358` and
|
||||
`-PskipRust=true`. Upstream's pinned MaliBridge submodule is initialized and its
|
||||
required Android server build also succeeds. The PR diff passes
|
||||
`git diff --check origin/main`.
|
||||
|
||||
No new APK installation, Thor regression pass or latency measurement was performed
|
||||
for this merge. The earlier device measurements do not validate this exact tree.
|
||||
|
||||
## Manual AYN Thor results
|
||||
|
||||
The user performed the following checks in the installed candidate. The desktop
|
||||
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 1.1 MiB |
Binary file not shown.
|
After Width: | Height: | Size: 9.0 MiB |
@@ -0,0 +1,244 @@
|
||||
# openMali 工作区记录
|
||||
|
||||
> 本文件记录 2026-10-31 ~ 2026-11-01 在本机与小米平板上的 MaliBridge + DroidDeck 0.6.7 合并、构建、调试和性能测试结果。
|
||||
> 这是本地工程记录,不是上游发布文档。未特别说明的 APK 均为 testkey 签名。
|
||||
|
||||
## 1. 目标与结论
|
||||
|
||||
- 目标:把 MaliBridge v0.5.4.2 的 Mali GPU 支持合并进 DroidDeck 0.6.7 主线,构建可安装 APK,并在平板上进入桌面、跑通 Steam 和性能测试。
|
||||
- 已做到:
|
||||
- 0.6.7 + MaliBridge v0.5.4.2 的合并包可安装。
|
||||
- Ubuntu rc4 运行时 + 内置最新 proot + KWin Zink/Mali 桥接,成功进入 KDE 桌面。
|
||||
- Steam 客户端下载/更新 100% 完成,进入 Steam 大屏幕登录页(二维码/账号密码)。
|
||||
- 完成 CPU、GPU、IO、内存、温度基线测试。
|
||||
- 关键结论:Mali 桥接本身没有成为瓶颈;真正的问题集中在 **运行时 DNS、proot 与 KWin 渲染栈**。当前 rc4 + packaged proot + render-node 是已验证可用的组合。
|
||||
|
||||
## 2. 设备与环境
|
||||
|
||||
- 设备:Xiaomi M367FC,SoC xring_o3_asic,GPU Mali-G2-Ultra-NX MC16,Android 17,内核 6.18.21。
|
||||
- CPU:10 核;内存 15.7 GB;存储 229 GB;屏幕 3408x2272;120 Hz。
|
||||
- Mali 驱动:ARM proprietary,Vulkan 1.4.345;桥接暴露 1.4.341。
|
||||
- 新 App:com.droiddeck.launcher,DroidDeck 0.6.7,versionCode 25(0.6.7-dnsfix-v25),testkey。
|
||||
- 旧 App:com.droiddeck.launcher.mali,DroidDeck-MaliBridge v0.5.4.2,versionCode 5042;保留用于对比,桌面可用。
|
||||
|
||||
## 3. 关键路径
|
||||
|
||||
- 新工程:/home/g/openMali/DroidDeck
|
||||
- MaliBridge 子模块:/home/g/openMali/DroidDeck/external/MaliBridge,v0.5.4.2,提交 95a1e60
|
||||
- 合并基线:main 69ffc096,tag mali-0.6.7-v0.5.4.2
|
||||
- 旧版源码:/home/g/openMali/reference/mali0542-src
|
||||
- 旧版 APK:/home/g/openMali/reference/DroidDeck-MaliBridge-v0.5.4.2.apk
|
||||
- 最终 APK:/home/g/openMali/output/DroidDeck-0.6.7-Mali-rc4.apk
|
||||
- 基准/参考工具:/home/g/openMali/reference/vkbridge-bench,/home/g/openMali/reference/oldapk
|
||||
|
||||
## 4. 已验证的修改
|
||||
|
||||
### 4.1 运行时与 proot
|
||||
|
||||
- 运行时 catalog 从 Debian linuxfs.json(r9) 切到 Ubuntu:
|
||||
- app/src/main/java/com/droiddeck/launcher/runtime/LinuxRuntimeInstaller.java
|
||||
- CATALOG_URL = .../linuxfs-ubuntu.json
|
||||
- 实际安装:ubuntu-r1-rc4;运行时约 3 GB;桌面栈另下载约 898 MB。
|
||||
- APK 不再排除 proot,改为内置最新官方 pack:
|
||||
- pack-proot-172bb48b00150b42
|
||||
- 压缩包 SHA-256:172bb48b00150b4292ba171089abecdf7243c06edddd68bf42dddb8c5bb24e4e
|
||||
- app/src/main/jniLibs/arm64-v8a/libproot.so(246,512 B)
|
||||
- app/src/main/jniLibs/arm64-v8a/libproot-loader.so(18,136 B)
|
||||
- app/build.gradle 移除 libproot.so / libproot-loader.so 的 excludes
|
||||
- LinuxRuntime:
|
||||
- 优先使用 nativeLibraryDir 中的 packaged proot/loader。
|
||||
- 新增 PROOT_PACKAGED 来源;isInstalled 接受 packaged proot。
|
||||
- prootSource 显示 packaged;ProotFastPath 只允许 PROOT_PACK,因此当前 fast path 关闭。
|
||||
- 旧 r9 + 旧 session/helper/host 的 0.6.7 组合已尝试但放弃:
|
||||
- KWin 曾能打开 3408x2272 窗口,但新 host 不显示、会话不稳定。
|
||||
- 该路线不作为最终方案。
|
||||
|
||||
### 4.2 proot fast path 实验
|
||||
|
||||
- 临时允许 packaged proot 走 fast path,实测反而更慢:
|
||||
- fast path off(当前):sha256 256 MB 207 ms,gzip -1 405 ms,read 3.9 GB/s。
|
||||
- fast path on:sha256 259 ms,gzip 461 ms,read 3.8 GB/s。
|
||||
- 结论:该 pack 的 fast path 对 CPU/IO 是负优化,已恢复默认关闭;源码 ProotFastPath 也恢复为只允许 PROOT_PACK。
|
||||
|
||||
### 4.3 桌面 / KWin / Mali 桥接
|
||||
|
||||
- tools/linuxfs/desktop/droiddeck-desktop 的 KWin OpenGL 分支:
|
||||
- 设置 KWIN_COMPOSE=O2、MESA_LOADER_DRIVER_OVERRIDE=zink、GALLIUM_DRIVER=zink、LIBGL_KOPPER_DRI2=true。
|
||||
- KWIN_RENDER_NODES 自动选择 /dev/dri/renderD0、/dev/dri/renderD307 或任意 /dev/dri/renderD*。
|
||||
- 在平板上实际使用 /dev/dri/renderD307(由 /dev/mali0 绑定)。
|
||||
- /usr/share/droiddeck/kwin-compositor 为 opengl。
|
||||
- 效果:
|
||||
- DroidDeckWayland 日志出现 [window] opened KDE Wayland Compositor 1280x720。
|
||||
- host 统计出现 GPU frames,不再出现 kwin software fallback / black picture。
|
||||
- KDE 桌面、任务栏、应用菜单正常。
|
||||
- 分辨率:
|
||||
- displayResolution.lxqt 设为 720p(1280x720)。
|
||||
- 720p 与 900p 的 vkgears 都是约 119.8 FPS,说明 GPU 已到 120 Hz 上限;720p 只减少缩放/带宽。
|
||||
- Steam 大屏幕模式:
|
||||
- app 的“游玩 Steam”使用 gamescope/Big Picture。
|
||||
- DroidDeckWayland 日志:Steam 大屏幕模式 1280x720,86.4 fps,875 GPU frames。
|
||||
- 可用 Steam 登录页。
|
||||
|
||||
### 4.4 UI / 桥接文案
|
||||
|
||||
- GpuInfo 恢复 bridge-aware supportText(bridge),新增 gpuinfo_bridge / gpuinfo_bridge_off 字符串。
|
||||
- DeviceInfo / DeviceReport / DriverMenus 使用当前 Mali 桥接状态显示支持文案。
|
||||
- LinuxRuntime 恢复 bridgeStandIn 的 DRM render node 回退逻辑。
|
||||
- 注意:Setup 顶部仍可能显示“GPU 不受支持”的旧标签(GpuDriversState 的 unsupported 标志),但下方已显示“实验性 Vulkan 桥接已开启”,桥接实际工作正常。
|
||||
|
||||
## 5. DNS 与 Steam
|
||||
|
||||
### 5.1 根因
|
||||
|
||||
- guest /etc/resolv.conf 被写成:
|
||||
- 1.1.1.1
|
||||
- 8.8.8.8
|
||||
- 2001:4860:4860::8888
|
||||
- 当前网络下这些公共 DNS 解析超时:
|
||||
- curl: (28) Resolving timed out after 10001 milliseconds
|
||||
- 设备实际 WiFi DNS 是 192.168.1.1;guest 改用该 DNS 后:
|
||||
- getent 能解析 client-update.steamstatic.com。
|
||||
- curl -I https://client-update.steamstatic.com/steam_client_linuxarm64 返回 200。
|
||||
- 结论:Steam 下载失败是 DNS,不是 Steam/GPU/代理。
|
||||
|
||||
### 5.2 已修复:App 自动获取本地 DNS
|
||||
|
||||
- 修改 app/src/main/java/com/droiddeck/launcher/runtime/LinuxNetworkLinkComponent.kt:
|
||||
- 新增 localDnsServers(),用 ConnectivityManager.allNetworks 遍历 WiFi/Ethernet 网络(排除 VPN)。
|
||||
- 收集这些网络的 DNS,并把默认路由 gateway 作为本地 DNS 兜底。
|
||||
- 私有地址(192.168/10.x)和 IPv4 优先。
|
||||
- writeResolver 的顺序:当前 active network DNS + localDnsServers() + 公共 DNS 兜底。
|
||||
- 验证(2026-11-01,dnsfix APK):
|
||||
- logcat:LinuxNetworkLink: resolver: 192.168.1.1 8.8.8.8 1.1.1.1 2001:4860:4860::8888
|
||||
- guest /etc/resolv.conf 第一行是 nameserver 192.168.1.1。
|
||||
- getent hosts store.steampowered.com 正常;curl -I https://store.steampowered.com 返回 200。
|
||||
- 旧 guest DNS 守护 /root/.config/plasma-workspace/env/01-dns-guard.sh 已删除;没有守护进程仍正常。
|
||||
- 说明:localDnsServers() 只取 WiFi/Ethernet 的 DNS,网关排在各 DNS 之后;active network 是 VPN 时不追加本地 DNS,只用 VPN 自己的 DNS。
|
||||
|
||||
### 5.3 Steam 客户端修复
|
||||
|
||||
- Steam 主程序下载后权限为 666:
|
||||
- /root/.local/share/Steam/steamrtarm64/steam
|
||||
- 需 chmod +x;更新后变为 700 也可执行。
|
||||
- 需要数据目录软链接:
|
||||
- /root/.steam/steam -> /root/.local/share/Steam
|
||||
- /root/.steam/root -> /root/.local/share/Steam
|
||||
- stale pid:
|
||||
- /root/.steam/steam.pid 可能残留已死 PID,导致 “Steam is already running”;启动前删除。
|
||||
- 不要在 Konsole 里用桌面 UI 方式启动 steam:
|
||||
- 会走 Xwayland/CEF,遇到 XRRGetOutputInfo() is not available / 无窗口。
|
||||
- 应从 DroidDeck 的“游玩 Steam”启动 Big Picture/gamescope。
|
||||
- 已验证(2026-11-01):
|
||||
- Steam 客户端更新 575,927 KB 到 100%。
|
||||
- Big Picture 已登录,库中显示 Shadow of the Tomb Raider 等游戏。
|
||||
- 32 位 steamrtarm32/steam-runtime-launcher-service 缺失的日志仍会出现,但 Big Picture 可用;游戏启动尚未验证。
|
||||
|
||||
## 6. 性能测试
|
||||
|
||||
### 6.1 存储 IO
|
||||
|
||||
| 路径 | 写 | 读 |
|
||||
|---|---:|---:|
|
||||
| Android /data/local/tmp | 1.0 GB/s | 4.7 GB/s |
|
||||
| Android /sdcard | 0.94 GB/s | 4.3 GB/s |
|
||||
| Guest proot(fast path off) | 1.2 GB/s | 3.9 GB/s |
|
||||
|
||||
Guest 读取比 host 低约 17%,是 proot 路径开销;写入不慢。
|
||||
|
||||
### 6.2 CPU
|
||||
|
||||
| 项目 | Host | Guest |
|
||||
|---|---:|---:|
|
||||
| sha256 256 MB 单线程 | 267 ms | 207 ms |
|
||||
| sha256 4x256 MB 4 线程 | 256 ms(约 4 GB/s 聚合) | 216 ms(约 4.7 GB/s 聚合) |
|
||||
| gzip -1 256 MB | 307 ms | 405 ms(+32%) |
|
||||
|
||||
注意:host/guest 的 sha256 实现不同,不能直接比较;gzip 更接近,proot 下约慢 30%。
|
||||
|
||||
### 6.3 GPU
|
||||
|
||||
- vkgears:119.86 FPS(600 帧/5 秒),720p 与 900p 基本一致,已到 120 Hz 上限。
|
||||
- 早期桥接基准:128 MiB copy 20.5 GB/s;空 submit 约 70 µs;4 KiB copy+submit 约 285 µs。
|
||||
- Steam Big Picture:1280x720,约 86.4 fps,875 GPU frames。
|
||||
- vkcube 在纹理路径触发断言(demo_prepare_texture_image),属于桥接兼容性问题,不是性能问题。
|
||||
|
||||
### 6.4 温度 / 内存
|
||||
|
||||
- CPU 29–33 °C,GPU 31–46.5 °C,Thermal Status 0,无节流。
|
||||
- 电池约 28 °C,64%。
|
||||
- 内存:15.7 GB 总,约 8.3 GB 已用,7.1 GB 可用,swap 约 2.6 GB。
|
||||
- 没有内存告急,但 swap 偏高;游戏前可重启/关闭后台。
|
||||
|
||||
### 6.5 v25 复测(2026-11-01 18:32)
|
||||
|
||||
环境:DroidDeck v25;GPU/IO 在 lxqt 桌面 1920x1080@120 测,CPU 分别测桌面和 Steam 会话;游戏 FPS 取自 Terraria 世界内 HUD。Thermal Status 0,CPU 32.8 °C,GPU max 34.8–46.5 °C,电池 31.8 °C / 92%。
|
||||
|
||||
| 项目 | v25 实测 | 说明 |
|
||||
|---|---:|---|
|
||||
| sha256 256 MB 单线程 | 桌面 283–322 ms;Steam 219–241 ms | Steam 会话约 230 ms,接近此前 207 ms |
|
||||
| gzip -1 256 MB | 桌面 514–534 ms;Steam 355–357 ms | Steam 会话约 356 ms;此前约 405 ms |
|
||||
| sha256 4×256 MB | Steam 222–269 ms;桌面 262–275 ms | 4 线程 |
|
||||
| Host /data/local/tmp O_DIRECT | 写 1060 / 读 1450 MB/s | 绕过 page cache |
|
||||
| Guest /root ext4 | 写 876 / 读 2337 MB/s | fdatasync;O_DIRECT 写 1270 MB/s |
|
||||
| Guest /root/Storage | 写 920 / 读 3029 MB/s | 读受 page cache 影响 |
|
||||
| vkgears 1280x720 | 115.8 FPS,p50 111.1,p99 25 ms | 4 秒采样 |
|
||||
| vkgears 1920x1080 | 113.2 FPS,p99 31 ms | 2 秒采样 |
|
||||
| Terraria 1280x720@120 | 59.9 FPS,AVG 49.3,1% 22.7 | HUD;CPU 36% / 2668 MHz / 33 °C,GPU 1% |
|
||||
| 内存 | 总 15.7 GB,可用 8.7 GB | Guest 已用 6.7 GB,swap 2.2 GB |
|
||||
|
||||
结论:GPU 与之前 119.86 FPS 基本一致(低约 3–4%),Terraria 稳定 60 FPS;IO 正常;测试期间无热节流。CPU 在 Steam 会话约 230 ms / 356 ms,接近或优于此前 207 ms / 405 ms;桌面会话因升频状态较低,v25 无 CPU 回归。
|
||||
|
||||
## 7. 构建与安装
|
||||
|
||||
- 构建:
|
||||
- cd /home/g/openMali/DroidDeck
|
||||
- ./gradlew :app:assembleRelease -PndkVersion=27.3.13750724
|
||||
- 修改 runtime inputs 后先记录:
|
||||
- python3 tools/release/runtime_inputs.py record
|
||||
- APK(DNS 自动修复 + GPU 状态文案 + HUD/CPU 温度 + mscoree 兜底,当前安装):
|
||||
- /home/g/openMali/output/DroidDeck-0.6.7-Mali-rc4-dnsfix-v25.apk
|
||||
- 76 MB;versionCode 25;versionName 0.6.7-dnsfix-v25
|
||||
- SHA-256 9808a8ab17f2d9a39e0b3abc9a05c2ee1c07ec7f4ac7cfa77866b2229fb6eb82
|
||||
- 上一版保留:v24(SHA-256 56b0ab03c0120c2a7a6ad0e4ed8d30a748021d7fe9e99a13b60f62a41e13b5e0)、v23(SHA-256 b0fadc5c...)、v22(SHA-256 69cd4f5f...)、v21(SHA-256 508294a6...)、v20(SHA-256 afd1ce12...)、v19(SHA-256 f63f4eae...)、v18(SHA-256 cc469703...)、v16 DroidDeck-0.6.7-Mali-rc4-dnsfix.apk(SHA-256 6c5f8c1f...)和 DroidDeck-0.6.7-Mali-rc4.apk(无 App 内 DNS 修复,SHA-256 c58fcc58...)。
|
||||
- testkey 签名;官方 release 私钥不在本机。
|
||||
- MIUI 安装:
|
||||
- 对已安装的旧包,adb push + adb shell pm install -r 可更新。
|
||||
- 对全新安装,MIUI 会报 INSTALL_FAILED_USER_RESTRICTED;需用文件管理器打开 APK,走 PackageInstaller,并在“是否允许 Shell 安装应用”点允许。
|
||||
- 官方 0.6.9 是 release key,testkey 包不能就地升级/降级;必须完整卸载,App 数据会被清空。
|
||||
|
||||
## 8. 当前安装状态
|
||||
|
||||
- com.droiddeck.launcher:0.6.7-dnsfix-v25(versionCode 25,testkey),2026-11-01 18:25 就地更新安装,App 数据保留。
|
||||
- GPU 状态:Setup 概览显示“GPU 通过 Mali 桥接”,绿色通过;不再显示“GPU 不受支持”。实现为 FrontEndSetup 的 gpuOk 包含 s.vkBridge,并新增 setup_gpu_bridged 文案。
|
||||
- 修复“清数据重启后 GPU 菜单消失”:showChecks 默认值从 false 改为 s.vkBridge;桥接开启时详情默认展开,GPU 行直接可见。已在 pm clear 后重新启动验证。
|
||||
- HUD:XRing/Mali 的 GPU load/clock/temp/thermal sysfs 对普通 App 拒绝访问,日志为 thermal zones 0、gpu load none、kgsl gpubusy refused。v21 在无数据时隐藏 GPU 统计行、VRAM=0 时隐藏 VRAM,只保留 GPU 型号;真正 GPU% / 温度 / 共享显存需要 root 或厂商遥测。
|
||||
- HUD 分辨率/卡死:v22 的 RES 不再用 Android displayMetrics 兜底,改用会话逻辑分辨率;桌面模式隐藏游戏 HUD,Steam/游戏模式显示。实测 Steam 下 HUD 为 RES 1280x720 @ 120Hz、FPS 42.8 / AVG 53.0。
|
||||
- CPU 温度/频率:v23 增加 USB/adb 辅助的 CPU 温度输入(/sdcard/DroidDeck/cpu-temp,由开发者在主机侧每 2 秒写入 cpu_therm,仓库不附带该脚本);v24 把 HUD 的 CPU 行顺序改为“占用 → 频率 → 温度”,Full/Mega/Tiles 三种布局都生效。
|
||||
- 安装方式:官方 0.6.9(release key)与 testkey 不兼容,完整卸载 0.6.9 后通过 PackageInstaller 安装;App 数据已被清空,当前是全新状态(首次启动显示配置页)。
|
||||
- DNS 自动修复已在 APK 内;运行时 ubuntu-r1-rc4、Mali 桥接、proot、桌面需要重新下载/配置;此前 Steam Big Picture 和 1280x720 KWin 已验证,但当前新数据需重新登录。
|
||||
- com.droiddeck.launcher.mali:旧 0.5.4.2 仍安装,桌面可用,用于对比。
|
||||
- 注意:Steam chmod/软链接/pid 清理仍是 guest 运行时修改;清除 App 数据或重装运行时会丢失。
|
||||
- Terraria 1.4.5.8 启动修复(2026-11-01):`dotnet40` 组件把 `WINEDLLOVERRIDES` 设为 `mscoree=n`,但该组件没有原生 `mscoree.dll`,Wine 报 `mscoree.dll not found` 后直接退出。v25 的 `droiddeck-wincomponents` 对 `mscoree=n` 自动追加 builtin 回退(`mscoree=n,b`);`dotnet40` 仍启用时,Terraria 已稳定进入世界并显示 HUD。
|
||||
|
||||
## 9. 已知问题 / 下一步
|
||||
|
||||
1. DNS 自动修复已完成(见 5.2);仍需在不同 WiFi/无 WiFi 环境下回归,确认 localDnsServers 的回退行为。
|
||||
2. Steam 桌面 UI 在 Xwayland 下仍可能无窗口;继续使用“游玩 Steam”/Big Picture,不要用 Konsole 直接 steam。
|
||||
3. Steam 32 位组件 steamrtarm32 / steam-runtime-launcher-service 缺失;Big Picture 可用。Terraria 1.4.5.8 已进入世界,其他游戏仍待验证。
|
||||
4. vkcube 纹理断言是桥接兼容性 bug,可单独排查。
|
||||
5. 真实游戏帧率/Proton/DXVK 尚未测试;当前性能数据主要是桌面、vkgears、IO/CPU。
|
||||
6. 仍是 testkey;如需官方升级安装,需要官方 release keystore。
|
||||
7. 官方 0.6.9 与 testkey 不兼容:只能完整卸载后安装,App 数据会丢;官方 APK 备份在 /tmp/installed-069.apk(宿主)和 /sdcard/Download/DroidDeck-0.6.9.apk(平板),回滚同样要先卸载。
|
||||
8. HUD 的 Mali GPU load/temp/VRAM 受驱动 sysfs 权限限制;除非 root/厂商接口,普通 App 无法获取。v21 已移除误导性的 GPU - 和 VRAM 0.0,保留 GPU 型号。
|
||||
|
||||
## 10. 已放弃 / 不再使用
|
||||
|
||||
- r9 + 旧 session/helper/host 组合:KWin 窗口不稳定/黑屏,放弃。
|
||||
- proot fast path:实测负优化,关闭。
|
||||
- 代理强制给 Steam:本地 DNS 直连更稳定;Steam 更新器对 proxy 环境并不可靠。
|
||||
|
||||
## 截图
|
||||
|
||||
Terraria 1.4.5.8 在 DroidDeck v25 + Mali 桥接 + Wine Mono 下进入世界。HUD 的 CPU 行是“占用 → 频率 → 温度”:
|
||||
|
||||

|
||||
+10
-1
@@ -41,9 +41,18 @@ Both the Android driver wrapper and the Linux session preload use
|
||||
`tools/quest/kgsl_compat.c`. Successful legacy allocation/free calls are
|
||||
unchanged. Only `EACCES`/`EPERM` failures retry through `GPUOBJ_ALLOC`,
|
||||
`GPUOBJ_INFO` and `GPUOBJ_FREE`. The Android wrapper depends on the original
|
||||
bundled Turnip binary. Unhandled controller ioctls forward to the next
|
||||
bundled Turnip binary. Quest's SELinux policy also denies `CMDSTREAM_READTIMESTAMP_CTXTID`, which Mesa 26's Turnip
|
||||
needs to wait on timeline semaphores; the adapter answers it from the last submitted timestamp
|
||||
and a zero-timeout `WAITTIMESTAMP`. Unhandled controller ioctls forward to the next
|
||||
preload hook rather than skipping it with a raw syscall.
|
||||
|
||||
The Ubuntu runtime's Turnip polls timeline points with
|
||||
`CMDSTREAM_READTIMESTAMP_CTXTID` and reports any failure as `VK_ERROR_UNKNOWN`,
|
||||
which aborted gamescope with `vk.WaitSemaphores` result -13 on Quest. The Linux
|
||||
preload (`tools/linuxfs/preload/kgslpoll.c`) answers a failed read from one
|
||||
millisecond `WAITTIMESTAMP` calls over the context's submitted timestamps, and
|
||||
logs refused KGSL ioctls to `session.log` as `[QuestKGSL] ioctl 0x.. refused`.
|
||||
|
||||
`tools/build_local.sh` and CI build the wrapper from source using the pinned
|
||||
Android NDK; the normal preload builds include the shared Linux adapter.
|
||||
Runtime input verification checks the resulting driver archive and invalidates
|
||||
|
||||
@@ -0,0 +1,86 @@
|
||||
# DroidDeck 0.6.9
|
||||
|
||||
<p align="center"><a href="https://discord.gg/JRGAvawjsm"><img src="https://img.shields.io/badge/Discord-Join%20the%20community-5865F2?logo=discord&logoColor=white" alt="Join the DroidDeck Discord"></a></p>
|
||||
|
||||
<!-- Maintainer check: Steam, Proton downloads and the games themselves come from Valve and the stores and are not part of DroidDeck; the intro below only claims DroidDeck's own code and the packs it builds. -->
|
||||
|
||||
**DroidDeck is 100% open source. No ads. No telemetry. No source withheld.**
|
||||
|
||||
Since 0.6.7, **5 people** sent **60 pull requests**. 30% of the pull requests came from the community. Thank you to everyone who sent code, translations, device testing and bug reports. This is a bug fix release: most of it fixes what you reported after 0.6.7.
|
||||
|
||||
Fittingly for 0.6.9, the top and bottom screens on the Pocket Duo and AYN Thor have finally stopped fighting for dominance and learned to work together.
|
||||
|
||||
**0.6.9 in 30 seconds**
|
||||
|
||||
- **Dual-screen handhelds** like the Retroid Pocket Duo and AYN Thor no longer show “DroidDeck isn’t responding”, no longer jump back over other apps, and keep the bottom-screen panel you picked
|
||||
- **Steam stops restarting at every start** to import added games, and asks first
|
||||
- **Steam’s UI runs at the full refresh rate again**, with the heat fix kept, and a session left in picture-in-picture drops to **30 fps** to save battery
|
||||
- **Cutscenes play again** with DroidDeck-Proton, and the **x86-64 Steam client** starts again on the Ubuntu runtime
|
||||
- **Windows components survive runtime updates**, and the **Linux runtime updates by itself**
|
||||
- **Xbox games run from their own folder** again, so Doom 64 and Unity games start
|
||||
- **Banking apps** open again: Android listed DroidDeck’s optional Home button accessibility service even while it was off, which some banking apps block. It never reads your screen
|
||||
- New: **controller button shortcuts**, **launch options for Steam games** in DroidDeck, a **frame limit for games started without Steam**, and a **DroidDeck HUD** you can pinch to resize and dock as an FPS tab
|
||||
|
||||
### Features
|
||||
|
||||
- Added **controller button shortcuts**: physical buttons can open Steam, Quick Access or DroidDeck’s menus, set per controller, with a reset. Buttons you leave unassigned work as before. Find them in Setup > Controller > Button mapping. (@jmarti326, [#1202](https://github.com/Droid-Deck/DroidDeck/pull/1202))
|
||||
|
||||
<img src="media/0.6.9/controller-shortcuts.jpg" width="50%" alt="Button mapping on a Retroid Pocket Duo with the new Physical button shortcuts group: Steam menu, Open Quick Access Menu and DroidDeck menu, each set to Default">
|
||||
- Added **launch options for Steam games** to a game’s Edit screen (the pencil on its page), so you can set options such as `-dx11` without opening Steam. They are the same launch options as in Steam’s Properties: a change in either one shows in both. (@K11MCH1, [#1888](https://github.com/Droid-Deck/DroidDeck/pull/1888))
|
||||
- Added a **Frame limit** for games started without Steam, on the Display page of the session drawer: Off, 30, 40, 45, 60, 90 or 120 fps. It applies live and lasts for the session. Steam games keep Steam’s own Frame Limit. (@xXJSONDeruloXx, [#1813](https://github.com/Droid-Deck/DroidDeck/pull/1813))
|
||||
- The HUD is now **DroidDeck HUD**. **Pinch with two fingers to resize it** from 50% to 200%, and **drag it past a screen edge to dock it as a small FPS tab**. (@xXJSONDeruloXx, [#1868](https://github.com/Droid-Deck/DroidDeck/pull/1868))
|
||||
- **x86_64 Flatpak apps run through FEX**. The r2modman bundle starts and loads its list of 334 games on a RedMagic Astra 2, and Flathub installs fall back to an app’s x86_64 build when it has no ARM one. A bundle built for an architecture DroidDeck cannot run is refused with a clear message before it downloads. (@maxjivi05, [#1875](https://github.com/Droid-Deck/DroidDeck/pull/1875), [#1873](https://github.com/Droid-Deck/DroidDeck/pull/1873))
|
||||
- The **Linux runtime updates by itself** when a new one is out, never during a game or desktop session. (@maxjivi05, [#1787](https://github.com/Droid-Deck/DroidDeck/pull/1787))
|
||||
- **itch.io updates download as patches** for games with butler builds, instead of the whole game again. (@FX192, [#1829](https://github.com/Droid-Deck/DroidDeck/pull/1829))
|
||||
- The desktop’s fastfetch shows the **DroidDeck mark** as its logo. (@xXJSONDeruloXx, [#1778](https://github.com/Droid-Deck/DroidDeck/pull/1778))
|
||||
|
||||
### Improvements
|
||||
|
||||
- **.NET games start faster**: they keep the FEX preset’s multiblock setting, so Stardew Valley starts in **45 s instead of 85 s** on the Retroid Pocket Duo. (@maxjivi05, [#1880](https://github.com/Droid-Deck/DroidDeck/pull/1880))
|
||||
- On low-memory devices, **Battle.net is compressed with the Steam client** while one of its games runs. Battle.net.exe alone used 345 MB on the Retroid Pocket Duo. (@maxjivi05, [#1882](https://github.com/Droid-Deck/DroidDeck/pull/1882))
|
||||
- Steam’s **Sleep after** timers start every session as Disabled, since Android decides when the device sleeps. New Steam installs start with **shader pre-caching off**. (@xXJSONDeruloXx, [#1848](https://github.com/Droid-Deck/DroidDeck/pull/1848), [#1861](https://github.com/Droid-Deck/DroidDeck/pull/1861))
|
||||
- The Library starts with **portrait covers** on new installs, and the Steam home drops its “Runtime installs on first Play” chip. Your saved layout is kept. (@xXJSONDeruloXx, [#1857](https://github.com/Droid-Deck/DroidDeck/pull/1857), [#1854](https://github.com/Droid-Deck/DroidDeck/pull/1854))
|
||||
- A **USB drive that is mounted but unreadable**, as on some Samsung phones, now explains itself and opens the All files access page, from the side rail too. (@maxjivi05, [#1872](https://github.com/Droid-Deck/DroidDeck/pull/1872))
|
||||
- **Translations:** every string added since the last pass is in all 32 languages. (@maxjivi05, [#1855](https://github.com/Droid-Deck/DroidDeck/pull/1855))
|
||||
- **Building and testing DroidDeck:** test and local builds show a faint PR, commit and title watermark, and the required-check tests match the CI gate. (@xXJSONDeruloXx, @maxjivi05, [#1863](https://github.com/Droid-Deck/DroidDeck/pull/1863), [#1864](https://github.com/Droid-Deck/DroidDeck/pull/1864), [#1866](https://github.com/Droid-Deck/DroidDeck/pull/1866), [#1874](https://github.com/Droid-Deck/DroidDeck/pull/1874))
|
||||
|
||||
### Fixed
|
||||
|
||||
- Fixed **“DroidDeck isn’t responding” on dual-screen handhelds** when input reached the bottom screen or the bottom screen took focus, which stopped controller navigation and RB/LB on the Stores tab. Seen on the AYN Thor and Retroid Pocket Duo. (@maxjivi05, [#1806](https://github.com/Droid-Deck/DroidDeck/pull/1806), [#1871](https://github.com/Droid-Deck/DroidDeck/pull/1871))
|
||||
- Fixed **dual-screen handhelds** taking over other apps: DroidDeck no longer jumps back over apps opened from outside it, such as iisu, an app sent to the Primary screen stays in front, the update install prompt survives a bottom-screen tap, and the home launcher stays out of Recents. (@maxjivi05, @xXJSONDeruloXx, [#1828](https://github.com/Droid-Deck/DroidDeck/pull/1828), [#1797](https://github.com/Droid-Deck/DroidDeck/pull/1797), [#1893](https://github.com/Droid-Deck/DroidDeck/pull/1893))
|
||||
- Fixed the **bottom screen**: it keeps the panel you picked, such as Trackpad or Terminal, across games, keeps DroidDeck’s controls up while a game loads, keeps the manual second-screen option when Dual screen is Off, and the Stop button no longer wraps letter by letter on the AYN Thor. (@maxjivi05, @xXJSONDeruloXx, [#1803](https://github.com/Droid-Deck/DroidDeck/pull/1803), [#1840](https://github.com/Droid-Deck/DroidDeck/pull/1840), [#1777](https://github.com/Droid-Deck/DroidDeck/pull/1777), [#1805](https://github.com/Droid-Deck/DroidDeck/pull/1805))
|
||||
- Fixed the **AYN Odin 2, Odin 2 Mini and Odin 2 Portal** losing their side rail and Back menu: Automatic dual screen now needs a real second touchscreen. On Meta Quest the launcher opens as a landscape window. (@maxjivi05, [#1801](https://github.com/Droid-Deck/DroidDeck/pull/1801), [#1893](https://github.com/Droid-Deck/DroidDeck/pull/1893))
|
||||
- Fixed **games launched from a frontend** such as Cocoon or iisu sitting on the home screen instead of starting. (@maxjivi05, @xXJSONDeruloXx, [#1789](https://github.com/Droid-Deck/DroidDeck/pull/1789), [#1844](https://github.com/Droid-Deck/DroidDeck/pull/1844))
|
||||
- Fixed **Steam restarting within seconds of every start** to import added games, which cut off game shortcuts. DroidDeck now asks with Restart now or Later. (@maxjivi05, [#1795](https://github.com/Droid-Deck/DroidDeck/pull/1795))
|
||||
- Fixed **Steam’s UI lag and heat** since 0.6.7 while keeping it at the panel’s full refresh rate, and a session left in **picture-in-picture** now draws at 30 fps, which saved about 1 W on a RedMagic Astra 2. (@maxjivi05, [#1809](https://github.com/Droid-Deck/DroidDeck/pull/1809), [#1841](https://github.com/Droid-Deck/DroidDeck/pull/1841), [#1842](https://github.com/Droid-Deck/DroidDeck/pull/1842))
|
||||
- Fixed the **performance HUD** turning itself on: it is off by default again, and your own choice is kept. (@maxjivi05, [#1807](https://github.com/Droid-Deck/DroidDeck/pull/1807))
|
||||
- Fixed **cutscenes and in-game videos** with DroidDeck-Proton: Resident Evil Revelations no longer waits forever on a loading screen and Kingdom Hearts HD 1.5+2.5 no longer crashes at cutscenes. (@maxjivi05, [#1823](https://github.com/Droid-Deck/DroidDeck/pull/1823))
|
||||
- Fixed the **Ubuntu runtime** without the desktop installed: the x86-64 Steam client starts again and survives its first self-update, ARMSX2, melonDS and Cemu start, and Steam’s Browse buttons, smart-card and speech support and GPU info in Steam work. (@maxjivi05, [#1825](https://github.com/Droid-Deck/DroidDeck/pull/1825), [#1793](https://github.com/Droid-Deck/DroidDeck/pull/1793), [#1802](https://github.com/Droid-Deck/DroidDeck/pull/1802))
|
||||
- Fixed **Windows components** (DirectX, Visual C++, XAudio, PhysX and more) disappearing after a runtime update. Lost ones are downloaded again, missing parts of bundles are reinstalled, and a launch waits for the restore. (@maxjivi05, [#1786](https://github.com/Droid-Deck/DroidDeck/pull/1786), [#1788](https://github.com/Droid-Deck/DroidDeck/pull/1788))
|
||||
- Fixed **Xbox games** running from the drive root: Doom 64, Unity games and AI: The Somnium Files start again. (@maxjivi05, [#1804](https://github.com/Droid-Deck/DroidDeck/pull/1804))
|
||||
- Fixed **Battle.net**: games install to Android storage, microSD cards and USB SSDs without the “logging on as an administrator” error, and its windows scale to screens above 1080p instead of opening tiny. (@maxjivi05, [#1791](https://github.com/Droid-Deck/DroidDeck/pull/1791), [#1832](https://github.com/Droid-Deck/DroidDeck/pull/1832))
|
||||
- Fixed **Mortal Kombat 11** and other games with a launch-option picker being closed while the picker was open. (@maxjivi05, [#1869](https://github.com/Droid-Deck/DroidDeck/pull/1869))
|
||||
- Fixed a **three-finger tap pasting clipboard text** in touchpad mode, the default for desktop sessions and Steam’s desktop UI. It now opens the keyboard there too, as in every other touch mode. (@xXJSONDeruloXx, [#1903](https://github.com/Droid-Deck/DroidDeck/pull/1903))
|
||||
- Fixed **DirectAudio crackling** on devices where Android refuses low-latency output, such as the AYN Thor. (@maxjivi05, [#1862](https://github.com/Droid-Deck/DroidDeck/pull/1862))
|
||||
- Fixed **banking apps** such as UBS refusing to open while DroidDeck 0.6.7 was installed. Nothing was wrong with your device or your accounts. 0.6.7 added an optional **accessibility service for Home button shortcuts** (Setup > Steam integration > Home button shortcuts), which lets you hold Home for Steam Guide chords. It only listens for button presses, and it cannot see your screen or read anything in other apps. Even when you never turned it on, Android listed it as installed, and some banking apps block any app outside the Play Store that has an accessibility service able to read button presses, to be safe. DroidDeck now only lists the service while you have it turned on in Android’s Accessibility settings, so banking apps open normally. If you use Home button shortcuts, the service stays on and those banking apps will still see it, because that is how accessibility services work. (@maxjivi05, [#1824](https://github.com/Droid-Deck/DroidDeck/pull/1824))
|
||||
- Fixed **added games showing up as Spacewar**: a game whose `steam_appid.txt` says 480, as Steam emulators and multiplayer fixes write it, such as PEAK, is no longer imported into Steam as Spacewar. An earlier import is undone, your game folder is left untouched, and a game whose Steam app ID changes follows it, with its art fetched again. (@K11MCH1, [#1896](https://github.com/Droid-Deck/DroidDeck/pull/1896))
|
||||
- Fixed **folders of games on game storage**, such as Rance 01, showing as one combined game, and adding a game changing another game’s exe. (@maxjivi05, [#1810](https://github.com/Droid-Deck/DroidDeck/pull/1810), [#1822](https://github.com/Droid-Deck/DroidDeck/pull/1822))
|
||||
- Fixed **Linux games on an NTFS USB drive** closing after about 14 seconds on their first start. (@maxjivi05, [#1850](https://github.com/Droid-Deck/DroidDeck/pull/1850))
|
||||
- Fixed **itch.io games** whose download is an archive inside an archive, such as Voices of the Void. (@maxjivi05, [#1800](https://github.com/Droid-Deck/DroidDeck/pull/1800))
|
||||
- Fixed the **Steam and desktop clock** staying on GMT instead of the Android time zone, and **Teardown** dropping to 30 fps under a Steam frame limit. (@maxjivi05, [#1790](https://github.com/Droid-Deck/DroidDeck/pull/1790))
|
||||
- Fixed Steam’s **Add a Non-Steam Game > Browse** button in the desktop session when another app holds port 8080 and Decky is on. (@maxjivi05, [#1798](https://github.com/Droid-Deck/DroidDeck/pull/1798))
|
||||
- Fixed **desktop video wallpapers** racing ahead after DroidDeck comes back from the background, and the Library’s Filter, Sort, Display and Collections menus being cut off in portrait. (@maxjivi05, [#1833](https://github.com/Droid-Deck/DroidDeck/pull/1833), [#1827](https://github.com/Droid-Deck/DroidDeck/pull/1827))
|
||||
|
||||
### Community
|
||||
|
||||
DroidDeck is built in the open by the people who use it. These are everyone whose code is in 0.6.9:
|
||||
|
||||
| Contributor | Pull requests |
|
||||
|---|---|
|
||||
| @maxjivi05 | 42: dual screens, Steam restarts and refresh rate, Ubuntu runtime, Windows components, Xbox, Battle.net, Flatpak through FEX and more |
|
||||
| @xXJSONDeruloXx | 14: DroidDeck HUD, frame limit without Steam, frontend launches, touchpad keyboard tap, Steam defaults, Library covers and more |
|
||||
| @K11MCH1 | 2: launch options for Steam games, Spacewar imports |
|
||||
| @jmarti326 | [#1202](https://github.com/Droid-Deck/DroidDeck/pull/1202): controller button shortcuts |
|
||||
| @FX192 | [#1829](https://github.com/Droid-Deck/DroidDeck/pull/1829): itch.io patch updates |
|
||||
|
||||
[Full changelog](https://github.com/Droid-Deck/DroidDeck/compare/0.6.7...0.6.9)
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 64 KiB |
@@ -50,6 +50,10 @@ DroidDeck saves separate **2D resolution**, **3D resolution**, and **VR resoluti
|
||||
|
||||
In **Automatic** picture mode, ordinary flat content is duplicated in full into both eyes on an SBS display. **Virtual screen** adds a configurable screen plane and tracking. **Side-by-side game** is for content that already contains separate eye images. SteamVR uses its direct stereo view and field-of-view control.
|
||||
|
||||
With **game on glasses** the compositor draws the guest pointer into its own scene as the last blended draw and mirrors it into both eyes for a side-by-side picture, while the phone stops drawing its Compose cursor. Over the app's own UI — the drawer, the PC keyboard, the achievements panel, PiP controls and the phone panel shown while the glasses have the picture — Android's pointer returns instead, so those controls are still clickable with a mouse.
|
||||
|
||||
The pointer is left out of the picture when it cannot be drawn where the game is: while a game holds the pointer lock (it draws its own), and for a game the compositor cannot import — an AHardwareBuffer-only surface, or HDR frames it has no texture for. Those games stay on their own display layer, because composing the scene would drop the game itself. An importable HDR game that would otherwise stay on its own layer is composed through the screen swapchain, so there the pointer does fit.
|
||||
|
||||
## Setup and app-wide behavior
|
||||
|
||||
1. Connect the glasses through a compatible video/data connection. Accept USB access when requested. For XREAL 1S, Android must also expose the glasses' USB-Ethernet network; the app leaves Steam's Internet connection on its normal network.
|
||||
|
||||
Vendored
+21
@@ -0,0 +1,21 @@
|
||||
MaliBridge
|
||||
Copyright (C) 2026 ASEbrahim and MaliBridge contributors
|
||||
https://github.com/ASEbrahim/MaliBridge
|
||||
|
||||
MaliBridge is free software: you can redistribute it and/or modify it under the terms of the GNU
|
||||
General Public License as published by the Free Software Foundation, either version 3 of the
|
||||
License, or (at your option) any later version. See LICENSE.
|
||||
|
||||
Additional terms under section 7 of the GNU GPL version 3:
|
||||
|
||||
1. Attribution (section 7(b)). Anyone who conveys MaliBridge, or a work based on it, in source or
|
||||
object form must keep the notice "MaliBridge by ASEbrahim" with a link to
|
||||
https://github.com/ASEbrahim/MaliBridge in the conveyed work's documentation, and, where the
|
||||
work has a user interface that shows credits, licences or an "about" screen, in that screen.
|
||||
|
||||
2. Names (section 7(e)). This licence grants no right to use the name "MaliBridge" or the
|
||||
author's name to name or promote a modified version. A modified version must be marked as
|
||||
changed and must not be presented as MaliBridge or as the author's work.
|
||||
|
||||
Third-party components keep their own licences and notices (third_party/ and the files that name
|
||||
them).
|
||||
+33
@@ -0,0 +1,33 @@
|
||||
# MaliBridge by ASEbrahim
|
||||
|
||||
MaliBridge by ASEbrahim: https://github.com/ASEbrahim/MaliBridge
|
||||
(GPL-3.0-or-later with the additional terms in NOTICE here, copied unchanged from the project).
|
||||
|
||||
DroidDeck builds MaliBridge from the `external/MaliBridge` submodule, pinned at 48477fe
|
||||
(v0.5.4) and not modified. Its Vulkan ICD runs inside the Linux runtime and forwards each call
|
||||
over a Unix socket to its server, which runs in the app on the phone's own Vulkan driver.
|
||||
DroidDeck uses it only on a GPU without Adreno's KGSL; an Adreno keeps Turnip.
|
||||
|
||||
The DroidDeck side of the bridge (the Setup switches, the server's start and session wiring, the
|
||||
Mali render node stand-in, the compositor's AHardwareBuffer import off Adreno, the Steam web helper
|
||||
layout, the socket wait and the DXVK choice for older Vulkan drivers) is Ahmad Sayed Alsayed
|
||||
Ebrahim's (ASEbrahim) work from https://github.com/ASEbrahim/DroidDeck, kept under their name in
|
||||
this repository's history.
|
||||
|
||||
MaliBridge's own credits, in its README, include:
|
||||
|
||||
- Vulkan-Headers 1.4.341 (Khronos Group), Apache-2.0 OR MIT: https://github.com/KhronosGroup/Vulkan-Headers
|
||||
- Arm's HWCPipe (MIT), whose counter layouts its GPU counter reader follows: https://github.com/ARM-software/HWCPipe
|
||||
- bcdec by Sergii Kudlai, MIT or Unlicense: https://github.com/iOrange/bcdec
|
||||
- etc2_encode by Lee Gao, MIT: https://github.com/leegao/etc2_encode
|
||||
- Lee Gao's Mali findings and SPIRV-Tools MaliOptimizationBarrierPass (Apache-2.0):
|
||||
https://github.com/leegao/SPIRV-Tools, and compat_layer (MIT): https://github.com/leegao/compat_layer
|
||||
- Julius Pinsker's bionic-vulkan-wrapper PR #228 (MIT)
|
||||
- David Cimo's droiddeck-mali (GPL-3.0): https://github.com/DavidCimo/droiddeck-mali
|
||||
- The412Banner's Mali compatibility layer and testing on the DroidDeck branch `test/non-adreno-all`
|
||||
- taowen's libhybris `arlinux` branch (Apache-2.0): https://github.com/taowen/libhybris/tree/arlinux
|
||||
- GameNative (GPL-3.0), wallentx's placed-memory layer for DroidDeck (MIT), Arm's published errata,
|
||||
ANGLE's Mali workarounds, and design notes from Winlator's Vortek
|
||||
|
||||
Each keeps its own licence and notice in the submodule (`third_party/` and the files that name
|
||||
them).
|
||||
Reference in new issue
Block a user