Jason Monk | 8f5f7ff | 2017-10-17 14:12:42 -0400 | [diff] [blame] | 1 | /* |
| 2 | * Copyright (C) 2017 The Android Open Source Project |
| 3 | * |
| 4 | * Licensed under the Apache License, Version 2.0 (the "License"); |
| 5 | * you may not use this file except in compliance with the License. |
| 6 | * You may obtain a copy of the License at |
| 7 | * |
| 8 | * http://www.apache.org/licenses/LICENSE-2.0 |
| 9 | * |
| 10 | * Unless required by applicable law or agreed to in writing, software |
| 11 | * distributed under the License is distributed on an "AS IS" BASIS, |
| 12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| 13 | * See the License for the specific language governing permissions and |
| 14 | * limitations under the License. |
| 15 | */ |
| 16 | |
| 17 | package android.app.slice; |
| 18 | |
Jason Monk | bf3eedc | 2018-04-05 20:56:42 -0400 | [diff] [blame] | 19 | import static android.content.pm.PackageManager.PERMISSION_DENIED; |
| 20 | |
Jason Monk | e2c6451 | 2017-12-11 15:14:54 -0500 | [diff] [blame] | 21 | import android.annotation.NonNull; |
Jason Monk | b9e06a8 | 2018-01-16 15:32:53 -0500 | [diff] [blame] | 22 | import android.annotation.Nullable; |
Jason Monk | 5e676a2 | 2018-03-08 14:18:55 -0500 | [diff] [blame] | 23 | import android.annotation.SdkConstant; |
| 24 | import android.annotation.SdkConstant.SdkConstantType; |
Jason Monk | 8f5f7ff | 2017-10-17 14:12:42 -0400 | [diff] [blame] | 25 | import android.annotation.SystemService; |
Jason Monk | a66dfee | 2018-05-11 08:23:59 -0700 | [diff] [blame] | 26 | import android.annotation.WorkerThread; |
Jason Monk | 632def1 | 2018-02-01 15:21:16 -0500 | [diff] [blame] | 27 | import android.content.ContentProviderClient; |
Jason Monk | b9e06a8 | 2018-01-16 15:32:53 -0500 | [diff] [blame] | 28 | import android.content.ContentResolver; |
Jason Monk | 8f5f7ff | 2017-10-17 14:12:42 -0400 | [diff] [blame] | 29 | import android.content.Context; |
Jason Monk | b9e06a8 | 2018-01-16 15:32:53 -0500 | [diff] [blame] | 30 | import android.content.Intent; |
Jason Monk | f200887 | 2018-02-23 08:59:31 -0500 | [diff] [blame] | 31 | import android.content.pm.PackageManager; |
Jason Monk | 7188855 | 2018-03-30 14:14:51 -0400 | [diff] [blame] | 32 | import android.content.pm.PackageManager.PermissionResult; |
Jason Monk | b9e06a8 | 2018-01-16 15:32:53 -0500 | [diff] [blame] | 33 | import android.content.pm.ResolveInfo; |
Jason Monk | 74f5e36 | 2017-12-06 08:56:33 -0500 | [diff] [blame] | 34 | import android.net.Uri; |
Jason Monk | 38df280 | 2018-02-22 19:28:12 -0500 | [diff] [blame] | 35 | import android.os.Binder; |
Jason Monk | b9e06a8 | 2018-01-16 15:32:53 -0500 | [diff] [blame] | 36 | import android.os.Bundle; |
Jason Monk | 8f5f7ff | 2017-10-17 14:12:42 -0400 | [diff] [blame] | 37 | import android.os.Handler; |
Jason Monk | 38df280 | 2018-02-22 19:28:12 -0500 | [diff] [blame] | 38 | import android.os.IBinder; |
Jason Monk | ac11238 | 2018-03-23 15:06:35 -0400 | [diff] [blame] | 39 | import android.os.Process; |
Jason Monk | 74f5e36 | 2017-12-06 08:56:33 -0500 | [diff] [blame] | 40 | import android.os.RemoteException; |
Jason Monk | 8f5f7ff | 2017-10-17 14:12:42 -0400 | [diff] [blame] | 41 | import android.os.ServiceManager; |
| 42 | import android.os.ServiceManager.ServiceNotFoundException; |
Jason Monk | ac11238 | 2018-03-23 15:06:35 -0400 | [diff] [blame] | 43 | import android.os.UserHandle; |
Jason Monk | 2d3932e | 2018-03-08 11:31:26 -0500 | [diff] [blame] | 44 | import android.util.ArraySet; |
Jason Monk | 5f8cc27 | 2018-01-16 17:57:20 -0500 | [diff] [blame] | 45 | import android.util.Log; |
Jason Monk | e2c6451 | 2017-12-11 15:14:54 -0500 | [diff] [blame] | 46 | |
Jason Monk | b9e06a8 | 2018-01-16 15:32:53 -0500 | [diff] [blame] | 47 | import com.android.internal.util.Preconditions; |
| 48 | |
| 49 | import java.util.ArrayList; |
Jason Monk | e2c6451 | 2017-12-11 15:14:54 -0500 | [diff] [blame] | 50 | import java.util.Arrays; |
Jason Monk | 5f8cc27 | 2018-01-16 17:57:20 -0500 | [diff] [blame] | 51 | import java.util.Collection; |
| 52 | import java.util.Collections; |
Jason Monk | e2c6451 | 2017-12-11 15:14:54 -0500 | [diff] [blame] | 53 | import java.util.List; |
Jason Monk | 2d3932e | 2018-03-08 11:31:26 -0500 | [diff] [blame] | 54 | import java.util.Set; |
Jason Monk | 8f5f7ff | 2017-10-17 14:12:42 -0400 | [diff] [blame] | 55 | |
| 56 | /** |
Jason Monk | e2c6451 | 2017-12-11 15:14:54 -0500 | [diff] [blame] | 57 | * Class to handle interactions with {@link Slice}s. |
| 58 | * <p> |
| 59 | * The SliceManager manages permissions and pinned state for slices. |
Jason Monk | 8f5f7ff | 2017-10-17 14:12:42 -0400 | [diff] [blame] | 60 | */ |
| 61 | @SystemService(Context.SLICE_SERVICE) |
| 62 | public class SliceManager { |
| 63 | |
Jason Monk | 5f8cc27 | 2018-01-16 17:57:20 -0500 | [diff] [blame] | 64 | private static final String TAG = "SliceManager"; |
| 65 | |
Jason Monk | e8f8be7 | 2018-01-21 10:10:35 -0500 | [diff] [blame] | 66 | /** |
| 67 | * @hide |
| 68 | */ |
| 69 | public static final String ACTION_REQUEST_SLICE_PERMISSION = |
Jason Monk | 0c179a9 | 2018-04-18 10:37:19 -0400 | [diff] [blame] | 70 | "com.android.intent.action.REQUEST_SLICE_PERMISSION"; |
Jason Monk | e8f8be7 | 2018-01-21 10:10:35 -0500 | [diff] [blame] | 71 | |
Mady Mellor | 3267ed8 | 2018-02-21 11:42:31 -0800 | [diff] [blame] | 72 | /** |
Jason Monk | 5e676a2 | 2018-03-08 14:18:55 -0500 | [diff] [blame] | 73 | * Category used to resolve intents that can be rendered as slices. |
| 74 | * <p> |
| 75 | * This category should be included on intent filters on providers that extend |
| 76 | * {@link SliceProvider}. |
| 77 | * @see SliceProvider |
| 78 | * @see SliceProvider#onMapIntentToUri(Intent) |
| 79 | * @see #mapIntentToUri(Intent) |
| 80 | */ |
| 81 | @SdkConstant(SdkConstantType.INTENT_CATEGORY) |
| 82 | public static final String CATEGORY_SLICE = "android.app.slice.category.SLICE"; |
| 83 | |
| 84 | /** |
Mady Mellor | 3267ed8 | 2018-02-21 11:42:31 -0800 | [diff] [blame] | 85 | * The meta-data key that allows an activity to easily be linked directly to a slice. |
| 86 | * <p> |
| 87 | * An activity can be statically linked to a slice uri by including a meta-data item |
| 88 | * for this key that contains a valid slice uri for the same application declaring |
| 89 | * the activity. |
Jason Monk | 39b9fb3 | 2018-03-27 10:45:23 -0400 | [diff] [blame] | 90 | * |
| 91 | * <pre class="prettyprint"> |
| 92 | * {@literal |
| 93 | * <activity android:name="com.example.mypkg.MyActivity"> |
| 94 | * <meta-data android:name="android.metadata.SLICE_URI" |
| 95 | * android:value="content://com.example.mypkg/main_slice" /> |
| 96 | * </activity>} |
| 97 | * </pre> |
| 98 | * |
| 99 | * @see #mapIntentToUri(Intent) |
| 100 | * @see SliceProvider#onMapIntentToUri(Intent) |
Mady Mellor | 3267ed8 | 2018-02-21 11:42:31 -0800 | [diff] [blame] | 101 | */ |
| 102 | public static final String SLICE_METADATA_KEY = "android.metadata.SLICE_URI"; |
| 103 | |
Jason Monk | 8f5f7ff | 2017-10-17 14:12:42 -0400 | [diff] [blame] | 104 | private final ISliceManager mService; |
| 105 | private final Context mContext; |
Jason Monk | 38df280 | 2018-02-22 19:28:12 -0500 | [diff] [blame] | 106 | private final IBinder mToken = new Binder(); |
Jason Monk | 8f5f7ff | 2017-10-17 14:12:42 -0400 | [diff] [blame] | 107 | |
Jason Monk | e2c6451 | 2017-12-11 15:14:54 -0500 | [diff] [blame] | 108 | /** |
| 109 | * @hide |
| 110 | */ |
Jason Monk | 8f5f7ff | 2017-10-17 14:12:42 -0400 | [diff] [blame] | 111 | public SliceManager(Context context, Handler handler) throws ServiceNotFoundException { |
| 112 | mContext = context; |
| 113 | mService = ISliceManager.Stub.asInterface( |
| 114 | ServiceManager.getServiceOrThrow(Context.SLICE_SERVICE)); |
| 115 | } |
Jason Monk | 74f5e36 | 2017-12-06 08:56:33 -0500 | [diff] [blame] | 116 | |
| 117 | /** |
Jason Monk | e2c6451 | 2017-12-11 15:14:54 -0500 | [diff] [blame] | 118 | * Ensures that a slice is in a pinned state. |
| 119 | * <p> |
| 120 | * Pinned state is not persisted across reboots, so apps are expected to re-pin any slices |
| 121 | * they still care about after a reboot. |
Jason Monk | 632def1 | 2018-02-01 15:21:16 -0500 | [diff] [blame] | 122 | * <p> |
| 123 | * This may only be called by apps that are the default launcher for the device |
| 124 | * or the default voice interaction service. Otherwise will throw {@link SecurityException}. |
Jason Monk | e2c6451 | 2017-12-11 15:14:54 -0500 | [diff] [blame] | 125 | * |
| 126 | * @param uri The uri of the slice being pinned. |
| 127 | * @param specs The list of supported {@link SliceSpec}s of the callback. |
| 128 | * @see SliceProvider#onSlicePinned(Uri) |
Jason Monk | 632def1 | 2018-02-01 15:21:16 -0500 | [diff] [blame] | 129 | * @see Intent#ACTION_ASSIST |
| 130 | * @see Intent#CATEGORY_HOME |
Jason Monk | 74f5e36 | 2017-12-06 08:56:33 -0500 | [diff] [blame] | 131 | */ |
Jason Monk | 2d3932e | 2018-03-08 11:31:26 -0500 | [diff] [blame] | 132 | public void pinSlice(@NonNull Uri uri, @NonNull Set<SliceSpec> specs) { |
Jason Monk | 74f5e36 | 2017-12-06 08:56:33 -0500 | [diff] [blame] | 133 | try { |
Jason Monk | e2c6451 | 2017-12-11 15:14:54 -0500 | [diff] [blame] | 134 | mService.pinSlice(mContext.getPackageName(), uri, |
Jason Monk | 38df280 | 2018-02-22 19:28:12 -0500 | [diff] [blame] | 135 | specs.toArray(new SliceSpec[specs.size()]), mToken); |
Jason Monk | 74f5e36 | 2017-12-06 08:56:33 -0500 | [diff] [blame] | 136 | } catch (RemoteException e) { |
| 137 | throw e.rethrowFromSystemServer(); |
| 138 | } |
| 139 | } |
| 140 | |
| 141 | /** |
Jason Monk | 2d3932e | 2018-03-08 11:31:26 -0500 | [diff] [blame] | 142 | * @deprecated TO BE REMOVED |
Jeff Sharkey | 3990ee1 | 2018-04-11 10:19:55 -0600 | [diff] [blame] | 143 | * @removed |
Jason Monk | 2d3932e | 2018-03-08 11:31:26 -0500 | [diff] [blame] | 144 | */ |
| 145 | @Deprecated |
| 146 | public void pinSlice(@NonNull Uri uri, @NonNull List<SliceSpec> specs) { |
| 147 | pinSlice(uri, new ArraySet<>(specs)); |
| 148 | } |
| 149 | |
| 150 | /** |
Jason Monk | e2c6451 | 2017-12-11 15:14:54 -0500 | [diff] [blame] | 151 | * Remove a pin for a slice. |
| 152 | * <p> |
| 153 | * If the slice has no other pins/callbacks then the slice will be unpinned. |
Jason Monk | 632def1 | 2018-02-01 15:21:16 -0500 | [diff] [blame] | 154 | * <p> |
| 155 | * This may only be called by apps that are the default launcher for the device |
| 156 | * or the default voice interaction service. Otherwise will throw {@link SecurityException}. |
Jason Monk | e2c6451 | 2017-12-11 15:14:54 -0500 | [diff] [blame] | 157 | * |
| 158 | * @param uri The uri of the slice being unpinned. |
| 159 | * @see #pinSlice |
| 160 | * @see SliceProvider#onSliceUnpinned(Uri) |
Jason Monk | 632def1 | 2018-02-01 15:21:16 -0500 | [diff] [blame] | 161 | * @see Intent#ACTION_ASSIST |
| 162 | * @see Intent#CATEGORY_HOME |
Jason Monk | 74f5e36 | 2017-12-06 08:56:33 -0500 | [diff] [blame] | 163 | */ |
Jason Monk | e2c6451 | 2017-12-11 15:14:54 -0500 | [diff] [blame] | 164 | public void unpinSlice(@NonNull Uri uri) { |
Jason Monk | 74f5e36 | 2017-12-06 08:56:33 -0500 | [diff] [blame] | 165 | try { |
Jason Monk | 38df280 | 2018-02-22 19:28:12 -0500 | [diff] [blame] | 166 | mService.unpinSlice(mContext.getPackageName(), uri, mToken); |
Jason Monk | 74f5e36 | 2017-12-06 08:56:33 -0500 | [diff] [blame] | 167 | } catch (RemoteException e) { |
| 168 | throw e.rethrowFromSystemServer(); |
| 169 | } |
| 170 | } |
| 171 | |
| 172 | /** |
Jason Monk | e2c6451 | 2017-12-11 15:14:54 -0500 | [diff] [blame] | 173 | * @hide |
Jason Monk | 74f5e36 | 2017-12-06 08:56:33 -0500 | [diff] [blame] | 174 | */ |
| 175 | public boolean hasSliceAccess() { |
| 176 | try { |
| 177 | return mService.hasSliceAccess(mContext.getPackageName()); |
| 178 | } catch (RemoteException e) { |
| 179 | throw e.rethrowFromSystemServer(); |
| 180 | } |
| 181 | } |
| 182 | |
| 183 | /** |
Jason Monk | e2c6451 | 2017-12-11 15:14:54 -0500 | [diff] [blame] | 184 | * Get the current set of specs for a pinned slice. |
| 185 | * <p> |
| 186 | * This is the set of specs supported for a specific pinned slice. It will take |
| 187 | * into account all clients and returns only specs supported by all. |
| 188 | * @see SliceSpec |
Jason Monk | 74f5e36 | 2017-12-06 08:56:33 -0500 | [diff] [blame] | 189 | */ |
Jason Monk | 2d3932e | 2018-03-08 11:31:26 -0500 | [diff] [blame] | 190 | public @NonNull Set<SliceSpec> getPinnedSpecs(Uri uri) { |
Jason Monk | 74f5e36 | 2017-12-06 08:56:33 -0500 | [diff] [blame] | 191 | try { |
Jason Monk | 2d3932e | 2018-03-08 11:31:26 -0500 | [diff] [blame] | 192 | return new ArraySet<>(Arrays.asList(mService.getPinnedSpecs(uri, |
| 193 | mContext.getPackageName()))); |
Jason Monk | 74f5e36 | 2017-12-06 08:56:33 -0500 | [diff] [blame] | 194 | } catch (RemoteException e) { |
| 195 | throw e.rethrowFromSystemServer(); |
| 196 | } |
| 197 | } |
| 198 | |
| 199 | /** |
Jason Monk | f88d25e | 2018-03-06 20:13:24 -0500 | [diff] [blame] | 200 | * Get the list of currently pinned slices for this app. |
| 201 | * @see SliceProvider#onSlicePinned |
| 202 | */ |
| 203 | public @NonNull List<Uri> getPinnedSlices() { |
| 204 | try { |
| 205 | return Arrays.asList(mService.getPinnedSlices(mContext.getPackageName())); |
| 206 | } catch (RemoteException e) { |
| 207 | throw e.rethrowFromSystemServer(); |
| 208 | } |
| 209 | } |
| 210 | |
| 211 | /** |
Jason Monk | 5f8cc27 | 2018-01-16 17:57:20 -0500 | [diff] [blame] | 212 | * Obtains a list of slices that are descendants of the specified Uri. |
| 213 | * <p> |
| 214 | * Not all slice providers will implement this functionality, in which case, |
| 215 | * an empty collection will be returned. |
| 216 | * |
| 217 | * @param uri The uri to look for descendants under. |
| 218 | * @return All slices within the space. |
| 219 | * @see SliceProvider#onGetSliceDescendants(Uri) |
| 220 | */ |
Jason Monk | a66dfee | 2018-05-11 08:23:59 -0700 | [diff] [blame] | 221 | @WorkerThread |
Jason Monk | 5f8cc27 | 2018-01-16 17:57:20 -0500 | [diff] [blame] | 222 | public @NonNull Collection<Uri> getSliceDescendants(@NonNull Uri uri) { |
| 223 | ContentResolver resolver = mContext.getContentResolver(); |
Jason Monk | ce1bead | 2018-05-31 14:12:52 -0400 | [diff] [blame] | 224 | try (ContentProviderClient provider = resolver.acquireUnstableContentProviderClient(uri)) { |
Jason Monk | 5f8cc27 | 2018-01-16 17:57:20 -0500 | [diff] [blame] | 225 | Bundle extras = new Bundle(); |
| 226 | extras.putParcelable(SliceProvider.EXTRA_BIND_URI, uri); |
Jason Monk | 632def1 | 2018-02-01 15:21:16 -0500 | [diff] [blame] | 227 | final Bundle res = provider.call(SliceProvider.METHOD_GET_DESCENDANTS, null, extras); |
Jason Monk | 5f8cc27 | 2018-01-16 17:57:20 -0500 | [diff] [blame] | 228 | return res.getParcelableArrayList(SliceProvider.EXTRA_SLICE_DESCENDANTS); |
| 229 | } catch (RemoteException e) { |
| 230 | Log.e(TAG, "Unable to get slice descendants", e); |
Jason Monk | 5f8cc27 | 2018-01-16 17:57:20 -0500 | [diff] [blame] | 231 | } |
| 232 | return Collections.emptyList(); |
| 233 | } |
| 234 | |
| 235 | /** |
Jason Monk | b9e06a8 | 2018-01-16 15:32:53 -0500 | [diff] [blame] | 236 | * Turns a slice Uri into slice content. |
| 237 | * |
| 238 | * @param uri The URI to a slice provider |
| 239 | * @param supportedSpecs List of supported specs. |
| 240 | * @return The Slice provided by the app or null if none is given. |
| 241 | * @see Slice |
| 242 | */ |
Jason Monk | 2d3932e | 2018-03-08 11:31:26 -0500 | [diff] [blame] | 243 | public @Nullable Slice bindSlice(@NonNull Uri uri, @NonNull Set<SliceSpec> supportedSpecs) { |
Jason Monk | b9e06a8 | 2018-01-16 15:32:53 -0500 | [diff] [blame] | 244 | Preconditions.checkNotNull(uri, "uri"); |
| 245 | ContentResolver resolver = mContext.getContentResolver(); |
Jason Monk | ce1bead | 2018-05-31 14:12:52 -0400 | [diff] [blame] | 246 | try (ContentProviderClient provider = resolver.acquireUnstableContentProviderClient(uri)) { |
Jason Monk | 632def1 | 2018-02-01 15:21:16 -0500 | [diff] [blame] | 247 | if (provider == null) { |
Steven Wu | a14c6b9 | 2018-05-22 09:08:22 -0400 | [diff] [blame] | 248 | Log.w(TAG, String.format("Unknown URI: %s", uri)); |
| 249 | return null; |
Jason Monk | 632def1 | 2018-02-01 15:21:16 -0500 | [diff] [blame] | 250 | } |
Jason Monk | b9e06a8 | 2018-01-16 15:32:53 -0500 | [diff] [blame] | 251 | Bundle extras = new Bundle(); |
| 252 | extras.putParcelable(SliceProvider.EXTRA_BIND_URI, uri); |
| 253 | extras.putParcelableArrayList(SliceProvider.EXTRA_SUPPORTED_SPECS, |
| 254 | new ArrayList<>(supportedSpecs)); |
Jason Monk | 632def1 | 2018-02-01 15:21:16 -0500 | [diff] [blame] | 255 | final Bundle res = provider.call(SliceProvider.METHOD_SLICE, null, extras); |
Jason Monk | b9e06a8 | 2018-01-16 15:32:53 -0500 | [diff] [blame] | 256 | Bundle.setDefusable(res, true); |
| 257 | if (res == null) { |
| 258 | return null; |
| 259 | } |
| 260 | return res.getParcelable(SliceProvider.EXTRA_SLICE); |
| 261 | } catch (RemoteException e) { |
| 262 | // Arbitrary and not worth documenting, as Activity |
| 263 | // Manager will kill this process shortly anyway. |
| 264 | return null; |
Jason Monk | b9e06a8 | 2018-01-16 15:32:53 -0500 | [diff] [blame] | 265 | } |
| 266 | } |
| 267 | |
| 268 | /** |
Jason Monk | 2d3932e | 2018-03-08 11:31:26 -0500 | [diff] [blame] | 269 | * @deprecated TO BE REMOVED |
Jeff Sharkey | 3990ee1 | 2018-04-11 10:19:55 -0600 | [diff] [blame] | 270 | * @removed |
Jason Monk | 2d3932e | 2018-03-08 11:31:26 -0500 | [diff] [blame] | 271 | */ |
| 272 | @Deprecated |
| 273 | public @Nullable Slice bindSlice(@NonNull Uri uri, @NonNull List<SliceSpec> supportedSpecs) { |
| 274 | return bindSlice(uri, new ArraySet<>(supportedSpecs)); |
| 275 | } |
| 276 | |
| 277 | /** |
Jason Monk | f200887 | 2018-02-23 08:59:31 -0500 | [diff] [blame] | 278 | * Turns a slice intent into a slice uri. Expects an explicit intent. |
Jason Monk | 5e676a2 | 2018-03-08 14:18:55 -0500 | [diff] [blame] | 279 | * <p> |
| 280 | * This goes through a several stage resolution process to determine if any slice |
| 281 | * can represent this intent. |
Jason Monk | 39b9fb3 | 2018-03-27 10:45:23 -0400 | [diff] [blame] | 282 | * <ol> |
| 283 | * <li> If the intent contains data that {@link ContentResolver#getType} is |
| 284 | * {@link SliceProvider#SLICE_TYPE} then the data will be returned.</li> |
Jason Monk | 5ffacd0 | 2018-04-10 15:00:18 -0400 | [diff] [blame] | 285 | * <li>If the intent explicitly points at an activity, and that activity has |
Jason Monk | 5e676a2 | 2018-03-08 14:18:55 -0500 | [diff] [blame] | 286 | * meta-data for key {@link #SLICE_METADATA_KEY}, then the Uri specified there will be |
Jason Monk | 39b9fb3 | 2018-03-27 10:45:23 -0400 | [diff] [blame] | 287 | * returned.</li> |
Jason Monk | 5ffacd0 | 2018-04-10 15:00:18 -0400 | [diff] [blame] | 288 | * <li>Lastly, if the intent with {@link #CATEGORY_SLICE} added resolves to a provider, then |
| 289 | * the provider will be asked to {@link SliceProvider#onMapIntentToUri} and that result |
| 290 | * will be returned.</li> |
Jason Monk | 39b9fb3 | 2018-03-27 10:45:23 -0400 | [diff] [blame] | 291 | * <li>If no slice is found, then {@code null} is returned.</li> |
| 292 | * </ol> |
Jason Monk | 7b8fef2 | 2018-01-30 16:04:14 -0500 | [diff] [blame] | 293 | * @param intent The intent associated with a slice. |
Jason Monk | f200887 | 2018-02-23 08:59:31 -0500 | [diff] [blame] | 294 | * @return The Slice Uri provided by the app or null if none exists. |
Jason Monk | 7b8fef2 | 2018-01-30 16:04:14 -0500 | [diff] [blame] | 295 | * @see Slice |
| 296 | * @see SliceProvider#onMapIntentToUri(Intent) |
| 297 | * @see Intent |
| 298 | */ |
| 299 | public @Nullable Uri mapIntentToUri(@NonNull Intent intent) { |
Jason Monk | 7b8fef2 | 2018-01-30 16:04:14 -0500 | [diff] [blame] | 300 | ContentResolver resolver = mContext.getContentResolver(); |
Jason Monk | 5ffacd0 | 2018-04-10 15:00:18 -0400 | [diff] [blame] | 301 | final Uri staticUri = resolveStatic(intent, resolver); |
| 302 | if (staticUri != null) return staticUri; |
Jason Monk | 7b8fef2 | 2018-01-30 16:04:14 -0500 | [diff] [blame] | 303 | // Otherwise ask the app |
Jason Monk | 5ffacd0 | 2018-04-10 15:00:18 -0400 | [diff] [blame] | 304 | String authority = getAuthority(intent); |
| 305 | if (authority == null) return null; |
Jason Monk | 7b8fef2 | 2018-01-30 16:04:14 -0500 | [diff] [blame] | 306 | Uri uri = new Uri.Builder().scheme(ContentResolver.SCHEME_CONTENT) |
| 307 | .authority(authority).build(); |
Jason Monk | ce1bead | 2018-05-31 14:12:52 -0400 | [diff] [blame] | 308 | try (ContentProviderClient provider = resolver.acquireUnstableContentProviderClient(uri)) { |
Jason Monk | 632def1 | 2018-02-01 15:21:16 -0500 | [diff] [blame] | 309 | if (provider == null) { |
Steven Wu | a14c6b9 | 2018-05-22 09:08:22 -0400 | [diff] [blame] | 310 | Log.w(TAG, String.format("Unknown URI: %s", uri)); |
| 311 | return null; |
Jason Monk | 632def1 | 2018-02-01 15:21:16 -0500 | [diff] [blame] | 312 | } |
Jason Monk | 7b8fef2 | 2018-01-30 16:04:14 -0500 | [diff] [blame] | 313 | Bundle extras = new Bundle(); |
| 314 | extras.putParcelable(SliceProvider.EXTRA_INTENT, intent); |
Jason Monk | 632def1 | 2018-02-01 15:21:16 -0500 | [diff] [blame] | 315 | final Bundle res = provider.call(SliceProvider.METHOD_MAP_ONLY_INTENT, null, extras); |
Jason Monk | 7b8fef2 | 2018-01-30 16:04:14 -0500 | [diff] [blame] | 316 | if (res == null) { |
| 317 | return null; |
| 318 | } |
| 319 | return res.getParcelable(SliceProvider.EXTRA_SLICE); |
| 320 | } catch (RemoteException e) { |
| 321 | // Arbitrary and not worth documenting, as Activity |
| 322 | // Manager will kill this process shortly anyway. |
| 323 | return null; |
Jason Monk | 7b8fef2 | 2018-01-30 16:04:14 -0500 | [diff] [blame] | 324 | } |
| 325 | } |
| 326 | |
Jason Monk | 5ffacd0 | 2018-04-10 15:00:18 -0400 | [diff] [blame] | 327 | private String getAuthority(Intent intent) { |
| 328 | Intent queryIntent = new Intent(intent); |
| 329 | if (!queryIntent.hasCategory(CATEGORY_SLICE)) { |
| 330 | queryIntent.addCategory(CATEGORY_SLICE); |
| 331 | } |
| 332 | List<ResolveInfo> providers = |
| 333 | mContext.getPackageManager().queryIntentContentProviders(queryIntent, 0); |
| 334 | return providers != null && !providers.isEmpty() ? providers.get(0).providerInfo.authority |
| 335 | : null; |
| 336 | } |
| 337 | |
| 338 | private Uri resolveStatic(@NonNull Intent intent, ContentResolver resolver) { |
| 339 | Preconditions.checkNotNull(intent, "intent"); |
| 340 | Preconditions.checkArgument(intent.getComponent() != null || intent.getPackage() != null |
| 341 | || intent.getData() != null, |
| 342 | "Slice intent must be explicit %s", intent); |
| 343 | |
| 344 | // Check if the intent has data for the slice uri on it and use that |
| 345 | final Uri intentData = intent.getData(); |
| 346 | if (intentData != null && SliceProvider.SLICE_TYPE.equals(resolver.getType(intentData))) { |
| 347 | return intentData; |
| 348 | } |
| 349 | // There are no providers, see if this activity has a direct link. |
| 350 | ResolveInfo resolve = mContext.getPackageManager().resolveActivity(intent, |
| 351 | PackageManager.GET_META_DATA); |
| 352 | if (resolve != null && resolve.activityInfo != null |
| 353 | && resolve.activityInfo.metaData != null |
| 354 | && resolve.activityInfo.metaData.containsKey(SLICE_METADATA_KEY)) { |
| 355 | return Uri.parse( |
| 356 | resolve.activityInfo.metaData.getString(SLICE_METADATA_KEY)); |
| 357 | } |
| 358 | return null; |
| 359 | } |
| 360 | |
Jason Monk | 7b8fef2 | 2018-01-30 16:04:14 -0500 | [diff] [blame] | 361 | /** |
Jason Monk | 5ffacd0 | 2018-04-10 15:00:18 -0400 | [diff] [blame] | 362 | * Turns a slice intent into slice content. Is a shortcut to perform the action |
Jeff Sharkey | 3990ee1 | 2018-04-11 10:19:55 -0600 | [diff] [blame] | 363 | * of both {@link #mapIntentToUri(Intent)} and {@link #bindSlice(Uri, Set)} at once. |
Jason Monk | b9e06a8 | 2018-01-16 15:32:53 -0500 | [diff] [blame] | 364 | * |
| 365 | * @param intent The intent associated with a slice. |
| 366 | * @param supportedSpecs List of supported specs. |
| 367 | * @return The Slice provided by the app or null if none is given. |
| 368 | * @see Slice |
| 369 | * @see SliceProvider#onMapIntentToUri(Intent) |
| 370 | * @see Intent |
| 371 | */ |
| 372 | public @Nullable Slice bindSlice(@NonNull Intent intent, |
Jason Monk | 2d3932e | 2018-03-08 11:31:26 -0500 | [diff] [blame] | 373 | @NonNull Set<SliceSpec> supportedSpecs) { |
Jason Monk | b9e06a8 | 2018-01-16 15:32:53 -0500 | [diff] [blame] | 374 | Preconditions.checkNotNull(intent, "intent"); |
Jason Monk | 135f417 | 2018-03-15 17:48:47 -0400 | [diff] [blame] | 375 | Preconditions.checkArgument(intent.getComponent() != null || intent.getPackage() != null |
| 376 | || intent.getData() != null, |
Jason Monk | 7b8fef2 | 2018-01-30 16:04:14 -0500 | [diff] [blame] | 377 | "Slice intent must be explicit %s", intent); |
Jason Monk | b9e06a8 | 2018-01-16 15:32:53 -0500 | [diff] [blame] | 378 | ContentResolver resolver = mContext.getContentResolver(); |
Jason Monk | 5ffacd0 | 2018-04-10 15:00:18 -0400 | [diff] [blame] | 379 | final Uri staticUri = resolveStatic(intent, resolver); |
| 380 | if (staticUri != null) return bindSlice(staticUri, supportedSpecs); |
Jason Monk | b9e06a8 | 2018-01-16 15:32:53 -0500 | [diff] [blame] | 381 | // Otherwise ask the app |
Jason Monk | 5ffacd0 | 2018-04-10 15:00:18 -0400 | [diff] [blame] | 382 | String authority = getAuthority(intent); |
| 383 | if (authority == null) return null; |
Jason Monk | b9e06a8 | 2018-01-16 15:32:53 -0500 | [diff] [blame] | 384 | Uri uri = new Uri.Builder().scheme(ContentResolver.SCHEME_CONTENT) |
| 385 | .authority(authority).build(); |
Jason Monk | ce1bead | 2018-05-31 14:12:52 -0400 | [diff] [blame] | 386 | try (ContentProviderClient provider = resolver.acquireUnstableContentProviderClient(uri)) { |
Jason Monk | 632def1 | 2018-02-01 15:21:16 -0500 | [diff] [blame] | 387 | if (provider == null) { |
Steven Wu | a14c6b9 | 2018-05-22 09:08:22 -0400 | [diff] [blame] | 388 | Log.w(TAG, String.format("Unknown URI: %s", uri)); |
| 389 | return null; |
Jason Monk | 632def1 | 2018-02-01 15:21:16 -0500 | [diff] [blame] | 390 | } |
Jason Monk | b9e06a8 | 2018-01-16 15:32:53 -0500 | [diff] [blame] | 391 | Bundle extras = new Bundle(); |
| 392 | extras.putParcelable(SliceProvider.EXTRA_INTENT, intent); |
Jason Monk | 632def1 | 2018-02-01 15:21:16 -0500 | [diff] [blame] | 393 | final Bundle res = provider.call(SliceProvider.METHOD_MAP_INTENT, null, extras); |
Jason Monk | b9e06a8 | 2018-01-16 15:32:53 -0500 | [diff] [blame] | 394 | if (res == null) { |
| 395 | return null; |
| 396 | } |
| 397 | return res.getParcelable(SliceProvider.EXTRA_SLICE); |
| 398 | } catch (RemoteException e) { |
| 399 | // Arbitrary and not worth documenting, as Activity |
| 400 | // Manager will kill this process shortly anyway. |
| 401 | return null; |
Jason Monk | b9e06a8 | 2018-01-16 15:32:53 -0500 | [diff] [blame] | 402 | } |
| 403 | } |
| 404 | |
| 405 | /** |
Jason Monk | 2d3932e | 2018-03-08 11:31:26 -0500 | [diff] [blame] | 406 | * @deprecated TO BE REMOVED. |
Jeff Sharkey | 3990ee1 | 2018-04-11 10:19:55 -0600 | [diff] [blame] | 407 | * @removed |
Jason Monk | 2d3932e | 2018-03-08 11:31:26 -0500 | [diff] [blame] | 408 | */ |
| 409 | @Deprecated |
| 410 | @Nullable |
| 411 | public Slice bindSlice(@NonNull Intent intent, |
| 412 | @NonNull List<SliceSpec> supportedSpecs) { |
| 413 | return bindSlice(intent, new ArraySet<>(supportedSpecs)); |
| 414 | } |
| 415 | |
| 416 | /** |
Jason Monk | 7188855 | 2018-03-30 14:14:51 -0400 | [diff] [blame] | 417 | * Determine whether a particular process and user ID has been granted |
| 418 | * permission to access a specific slice URI. |
| 419 | * |
| 420 | * @param uri The uri that is being checked. |
| 421 | * @param pid The process ID being checked against. Must be > 0. |
| 422 | * @param uid The user ID being checked against. A uid of 0 is the root |
| 423 | * user, which will pass every permission check. |
| 424 | * |
| 425 | * @return {@link PackageManager#PERMISSION_GRANTED} if the given |
| 426 | * pid/uid is allowed to access that uri, or |
| 427 | * {@link PackageManager#PERMISSION_DENIED} if it is not. |
| 428 | * |
| 429 | * @see #grantSlicePermission(String, Uri) |
| 430 | */ |
| 431 | public @PermissionResult int checkSlicePermission(@NonNull Uri uri, int pid, int uid) { |
Jason Monk | bf3eedc | 2018-04-05 20:56:42 -0400 | [diff] [blame] | 432 | try { |
Jason Monk | fe4885e | 2018-07-23 13:31:30 -0400 | [diff] [blame] | 433 | return mService.checkSlicePermission(uri, mContext.getPackageName(), null, pid, uid, |
| 434 | null); |
Jason Monk | bf3eedc | 2018-04-05 20:56:42 -0400 | [diff] [blame] | 435 | } catch (RemoteException e) { |
| 436 | throw e.rethrowFromSystemServer(); |
| 437 | } |
Jason Monk | 7188855 | 2018-03-30 14:14:51 -0400 | [diff] [blame] | 438 | } |
| 439 | |
| 440 | /** |
| 441 | * Grant permission to access a specific slice Uri to another package. |
| 442 | * |
| 443 | * @param toPackage The package you would like to allow to access the Uri. |
| 444 | * @param uri The Uri you would like to grant access to. |
| 445 | * |
| 446 | * @see #revokeSlicePermission |
| 447 | */ |
| 448 | public void grantSlicePermission(@NonNull String toPackage, @NonNull Uri uri) { |
Jason Monk | bf3eedc | 2018-04-05 20:56:42 -0400 | [diff] [blame] | 449 | try { |
| 450 | mService.grantSlicePermission(mContext.getPackageName(), toPackage, uri); |
| 451 | } catch (RemoteException e) { |
| 452 | throw e.rethrowFromSystemServer(); |
| 453 | } |
Jason Monk | 7188855 | 2018-03-30 14:14:51 -0400 | [diff] [blame] | 454 | } |
| 455 | |
| 456 | /** |
| 457 | * Remove permissions to access a particular content provider Uri |
| 458 | * that were previously added with {@link #grantSlicePermission} for a specific target |
| 459 | * package. The given Uri will match all previously granted Uris that are the same or a |
| 460 | * sub-path of the given Uri. That is, revoking "content://foo/target" will |
| 461 | * revoke both "content://foo/target" and "content://foo/target/sub", but not |
| 462 | * "content://foo". It will not remove any prefix grants that exist at a |
| 463 | * higher level. |
| 464 | * |
| 465 | * @param toPackage The package you would like to allow to access the Uri. |
| 466 | * @param uri The Uri you would like to revoke access to. |
| 467 | * |
| 468 | * @see #grantSlicePermission |
| 469 | */ |
| 470 | public void revokeSlicePermission(@NonNull String toPackage, @NonNull Uri uri) { |
Jason Monk | bf3eedc | 2018-04-05 20:56:42 -0400 | [diff] [blame] | 471 | try { |
| 472 | mService.revokeSlicePermission(mContext.getPackageName(), toPackage, uri); |
| 473 | } catch (RemoteException e) { |
| 474 | throw e.rethrowFromSystemServer(); |
| 475 | } |
Jason Monk | 7188855 | 2018-03-30 14:14:51 -0400 | [diff] [blame] | 476 | } |
| 477 | |
| 478 | /** |
Jason Monk | e8f8be7 | 2018-01-21 10:10:35 -0500 | [diff] [blame] | 479 | * Does the permission check to see if a caller has access to a specific slice. |
| 480 | * @hide |
| 481 | */ |
Jason Monk | 42e03f8 | 2018-03-30 11:26:56 -0400 | [diff] [blame] | 482 | public void enforceSlicePermission(Uri uri, String pkg, int pid, int uid, |
| 483 | String[] autoGrantPermissions) { |
Jason Monk | e8f8be7 | 2018-01-21 10:10:35 -0500 | [diff] [blame] | 484 | try { |
Jason Monk | ac11238 | 2018-03-23 15:06:35 -0400 | [diff] [blame] | 485 | if (UserHandle.isSameApp(uid, Process.myUid())) { |
| 486 | return; |
| 487 | } |
Jason Monk | e8f8be7 | 2018-01-21 10:10:35 -0500 | [diff] [blame] | 488 | if (pkg == null) { |
| 489 | throw new SecurityException("No pkg specified"); |
| 490 | } |
Jason Monk | fe4885e | 2018-07-23 13:31:30 -0400 | [diff] [blame] | 491 | int result = mService.checkSlicePermission(uri, mContext.getPackageName(), pkg, pid, |
| 492 | uid, autoGrantPermissions); |
Jason Monk | e8f8be7 | 2018-01-21 10:10:35 -0500 | [diff] [blame] | 493 | if (result == PERMISSION_DENIED) { |
| 494 | throw new SecurityException("User " + uid + " does not have slice permission for " |
| 495 | + uri + "."); |
| 496 | } |
Jason Monk | e8f8be7 | 2018-01-21 10:10:35 -0500 | [diff] [blame] | 497 | } catch (RemoteException e) { |
| 498 | throw e.rethrowFromSystemServer(); |
| 499 | } |
| 500 | } |
| 501 | |
| 502 | /** |
| 503 | * Called by SystemUI to grant a slice permission after a dialog is shown. |
| 504 | * @hide |
| 505 | */ |
| 506 | public void grantPermissionFromUser(Uri uri, String pkg, boolean allSlices) { |
| 507 | try { |
| 508 | mService.grantPermissionFromUser(uri, pkg, mContext.getPackageName(), allSlices); |
| 509 | } catch (RemoteException e) { |
| 510 | throw e.rethrowFromSystemServer(); |
| 511 | } |
| 512 | } |
Jason Monk | 8f5f7ff | 2017-10-17 14:12:42 -0400 | [diff] [blame] | 513 | } |