Skip to main content

Delivering Mobile Apps

 

Applies only to Mobile Apps
OutSystems

Generate and Distribute Your Mobile App for Development Tests

While you are developing a mobile app, there will be times when you have completed some work that you want to test on the device and share it with other so they can also test it.

In OutSystems, you can build and generate a mobile application package for your mobile app for test purposes and install it on the device. You can then share the package with other users following iOS/Android distribution process.

You can also test your mobile app on a device using the OutSystems Now app, without having to generate the native application package and install it. You'll be able to execute and preview the plugins supported by OutSystems on your mobile device. OutSystems Now is a mobile app that loads your app in a container and provides a seamless integration between your app and the mobile functionalities. Check how you can preview your mobile app in the device using OutSystems Now.

For iOS

Before You Start

  • To test your app, you must have a certificate of type iOS App Development generated and configured in your Apple Developer account. If you don’t have one, learn how you can create a certificate;

  • To allow launching your app in the devices of the end-users group, you must setup the iOS App Development provisioning profile with the relevant device IDs. 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 registering devices on your Apple Developer account, check the Apple Developer website;  

  • To get the certificate and provisioning profile to generate the iOS app for your mobile app, you must have an Apple Developer account. If you don't, create a new Apple Developer Account.

Generate the iOS App Package (IPA)

You can configure, generate and download an iOS mobile app package of your app for development tests 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 button if you've already generated a previous iOS app;
  3. In the Build type dropdown, select the Development option;
  4. Keep the default app identifier assigned by the platform or write your own (matching reverse domain name notation, e.g. com.domain.appname). You have to register the same app identifier in your Apple Developer Account;
  5. Provide a certificate and a provisioning profile both of type iOS App Development;
  6. Click Generate App.

When the app generation completes, scan the QR code or copy the created installation link using your device to download the iOS package (IPA) and install it.

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 the Development option;
  5. Keep the default app identifier assigned by the platform or write your own (matching reverse domain name notation, e.g. com.domain.appname);
  6. Provide a certificate of type iOS App Development and its password. The certificate should have a .p12 file extension;
  7. Provide an iOS App Development provisioning profile that matches the certificate you provided. 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).

Distribute the App for Development Tests

To share your app with others, send them the QR code generated by Service Studio, the installation link or the app package (IPA) itself.

Have in mind that only selected devices specified for the provisioning profile can install and open the app.

For Android

Before You Start

  • If you want to sign the debug version of your app with a custom keystore (which is an optional step in the procedure below) and you don't have one yet, check how you can create a keystore

Generate the Android App Package (APK)

You can configure, generate and download an Android mobile app package of your app for development tests 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 Debug option;
  4. Keep the default app identifier assigned by the platform or write your own (matching reverse domain name notation, e.g. com.domain.appname);
  5. (Optional step) If you want to use a custom keystore to sign the debug version of your app:
    1. Expand the > Configure Keystore section in the Native Platforms tab;
    2. Select the keystore and introduce the passwords; 
    3. 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;
  6. Click Generate App.

When the app generation completes, scan the QR code or copy the created installation link using your device to download the Android package (APK) and install it.

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 Debug option;
  5. Keep the default app identifier assigned by the platform or write your own (matching reverse domain name notation, e.g. com.domain.appname);
  6. (Optional step) If you want to use a custom keystore to sign the debug version of your app:
    1. Select the keystore and introduce the passwords; 
    2. 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 Save to save your settings;
  8. 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 App for Development Tests

To share your app with others, send them the QR code generated by Service Studio, the installation link or the app package (APK) itself.

In case your device blocks the installation of the app since it was obtained from an unknown source, go to the device settings and allow the installation from unknown sources to fix it.