Add a Restore Flow

Add the following code into the class in MainActivity.java.

public void startRestoreFlow() {
    LOGGER.debug("startRestoreFlow: starting restore flow");
    flowContext = new OnboardingContext();

    // Creating flow and configuring steps
    Flow flow = new Flow("restore");
    flow.setSteps(new Step[]{
            new PasscodePolicyStoreStep(),    // Opens the passcode policy store (RLM_SECURE_STORE)
            new StoreManagerStep(),           // Opens the application store (APP_SECURE_STORE)
            new WelcomeScreenStoreStep(),     // Reads the previously stored config data and adds it to the context
            new SettingsStoreStep(),          // Reads the previously stored passcode policy and adds it to the context
            new BasicAuthStep(),              // Creates an instance of the OKHttpClient
            new BasicAuthStoreStep(),         // Restores the authentication data from the application store
            settingsDownloadStep,             // Get the client policy data from the server
            new LoggingStep(),                // available in 2.0.1+
            new ChangePasscodeStep(),         // If required by a change in client policy, display the change passcode screen
            eulaScreenStep                    // Presents the EULA screen if the EULA version has been updated
    });

    // Preparing the flow context
    flowContext.setContext(getApplication());
    flowContext.setFlowPresentationActionHandler(new FlowPresentationActionHandlerImpl(this));

    flowManagerService.execute(flow, flowContext, new FlowActionHandler() {
        @Override
        public void onFailure(Throwable t) {
            // flowManagerService failed to execute so will show error dialog
            LOGGER.debug("Failed to restore: " + t);
            showAlertDialog("Restore", t);
        }

        @Override
        public void onSuccess(FlowContext result) {
            initializeLogging(flowContext.getPolicy().getLogLevel());  // TODO remove when https://support.wdf.sap.corp/sap/support/message/1980000361 is fixed
            // flowManagerService executed successfully so remove the splash screen and replace it with the actual working app screen
            getSupportActionBar().show();
            setContentView(R.layout.activity_main);
            LOGGER.debug("Successfully restored");
            LOGGER.warn("Log level after restore is: " + Logging.getRootLogger().getLevel().toString());
        }
    });
}

This reloads the configurations from the app’s state and shows the screen where users have to input their passcode. Notice that the order of the steps is different from the onboard flow. The suggested order of steps is covered at Flow Types.

Find the method onServiceConnected and replace the line startOnboardingFlow(); with the below code.

if (isOnboarded) {
    LOGGER.debug("ServiceConnected: going to start restore flow");
    startRestoreFlow();
} else {
    LOGGER.debug("ServiceConnected: going to start onboarding flow");
    startOnboardingFlow();
}

This code segment determines if the user had already been shown the Onboarding flow. If they have, then the Restore flow is taken, otherwise the Onboarding flow is taken. The isOnboarding variable is stored in the passcode policy store in order to be persisted between application restarts.