Skip to content

This repository contains the core files needed to build a Phonegap package for your Mendix application

Notifications You must be signed in to change notification settings

mendix/hybrid-app-base

Repository files navigation

Mendix PhoneGap / Cordova hybrid app base package

This repository contains the core files needed to build a Phonegap package for your Mendix application. It consists of two main parts:

  • The core source files for the hybrid app
  • The webpack configuration that is used during the build process

You should not use this package directly. Instead, refer to the Mendix PhoneGap / Cordova hybrid app template for instructions on how to customize and build your Mendix hybrid mobile app.

Building a templated Phonegap Build package

This project can be used to create a templated Phonegap Build package, as used within the Mobile Publish flow of the Mendix Portal.

Prerequisites

  • Recent Node.js. This code was tested with version 20. You can check by running node -v.
    • Windows: install from nodejs.org
    • MacOS: use Brew to install Node.js: brew install node
    • Linux, BSD, etc: install using the available package manager, e.g. on Debian: sudo apt-get install node
  • To customize the runtime behavior, include the following configuration: Set com.mendix.core.SameSiteCookies to None in Studio Pro.
  • Deploy and test the application using HTTPS.
  • The scheme configuration in config.xml should not be changed to any value other than app for iOS.

Build

$ npm install                       # install dependencies
$ npm run appbase                   # create templated PGB package in `dist`

Mendix-specific forks of Cordova/Phonegap plugins

Mendix hybrid apps include a number of plugins by default. These plugins have been created by the Cordova/Phonegap community. For some of these plugins, we have created Mendix-specific forks. The reason for creating a fork varies per plugin. The list below outlines the details per forked plugin.

cordova-plugin-wkwebview-engine

We implemented XHR request handling using native code, while keeping support for cookies.

cordova-sqlite-storage

We included the SQLite native libraries.

phonegap-launch-navigator

We added support for cordova-android 7+.

phonegap-plugin-push

We unpinned the version of the Android support v13 library.

cordova-plugin-secure-storage

We added support for Android 10