Skip to main content

 

 

 

 

Template:OutSystems/Documentation_KB/Breadcrumb_New_Layout

 

 

Template:OutSystems/OSLanguageSwitcher

 

Applies only to Mobile Apps

 

 

OutSystems

Generate and Distribute Your Mobile App

Template:OutSystems/Documentation_KB/ContentCollaboration
  • Edit
    Collaborate with us
    Edit this page on GitHub
  • Before generating your mobile app for the first time, you have to configure specific iOS and/or Android settings. Check the topics listed at the end of this page for details about different scenarios, such as development tests, distributing your app to a limited group of end users or publishing your app in Mobile App Stores.

    The following sections show how to configure and generate iOS and Android app packages of your mobile apps in Service Studio or in Service Center.

    For additional information about generating and distributing iOS and Android app packages, see More Information on Generating and Distributing Mobile Apps.

    See Distribute as a progressive web app (PWA) for information about the PWA options.

    Configure and Generate a Mobile App Package in Service Studio

    To configure or generate your mobile app package (iOS or Android) in Service Studio, do the following:

    1. Navigate to the app detail screen of your mobile app.

    2. Select the Distribute tab. The native mobile settings are in the Native Platforms section.

    3. When configuring your mobile app for the first time for a given platform (iOS or Android), click on the Configure iOS App or Configure Android App button, according to the platform. Follow the configuration steps for your desired scenario, described in the topics listed at the end of this page. If you have previously defined your mobile app's iOS or Android configuration settings, click on the cog icon for the correct platform to change your configuration.

    4. After defining or changing your mobile app iOS or Android settings, click on the Generate App button.

      Native app settings in Service Studio

    Configure and Generate a Mobile App Package in Service Center

    To configure or generate your mobile app package (iOS or Android) in Service Center, do the following:

    1. Open the Service Center console of the environment (https://<environmentdomain>/ServiceCenter) and navigate to Factory.

    2. Click on the Applications tab, open your mobile app from the app list, then select the Distribute tab. The native mobile settings are in the Native Platforms section.

      Native app settings in Service Center

    3. To configure your mobile app package for the first time or to change the current configuration for a given platform (iOS or Android), click on the Configure link for the iOS or Android entry. Follow the configuration steps for your desired scenario, described in the topics listed at the end of this page.

      Android settings in Service Center

    4. After defining or changing your mobile app iOS or Android settings, click on the Save button.

    5. At the end of the configuration settings page, select the MABS version you wish to use for generating the mobile app package for the mobile platform you're configuring (iOS or Android) in the current environment.

      For more information about MABS check Choosing the MABS Version to Build Your Mobile Packages

    6. Click Save and Generate and wait a few moments while OutSystems generates your mobile app package.

    Now that you have configured the app, the next time you need to generate a new mobile app package, just click the Generate button.

    Customizing the Mobile App Domain Name

    This feature is only available in OutSystems on-premises installations.

    For some cases, you might need to change the domain name associated with your mobile app, like when you have internal security policies dictating that different mobile apps should have different associated domain names and SSL certificates.

    You can customize the domain name for each mobile app in Service Center. By default, OutSystems uses the hostname set for the environment in Administration > Environment Configuration.

    Note: The domain name set for your mobile app should match the Common Name (CN) or a Subject Alternative Name (SAN) specified in the SSL certificate you have configured in your web server for serving HTTPS requests.

    To define a different domain name for your mobile app, do the following:

    1. In the Distribute tab, under the section Native Platforms, click the Change link in the Domain Name column.

      Hostname settings for mobile apps

    2. Enter the new domain name for the mobile app and click Apply.

    3. Regenerate the mobile app for the changes to take effect.

    Customizing the Mobile App Version Code

    The mobile app version code is an internal number associated with the generation of the mobile app package. App stores use this number to determine whether one version is more recent than another. See more detailed information in Android and iOS documentation.

    By default, OutSystems increments the version code by one every time the MABS generates the mobile app package.

    For some cases, you might need to change the default mobile app version code. For example, if you are migrating an existing mobile app from other technology to OutSystems, the current version code of your app in the app store is higher than the first OutSystems app version code. In this case, you can set the version code of your OutSystems mobile app to a different value.

    To set a different version code for your mobile app, do the following:

    1. In the Distribute tab, under the section Native Platforms, click the Change link in the Code column for the iOS or Android entry.

      App code version settings for mobile apps

    2. Enter the new code for the mobile app and click Apply.

    The next time you generate a new app package, the version code increments by one.

    Choosing the MABS Version to Build Your Mobile Packages

    The Mobile Apps Build Service (MABS) is a cloud service used by OutSystems to generate the mobile packages of your mobile apps developed in OutSystems for iOS and Android.

    MABS is continuously improved and OutSystems regularly makes available new versions of this cloud service. However, you might not want to use the latest version, since different MABS versions support different mobile stacks and therefore different ranges of devices and mobile platform versions.

    You can select the MABS version used to generate the mobile packages by mobile app and by mobile platform (iOS and Android), for a given environment. You can do this in Service Center at the app level.

    To choose a MABS version do the following:

    1. In Service Center, click on the Applications tab, open your mobile app from the app list and select the Distribute tab. The native mobile settings are in the Native Platforms section.

    2. In the Settings column, click on the Configure link for the iOS or Android entry.

      Mobile app settings screen

    3. At the end of the configuration settings page, select the MABS version you wish to use for generating the mobile app package for the mobile platform you're configuring (iOS or Android) in the current environment, either the latest available version or a specific version (see below for details).

      Mobile Apps Build Service (MABS) version selection)

      Note: The MABS version selection is only available for apps whose native platform settings are already configured.

    4. Click Save and Generate and wait a few moments while OutSystems generates your mobile app package.

    When choosing a MABS version you have the following options available:

    • Always use the latest version available: Always use the most recent MABS version available to generate the mobile package of the app for the current platform and in the current environment.

    • Specific version (select from list): Generate mobile app packages (in the current environment) with the MABS version selected from the list.

    Whether you selected the option of using the latest MABS version or using a specific MABS version for the app package generation, when you generate and tag a mobile app version, OutSystems records the MABS version used to generate the mobile package.

    To fully understand the impacts of this setting, be sure to check Understanding MABS Versions.

    Download Mobile App Build Logs

    You can obtain the build logs of your mobile apps in Service Center. Build logs are available for both successful and unsuccessful builds, and each platform (Android and iOS) has its own build log.

    To obtain a mobile app build log:

    1. Access the Service Center of the environment (https://<environmentdomain>/ServiceCenter).
    2. Go to Factory and click the Applications tab.
    3. Click your mobile app name to navigate to the mobile app detail page.
    4. In the Distribute tab, under the Native Platforms section, click the log icon for the desired platform to download the build log.

    Updating Your Mobile App Package

    In most occasions, the users of your mobile app don't have to update it manually after installing it in their devices, since OutSystems automatically pushes the updates to their devices when you publish a new mobile app version.

    However, in some specific situations, the users must install a new mobile app package. For more information check Mobile App Update Scenarios.

    Distribute your app as PWA

    You can use the settings in Service Center to configure your app as progressive web app (PWA). PWAs run from your server and don't require distribution though the app stores.

    For more information check out Distribute as a progressive web app (PWA).

    To set an app for the PWA distribution in Service Center, do the following:

    1. Open the Service Center console of the environment (https://<environmentdomain>/ServiceCenter) and navigate to Factory.

    2. Click on the Applications tab, open your mobile app from the app list, then select the Distribute tab. The PWA settings are in the Progressive Web Application (PWA) section.

      PWA settings in Service Center

    3. Select the checkbox Distribute as PWA, then click on Apply.

    Articles in this Section

    • Was this article helpful?