Release Notes for Cordova (Android)

9.0.0 (Jun 23, 2020)

• GH-1005 chore: set AndroidX off by default
• GH-971 fix: Accept multiple mime types on file input
• GH-1001 fix: support both adaptive and standard icons at the same time
• GH-985 fix: Plugin install fails when preview sdk is installed
• GH-994 chore: cleanup yaml files
• GH-999 chore: remove trailing spaces from Java sources
• GH-992 chore: update some dependencies
• GH-998 chore: remove trailing spaces from framework build files
• GH-997 chore: remove trailing spaces from project template
• GH-996 chore: remove trailing spaces from bat files
• GH-995 remove trailing spaces from markdown files
• GH-993 chore: update devDependencies
• GH-987 breaking: reduce combined response cutoff to 16 MB
• GH-988 major: Gradle 6.5 & Android Gradle plugin 4.0.0 updates
• GH-990 chore: remove trailing spaces from app/build.gradle
• GH-989 breaking: remove legacy/build.gradle from template
• GH-978 fix: wait_for_boot waiting forever
• GH-965 fix: Increased detectArchitecture() timeout
• GH-962 breaking: Bump Android gradle plugin to 3.6.0
• GH-948 feature: JVM Args flag
• GH-951 fix: ANDROID_SDK_ROOT variable
• GH-959 test: synced AndroidX gradle versions to the same version as the Android test
• GH-960 feat: com.android.tools.build:gradle:3.5.3
• GH-956 chore(npm): add package-lock.json
• GH-958 chore(npm): add ignore list
• GH-957 chore: various cleanup
• GH-955 chore(eslint): bump package & apply eslint fix
• GH-954 breaking(npm): bump packages
• GH-953 chore(npm): use short notation in package.json
• GH-823 fix: prevent exit fullscreen mode from closing application
• GH-950 fix: removed redundent logcat print
• GH-915 breaking: bump minSdkVersion to 22 and drop pre-Lollipop specific code
• GH-941 fix: GH-873 App bundle builds to obey command-line arguments
• GH-940 ci: drop travis & move codecov to gh-actions
• GH-929 chore: updated README to reflect what Android requires more accurately, which is Java 8, not anything less, not anything greater. Java 1.8.x is required.
• GH-937 fix: GH-935 replaced compare-func with native sort method
• GH-939 fix: test failure with shebang interpreter in rewired files
• GH-911 refactor: use es6 class
• GH-910 refactor (eslint): use cordova-eslint
• GH-909 chore: remove appveyor residual
• GH-895 feat: add github actions
• GH-842 refactor: remove shelljs dependency
• GH-896 feat: add Kotlin support
• GH-901 feat: add AndroidX support
• GH-849 fix: cordova requirements consider the android-targetSdkVersion
• GH-904 fix (adb): shell to return expected stdout
• GH-792 feat: upgrade gradle to 6.1 & gradle build tools to 3.5.3
• GH-902 chore: remove .project file & add .settings to gitignore
• GH-900 refactor: simplify doFindLatestInstalledBuildTools
• GH-751 feat: use Java package name for loading BuildConfig
• GH-898 chore: rename gradle plugin google services preference options
• GH-893 feat: add Google Services support
• GH-709 feat: add version-compare library to compare build-tools versions properly.
• GH-831 chore: ignore auto-generated eclipse buildship files
• GH-848 breaking: increased default target sdk to 29
• GH-859 breaking: removed unnecessary project name restriction
• GH-833 chore: drop q module
• GH-862 chore: replace superspawn & child_process with execa
• GH-860 feat: don't filter gradle's stderr anymore
• GH-832 chore: drop node 6 and 8 support
• GH-890 chore: bump version to 9.0.0-dev
• GH-697 chore: optimization code
• GH-863 chore: removed comment that serves no purpose
• GH-861 chore: update jasmine to 3.5.0
• GH-858 chore: modernize our one E2E test
• GH-854 chore: ensure to lint as many files as possible

8.1.0 (Sep 11, 2019)

• GH-827 chore: bump dependencies for release 8.1.0
• GH-651 feat: added multiple selection for filepicker
• GH-672 chore: compress files in /res with tinypng.com
• GH-815 fix: clean command
• GH-750 Don't request focus explicitly if not needed
• GH-800 GH-799 (android) Stop webview from restarting when activity resizes
• GH-764 feat: Build app bundles (.aab files)
• GH-788 Simplify apkSorter using compare-func package
• GH-787 Simplify and fix promise handling in specs
• GH-784 Properly handle promise in create script
• GH-783 Do not clobber process properties with test mocks
• GH-782 Do not clobber console.log to spy on it
• GH-724 Add Node.js 12 to CI Services
• GH-777 ci(travis): set dist: trusty in .travis.yml
• GH-779 Consistent order from ProjectBuilder.apkSorter
• GH-778 test: use verbose spec reporter
• GH-774 rewire workaround for NodeJS 12
• GH-772 nyc@14 update in devDependencies
• GH-765 ci(travis): Fix Android SDK
• GH-713 Do not explicitly require modules from project directory
• GH-676 Added allprojects repositories for Framework Release Builds
• GH-699 Improve Gradle Build Arguments
• GH-710 Fix deprecation warning in SystemCookieManager
• GH-691 GH-690: Run prepare with the correct ConfigParser
• GH-673 Updated Android_HOME Test to Follow GH-656 Change

8.0.0 (Feb 13, 2019)

