Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 523f1f5f authored by TYM Tsai's avatar TYM Tsai Committed by Ahaan Ugale
Browse files

Adds APIs for Autofill bottom sheet UI 

Adds APIs for set up field presentations for bottom sheet. Also reduce
the APIs overloading for setting the presentations.

Bug: 210926084
Test: Manual
Change-Id: Iacb8d3352303650afbfa2072ce7c382d0baed702
parent 2801e6de

core/api/current.txt

+48 −14
Original line number Diff line number Diff line
@@ -37727,21 +37727,23 @@ package android.service.autofill { 
  }















  public static final class Dataset.Builder {













    ctor public Dataset.Builder(@NonNull android.widget.RemoteViews);













    ctor @Deprecated public Dataset.Builder(@NonNull android.widget.RemoteViews);













    ctor public Dataset.Builder(@NonNull android.service.autofill.Presentations);















    ctor public Dataset.Builder();















    method @NonNull public android.service.autofill.Dataset build();















    method @NonNull public android.service.autofill.Dataset.Builder setAuthentication(@Nullable android.content.IntentSender);













    method @NonNull public android.service.autofill.Dataset.Builder setField(@NonNull android.view.autofill.AutofillId, @Nullable android.service.autofill.Field);















    method @NonNull public android.service.autofill.Dataset.Builder setId(@Nullable String);













    method @NonNull public android.service.autofill.Dataset.Builder setInlinePresentation(@NonNull android.service.autofill.InlinePresentation);













    method @NonNull public android.service.autofill.Dataset.Builder setInlinePresentation(@NonNull android.service.autofill.InlinePresentation, @NonNull android.service.autofill.InlinePresentation);













    method @NonNull public android.service.autofill.Dataset.Builder setValue(@NonNull android.view.autofill.AutofillId, @Nullable android.view.autofill.AutofillValue);













    method @NonNull public android.service.autofill.Dataset.Builder setValue(@NonNull android.view.autofill.AutofillId, @Nullable android.view.autofill.AutofillValue, @NonNull android.widget.RemoteViews);













    method @NonNull public android.service.autofill.Dataset.Builder setValue(@NonNull android.view.autofill.AutofillId, @Nullable android.view.autofill.AutofillValue, @Nullable java.util.regex.Pattern);













    method @NonNull public android.service.autofill.Dataset.Builder setValue(@NonNull android.view.autofill.AutofillId, @Nullable android.view.autofill.AutofillValue, @Nullable java.util.regex.Pattern, @NonNull android.widget.RemoteViews);













    method @NonNull public android.service.autofill.Dataset.Builder setValue(@NonNull android.view.autofill.AutofillId, @Nullable android.view.autofill.AutofillValue, @NonNull android.widget.RemoteViews, @NonNull android.service.autofill.InlinePresentation);













    method @NonNull public android.service.autofill.Dataset.Builder setValue(@NonNull android.view.autofill.AutofillId, @Nullable android.view.autofill.AutofillValue, @NonNull android.widget.RemoteViews, @NonNull android.service.autofill.InlinePresentation, @NonNull android.service.autofill.InlinePresentation);













    method @NonNull public android.service.autofill.Dataset.Builder setValue(@NonNull android.view.autofill.AutofillId, @Nullable android.view.autofill.AutofillValue, @Nullable java.util.regex.Pattern, @NonNull android.widget.RemoteViews, @NonNull android.service.autofill.InlinePresentation);













    method @NonNull public android.service.autofill.Dataset.Builder setValue(@NonNull android.view.autofill.AutofillId, @Nullable android.view.autofill.AutofillValue, @Nullable java.util.regex.Pattern, @NonNull android.widget.RemoteViews, @NonNull android.service.autofill.InlinePresentation, @NonNull android.service.autofill.InlinePresentation);













    method @Deprecated @NonNull public android.service.autofill.Dataset.Builder setInlinePresentation(@NonNull android.service.autofill.InlinePresentation);













    method @Deprecated @NonNull public android.service.autofill.Dataset.Builder setInlinePresentation(@NonNull android.service.autofill.InlinePresentation, @NonNull android.service.autofill.InlinePresentation);













    method @Deprecated @NonNull public android.service.autofill.Dataset.Builder setValue(@NonNull android.view.autofill.AutofillId, @Nullable android.view.autofill.AutofillValue);













    method @Deprecated @NonNull public android.service.autofill.Dataset.Builder setValue(@NonNull android.view.autofill.AutofillId, @Nullable android.view.autofill.AutofillValue, @NonNull android.widget.RemoteViews);













    method @Deprecated @NonNull public android.service.autofill.Dataset.Builder setValue(@NonNull android.view.autofill.AutofillId, @Nullable android.view.autofill.AutofillValue, @Nullable java.util.regex.Pattern);













    method @Deprecated @NonNull public android.service.autofill.Dataset.Builder setValue(@NonNull android.view.autofill.AutofillId, @Nullable android.view.autofill.AutofillValue, @Nullable java.util.regex.Pattern, @NonNull android.widget.RemoteViews);













    method @Deprecated @NonNull public android.service.autofill.Dataset.Builder setValue(@NonNull android.view.autofill.AutofillId, @Nullable android.view.autofill.AutofillValue, @NonNull android.widget.RemoteViews, @NonNull android.service.autofill.InlinePresentation);













    method @Deprecated @NonNull public android.service.autofill.Dataset.Builder setValue(@NonNull android.view.autofill.AutofillId, @Nullable android.view.autofill.AutofillValue, @NonNull android.widget.RemoteViews, @NonNull android.service.autofill.InlinePresentation, @NonNull android.service.autofill.InlinePresentation);













    method @Deprecated @NonNull public android.service.autofill.Dataset.Builder setValue(@NonNull android.view.autofill.AutofillId, @Nullable android.view.autofill.AutofillValue, @Nullable java.util.regex.Pattern, @NonNull android.widget.RemoteViews, @NonNull android.service.autofill.InlinePresentation);













    method @Deprecated @NonNull public android.service.autofill.Dataset.Builder setValue(@NonNull android.view.autofill.AutofillId, @Nullable android.view.autofill.AutofillValue, @Nullable java.util.regex.Pattern, @NonNull android.widget.RemoteViews, @NonNull android.service.autofill.InlinePresentation, @NonNull android.service.autofill.InlinePresentation);















  }





























  public final class DateTransformation implements android.os.Parcelable android.service.autofill.Transformation {









@@ -37758,6 +37760,19 @@ package android.service.autofill {













    field @NonNull public static final android.os.Parcelable.Creator<android.service.autofill.DateValueSanitizer> CREATOR;















  }



























  public final class Field {













    method @Nullable public android.service.autofill.Presentations getPresentations();













    method @Nullable public android.view.autofill.AutofillValue getValue();













  }

























  public static final class Field.Builder {













    ctor public Field.Builder();













    method @NonNull public android.service.autofill.Field build();













    method @NonNull public android.service.autofill.Field.Builder setFilter(@Nullable java.util.regex.Pattern);













    method @NonNull public android.service.autofill.Field.Builder setPresentations(@NonNull android.service.autofill.Presentations);













    method @NonNull public android.service.autofill.Field.Builder setValue(@NonNull android.view.autofill.AutofillValue);













  }



























  public final class FieldClassification {















    method @NonNull public java.util.List<android.service.autofill.FieldClassification.Match> getMatches();















  }










@@ -37840,11 +37855,14 @@ package android.service.autofill {













    method @NonNull public android.service.autofill.FillResponse.Builder addDataset(@Nullable android.service.autofill.Dataset);















    method @NonNull public android.service.autofill.FillResponse build();















    method @NonNull public android.service.autofill.FillResponse.Builder disableAutofill(long);













    method @NonNull public android.service.autofill.FillResponse.Builder setAuthentication(@NonNull android.view.autofill.AutofillId[], @Nullable android.content.IntentSender, @Nullable android.widget.RemoteViews);













    method @NonNull public android.service.autofill.FillResponse.Builder setAuthentication(@NonNull android.view.autofill.AutofillId[], @Nullable android.content.IntentSender, @Nullable android.widget.RemoteViews, @Nullable android.service.autofill.InlinePresentation);













    method @NonNull public android.service.autofill.FillResponse.Builder setAuthentication(@NonNull android.view.autofill.AutofillId[], @Nullable android.content.IntentSender, @Nullable android.widget.RemoteViews, @Nullable android.service.autofill.InlinePresentation, @Nullable android.service.autofill.InlinePresentation);













    method @Deprecated @NonNull public android.service.autofill.FillResponse.Builder setAuthentication(@NonNull android.view.autofill.AutofillId[], @Nullable android.content.IntentSender, @Nullable android.widget.RemoteViews);













    method @Deprecated @NonNull public android.service.autofill.FillResponse.Builder setAuthentication(@NonNull android.view.autofill.AutofillId[], @Nullable android.content.IntentSender, @Nullable android.widget.RemoteViews, @Nullable android.service.autofill.InlinePresentation);













    method @Deprecated @NonNull public android.service.autofill.FillResponse.Builder setAuthentication(@NonNull android.view.autofill.AutofillId[], @Nullable android.content.IntentSender, @Nullable android.widget.RemoteViews, @Nullable android.service.autofill.InlinePresentation, @Nullable android.service.autofill.InlinePresentation);













    method @NonNull public android.service.autofill.FillResponse.Builder setAuthentication(@NonNull android.view.autofill.AutofillId[], @Nullable android.content.IntentSender, @Nullable android.service.autofill.Presentations);















    method @NonNull public android.service.autofill.FillResponse.Builder setClientState(@Nullable android.os.Bundle);













    method @NonNull public android.service.autofill.FillResponse.Builder setDialogHeader(@NonNull android.widget.RemoteViews);















    method @NonNull public android.service.autofill.FillResponse.Builder setFieldClassificationIds(@NonNull android.view.autofill.AutofillId...);













    method @NonNull public android.service.autofill.FillResponse.Builder setFillDialogTriggerIds(@NonNull android.view.autofill.AutofillId...);















    method @NonNull public android.service.autofill.FillResponse.Builder setFlags(int);















    method @NonNull public android.service.autofill.FillResponse.Builder setFooter(@NonNull android.widget.RemoteViews);















    method @NonNull public android.service.autofill.FillResponse.Builder setHeader(@NonNull android.widget.RemoteViews);










@@ -37889,6 +37907,22 @@ package android.service.autofill {













  public interface OnClickAction {















  }



























  public final class Presentations {













    method @Nullable public android.widget.RemoteViews getDialogPresentation();













    method @Nullable public android.service.autofill.InlinePresentation getInlinePresentation();













    method @Nullable public android.service.autofill.InlinePresentation getInlineTooltipPresentation();













    method @Nullable public android.widget.RemoteViews getMenuPresentation();













  }

























  public static final class Presentations.Builder {













    ctor public Presentations.Builder();













    method @NonNull public android.service.autofill.Presentations build();













    method @NonNull public android.service.autofill.Presentations.Builder setDialogPresentation(@NonNull android.widget.RemoteViews);













    method @NonNull public android.service.autofill.Presentations.Builder setInlinePresentation(@NonNull android.service.autofill.InlinePresentation);













    method @NonNull public android.service.autofill.Presentations.Builder setInlineTooltipPresentation(@NonNull android.service.autofill.InlinePresentation);













    method @NonNull public android.service.autofill.Presentations.Builder setMenuPresentation(@NonNull android.widget.RemoteViews);













  }



























  public final class RegexValidator implements android.os.Parcelable android.service.autofill.Validator {















    ctor public RegexValidator(@NonNull android.view.autofill.AutofillId, @NonNull java.util.regex.Pattern);















    method public int describeContents();

























core/api/system-current.txt



+2
−2






























Original line number
Diff line number
Diff line








@@ -10356,9 +10356,9 @@ package android.service.autofill {













  }





























  public static final class Dataset.Builder {













    ctor public Dataset.Builder(@NonNull android.service.autofill.InlinePresentation);













    ctor @Deprecated public Dataset.Builder(@NonNull android.service.autofill.InlinePresentation);















    method @NonNull public android.service.autofill.Dataset.Builder setContent(@NonNull android.view.autofill.AutofillId, @Nullable android.content.ClipData);













    method @NonNull public android.service.autofill.Dataset.Builder setFieldInlinePresentation(@NonNull android.view.autofill.AutofillId, @Nullable android.view.autofill.AutofillValue, @Nullable java.util.regex.Pattern, @NonNull android.service.autofill.InlinePresentation);













    method @Deprecated @NonNull public android.service.autofill.Dataset.Builder setFieldInlinePresentation(@NonNull android.view.autofill.AutofillId, @Nullable android.view.autofill.AutofillValue, @Nullable java.util.regex.Pattern, @NonNull android.service.autofill.InlinePresentation);















  }





























  public abstract class InlineSuggestionRenderService extends android.app.Service {

























core/java/android/service/autofill/Dataset.java



+212
−46




























File changed.
Preview size limit exceeded, changes collapsed.
























core/java/android/service/autofill/Field.java
0 → 100644



+165
−0






























Original line number
Diff line number
Diff line













/*













 * Copyright (C) 2022 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 android.service.autofill;



























import android.annotation.NonNull;













import android.annotation.Nullable;













import android.annotation.SuppressLint;













import android.view.autofill.AutofillId;













import android.view.autofill.AutofillValue;



























import com.android.internal.util.DataClass;



























import java.util.regex.Pattern;



























/**













 * This class is used to set all information of a field. Such as the













 * {@link AutofillId} of the field, the {@link AutofillValue} to be autofilled,













 * a <a href="#Filtering">explicit filter</a>, and presentations to be visualized,













 * etc.













 */













public final class Field {



























    /**













     * The value to be autofilled. Pass {@code null} if you do not have the value













     * but the target view is a logical part of the dataset. For example, if the













     * dataset needs authentication and you have no access to the value.













     */













    private @Nullable AutofillValue mValue;



























    /**













     * Regex used to determine if the dataset should be shown in the autofill UI;













     * when {@code null}, it disables filtering on that dataset (this is the recommended













     * approach when {@code value} is not {@code null} and field contains sensitive data













     * such as passwords).













     *













     * @see Dataset.DatasetFieldFilter













     * @hide













     */













    private @Nullable Dataset.DatasetFieldFilter mFilter;



























    /**













     * The presentations used to visualize this field in Autofill UI.













     */













    private @Nullable Presentations mPresentations;









































    /* package-private */ Field(













            @Nullable AutofillValue value,













            @Nullable Dataset.DatasetFieldFilter filter,













            @Nullable Presentations presentations) {













        this.mValue = value;













        this.mFilter = filter;













        this.mPresentations = presentations;













    }



























    /**













     * The value to be autofilled. Pass {@code null} if you do not have the value













     * but the target view is a logical part of the dataset. For example, if the













     * dataset needs authentication and you have no access to the value.













     */













    @DataClass.Generated.Member













    public @Nullable AutofillValue getValue() {













        return mValue;













    }



























    /**













     * Regex used to determine if the dataset should be shown in the autofill UI;













     * when {@code null}, it disables filtering on that dataset (this is the recommended













     * approach when {@code value} is not {@code null} and field contains sensitive data













     * such as passwords).













     *













     * @see Dataset.DatasetFieldFilter













     * @hide













     */













    public @Nullable Dataset.DatasetFieldFilter getFilter() {













        return mFilter;













    }



























    /**













     * The presentations used to visualize this field in Autofill UI.













     */













    public @Nullable Presentations getPresentations() {













        return mPresentations;













    }



























    /**













     * A builder for {@link Field}













     */













    public static final class Builder {



























        private @Nullable AutofillValue mValue = null;













        private @Nullable Dataset.DatasetFieldFilter mFilter = null;













        private @Nullable Presentations mPresentations = null;













        private boolean mDestroyed = false;



























        public Builder() {













        }



























        /**













         * The value to be autofilled. Pass {@code null} if you do not have the value













         * but the target view is a logical part of the dataset. For example, if the













         * dataset needs authentication and you have no access to the value.













         */













        public @NonNull Builder setValue(@NonNull AutofillValue value) {













            checkNotUsed();













            mValue = value;













            return this;













        }



























        /**













         * Regex used to determine if the dataset should be shown in the autofill UI;













         * when {@code null}, it disables filtering on that dataset (this is the recommended













         * approach when {@code value} is not {@code null} and field contains sensitive data













         * such as passwords).













         */













        @SuppressLint("MissingGetterMatchingBuilder")













        public @NonNull Builder setFilter(@Nullable Pattern value) {













            checkNotUsed();













            mFilter = new Dataset.DatasetFieldFilter(value);













            return this;













        }



























        /**













         * The presentations used to visualize this field in Autofill UI.













         */













        public @NonNull Builder setPresentations(@NonNull Presentations value) {













            checkNotUsed();













            mPresentations = value;













            return this;













        }



























        /** Builds the instance. This builder should not be touched after calling this! */













        public @NonNull Field build() {













            checkNotUsed();













            mDestroyed = true; // Mark builder used



























            Field o = new Field(













                    mValue,













                    mFilter,













                    mPresentations);













            return o;













        }



























        private void checkNotUsed() {













            if (mDestroyed) {













                throw new IllegalStateException(













                        "This Builder should not be reused. Use a new Builder instance instead");













            }













        }













    }













}
























core/java/android/service/autofill/FillResponse.java



+203
−11




























File changed.
Preview size limit exceeded, changes collapsed.