Lepton: Android titles installed on microSD fail to start: native libs not fully extracted (`libunity.so` not found), works from internal storage

未关闭
  • 哪里不对？
#2,934 2 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

还没有人认领这个 Issue。

评估

难度
4/5
预计耗时
3-5 天
新手友好度
8/100
Issue 类型
缺陷
描述清晰度
基本清楚
活跃度
活跃
技术栈
android
领域
infrastructure, mobile

调研方向

This is a tracker report with no code in this repository, and the fault appears to sit in how Lepton prepares app data on microSD. Start with the attached lepton-steamlaunch-1079800.log and logcat-crash.log, then compare the extracted lib/arm64 directory against the APK's lib/arm64-v8a contents. Done means identifying why libunity.so is missing from the extracted directory on the SD-card install, which needs Lepton or SteamOS maintainer input.

由索引模型根据 Issue 内容生成。

描述

Your system information
  • Steam client version: 1791328779 (steam_client_linux_arm64_beta)
  • SteamOS version: 0.4.5 (build 20261007.6125817, kernel 6.18.0-ge66bc2ca6f8c), Steam Frame
  • Opted into Steam client beta?: Not on the UI
  • Opted into SteamOS beta?: Not on the UI
  • Have you checked for updates in Settings > System?: Yes
Please describe your issue in as much detail as possible:

Expected: Pistol Whip (App ID 1079800, com.cloudheadgames.pistolwhip, APK versionCode 12) launches via Lepton when the game is installed on the microSD card, as it did before the recent SteamOS update.

Actual: The app shows no response and exits about 0.1 s after start. Every launch fails the same way. Moving the game to internal storage fixes it: Pistol Whip then launches normally via Lepton.

The crash is in UnityPlayer.loadNative:

F DEBUG : Abort message: 'JNI FatalError called: Unable to load library:
/data/app/~~Nu40_3Xcpfglc68Pr84GEA==/com.cloudheadgames.pistolwhip-QPLwc30x06O_4nXp9JrUPA==/lib/arm64/libunity.so
[dlopen failed: library "libunity.so" not found]'

Lepton then logs Clearing baked app data due to early exit.

Findings:

  • The APK is intact. Pistol Whip.apk (1,742,890,811 bytes) contains lib/arm64-v8a/libunity.so (25,175,672 bytes) and all other arm64 libs.
  • Extraction is partial. libmain.so loads from /data/app/.../lib/arm64/, but libunity.so is missing from that same directory.
  • Kernel warning on the SD-card game directory at launch:
    overlayfs: fs on '/run/media/steamos/SF/steamapps/common/Pistol Whip' does not support file handles, falling back to xino=off.
  • SD card: ext4 on mmcblk0p1, utf8 encoding (casefold).
  • Other compat tools: forcing a different Lepton version did not help. The Windows build via Proton/FEX runs.

Versions: Lepton v3.0.5 (rootfs v3.0.3), Android image LineageOS 18.1-20260925-UNOFFICIAL-lepton_arm64_only, XRService 2026-09-23 23:30:05 64f342ccba.

Suspected cause: a regression in how Lepton prepares or overlays app data when the game is on the microSD card. Native libraries do not fully end up in the app's lib/arm64 directory.

Logs attached: lepton-steamlaunch-1079800.log, lepton-logcats/steamlaunch-1079800/ (main/system/crash/kernel/radio). Failing launch: 2026-10-13 22:42 CEST.

Steps for reproducing this issue:
  1. Install Pistol Whip (App ID 1079800) to a microSD card (ext4) on Steam Frame.
  2. Launch it with the default compatibility tool (Lepton).
  3. The app does not respond and exits within a second. logcat-crash.log shows libunity.so not found. Moving the game to internal storage and launching again works.

It was working on SD card before I upgraded to SteamOS 0.4.5 therefore I suspect it is an OS

SteamFrame_logs.zip

主要语言
没有语言数据
星标
2.7k
派生
88
30 天内没有已合并 PR

环境准备

这个项目没有提供开发容器、Dockerfile 或贡献指南，环境需要你自己搭建：先看它的 README，通用步骤见我们的新手贡献指南。

从这里开始

  1. 先读完整个 Issue，再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库，在一个分支上完成修改。
  4. 提交 Pull Request，并在描述里引用这个 Issue 编号。

ValveSoftware/SteamOS 的其他 Issue

查看 ValveSoftware/SteamOS 的全部 Issue

相似的 Issue

更多 DevOps Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。