• GH-669 Added Missing License Headers
• GH-655 Use custom Gradle properties to read minSdkVersion value from config.xml
• GH-656 Quick fix to support Android_SDK_ROOT
• GH-632 Ignore more Gradle build artifacts in Android project
• GH-642 Android tools 3.3 & Gradle 4.10.3 update
• GH-654 Quick updates to top-level project.properties
• GH-635 Ignore Android Studio .idea files in project
• GH-624 Add missing log to Java version check
• GH-630 Update emulator.js to fix issue GH-608
• GH-626 Added package-lock.json to .gitignore
• GH-620 Fix requirements error messages for JDK 8
• GH-619 javac error message fixes in requirements check
• GH-612 Android Platform Release Preparation (Cordova 9)
• GH-607 Copy node_modules if the directory exists
• GH-582 Improve Test README
• GH-589 Rewrite install dir resolution for legacy plugins
• GH-572 Resolve issue with plugin target-dir="app*" subdirs
• GH-567 Output current package name if package name can't be validated
• GH-507 Gradle Updates
• GH-559 Eslint ignore version file
• GH-550 Fix for old plugins with non-Java sources
• GH-558 Update cordova.js from cordova-js@4.2.3
• GH-553 Check for build-extras.gradle in the app-parent directory
• GH-551 Add missing cast for cdvMinSdkVersion
• GH-539 Fix destination path fallback
• GH-544 Remove obsolete check for JellyBean
• GH-465 Removes Gradle property in-line command arguments for gradle.properties
• GH-523 Always put the Google repo above jcenter
• GH-486 Change deprecated "compile" to "implementation"
• GH-495 Incorrect default sdk version issue fix
• GH-493 Remove bundled dependencies
• GH-490 Fixes build & run related bugs from builder refactor
• GH-464 Unit tests for Android_sdk and AndroidProject
• GH-448 CB-13685 Adaptive Icon Support
• GH-487 Do not attempt an activity intent AND a url load into the webview, return from the internal webview load.
• GH-461 Remove old builders code
• GH-463 Emulator: Add unit tests and remove Q
• GH-462 Device: Add unit tests and remove Q
• GH-457 Emulator: handle "device still connecting" error
• GH-445 Run and retryPromise improvements and tests
• GH-453 Lint JS files w/out extension too
• GH-452 Emit log event instead of logging directly
• GH-449 Increase old plugin compatibility
• GH-442 Fixes and cleanup for Java tests and CI
• GH-446 CB-14101 Fix Java version check for Java >= 9
• CB-14127 Move google maven repo ahead of jcenter
• CB-14038 Fix false positive detecting project type
• CB-14008 Updating Gradle Libraries to work with Android Studio 3.1.0
• CB-13975 Fix to fire pause event when cdvStartInBackground=true
• CB-13830 Add handlers for plugins that use non-Java source files, such as Camera
• CB-13923 Fix -1 length for compressed files

7.1.0 (Feb 20, 2018)

• CB-13879 updated gradle tools dependency to 3.0.1 for project template
• CB-13831 Update android-versions to 1.3.0 to support SDK 27.
• CB-13800 Drop pre-KitKat specific code
• CB-13724 Updated the Android Tooling required for the latest version on both the test project, and the template
• CB-13724 Bump Target SDK to API 27
• CB-13646 Using the deprecated NDK by default breaks the build. Crosswalk users need to specify the Gradle parameters to keep it working.
• CB-12218 Fix consistency of null result message
• CB-13571 Prevent crash with unrecognized Android version
• CB-13721 Fix build apps that use cdvHelpers.getConfigPreference
• CB-13621 Wrote similar warning to CB-12948 on iOS. We no longer support cordova update command.

7.0.0 (Nov 30, 2017)

• CB-13612 Fix the remapper so that XML files copy over and the Camera works again.
• CB-13741 Bump package.json so we can install plugins
• CB-13610 Compress the default app assets
• CB-12835 add a Context getter in CordovaInterface
• CB-8976 Added the cdvVersionCodeForceAbiDigit flag to the template build.gradle that appends 0 to the versionCode when cdvBuildMultipleApks is not set
• CB-12291 (android) Add x86_64, arm64 and armeabi architecture flavors
• CB-13602 We were setting the path wrong, this is hacky but it works
• CB-13601 Fixing the standalone run scripts to make sure this works without using the CLI
• CB-13580 fix build for multiple apks (different product flavors)
• CB-13558 Upgrading the gradle so we can upload the AAR
• CB-13297 This just works once you bump the project structure. Java 1.8 compatibility baked-in
• CB-11244 Android Studio 3 work, things have changed with how the platform is built
• CB-11244 Found bug where the gradle subproject changes weren't actually getting written to the correct gradle file
• CB-13470 Fix Clean so that it cleans the Android Studio structure
• CB-11244 Adding specs for resource files inside an Android Studio Project
• CB-11244 Added remapping for drawables
• CB-11244 Found bug in Api.js where xml/strings.xml is used instead of values/strings.xml
• CB-11244 Setup Api.js to support multiple builders based on project structure
• CB-11244 Changing directory creation, will most likely hide this behind a flag for the next release of cordova-android, and then make it default in the next major pending feedback
• Adding the Studio Builder to build a project based on Android Studio, and deleting Ant, since Google does not support Ant Builds anymore. Sorry guys!

6.4.0 (Nov 06, 2017)

• CB-13289 Fixing build problems with Studio Three, but keeping Windows Gradle fix for now, will be deprecated
• CB-13289 Fix test to work with new Google Android Gradle DSL
• :CB-13501 : update appveyor node versions to support node 8
• CB-13499 Remove duplicate "setting" in error strings
• Include missing values for task.name when 'cdvBuildMultipleApks' option is true, 'task.name' can have 'validateSigningArmv7Release' or 'validateSigningX86Release' values too.
• CB-13406 Fixed AVD API level comparison when choosing sub-par API level match. Added tests for the best_image method.
• CB-13404 add Android-versions to bundledDependencies. Ignore best emulator selection when parsed AVD information does not include API level in the target
• CB-12895 : eslint ignoring cordova.js
• CB-12895 Temporarily disabling eslint since cordova-js does not have eslint yet.

6.3.0 (Sep 25, 2017)

• CB-6936 fix crash when calling methods on a destroyed webview
• CB-12981 handle SDK 26.0.2 slightly different AVD list output for Android 8+ AVDs. Would cause "cannot read property replace of undefined" errors when trying to deploy an Android 8 emulator.
• Updated maven repo to include most recent lib versions
• CB-13177 Updating to API Level 26
• Revert CB-12015 initial-scale values less than 1.0 are ignored on Android
• CB-12730 The Cordova Compatibility Plugin is now integrated into cordova-android
• CB-12453 Remove unnecessary double quotes from .bat files which are the causes of crash if project path contains spaces
• CB-13031 Fix bug with case-sensitivity of Android-packageName
• CB-10916 Support display name for Android
• CB-12423 make explicit JDK 1.8 or greater is needed in the README, we require 1.8 for compilation, but do not have 1.8 Java features yet
• CB-13006 removed create and update end-to-end tests, and instead added more unit test coverage. tweaked code coverage invocation so that we get coverage details on the create.js module. slight changes to the create.js module so that it is slightly easier to test.
• CB-12950 lots of tweaks for end-to-end test runs, especially on CI: - rename npm tasks to reflect what they do (npm run unit-tests, npm run e2e-tests). main npm test runs linter, unit tests and e2e tests now. - locked jasmine down to ~2.6.0. - consolidate gitignores. - updated travis to run npm test. add Android sdk installation to appveyor ci run.align Android dpendencies across travis and appveyor. have appveyor install gradle. force gradle to version 3.4.1 in appveyor, as that seems to be the only version choco has. explicitly invoke sdkmanager to move license accepting process along.
• CB-12605 In Windows get Android studio path from the registry
• CB-12762 : pointed package.json repo items to github mirrors instead of apache repos site
• CB-12617 : removed node0.x support for platforms and added engineStrict

6.2.3 (May 2, 2017)

• CB-12640 better handling of unrecognized Android SDK commands on Windows.
• CB-12640 flipped avd parsing logic so that it always tries to use avdmanager to retrieve avds first, then falls back to android command if avdmanager cannot be found (and errors with ENOENT). updated tests - and added explicit tests to ensure to shell out to singular forms of sub-commands when executing android
• CB-12640 support for android sdk tools 26.0.1.

6.2.2 (Apr 24, 2017)

• CB-12697 Updated checked-in node_modules

6.2.1 (Apr 02, 2017)

• CB-12621 reverted elementtree dep to 0.1.6

6.2.0 (Mar 28, 2017)

• CB-12614 Adding headers to tests
• CB-8978 Prepare copy resource-files from config.xml
• CB-12605 Fix a requirements check failure on Windows
• CB-12595 This should find an Android Studio installation and use the sweet gradle center found inside
• CB-12546 leverage avdmanager if android warns it is no longer useful, which happens in Android SDK Tools 25.3.1. Explicitly set the CWD of the spawned emulator process to workaround a recent google android sdk bug. Rename android_sdk_version.js to android_sdk.js, to better reflect its contents. Have create.js copy over the android_sdk_version batch file.
• CB-12524 Fix for missing gradle template error. This now fetches the template from inside of the Android Studio directory, and falls back to a locally installed Gradle instance
• CB-12465 Writing new JUnit Test Instrumentation to replace tests and retire problmatic tests

6.1.2 (Jan 26, 2017)

• Security Change to https by default
• CB-12018: updated tests to work with jasmine (promise matcher tests commented out for now)
• created directories and corresponding images for xxhdpi and xxxhdpi, both drawables and mipmaps

6.1.1 (Jan 03, 2017)

• CB-12159 Android Keystore password prompt won't show up
• CB-12169 Check for build directory before running a clean
• Fixed AndroidStudio tests to actually run, removed app/src/main/assets/ as a requirement and added app/src/main/res instead, added placeholder for build/ folder, Removed dupe gitignore

6.1.0 (Nov 02, 2016)

• CB-12108 Updating gradle files to work with the latest version of Android Studio
• CB-12102 Bump travis to build to API 25
• Bumping up the version
• CB-12101 Fix so that CLI builds don't conflict with Android Studio builds
• CB-12077 Fix paths for Android icons/splashscreens
• added framework/build to .ratignore
• Fix for broken testUrl test
• Last minute change of test targets
• Update JS snapshot to version 6.1.0-dev (via coho)
• Set VERSION to 6.1.0-dev (via coho)

6.0.0 (Oct 20, 2016)

This release adds significant functionality, and also introduces a number of breaking changes. Some of the changes to the code base will be of particular interest to third party webview plugin developers.

Major Changes

• Primary bridge is the EVAL_BRIDGE, which tells the WebView to execute JS directly. This is more stable than the ONLINE_EVENT bridge
• Full Support for Android Nougat (API 24)
• Ice Cream Sandwich Support has been deprecated. Minimum Supported Android Version is Jellybean (API 16/ Android 4.1)
• Plugin Installation now CLEANS the build directory, this speeds up gradle build times and allows for CLI develoment to be more predictable

Changes For Third-Party WebView Developers:

• executeJavascript method added and is an abstract method that must be implemented
• the EVAL_BRIDGE must be added to the WebView

Curated Changes from the Git Commit Logs

• Updating the gradle build for test to use the latest
• CB-11083 Fixing syncronous file check and future-proofing the JS for Travis
• CB-11083 Reading files to check for CordovaLib dependency, if so, we exclude CordovaLib to be safe
• CB-11083 Plugin build script for dependencies without a gradle file
• CB-11083 The GradleBuidler can tell the difference between a Cordova Plugin Framework and a regular framework based on the name
• CB-11083 Fix to deal with custom frameworks with their own Gradle configuration
• CB-12003 updated node_modules
• CB-11771 Deep symlink directories to target project instead of linking the directory itself
• CB-11880 android: Fail-safe for cordova.exec()
• CB-11999 add message, catch exception if require fails
• fix issue with app_name containing apostrophes
• CB-8722 - Move icons from drawable to mipmap
• CB-11964 Call clean after plugin install and mock it in tests
• Did a try/catch to deal with the unit tests vs actual project environment, code duplication is needed because of builderEnv
• CB-11964 Do a clean when installing a plugin to et around the bug
• CB-11921 - Add github pull request template
• CB-11935 Does a best-effort attempt to pause any processing that can be paused safely, such as animations and geolocation.
• CB-11640 Fixing check_reqs.js so it actually works
• CB-11640 Changing requirements check to ask for Java 8
• CB-11869 Fix cordova-js android exec tests
• CB-11907 Bumping Gradle to work with Android Studio 2.2 and the Android Gradle Plugin
• Enable background start of Cordova Android apps
• fixing jshint issues
• replace Integer.parseInt with BigInteger so that you can use longer Android version codes
• CB-11828 Adding dirty userAgent checking to see if we're running Jellybean or not for bridge modes
• CB-11828 Switching default bridge back to ONLINE_BRIDGE
• Add gradle build flag to enable dex in process for large projects
• added ability for cordova activity to be viewed in a real full screen regardless of android version (as was the case in previous cordova versions)
• Updating travis
• Adding Static Method to CoreAndroid Plugin so we can get the BuildConfig data from other plugins
• Bump Target and Min API levels
• Make evaluateJavaScript brige default
• Creating an evaluateJavascript branch
• CB-11727 - travis ci setup is still using 0.10.32 node
• CB-11726 - Update appveyor node versions to 4 and 6, so they will always use the latest versions
• Close invalid PRs
• CB-11683 Fixed linking to directories during plugin installation.
• fixed CB-11078 Empty string for BackgroundColor preference crashes application This closes #316
• Update JS snapshot to version 5.3.0-dev (via coho)
• Set VERSION to 5.3.0-dev (via coho)
• CB-11626 Updated RELEASENOTES and Version for release 5.2.2
• updated cordoova-common to 1.4.0
• This closes #195
• Updaing the gradle for the tests to the latest
• CB-11550 Updated RELEASENOTES for release 5.2.1
• CB-9489 Fixed "endless waiting for emulator" issue
• Update JS snapshot to version 5.3.0-dev (via coho)
• Set VERSION to 5.3.0-dev (via coho)
• CB-11444 Updated RELEASENOTES and Version for release 5.2.0
• CB-11481 android-library is deprecated use com.android.library instead

5.2.2 (Jul 26, 2016)

• CB-11615 updated cordoova-common to 1.4.0

5.2.1 (Jul 11, 2016)

• CB-9489 Fixed "endless waiting for emulator" issue
• CB-11481 android-library is deprecated use com.android.library instead

5.2.0 (Jun 29, 2016)

• CB-11383 Update to gradle for using jcenter and correct Application plugin
• CB-11365 fixed plugin rm issue with emit being undefined
• CB-11117 Use FileUpdater to optimize prepare for android platform
• CB-10096 Upgrade test project to Gradle Plugin 2.1.0
• CB-11292 fix broken MessageChannel after plugins are recreated
• CB-11259 Improving build output
• CB-10096 Upgrading to Gradle Plugin 2.1.0
• CB-11198 Skip android target sdk check. This closes #303.
• CB-11138 Reuse PluginManager from common to add/rm plugins
• CB-11133 Handle android emulator start failure
• CB-11132 Fix Error: Cannot read property match of undefined in cordova-android emulator.js
• Add simple log for package name being deployed
• CB-11015 Error adding plugin with gradle extras
• CB-11095 Fix plugin add/removal when running on Node v.010
• CB-11022 Duplicate www files to both destinations on plugin operations
• CB-10964 Handle build.json file starting with a BOM.
• CB-10963 Handle overlapping permission requests from plugins
• CB-8582 Obscure INSTALL_FAILED_VERSION_DOWNGRADE error when installing app
• CB-10862 Cannot set minsdkversion
• CB-10896 We never enabled cookies on the WebView proper
• CB-10837 Support platform-specific orientation on Android
• CB-10600 cordova run android --release does not use signed and zip-aligned version of APK
• CB-9710 Fixing issues parsing android avd list output for certain AVDs which resulted in them not being included in the selection process even if they are the best match.
• CB-10888 Enable coverage reports collection via codecov
• CB-10846 Add Travis and AppVeyor badges to readme
• CB-10846 Add AppVeyor configuration
• CB-10749 Use cordova-common.CordovaLogger in cordova-android
• CB-10673 fixed conflicting plugin install issue with overlapped <source-file> tag. Add --force flag.
• CB-8976 Removing the auto-version for non-Crosswalk applications
• CB-10768 Use cordova-common.superspawn in GradleBuilder
• CB-10729 Move plugin handlers tests for into platform's repo
• CB-10669 cordova run --list cannot find adb
• CB-10660 fixed the exception when removing a non-existing directory.

5.1.1 (Feb 24, 2016)

• updated cordova-common dependnecy to 1.1.0
• CB-10628 Fix emulate android --target
• CB-10618 Handle gradle frameworks on plugin installation/uninstallation
• CB-10510 Add an optional timeout to emu start script
• CB-10498 Resume event should be sticky if it has a plugin result
• fix HtmlNotFoundTest so that it passes when file not found is handled correctly
• CB-10472 NullPointerException: org.apache.cordova.PluginManager.onSaveInstanceState check if pluginManager is null before using it
• CB-10138 Adds missing plugin metadata to plugin_list module.
• CB-10443 Pass original options instead of remaining
• CB-10443 Fix this.root null reference
• CB-10421 Fixes exception when calling run script with --help option
• updated .gitignore
• CB-10406 Fixes an exception, thrown when building using Ant.
• CB-10157 Uninstall app from device/emulator only when signed apk is already installed

5.1.0 (Jan 19, 2016)

• CB-10386 Add android.useDeprecatedNdk=true to support NDK in gradle
• CB-8864 Fixing this to mitigate CB-8685 and CB-10104
• CB-10105 Spot fix for tilde errors on paths.
• Update theme to Theme.DeviceDefault.NoActionBar
• CB-10014 Set gradle applicationId to package name.
• CB-9949 Fixing menu button event not fired in Android
• CB-9479 Fixing the conditionals again, we should
• CB-8917 New Plugin API for passing results on resume after Activity destruction
• CB-9971 Suppress gradlew _JAVA_OPTIONS output during build
• CB-9836 Add .gitattributes to prevent CRLF line endings in repos
• added node_modules back into .gitignore

5.0.0 (Nov 01, 2015)

