Read Assembly Store
Documentsread-assembly-storeRead Assembly Store is an Agent Skill for documents published in the dotnet/android repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Read and inspect .NET assembly stores from Android APK, AAB, or raw store files. Use this when users want to inspect, examine, or list assemblies in an APK, AAB, assembly store, or manifest file.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/dotnet/android/blob/HEAD/.github/skills/read-assembly-store/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/read-assembly-store, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Read Assembly Store
Read and inspect .NET assembly stores from Android APK, AAB, or raw store files using the assembly-store-reader-mk2 tool in this repository.
What It Does
Lists all .NET managed assemblies embedded in an Android app, showing per-assembly metadata (PE image offset/size, debug data, config data, name hashes) grouped by target architecture.
Supports these input types:
- APK files (
.apk) - AAB files (
.aab) - Assembly store files (
libassembly-store.so,assemblies.blob) - Store manifest files (
base_assemblies.manifest) - Store base names (e.g.
baseorbase_assemblies)
How to Run
From the repository root, run the tool using dotnet-local to ensure the correct SDK is used.
On Windows:
.\dotnet-local.cmd run --project .\tools\assembly-store-reader-mk2\ -- [OPTIONS] <file>
On macOS/Linux:
./dotnet-local.sh run --project ./tools/assembly-store-reader-mk2/ -- [OPTIONS] <file>
Options
-a,--arch=ARCHITECTURES— Comma-separated list of architectures to limit output to (e.g.Arm64,x64,Arm,X86). Aliases likeaarch64,arm32,armv7a,armv8aalso work.-h,--help— Show help.
Instructions
- Determine the user's operating system from the environment context.
- Ask the user which file to inspect if not already specified.
- Run the appropriate command from the repository root, passing the file path and any options after
--. - Report the output to the user, summarizing the assemblies found per architecture.
Examples
Inspect an APK:
.\dotnet-local.cmd run --project .\tools\assembly-store-reader-mk2\ -- path\to\app.apk
Inspect an APK, arm64 only:
.\dotnet-local.cmd run --project .\tools\assembly-store-reader-mk2\ -- --arch=Arm64 path\to\app.apk
Inspect a raw store file:
.\dotnet-local.cmd run --project .\tools\assembly-store-reader-mk2\ -- path\to\libassembly-store.so