src/com/android/settings/biometrics/BiometricEnrollIntroduction.java - LeafOS-Project/android_packages_apps_Settings - Gitiles

 /*
  * Copyright (C) 2018 The Android Open Source Project
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
  * You may obtain a copy of the License at
  *
  *      http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License
  */

 package com.android.settings.biometrics;

 import android.app.admin.DevicePolicyManager;
 import android.content.Intent;
 import android.graphics.PorterDuff;
 import android.graphics.PorterDuffColorFilter;
 import android.hardware.biometrics.BiometricAuthenticator;
 import android.os.Bundle;
 import android.os.UserHandle;
 import android.os.UserManager;
 import android.util.Log;
 import android.view.View;
 import android.widget.TextView;

 import androidx.annotation.NonNull;
 import androidx.annotation.Nullable;
 import androidx.annotation.StringRes;
 import androidx.annotation.VisibleForTesting;

 import com.android.internal.widget.LockPatternUtils;
 import com.android.settings.R;
 import com.android.settings.SetupWizardUtils;
 import com.android.settings.password.ChooseLockGeneric;
 import com.android.settings.password.ChooseLockSettingsHelper;
 import com.android.settings.password.SetupSkipDialog;

 import com.google.android.setupcompat.template.FooterBarMixin;
 import com.google.android.setupcompat.template.FooterButton;
 import com.google.android.setupcompat.util.WizardManagerHelper;
 import com.google.android.setupdesign.GlifLayout;
 import com.google.android.setupdesign.span.LinkSpan;
 import com.google.android.setupdesign.template.RequireScrollMixin;
 import com.google.android.setupdesign.util.DynamicColorPalette;

 /**
  * Abstract base class for the intro onboarding activity for biometric enrollment.
  */
 public abstract class BiometricEnrollIntroduction extends BiometricEnrollBase
         implements LinkSpan.OnClickListener {

     private static final String TAG = "BiometricEnrollIntroduction";

     private static final String KEY_CONFIRMING_CREDENTIALS = "confirming_credentials";
     private static final String KEY_SCROLLED_TO_BOTTOM = "scrolled";

     private GatekeeperPasswordProvider mGatekeeperPasswordProvider;
     private UserManager mUserManager;
     private boolean mHasPassword;
     private boolean mBiometricUnlockDisabledByAdmin;
     private TextView mErrorText;
     protected boolean mConfirmingCredentials;
     protected boolean mNextClicked;
     private boolean mParentalConsentRequired;
     private boolean mHasScrolledToBottom = false;

     @Nullable private PorterDuffColorFilter mIconColorFilter;

     /**
      * @return true if the biometric is disabled by a device administrator
      */
     protected abstract boolean isDisabledByAdmin();

     /**
      * @return the layout resource
      */
     protected abstract int getLayoutResource();

     /**
      * @return the header resource for if the biometric has been disabled by a device administrator
      */
     protected abstract int getHeaderResDisabledByAdmin();

     /**
      * @return the default header resource
      */
     protected abstract int getHeaderResDefault();

     /**
      * @return the description for if the biometric has been disabled by a device admin
      */
     protected abstract String getDescriptionDisabledByAdmin();

     /**
      * @return the cancel button
      */
     protected abstract FooterButton getCancelButton();

     /**
      * @return the next button
      */
     protected abstract FooterButton getNextButton();

     /**
      * @return the error TextView
      */
     protected abstract TextView getErrorTextView();

     /**
      * @return 0 if there are no errors, otherwise returns the resource ID for the error string
      * to be displayed.
      */
     protected abstract int checkMaxEnrolled();

     /**
      * @return the challenge generated by the biometric hardware
      */
     protected abstract void getChallenge(GenerateChallengeCallback callback);

     /**
      * @return one of the ChooseLockSettingsHelper#EXTRA_KEY_FOR_* constants
      */
     protected abstract String getExtraKeyForBiometric();

     /**
      * @return the intent for proceeding to the next step of enrollment. For Fingerprint, this
      * should lead to the "Find Sensor" activity. For Face, this should lead to the "Enrolling"
      * activity.
      */
     protected abstract Intent getEnrollingIntent();

     /**
      * @return the title to be shown on the ConfirmLock screen.
      */
     protected abstract int getConfirmLockTitleResId();

     /**
      * @param span
      */
     public abstract void onClick(LinkSpan span);

     public abstract @BiometricAuthenticator.Modality int getModality();

     protected interface GenerateChallengeCallback {
         void onChallengeGenerated(int sensorId, int userId, long challenge);
     }

     @Override
     protected void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);

         if (savedInstanceState != null) {
             mConfirmingCredentials = savedInstanceState.getBoolean(KEY_CONFIRMING_CREDENTIALS);
             mHasScrolledToBottom = savedInstanceState.getBoolean(KEY_SCROLLED_TO_BOTTOM);
             mLaunchedPostureGuidance = savedInstanceState.getBoolean(
                     EXTRA_LAUNCHED_POSTURE_GUIDANCE);
         }

         Intent intent = getIntent();
         if (intent.getStringExtra(WizardManagerHelper.EXTRA_THEME) == null) {
             // Put the theme in the intent so it gets propagated to other activities in the flow
             intent.putExtra(
                     WizardManagerHelper.EXTRA_THEME,
                     SetupWizardUtils.getThemeString(intent));
         }

         mBiometricUnlockDisabledByAdmin = isDisabledByAdmin();

         setContentView(getLayoutResource());
         mParentalConsentRequired = ParentalControlsUtils.parentConsentRequired(this, getModality())
                 != null;
         if (mBiometricUnlockDisabledByAdmin && !mParentalConsentRequired) {
             setHeaderText(getHeaderResDisabledByAdmin());
         } else {
             setHeaderText(getHeaderResDefault());
         }

         mErrorText = getErrorTextView();

         mUserManager = getUserManager();
         updatePasswordQuality();

         // Check isFinishing() because FaceEnrollIntroduction may finish self to launch
         // FaceSettings during onCreate()
         if (!mConfirmingCredentials && !isFinishing()) {
             if (!mHasPassword) {
                 // No password registered, launch into enrollment wizard.
                 mConfirmingCredentials = true;
                 launchChooseLock();
             } else if (!BiometricUtils.containsGatekeeperPasswordHandle(getIntent())
                     && mToken == null) {
                 // It's possible to have a token but mLaunchedConfirmLock == false, since
                 // ChooseLockGeneric can pass us a token.
                 mConfirmingCredentials = true;
                 launchConfirmLock(getConfirmLockTitleResId());
             }
         }

         final GlifLayout layout = getLayout();
         mFooterBarMixin = layout.getMixin(FooterBarMixin.class);
         mFooterBarMixin.setPrimaryButton(getPrimaryFooterButton());
         mFooterBarMixin.setSecondaryButton(getSecondaryFooterButton(), true /* usePrimaryStyle */);
         mFooterBarMixin.getSecondaryButton().setVisibility(
                 mHasScrolledToBottom ? View.VISIBLE : View.INVISIBLE);

         final RequireScrollMixin requireScrollMixin = layout.getMixin(RequireScrollMixin.class);
         requireScrollMixin.requireScrollWithButton(this, getPrimaryFooterButton(),
                 getMoreButtonTextRes(), this::onNextButtonClick);
         requireScrollMixin.setOnRequireScrollStateChangedListener(
                 scrollNeeded -> {
                     boolean enrollmentCompleted = checkMaxEnrolled() != 0;
                     if (!enrollmentCompleted) {
                         // Update text of primary button from "More" to "Agree".
                         final int primaryButtonTextRes = scrollNeeded
                                 ? getMoreButtonTextRes()
                                 : getAgreeButtonTextRes();
                         getPrimaryFooterButton().setText(this, primaryButtonTextRes);
                     }

                     // Show secondary button once scroll is completed.
                     if (!scrollNeeded) {
                         if (!enrollmentCompleted) {
                             getSecondaryFooterButton().setVisibility(View.VISIBLE);
                         }
                         mHasScrolledToBottom = true;
                     }
                 });
     }

     @Override
     protected void onResume() {
         super.onResume();

         final int errorMsg = checkMaxEnrolled();
         if (errorMsg == 0) {
             mErrorText.setText(null);
             mErrorText.setVisibility(View.GONE);
             getNextButton().setVisibility(View.VISIBLE);
         } else {
             mErrorText.setText(errorMsg);
             mErrorText.setVisibility(View.VISIBLE);
             getNextButton().setText(getResources().getString(R.string.done));
             getNextButton().setVisibility(View.VISIBLE);
             getSecondaryFooterButton().setVisibility(View.INVISIBLE);
         }
     }

     @Override
     protected void onSaveInstanceState(Bundle outState) {
         super.onSaveInstanceState(outState);
         outState.putBoolean(KEY_CONFIRMING_CREDENTIALS, mConfirmingCredentials);
         outState.putBoolean(KEY_SCROLLED_TO_BOTTOM, mHasScrolledToBottom);
     }

     @Override
     protected boolean shouldFinishWhenBackgrounded() {
         return super.shouldFinishWhenBackgrounded() && !mConfirmingCredentials && !mNextClicked;
     }

     @VisibleForTesting
     @NonNull
     protected GatekeeperPasswordProvider getGatekeeperPasswordProvider() {
         if (mGatekeeperPasswordProvider == null) {
             mGatekeeperPasswordProvider = new GatekeeperPasswordProvider(getLockPatternUtils());
         }
         return mGatekeeperPasswordProvider;
     }

     @VisibleForTesting
     protected UserManager getUserManager() {
         return UserManager.get(this);
     }

     @VisibleForTesting
     @NonNull
     protected LockPatternUtils getLockPatternUtils() {
         return new LockPatternUtils(this);
     }

     private void updatePasswordQuality() {
         final int passwordQuality = getLockPatternUtils()
                 .getActivePasswordQuality(mUserManager.getCredentialOwnerProfile(mUserId));
         mHasPassword = passwordQuality != DevicePolicyManager.PASSWORD_QUALITY_UNSPECIFIED;
     }

     @Override
     protected void onNextButtonClick(View view) {
         mNextClicked = true;
         if (checkMaxEnrolled() == 0) {
             // Lock thingy is already set up, launch directly to the next page
             launchNextEnrollingActivity(mToken);
         } else {
             boolean couldStartNextBiometric = BiometricUtils.tryStartingNextBiometricEnroll(this,
                     ENROLL_NEXT_BIOMETRIC_REQUEST, "enrollIntroduction#onNextButtonClicked");
             if (!couldStartNextBiometric) {
                 setResult(RESULT_FINISHED);
                 finish();
             }
         }
         mNextLaunched = true;
     }

     private void launchChooseLock() {
         Intent intent = BiometricUtils.getChooseLockIntent(this, getIntent());
         intent.putExtra(ChooseLockGeneric.ChooseLockGenericFragment.HIDE_INSECURE_OPTIONS, true);
         intent.putExtra(ChooseLockSettingsHelper.EXTRA_KEY_REQUEST_GK_PW_HANDLE, true);
         intent.putExtra(getExtraKeyForBiometric(), true);
         if (mUserId != UserHandle.USER_NULL) {
             intent.putExtra(Intent.EXTRA_USER_ID, mUserId);
         }
         startActivityForResult(intent, CHOOSE_LOCK_GENERIC_REQUEST);
     }

     private void launchNextEnrollingActivity(byte[] token) {
         Intent intent = getEnrollingIntent();
         if (token != null) {
             intent.putExtra(ChooseLockSettingsHelper.EXTRA_KEY_CHALLENGE_TOKEN, token);
         }
         if (mUserId != UserHandle.USER_NULL) {
             intent.putExtra(Intent.EXTRA_USER_ID, mUserId);
         }
         BiometricUtils.copyMultiBiometricExtras(getIntent(), intent);
         intent.putExtra(EXTRA_FROM_SETTINGS_SUMMARY, mFromSettingsSummary);
         intent.putExtra(EXTRA_KEY_CHALLENGE, mChallenge);
         intent.putExtra(EXTRA_KEY_SENSOR_ID, mSensorId);
         startActivityForResult(intent, BIOMETRIC_FIND_SENSOR_REQUEST);
     }

     /**
      * Returns the intent extra data for setResult(), null means nothing need to been sent back
      */
     @Nullable
     protected Intent getSetResultIntentExtra(@Nullable Intent activityResultIntent) {
         return activityResultIntent;
     }

     @Override
     protected void onActivityResult(int requestCode, int resultCode, Intent data) {
         Log.d(TAG,
                 "onActivityResult(requestCode=" + requestCode + ", resultCode=" + resultCode + ")");
         final boolean cameFromMultiBioFpAuthAddAnother =
                 requestCode == BiometricUtils.REQUEST_ADD_ANOTHER
                 && BiometricUtils.isMultiBiometricFingerprintEnrollmentFlow(this);
         if (requestCode == BIOMETRIC_FIND_SENSOR_REQUEST) {
             if (isResultFinished(resultCode)) {
                 handleBiometricResultSkipOrFinished(resultCode, getSetResultIntentExtra(data));
             } else if (isResultSkipped(resultCode)) {
                 if (!BiometricUtils.tryStartingNextBiometricEnroll(this,
                         ENROLL_NEXT_BIOMETRIC_REQUEST, "BIOMETRIC_FIND_SENSOR_SKIPPED")) {
                     handleBiometricResultSkipOrFinished(resultCode, data);
                 }
             } else if (resultCode == RESULT_TIMEOUT) {
                 setResult(resultCode, data);
                 finish();
             }
         } else if (requestCode == CHOOSE_LOCK_GENERIC_REQUEST) {
             mConfirmingCredentials = false;
             if (resultCode == RESULT_FINISHED) {
                 updatePasswordQuality();
                 final boolean handled = onSetOrConfirmCredentials(data);
                 if (!handled) {
                     overridePendingTransition(R.anim.sud_slide_next_in, R.anim.sud_slide_next_out);
                     getNextButton().setEnabled(false);
                     getChallenge(((sensorId, userId, challenge) -> {
                         mSensorId = sensorId;
                         mChallenge = challenge;
                         mToken = BiometricUtils.requestGatekeeperHat(this, data, mUserId,
                                 challenge);
                         BiometricUtils.removeGatekeeperPasswordHandle(this, data);
                         getNextButton().setEnabled(true);
                     }));
                 }
             } else {
                 setResult(resultCode, data);
                 finish();
             }
         } else if (requestCode == CONFIRM_REQUEST) {
             mConfirmingCredentials = false;
             if (resultCode == RESULT_OK && data != null) {
                 final boolean handled = onSetOrConfirmCredentials(data);
                 if (!handled) {
                     overridePendingTransition(R.anim.sud_slide_next_in, R.anim.sud_slide_next_out);
                     getNextButton().setEnabled(false);
                     getChallenge(((sensorId, userId, challenge) -> {
                         mSensorId = sensorId;
                         mChallenge = challenge;
                         mToken = BiometricUtils.requestGatekeeperHat(this, data, mUserId,
                                 challenge);
                         BiometricUtils.removeGatekeeperPasswordHandle(this, data);
                         getNextButton().setEnabled(true);
                     }));
                 }
             } else {
                 setResult(resultCode, data);
                 finish();
             }
         } else if (requestCode == LEARN_MORE_REQUEST) {
             overridePendingTransition(R.anim.sud_slide_back_in, R.anim.sud_slide_back_out);
         } else if (requestCode == ENROLL_NEXT_BIOMETRIC_REQUEST
                 || cameFromMultiBioFpAuthAddAnother) {
             if (isResultFinished(resultCode)) {
                 handleBiometricResultSkipOrFinished(resultCode, data);
             } else if (isResultSkipped(resultCode)) {
                 if (requestCode == BiometricUtils.REQUEST_ADD_ANOTHER) {
                     // If we came from an add another request, it still might
                     // be possible to add another biometric. Check if we can.
                     if (checkMaxEnrolled() != 0) {
                         // If we can't enroll any more biometrics, than skip
                         // this one.
                         handleBiometricResultSkipOrFinished(resultCode, data);
                     }
                 } else {
                     handleBiometricResultSkipOrFinished(resultCode, data);
                 }
             } else if (resultCode != RESULT_CANCELED) {
                 setResult(resultCode, data);
                 finish();
             }
         }
         super.onActivityResult(requestCode, resultCode, data);
     }

     private static boolean isResultSkipped(int resultCode) {
         return resultCode == RESULT_SKIP
                 || resultCode == SetupSkipDialog.RESULT_SKIP;
     }

     private static boolean isResultFinished(int resultCode) {
         return resultCode == RESULT_FINISHED;
     }

     private static boolean isResultSkipOrFinished(int resultCode) {
         return isResultSkipped(resultCode) || isResultFinished(resultCode);
     }

     protected void removeEnrollNextBiometric() {
         getIntent().removeExtra(MultiBiometricEnrollHelper.EXTRA_ENROLL_AFTER_FACE);
         getIntent().removeExtra(MultiBiometricEnrollHelper.EXTRA_ENROLL_AFTER_FINGERPRINT);
     }

     protected void removeEnrollNextBiometricIfSkipEnroll(@Nullable Intent data) {
         if (data != null
                 && data.getBooleanExtra(
                         MultiBiometricEnrollHelper.EXTRA_SKIP_PENDING_ENROLL, false)) {
             removeEnrollNextBiometric();
         }
     }
     protected void handleBiometricResultSkipOrFinished(int resultCode, @Nullable Intent data) {
         removeEnrollNextBiometricIfSkipEnroll(data);
         if (resultCode == RESULT_SKIP) {
             onEnrollmentSkipped(data);
         } else if (resultCode == RESULT_FINISHED) {
             onFinishedEnrolling(data);
         }
     }

     /**
      * Called after confirming credentials. Can be used to prevent the default
      * behavior of immediately calling #getChallenge (useful to things like intro
      * consent screens that don't actually do enrollment and will later start an
      * activity that does).
      *
      * @return True if the default behavior should be skipped and handled by this method instead.
      */
     protected boolean onSetOrConfirmCredentials(@Nullable Intent data) {
         return false;
     }

     protected void onCancelButtonClick(View view) {
         finish();
     }

     protected void onSkipButtonClick(View view) {
         onEnrollmentSkipped(null /* data */);
     }

     protected void onEnrollmentSkipped(@Nullable Intent data) {
         setResult(RESULT_SKIP, data);
         finish();
     }

     protected void onFinishedEnrolling(@Nullable Intent data) {
         setResult(RESULT_FINISHED, data);
         finish();
     }

     protected void updateDescriptionText() {
         if (mBiometricUnlockDisabledByAdmin && !mParentalConsentRequired) {
             setDescriptionText(getDescriptionDisabledByAdmin());
         }
     }

     @Override
     protected void initViews() {
         super.initViews();
         updateDescriptionText();
     }

     @NonNull
     protected PorterDuffColorFilter getIconColorFilter() {
         if (mIconColorFilter == null) {
             mIconColorFilter = new PorterDuffColorFilter(
                     DynamicColorPalette.getColor(this, DynamicColorPalette.ColorType.ACCENT),
                     PorterDuff.Mode.SRC_IN);
         }
         return mIconColorFilter;
     }

     @NonNull
     protected abstract FooterButton getPrimaryFooterButton();

     @NonNull
     protected abstract FooterButton getSecondaryFooterButton();

     @StringRes
     protected abstract int getAgreeButtonTextRes();

     @StringRes
     protected abstract int getMoreButtonTextRes();
 }
	/*
	* Copyright (C) 2018 The Android Open Source Project
	*
	* Licensed under the Apache License, Version 2.0 (the "License");
	* you may not use this file except in compliance with the License.
	* You may obtain a copy of the License at
	*
	* http://www.apache.org/licenses/LICENSE-2.0
	*
	* Unless required by applicable law or agreed to in writing, software
	* distributed under the License is distributed on an "AS IS" BASIS,
	* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
	* See the License for the specific language governing permissions and
	* limitations under the License
	*/

	package com.android.settings.biometrics;

	import android.app.admin.DevicePolicyManager;
	import android.content.Intent;
	import android.graphics.PorterDuff;
	import android.graphics.PorterDuffColorFilter;
	import android.hardware.biometrics.BiometricAuthenticator;
	import android.os.Bundle;
	import android.os.UserHandle;
	import android.os.UserManager;
	import android.util.Log;
	import android.view.View;
	import android.widget.TextView;

	import androidx.annotation.NonNull;
	import androidx.annotation.Nullable;
	import androidx.annotation.StringRes;
	import androidx.annotation.VisibleForTesting;

	import com.android.internal.widget.LockPatternUtils;
	import com.android.settings.R;
	import com.android.settings.SetupWizardUtils;
	import com.android.settings.password.ChooseLockGeneric;
	import com.android.settings.password.ChooseLockSettingsHelper;
	import com.android.settings.password.SetupSkipDialog;

	import com.google.android.setupcompat.template.FooterBarMixin;
	import com.google.android.setupcompat.template.FooterButton;
	import com.google.android.setupcompat.util.WizardManagerHelper;
	import com.google.android.setupdesign.GlifLayout;
	import com.google.android.setupdesign.span.LinkSpan;
	import com.google.android.setupdesign.template.RequireScrollMixin;
	import com.google.android.setupdesign.util.DynamicColorPalette;

	/**
	* Abstract base class for the intro onboarding activity for biometric enrollment.
	*/
	public abstract class BiometricEnrollIntroduction extends BiometricEnrollBase
	implements LinkSpan.OnClickListener {

	private static final String TAG = "BiometricEnrollIntroduction";

	private static final String KEY_CONFIRMING_CREDENTIALS = "confirming_credentials";
	private static final String KEY_SCROLLED_TO_BOTTOM = "scrolled";

	private GatekeeperPasswordProvider mGatekeeperPasswordProvider;
	private UserManager mUserManager;
	private boolean mHasPassword;
	private boolean mBiometricUnlockDisabledByAdmin;
	private TextView mErrorText;
	protected boolean mConfirmingCredentials;
	protected boolean mNextClicked;
	private boolean mParentalConsentRequired;
	private boolean mHasScrolledToBottom = false;

	@Nullable private PorterDuffColorFilter mIconColorFilter;

	/**
	* @return true if the biometric is disabled by a device administrator
	*/
	protected abstract boolean isDisabledByAdmin();

	/**
	* @return the layout resource
	*/
	protected abstract int getLayoutResource();

	/**
	* @return the header resource for if the biometric has been disabled by a device administrator
	*/
	protected abstract int getHeaderResDisabledByAdmin();

	/**
	* @return the default header resource
	*/
	protected abstract int getHeaderResDefault();

	/**
	* @return the description for if the biometric has been disabled by a device admin
	*/
	protected abstract String getDescriptionDisabledByAdmin();

	/**
	* @return the cancel button
	*/
	protected abstract FooterButton getCancelButton();

	/**
	* @return the next button
	*/
	protected abstract FooterButton getNextButton();

	/**
	* @return the error TextView
	*/
	protected abstract TextView getErrorTextView();

	/**
	* @return 0 if there are no errors, otherwise returns the resource ID for the error string
	* to be displayed.
	*/
	protected abstract int checkMaxEnrolled();

	/**
	* @return the challenge generated by the biometric hardware
	*/
	protected abstract void getChallenge(GenerateChallengeCallback callback);

	/**
	* @return one of the ChooseLockSettingsHelper#EXTRA_KEY_FOR_* constants
	*/
	protected abstract String getExtraKeyForBiometric();

	/**
	* @return the intent for proceeding to the next step of enrollment. For Fingerprint, this
	* should lead to the "Find Sensor" activity. For Face, this should lead to the "Enrolling"
	* activity.
	*/
	protected abstract Intent getEnrollingIntent();

	/**
	* @return the title to be shown on the ConfirmLock screen.
	*/
	protected abstract int getConfirmLockTitleResId();

	/**
	* @param span
	*/
	public abstract void onClick(LinkSpan span);

	public abstract @BiometricAuthenticator.Modality int getModality();

	protected interface GenerateChallengeCallback {
	void onChallengeGenerated(int sensorId, int userId, long challenge);
	}

	@Override
	protected void onCreate(Bundle savedInstanceState) {
	super.onCreate(savedInstanceState);

	if (savedInstanceState != null) {
	mConfirmingCredentials = savedInstanceState.getBoolean(KEY_CONFIRMING_CREDENTIALS);
	mHasScrolledToBottom = savedInstanceState.getBoolean(KEY_SCROLLED_TO_BOTTOM);
	mLaunchedPostureGuidance = savedInstanceState.getBoolean(
	EXTRA_LAUNCHED_POSTURE_GUIDANCE);
	}

	Intent intent = getIntent();
	if (intent.getStringExtra(WizardManagerHelper.EXTRA_THEME) == null) {
	// Put the theme in the intent so it gets propagated to other activities in the flow
	intent.putExtra(
	WizardManagerHelper.EXTRA_THEME,
	SetupWizardUtils.getThemeString(intent));
	}

	mBiometricUnlockDisabledByAdmin = isDisabledByAdmin();

	setContentView(getLayoutResource());
	mParentalConsentRequired = ParentalControlsUtils.parentConsentRequired(this, getModality())
	!= null;
	if (mBiometricUnlockDisabledByAdmin && !mParentalConsentRequired) {
	setHeaderText(getHeaderResDisabledByAdmin());
	} else {
	setHeaderText(getHeaderResDefault());
	}

	mErrorText = getErrorTextView();

	mUserManager = getUserManager();
	updatePasswordQuality();

	// Check isFinishing() because FaceEnrollIntroduction may finish self to launch
	// FaceSettings during onCreate()
	if (!mConfirmingCredentials && !isFinishing()) {
	if (!mHasPassword) {
	// No password registered, launch into enrollment wizard.
	mConfirmingCredentials = true;
	launchChooseLock();
	} else if (!BiometricUtils.containsGatekeeperPasswordHandle(getIntent())
	&& mToken == null) {
	// It's possible to have a token but mLaunchedConfirmLock == false, since
	// ChooseLockGeneric can pass us a token.
	mConfirmingCredentials = true;
	launchConfirmLock(getConfirmLockTitleResId());
	}
	}

	final GlifLayout layout = getLayout();
	mFooterBarMixin = layout.getMixin(FooterBarMixin.class);
	mFooterBarMixin.setPrimaryButton(getPrimaryFooterButton());
	mFooterBarMixin.setSecondaryButton(getSecondaryFooterButton(), true /* usePrimaryStyle */);
	mFooterBarMixin.getSecondaryButton().setVisibility(
	mHasScrolledToBottom ? View.VISIBLE : View.INVISIBLE);

	final RequireScrollMixin requireScrollMixin = layout.getMixin(RequireScrollMixin.class);
	requireScrollMixin.requireScrollWithButton(this, getPrimaryFooterButton(),
	getMoreButtonTextRes(), this::onNextButtonClick);
	requireScrollMixin.setOnRequireScrollStateChangedListener(
	scrollNeeded -> {
	boolean enrollmentCompleted = checkMaxEnrolled() != 0;
	if (!enrollmentCompleted) {
	// Update text of primary button from "More" to "Agree".
	final int primaryButtonTextRes = scrollNeeded
	? getMoreButtonTextRes()
	: getAgreeButtonTextRes();
	getPrimaryFooterButton().setText(this, primaryButtonTextRes);
	}

	// Show secondary button once scroll is completed.
	if (!scrollNeeded) {
	if (!enrollmentCompleted) {
	getSecondaryFooterButton().setVisibility(View.VISIBLE);
	}
	mHasScrolledToBottom = true;
	}
	});
	}

	@Override
	protected void onResume() {
	super.onResume();

	final int errorMsg = checkMaxEnrolled();
	if (errorMsg == 0) {
	mErrorText.setText(null);
	mErrorText.setVisibility(View.GONE);
	getNextButton().setVisibility(View.VISIBLE);
	} else {
	mErrorText.setText(errorMsg);
	mErrorText.setVisibility(View.VISIBLE);
	getNextButton().setText(getResources().getString(R.string.done));
	getNextButton().setVisibility(View.VISIBLE);
	getSecondaryFooterButton().setVisibility(View.INVISIBLE);
	}
	}

	@Override
	protected void onSaveInstanceState(Bundle outState) {
	super.onSaveInstanceState(outState);
	outState.putBoolean(KEY_CONFIRMING_CREDENTIALS, mConfirmingCredentials);
	outState.putBoolean(KEY_SCROLLED_TO_BOTTOM, mHasScrolledToBottom);
	}

	@Override
	protected boolean shouldFinishWhenBackgrounded() {
	return super.shouldFinishWhenBackgrounded() && !mConfirmingCredentials && !mNextClicked;
	}

	@VisibleForTesting
	@NonNull
	protected GatekeeperPasswordProvider getGatekeeperPasswordProvider() {
	if (mGatekeeperPasswordProvider == null) {
	mGatekeeperPasswordProvider = new GatekeeperPasswordProvider(getLockPatternUtils());
	}
	return mGatekeeperPasswordProvider;
	}

	@VisibleForTesting
	protected UserManager getUserManager() {
	return UserManager.get(this);
	}

	@VisibleForTesting
	@NonNull
	protected LockPatternUtils getLockPatternUtils() {
	return new LockPatternUtils(this);
	}

	private void updatePasswordQuality() {
	final int passwordQuality = getLockPatternUtils()
	.getActivePasswordQuality(mUserManager.getCredentialOwnerProfile(mUserId));
	mHasPassword = passwordQuality != DevicePolicyManager.PASSWORD_QUALITY_UNSPECIFIED;
	}

	@Override
	protected void onNextButtonClick(View view) {
	mNextClicked = true;
	if (checkMaxEnrolled() == 0) {
	// Lock thingy is already set up, launch directly to the next page
	launchNextEnrollingActivity(mToken);
	} else {
	boolean couldStartNextBiometric = BiometricUtils.tryStartingNextBiometricEnroll(this,
	ENROLL_NEXT_BIOMETRIC_REQUEST, "enrollIntroduction#onNextButtonClicked");
	if (!couldStartNextBiometric) {
	setResult(RESULT_FINISHED);
	finish();
	}
	}
	mNextLaunched = true;
	}

	private void launchChooseLock() {
	Intent intent = BiometricUtils.getChooseLockIntent(this, getIntent());
	intent.putExtra(ChooseLockGeneric.ChooseLockGenericFragment.HIDE_INSECURE_OPTIONS, true);
	intent.putExtra(ChooseLockSettingsHelper.EXTRA_KEY_REQUEST_GK_PW_HANDLE, true);
	intent.putExtra(getExtraKeyForBiometric(), true);
	if (mUserId != UserHandle.USER_NULL) {
	intent.putExtra(Intent.EXTRA_USER_ID, mUserId);
	}
	startActivityForResult(intent, CHOOSE_LOCK_GENERIC_REQUEST);
	}

	private void launchNextEnrollingActivity(byte[] token) {
	Intent intent = getEnrollingIntent();
	if (token != null) {
	intent.putExtra(ChooseLockSettingsHelper.EXTRA_KEY_CHALLENGE_TOKEN, token);
	}
	if (mUserId != UserHandle.USER_NULL) {
	intent.putExtra(Intent.EXTRA_USER_ID, mUserId);
	}
	BiometricUtils.copyMultiBiometricExtras(getIntent(), intent);
	intent.putExtra(EXTRA_FROM_SETTINGS_SUMMARY, mFromSettingsSummary);
	intent.putExtra(EXTRA_KEY_CHALLENGE, mChallenge);
	intent.putExtra(EXTRA_KEY_SENSOR_ID, mSensorId);
	startActivityForResult(intent, BIOMETRIC_FIND_SENSOR_REQUEST);
	}

	/**
	* Returns the intent extra data for setResult(), null means nothing need to been sent back
	*/
	@Nullable
	protected Intent getSetResultIntentExtra(@Nullable Intent activityResultIntent) {
	return activityResultIntent;
	}

	@Override
	protected void onActivityResult(int requestCode, int resultCode, Intent data) {
	Log.d(TAG,
	"onActivityResult(requestCode=" + requestCode + ", resultCode=" + resultCode + ")");
	final boolean cameFromMultiBioFpAuthAddAnother =
	requestCode == BiometricUtils.REQUEST_ADD_ANOTHER
	&& BiometricUtils.isMultiBiometricFingerprintEnrollmentFlow(this);
	if (requestCode == BIOMETRIC_FIND_SENSOR_REQUEST) {
	if (isResultFinished(resultCode)) {
	handleBiometricResultSkipOrFinished(resultCode, getSetResultIntentExtra(data));
	} else if (isResultSkipped(resultCode)) {
	if (!BiometricUtils.tryStartingNextBiometricEnroll(this,
	ENROLL_NEXT_BIOMETRIC_REQUEST, "BIOMETRIC_FIND_SENSOR_SKIPPED")) {
	handleBiometricResultSkipOrFinished(resultCode, data);
	}
	} else if (resultCode == RESULT_TIMEOUT) {
	setResult(resultCode, data);
	finish();
	}
	} else if (requestCode == CHOOSE_LOCK_GENERIC_REQUEST) {
	mConfirmingCredentials = false;
	if (resultCode == RESULT_FINISHED) {
	updatePasswordQuality();
	final boolean handled = onSetOrConfirmCredentials(data);
	if (!handled) {
	overridePendingTransition(R.anim.sud_slide_next_in, R.anim.sud_slide_next_out);
	getNextButton().setEnabled(false);
	getChallenge(((sensorId, userId, challenge) -> {
	mSensorId = sensorId;
	mChallenge = challenge;
	mToken = BiometricUtils.requestGatekeeperHat(this, data, mUserId,
	challenge);
	BiometricUtils.removeGatekeeperPasswordHandle(this, data);
	getNextButton().setEnabled(true);
	}));
	}
	} else {
	setResult(resultCode, data);
	finish();
	}
	} else if (requestCode == CONFIRM_REQUEST) {
	mConfirmingCredentials = false;
	if (resultCode == RESULT_OK && data != null) {
	final boolean handled = onSetOrConfirmCredentials(data);
	if (!handled) {
	overridePendingTransition(R.anim.sud_slide_next_in, R.anim.sud_slide_next_out);
	getNextButton().setEnabled(false);
	getChallenge(((sensorId, userId, challenge) -> {
	mSensorId = sensorId;
	mChallenge = challenge;
	mToken = BiometricUtils.requestGatekeeperHat(this, data, mUserId,
	challenge);
	BiometricUtils.removeGatekeeperPasswordHandle(this, data);
	getNextButton().setEnabled(true);
	}));
	}
	} else {
	setResult(resultCode, data);
	finish();
	}
	} else if (requestCode == LEARN_MORE_REQUEST) {
	overridePendingTransition(R.anim.sud_slide_back_in, R.anim.sud_slide_back_out);
	} else if (requestCode == ENROLL_NEXT_BIOMETRIC_REQUEST
	\|\| cameFromMultiBioFpAuthAddAnother) {
	if (isResultFinished(resultCode)) {
	handleBiometricResultSkipOrFinished(resultCode, data);
	} else if (isResultSkipped(resultCode)) {
	if (requestCode == BiometricUtils.REQUEST_ADD_ANOTHER) {
	// If we came from an add another request, it still might
	// be possible to add another biometric. Check if we can.
	if (checkMaxEnrolled() != 0) {
	// If we can't enroll any more biometrics, than skip
	// this one.
	handleBiometricResultSkipOrFinished(resultCode, data);
	}
	} else {
	handleBiometricResultSkipOrFinished(resultCode, data);
	}
	} else if (resultCode != RESULT_CANCELED) {
	setResult(resultCode, data);
	finish();
	}
	}
	super.onActivityResult(requestCode, resultCode, data);
	}

	private static boolean isResultSkipped(int resultCode) {
	return resultCode == RESULT_SKIP
	\|\| resultCode == SetupSkipDialog.RESULT_SKIP;
	}

	private static boolean isResultFinished(int resultCode) {
	return resultCode == RESULT_FINISHED;
	}

	private static boolean isResultSkipOrFinished(int resultCode) {
	return isResultSkipped(resultCode) \|\| isResultFinished(resultCode);
	}

	protected void removeEnrollNextBiometric() {
	getIntent().removeExtra(MultiBiometricEnrollHelper.EXTRA_ENROLL_AFTER_FACE);
	getIntent().removeExtra(MultiBiometricEnrollHelper.EXTRA_ENROLL_AFTER_FINGERPRINT);
	}

	protected void removeEnrollNextBiometricIfSkipEnroll(@Nullable Intent data) {
	if (data != null
	&& data.getBooleanExtra(
	MultiBiometricEnrollHelper.EXTRA_SKIP_PENDING_ENROLL, false)) {
	removeEnrollNextBiometric();
	}
	}
	protected void handleBiometricResultSkipOrFinished(int resultCode, @Nullable Intent data) {
	removeEnrollNextBiometricIfSkipEnroll(data);
	if (resultCode == RESULT_SKIP) {
	onEnrollmentSkipped(data);
	} else if (resultCode == RESULT_FINISHED) {
	onFinishedEnrolling(data);
	}
	}

	/**
	* Called after confirming credentials. Can be used to prevent the default
	* behavior of immediately calling #getChallenge (useful to things like intro
	* consent screens that don't actually do enrollment and will later start an
	* activity that does).
	*
	* @return True if the default behavior should be skipped and handled by this method instead.
	*/
	protected boolean onSetOrConfirmCredentials(@Nullable Intent data) {
	return false;
	}

	protected void onCancelButtonClick(View view) {
	finish();
	}

	protected void onSkipButtonClick(View view) {
	onEnrollmentSkipped(null /* data */);
	}

	protected void onEnrollmentSkipped(@Nullable Intent data) {
	setResult(RESULT_SKIP, data);
	finish();
	}

	protected void onFinishedEnrolling(@Nullable Intent data) {
	setResult(RESULT_FINISHED, data);
	finish();
	}

	protected void updateDescriptionText() {
	if (mBiometricUnlockDisabledByAdmin && !mParentalConsentRequired) {
	setDescriptionText(getDescriptionDisabledByAdmin());
	}
	}

	@Override
	protected void initViews() {
	super.initViews();
	updateDescriptionText();
	}

	@NonNull
	protected PorterDuffColorFilter getIconColorFilter() {
	if (mIconColorFilter == null) {
	mIconColorFilter = new PorterDuffColorFilter(
	DynamicColorPalette.getColor(this, DynamicColorPalette.ColorType.ACCENT),
	PorterDuff.Mode.SRC_IN);
	}
	return mIconColorFilter;
	}

	@NonNull
	protected abstract FooterButton getPrimaryFooterButton();

	@NonNull
	protected abstract FooterButton getSecondaryFooterButton();

	@StringRes
	protected abstract int getAgreeButtonTextRes();

	@StringRes
	protected abstract int getMoreButtonTextRes();
	}