apk-parser

Extract Android Manifest info from an APK file.

Usage no npm install needed!

<script type="module">
  import apkParser from 'https://cdn.skypack.dev/apk-parser';
</script>

README

apk-parser - Android apk-file parser

Extract Android Manifest info from an APK file.

Build Status

While there are some implementations for this out in the wild, none of them handle all of the intricacies of the APK file-format. This module uses the aapt tool from the Android SDK to solve that problem. The tool will be downloaded and installed during npm install. Tested on Linux and OS X.

Using 64-bit Ubuntu?

Newer versions of Ubuntu don't support 32-bit executables by default. aapt is a 32-bit executable. In order for apk-parser to work from 64-bit Ubuntu, you need to execute the following commands to install 32-bit support:

sudo dpkg --add-architecture i386
sudo apt-get -qqy update
sudo apt-get -qqy install libncurses5:i386 libstdc++6:i386 zlib1g:i386

Getting started

Add apk-parser to your project: npm install --save apk-parser.

Sample usage:

var parseApk = require('apk-parser');
parseApk('myApkFile.apk', function (err, data) {
    // Handle error or do something with data.
});

The returned data object is an object-representation of the AndroidManifest.xml file. Here's a sample file:

{
    "manifest": [
        {
            "@package": "com.example.android.snake",
            "uses-permission": [
                {
                    "@android:name": "android.permission.INTERNET"
                }
            ],
            "application": [
                {
                    "@android:label": "Snake on a Phone",
                    "activity": [
                        {
                            "@android:theme": "@0x1030006",
                            "@android:name": "Snake",
                            "@android:screenOrientation": 1,
                            "@android:configChanges": "(type 0x11)0xa0",
                            "intent-filter": [
                                {
                                    "action": [
                                        {
                                            "@android:name": "android.intent.action.MAIN"
                                        }
                                    ],
                                    "category": [
                                        {
                                            "@android:name": "android.intent.category.LAUNCHER"
                                        }
                                    ]
                                }
                            ]
                        }
                    ]
                }
            ]
        }
    ]
}

Things to note:

  • The top-level element is a key named manifest.
  • Attributes are encoded by prepending their name with @.
  • Child nodes can be accessed by name. The value is always an array, as there might be more than one array.
  • This representation is unaware of the meaning of this file (you might know that there will always only be one application tag, the module does not). This make sure that it never breaks with future Android releases.

You can increase the buffer size when needed, but do note that it comes with a memory cost:

parseApk('myApkFile.apk', 8 * 1024 * 1024, function (err, data) {
    // Handle error or do something with data.
});

Contributing

All code lives in the lib folder. Try to stick to the style conventions used in existing code.

Tests can be run using grunt test. A convenience command to automatically run the tests is also available: grunt watch. Please add test cases when adding new functionality: this will prove that it works and ensure that it will keep working in the future.

License

(The MIT License)

Copyright (C) 2013-2015 by Ruben Vermeersch <ruben@rocketeer.be>

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.