@mendix/mendix-hybrid-app-base

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

• Original repository
• Forked library (code is in internal repository)

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

cordova-sqlite-storage

• Original repository
• Forked repository

We included the SQLite native libraries.

phonegap-launch-navigator

• Original repository
• Forked repository

We added support for cordova-android 7+.

phonegap-plugin-push

• Original repository
• Forked repository

We unpinned the version of the Android support v13 library.

cordova-plugin-secure-storage

• Original repository
• Forked library

We added support for Android 10

cordova-plugin-n0sm-file-transfer

• Original repository
• Forked library

We have fixed nested path creation problem for Android.