fix: suppress NuGet Linux native libs to bundle correct Android libbass.so

The ppy.osu.Framework.NativeLibs NuGet package ships Linux ARM64 native
libraries (libbass.so linking libc.so.6, libpthread.so.0). The .NET RID
fallback chain for android-arm64 resolves these Linux .so files into the
APK, overriding the correctly declared AndroidNativeLibrary items that
point to the Android-built versions (linking libOpenSLES.so, libandroid.so).

Fix: Add ExcludeAssets="native" PrivateAssets="all" to the NativeLibs
package reference in osu.Android.props to prevent NuGet from contributing
any native .so files. The correct Android libraries are supplied via
AndroidNativeLibrary from the framework submodule.

Also adds ABI verification to the release workflow to detect this class
of error (wrong platform .so in APK) in future builds.

Agent-Logs-Url: https://github.com/winnerspiros/osu/sessions/9d91747c-8581-4e17-b3d8-a44994850fd3

Co-authored-by: winnerspiros <1675249+winnerspiros@users.noreply.github.com>

Author: Copilot

.github/workflows/release.yml

@@ -218,6 +218,7 @@ jobs:
       - name: Verify native libraries in APK
         run: |
           APK="${{ steps.find_apk.outputs.apk_path }}"
+          SUBMOD="submodules/osu-framework/osu.Framework.Android/arm64-v8a"
           echo "Checking APK for required native libraries..."
 
           NATIVE_LIBS=$(unzip -l "$APK" | grep "lib/arm64-v8a/.*\.so" || true)
@@ -243,6 +244,24 @@ jobs:
           echo ""
           echo "All required native libraries present ✓"
 
+          # Verify the BASS libraries are the Android-built versions, not the Linux desktop
+          # ones from the NativeLibs NuGet package.  The Android libbass.so links against
+          # libOpenSLES.so (Android audio API); the Linux one links against libc.so.6.
+          echo ""
+          echo "Verifying native library ABI compatibility..."
+          TMPDIR=$(mktemp -d)
+          unzip -q -o "$APK" "lib/arm64-v8a/libbass.so" -d "$TMPDIR"
+          if readelf -d "$TMPDIR/lib/arm64-v8a/libbass.so" | grep -q "libOpenSLES.so"; then
+            echo "✅ libbass.so is the correct Android build (links libOpenSLES.so)"
+          else
+            echo "::error::libbass.so in APK is NOT the Android build — it appears to be the Linux desktop version from ppy.osu.Framework.NativeLibs NuGet. The app will crash with DllNotFoundException."
+            echo "::error::Ensure ppy.osu.Framework.NativeLibs has ExcludeAssets=native in osu.Android.props."
+            readelf -d "$TMPDIR/lib/arm64-v8a/libbass.so" | grep NEEDED || true
+            rm -rf "$TMPDIR"
+            exit 1
+          fi
+          rm -rf "$TMPDIR"
+
       - name: Upload APK artifact
         uses: actions/upload-artifact@v7
         with:

osu.Android.props

@@ -86,6 +86,18 @@
   <ItemGroup>
     <!-- Use winnerspiros/osu-framework fork (net10.0-android, optimized) via submodule instead of ppy NuGet package -->
     <ProjectReference Include="$(MSBuildThisFileDirectory)submodules/osu-framework/osu.Framework.Android/osu.Framework.Android.csproj" />
+
+    <!-- Suppress native assets from the desktop NativeLibs NuGet package.
+         ppy.osu.Framework.NativeLibs (transitive via osu.Framework.csproj) ships
+         runtimes/linux-arm64/native/libbass.so and friends built for GNU/Linux (they link
+         libc.so.6, libpthread.so.0, etc.).  The .NET RID fallback chain for android-arm64
+         (android-arm64 → android → unix → any) causes the Linux ARM64 .so files to leak
+         into the APK even though the NuGet has an android/native/_._  placeholder.
+         The result: the APK ends up with a Linux libbass.so that cannot load on Android
+         (DllNotFoundException at startup).
+         ExcludeAssets="native" prevents NuGet from contributing any .so files;
+         the correct Android-built libraries are supplied by AndroidNativeLibrary below. -->
+    <PackageReference Include="ppy.osu.Framework.NativeLibs" Version="2025.806.0-nativelibs" ExcludeAssets="native" PrivateAssets="all" />
   </ItemGroup>
 
   <!-- Include framework native libraries (BASS audio, FFmpeg, etc.) from the submodule.