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

Commit 90370e0b authored by Kang Li's avatar Kang Li
Browse files

Add a service to rank apps for ResolverActivity. 

bug: 30982298
Test: manual - shared images in Camera, texts in Messenger, and webpages
in Chrome.

Change-Id: If335c269ca54145839ad8fd4b3f9b93a74b550f8
(cherry picked from commit 35b9e301)
parent 82331f7f

Android.mk

+3 −0
Original line number Diff line number Diff line
@@ -320,6 +320,8 @@ LOCAL_SRC_FILES += \ 
	core/java/android/service/wallpaper/IWallpaperService.aidl \

	core/java/android/service/chooser/IChooserTargetService.aidl \

	core/java/android/service/chooser/IChooserTargetResult.aidl \

	core/java/android/service/resolver/IResolverRankerService.aidl \

	core/java/android/service/resolver/IResolverRankerResult.aidl \

	core/java/android/text/ITextClassificationService.aidl \

	core/java/android/view/accessibility/IAccessibilityInteractionConnection.aidl\

	core/java/android/view/accessibility/IAccessibilityInteractionConnectionCallback.aidl\
@@ -729,6 +731,7 @@ aidl_files := \ 
	frameworks/base/core/java/android/service/notification/SnoozeCriterion.aidl \

	frameworks/base/core/java/android/service/notification/StatusBarNotification.aidl \

	frameworks/base/core/java/android/service/chooser/ChooserTarget.aidl \

	frameworks/base/core/java/android/service/resolver/ResolverTarget.aidl \

	frameworks/base/core/java/android/speech/tts/Voice.aidl \

	frameworks/base/core/java/android/app/usage/CacheQuotaHint.aidl \

	frameworks/base/core/java/android/app/usage/ExternalStorageStats.aidl \

api/system-current.txt

