[ProgressIndicator] Added an API to automatically hide the indicator after it reaches max progress.

PiperOrigin-RevId: 800169008

Author: pekingme

lib/java/com/google/android/material/progressindicator/BaseProgressIndicator.java

@@ -18,6 +18,7 @@
 
 import com.google.android.material.R;
 
+import static com.google.android.material.progressindicator.DeterminateDrawable.MAX_DRAWABLE_LEVEL;
 import static com.google.android.material.theme.overlay.MaterialThemeOverlay.wrap;
 import static java.lang.Math.abs;
 import static java.lang.Math.min;
@@ -43,6 +44,7 @@
 import androidx.annotation.RestrictTo.Scope;
 import androidx.annotation.StyleRes;
 import androidx.annotation.VisibleForTesting;
+import androidx.dynamicanimation.animation.DynamicAnimation.OnAnimationEndListener;
 import androidx.vectordrawable.graphics.drawable.Animatable2Compat.AnimationCallback;
 import com.google.android.material.color.MaterialColors;
 import com.google.android.material.internal.ThemeEnforcement;
@@ -960,6 +962,25 @@ public void setVisibilityAfterHide(int visibility) {
     visibilityAfterHide = visibility;
   }
 
+  private final OnAnimationEndListener hideAfterMaxProgressListener =
+      (animation, canceled, value, velocity) -> {
+        if (getProgressDrawable() != null
+            && getProgressDrawable().getLevel() == MAX_DRAWABLE_LEVEL) {
+          hide();
+        }
+      };
+
+  public void setHideAfterMaxProgress(boolean hideAfterMaxProgress) {
+    if (getProgressDrawable() == null) {
+      return;
+    }
+    if (hideAfterMaxProgress) {
+      getProgressDrawable().addSpringAnimationEndListener(hideAfterMaxProgressListener);
+    } else {
+      getProgressDrawable().removeSpringAnimationEndListener(hideAfterMaxProgressListener);
+    }
+  }
+
   /**
    * Sets the scale of the animation duration in indeterminate mode.
    *

lib/java/com/google/android/material/progressindicator/DeterminateDrawable.java

@@ -40,7 +40,7 @@
 public final class DeterminateDrawable<S extends BaseProgressIndicatorSpec>
     extends DrawableWithAnimatedVisibilityChange {
   // Constants for drawing progress.
-  private static final int MAX_DRAWABLE_LEVEL = 10000;
+  static final int MAX_DRAWABLE_LEVEL = 10000;
   // Constants for amplitude animation.
   static final float FULL_AMPLITUDE_PROGRESS_MIN = 0.1f;
   static final float FULL_AMPLITUDE_PROGRESS_MAX = 0.9f;