Meet npm Pro: unlimited public & private packages + package-based permissions.Learn more »

This package has been deprecated

Author message:

This package is not being maintained by MSFT anymore


0.1.26 • Public • Published


This library helps you retrieve the most frequently extracted metadata and icons within iOS, Android and UWP applications.



import { Extract } from 'app-metadata';


let results = await;

This library relies on the standard set of file extensions to determine the type of package it is analyzing.


The library will return the information most relevant for the supported platforms. For a better understanding of the details retrieved refer to the tables below.


Supported extension: .ipa
Property Description
languages Array of language strings compiled from .lproj files
hasProvisioning Should always be true since IPA will contain a provisioning profile
appex_provisioning_profiles Array of all other provisioning profiles included in the metadata
  • ##### from Plist (info.plist):
Property Description
displayName CFBundleDisplayName (The user-visible name of the bundle) or CFBundleName (short bundle name)
uniqueIdentifier CFBundleIdentifier (reverse DNS that identifies a project by concatenating the company identifier with the product name)
version CFBundleShortVersionString (The release-version-number string for the bundle)
buildVersion CFBundleVersion (The build-version-number string for the bundle)
executableName CFBundleExecutable (Name of the bundle’s executable file)
minimumOsVersion MinimumOSVersion or LSMinimumSystemVersion
deviceFamily UIdeviceFamily
  • ##### from Provisioning Profile (embedded.mobileprovision):
Property Description
pathName Path of the provisioning profile from inside of the IPA
mobileProvisionFileContent Provisioning profile content
teamIdentifier Entitlements[""]
profileType If data.ProvisionedDevices exists, "adhoc". Otherwise "enterprise"
expiredAt expired_at or ExpirationDate
idName AppIDName
name Name
UniqueDeviceIdentifierList ProvisionedDevices
deviceFamily Platform


Supported extension: .apk
  • ##### from Manifest:
Property Description
uniqueIdentifier package
version versionName
buildVersion versionCode
minimumOsVersion usesSdk.minSdkVersion
deviceFamily "android"


Supported extensions: .appx, appxupload or .zip
from Manifest:
Property Description
deviceFamily Constants.WINDOWS
displayName Package.Properties.DisplayName
iconFullPath Package.Properties.Logo
uniqueIdentifier Package.Identity.Name
buildVersion Package.Identity.Version
minimumOsVersion Package.Prerequisites.OSMinVersion or Package.Dependencies.TargetDeviceFamily.MinVersion
executableName Package.Applications.Application.Executable
languages Built from Package.Resources.Resource.Language

UWP Bundles

Supported extensions: .appxbundle, appxupload or .zip

For .appxbundle app packages, the manifest is checked for the correct name of the appx subpackage. If it is found, the metadata is parsed directly from there, otherwise we scavenge for as much as we can get from the appxbundle manifest and metadata

Property Description
languages Built from .appx language files. Example- VLC_WinRT.WindowsPhone_1.8.4.0_language-en.appx
from Manifest:
Property Description
deviceFamily windows
uniqueIdentifier Bundle.Identity.Name
buildVersion Bundle.Identity.Version
minimumOsVersion Bundle.Prerequisites.OSMinVersion or Bundle.Dependencies.TargetDeviceFamily

The assumption for zip and appxUpload is that the unziped folders will have the appx or appxbundle which we will then process as we do normally


  • Install node version 7.6.0

  • Install project dependencies (based on <REPO ROOT>/package.json)

    npm install
  • Install typescript via npm (npm will be installed with node)

    npm install -g typescript@2.3.4
  • Install gulp via npm

    npm install -g gulp@3.9
  • Upgrade npm to version 3.3.x

    npm install -g npm@5
  • Install the IDE


This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit

When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact with any additional questions or comments.

  • Ensure that it builds
    • Via gulp
      cd <REPO ROOT>
      gulp build
  • Ensure that tests pass
    • Via gulp
      cd <REPO ROOT>
      gulp test

Developing on OS X

  • Visual Studio Code

    • Point Visual Studio Code to the repo root
    • Install project dependencies
      • via npm on the command line
        cd <REPO ROOT>
        npm install 
    • Build (Cmd-Shift-B)
    • Run (F5)
    • Testing
      • via Visual Studio Code (Cmd-Shift-T)
      • via gulp on the command line
        cd <REPO ROOT>
        gulp test




npm i app-metadata

DownloadsWeekly Downloads






Last publish


  • avatar
  • avatar
  • avatar
  • avatar