cordova-plugin-buildinfo

This plugin defines a global BuildInfo object.

BuildInfo object is available at the time the deviceready event fires.

document.addEventListener("deviceready", onDeviceReady, false);

function onDeviceReady() {
	console.log('BuildInfo.baseUrl        =' + BuildInfo.baseUrl);
	console.log('BuildInfo.packageName    =' + BuildInfo.packageName);
	console.log('BuildInfo.basePackageName=' + BuildInfo.basePackageName);
	console.log('BuildInfo.displayName    =' + BuildInfo.displayName);
	console.log('BuildInfo.name           =' + BuildInfo.name);
	console.log('BuildInfo.version        =' + BuildInfo.version);
	console.log('BuildInfo.versionCode    =' + BuildInfo.versionCode);
	console.log('BuildInfo.debug          =' + BuildInfo.debug);
	console.log('BuildInfo.buildType      =' + BuildInfo.buildType);
	console.log('BuildInfo.flavor         =' + BuildInfo.flavor);
	console.log('BuildInfo.buildDate      =' + BuildInfo.buildDate);
	console.log('BuildInfo.installDate    =' + BuildInfo.installDate);
}

Installation

cordova plugin add cordova-plugin-buildinfo

Supported Platforms

• Android
• iOS
• Windows
• macOS(OS X)
• Browser
• Electron

Properties

• BuildInfo.baseUrl
• BuildInfo.packageName
• BuildInfo.basePackageName
• BuildInfo.displayName
• BuildInfo.name
• BuildInfo.version
• BuildInfo.versionCode
• BuildInfo.debug
• BuildInfo.buildType
• BuildInfo.flavor
• BuildInfo.buildDate
• BuildInfo.installDate
• BuildInfo.windows
  • logo
  • version

BuildInfo.baseUrl

Get the cordova.js file exists path.
Path last character is '/'.

Platform	Value	Type
Android	Path	String
iOS	Path	String
Windows	Path	String
macOS(OS X)	Path	String
Browser	Path	String
Electron	Path	String

BuildInfo.packageName

Get the packageName of Application ID.

Platform	Value	Type
Android	Package Name	String
iOS	Bundle Identifier	String
Windows	Identity name	String
macOS(OS X)	Bundle Identifier	String
Browser	Get the id attribute of the widget element in config.xml file.	String
Electron	Get the id attribute of the widget element in config.xml file.	String

BuildInfo.basePackageName

Android only.

Get the packageName of BuildConfig class.

If you use the configure of "build types" or "product flavors", because you can specify a different package name is the id attribute of the widget element of config.xml, is the property to get the package name that BuildConfig class belongs. (ought be the same as the id attribute of the widget element of config.xml)

Platform	Value	Type
Android	Package name of BuildConfig class	String
iOS	Bundle Identifier(equals BuildInfo.packageName)	String
Windows	Identity name(equals BuildInfo.packageName)	String
macOS(OS X)	Bundle Identifier(equals BuildInfo.packageName)	String
Browser	equals BuildInfo.packageName	String
Electron	equals BuildInfo.packageName	String

BuildInfo.displayName

Get the displayName.

Platform	Value	Type
Android	Application Label	String
iOS	CFBundleDisplayName (CFBundleName if not present)	String
Windows	Get the DisplayName attribute of the VisualElements element in AppxManifest.xml file.	String
macOS(OS X)	CFBundleDisplayName (CFBundleName if not present)	String
Browser	Get the short attribute of the name element in config.xml file.	String
Electron	Get the short attribute of the name element in config.xml file.	String

BuildInfo.name

Get the name.

Platform	Value	Type
Android	Application Label(equal BuildInfo.displayName)	String
iOS	CFBundleName	String
Windows	Windows Store display name	String
macOS(OS X)	CFBundleName	String
Browser	Get value of the name element in config.xml file.	String
Electron	Get value of the name element in config.xml file.	String

BuildInfo.version

Get the version.

Platform	Value	Type
Android	BuildConfig.VERSION_NAME	String
iOS	CFBundleShortVersionString	String
Windows	Major.Minor.Build ex) "1.2.3"	String
macOS(OS X)	CFBundleShortVersionString	String
Browser	Get the version attribute of the widget element in config.xml file.	String
Electron	Get the version attribute of the widget element in config.xml file.	String

BuildInfo.versionCode

Get the version code.

Platform	Value	Type
Android	BuildConfig.VERSION_CODE	integer
iOS	CFBundleVersion	String
Windows	Major.Minor.Build.Revision ex) "1.2.3.4"	String
macOS(OS X)	CFBundleVersion	String
Browser	equals BuildInfo.version	String
Electron	equals BuildInfo.version	String

BuildInfo.debug

Get the debug flag.

