Get Familiar with the Flows Component by a Wizard-Generated Application

Open the project you previously created using the SAP BTP SDK Wizard for Android.

In Android Studio, on Windows, press Ctrl+N, or, on a Mac, press command+O, and type WelcomeActivity to open WelcomeActivity.java.

On Windows, press Ctrl+F12, or, on a Mac, press command+F12, and type startFlow to move to the startFlow method. To start the onboarding process, firstly create a FlowContext instance that contains the information required by the flow, such as the application information, the status of multi-user mode, the flow state listener, etc. Then call the start method of the Flow class to start the onboarding flow, allowing the entire onboarding process to be handled automatically.

!

Notice that by default, the type of a flow is FlowType.ONBOARDING. To start a different type of flow, such as a Change Passcode flow, the client code must specify the flow type in the FlowContext instance. Besides the parameters specified above, there are also many other parameters in the FlowContext class that can be modified to allow the client code to customize a flow. When the values of the parameters are not specified in the client code, the default values will be used. The details of all parameters in the FlowContext class will be explained in subsequent tutorials.

FlowStateListener is a parameter in the FlowContext class. Using the callbacks defined in the listener, client code can insert logic at certain points during the flow process. For example, after the client policy is retrieved, the client code can retrieve the information that will be used by the app. In Android Studio, on Windows, press Ctrl+N, or, on a Mac, press command+O, and type WizardFlowStateListener to open WizardFlowStateListener.java. This class is a sample implementation for the callbacks defined in the FlowStateListener class. The details of FlowState and FlowStateListener will be explained in subsequent tutorials.

Open the project you previously created using the SAP BTP SDK Wizard for Android.

In Android Studio, on Windows, press Ctrl+N, or, on a Mac, press command+O, and type WelcomeActivity to open WelcomeActivity.kt.

On Windows, press Ctrl+F12, or, on a Mac, press command+F12, and type startFlow to move to the startOnboarding method. To start the onboarding process, firstly create a FlowContext instance that contains the information required by the flow, such as the application information, the status of multi-user mode, the flow state listener, etc. Then call the start method of the Flow class to start the onboarding flow, allowing the entire onboarding process to be handled automatically.

!

Notice that by default, the type of a flow is FlowType.ONBOARDING. To start a different type of flow, such as a Change Passcode flow, the client code must specify the flow type in the FlowContext instance. Besides the parameters specified above, there are also many other parameters in the FlowContext class that can be modified to allow the client code to customize a flow. When the values of the parameters are not specified in the client code, the default values will be used. The details of all parameters in the FlowContext class will be explained in subsequent tutorials.

FlowStateListener is a parameter in the FlowContext class. Using the callbacks defined in the listener, client code can insert logic at certain points during the flow process. For example, after the client policy is retrieved, the client code can retrieve the information that will be used by the app. In Android Studio, on Windows, press Ctrl+N, or, on a Mac, press command+O, and type WizardFlowStateListener to open WizardFlowStateListener.kt. This class is a sample implementation for the callbacks defined in the FlowStateListener class. The details of FlowState and FlowStateListener will be explained in subsequent tutorials.