Android/frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Slices: Fix up some formatting and add examples

Browse Source 
Test: TH
Change-Id: Ia95306d9a44e6a9861958bd7f2b3b697a7ecb4cc
Fixes: 76462142
Fixes: 76461933
This commit is contained in:
Jason Monk
2018-03-27 10:45:23 -04:00
parent ff23ffa8ff
commit 39b9fb373c
1 changed files with 20 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

28
core/java/android/app/slice/SliceManager.java
View File

@@ -81,6 +81,17 @@ public class SliceManager {
* An activity can be statically linked to a slice uri by including a meta-data item
* for this key that contains a valid slice uri for the same application declaring
* the activity.
*
* <pre class="prettyprint">
* {@literal
* <activity android:name="com.example.mypkg.MyActivity">
* <meta-data android:name="android.metadata.SLICE_URI"
* android:value="content://com.example.mypkg/main_slice" />
* </activity>}
* </pre>
*
* @see #mapIntentToUri(Intent)
* @see SliceProvider#onMapIntentToUri(Intent)
*/
public static final String SLICE_METADATA_KEY = "android.metadata.SLICE_URI";
@@ -257,16 +268,17 @@ public class SliceManager {
* <p>
* This goes through a several stage resolution process to determine if any slice
* can represent this intent.
* - If the intent contains data that {@link ContentResolver#getType} is
* {@link SliceProvider#SLICE_TYPE} then the data will be returned.
* - If the intent with {@link #CATEGORY_SLICE} added resolves to a provider, then
* <ol>
* <li> If the intent contains data that {@link ContentResolver#getType} is
* {@link SliceProvider#SLICE_TYPE} then the data will be returned.</li>
* <li>If the intent with {@link #CATEGORY_SLICE} added resolves to a provider, then
* the provider will be asked to {@link SliceProvider#onMapIntentToUri} and that result
* will be returned.
* - Lastly, if the intent explicitly points at an activity, and that activity has
* will be returned.</li>
* <li>Lastly, if the intent explicitly points at an activity, and that activity has
* meta-data for key {@link #SLICE_METADATA_KEY}, then the Uri specified there will be
* returned.
* - If no slice is found, then {@code null} is returned.
*
* returned.</li>
* <li>If no slice is found, then {@code null} is returned.</li>
* </ol>
* @param intent The intent associated with a slice.
* @return The Slice Uri provided by the app or null if none exists.
* @see Slice