Platform	Value	Type
Android	BuildConfig.DEBUG	Boolean
iOS	defined "DEBUG" is true	Boolean
Windows	isDevelopmentMode is true	Boolean
macOS(OS X)	defined "DEBUG" is true	Boolean
Browser	Always false	Boolean
Electron	True when cordova build electron --debug is executed with the "--debug" flag.	Boolean

BuildInfo.buildType

Android , Windows Only.

Get the build type.

Platform	Value	Type
Android	BuildConfig.BUILD_TYPE	String
iOS	empty string	String
Windows	"release" or "debug"	String
macOS(OS X)	empty string	String
Browser	empty string	String
Electron	empty string	String

BuildInfo.flavor

Android Only.

Get the flavor.

Platform	Value	Type
Android	BuildConfig.FLAVOR	String
iOS	empty string	String
Windows	empty string	String
macOS(OS X)	empty string	String
Browser	empty string	String
Electron	empty string	String

BuildInfo.buildDate

Get the build date and time in the Date object returns.

Attention:

• Android: Add the BuildInfo.gradle file to your Android project.
  The BuildInfo.gradle file contains the setting to add the _BUILDINFO_TIMESTAMP field to the BuildConfig class.
• Windows: Add the buildinfo.resjson file to your Windows project.
  The buildinfo.resjson file into the "strings" folder.
  And also add a task to rewrite buildinfo.resjson in the CordovaApp.projitems file.
• Browser and Electron: When cordova prepare is executed Build date and time is embedded in
  platforms/browser/www/plugins/cordova-plugin-buildinfo/src/browser/BuildInfoProxy.js file.
  (Or platforms/electron/www/plugins/cordova-plugin-buildinfo/src/browser/BuildInfoProxy.js file.)
  cordova prepare is also executed for cordova build, cordova run and cordova platform add.
  (Reference: Hooks Guide - Apache Cordova)

Platform	Value	Type
Android	BuildConfig._BUILDINFO_TIMESTAMP value	Date
iOS	Get the modification date and time of the Info.plist file acquired from the executionPath property of the main bundle.	Date
Windows	Resource value of "/buildinfo/Timestamp" string.	Date
macOS(OS X)	Get the modification date and time of the config.xml file acquired from the resource of the main bundle.	Date
Browser	The date and time when cordova prepare was executed.	Date
Electron	The date and time when cordova prepare was executed.	Date

BuildInfo.installDate

Get the install date and time in the Date object returns.

Attention:

• Browser and Electron: Installation date and time is unknown.

Platform	Value	Type
Android	The firstInstallTime property of PackageInfo	Date
iOS	Get the creation date and time of the document directory.	Date
Windows	The installedDate property of Windows.ApplicatinoModel.Package.current	Date
macOS(OS X)	Date and time of kMDItemDateAdded recorded in File Metadata of application package.	Date
Browser	Not available.	null
Electron	Not available.	null

BuildInfo.windows

Windows Only.

Get the windows extra information.

Platform	Value	Type
Android	undefined	undefined
iOS	undefined	undefined
Windows	Object	Object
macOS(OS X)	undefined	undefined
Browser	undefined	undefined
Electron	undefined	undefined

Property name	Value	Type
architecture	Windows.ApplicationModel.Package.current.id.architecture	integer
description	Windows.ApplicationModel.Package.current.description	String
displayName	Windows.ApplicationModel.Package.current.displayName	String
familyName	Windows.ApplicationModel.Package.current.id.familyName	String
fullName	Windows.ApplicationModel.Package.current.id.fullName	String
logo	Object	Object
publisher	Windows.ApplicationModel.Package.current.id.publisher	String
publisherId	Windows.ApplicationModel.Package.current.id.publisherId	String
publisherDisplayName	Windows.ApplicationModel.Package.current.publisherDisplayName	String
resourceId	Windows.ApplicationModel.Package.current.id.resourceId	String
version	Windows.ApplicationModel.Package.current.id.version	Object

BuildInfo.windows.logo

Property name	Value	Type
absoluteCannonicalUri	Windows.ApplicationModel.Package.logo.absoluteCanonicalUri	String
absoluteUri	Windows.ApplicationModel.Package.logo.absoluteUri	String
displayIri	Windows.ApplicationModel.Package.logo.displayIri	String
displayUri	Windows.ApplicationModel.Package.logo.displayUri	String
path	Windows.ApplicationModel.Package.logo.path	String
rawUri	Windows.ApplicationModel.Package.logo.rawUri	String

BuildInfo.windows.version

Property name	Value	Type
major	Windows.ApplicationModel.Package.current.id.version.major	integer
minor	Windows.ApplicationModel.Package.current.id.version.minor	integer
build	Windows.ApplicationModel.Package.current.id.version.build	integer
revision	Windows.ApplicationModel.Package.current.id.version.revision	integer