Restore and Reset Applications Using the Flows Component

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 SettingsFragment to open SettingsFragment.java.

On Windows, press Ctrl+F12, or, on a Mac, press command+F12, and type onCreatePreferences to move to the onCreatePreferences method. To start the flow to reset the application, set the flow type to FlowType.RESET for the FlowContext instance, and then start the flow with this FlowContext instance. The entire process to reset application will be handled automatically.

When the reset flow is started, the default behavior, is for a dialog to be displayed, asking the user for confirmation.

You can customize your client code so that the reset flow hides this dialog by overriding the isResetConfirmationNeeded function of the FlowOptions instance to return false and set this FlowOptions instance for the FlowContext instance to start the reset flow.

FlowContext flowContext = new FlowContextBuilder()
            .setFlowType(FlowType.RESET)
            .setFlowOptions(new FlowOptions(){
                @Override
                public boolean isResetConfirmationNeeded() {
                    return false;
                }
            }).build();
Flow.start(this, flowContext);

Before removing all the data managed by the Flows component, the reset flow will notify the ApplicationReset event. You can use the onApplicationReset callback of the FlowStateListener instance to insert its own logic for application reset, for example to clear the data managed by the client code and un-register the push token.

In Android Studio, on Windows, press Ctrl+N, or, on a Mac, press command+O, and type WizardFlowStateListener to open WizardFlowStateListener.java. On Windows, press Ctrl+F12, or, on a Mac, press command+F12, and type onApplicationReset to move to the onApplicationReset method.

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 SettingsFragment to open SettingsFragment.kt.

On Windows, press Ctrl+F12, or, on a Mac, press command+F12, and type onCreatePreferences to move to the onCreatePreferences method. To start the flow to reset application, set the flow type to FlowType.RESET for the FlowContext instance, and then start the flow with this FlowContext instance. The entire process to reset application will be handled automatically.

When the reset flow is started, the default behavior is for a dialog to be displayed, asking the user for confirmation.

You can customize your client code so that the reset flow hides this dialog by setting the value of needConfirmWhenReset parameter to false for the FlowOptions instance and set this FlowOptions instance for the FlowContext instance to start the reset flow.

val flowContext =
        FlowContextBuilder()
                .setFlowType(FlowType.RESET)
                .setFlowOptions(FlowOptions(
                        needConfirmWhenReset = false
                ))
                .build()
Flow.start(this, flowContext)

Before removing all the data managed by the Flows component, the reset flow will notify the ApplicationReset event. You can use the onApplicationReset callback of the FlowStateListener instance to insert its own logic for application reset, for example to clear the data managed by the client code and un-register the push token.

In Android Studio, on Windows, press Ctrl+N, or, on a Mac, press command+O, and type WizardFlowStateListener to open WizardFlowStateListener.kt. On Windows, press Ctrl+F12, or, on a Mac, press command+F12, and type onApplicationReset to move to the onApplicationReset method.