mirror of
https://github.com/Droid-Deck/DroidDeck.git
synced 2026-11-20 21:35:59 +00:00
Add enhanced one-session diagnostic bundles
This commit is contained in:
1 parent
b563b8d1eb
commit
5614bd5d5a
32 files changed
+3100
-141
No files matched your search
@@ -116,6 +116,48 @@ logging can reduce performance and consume storage; disable it after collecting
|
||||
the report. If the session log directory is unavailable, the launcher reports
|
||||
that diagnostics were skipped instead of writing uncollected files elsewhere.
|
||||
|
||||
## Enhanced diagnostics
|
||||
|
||||
Use **Setup > Diagnostics > Enhanced diagnostics for next session** when normal
|
||||
session logs are not enough. The setting is one-shot: DroidDeck creates and
|
||||
retains the next session's log directory, records the diagnostic profile, then
|
||||
turns the setting off. It also enables the existing game diagnostic environment
|
||||
for that session without changing the user's saved **Session logs** or **Game
|
||||
debug logs** preferences.
|
||||
|
||||
After reproducing the problem, use **Latest session logs > Share logs** or the
|
||||
in-session share action. Enhanced sessions offer separate, correlated archives:
|
||||
|
||||
| Archive | Main contents |
|
||||
| --- | --- |
|
||||
| Session and device | Startup timeline, device/component selection, app, audio, network, and exit summaries |
|
||||
| Graphics | Graphics-related logs plus bounded Gamescope frame and process summaries when their providers are available |
|
||||
| Games and compatibility | Proton, Wine, DXVK/VKD3D, FEX, store, and game lifecycle logs |
|
||||
|
||||
Choose one archive when an issue calls for a narrow report, or **All bundles**
|
||||
to share the three archives together. Every archive contains a
|
||||
`diagnostics-manifest.json` with the common session ID and the state of each
|
||||
artifact: captured, truncated, unavailable, omitted, or failed. Some captured
|
||||
logs may themselves explain that a permission-limited source was unavailable.
|
||||
|
||||
Exported archives sample a bounded amount of input. Large text logs retain
|
||||
complete lines from their beginning and end, and the manifest records partial
|
||||
scans and input limits. Raw game and component log writers are not yet safely byte-bounded while
|
||||
the session is running; they can use substantial storage, particularly during a
|
||||
long Proton game session. Enhanced diagnostics may also change timing because it
|
||||
keeps the game wrapper alive long enough to record an exit status. Turn it on
|
||||
only for a reproduction and review the archives before sharing them.
|
||||
|
||||
The bundle does not promise unrestricted Android, kernel, or vendor-driver
|
||||
logs. If accessible, Android's crash buffer can include reports from other apps;
|
||||
redaction is best effort. Screen captures, pixels, input contents, memory dumps,
|
||||
and full system traces are not included automatically.
|
||||
|
||||
The Gamescope frame summary is produced only by a Gamescope build that includes
|
||||
the enhanced frame-trace provider. An older bundled Gamescope safely ignores the
|
||||
diagnostic environment setting; the Graphics archive then records no frame-trace
|
||||
summary rather than inventing one.
|
||||
|
||||
A Unity game under FEX (`UnityPlayer.dll` for Windows builds under Proton,
|
||||
`UnityPlayer.so` or `GameAssembly.so` for native Linux builds started by
|
||||
**Linux x86 (FEX)**) keeps FEX's TSO on when the Default profile's FEX preset
|
||||
|
||||
Reference in new issue
Block a user