Copyright (C) 2012 Sony Mobile Communications AB
This file is part of ApkAnalyser.
Licensed under the Apache License, Version 2.0 (the "License");
  you may not use this file except in compliance with the License.  You may obtain a copy of the License at

 http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software  distributed under the License is distributed on an "AS IS" BASIS,  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the License for the specific language governing permissions and  limitations under the License.  ==============================================================================  Introduction ------------ ApkAnalyser is a static, virtual analysis tool for examining and validating  the development work of your Android app. It's a complete tool chain which supports  modification of the binary application with more printouts. You are then able to  repack, install, run and verify the result from logcat. ApkAnalyser also supports  resource analysis, and you can decode XML, look up resource references and detect  potential issues in your app.  It??s a stand-alone J2SE application, released under Apache 2.0 license, 100% written in Java.
Open Source Projects --------------------  Some code of following OSS projects are imported and modified: 1. smali, dalvik assembler/disassembler, http://code.google.com/p/smali/ 2. apktool, reengineering binary Android apps, http://code.google.com/p/android-apktool/ 3. Android4ME, J2ME port of Google's Android, http://code.google.com/p/android4me/ 4. Android Open Source Project  Following OSS projects are used as jar library: 1. ASM, Java bytecode manipulation and analysis framework, http://asm.ow2.org/license.html  2. Jgraphx, Java Graph Visualization Library, http://www.jgraph.com/jgraph.html 3. Xpp3, a streaming pull XML parser, http://www.extreme.indiana.edu/dist/java-repository/xpp3/distributions 4. L2fprod, extended swing components, http://www.l2fprod.com/common/
Build Infomation ----------------  Firstly, the latest ApkAnalyser is available at:  https://github.com/sonyxperiadev/ApkAnalyser  ApkAnalyser includes two open source projects, smali and apktool. The projects must be built in sequence of:  1. smali 2. apktool 3. apkanalyser  All of the projects are managed by Maven2 build system.  http://maven.apache.org/download.html  The project could be built on JDK1.5, 1.6 or 1.7.
Build Steps -----------  1. Get the latest code  git clone git://github.com/sonyxperiadev/ApkAnalyser.git  2. Build smali project cd smali mvn install  3. Build apktool project cd ../apktool mvn install  4. Install jgraphx into local Maven repository cd ../apkanalyser mvn install:install-file -Dfile=lib/jgraphx.jar -DgroupId=com.mxgraph -DartifactId=jgraphx -Dversion=1.7.1.9 -Dpackaging=jar -DgeneratePom=true  5. Build and package ApkAnalyser mvn assembly:assembly  6. The executable jar file should be at  apkanalyser\target\apkanalyser-{
version
}
-exec.jar  Optionally, Eclipse project could also be generated by "mvn eclipse:eclipse" command.
Launch ApkAnalyser ------------------  To launch it, just execute:
java -jar ApkAnalyser.jar  Sometimes, ApkAnalyser consumes lots of memory for analysing the dalvik bytecodes.  It may run out of memory expecially for loading more than one big odexed APK files. In that case, the max heap size should be explicitly incrased by "-Xmx1024m" parameter:
java -Xmx1024m -jar ApkAnalyser.jar
Contacts --------  Zhang Bojie, Sony Mobile Communications [email protected]