Overview
Manage mobile app updates with ease using the Mobile Install Manager. Control when updates are required or optional, notify users of new versions, and ensure everyone stays on supported releases for a smooth and secure app experience.
Require Update - Situations when the user must install a new build
Optional Upgrade - New features/functionality
Application Composition
Applications & Libraries
Mobile Install Manager - End-user application
Open Id Connector - Library module used to wrap the consumption of the ODC Authentication and Authorization API
Portfolio API Connector - Library module used to wrap the consumption of the Portfolio API
Database Model - Mobile Install Manager
Roles
Single MobileInstallManager role provides full application functionality.
Settings
App:Setting
Description
Data Type
Mobile Install Manager:BatchSize
Limit for ODC REST APIs, max is 100
Integer
MobileInstallManager:CipherKey
Cipher key used to store the access token locally. Used for accessing Portfolio API Connector.
Text
Open Id Connector:ClientId
Client Id
Note: Can optionally use the same API Client in each stage (if API client has full range of stage permissions).
Open Id Connector:ClientSecret
Client Secret
Open Id Connector:TenantDomain
Tenant Domain (ex: mytenant.outsystems.dev).
Note: Same URL as when accessing ODC Portal, does not change between stages.
Note: For configuring Open ID Connector, please refer to documentation.
Timers
Timer Name
Schedule
Sync_StageAssets
Synchronizes Mobile Assets
Daily 23:55 UTC
API Client(s)
Can configure one API Client with all the appropriate permissions or one API Client per stage. Need to assign at least Stage > View stage permission for the Portfolio API. Mobile Install Manager Application leverages the ‘deployed-assets’ and ‘environments’ endpoints.
Roll-out plan - Apps to be deployed
App Name
Mobile Install Manager
Post Deploy Configurations
Application
Name
Update
Run Sync_StageAssets
How To Consume in Mobile App
Add Service Action ‘ServiceActionLocalVersionCheck’ to your mobile app
Get asset key for your mobile app
Can view the Asset Id/Key in URL on configuration manager or in URL on ODC Portal. The Asset Id/Key is unique across stages and does not change (unlike app name potentially).
Note: Instead of hardcoding/setting, can use JavaScript API to fetch applicationKey.
Configure on Splash screen for your mobile application
Redirect to Update Screen
Note: For example purposes, we are using one screen for require update and update available. For your implementation, you can show/display whatever you would like (ex. could open the app store immediately on update required.)
Future Enhancements
Only supports up to 100 mobile apps. ODC REST APIs have a max value of 100 returned results. Plan on implementing pagination for ODC Rest APIs.
The ODC REST APIs do not expose the application versions. When the new feature is added, will plan on dynamically pulling in the application versions for configuration (ie. no need to manually specify the application version).
Disclaimer
Mobile Install Manager application is only intended for native mobile apps, not PWAs. To test end-to-end, you must generate a mobile app package for iOS or Android and install on your local device.