The Project Configuration Page¶
Specify a name for your project as well as the project namespace and location. You can also use this page to configure features such as push notification and logging.
When you select Finish to generate your new app, the Wizard connects to the SAP Cloud Platform to register your app and send your app configuration settings.
Discovery Service Support¶
The SAP Discovery Service simplifies the user onboarding process by letting you distribute initial configuration data to a mobile app.
If you enable the Discovery Service, the app is published to the discovery service during app generation. The service domain is then downloaded from the server and generated into the application.
If the app was previously published, it is re-published using the default configuration options.
During onboarding, your app users are prompted to enter their e-mail address or a short code. Once they have done so, the app downloads the required initial configuration.
To use a short code, you must configure the Discovery Service on the SAP Cloud Platform. See Discovery Service Overview for more information.
If you decide not to use the Discovery Service, the Wizard creates a JSON file containing app configuration and includes it with the app during generation. During onboarding, the app uses the File Provider to read JSON file and configure the app.
Discovery Service is not supported on Cloud Foundry. If your account is on a Cloud Foundry, Use Discovery Service for Application Bootstrapping check box is disabled.
Push notification requires Firebase. To configure your app to use Firebase, create a FireBase Account, configure Push service for your app, and download the JSON file (
google-sevices.json) containing the push configuration.
You must also configure the server to use push. See Android Push Notifications for more information.
Type a name for your project in the Project Name field. The name cannot contain special characters except for the underscore (_) character.
When you type a name, the Wizard appends the project name to the end of the project namespace.
If required, type another unique ID for your project in the Project Namespace field.
The project namespace cannot contain white spaces or special characters.
Type a path for your project in the Project Location field.
You can also select a path and folder for your project using the browse (...) button.
To use the Discovery Service to deliver initial configuration during onboarding, enable Use Discovery Service for Application Bootstrapping.
If you disable this option, the app uses the File Provider to provide initial configuration.
To generate UI for the app, select Generate Master-Detail Application.
The For Destination field displays the destination configured in the OData Services page. If there is more than one destination configured, the destinations are provided in a list. If required, select a destination from the list.
If you clear this checkbox, the Wizard generates a project with only basic functionality such as onboarding and proxy classes but without code for UI, logging, or push notifications.
Onboarding screens are still present, but the master-detail UI is replaced with a very simple "Hello world" which the user can replace or customize.
To have your generated app log information during runtime, select Enable Logging.
Logging information is stored on the app. To upload stored logs to the cloud platform, select Enable Log Upload.
To have your generated app accept push notifications, select Enable Push, then upload the
google-services.jsonthat you obtained from the Firebase website.
The package name in the JSON file must match the project namespace.