AsmActualCombat

AsmActualCombat provides automated instrumentation (ASM full tracking) and debugging utilities for Android applications.

ASM Full Tracking (全埋点)

Automatically tracks the following events:

• AppStart: Application startup.
• AppEnd: Application exit.
• AppViewScreen: Page/Screen browsing.
• AppClick: View clicks (e.g., ImageView, Button, Dialog). Includes built-in protection against multiple clicks and supports intercepting setOnClickListener calls.
• Privacy Method Handling: Can replace privacy method bodies with custom implementations.

Auxiliary Debugging Features

• Measure method execution time.
• Print method parameters and return values.
• Print method stack frames.
• Dynamically enable or disable the plugin.

If you are using an older Gradle configuration, follow these steps:

1. Configure the ASM Plugin

Add the following to your root build.gradle at the end of the repositories block:

buildscript {
  repositories {
    maven {
      url "https://plugins.gradle.org/m2/"
    }
  }
  dependencies {
    classpath "io.github.peakmain:plugin:1.2.0"
  }
}

apply plugin: "com.peakmain.plugin"

2. Configure the SDK Dependency

First, add the JitPack repository to your root build.gradle:

allprojects {
    repositories {
        ... 
        maven { url 'https://jitpack.io' }
    }
}

Then, add the dependency to your module's build.gradle:

dependencies {
    implementation 'com.github.Peakmain:AsmActualCombat:1.2.0'
}

The monitorPlugin block allows you to configure how the ASM plugin handles privacy method calls and logging. You can use it to replace privacy method bodies with your own implementation.

Configuration Options

• whiteList: A list of classes/packages to exclude from processing.
• methodStatus: Controls method body replacement. Setting this to 1 enables method body replacement; other values result in normal behavior.
• enableLog: A boolean to enable or disable log printing (defaults to false).

monitorPlugin {
    whiteList = [
            "com.peakmain.asmactualcombat.utils.TestUtils",
            "com.peakmain.plugin"
    ]
    methodStatus = 1 // 1 enables method body replacement
    enableLog = true // Enables log printing
}

To use the ASM tracking capabilities, you must initialize the SensorsDataAPI within your Application.onCreate() method. This SDK allows you to manage user agreements, monitor data upload states, and intercept/replace sensitive system method calls (like device ID or WiFi information retrieval) via listeners.

@Override
public void onCreate() {
    super.onCreate();
    // Initialize JPush
    JPushInterface.init(this);
    
    // Initialize SensorsDataAPI
    SensorsDataAPI.init(this);
    
    // Set user agreement policy (return true to accept)
    SensorsDataAPI.getInstance().setOnUserAgreementListener(() -> true);
}

Use SensorsDataAPI.getInstance().setOnUploadSensorsDataListener to intercept and react to sensor data being uploaded. The listener provides a state and the data payload. Common states are defined in SensorsDataConstants:

• SensorsDataConstants.APP_START_EVENT_STATE
• SensorsDataConstants.APP_END__EVENT_STATE
• SensorsDataConstants.APP_VIEW_SCREEN__EVENT_STATE

SensorsDataAPI.getInstance().setOnUploadSensorsDataListener((state, data) -> {
    switch (state) {
        case SensorsDataConstants.APP_START_EVENT_STATE:
        case SensorsDataConstants.APP_END__EVENT_STATE:
        case SensorsDataConstants.APP_VIEW_SCREEN__EVENT_STATE:
            // Handle specific event data
            break;
        default:
            // Handle other states
            break;
    }
});