shellapk:基于 Android NDK 的动态加载 SO 插件壳项目

ShellAPK

Branch1Tags0
FilesLast commitLast 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

Introduction

ShellAPK

Customize your domain