Xposed模块开发入门-最基本的项目创建

本人结合网络上的种种教程以及自己实践，记录下一个完整的基本Xposed模块项目的创建过程。

 

开发环境：

• Mac系统
• AndroidStudio 3.2.1
• gradle 3.2.1
• VirtualXposed（无需Root的使用Xposed模块）

 

Xposed、相关网站

• Xposed官方网站：https://api.xposed.info/reference/packages.html
• Xposed Github网址：https://github.com/rovo89/Xposed
• VirtualXposed官方网站：https://vxposed.com/
• VirtualXposed Github网址：https://github.com/android-hacker/VirtualXposed

 

参考链接：

• https://www.52pojie.cn/thread-688466-1-1.html
• https://www.jianshu.com/p/275a45b8095b

---

 

 

1、下载相关文件

官网下载链接：https://jcenter.bintray.com/de/robv/android/xposed/api/

由此链接进入，并下载以下两个文件

• api-82-sources.jar
• api-82.jar

 

---

 

 

2、创建基础项目和环境搭建

2.1、使用AndroidStudio构建一个基础项目，Android开发的基础操作，这里略过。

2.2、添加引用

在Module的build.gradle中添加以下两句引用，并注意要将 implementation fileTree(dir: 'libs', include: ['*.jar']) 修改为 compileOnly fileTree(dir: 'libs', include: ['*.jar']) 。

原因是Xposed里已有该JAR包内容，再次打包进去会冲突，就会导致handleLoadPackage没有回调。

dependencies {
    //以下两句引用
    //provided 有错就替换为 compileOnly
    compileOnly 'de.robv.android.xposed:api:82'
    //如果需要引入文档，方便查看的话
    compileOnly 'de.robv.android.xposed:api:82:sources'

    compileOnly fileTree(dir: 'libs', include: ['*.jar'])
    implementation 'com.android.support:appcompat-v7:28.0.0'
    implementation 'com.android.support.constraint:constraint-layout:1.1.3'
    testImplementation 'junit:junit:4.12'
    androidTestImplementation 'com.android.support.test:runner:1.0.2'
    androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.2'
}

单独列出来，gradle版本不同，就使用 provided或者 compileOnly，implementation、api、compileOnly区别详解可以参考链接 https://blog.csdn.net/yuzhiqiang_1993/article/details/78366985?locationNum=6&fps=1

compileOnly 'de.robv.android.xposed:api:82'
//如果需要引入文档，方便查看的话
compileOnly 'de.robv.android.xposed:api:82:sources'

2.3、声明Xposed模块

创建Xposed项目后，需要还在AndroidMenafest.xml文件里面声明Xposed模块，在application里面添加三个meta-data标签（xposedmodule，xposeddescription，xposedminversion）。

• xposedmodule：表示作为Xposed的一个模块
• xposeddescription：表示对本模块的描述，该描述会显示在安装好后的程序名称下方
• xposedminversion：表示的jar包的最低版本号

<meta-data
    android:name="xposedmodule"
    android:value="true"/>
<meta-data
    android:name="xposeddescription"
    android:value="我就是个简单的Xposed Demo"/>
<meta-data
    android:name="xposedminversion"
    android:value="53"/>

如图：

2.4、添加测试功能

在MainActivity视图中添加一个测试Button，点击后Toast提示

MainActivity中的逻辑代码如下：

//将被hook的类
public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        //点击测试事件
        findViewById(R.id.btn_test).setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                Toast.makeText(MainActivity.this, saySomething(), Toast.LENGTH_SHORT).show();
            }
        });


    }

    //将被hook的方法
    public String saySomething(){
        return "我是一个好人";
    }

}

完整功能就是，点击按钮，Toast提示“我是一个好人”，提示内容由 saySomething()提供。

2.5、创建挂钩类

接下来，就是编写xposed模块，hook这里的MainActivity，并修改 saySomething()方法的返回值为“我是一个坏人”。

新建一个类Test，实现 IXposedHookLoadPackage接口，重写 handleLoadPackage方法，先筛选到我们本程序的包名，然后用XposedHelpers里的 findAndHookMethod方法对MainActivity中的 saySomething方法进行劫持。

public class Test implements IXposedHookLoadPackage {


    @Override
    public void handleLoadPackage(XC_LoadPackage.LoadPackageParam lpparam) throws Throwable {
        //判断包名
        if (lpparam.packageName.equals("com.example.leaf.testvpdemo")) {

            Class clazz = lpparam.classLoader.loadClass("com.example.leaf.testvpdemo.MainActivity");
            //hook saySomething()方法
            XposedHelpers.findAndHookMethod(clazz, "saySomething", new XC_MethodHook() {
                protected void beforeHookedMethod(MethodHookParam param) throws Throwable {
                    super.beforeHookedMethod(param);
                }

                protected void afterHookedMethod(MethodHookParam param) {
                    param.setResult("我是一个坏人！");
                }
            });
        }
    }
}

2.5、声明类的入口

创建完我们钩类之后，我们需要将该类加载到XposedInstaller中，也就是我们必须声明该类的位置，需要在xposed_init中声明。 

先创建assets文件

然后在assets文件里，新建一个文件名为“xposed_init”（文件类型选text），注意没有后缀

 

然后在 xposed_init 内写入刚创建的入口类的完整类名，这里是 com.example.leaf.testvpdemo.Test 

到此为止，完整的基本项目就完成了。

---

 

 

3、运行测试Xposed模块

 如果直接运行，然后在 VirtualXposed中打开该应用，会发现报错，错误日志如下：

E/Xposed: java.lang.ClassNotFoundException: Didn't find class "com.example.leaf.testvpdemo.Test" on path: DexPathList

请确保禁用 Instant Run，否则hook的类不会直接包含在APK中，导致HOOK失败！

禁用后，重新运行项目，并在“添加应用”将应用添加到 VirtualXposed内，再在“模块管理”中，将模块开启，记得开启模块后要对 VirtualXposed进行重启。

 

最后的效果如下：