ShellAPK
| Files | Last commit | Last update |
|---|---|---|
| 5 months ago | ||
| 5 months ago | ||
| 5 months ago | ||
| 5 months ago | ||
| 5 months ago | ||
| 5 months ago | ||
| 5 months ago | ||
| 5 months ago | ||
| 5 months ago |
ShellAPK — Android 壳 App
动态加载 SD 卡目录中 .so 文件并运行其 C 函数。插件无需适配 JNI 命名规范。
项目结构
shellapk/
├── app/
│ ├── build.gradle # 模块构建配置 (AGP + NDK)
│ ├── proguard-rules.pro # ProGuard 规则
│ └── src/main/
│ ├── AndroidManifest.xml # 权限 + 单 Activity
│ ├── java/com/shellapk/
│ │ ├── MainActivity.java # 占位 Activity (UI + 权限 + 插件调用)
│ │ ├── NativeBridge.java # JNI 桥接声明层
│ │ └── SoLoader.java # 插件扫描 & 加载管理器
│ ├── jni/
│ │ ├── CMakeLists.txt # NDK 构建配置
│ │ └── bridge.c # 原生桥接层 (dlopen/dlsym)
│ └── res/ # UI 资源
├── sample_plugin/
│ └── sample_plugin.c # 示例插件源码
├── build.gradle # 根构建配置
├── settings.gradle # Gradle 设置
├── gradle.properties # Gradle 属性
└── gradle/wrapper/ # Gradle Wrapper
核心架构
┌─────────────────────┐
│ MainActivity │ ← 占位 Activity,UI + 权限 + 调用入口
│ (占位Activity) │
└────────┬────────────┘
│
┌────────▼────────────┐
│ SoLoader │ ← 扫描 /sdcard/shellapk/plugins/*.so
│ (扫描+加载管理器) │ 对每个 SO: 用 dlopen 绕过 JNI 命名限制
└────────┬────────────┘
│
┌────────▼────────────┐
│ NativeBridge │ ← JNI 声明层 (Java → native)
│ (JNI桥接声明) │
└────────┬────────────┘
│
┌────────▼────────────┐
│ libbridge.so │ ← 内置原生库,通过 dlopen/dlsym
│ (原生桥接层) │ 加载 SD 卡中的插件 SO 并调用函数
└────────┬────────────┘
│
┌────────▼────────────┐
│ plugin SO files │ ← /sdcard/shellapk/plugins/*.so
│ (SD卡插件) │ 无需适配 JNI 命名规范!
└─────────────────────┘
为什么用 dlopen 而不是 System.load()
| 方式 | 限制 |
|---|---|
System.load() / System.loadLibrary() |
要求 SO 中 JNI 函数名与 Java 包名严格匹配,插件需为每个 Java native 方法实现对应导出函数 |
dlopen + dlsym |
无限制 — 插件导出自定义 C 函数如 plugin_init() / plugin_run() 即可,与 Java 包名解耦 |
SD 卡插件目录
/sdcard/shellapk/plugins/
App 启动时会扫描此目录下所有 *.so 文件并尝试加载。
插件约定函数(均为可选)
| 函数 | 签名 | 说明 |
|---|---|---|
plugin_init |
void() |
初始化 |
plugin_run |
const char*(const char*) |
运行入口 |
plugin_version |
const char*() |
版本号 |
SD 卡中的 SO 只需导出这些 C 函数即可被壳 App 发现和调用。
权限处理
| Android 版本 | 所需权限 | 方式 |
|---|---|---|
| 5.x (API 21) 及以下 | 默认有权限 | 直接读取 |
| 6-10 (API 23-29) | READ_EXTERNAL_STORAGE |
requestPermissions 弹窗 |
| 11+ (API 30+) | MANAGE_EXTERNAL_STORAGE |
跳转系统设置页面 |
构建
方法一:Android Studio
用 Android Studio 打开 shellapk/ 目录 → Sync Gradle → Run。
方法二:命令行
export ANDROID_HOME=/path/to/sdk
cd /path/to/shellapk
./gradlew assembleDebug
APK 产物:app/build/outputs/apk/debug/app-debug.apk
测试
1. 编译示例插件
需要 NDK r23+ 中的 standalone toolchain(或直接用 NDK 的 clang):
# arm64 设备
aarch64-linux-android21-clang -shared -fPIC \
-o libsample.so sample_plugin/sample_plugin.c \
-landroid -llog
# arm32 设备
armv7a-linux-androideabi21-clang -shared -fPIC \
-o libsample.so sample_plugin/sample_plugin.c \
-landroid -llog
2. 安装
adb push libsample.so /sdcard/shellapk/plugins/
adb install -r app/build/outputs/apk/debug/app-debug.apk
3. 运行
打开 App → 授权 → 点击 「刷新」 按钮即可在日志区域看到加载和执行结果。
示例插件的导出函数
void plugin_init(void); // 初始化
const char* plugin_run(const char*); // 运行入口
const char* plugin_version(void); // 版本号
int plugin_add(int); // 整数运算 (演示 callIntInt)
技术栈
- Java 8 / AndroidX (AppCompatActivity, MaterialButton)
- NDK + CMake 编译
libbridge.so - dlopen / dlsym / dlclose 动态加载 SD 卡 SO
- JNI 桥接 Java ↔ C