372 lines
17 KiB
Java
372 lines
17 KiB
Java
|
/*
|
||
|
|
* 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.app;
|
||
|
|
|
||
|
|
import android.annotation.MainThread;
|
||
|
|
import android.annotation.NonNull;
|
||
|
|
import android.annotation.Nullable;
|
||
|
|
import android.annotation.SystemApi;
|
||
|
|
import android.content.Context;
|
||
|
|
import android.content.Intent;
|
||
|
|
import android.content.pm.InstantAppRequestInfo;
|
||
|
|
import android.content.pm.InstantAppResolveInfo;
|
||
|
|
import android.os.Build;
|
||
|
|
import android.os.Bundle;
|
||
|
|
import android.os.Handler;
|
||
|
|
import android.os.IBinder;
|
||
|
|
import android.os.IRemoteCallback;
|
||
|
|
import android.os.Looper;
|
||
|
|
import android.os.Message;
|
||
|
|
import android.os.RemoteException;
|
||
|
|
import android.os.UserHandle;
|
||
|
|
import android.util.Log;
|
||
|
|
import android.util.Slog;
|
||
|
|
|
||
|
|
import com.android.internal.annotations.VisibleForTesting;
|
||
|
|
import com.android.internal.os.SomeArgs;
|
||
|
|
|
||
|
|
import java.util.Arrays;
|
||
|
|
import java.util.Collections;
|
||
|
|
import java.util.List;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Base class for implementing the resolver service.
|
||
|
|
* @hide
|
||
|
|
*/
|
||
|
|
@SystemApi
|
||
|
|
public abstract class InstantAppResolverService extends Service {
|
||
|
|
private static final boolean DEBUG_INSTANT = Build.IS_DEBUGGABLE;
|
||
|
|
private static final String TAG = "PackageManager";
|
||
|
|
|
||
|
|
/** @hide */
|
||
|
|
public static final String EXTRA_RESOLVE_INFO = "android.app.extra.RESOLVE_INFO";
|
||
|
|
/** @hide */
|
||
|
|
public static final String EXTRA_SEQUENCE = "android.app.extra.SEQUENCE";
|
||
|
|
Handler mHandler;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Called to retrieve resolve info for instant applications immediately.
|
||
|
|
*
|
||
|
|
* @param digestPrefix The hash prefix of the instant app's domain.
|
||
|
|
*
|
||
|
|
* @deprecated Should implement {@link #onGetInstantAppResolveInfo(InstantAppRequestInfo,
|
||
|
|
* InstantAppResolutionCallback)}
|
||
|
|
*/
|
||
|
|
@Deprecated
|
||
|
|
public void onGetInstantAppResolveInfo(@Nullable int[] digestPrefix, @NonNull String token,
|
||
|
|
@NonNull InstantAppResolutionCallback callback) {
|
||
|
|
throw new IllegalStateException("Must define onGetInstantAppResolveInfo");
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Called to retrieve intent filters for instant applications from potentially expensive
|
||
|
|
* sources.
|
||
|
|
*
|
||
|
|
* @param digestPrefix The hash prefix of the instant app's domain.
|
||
|
|
*
|
||
|
|
* @deprecated Should implement {@link #onGetInstantAppIntentFilter(InstantAppRequestInfo,
|
||
|
|
* InstantAppResolutionCallback)}
|
||
|
|
*/
|
||
|
|
@Deprecated
|
||
|
|
public void onGetInstantAppIntentFilter(@Nullable int[] digestPrefix, @NonNull String token,
|
||
|
|
@NonNull InstantAppResolutionCallback callback) {
|
||
|
|
throw new IllegalStateException("Must define onGetInstantAppIntentFilter");
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Called to retrieve resolve info for instant applications immediately. The response will be
|
||
|
|
* ignored if not provided within a reasonable time. {@link InstantAppResolveInfo}s provided
|
||
|
|
* in response to this method may be partial to request a second phase of resolution which will
|
||
|
|
* result in a subsequent call to
|
||
|
|
* {@link #onGetInstantAppIntentFilter(Intent, int[], String, InstantAppResolutionCallback)}
|
||
|
|
*
|
||
|
|
* @param sanitizedIntent The sanitized {@link Intent} used for resolution. A sanitized Intent
|
||
|
|
* is an intent with potential PII removed from the original intent.
|
||
|
|
* Fields removed include extras and the host + path of the data, if
|
||
|
|
* defined.
|
||
|
|
* @param hostDigestPrefix The hash prefix of the instant app's domain.
|
||
|
|
* @param token A unique identifier that will be provided in calls to
|
||
|
|
* {@link #onGetInstantAppIntentFilter(Intent, int[], String,
|
||
|
|
* InstantAppResolutionCallback)}
|
||
|
|
* and provided to the installer via {@link Intent#EXTRA_INSTANT_APP_TOKEN} to
|
||
|
|
* tie a single launch together.
|
||
|
|
* @param callback The {@link InstantAppResolutionCallback} to provide results to.
|
||
|
|
*
|
||
|
|
* @see InstantAppResolveInfo
|
||
|
|
*
|
||
|
|
* @deprecated Should implement {@link #onGetInstantAppResolveInfo(InstantAppRequestInfo,
|
||
|
|
* InstantAppResolutionCallback)}
|
||
|
|
*/
|
||
|
|
@Deprecated
|
||
|
|
public void onGetInstantAppResolveInfo(@NonNull Intent sanitizedIntent,
|
||
|
|
@Nullable int[] hostDigestPrefix, @NonNull String token,
|
||
|
|
@NonNull InstantAppResolutionCallback callback) {
|
||
|
|
// if not overridden, forward to old methods and filter out non-web intents
|
||
|
|
if (sanitizedIntent.isWebIntent()) {
|
||
|
|
onGetInstantAppResolveInfo(hostDigestPrefix, token, callback);
|
||
|
|
} else {
|
||
|
|
callback.onInstantAppResolveInfo(Collections.emptyList());
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Called to retrieve intent filters for potentially matching instant applications. Unlike
|
||
|
|
* {@link #onGetInstantAppResolveInfo(Intent, int[], String, InstantAppResolutionCallback)},
|
||
|
|
* the response may take as long as necessary to respond. All {@link InstantAppResolveInfo}s
|
||
|
|
* provided in response to this method must be completely populated.
|
||
|
|
*
|
||
|
|
* @param sanitizedIntent The sanitized {@link Intent} used for resolution.
|
||
|
|
* @param hostDigestPrefix The hash prefix of the instant app's domain or null if no host is
|
||
|
|
* defined.
|
||
|
|
* @param token A unique identifier that was provided in
|
||
|
|
* {@link #onGetInstantAppResolveInfo(Intent, int[], String,
|
||
|
|
* InstantAppResolutionCallback)}
|
||
|
|
* and provided to the currently visible installer via
|
||
|
|
* {@link Intent#EXTRA_INSTANT_APP_TOKEN}.
|
||
|
|
* @param callback The {@link InstantAppResolutionCallback} to provide results to.
|
||
|
|
*
|
||
|
|
* @deprecated Should implement {@link #onGetInstantAppIntentFilter(InstantAppRequestInfo,
|
||
|
|
* InstantAppResolutionCallback)}
|
||
|
|
*/
|
||
|
|
@Deprecated
|
||
|
|
public void onGetInstantAppIntentFilter(@NonNull Intent sanitizedIntent,
|
||
|
|
@Nullable int[] hostDigestPrefix,
|
||
|
|
@NonNull String token, @NonNull InstantAppResolutionCallback callback) {
|
||
|
|
Log.e(TAG, "New onGetInstantAppIntentFilter is not overridden");
|
||
|
|
// if not overridden, forward to old methods and filter out non-web intents
|
||
|
|
if (sanitizedIntent.isWebIntent()) {
|
||
|
|
onGetInstantAppIntentFilter(hostDigestPrefix, token, callback);
|
||
|
|
} else {
|
||
|
|
callback.onInstantAppResolveInfo(Collections.emptyList());
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Called to retrieve resolve info for instant applications immediately. The response will be
|
||
|
|
* ignored if not provided within a reasonable time. {@link InstantAppResolveInfo}s provided
|
||
|
|
* in response to this method may be partial to request a second phase of resolution which will
|
||
|
|
* result in a subsequent call to {@link #onGetInstantAppIntentFilter(Intent, int[], UserHandle,
|
||
|
|
* String, InstantAppResolutionCallback)}
|
||
|
|
*
|
||
|
|
* @param sanitizedIntent The sanitized {@link Intent} used for resolution. A sanitized Intent
|
||
|
|
* is an intent with potential PII removed from the original intent.
|
||
|
|
* Fields removed include extras and the host + path of the data, if
|
||
|
|
* defined.
|
||
|
|
* @param hostDigestPrefix The hash prefix of the instant app's domain.
|
||
|
|
* @param userHandle The user for which to resolve the instant app.
|
||
|
|
* @param token A unique identifier that will be provided in calls to {@link
|
||
|
|
* #onGetInstantAppIntentFilter(Intent, int[], UserHandle, String,
|
||
|
|
* InstantAppResolutionCallback)} and provided to the installer via {@link
|
||
|
|
* Intent#EXTRA_INSTANT_APP_TOKEN} to tie a single launch together.
|
||
|
|
* @param callback The {@link InstantAppResolutionCallback} to provide results to.
|
||
|
|
*
|
||
|
|
* @see InstantAppResolveInfo
|
||
|
|
*
|
||
|
|
* @deprecated Should implement {@link #onGetInstantAppResolveInfo(InstantAppRequestInfo,
|
||
|
|
* InstantAppResolutionCallback
|
||
|
|
*/
|
||
|
|
@Deprecated
|
||
|
|
public void onGetInstantAppResolveInfo(@NonNull Intent sanitizedIntent,
|
||
|
|
@Nullable int[] hostDigestPrefix, @NonNull UserHandle userHandle,
|
||
|
|
@NonNull String token, @NonNull InstantAppResolutionCallback callback) {
|
||
|
|
// If not overridden, forward to the old method.
|
||
|
|
onGetInstantAppResolveInfo(sanitizedIntent, hostDigestPrefix, token, callback);
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Called to retrieve intent filters for potentially matching instant applications. Unlike
|
||
|
|
* {@link #onGetInstantAppResolveInfo(Intent, int[], UserHandle, String,
|
||
|
|
* InstantAppResolutionCallback)}, the response may take as long as necessary to respond. All
|
||
|
|
* {@link InstantAppResolveInfo}s provided in response to this method must be completely
|
||
|
|
* populated.
|
||
|
|
*
|
||
|
|
* @param sanitizedIntent The sanitized {@link Intent} used for resolution.
|
||
|
|
* @param hostDigestPrefix The hash prefix of the instant app's domain or null if no host is
|
||
|
|
* defined.
|
||
|
|
* @param userHandle The user for which to resolve the instant app.
|
||
|
|
* @param token A unique identifier that was provided in {@link #onGetInstantAppResolveInfo(
|
||
|
|
* Intent, int[], UserHandle, String, InstantAppResolutionCallback)} and provided
|
||
|
|
* to the currently visible installer via {@link Intent#EXTRA_INSTANT_APP_TOKEN}.
|
||
|
|
* @param callback The {@link InstantAppResolutionCallback} to provide results to.
|
||
|
|
*
|
||
|
|
* @deprecated Should implement {@link #onGetInstantAppIntentFilter(InstantAppRequestInfo,
|
||
|
|
* InstantAppResolutionCallback)}
|
||
|
|
*/
|
||
|
|
@Deprecated
|
||
|
|
public void onGetInstantAppIntentFilter(@NonNull Intent sanitizedIntent,
|
||
|
|
@Nullable int[] hostDigestPrefix, @NonNull UserHandle userHandle,
|
||
|
|
@NonNull String token, @NonNull InstantAppResolutionCallback callback) {
|
||
|
|
// If not overridden, forward to the old method.
|
||
|
|
onGetInstantAppIntentFilter(sanitizedIntent, hostDigestPrefix, token, callback);
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Called to retrieve resolve info for instant applications immediately. The response will be
|
||
|
|
* ignored if not provided within a reasonable time. {@link InstantAppResolveInfo}s provided
|
||
|
|
* in response to this method may be partial to request a second phase of resolution which will
|
||
|
|
* result in a subsequent call to {@link #onGetInstantAppIntentFilter(InstantAppRequestInfo,
|
||
|
|
* InstantAppResolutionCallback)}
|
||
|
|
*
|
||
|
|
* @param request The parameters for this resolution request
|
||
|
|
* @param callback The {@link InstantAppResolutionCallback} to provide results to.
|
||
|
|
*
|
||
|
|
* @see InstantAppResolveInfo
|
||
|
|
*/
|
||
|
|
@MainThread
|
||
|
|
public void onGetInstantAppResolveInfo(@NonNull InstantAppRequestInfo request,
|
||
|
|
@NonNull InstantAppResolutionCallback callback) {
|
||
|
|
// If not overridden, forward to the old method.
|
||
|
|
onGetInstantAppResolveInfo(request.getIntent(), request.getHostDigestPrefix(),
|
||
|
|
request.getUserHandle(), request.getToken(), callback);
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Called to retrieve intent filters for potentially matching instant applications. Unlike
|
||
|
|
* {@link #onGetInstantAppResolveInfo(InstantAppRequestInfo, InstantAppResolutionCallback)},
|
||
|
|
* the response may take as long as necessary to respond. All {@link InstantAppResolveInfo}s
|
||
|
|
* provided in response to this method must be completely populated.
|
||
|
|
*
|
||
|
|
* @param request The parameters for this resolution request
|
||
|
|
* @param callback The {@link InstantAppResolutionCallback} to provide results to.
|
||
|
|
*/
|
||
|
|
@MainThread
|
||
|
|
public void onGetInstantAppIntentFilter(@NonNull InstantAppRequestInfo request,
|
||
|
|
@NonNull InstantAppResolutionCallback callback) {
|
||
|
|
// If not overridden, forward to the old method.
|
||
|
|
onGetInstantAppIntentFilter(request.getIntent(), request.getHostDigestPrefix(),
|
||
|
|
request.getUserHandle(), request.getToken(), callback);
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Returns a {@link Looper} to perform service operations on.
|
||
|
|
*/
|
||
|
|
Looper getLooper() {
|
||
|
|
return getBaseContext().getMainLooper();
|
||
|
|
}
|
||
|
|
|
||
|
|
@Override
|
||
|
|
public final void attachBaseContext(Context base) {
|
||
|
|
super.attachBaseContext(base);
|
||
|
|
mHandler = new ServiceHandler(getLooper());
|
||
|
|
}
|
||
|
|
|
||
|
|
@Override
|
||
|
|
public final IBinder onBind(Intent intent) {
|
||
|
|
return new IInstantAppResolver.Stub() {
|
||
|
|
@Override
|
||
|
|
public void getInstantAppResolveInfoList(InstantAppRequestInfo request, int sequence,
|
||
|
|
IRemoteCallback callback) {
|
||
|
|
if (DEBUG_INSTANT) {
|
||
|
|
Slog.v(TAG, "[" + request.getToken() + "] Phase1 called; posting");
|
||
|
|
}
|
||
|
|
final SomeArgs args = SomeArgs.obtain();
|
||
|
|
args.arg1 = request;
|
||
|
|
args.arg2 = callback;
|
||
|
|
mHandler.obtainMessage(ServiceHandler.MSG_GET_INSTANT_APP_RESOLVE_INFO, sequence,
|
||
|
|
0, args).sendToTarget();
|
||
|
|
}
|
||
|
|
|
||
|
|
@Override
|
||
|
|
public void getInstantAppIntentFilterList(InstantAppRequestInfo request,
|
||
|
|
IRemoteCallback callback) {
|
||
|
|
if (DEBUG_INSTANT) {
|
||
|
|
Slog.v(TAG, "[" + request.getToken() + "] Phase2 called; posting");
|
||
|
|
}
|
||
|
|
final SomeArgs args = SomeArgs.obtain();
|
||
|
|
args.arg1 = request;
|
||
|
|
args.arg2 = callback;
|
||
|
|
mHandler.obtainMessage(ServiceHandler.MSG_GET_INSTANT_APP_INTENT_FILTER, args)
|
||
|
|
.sendToTarget();
|
||
|
|
}
|
||
|
|
};
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Callback to post results from instant app resolution.
|
||
|
|
*/
|
||
|
|
public static final class InstantAppResolutionCallback {
|
||
|
|
private final IRemoteCallback mCallback;
|
||
|
|
private final int mSequence;
|
||
|
|
|
||
|
|
/** @hide **/
|
||
|
|
@VisibleForTesting(visibility = VisibleForTesting.Visibility.PACKAGE)
|
||
|
|
public InstantAppResolutionCallback(int sequence, IRemoteCallback callback) {
|
||
|
|
mCallback = callback;
|
||
|
|
mSequence = sequence;
|
||
|
|
}
|
||
|
|
|
||
|
|
public void onInstantAppResolveInfo(List<InstantAppResolveInfo> resolveInfo) {
|
||
|
|
final Bundle data = new Bundle();
|
||
|
|
data.putParcelableList(EXTRA_RESOLVE_INFO, resolveInfo);
|
||
|
|
data.putInt(EXTRA_SEQUENCE, mSequence);
|
||
|
|
try {
|
||
|
|
mCallback.sendResult(data);
|
||
|
|
} catch (RemoteException e) {
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
private final class ServiceHandler extends Handler {
|
||
|
|
public static final int MSG_GET_INSTANT_APP_RESOLVE_INFO = 1;
|
||
|
|
public static final int MSG_GET_INSTANT_APP_INTENT_FILTER = 2;
|
||
|
|
public ServiceHandler(Looper looper) {
|
||
|
|
super(looper, null /*callback*/, true /*async*/);
|
||
|
|
}
|
||
|
|
|
||
|
|
@Override
|
||
|
|
@SuppressWarnings("unchecked")
|
||
|
|
public void handleMessage(Message message) {
|
||
|
|
final int action = message.what;
|
||
|
|
switch (action) {
|
||
|
|
case MSG_GET_INSTANT_APP_RESOLVE_INFO: {
|
||
|
|
final SomeArgs args = (SomeArgs) message.obj;
|
||
|
|
final InstantAppRequestInfo request = (InstantAppRequestInfo) args.arg1;
|
||
|
|
final IRemoteCallback callback = (IRemoteCallback) args.arg2;
|
||
|
|
args.recycle();
|
||
|
|
final int sequence = message.arg1;
|
||
|
|
if (DEBUG_INSTANT) {
|
||
|
|
Slog.d(TAG, "[" + request.getToken() + "] Phase1 request;"
|
||
|
|
+ " prefix: " + Arrays.toString(request.getHostDigestPrefix())
|
||
|
|
+ ", userId: " + request.getUserHandle().getIdentifier());
|
||
|
|
}
|
||
|
|
onGetInstantAppResolveInfo(request,
|
||
|
|
new InstantAppResolutionCallback(sequence, callback));
|
||
|
|
} break;
|
||
|
|
|
||
|
|
case MSG_GET_INSTANT_APP_INTENT_FILTER: {
|
||
|
|
final SomeArgs args = (SomeArgs) message.obj;
|
||
|
|
final InstantAppRequestInfo request = (InstantAppRequestInfo) args.arg1;
|
||
|
|
final IRemoteCallback callback = (IRemoteCallback) args.arg2;
|
||
|
|
args.recycle();
|
||
|
|
if (DEBUG_INSTANT) {
|
||
|
|
Slog.d(TAG, "[" + request.getToken() + "] Phase2 request;"
|
||
|
|
+ " prefix: " + Arrays.toString(request.getHostDigestPrefix())
|
||
|
|
+ ", userId: " + request.getUserHandle().getIdentifier());
|
||
|
|
}
|
||
|
|
onGetInstantAppIntentFilter(request,
|
||
|
|
new InstantAppResolutionCallback(-1 /*sequence*/, callback));
|
||
|
|
}
|
||
|
|
break;
|
||
|
|
|
||
|
|
default: {
|
||
|
|
throw new IllegalArgumentException("Unknown message: " + action);
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|