+31 −0
Original line number Diff line number Diff line
@@ -53,6 +53,7 @@ package android { 
    field public static final java.lang.String BIND_PRINT_SERVICE = "android.permission.BIND_PRINT_SERVICE";

    field public static final java.lang.String BIND_QUICK_SETTINGS_TILE = "android.permission.BIND_QUICK_SETTINGS_TILE";

    field public static final java.lang.String BIND_REMOTEVIEWS = "android.permission.BIND_REMOTEVIEWS";

    field public static final java.lang.String BIND_RESOLVER_RANKER_SERVICE = "android.permission.BIND_RESOLVER_RANKER_SERVICE";

    field public static final java.lang.String BIND_RUNTIME_PERMISSION_PRESENTER_SERVICE = "android.permission.BIND_RUNTIME_PERMISSION_PRESENTER_SERVICE";

    field public static final java.lang.String BIND_SCREENING_SERVICE = "android.permission.BIND_SCREENING_SERVICE";

    field public static final java.lang.String BIND_TELECOM_CONNECTION_SERVICE = "android.permission.BIND_TELECOM_CONNECTION_SERVICE";
@@ -40459,6 +40460,36 @@ package android.service.quicksettings { 














}



























package android.service.resolver {

























  public abstract class ResolverRankerService extends android.app.Service {













    ctor public ResolverRankerService();













    method public android.os.IBinder onBind(android.content.Intent);













    method public void onPredictSharingProbabilities(java.util.List<android.service.resolver.ResolverTarget>);













    method public void onTrainRankingModel(java.util.List<android.service.resolver.ResolverTarget>, int);













    field public static final java.lang.String BIND_PERMISSION = "android.permission.BIND_RESOLVER_RANKER_SERVICE";













    field public static final java.lang.String SERVICE_INTERFACE = "android.service.resolver.ResolverRankerService";













  }

























  public final class ResolverTarget implements android.os.Parcelable {













    ctor public ResolverTarget();













    method public int describeContents();













    method public float getChooserScore();













    method public float getLaunchScore();













    method public float getRecencyScore();













    method public float getSelectProbability();













    method public float getTimeSpentScore();













    method public void setChooserScore(float);













    method public void setLaunchScore(float);













    method public void setRecencyScore(float);













    method public void setSelectProbability(float);













    method public void setTimeSpentScore(float);













    method public void writeToParcel(android.os.Parcel, int);













    field public static final android.os.Parcelable.Creator<android.service.resolver.ResolverTarget> CREATOR;













  }

























}



























package android.service.restrictions {





























  public abstract class RestrictionsReceiver extends android.content.BroadcastReceiver {

























core/java/android/service/resolver/IResolverRankerResult.aidl
0 → 100644



+27
−0




























Original line number
Diff line number
Diff line













/*













 * Copyright (C) 2017 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.resolver;



























import android.service.resolver.ResolverTarget;



























/**













 * @hide













 */













oneway interface IResolverRankerResult













{













    void sendResult(in List<ResolverTarget> results);













}










 No newline at end of file
























core/java/android/service/resolver/IResolverRankerService.aidl
0 → 100644



+29
−0




























Original line number
Diff line number
Diff line













/*













 * Copyright (C) 2017 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.resolver;



























import android.service.resolver.IResolverRankerResult;













import android.service.resolver.ResolverTarget;



























/**













 * @hide













 */













oneway interface IResolverRankerService













{













    void predict(in List<ResolverTarget> targets, IResolverRankerResult result);













    void train(in List<ResolverTarget> targets, int selectedPosition);













}










 No newline at end of file
























core/java/android/service/resolver/ResolverRankerService.java
0 → 100644



+187
−0




























Original line number
Diff line number
Diff line













/*













 * Copyright (C) 2017 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.resolver;



























import android.annotation.SdkConstant;













import android.annotation.SystemApi;













import android.app.Service;













import android.content.ComponentName;













import android.content.Intent;













import android.os.IBinder;













import android.os.Handler;













import android.os.HandlerThread;













import android.os.RemoteException;













import android.service.resolver.ResolverTarget;













import android.util.Log;



























import java.util.List;













import java.util.Map;



























/**













 * A service to rank apps according to usage stats of apps, when the system is resolving targets for













 * an Intent.













 *













 * <p>To extend this class, you must declare the service in your manifest file with the













 * {@link android.Manifest.permission#BIND_RESOLVER_RANKER_SERVICE} permission, and include an













 * intent filter with the {@link #SERVICE_INTERFACE} action. For example:</p>













 * <pre>













 *     &lt;service android:name=".MyResolverRankerService"













 *             android:exported="true"













 *             android:priority="100"













 *             android:permission="android.permission.BIND_RESOLVER_RANKER_SERVICE"&gt;













 *         &lt;intent-filter&gt;













 *             &lt;action android:name="android.service.resolver.ResolverRankerService" /&gt;













 *         &lt;/intent-filter&gt;













 *     &lt;/service&gt;













 * </pre>













 * @hide













 */













@SystemApi













public abstract class ResolverRankerService extends Service {



























    private static final String TAG = "ResolverRankerService";



























    private static final boolean DEBUG = false;



























    /**













     * The Intent action that a service must respond to. Add it to the intent filter of the service













     * in its manifest.













     */













    @SdkConstant(SdkConstant.SdkConstantType.SERVICE_ACTION)













    public static final String SERVICE_INTERFACE = "android.service.resolver.ResolverRankerService";



























    /**













     * The permission that a service must require to ensure that only Android system can bind to it.













     * If this permission is not enforced in the AndroidManifest of the service, the system will













     * skip that service.













     */













    public static final String BIND_PERMISSION = "android.permission.BIND_RESOLVER_RANKER_SERVICE";



























    private ResolverRankerServiceWrapper mWrapper = null;



























    /**













     * Called by the system to retrieve a list of probabilities to rank apps/options. To implement













     * it, set selectProbability of each input {@link ResolverTarget}. The higher the













     * selectProbability is, the more likely the {@link ResolverTarget} will be selected by the













     * user. Override this function to provide prediction results.













     *













     * @param targets a list of {@link ResolverTarget}, for the list of apps to be ranked.













     *













     * @throws Exception when the prediction task fails.













     */













    public void onPredictSharingProbabilities(final List<ResolverTarget> targets) {}



























    /**













     * Called by the system to train/update a ranking service, after the user makes a selection from













     * the ranked list of apps. Override this function to enable model updates.













     *













     * @param targets a list of {@link ResolverTarget}, for the list of apps to be ranked.













     * @param selectedPosition the position of the selected app in the list.













     *













     * @throws Exception when the training task fails.













     */













    public void onTrainRankingModel(













            final List<ResolverTarget> targets, final int selectedPosition) {}



























    private static final String HANDLER_THREAD_NAME = "RESOLVER_RANKER_SERVICE";













    private volatile Handler mHandler;













    private HandlerThread mHandlerThread;



























    @Override













    public IBinder onBind(Intent intent) {













        if (DEBUG) Log.d(TAG, "onBind " + intent);













        if (!SERVICE_INTERFACE.equals(intent.getAction())) {













            if (DEBUG) Log.d(TAG, "bad intent action " + intent.getAction() + "; returning null");













            return null;













        }













        if (mHandlerThread == null) {













            mHandlerThread = new HandlerThread(HANDLER_THREAD_NAME);













            mHandlerThread.start();













            mHandler = new Handler(mHandlerThread.getLooper());













        }













        if (mWrapper == null) {













            mWrapper = new ResolverRankerServiceWrapper();













        }













        return mWrapper;













    }



























    @Override













    public void onDestroy() {













        mHandler = null;













        if (mHandlerThread != null) {













            mHandlerThread.quitSafely();













        }













        super.onDestroy();













    }



























    private static void sendResult(List<ResolverTarget> targets, IResolverRankerResult result) {













        try {













            result.sendResult(targets);













        } catch (Exception e) {













            Log.e(TAG, "failed to send results: " + e);













        }













    }



























    private class ResolverRankerServiceWrapper extends IResolverRankerService.Stub {



























        @Override













        public void predict(final List<ResolverTarget> targets, final IResolverRankerResult result)













                throws RemoteException {













            Runnable predictRunnable = new Runnable() {













                @Override













                public void run() {













                    try {













                        if (DEBUG) {













                            Log.d(TAG, "predict calls onPredictSharingProbabilities.");













                        }













                        onPredictSharingProbabilities(targets);













                        sendResult(targets, result);













                    } catch (Exception e) {













                        Log.e(TAG, "onPredictSharingProbabilities failed; send null results: " + e);













                        sendResult(null, result);













                    }













                }













            };













            final Handler h = mHandler;













            if (h != null) {













                h.post(predictRunnable);













            }













        }



























        @Override













        public void train(final List<ResolverTarget> targets, final int selectedPosition)













                throws RemoteException {













            Runnable trainRunnable = new Runnable() {













                @Override













                public void run() {













                    try {













                        if (DEBUG) {













                            Log.d(TAG, "train calls onTranRankingModel");













                        }













                        onTrainRankingModel(targets, selectedPosition);













                    } catch (Exception e) {













                        Log.e(TAG, "onTrainRankingModel failed; skip train: " + e);













                    }













                }













            };













            final Handler h = mHandler;













            if (h != null) {













                h.post(trainRunnable);













            }













        }













    }













}