Skip to content

sandin/android-vm-injector

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

48 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Android Injector

简介

本工具提供了Android应用运行时注入任意so文件的功能。

  • Non-Rooted 机器可注入 debuggable=true 的应用。
  • Rooted 机器可注入包括 release 在内的所有应用, 前提条件为:
    1. 需要有 su 命令。
    2. 需要将 ro.debuggable 修改为 1 (可使用工具如 MagiskHidePropsConf)

本应用不支持和Android studio同时使用,使用前请先关闭Android studio.

功能 Features

  1. 检测Android应用的架构
  2. Android应用运行时注入.so文件并拉起

安装 Install

with-jre

  1. 下载zip包
  2. 解压缩

without-jre

  1. 配置本地Java环境
  2. 下载without-jre.zip
  3. 解压缩

使用 Usage

.so注入

$ artinjector -i <injecto_so> -p <package_name>

可选参数:

  • [ --adbPath <adb_path>]

    • 指定adb路径

如果未指定adb路径则优先寻找系统中已存在的adb进程和环境变量中的adb路径 非root手机仅支持注入debuggable的Android应用

  • [ --breakOn <break_points>]

自定义断点,断点之间用逗号分割,如果自定义了断点将不会使用默认断点

--breakOn android.app.Activity.onCreate,android.os.Looper.myLooper

.apk注入

$ artinjector -i <apk_file> -p <package_name> --launch

NOTE: APK的注入不支持自定义的 breakOn 断点参数,它只支持在 Application.attachBaseContext() 断点, 并且只支持 --launch 模式。

该工具支持直接注入一个APK文件,包括其中的java代码和so代码,支持正常调用任意的Android API和JNI API,支持注入任何Hook框架,包括Hook Java代码或者Hook cpp代码。

APK可以是一个正常的APK文件,只需要其中包含一个固定的入口函数 com.github.sandin.artinjector.entry() ,该函数会在启动的时候注入到目标JVM中执行。

package com.github.sandin.artinjector;

import android.app.Application;
import android.util.Log;

public class EntryPoint {
  static {
    System.loadLibrary("native-lib");
  }

  public static native String stringFromJNI();

  public static int entry(Application application, ClassLoader dexClassLoader, ClassLoader originClassLoader) {
    Log.i("ArtInjector", "3 entry, application=" + application + " dexClassLoader=" + dexClassLoader + ", originClassLoader=" + originClassLoader);
    
    // just do what you want

      
  }

}

检测app架构(32/64 bit)

$ artinjector -p <package_name> -a

启动应用并置于等待调试器阶段

$ artinjector -p <package_name> --launch

可选参数:

  • [-ac <activity_name>] 根据输入的activity_name来启动应用,如果未指定activity_name则根据package_name启动应用

错误码 ErrorCodes

SOFILE_NOT_EXIST = 1 		 	//.so文件不存在
CANT_FIND_DEVICE = 2;	    		//无法找到设备
CANT_GET_CLIENT = 3;		    	//选择的应用不是debuggable或者未启动
CANT_PUSH_FILE = 4;	        	//无法将.so推入手机
CANT_ATTACH_APP = 5;		        //无法连接应用
BREAKPOINT_TIMEOUT = 6; 	        //断点超时
SOFILE_SHOULD_USE_32BIT = 7; 		//应用为32位,使用了64位的.so
SOFILE_SHOULD_USE_64BIT = 8;            //应用为64位,使用了32位的.so
LOAD_SO_FAIL = 9;                       //拉起so失败
CANT_GET_ADB = 10;                      //无法创建调试桥
BREAKPOINTS_HAVE_ERROR = 11;            //输入的断点格式错误

编译 Builder

执行 gradle shadowJar task, 输出目录: build/lib/artinjector-<version>-all.jar

常见问题 Tips

  • 如果一直在等待断点阶段(wait breakpoints),尝试切出应用再切回应用
  • 无法创建调试桥的可能原因:没有将本地的adb配置到环境变量,未手动指定本地的adb路径及未启动adb服务,解决方案:
    1. 将本地的adb添加到环境变量
    2. 使用--adbPath <adb_path>来指定adb路径
    3. 启动adb服务

类似工具

About

Android VM Injector

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages