Hybrid App

Last update: Download PDF Edit

These are the release notes for the Hybrid App.

The version numbers for each release refer to the Hybrid App Base and Hybrid App Template packages, respectively.

If you’re building the app using the regular PhoneGap Build approach from within the Mendix Developer Portal, you do not need to worry about these numbers. Downloading and building a new package will set you up with the latest version.

If you’re using the advanced flow, you can get the latest version of the Hybrid App Base by running npm update from your hybrid app project directory. To upgrade to the latest version of the Hybrid App Template, either pull in the latest changes from GitHub, or download a new copy from the Mendix Cloud Portal (Developer Portal > DEPLOY).

2018

March 13th, 2018 (2.0.1 / 2.0.0)

This patch release fixes an issue with an upstream dependency (com.android.support:support-v4) that was updated by Google. The issue prevents building .apk files, both locally and on Phonegap Build.

March 9th, 2018 (2.0.0 / 2.0.0)

  • We added support for custom theming:
    • You can configure the image on the error screen by adding/replacing error.png.
    • You can configure the colors (background/foreground/text) of the error dialog box, login screen, and pin screen by adjusting parameters.json.
    • You can adjust the HTML and CSS of the loading screen by configuring loader.html.snippet and loader.css.snippet.
  • We now properly set the page title based on the name value in parameters.json.

January 31st, 2018 (1.7.4 / 1.4.0)

  • We fixed the issue where NPM updates failed consistently. This issue was related to the recently added local PhoneGap dependency. This local dependency is now removed. PhoneGap should be installed globally, and it should match the CLI version configured in the config.xml (for example, npm install -g phonegap@7.1.0). During NPM install/update, there will be feedback in the console regarding the current and required versions.
  • We removed the package-lock.json files from both mendix-hybrid-app-base as well as mendix-hybrid-app-template. This makes it easier to stay up to date with the latest mendix-hybrid-app-base package.
  • Example files for the config.xml.mustache and the index.html.mustache files are now created during NPM install/update.
  • We removed the obsolete dependencies related to webpack.

January 30th, 2018 (1.7.3 / 1.3.5)

  • We removed the Cordova console plugin. This plugin was obsolete and caused issues while building iOS packages.

January 23rd, 2018 (1.7.2 / 1.3.5)

  • We updated the package-lock.json file to fix the issue where an old version of mendix-hybrid-app-base was being used.

January 17th, 2018 (1.7.2 / 1.3.4)

  • We added a cachebust to the synchronizePackage call so that a fresh copy of the static files is downloaded only when needed.
  • We upgraded the Phonegap CLI version used to 7.1.0.
  • We upgraded the cordova-build-architecture plugin to the latest version, which fixes the issue with setting up a local platform for the PhoneGap project.
  • We added npm as a dev dependency to make local builds more robust.

2017

December 22nd, 2017 (1.7.0 / 1.3.3)

  • We renamed the command prepare to prepare:all, because it conflicted with the npm command of the same name.
  • We updated the README with a table of contents and a list of known issues.

December 2nd, 2017 (1.7.0 / 1.3.2)

  • We updated some of the Cordova plugins to support the new iPhone X screen size/ratio/notch. Please follow the instructions in iPhone X Support to configure your hybrid app to look good on an iPhone X.
  • We improved how Android splash screens are configured. The old configuration could lead to memory-related crashes during startup.

November 16th, 2017 (1.6.0 / 1.3.1)

  • Android icons and splash screens are now properly configured. For projects using the “do it yourself” workflow, apply the following change in src/config.xml.mustache:

    • Change:
    <{{{tag}}} src="{{{filename}}}" qualifier="{{{qualifier}}}"/>
    


    to:

    <{{{tag}}} src="{{{filename}}}" density="{{{qualifier}}}"/>
    
  • We removed the superfluous error message in case of a failed PIN login.

  • We fixed the issue where static files would synchronize on every startup, when static resources from disk was enabled in the Mendix project.

  • In earlier versions, mobile apps with offline mode enabled would show a dialog box when a new version of the Mendix app was available. We changed this behavior to always update on startup. This prevents inconsistencies that can occur when the user decides to update the mobile app at a later moment.

October 27th, 2017 (1.5.0 / 1.3.1)

  • In some cases, it was possible to avoid the PIN login prompt. This release mitigates those cases. For hybrid apps that have PIN login enabled, upgrading to this release is highly recommended.

October 17th, 2017 (1.4.3 / 1.3.1)

  • Support for custom navigation profiles was removed. This affects Mendix apps running on version 7.2 or 7.3. For these apps, upgrading to a newer Mendix version is recommended.

October 13th, 2017 (1.4.2 / 1.3.1)

  • We added extra Phonegap commands (plugin and prepare).
  • We added a devDependency to fix the failing build in some cases.
  • We fixed the issue where some cleanup steps were skipped when the removal of cookies and/or PIN/login tokens failed.

October 12th, 2017 (1.4.1 / 1.3.0)

  • We fixed the wrong application of Promise.all, which broke the PIN flow.
  • We fixed the appbase command, used internally to build the Phonegap Build zip file.

October 11th, 2017 (1.4.0 / 1.3.0)

  • This release improves support for the PIN login feature:
    • We updated the Phonegap CLI version to 7.0.1.
    • We improved support for switching users in combination with the PIN login feature.
    • We fixed an issue with the remaining session data.

September 25th, 2017 (1.3.0 / 1.3.0)

  • Based on feedback from the Mendix community, we decided to iterate on the command set that is at your disposal while building your Mendix hybrid mobile app. For instructions on how to use the updated commands, refer to the Mendix PhoneGap Build App Template README.

September 20th, 2017 (1.3.0 / 1.2.0)

  • We added support for iOS 11 (ticket 56209). For existing hybrid apps, you can also update the cordova-plugin-wkwebview-engine-nextgen plugin in the config.xml to version to 1.1.0 and publish again.
  • We changed the keyboard type on the PIN login page to tel. (Ticket 54380)

August 28th, 2017 (1.2.0 / 1.2.0)

  • Whenever a new version of your Mendix application is deployed, the hybrid app will now ask the user to confirm that they are ready to update.

August 25th, 2017 (1.1.2 / 1.1.1)

  • We fixed the “malformed JSON” issue.
  • We removed the dependency on the BlueBird library.
  • We updated to Webpack 3.

August 1st, 2017 (1.1.0 / 1.1.0)

  • You can now automatically log in if credentials are provided.
  • We replaced the SQLite library with our own fork.

June 13th, 2017 (1.0.7 / 1.0.3)

  • The build for Android ARM is now by default.

June 13th, 2017 (1.0.6 / 1.0.3)

  • We now facilitate the overriding of entry.js.

June 13th, 2017 (1.0.5 / 1.0.3)

  • We cleaned up the resources folder.

June 13th, 2017 (1.0.4 / 1.0.3)

  • We fixed the issue where the package.json was removed on cleanup.

June 13th, 2017 (1.0.3 / 1.0.3)

  • WkWebview is now enabled by default.
  • We fixed the issues with UglifyJS and added the NPM5 lockfile.

June 13th, 2017 (1.0.2 / 1.0.2)

  • We fixed the resource paths and the debug mode.

June 13th, 2017 (1.0.1 / 1.0.1)

  • There are now more iOS icons.
  • We improved the documentation.
  • We fixed the image URLs in WkWebview.

June 13th, 2017 (1.0.0 / 1.0.0)

  • There is now a new Mendix Hybrid App package format.