The Mobile App page enables publishing your app in the Apple App Store (for iOS) and Google Play Store (for Android).
This page is divided into three tabs:
- App Info
2 App Info
In this tab, you can find the following sections:
- General settings
- Profile settings
- Custom Phonegap/Cordova configuration
2.1 General Settings
In the General settings section, you must provide the following information:
- The Name of the app
- The unique App Identifier (for example,
- A Description of the app
- Whether a 5 digit PIN is enabled or disabled via the PIN required? check box
2.2 Profile Settings
If you are targeting Mendix 7.2.0 or above, please specify the navigation profiles to use on phones and tablets.
Make sure the profile identifier corresponds with the one defined in Mendix Studio Pro.
- Phone profile
- Tablet profile
- Enable offline capabilities? (available offline apps)
For more information, see Availability in Offline.
By default, Mendix hybrid applications require a set of device permissions. When users install the app or open the app for the first time, they will be asked to grant these permissions. You can use the check boxes below to control which permissions are requested.
The permissions that can be enabled/disabled:
- Photo Library
Some functionality might not be available when you disable these permissions (for example, your app will not be able to use the camera widget when you disable it).
2.4 Custom Phonegap/Cordova Configuration
You can specify additional Phonegap/Cordova settings and plugins by adding an XML snippet below. This snippet will be inserted at the bottom of the configuration file.
For an overview of available elements and settings, refer to Apache Cordova Phonegap Reference Config.xml.
3 iOS & Android
In these tabs, you will see an overview of all the images that will be used in the app store. The images are divided into two categories:
- Splash screens
The following image formats are supported: PNG, GIF, JPEG, and BMP. PNG is recommended, as it is compressed without loss of any information and supports transparency very well.
If you click Edit, you can replace the image by uploading a new file with the same dimensions as the original file.
If you do not upload any images, the default Mendix-branded images that are shown will continue to be used.
Take note of the required resolutions and file types for the image files, as the system will not allow you to upload images with different resolutions (because your app packages will not function properly).
4 Publish for Mobile App Stores
On the right side of the screen, you can choose which operating system you want to publish (iOS or Android).
When you are ready to build, click Publish for Mobile App Stores.
This wizard will guide you through the process of creating app packages for the Apple App Store and Google Play Store. These packages can be built using Adobe’s PhoneGap Build service. The resulting mobile apps can then access native functionality such as the geo location service and the camera.
You need an account for Adobe PhoneGap Build and for the app stores in which you want to publish your app.
There are two ways that the device can build the packages:
- Build it in the cloud
- Do it yourself
4.1 Building It in the Cloud
Building in the cloud uses the PhoneGap Build service from Adobe. Unfortunately, Adobe no longer maintains this service. As a result, as of April 30th 2020, iOS apps built through the platform or using the PhoneGap Build service are not being accepted on Apple’s App Store.
After selecting the Build in the cloud option and choosing the correct environment, you are ready to start the PhoneGap build.
When you click Start PhoneGap Build job, Mendix will generate an Adobe PhoneGap Build package and send it to the PhoneGap Build service on your behalf. You might be required to authorize this request using an Adobe PhoneGap Build account.
As soon as the build job has completed, the platform-specific packages will be ready for download.
Please note that an Adobe PhoneGap Build account is required to continue. Create an account if you do not have one already.
4.2 Doing It Yourself
After selecting the Do it yourself option and choosing the correct environment, click Download a customizable package. The package contains all your settings, icons, and splash screens. It allows you to easily make changes, create local builds, run on emulators, and upload to the PhoneGap Build service.
/dist folder, you’ll find a pre-compiled Adobe PhoneGap Build package for your app. You can upload this package directly to the PhoneGap Build service to obtain platform-specific app packages. Those packages can then be published in the app stores.
You can freely customize the generated package to enable, for example, additional PhoneGap/Cordova plugins or add additional resources to your app. For more information, see Customizing PhoneGap Build Packages.
For detailed instructions, see the hybrid-app-template GitHub repository.
To generate the Android Google Play package, go to Build.PhoneGap.com.
For iOS please follow the instrcutions bellow.
4.3 Building Your iOS App Locally
- A Mac OSX machine
- Install NodeJS LTS using the all-in-one installation option
- Download Do it yourself package from Cloud Portal and unzip it in a known location
- Register for an Apple Developer Account
- Install XCode and its command-line tools
4.3.1 Prepare Your Project for Building
To prepare your project for building, follow these instructions:
- Open a terminal window and change directory into the unzipped package folder, for example cd /Downloads/phonegap if it is in your Downloads folder.
npm i && npm run package && npm run platform:ios. This combination of commands does the following:
- Installs all required dependencies.
- Packages the Cordova app for deployment.
- Adds the iOS platform to Cordova.
4.3.2 Building Your Prepared Project
There are two possible ways to build your apps: the Cordova CLI or XCode. The Cordova CLI is faster and allows Cordova to fully control the your project’s configuration. XCode is more involved, but XCode’s UI makes it easier to detect problems in the project. You can use whichever works best for your case.
220.127.116.11 Building iOS Using the Corodova CLI
- Your Apple Developer team’s id, which can be found here
This process is shorter than using XCode but might require more work to understand why a build fails. To build using the Cordova CLI, do the following:
npm run build -- ios --release --device --codeSignIdentity="iPhone Developer" --developmentTeam="<your-teams-id>". This combination of commands does the following:
- Starts a release build that will create binaries for a physical device
- Uses the code sign identity “iPhone Developer” for signing
- Looks up the provisioning files and certificates using the provided Apple Developer’s team id
1.1 Optionally, if you wish to build for an emulator and do a debug build use the following command instead:
npm run build -- ios --debug --emulator.
When the build succeeds the generated IPA file can be found in /build/platforms/ios/build. That folder should have the following file structure(if you did a build for an emulator an .app file will be available):
The IPA generated can be now uploaded to Testflight for further testing. If you wish to do so, continue with the Upload tools section, on the App Store documenation.
18.104.22.168 Building iOS using XCode
Using XCode can be easier than the Cordova CLI due to XCode’s friendly visual interface. To build your app using XCode do the following:
1. Under /build/platforms/ios/ open the
.xcworkspace file by double-clicking it. Xcode should open with the project loaded:
Select the root element from the tree view in the left-side panel:
The screen should change to the following view. If it does not, select the item under Targets on the left panel not the item under Project and select the tab Signing & Certificates:
Both Debug and Release might have been configured for Automatically manage signing. Clear both check boxes to switch to manual signing. The screen should change to the following:
Enable Automatically manage signing again.
Select a Team using the drop-down menu. If you have not yet signed in with your credentials, XCode will prompt you to do so.
When configured correctly all errors should be gone.
Make sure you select the target to be your app’s build target and designate Generic iOS Device as a device:
Select Product and then Archive from the menu bar:
After the process finishes successfully the Organizer view will come up. Your app should be selected and your latest Archive visible. You can always open the organizer yourself through XCode’s Window menu:
You can now use the Distribute App button to distribute your app to the appstore or archive it for local distribution:
How to build a PhoneGap app in the cloud