How termux/termuxam works
This repository reimplements Android’s am command for use from an app, addressing the Oreo-era restriction described in the README. The principal workflow is shell invocation, command/intent argument handling, then Activity Manager operations through a version-tolerant reflective interface. The code also includes compatibility support for Android’s hidden APIs and caller context. The README documents activity starts and broadcasts; the source index indicates additional service operations. Unsampled implementation details and wrapper-script internals are not inferred.
Main entry points: Am.java AM command · IActivityManager.java Activity operations · PermissionUtils.java Permission checks · ShellCommand.java Argument reader
Components 19
Command interface
- AM command
app/src/main/java/com/termux/termuxam/Am.java - Base command
app/src/main/java/com/termux/termuxam/BaseCommand.java - Argument reader
app/src/main/java/com/termux/termuxam/ShellCommand.java - Intent arguments
app/src/main/java/com/termux/termuxam/IntentCmd.java
Activity operations
- Activity operations
app/src/main/java/com/termux/termuxam/IActivityManager.java - Activity constants
app/src/main/java/com/termux/termuxam/ActivityManager.java - Broadcast receiver stub
app/src/main/java/android/content/IIntentReceiver.java
Android compatibility
- Method adaptation
app/src/main/java/com/termux/termuxam/CrossVersionReflectedMethod.java - Caller context
app/src/main/java/com/termux/termuxam/FakeContext.java - Platform workarounds
app/src/main/java/com/termux/termuxam/Workarounds.java - Permission checks
app/src/main/java/com/termux/termuxam/PermissionUtils.java - Service lookup stub
app/src/main/java/android/os/ServiceManager.java - App-ops interface stub
app/src/main/java/com/android/internal/app/IAppOpsService.java
Runtime support
- Reflection utilities
app/src/main/java/com/termux/termuxam/reflection/ReflectionUtils.java - Invocation results
app/src/main/java/com/termux/termuxam/reflection/result/InvokeResult.java - Method results
app/src/main/java/com/termux/termuxam/reflection/result/MethodInvokeResult.java - Logger
app/src/main/java/com/termux/termuxam/logger/Logger.java
Other components
- Shell user
- Android ActivityManager
Connections 19
- Shell user → AM command: invokes
README.md - AM command → Base command: uses
app/src/main/java/com/termux/termuxam/Am.java - Base command → Argument reader: uses
app/src/main/java/com/termux/termuxam/BaseCommand.java - AM command → Argument reader: reads arguments
app/src/main/java/com/termux/termuxam/Am.java - AM command → Intent arguments: parses intents
app/src/main/java/com/termux/termuxam/Am.java - Intent arguments → Argument reader: reads arguments
app/src/main/java/com/termux/termuxam/IntentCmd.java - AM command → Activity operations: dispatches operations
app/src/main/java/com/termux/termuxam/Am.java - Activity operations → Android ActivityManager: reflectively invokes
app/src/main/java/com/termux/termuxam/IActivityManager.java - Activity operations → Method adaptation: adapts methods
app/src/main/java/com/termux/termuxam/IActivityManager.java - Activity operations → Caller context: uses context
app/src/main/java/com/termux/termuxam/IActivityManager.java - Activity operations → Platform workarounds: applies workarounds
app/src/main/java/com/termux/termuxam/IActivityManager.java - Activity operations → Broadcast receiver stub: uses receiver
app/src/main/java/com/termux/termuxam/IActivityManager.java - AM command → Permission checks: checks permissions
app/src/main/java/com/termux/termuxam/Am.java - AM command → Activity constants: uses constants
app/src/main/java/com/termux/termuxam/Am.java - Permission checks → Service lookup stub: looks up service
app/src/main/java/com/termux/termuxam/PermissionUtils.java - Permission checks → App-ops interface stub: uses interface
app/src/main/java/com/termux/termuxam/PermissionUtils.java - Reflection utilities → Logger: logs failures
app/src/main/java/com/termux/termuxam/reflection/ReflectionUtils.java - Reflection utilities → Method results: returns result
app/src/main/java/com/termux/termuxam/reflection/ReflectionUtils.java - Method results → Invocation results: extends result
app/src/main/java/com/termux/termuxam/reflection/result/MethodInvokeResult.java