https://github.com/mendix/hybrid-app-base
This repository contains the core files needed to build a Phonegap package for your Mendix application
https://github.com/mendix/hybrid-app-base
Last synced: 14 days ago
JSON representation
This repository contains the core files needed to build a Phonegap package for your Mendix application
- Host: GitHub
- URL: https://github.com/mendix/hybrid-app-base
- Owner: mendix
- Created: 2017-03-21T07:53:14.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2026-02-20T11:07:49.000Z (2 months ago)
- Last Synced: 2026-02-20T15:28:00.446Z (2 months ago)
- Language: JavaScript
- Size: 3.34 MB
- Stars: 9
- Watchers: 4
- Forks: 13
- Open Issues: 34
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 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](https://github.com/mendix/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](https://nodejs.org/en/download/)
- MacOS: use [Brew](https://brew.sh/) 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](https://docs.mendix.com/refguide/custom-settings/#commendixcoreSameSiteCookies) 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](https://github.com/apache/cordova-plugin-wkwebview-engine)
- [Forked library](https://www.npmjs.com/package/@mendix/cordova-plugin-wkwebview-engine-mx) (code is in internal repository)
We implemented XHR request handling using native code, while keeping support for cookies.
### cordova-sqlite-storage
- [Original repository](https://github.com/litehelpers/Cordova-sqlite-storage)
- [Forked repository](https://github.com/mendix/Cordova-sqlite-storage-pgb)
We included the SQLite native libraries.
### phonegap-launch-navigator
- [Original repository](https://github.com/dpa99c/phonegap-launch-navigator)
- [Forked repository](https://github.com/mendix/phonegap-launch-navigator)
We added support for cordova-android 7+.
### phonegap-plugin-push
- [Original repository](https://github.com/phonegap/phonegap-plugin-push)
- [Forked repository](https://github.com/mendix/phonegap-plugin-push)
We unpinned the version of the Android support v13 library.
### cordova-plugin-secure-storage
- [Original repository](https://github.com/Crypho/cordova-plugin-secure-storage)
- [Forked library](https://github.com/mendix/cordova-plugin-secure-storage)
We added support for Android 10
### cordova-plugin-n0sm-file-transfer
- [Original repository](https://github.com/mvinayprasad/cordova-plugin-ns0m-file-transfer)
- [Forked library](https://github.com/mendix/cordova-plugin-ns0m-file-transfer)
We have fixed nested path creation problem for Android.