Android(5) Xposed API中文手册（部分）

推荐肉丝r0ysue课程（包含安卓逆向与js逆向）：
Xposed英文原版离线api文档

android.app

AndroidAppHelper

包含一些关于当前app信息的一些方法

Public Methods

返回值类型	Public方法原型及作用
static Application	currentApplication ()：返回当前进程的主要Application类
static ApplicationInfo	currentApplicationInfo ()：返回当前进程中主应用程序的的信息
static String	currentPackageName ()：返回当前进程中主应用程序的Android包名称。
static String	currentProcessName ()：返回当前进程的名称。
static SharedPreferences	getDefaultSharedPreferencesForPackage ( String packageName) ：（此方法已弃用。）现在使用XSharedPreferences
static SharedPreferences	getSharedPreferencesForPackage ( String packageName, String prefFileName, int mode) ：（此方法已弃用。）现在使用 XSharedPreferences
static void	reloadSharedPreferencesIfNeeded ( SharedPreferences pref)：（此方法已弃用。）现在使用 XSharedPreferences.reload()

de.robv.android.xposed

XC_MethodHook

用于hook 方法的回调类

通常，子类被创建时会重写beforeHookedMethod(XC_MethodHook.MethodHookParam) 或者afterHookedMethod(XC_MethodHook.MethodHookParam)。

内部类

	类名	描述
class	XC_MethodHook.MethodHookParam	包装有关方法调用的信息（参数、返回值），并且允许对其进行修改。
class	XC_MethodHook.Unhook	用来解除方法/构造函数的钩子的对象，。

公共构造方法	描述
XC_MethodHook ()	创建具有默认优先级的新回调。
XC_MethodHook (int priority)	创建具有特定优先级的新回调。

返回值类型	Protected方法原型及作用
void	afterHookedMethodMethod(XC_MethodHook.MethodHookParam param)：在调用被hook的方法后调用。
void	beforeHookedMethod(XC_MethodHook.MethodHookParam param) ：在调用被hook的方法前调用。

XC_MethodHook.MethodHookParam

包装有关方法调用的信息（参数、返回值），并且允许对其进行修改。

成员域

成员域类型	成员域名字	描述
public Object[]	args	被hook方法的参数列表
public Member	method	这个被hook的方法/构造方法
public Object	thisObject	一个实例方法的this引用；静态方法则返回null

返回值类型	Public方法原型及作用
Object	getResult () ：返回被hook方法调用的结果。
Object	getResultOrThrowable () ：返回被hook方法调用的结果，或抛出由该方法引起的异常。
Throwable	getThrowable () ：返回由被hook方法抛出的Throwable 或者null
boolean	hasThrowable () ：如果被hook方法抛出了异常，则返回true
void	setResult ( Object result) ：修改被hook方法的结果
void	setThrowable ( Throwable throwable) ：修改被hook方法抛出的异常

XC_MethodHook.Unhook

返回值类型	Public方法原型及作用
XC_MethodHook	getCallback () ：返回已注册的回调方法。
Member	getHookedMethod () ：返回这个被hook的方法/构造方法
void	unhook () ：移除方法回调（hook）

XC_MethodReplacement

Public Constructors	描述
XC_MethodReplacement ()	创建具有默认优先级的新回调。
XC_MethodReplacement (int priority)	创建具有特定优先级的新回调。

返回值类型	Public方法原型及作用
static XC_MethodReplacement	returnConstant (Object result) ：创建一个回调方法，使得返回给被钩方法的调用者的值为定值result
static XC_MethodReplacement	returnConstant (int priority, Object result) ：像returnConstant(Object), 但是允许设置一个优先级

返回值类型	Protected 方法原型及作用
abstract Object	replaceHookedMethod ( XC_MethodHook.MethodHookParam param) ：快捷的完全替换这个hook方法

XposedBridge

Fields
public static final ClassLoader	BOOTCLASSLOADER	系统类装入器，可用于定位Android框架类。
public static int	XPOSED_BRIDGE_VERSION	这个字段在API level 65被废弃。 现在使用getXposedVersion()