• Update CordovaWebViewEngine.java
• CB-9909 Shouldn't escape spaces in paths on Windows.
• CB-9870 updated hello world template
• CB-9880 Fixes platform update failure when upgrading from android@<4.1.0
• CB-9844 Remove old .java after renaming activity
• CB-9800 Fixing contribute link.
• CB-9782 Check in cordova-common dependency
• Adds licence header to Adb to pass rat audit
• CB-9835 Downgrade properties-parser to prevent failures in Node < 4.x
• CB-9782 Implements PlatformApi contract for Android platform.
• CB-9826 Fixed test-build script on windows.
• Refactor of the Cordova Plugin/Permissions API
• Manually updating version to 5.0.0-dev for engine tags
• Bump up to API level 23
• Commiting code to handle permissions, and the special case of the Geolocation Plugin
• CB-9608 cordova-android no longer builds on Node 0.10 or below
• CB-9080 Cordova CLI run for Android versions 4.1.1 and lower throws error
• CB-9557 Fixes apk install failure when switching from debug to release build
• CB-9496 removed permissions added for crosswalk
• CB-9402 Allow to set gradle distubutionUrl via env variable CORDOVA_ANDROID_GRADLE_DISTRIBUTION_URL
• CB-9428 update script now bumps up minSdkVersion to 14 if it is less than that.
• CB-9430 Fixes check_reqs failure when javac returns an extra line
• CB-9172 Improved emulator deploy stability. This closes #188.
• CB-9404 Fixed an exception when path contained -debug or -release
• CB-8320 Setting up gradle so we can use CordovaLib as a standard Android Library
• CB-9185 Fixed an issue when unsigned apks couldn't be found.
• CB-9397 Fixes minor issues with cordova requirements android
• CB-9389 Fixes build/check_reqs hang

Release 4.1.1 (Aug 2015)

• CB-9428 update script now bumps up minSdkVersion to 14 if it is less than that
• CB-9430 Fixes check_reqs failure when javac returns an extra line

Release 4.1.0 (Jul 2015)

