# lualvsil/naloader architecture

> Architecture diagram of the GitHub repository lualvsil/naloader, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/lualvsil/naloader
- Repository: https://github.com/lualvsil/naloader

## Overview

NALoader is an Android host app for selecting and running an external NativeActivity .so without rebuilding the APK. The main workflow passes a selected document URI from MainActivity to LoaderActivity, which copies the library into app storage and calls native code to load it and invoke its entry point. LoaderActivity also saves logcat output during lifecycle events. NaDocumentsProvider exposes app-private files through Android’s document-provider interface. The workflow and lifecycle behavior are documented in the README; source excerpts show the Java-to-native calls and provider operations.

Main entry points: [`app/src/main/java/com/lualvsil/naloader/LoaderActivity.java`](https://github.com/lualvsil/naloader/blob/main/app/src/main/java/com/lualvsil/naloader/LoaderActivity.java) (LoaderActivity), [`app/src/main/cpp/main.cpp`](https://github.com/lualvsil/naloader/blob/main/app/src/main/cpp/main.cpp) (Native loader), [`app/src/main/java/com/lualvsil/naloader/MainActivity.java`](https://github.com/lualvsil/naloader/blob/main/app/src/main/java/com/lualvsil/naloader/MainActivity.java) (MainActivity), [`app/src/main/java/com/lualvsil/naloader/NaDocumentsProvider.java`](https://github.com/lualvsil/naloader/blob/main/app/src/main/java/com/lualvsil/naloader/NaDocumentsProvider.java) (Documents provider)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_selection["Selection"]
  node_main["MainActivity<br/>[MainActivity.java]"]
end

subgraph group_runtime["Native runtime"]
  node_loader["LoaderActivity"]
  node_native["Native loader<br/>[main.cpp]"]
end

subgraph group_files["App files"]
  node_provider["Documents provider"]
  node_appfiles["App files"]
end

subgraph group_diagnostics["Diagnostics"]
  node_logcat["Logcat output"]
end

node_user(("User"))
node_picker["Document picker"]
node_library["Selected .so"]
node_android["Android runtime"]
node_logservice["Android logcat"]

node_user -->|"opens"| node_main
node_main -->|"opens picker"| node_picker
node_picker -->|"returns URI"| node_main
node_main -->|"launches with URI"| node_loader
node_loader -->|"reads selected URI"| node_picker
node_loader -->|"copies library"| node_appfiles
node_loader -->|"calls JNI"| node_native
node_native -->|"loads and invokes"| node_library
node_android -->|"delivers lifecycle"| node_loader
node_loader -->|"relays lifecycle"| node_library
node_provider -->|"reads and writes"| node_appfiles
node_loader -->|"requests log dump"| node_native
node_native -->|"captures logs"| node_logservice
node_native -->|"writes dump"| node_logcat
node_loader -->|"saves on pause"| node_logcat

click node_main "https://github.com/lualvsil/naloader/blob/main/app/src/main/java/com/lualvsil/naloader/MainActivity.java"
click node_loader "https://github.com/lualvsil/naloader/blob/main/app/src/main/java/com/lualvsil/naloader/LoaderActivity.java"
click node_native "https://github.com/lualvsil/naloader/blob/main/app/src/main/cpp/main.cpp"
click node_provider "https://github.com/lualvsil/naloader/blob/main/app/src/main/java/com/lualvsil/naloader/NaDocumentsProvider.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_main,node_user toneBlue
class node_loader,node_native toneAmber
class node_provider,node_appfiles toneMint
class node_logcat toneRose
class node_picker,node_library,node_android,node_logservice toneIndigo
```

## Components

### Selection

- [MainActivity](https://github.com/lualvsil/naloader/blob/main/app/src/main/java/com/lualvsil/naloader/MainActivity.java): `app/src/main/java/com/lualvsil/naloader/MainActivity.java`

### Native runtime

- [LoaderActivity](https://github.com/lualvsil/naloader/blob/main/app/src/main/java/com/lualvsil/naloader/LoaderActivity.java): `app/src/main/java/com/lualvsil/naloader/LoaderActivity.java`
- [Native loader](https://github.com/lualvsil/naloader/blob/main/app/src/main/cpp/main.cpp): `app/src/main/cpp/main.cpp`

### App files

- [Documents provider](https://github.com/lualvsil/naloader/blob/main/app/src/main/java/com/lualvsil/naloader/NaDocumentsProvider.java): `app/src/main/java/com/lualvsil/naloader/NaDocumentsProvider.java`
- **App files**

### Diagnostics

- **Logcat output**

### Other components

- **User**
- **Document picker**
- **Selected .so**
- **Android runtime**
- **Android logcat**

## Connections

- User → MainActivity: opens (evidence: `README.md`)
- MainActivity → Document picker: opens picker (evidence: `app/src/main/java/com/lualvsil/naloader/MainActivity.java`)
- Document picker → MainActivity: returns URI (evidence: `app/src/main/java/com/lualvsil/naloader/MainActivity.java`)
- MainActivity → LoaderActivity: launches with URI (evidence: `app/src/main/java/com/lualvsil/naloader/MainActivity.java`)
- LoaderActivity → Document picker: reads selected URI (evidence: `app/src/main/java/com/lualvsil/naloader/LoaderActivity.java`)
- LoaderActivity → App files: copies library (evidence: `app/src/main/java/com/lualvsil/naloader/LoaderActivity.java`)
- LoaderActivity → Native loader: calls JNI (evidence: `app/src/main/java/com/lualvsil/naloader/LoaderActivity.java`)
- Native loader → Selected .so: loads and invokes (evidence: `app/src/main/cpp/main.cpp`)
- Android runtime → LoaderActivity: delivers lifecycle (evidence: `README.md`)
- LoaderActivity → Selected .so: relays lifecycle (evidence: `README.md`)
- Documents provider → App files: reads and writes (evidence: `app/src/main/java/com/lualvsil/naloader/NaDocumentsProvider.java`)
- LoaderActivity → Native loader: requests log dump (evidence: `app/src/main/java/com/lualvsil/naloader/LoaderActivity.java`)
- Native loader → Android logcat: captures logs (evidence: `app/src/main/cpp/main.cpp`)
- Native loader → Logcat output: writes dump (evidence: `app/src/main/cpp/main.cpp`)
- LoaderActivity → Logcat output: saves on pause (evidence: `README.md`)
