We are preparing a new source of documentation for you. Work in progress!

Custom mobile apps

From Resco's Wiki
Jump to: navigation, search
Branding and customization

Use the Mobile Apps section of Woodford if you want to have your own branded application available on application stores (Play Store and App Store).

Branded application can have a custom name and brand information, as well as custom icons. Icons are used in the application itself, in the device application menu, or in store.

Creating a new configuration

  1. On the Administration menu in Woodford, click Mobile Apps. The main page shows a list of all existing mobile app configurations of your organization. Use it for creating new and managing your existing configurations (edit, delete, request build, or download application build files).
  2. Click New to open a window that holds all configuration data. The window is divided into three tabs – General, Android, and iOS.
  3. Enter the details on all tabs and click Save.

General tab

The General tab has common information that apply for both platforms. Fields marked with an asterisk (*) are mandatory, others are optional. Mandatory fields with missing data are highlighted when you try saving configuration without setting mandatory fields.

Application Title
Title of the application visible in the app menu on device. Max 32 characters.
Package Name
Represents unique ID of the application package. Only a-z, A-Z, 0-9, and period (.) are available. Example: user.organization.appname (lucia.resconet.promoapp). It is read-only after save.
URL Scheme
It is generated from Package Name. It can be modified.
Email
Email address of the person responsible for mobile application build configuration. This person will receive emails about build process (approval, completion, or denial).
Application Background Color
Color used to colorize icons with transparent background. This applies on Android versions 8+.
Manufacturer
Company name or other identification of application owner
Application About Title
Descriptive application title will be used in email communication and in the About section of the app.
Application Subtitle
Subtitle / short description of the application will be displayed in the About section of the app.


Select Set default sync dialog information (optional) if you want to configure parameters that become the default values in the synchronization window within the app, so that users don’t have to type them manually. However, you cannot set a default email address and password.

Organization URL
Default URL for synchronization
User mode
Default user mode
Domain, Home Realm, ADFS User Name
Please contact Resco support if you want to use these parameters.
Hide User Mode
Select if you want to hide user mode selection in the app.
Hide Organization URL
Select if you want to hide organization’s URL in the app.
Save Password
Select if you want to save password automatically.

Android tab

Check Set Android Configuration if you wish to build an application for Android devices. Enabling this setting reveals Android icons section.

All icons must be in PNG format and they must have the required size in pixels (px). Also, ensure that the background color of the icons is transparent, or the build won’t be successful. Keep in mind that you are adding one icon with different dimensions and transparency.

Launcher icons can be easily generated using URL link Custom icon generator for Android. It opens a simple app for generating icons.

These are the different types of icons that you must provide:

  • Icons for old version of Android: Android version 7 and older need full-color icons to be used in the Android application. Since we support compatibility from version 5, full-color icon must be added to configuration in all requested sizes.
  • Icons for Android version 8+: Transparent images are used in the applications from Android version 8. These icons use app’s background color and add it to icons’ background. Add transparent icons in all sizes.
  • Common icons: The notification and splash icons are common for all versions.

iOS tab

Check Set iOS Configuration if you wish to build an application for iOS devices. Enabling this setting reveals iOS icons section.

All icons must be in PNG format and they must have the required size in pixels (px). Also, ensure that the background color of the icons is transparent, or the build won’t be successful. Keep in mind that you are adding one icon with different dimensions and transparency.

In this case, icons with transparent background get background color calculated by iOS OS.

If you want to bypass the application store, if you want to distribute the application to your enterprise users by using a mobile device management tool, you need to perform additional configuration to have the app signed correctly:

  • iOS Signing Certificate (.p12 file)
  • iOS Signing Password
  • iOS Provision Profile (.mobileprovision file)

Requesting a build

Once you have completed the configuration, added all icons, and saved the configuration, it has Draft status. This status means that the configuration is editable, and a build hasn’t been requested. To request build, click Request.

Note By clicking Request you are officially asking for application build. This is paid service. Contact Resco sales for more information.

You will receive a confirmation email about this request, and later also emails about approval, denial, and completion.

Downloading application files

Once build is complete, you can download application files using the Download button. This button opens a window with all builds available for the selected configuration. Use separate Android and iOS download links. Links are available only for the platform that you have selected in the configuration.

Download links are also sent to the email address entered in the configuration. These links are valid only for 7 days. After this period, you must request renewal of the links by clicking Request Renewal. Renewal isn’t immediate, it takes some time. Check the links later that day.

When links expire, the build remains visible, but the links are not.

Statuses and their meaning

Draft
New configuration which is saved but has not been requested yet. It is possible to Edit, Request or Delete such a configuration.
Existing and already requested or completed configuration which is changed, and these changes are saved. If this configuration has already been requested and built before, it is not possible to delete it.
Requested
Configuration which is saved and requested. In this state, it is not possible to delete, edit or request build for this configuration. It is possible to download its already completed builds.
Approved
Configuration which has been approved and its build is being processed. Shortly download links will be available. Notification email is sent to responsible person.
Completed
Configuration build is completed, and application files are available for download. Notification email is sent to responsible person. Once user edits configuration in this state, it becomes Draft again.
Denied
Configuration build request was denied. You will be contacted shortly with more information.

See also