• CB-9392 Fixed printing flavored versions. This closes #184.
• CB-9382 [Android] Fix KeepRunning setting when Plugin activity is showed. This closes #200
• CB-9391 Fixes cdvBuildMultipleApks option casting
• CB-9343 Split the Content-Type to obtain a clean mimetype
• CB-9255 Make getUriType case insensitive.
• CB-9149 Fixes JSHint issue introduced by 899daa9
• CB-9372 Remove unused files: 'main.js' & 'master.css'. This closes #198
• CB-9149 Make gradle alias subprojects in order to handle libs that depend on libs. This closes #182
• Update min SDK version to 14
• Update licenses. This closes #190
• CB-9185 Fix signed release build exception. This closes #193.
• CB-9286 Fixes build failure when ANDROID_HOME is not set.
• CB-9284 Fix for handling absolute path for keystore in build.json
• CB-9260 Install Android-22 on Travis-CI
• Adding .ratignore file.
• CB-9119 Adding lib/retry.js for retrying promise-returning functions. Retrying 'adb install' in emulator.js because it sometimes hangs.
• CB-9115 android: Grant Lollipop permission req
• Remove extra console message
• CB-8898 Report expected gradle location properly
• CB-8898 Fixes gradle check failure due to missing quotes
• CB-9080 -d option is not supported on Android 4.1.1 and lower, removing
• CB-8954 Adds requirements command support to check_reqs module
• Update JS snapshot to version 4.1.0-dev (via coho)
• CB-8417 updated platform specific files from cordova.js repo
• Adding tests to confirm that preferences aren't changed by Intents
• Forgot to remove the method that copied over the intent data
• Getting around to removing this old Intent code
• Update JS snapshot to version 4.1.0-dev (via coho)
• Fix CordovaPluginTest on KitKat (start-up events seem to change)
• CB-3360 Allow setting a custom User-Agent (close #162)
• CB-8902 Use immersive mode when available when going fullscreen (close #175)
• Make BridgeMode methods public (they were always supposed to be)
• Simplify: EncodingUtils.getBytes(str) -> str.getBytes()
• Don't show warning when gradlew file is read-only
• Don't show warning when prepEnv copies gradlew and it's read-only
• Make gradle wrapper prepEnv code work even when android-sdk is read-only
• CB-8897 Delete drawable/icon.png since it duplicates drawable-mdpi/icon.png
• Updating the template to target mininumSdkTarget=14
• CB-8894 Updating the template to target mininumSdkTarget=14
• CB-8891 Add a note about when the gradle helpers were added
• CB-8891 Add a gradle helper for retrieving config.xml preference values
• CB-8884 Delete Eclipse tweaks from create script
• CB-8834 Don't fail to install on VERSION_DOWNGRADE
• Automated tools fail, and you have to remember all four places where this is set.
• Update the package.json
• CB-9042 coho failed to update version, so here we are
• CB9042 - Updating Release Notes
• Adding tests to confirm that preferences aren't changed by Intents
• updating existing test code
• Forgot to remove the method that copied over the intent data
• Getting around to removing this old Intent code
• CB-8834 Don't fail to install on VERSION_DOWNGRADE

Release 4.0.2 (May 2015)

• Removed Intent Functionality from Preferences - Preferences can no longer be set by intents

Release 4.0.1 (April 2015)

• Bug fixed where platform failed to install on a version downgrade

Release 4.0.0 (March 2015)

This release adds significant functionality, and also introduces a number of breaking changes. Some of the changes to the code base will be of particular interest to plugin developers.

Major Changes

• Support for pluggable WebViews
  • The system WebView can be replaced in your app, via a plugin
  • Core WebView functionality is encapsulated, with extension points exposed via interfaces
• Support for Crosswalk to bring the modern Chromium WebView to older devices
  • Uses the pluggable WebView framework
  • You will need to add the new cordova-crosswalk-engine plugin
• Splash screen functionality is now provided via plugin
  • You will need to add the new cordova-plugin-splashscreen plugin to continue using a splash screen
• Whitelist functionality is now provided via plugin (CB-7747)
  • The whitelist has been enhanced to be more secure and configurable
  • Setting of Content-Security-Policy is now supported by the framework (see details in plugin readme)
  • You will need to add the new cordova-plugin-whitelist plugin
  • Legacy whitelist behaviour is still available via plugin (although not recommended).

Changes For Plugin Developers:

• Develop in Android Studio
  • Android Studio is now fully supported, and recommended over Eclipse
• Build using Gradle
  • All builds use Gradle by default, instead of Ant
  • Plugins can add their own gradle build steps!
  • Plugins can depend on Maven libraries using <framework> tags
• New APIs: onStart, onStop, onConfigurationChanged
• "onScrollChanged" message removed. Use view.getViewTreeObserver().addOnScrollChangedListener(...) instead
• CB-8702 New API for plugins to override shouldInterceptRequest with a stream

Other Changes

• CB-8378 Removed hidekeyboard and showkeyboard events (apps should use a plugin instead)
• CB-8735 bin/create regex relaxed / better support for numbers
• CB-8699 Fix CordovaResourceApi copyResource creating zero-length files when src=uncompressed asset
• CB-8693 CordovaLib should not contain icons / splashscreens
• CB-8592 Fix NPE if lifecycle events reach CordovaWebView before init() has been called
• CB-8588 Add CATEGORY_BROWSABLE to intents from showWebPage openExternal=true
• CB-8587 Don't allow WebView navigations within showWebPage that are not whitelisted
• CB-7827 Add --activity-name for bin/create
• CB-8548 Use debug-signing.properties and release-signing.properties when they exist
• CB-8545 Don't add a layout as a parent of the WebView
• CB-7159 BackgroundColor not used when <html style="opacity:0">, nor during screen rotation
• CB-6630 Removed OkHttp from core library. It's now available as a plugin: cordova-plugin-okhttp

Release 3.7.1 (January 2015)

• CB-8411 Initialize plugins only after createViews() is called (regression in 3.7.0)

Release 3.7.0 (January 2015)

• CB-8328 Allow plugins to handle certificate challenges (close #150)
• CB-8201 Add support for auth dialogs into Cordova Android
• CB-8017 Add support for <input type=file> for Lollipop
• CB-8143 Loads of gradle improvements (try it with cordova/build --gradle)
• CB-8329 Cancel outstanding ActivityResult requests when a new startActivityForResult occurs
• CB-8026 Bumping up Android Version and setting it up to allow third-party cookies. This might change later.
• CB-8210 Use PluginResult for various events from native so that content-security-policy can be used
• CB-8168 Add support for cordova/run --list (closes #139)
• CB-8176 Vastly better auto-detection of SDK & JDK locations
• CB-8079 Use activity class package name, but fallback to application package name when looking for splash screen drawable
• CB-8147 Have corodva/build warn about unrecognized flags rather than fail
• CB-7881 Android tooling shouldn't lock application directory
• CB-8112 Turn off mediaPlaybackRequiresUserGesture
• CB-6153 Add a preference for controlling hardware button audio stream (DefaultVolumeStream)
• CB-8031 Fix race condition that shows as ConcurrentModificationException
• CB-7974 Cancel timeout timer if view is destroyed
• CB-7940 Disable exec bridge if bridgeSecret is wrong
• CB-7758 Allow content-url-hosted pages to access the bridge
• CB-6511 Fixes build for android when app name contains unicode characters.
• CB-7707 Added multipart PluginResult
• CB-6837 Fix leaked window when hitting back button while alert being rendered
• CB-7674 Move preference activation back into onCreate()
• CB-7499 Support RTL text direction
• CB-7330 Don't run check_reqs for bin/create.

3.6.4 (Sept 30, 2014)

• Set VERSION to 3.6.4 (via coho)
• Update JS snapshot to version 3.6.4 (via coho)
• CB-7634 Detect JAVA_HOME properly on Ubuntu
• CB-7579 Fix run script's ability to use non-arch-specific APKs
• CB-6511 Fixes build for android when app name contains unicode characters.
• CB-7463 Adding licences. I don't know what the gradle syntax is for comments, that still needs to be done.
• CB-7463 Looked at the Apache BigTop git, gradle uses C-style comments
• CB-7460 Fixing bug with KitKat where the background colour would override the CSS colours on the application

3.6.0 (Sept 2014)

• Set VERSION to 3.6.0 (via coho)
• CB-7410 fix the menu test
• CB-7410 Fix the errorUrl test
• CB-7410 Fix Basic Authentication test
• CB-3445 Allow build and run scripts to select APK by architecture
• CB-3445 Add environment variable 'BUILD_MULTIPLE_APKS' for splitting APKs based on architecture
• CB-3445 Ensure that JAR files in libs directory are included
• CB-7267 update RELEASENOTES for 3.5.1
• CB-7410 clarify the title
• CB-7385 update cordova.js for testing prior to branch/tag
• CB-7410 add whitelist entries to get iframe/GoogleMaps working
• CB-7291 propogate change in method signature to the native tests
• CB-7291 Restrict meaning of "*" in internal whitelist to just http and https
• CB-7291 Only add file, content and data URLs to internal whitelist
• CB-7291 Add defaults to external whitelist
• CB-7291 Add external-launch-whitelist and use it for filtering intent launches
• CB-3445 Read project.properties to configure gradle libraries
• CB-7325 Fix error message in android_sdk_version.js when missing SDK on windows
• CB-7335 Add a .gitignore to android project template
• CB-7330 Fix dangling function call in last commit (broke gradle builds)
• CB-7330 Don't run "android update" during creation
• CB-3445 Add gradle support clean command (plus some code cleanup)
• CB-7044 Fix typo in prev commit causing check_reqs to always fail.
• CB-3445 Copy gradle wrapper in build instead of create
• CB-3445 Add .gradle template files for "update" as well as "create"
• CB-7044 Add JAVA_HOME when not set. Be stricter about ANDROID_HOME
• CB-3445 Speed up gradle building (incremental builds go from 10s -> 1.5s for me)
• CB-3445 android: Copy Gradle wrapper from Android SDK rather than bundling a JAR
• CB-3445 Add which to checked-in node_modules
• CB-3445 Add option to build and install with gradle
• CB-3445 Add an initial set of Gradle build scripts
• CB-7321 Don't require ant for create script
• CB-7044, CB-7299 Fix up PATH problems when possible.
• Change in test's AndroidManifest.xml needed for the test to run properly. Forgot the manifest.
• Change in test's AndroidManifest.xml needed for the test to run properly
• Adding tests related to 3.5.1
• CB-7261 Fix setNativeToJsBridgeMode sometimes crashing when switching to ONLINE_EVENT
• CB-7265 Fix crash when navigating to custom protocol (introduced in 3.5.1)
• Filter out non-launchable intents
• Handle unsupported protocol errors in webview better
• CB-7238 I should have collapsed this, but Config.init() must go before the creation of CordovaWebView
• CB-7238 Minor band-aid to get tests running again, this has to go away before 3.6.0 is released, since this is an API change.
• Extend whitelist to handle URLs without // chars
• CB-7172 Force window to have focus after resume
• CB-7159 Set background color of webView as well as its parent
• CB-7018 Fix setButtonPlumbedToJs never un-listening
• Undeprecate some just-deprecated symbols in PluginManager.
• @Deprecate methods of PluginManager that were never meant to be public
• Move plugin instantiation and instance storing logic PluginEntry->PluginManager
• Fix broken unit test due to missing Config.init() call
• Update to check for Google Glass APIs
• Fix for android not being in PATH check on Windows
• Displaying error when regex does not match.
• Fix broken compile due to previous commit :(
• Tweak CordovaPlugin.initialize method to be less deprecated.
• Un-deprecate CordovaActivity.init() - it's needed to tweak prefs in onCreate
• Tweak log messages in CordovaBridge with bridgeSecret is wrong
• Backport CordovaBridge from 4.0.x -> master
• Update unit tests to not use most deprecated things (e.g. DroidGap)
• Add non-String overloades for CordovaPreferences.set()
• Make CordovaWebview resilient to init() not being called (for backwards-compatibility)
• Add node_module licenses to LICENSE
• Update cordova.js snapshot to work with bridge changes
• Provide CordovaPlugin with CordovaPreferences. Add new Plugin.initialize()
• Convert usages of Config.* to use the non-static versions
• Change getProperty -> prefs.get* within CordovaActivity
• Make CordovaUriHelper class package-private
• Fix PluginManager.setPluginEntries not removing old entries
• Move registration of App plugin from config.xml -> code
• Make setWebViewClient an override instead of an overload. Delete Location-change JS->Native bridge mode (missed some of it).
• CB-4404 Revert setting android:windowSoftInputMode to "adjustPan"
• Refactor: Use ConfigXmlParser in activity. Adds CordovaWebView.init()
• Deprecate some convenience methods on CordovaActivity
• Fix CordovaPreferences not correctly parsing hex values (valueOf->decode)
• Refactor: Move url-filter information into PluginEntry.
• Don't re-parse config.xml in onResume.
• Move handling of Fullscreen preference to CordovaActivity
• Delete dead code from CordovaActivity
• Update .classpath to make Eclipse happy (just re-orders one line)
• Delete "CB-3064: The errorUrl is..." Log message left over from debugging presumably
• Refactor Config into ConfigXmlParser, CordovaPreferences
• Delete Location-change JS->Native bridge mode
• CB-5988 Allow exec() only from file: or start-up URL's domain
• CB-6761 Fix native->JS bridge ceasing to fire when page changes and online is set to false and the JS loads quickly
• Update the errorurl to no longer use intents
• This breaks running the JUnit tests, we'll bring it back soon
• Refactoring the URI handling on Cordova, removing dead code
• CB-7018 Clean up and deprecation of some button-related functions
• CB-7017 Fix onload=true being set on all subsequent plugins
• CB-5971 Fix package / project validation
• CB-5971 Add unit tests to cordova-android
• CB-5971 Factor out package/project name validation logic
• Delete explicit activity.finish() in back button handling. No change in behaviour.
• CB-5971 This would have been a good first bug, too bad
• CB-4404 Changing where android:windowSoftInputMode is in the manifest so it works
• Add documentation referencing other implementation.
• CB-6851 Deprecate WebView.sendJavascript()
• CB-6876 Show the correct executable name
• CB-6876 Fix the "print usage"
• Trivial spelling fix in comments when reading CordovaResourceApi
• CB-6818 I want to remove this code, because Square didn't do their headers properly
• CB-6860 Add activity_name and launcher_name to AndroidManifest.xml & strings.xml
• Add a comment to custom_rules.xml saying why we move AndroidManifest.xml
• Remove +x from README.md
• CB-6784 Add missing licenses
• CB-6784 Add license to CONTRIBUTING.md
• Revert "defaults.xml: Add AndroidLaunchMode preference"
• updated RELEASENOTES
• CB-6315 Wrapping this so it runs on the UI thread
• CB-6723 Update package name for Robotium
• CB-6707 Update minSdkVersion to 10 consistently
• CB-5652 make visible cordova version
• Update JS snapshot to version 3.6.0-dev (via coho)
• Update JS snapshot to version 3.6.0-dev (via coho)
• Set VERSION to 3.6.0-dev (via coho)

3.5.1 (August 2014)

This was a security update to address CVE-2014-3500, CVE-2014-3501, and CVE-2014-3502. For more information, see http://cordova.apache.org/announcements/2014/08/04/android-351.html

• Filter out non-launchable intents
• Handle unsupported protocol errors in webview better
• Update the errorurl to no longer use intents
• Refactoring the URI handling on Cordova, removing dead code

3.5.0 (May 2014)

• OkHttp has broken headers. Updating for ASF compliance.
• Revert accidentally removed lines from NOTICE
• CB-6552 added top level package.json
• CB-6491 add CONTRIBUTING.md
• CB-6543 Fix cordova/run failure when no custom_rules.xml available
• defaults.xml: Add AndroidLaunchMode preference
• Add JavaDoc for CordovaResourceApi
• CB-6388 Handle binary data correctly in LOAD_URL bridge
• Fix CB-6048 Set launchMode=singleTop so tapping app icon does not always restart app
• Remove incorrect usage of AlertDialog.Builder.create
• Catch uncaught exceptions in from plugins and turn them into error responses.
• Add NOTICE file
• CB-6047 Fix online sometimes getting in a bad state on page transitions.
• Add another convenience overload for CordovaResourceApi.copyResource
• Update framework's .classpath to what Eclipse wants it to be.
• README.md: android update to android-19.
• Fix NPE when POLLING bridge mode is used.
• Updating NOTICE to include Square for OkHttp
• CB-5398 Apply KitKat content URI fix to all content URIs
• CB-5398 Work-around for KitKat content: URLs not rendering in tags
• CB-5908 add splascreen images to template
• CB-5395 Make scheme and host (but not path) case-insensitive in whitelist
• Ignore multiple onPageFinished() callbacks & onReceivedError due to stopLoading()
• Removing addJavascriptInterface support from all Android versions lower than 4.2 due to security vu
• CB-4984 Don't create on CordovaActivity name
• CB-5917 Add a loadUrlIntoView overload that doesn't recreate plugins.
• Use thread pool for load timeout.
• CB-5715 For CLI, hide assets/www and res/xml/config.xml by default
• CB-5793 ant builds: Rename AndroidManifest during -post-build to avoid Eclipse detecting ant-build/
• CB-5889 Make update script find project name instead of using "null" for CordovaLib
• CB-5889 Add a message in the update script about needing to import CordovaLib when using an IDE.

3.4.0 (Feb 2014)

43 commits from 10 authors. Highlights include:

• Removing addJavascriptInterface support from all Android versions lower than 4.2 due to security vulnerability
• CB-5917 Add a loadUrlIntoView overload that doesn't recreate plugins.
• CB-5889 Make update script find project name instead of using "null" for CordovaLib
• CB-5889 Add a message in the update script about needing to import CordovaLib when using an IDE.
• CB-5793 Don't clean before build and change output directory to ant-build to avoid conflicts with Eclipse.
• CB-5803 Fix cordova/emulate on windows.
• CB-5801 exec->spawn in build to make sure compile errors are shown.
• CB-5799 Update version of OkHTTP to 1.3
• CB-4910 Update CLI project template to point to config.xml at the root now that it's not in www/ by default.
• CB-5504 Adding onDestroy to app plugin to deregister telephonyReceiver
• CB-5715 Add Eclipse .project file to create template. For CLI projects, it adds refs for root www/ & config.xml and hides platform versions
• CB-5447 Removed android:debuggable=“true” from project template.
• CB-5714 Fix of android build when too big output stops build with error due to buffer overflow.
• CB-5592 Set MIME type for openExternal when scheme is file:

3.3.0 (Dec 2013)

41 commits from 11 authors. Highlights include:

• CB-5481 Fix for Cordova trying to get config.xml from the wrong namespace
• CB-5487 Enable Remote Debugging when your Android app is debuggable.
• CB-5445 Adding onScrollChanged and the ScrollEvent object
• CB-5422 Don't require JAVA_HOME to be defined
• CB-5490 Add javadoc target to ant script
• CB-5471 Deprecated DroidGap class
• CB-5255 Prefer Google API targets over android-## targets when building.
• CB-5232 Change create script to use Cordova as a Library Project instead of a .jar
• CB-5302 Massive movement to get tests working again
• CB-4996 Fix paths with spaces while launching on emulator and device
• CB-5209 Cannot build Android app if project path contains spaces

3.2.0 (Nov 2013)

27 commits from 7 authors. Highlights include:

• CB-5193 Fix Android WebSQL sometime throwing SECURITY_ERR.
• CB-5191 Deprecate
• Updating shelljs to 0.2.6. Copy now preserves mode bits.
• CB-4872 Added android version scripts (android_sdk_version, etc)
• CB-5117 Output confirmation message if check_reqs passes.
• CB-5080 Find resources in a way that works with aapt's --rename-manifest-package
• CB-4527 Don't delete .bat files even when on non-windows platform
• CB-4892 Fix create script only escaping the first space instead of all spaces.

3.1.0 (Sept 2013)

55 commits from 9 authors. Highlights include:

• CB-4817 Remove unused assets in project template.
• Fail fast in create script if package name is not com.foo.bar.
• CB-4782 Convert ApplicationInfo.java -> appinfo.js
• CB-4766 Deprecated JSONUtils.java (moved into plugins)
• CB-4765 Deprecated ExifHelper.java (moved into plugins)
• CB-4764 Deprecated DirectoryManager.java (moved into plugins)
• CB-4763 Deprecated FileHelper.java (moved into plugins), Move getMimeType() into CordovaResourceApi.
• CB-4725 Add CordovaWebView.CORDOVA_VERSION constant
• Incrementing version check for Android 4.3 API Level 18
• CB-3542 rewrote cli tooling scripts in node
• Allow CordovaChromeClient subclasses access to CordovaInterface and CordovaWebView members
• Refactor CordovaActivity.init so that subclasses can easily override factory methods for webview objects
• CB-4652 Allow default project template to be overridden on create
• Tweak the online bridge to not send excess online events.
• CB-4495 Modify start-emulator script to exit immediately on a fatal emulator error.
• Log WebView IOExceptions only when they are not 404s
• Use a higher threshold for slow exec() warnings when debugger is attached.
• Fix data URI decoding in CordovaResourceApi
• CB-3819 Made it easier to set SplashScreen delay.
• CB-4013 Fixed loadUrlTimeoutValue preference.
• Upgrading project to Android 4.3
• CB-4198 bin/create script should be better at handling non-word characters in activity name. Patched windows script as well.
• CB-4198 bin/create should handle spaces in activity better.
• CB-4096 Implemented new unified whitelist for android
• CB-3384 Fix thread assertion when plugins remap URIs