Skip to main content

Delivering Mobile Apps

 

Applies only to Mobile Apps
OutSystems

Generate and Publish Your Mobile App to the Mobile App Stores

At some point your mobile app will be ready for production and so, to be used by end-users. One of the ways you can distribute your production-ready mobile app is by providing it in the mobile stores for the general public.

In OutSystems, you can generate a mobile application package for your mobile app to be published in the App Store and Google Play stores. Note that if you enrolled in the Apple Enterprise Developer Program, you will need to distribute your mobile app outside the App Store to your company's end-users. 

For iOS

You can only publish your app to the App Store if you enrolled in the Apple Developer Program.

If you enrolled in the Apple Enterprise Developer Program, you can generate a release version of your app (without debug information) using an In-House provisioning profile, but you will have to handle the app distribution on your own. You can do this by sending the installation link or the app package (IPA) itself, or by using an internal enterprise store or an MDM (Mobile Device Management) solution.  

Before You Start

To generate the release version of your iOS mobile app:

  • You must be enrolled as an Apple Developer. If you haven’t enrolled yet, learn how to enroll as an Apple Developer;

  • You must also have a certificate generated and configured in your Apple Developer account. The exact type of certificate depends on the developer program you enrolled in:
    App Store and Ad Hoc certificate for Apple Developer Program; or
    In-House and Ad Hoc certificate for Apple Developer Enterprise Program.
    If you don’t have one, learn how you can create a certificate;

  • You will need a provisioning profile according to the developer program you enrolled in:
    — App Store provisioning profile for the Apple Developer Program, or
    In-House provisioning profile for the Apple Developer Enterprise Program.
    A provisioning profile allows your application to be launched on Apple devices and use app services. If you don't have one, learn how you can create a provisioning profile.
    For more information on the different provisioning profiles, check the Medium blog post “Cruising through the Complexities of Signing Native Mobile Apps” by OutSystems;

Additionally, you will need to run Application Loader, an application only available for Mac, to submit the app to the App Store for distribution. This application is available for Mac running OS X 10.9 or later and can be obtained by installing the latest Xcode development IDE from Apple.

Generate the iOS App Package (IPA)

You can generate the release (final) version of your mobile app in Service Studio or in Service Center.

To use Service Studio, do the following:

  1. Go to the app detail screen of the mobile application for which you want to generate the mobile application package. Open the Native Platforms tab;
  2. Click on the Configure iOS App button or the iOS cog icon if you've already generated a previous iOS app;
  3. In the Build type dropdown, select App Store (for Apple Developer Program) or In-House (for Apple Developer Enterprise Program);
  4. Keep the default app identifier assigned by OutSystems or write your own (matching reverse domain name notation, e.g. com.domain.appname);
  5. Provide a certificate of the correct type (see “Before You Start”) and its password. The certificate should have a .p12 extension;
  6. Provide a provisioning profile of the correct type (see “Before You Start”). The provisioning profile should have a .mobileprovision extension;
  7. Click Generate App.

After the generation has been completed, scan the QR code or copy the created installation link using your device to download the generated iOS app package (IPA). 

To use Service Center, do the following:

  1. Access Service Center of the environment (https://<environmentdomain>/ServiceCenter);
  2. Go to Factory, click on the Applications tab and open your application from the applications list;
  3. Select the Native Platforms tab and click on the Configure link for the iOS entry;
  4. In the Build type dropdown, select App Store (for Apple Developer Program) or In-House (for Apple Developer Enterprise Program);
  5. Keep the default app identifier assigned by OutSystems or write your own (matching reverse domain name notation, e.g. com.domain.appname);
  6. Provide a certificate of the correct type (see “Before You Start”) and its password. The certificate should have a .p12 extension;
  7. Provide a provisioning profile of the correct type (see “Before You Start”). The provisioning profile should have a .mobileprovision extension;
  8. Click Save to save your settings;
  9. Click Generate and wait a few moments while the app is being generated.

After the app is generated, click the download icon near the version information to download the iOS app package (IPA).

Submit the Mobile App to the App Store

Only available if you enrolled in the Apple Developer Program.

After generating the iOS app package (IPA) you can submit it to the App Store. Note that initially the app will be held for review by Apple before it’s made available in the App Store. 

To submit your app to the App Store:

  1. Get the Application Loader app from Apple (only available for Mac running OS X 10.9 or later). Application Loader is an Apple tool to help you prepare and submit your apps for distribution through the App Store. It’s available for download in the “Resources and Help” section of iTunes Connect, or you can launch it directly from the Xcode app, if you have Xcode installed on your Mac;
  2. Run the Application Loader app and enter your Apple ID and password;
  3. Select the Deliver Your App option;
  4. Provide your generated app package file (IPA) when asked, and complete the app submission according to the instructions presented in Application Loader. 

For Android

Before You Start

Generate the Android App Package (APK)

You can generate the release (final) version of your mobile app in Service Studio or in Service Center.

To use Service Studio, do the following:

  1. Go to the app detail screen of the mobile application for which you want to generate the mobile application package. Open the Native Platforms tab;
  2. Click on the Configure Android App button or the Android cog icon button if you've already generated a previous Android app;
  3. In the Build type dropdown, select the Release option;
  4. Keep the default app identifier assigned by OutSystems or write your own (matching reverse domain name notation, e.g. com.domain.appname);
  5. Select the keystore to sign your app and introduce the passwords. If you don't have a keystore to sign your Android apps, check how to do it;
  6. Fill in the alias name and password of the private/public key pair to use. The alias you must use is the one generated when creating the keystore;
  7. Click Generate App.

After the generation has been completed, scan the QR code or copy the created installation link using your device to download the generated Android app package (APK).

To use Service Center, do the following:

  1. Access Service Center of the environment (https://<environmentdomain>/ServiceCenter);
  2. Go to Factory, click on the Applications tab and open your application from the applications list;
  3. Select the Native Platforms tab and click on the Configure link for the Android entry;
  4. In the Build type dropdown, select the Release option;
  5. Keep the default app identifier assigned by OutSystems or write your own (matching reverse domain name notation, e.g. com.domain.appname);
  6. Select the keystore to sign your app and introduce the passwords. If you don't have a keystore to sign your Android apps, check how to do it;
  7. Fill in the alias name and password of the private/public key pair to use. The alias you must use is the one generated when creating the keystore;
  8. Click Save to save your settings;
  9. Click Generate and wait a few moments while the app is being generated.

After the app is generated, click the download icon near the version information to download the Android app package (APK).

Distribute the Mobile App through the Google Play store

After the generation has been completed, scan the QR code or copy the created installation link using your device to download the Android app package (APK). Then you only need to access to the Google Developer Account to upload the mobile app.