This article describes how to build an app from your configurator
Building an app consists out of 5 steps:
1. Layout & Settings: set up all artwork, colours and texts
2. Keys: add push notification and sign in keys
3. Certificates: add the certificates
4. Build: submit the build to the queue
5. Test: download a test version of the app to check your build
After all 5 steps have been completed, you will be able to download the final version of the app to submit to the stores.
Each of the 5 steps are detailed below.
1. Layout & Settings
App name on device: this is the app name as is displayed below the icon on the home screen of your device. As you only have a limited number of characters there, try to keep this name short. If it's too long, it will be truncated with three dots on the device.
Version number: for the first version, this number should be 1.0. For other versions, this has to be higher than the previous version, so that the iOS device recognizes that there is an update available. The format should be a number with one decimal, e.g. 1.1, 3.4, 11.5, etc.
Android version code: for the first version, this number should be 1. For other versions, this has to be higher than the previous version, so that the Android device recognizes that there is an update available. The format should be an integer, e.g. 3, 11 or 54.
Software version: this is the version the app is built on. Default, the latest stable version is used. It is not configurable and is just displayed for your reference.
Data version to include in build (single-event apps only): for single-event apps, you can select the data release version that should be included in the build. Users that don't have an internet connection when they open the app, will see the data included in this build. When a connection is available, they can always update to the latest version.
Image guidelines and required formats can be found in the artwork guidelines.
App icon iOS: the icon as displayed on the home screen of iOS devices.
App icon Android: the icon as displayed on the home screen of Android devices.
Welcome screen logo: the logo that is shown while the app is loading. This will be shown on top of a background color that you can configure below Colors.
Primary: used for the app bar on the selection screen, when the user opens the app without having an internet connection. When a connection is available, the color from the Colors modal on the selection screen is used instead.
Contrast: used for icons and other elements throughout the app. Please note that for each event, you can set a different contrast color that will overwrite the one included in the build.
Welcome screen background: The background color behind the welcome screen logo.
Strings are texts that are shown in the app. The strings that can be edited at this point, are all used in the selection screen, before any event is installed. The event strings can be configured within each event.
You can select one of the default languages, and optionally, change the texts. Please note that any changes you've made in a certain language are lost when you select another one!
Images in lists
Here you can set whether you want to see person images and company logos in lists. In case a photo or a logo is not uploaded, a placeholder will be shown.
If you uncheck these option(s), none of the items in the respective list will have a photo, logo or placeholder, even though you might have added them in the data editor. It is therefore advised to only switch this off if you're not adding any person photos or logos at all.
Here you can add custom configurations, that are generally not applicable for most conferences. In case this is needed for your app, we'll let you know how to add it here.
One Signal Push notifications
One Signal is the platform used for sending push notifications to devices with the app installed. In order to integrate with the app correctly, the Sender ID (Google) and App ID (One Signal) keys have to be added.
How these keys should be generated, is explained in another article. Here you only have to copy the values:
App ID: the App ID is the key used to identify the app at the One Signal account. It can be found at OneSignal, under App Settings > Keys & IDs. In the configurator of your app, you fill in the same number. This links the news messages you send from there, to the right app.
Sender ID: the Sender ID is provided by Google. To find it, go to Firebase and select the app. The ID is under the Cloud Messaging tab on the App Settings. Copy only the numbers, the 'str:' prefix will be added automatically.
Google sign in keys
In order to allow Google login through My Congress, the client keys for iOS and Web have to be added. They can be found in Google's developer console under Credentials. Creating the keys is explained in a separate article. Here you just have to copy the values:
Select Add later if you don't have the OneSignal or Google keys yet. Push notifications or Google login will then not work, but you can still test the rest of the app.
For each iOS app, certificates need to be added that classify you as a trusted developer. Different certificates need to be added for the test version as for the Store version.
iOS certificates of test version
After creating the certificates of the test version, you will know what to fill in for each of the fields below.
Test version bundle id: the Bundle ID is used by Apple to identify the app among all others in the App Store. Enter the bundle id of the test version here.
Test version mobileprovision file: the app needs to be configured to launch on devices and use services, and this process is called Provisioning. These configurations are saved in the provisioning profile, a file with extension .mobileprovision, which is used, together with the certificates and bundle ID to sign the app. Make sure to select the .mobileprovision file of the test version.
Test version P12 file: to build and publish the app to the store, a distribution certificate is required. A .p12 file contains the certificates necessary to sign the app during its construction, and only one is necessary for all your apps. Make sure to select the .p12 file of the test version.
P12 password: enter the password of the p12 file, if you've set any. If you didn't, you can leave this empty.
Test version certificate name: enter the certificate name of the test version.
iOS certificates of store version
For the Store version, the fields are the same, but the creating the Store certificates is a bit different. Select Add later if you don't have the iOS certificates of store version yet. The Store version will not be built, but you will still be able to test the app.
In this step, you can choose whether you want to create the screenshots needed for submission. To do so, tick the box and select the event from which to take the event screenshots. Please note your build takes longer to finish if you're creating screenshots, so only check this when you're doing the final build before submission.
Next, submit your build by clicking Submit build. The build will be added to our queue. It takes up to 30 minutes before your build is complete. When the build is ready, you will see green checkmarks and you can continue to the next step.
In case there are errors, try to solve them yourself or contact us if you can't figure out what's wrong.
To test the app, scan the QR code with an iOS or Android device. A page opens where you can click to install the right build for your device.
Depending on the type of certificate you built with and the version of iOS, you will need to take different steps to allow opening the app.
- iOS, built with Ad Hoc certificate: On iOS 16 and up, you will need to enable Developer mode to allow opening the app after installing it. Go to Settings / Privacy & Security > Developer Mode and turn on the toggle. Are you getting the message that the app's integrity could not be verified? Please make sure that your Device ID is added to the provisioning profile.
- iOS, built with Enterprise certificate: Conference Compass should be added to your trusted developers in order to allow installation of the test app. Go to Settings / General / VPN & Device Management after installing the app. Below Enterprise app, select Conference Compass BV and select to trust us.
- Android: Go to Settings / Security and switch on Unknown sources to allow installing apps that are not coming from the Play Store.
When the app has been tested, you can tick the checkbox and finish this last step.
Finishing and creating the submission files
After finishing all 5 steps and testing your app, you will be taken to the starting point in App builds page, where you will find details of the last completed version, including the QR code for the test app and the files that can be downloaded to be submitted to the App Store or submitted to the Play Store. If ticked in the build, you can also download the zip files that include the screenshots.
The properties this app was built with, such as the version numbers or colours, are shown when clicking View build properties.
OS's supported versions
See below on which versions of the mobile Operational Systems our app runs:
Runs on iOS/iPadOS 10 or later
Runs on Android 5 or later