返回值类型	Public方法原型及作用
static int	getXposedVersion () ：返回Xposed框架的当前安装版本。
static Set <XC_MethodHook.Unhook>	hookAllConstructors ( Class <?> hookClass, XC_MethodHook callback) ：钩住指定类hookClass的所有构造函数。
static Set <XC_MethodHook.Unhook>	hookAllMethods ( Class <?> hookClass, String methodName, XC_MethodHook callback) ：用指定类hookClass中声明的methodName钩住所有该方法。
static XC_MethodHook.Unhook	hookMethod ( Member hookMethod, XC_MethodHook callback)：用指定的回调钩住任何方法（或构造函数）。
static Object	invokeOriginalMethod ( Member method, Object thisObject, Object[] args) 基本上与反射中Method.invoke(Object，Object…)相同，但是是调用未被Xposed修改的原始的Method。
static void	log ( String text) ：在Xposed的error日志中写一条信息
static void	log ( Throwable t) ：在将堆栈跟踪记录到Xposed error日志。
static void	unhookMethod ( Member hookMethod, XC_MethodHook callback) ：这个方法在API level 81已经被弃用 ，现在使用 XC_MethodHook.Unhook.unhook() 。钩住方法时，将返回Unhook类的实例

XposedHelpers

返回值类型	Public方法原型及作用
static byte[]	assetAsByteArray ( Resources res, String path) ：从资源对象加载资源，并将内容作为“byte”数组返回。
static Object	callMethod ( Object obj, String methodName, Class<?> parameterTypes, Object… args) ：调用给定对象的实例或静态方法。
static Object	callMethod ( Object obj, String methodName, Object… args) ：调用给定对象的实例或静态方法。
static Object	callStaticMethod ( Class <?> clazz, String methodName, Class<?> parameterTypes, Object... args) ： 调用给定类的静态方法。
static Object	callStaticMethod ( Class <?> clazz, String methodName, Object… args) ： 调用给定类的静态方法。
static int	decrementMethodDepth ( String method) ：递减给定方法的深度计数器。
static XC_MethodHook.Unhook	findAndHookConstructor ( Class <?> clazz, Object… parameterTypesAndCallback) ：查找构造函数并将其挂钩。
static XC_MethodHook.Unhook	findAndHookConstructor ( String className, ClassLoader classLoader, Object… parameterTypesAndCallback) ： 查找构造函数并将其挂钩。
static XC_MethodHook.Unhook	findAndHookMethod ( Class <?> clazz, String methodName, Object… parameterTypesAndCallback) ： 查找一个方法并将其挂钩
static XC_MethodHook.Unhook	findAndHookMethod ( String className, ClassLoader classLoader, String methodName, Object… parameterTypesAndCallback) ： 查找一个方法并将其挂钩
static Class <?>	findClass ( String className, ClassLoader classLoader) ：使用指定的类装入器查找类。
static Class <?>	findClassIfExists ( String className, ClassLoader classLoader) ：查找一个类，如果存在就返回。
static Constructor <?>	findConstructorBestMatch ( Class <?> clazz, Class args) ：在类中查找构造函数并将其设置为可访问的。
static Constructor <?>	findConstructorBestMatch ( Class <?> clazz, Object… args) ：在类中查找构造函数并将其设置为可访问的。
static Constructor <?>	findConstructorBestMatch ( Class <?> clazz, Class... <?> parameterTypes) ：在类中查找构造函数并将其设置为可访问的。
static Constructor <?>	findConstructorExact ( String className, ClassLoader classLoader, Object… parameterTypes) ：查找类的构造函数并将其设置为可访问的。
static Constructor <?>	findConstructorExact ( Class <?> clazz, Class... <?> parameterTypes) ：查找类的构造函数并将其设置为可访问的。
static Constructor <?>	findConstructorExact ( Class <?> clazz, Object… parameterTypes) 查找类的构造函数并将其设置为可访问的。
static Constructor <?>	findConstructorExactIfExists ( Class <?> clazz, Object… parameterTypes) 查找构造函数，如果存在就将其返回。
static Constructor <?>	findConstructorExactIfExists ( String className, ClassLoader classLoader, Object… parameterTypes) 查找构造函数，如果存在就将其返回。
static Field	findField ( Class <?> clazz, String fieldName) 在类中查找一个字段并将其设置为可访问的。
static Field	findFieldIfExists ( Class <?> clazz, String fieldName) 查找字段，如果存在就将其返回。
static Field	findFirstFieldByExactType ( Class <?> clazz, Class <?> type) 返回类中给定类型的第一个字段。
static Method	findMethodBestMatch ( Class <?> clazz, String methodName, Class args) 在类中查找方法并将其设置为可访问的。
static Method	findMethodBestMatch ( Class <?> clazz, String methodName, Object… args) 在类中查找方法并将其设置为可访问的。
static Method	findMethodBestMatch ( Class <?> clazz, String methodName, Class... <?> parameterTypes) 在类中查找方法并将其设置为可访问的。
static Method	findMethodExact ( Class <?> clazz, String methodName, Class... <?> parameterTypes) 在类中查找方法并将其设置为可访问的。
static Method	findMethodExact ( Class <?> clazz, String methodName, Object… parameterTypes) 在类中查找方法并将其设置为可访问的。
static Method	findMethodExact ( String className, ClassLoader classLoader, String methodName, Object… parameterTypes) 在类中查找方法并将其设置为可访问的。
static Method	findMethodExactIfExists ( Class <?> clazz, String methodName, Object… parameterTypes) 查找并返回存在的方法。
static Method	findMethodExactIfExists ( String className, ClassLoader classLoader, String methodName, Object… parameterTypes) 查找并返回存在的方法。
static Method	findMethodsByExactParameters ( Class <?> clazz, Class <?> returnType, Class... <?> parameterTypes) 返回具有指定参数类型的类中声明/重写的所有方法的数组。
static Object	getAdditionalInstanceField ( Object obj, String key) 返回一个被setAdditionalInstanceField(Object, String, Object)存储的值.
static Object	getAdditionalStaticField ( Class <?> clazz, String key) Like setAdditionalInstanceField(Object, String, Object), but the value is returned for clazz.
static Object	getAdditionalStaticField ( Object obj, String key) Like getAdditionalInstanceField(Object, String), but the value is returned for the class of obj.
static boolean	getBooleanField ( Object obj, String fieldName) 返回给定对象实例中的fieldName字段的类型为Boolean的值。
static byte	getByteField ( Object obj, String fieldName) Returns the value of a byte field in the given object instance.
static char	getCharField ( Object obj, String fieldName) Returns the value of a char field in the given object instance.
static Class<?>	getClassesAsArray ( Class… <?> clazzes) Returns an array of the given classes.
static double	getDoubleField ( Object obj, String fieldName) Returns the value of a double field in the given object instance.
static float	getFloatField ( Object obj, String fieldName) Returns the value of a float field in the given object instance.
static int	getIntField ( Object obj, String fieldName) Returns the value of an int field in the given object instance.
static long	getLongField ( Object obj, String fieldName) Returns the value of a long field in the given object instance.
static String	getMD5Sum ( String file) Returns the lowercase hex string representation of a file’s MD5 hash sum.
static int	getMethodDepth ( String method) Returns the current depth counter for the given method.
static Object	getObjectField ( Object obj, String fieldName) 返回给定对象实例中的对象字段的值。
static Class<?>	getParameterTypes ( Object… args) Returns an array with the classes of the given objects.
static short	getShortField ( Object obj, String fieldName) Returns the value of a short field in the given object instance.
static boolean	getStaticBooleanField ( Class <?> clazz, String fieldName) Returns the value of a static boolean field in the given class.
static byte	getStaticByteField ( Class <?> clazz, String fieldName) Sets the value of a static byte field in the given class.
static char	getStaticCharField ( Class <?> clazz, String fieldName) Sets the value of a static char field in the given class.
static double	getStaticDoubleField ( Class <?> clazz, String fieldName) Sets the value of a static double field in the given class.
static float	getStaticFloatField ( Class <?> clazz, String fieldName) Sets the value of a static float field in the given class.
static int	getStaticIntField ( Class <?> clazz, String fieldName) Sets the value of a static int field in the given class.
static long	getStaticLongField ( Class <?> clazz, String fieldName) Sets the value of a static long field in the given class.
static Object	getStaticObjectField ( Class <?> clazz, String fieldName) Returns the value of a static object field in the given class.
static short	getStaticShortField ( Class <?> clazz, String fieldName) Sets the value of a static short field in the given class.
static Object	getSurroundingThis ( Object obj) For inner classes, returns the surrounding instance, i.e.
static int	incrementMethodDepth ( String method) Increments the depth counter for the given method.
static Object	newInstance ( Class <?> clazz, Object… args) Creates a new instance of the given class.
static Object	newInstance ( Class <?> clazz, Class<?> parameterTypes, Object... args) Creates a new instance of the given class.
static Object	removeAdditionalInstanceField ( Object obj, String key) Removes and returns a value which was stored with setAdditionalInstanceField(Object, String, Object).
static Object	removeAdditionalStaticField ( Class <?> clazz, String key) Like setAdditionalInstanceField(Object, String, Object), but the value is removed and returned for clazz.
static Object	removeAdditionalStaticField ( Object obj, String key) Like removeAdditionalInstanceField(Object, String), but the value is removed and returned for the class of obj.
static Object	setAdditionalInstanceField ( Object obj, String key, Object value) Attaches any value to an object instance.
static Object	setAdditionalStaticField ( Object obj, String key, Object value) Like setAdditionalInstanceField(Object, String, Object), but the value is stored for the class of obj.
static Object	setAdditionalStaticField ( Class <?> clazz, String key, Object value) Like setAdditionalInstanceField(Object, String, Object), but the value is stored for clazz.
static void	setBooleanField ( Object obj, String fieldName, boolean value) Sets the value of a boolean field in the given object instance.
static void	setByteField ( Object obj, String fieldName, byte value) 在被给予的类中，设置一个byte域
static void	setCharField ( Object obj, String fieldName, char value) Sets the value of a char field in the given object instance.
static void	setDoubleField ( Object obj, String fieldName, double value) Sets the value of a double field in the given object instance.
static void	setFloatField ( Object obj, String fieldName, float value) Sets the value of a float field in the given object instance.
static void	setIntField ( Object obj, String fieldName, int value) Sets the value of an int field in the given object instance.
static void	setLongField ( Object obj, String fieldName, long value) Sets the value of a long field in the given object instance.
static void	setObjectField ( Object obj, String fieldName, Object value) Sets the value of an object field in the given object instance.
static void	setShortField ( Object obj, String fieldName, short value) Sets the value of a short field in the given object instance.
static void	setStaticBooleanField ( Class <?> clazz, String fieldName, boolean value) Sets the value of a static boolean field in the given class.
static void	setStaticByteField ( Class <?> clazz, String fieldName, byte value) 在被给予的类中，设置一个静态byte域
static void	setStaticCharField ( Class <?> clazz, String fieldName, char value) Sets the value of a static char field in the given class.
static void	setStaticDoubleField ( Class <?> clazz, String fieldName, double value) Sets the value of a static double field in the given class.
static void	setStaticFloatField ( Class <?> clazz, String fieldName, float value) Sets the value of a static float field in the given class.
static void	setStaticIntField ( Class <?> clazz, String fieldName, int value) Sets the value of a static int field in the given class.
static void	setStaticLongField ( Class <?> clazz, String fieldName, long value) Sets the value of a static long field in the given class.
static void	setStaticObjectField ( Class <?> clazz, String fieldName, Object value) Sets the value of a static object field in the given class.
static void	setStaticShortField ( Class <?> clazz, String fieldName, short value) Sets the value of a static short field in the given class.