Skip to main content

17

Mobile Migration

Starting with M.App Enterprise 17.0, a new mobile client will be delivered. It is based on Microsoft MAUI and attempts to stay backward compatible with your existing shells, but requires M.App Enterprise 17.0 as server version. To avoid breaking existing apps, it will be published as MAE Mobile in the app stores.

M.App Enterprise 16.x -> M.App Enterprise app
M.App Enterprise 17.x -> MAE Mobile app

This guide will help you to transist to the new MAE Mobile app.

Migration steps

  • Prepare a 17.x test environment with a separate master and tenant database
  • Test your existing apps with MAE Mobile app
  • Inform app users to sync their changes and install new MAE Mobile app
  • Upgrade 16.x installation to 17.x

Known compatibility issues

  • JavaScript engine is more strict regarding syntax errors:
//Working in 16.x
Context.setValue('key' 'value');

//Correct syntax
Context.setValue('key', 'value');
  • ListCell DisplaySize behaviour change:
<!-- 16.x -->
<ListCell DisplaySize="Small" /> <!-- Smartphone, Tablet, Desktop -->
<ListCell DisplaySize="Medium" /> <!-- Tablet, Desktop -->
<ListCell DisplaySize="Large" /> <!-- Desktop -->
  
<!-- 17.x -->
<ListCell DisplaySize="Small" /> <!-- Smartphone -->
<ListCell DisplaySize="Medium,Large" /> <!-- Tablet, Desktop -->
<ListCell DisplaySize="Large" /> <!-- Desktop -->