Tutorial1

Background

I want to get all the input parameters when my application enters a method. In this case, we use FingerPaint in ApiDemo app from Android SDK sample to show how we get the input paramters of myView.onTouchEvent(MotionEvent event)

Step 1: get the application

• create an eclipse project for ApiDemo (sdk\samples\android-7\ApiDemos)
• build it and get the apk file in bin folder, e.g. sdk\samples\android-7\ApiDemos\bin\ApiDemos.apk

Step 2: get system libraries

• because we are using the sample app from the SDK, we just use the corresponding android.jar to solve the class path, e.g. sdk\platforms\android-7\android.jar

Step 3 analyse and modify the app

• launch the ApkAnalyser

• File->Settings

  Configure ADB executable path in ApkAnalyser, e.g. C:\android-sdk-windows\tools\adb.exe

• File->Set path

  Add android.jar, the file you get from Step 2

  Add ApiDemos.apk, the file you get from Step 1

• File->Analyse...

Now, you may do any Dalvik Bytecode Injections as you want.

In this case, we just need the input parameters of FingerPaint$MyView.onTouchEvent(android.view.MotionEvent event)

The injection should be '''Print method entry(with params)'''

• Right click "onTouchEvent(android.view.MotionEvent event)" method -> Print method entry(with params)

• Modification->Perform bytecode modification

Now there should be a summary of all the class modified and the new APK file

Step 4 view the printouts

• Prepare the phone. Start emulator or connect your device via usb cable.

Make sure your phone is the only one which connect to the ADB (you may check it with "adb devices"), because there is a limitation that ApkAnalyser only support one device, see Trouble Shooting

• Click "Install and run", the modified app will be installed and launched automatically.

• In this case, just launch "API Demos" -> "Graphics" -> "FingerPaint"

• Click "S" button in the Console to remove all the outputs except our logs (in TAG "APKANALYSER")

• You may touch the screen to see the logs, here is a snapshot