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

Merge "Add flags for quick viewer to indicate capabilities of a document." into oc-dev

Browse Source
This commit is contained in:
Garfield Tan
2017-03-31 18:04:49 +00:00
committed by Android (Google) Code Review
parent 70c429d37a ce1d0e9459
commit f6d9507a00
8 changed files with 140 additions and 12 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
api/current.txt
View File

@@ -9469,7 +9469,7 @@ package android.content {
field public static final java.lang.String EXTRA_PHONE_NUMBER = "android.intent.extra.PHONE_NUMBER";
field public static final java.lang.String EXTRA_PROCESS_TEXT = "android.intent.extra.PROCESS_TEXT";
field public static final java.lang.String EXTRA_PROCESS_TEXT_READONLY = "android.intent.extra.PROCESS_TEXT_READONLY";
field public static final java.lang.String EXTRA_QUICK_VIEW_ADVANCED = "android.intent.extra.QUICK_VIEW_ADVANCED";
field public static final java.lang.String EXTRA_QUICK_VIEW_FEATURES = "android.intent.extra.QUICK_VIEW_FEATURES";
field public static final java.lang.String EXTRA_QUIET_MODE = "android.intent.extra.QUIET_MODE";
field public static final java.lang.String EXTRA_REFERRER = "android.intent.extra.REFERRER";
field public static final java.lang.String EXTRA_REFERRER_NAME = "android.intent.extra.REFERRER_NAME";
@@ -9735,6 +9735,14 @@ package android.content {
field public final long period;
}
public class QuickViewConstants {
field public static final java.lang.String FEATURE_DOWNLOAD = "android:download";
field public static final java.lang.String FEATURE_EDIT = "android:edit";
field public static final java.lang.String FEATURE_PRINT = "android:print";
field public static final java.lang.String FEATURE_SEND = "android:send";
field public static final java.lang.String FEATURE_VIEW = "android:view";
}
public class ReceiverCallNotAllowedException extends android.util.AndroidRuntimeException {
ctor public ReceiverCallNotAllowedException(java.lang.String);
}

4
api/removed.txt
View File

@@ -33,6 +33,10 @@ package android.content {
method public abstract java.io.File getSharedPreferencesPath(java.lang.String);
}
public class Intent implements java.lang.Cloneable android.os.Parcelable {
field public static final deprecated java.lang.String EXTRA_QUICK_VIEW_ADVANCED = "android.intent.extra.QUICK_VIEW_ADVANCED";
}
}
package android.content.pm {

10
api/system-current.txt
View File

@@ -9995,7 +9995,7 @@ package android.content {
field public static final java.lang.String EXTRA_PHONE_NUMBER = "android.intent.extra.PHONE_NUMBER";
field public static final java.lang.String EXTRA_PROCESS_TEXT = "android.intent.extra.PROCESS_TEXT";
field public static final java.lang.String EXTRA_PROCESS_TEXT_READONLY = "android.intent.extra.PROCESS_TEXT_READONLY";
field public static final java.lang.String EXTRA_QUICK_VIEW_ADVANCED = "android.intent.extra.QUICK_VIEW_ADVANCED";
field public static final java.lang.String EXTRA_QUICK_VIEW_FEATURES = "android.intent.extra.QUICK_VIEW_FEATURES";
field public static final java.lang.String EXTRA_QUIET_MODE = "android.intent.extra.QUIET_MODE";
field public static final java.lang.String EXTRA_REFERRER = "android.intent.extra.REFERRER";
field public static final java.lang.String EXTRA_REFERRER_NAME = "android.intent.extra.REFERRER_NAME";
@@ -10266,6 +10266,14 @@ package android.content {
field public final long period;
}
public class QuickViewConstants {
field public static final java.lang.String FEATURE_DOWNLOAD = "android:download";
field public static final java.lang.String FEATURE_EDIT = "android:edit";
field public static final java.lang.String FEATURE_PRINT = "android:print";
field public static final java.lang.String FEATURE_SEND = "android:send";
field public static final java.lang.String FEATURE_VIEW = "android:view";
}
public class ReceiverCallNotAllowedException extends android.util.AndroidRuntimeException {
ctor public ReceiverCallNotAllowedException(java.lang.String);
}

4
api/system-removed.txt
View File

@@ -31,6 +31,10 @@ package android.content {
method public abstract java.io.File getSharedPreferencesPath(java.lang.String);
}
public class Intent implements java.lang.Cloneable android.os.Parcelable {
field public static final deprecated java.lang.String EXTRA_QUICK_VIEW_ADVANCED = "android.intent.extra.QUICK_VIEW_ADVANCED";
}
}
package android.content.pm {

10
api/test-current.txt
View File

@@ -9502,7 +9502,7 @@ package android.content {
field public static final java.lang.String EXTRA_PHONE_NUMBER = "android.intent.extra.PHONE_NUMBER";
field public static final java.lang.String EXTRA_PROCESS_TEXT = "android.intent.extra.PROCESS_TEXT";
field public static final java.lang.String EXTRA_PROCESS_TEXT_READONLY = "android.intent.extra.PROCESS_TEXT_READONLY";
field public static final java.lang.String EXTRA_QUICK_VIEW_ADVANCED = "android.intent.extra.QUICK_VIEW_ADVANCED";
field public static final java.lang.String EXTRA_QUICK_VIEW_FEATURES = "android.intent.extra.QUICK_VIEW_FEATURES";
field public static final java.lang.String EXTRA_QUIET_MODE = "android.intent.extra.QUIET_MODE";
field public static final java.lang.String EXTRA_REFERRER = "android.intent.extra.REFERRER";
field public static final java.lang.String EXTRA_REFERRER_NAME = "android.intent.extra.REFERRER_NAME";
@@ -9768,6 +9768,14 @@ package android.content {
field public final long period;
}
public class QuickViewConstants {
field public static final java.lang.String FEATURE_DOWNLOAD = "android:download";
field public static final java.lang.String FEATURE_EDIT = "android:edit";
field public static final java.lang.String FEATURE_PRINT = "android:print";
field public static final java.lang.String FEATURE_SEND = "android:send";
field public static final java.lang.String FEATURE_VIEW = "android:view";
}
public class ReceiverCallNotAllowedException extends android.util.AndroidRuntimeException {
ctor public ReceiverCallNotAllowedException(java.lang.String);
}

4
api/test-removed.txt
View File

@@ -33,6 +33,10 @@ package android.content {
method public abstract java.io.File getSharedPreferencesPath(java.lang.String);
}
public class Intent implements java.lang.Cloneable android.os.Parcelable {
field public static final deprecated java.lang.String EXTRA_QUICK_VIEW_ADVANCED = "android.intent.extra.QUICK_VIEW_ADVANCED";
}
}
package android.content.pm {

42
core/java/android/content/Intent.java
View File

@@ -668,19 +668,17 @@ public class Intent implements Parcelable, Cloneable {
* a URI or a list of URIs.
* <p>Activities handling this intent action should handle the vast majority of
* MIME types rather than only specific ones.
* <p>Quick viewers must render the quick view image locally, and must not send
* file content outside current device.
* <p>Input: {@link #getData} is a mandatory content URI of the item to
* preview. {@link #getClipData} contains an optional list of content URIs
* if there is more than one item to preview. {@link #EXTRA_INDEX} is an
* optional index of the URI in the clip data to show first.
* <p>By default quick viewers are supposed to be lightweight and focus on
* previewing the content only. They should not expose features such as printing,
* opening in an external app, deleting, rotating, casting, etc.
* However, if {@link #EXTRA_QUICK_VIEW_ADVANCED} is true, then the quick viewer
* may show advanced UI which includes convenience actions suitable for the passed
* Uris.
* {@link #EXTRA_QUICK_VIEW_FEATURES} is an optional extra indicating the features
* that can be shown in the quick view UI.
* <p>Output: nothing.
* @see #EXTRA_QUICK_VIEW_ADVANCED
* @see #EXTRA_INDEX
* @see #EXTRA_QUICK_VIEW_FEATURES
*/
@SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
public static final String ACTION_QUICK_VIEW = "android.intent.action.QUICK_VIEW";
@@ -4490,7 +4488,7 @@ public class Intent implements Parcelable, Cloneable {
* Optional index with semantics depending on the intent action.
*
* <p>The value must be an integer greater or equal to 0.
* @see ACTION_QUICK_VIEW
* @see #ACTION_QUICK_VIEW
*/
public static final String EXTRA_INDEX = "android.intent.extra.INDEX";
@@ -4500,11 +4498,37 @@ public class Intent implements Parcelable, Cloneable {
* casting, etc.
*
* <p>The value is boolean. By default false.
* @see ACTION_QUICK_VIEW
* @see #ACTION_QUICK_VIEW
* @removed
*/
@Deprecated
public static final String EXTRA_QUICK_VIEW_ADVANCED =
"android.intent.extra.QUICK_VIEW_ADVANCED";
/**
* An optional extra of {@code String[]} indicating which quick view features should be made
* available to the user in the quick view UI while handing a
* {@link Intent#ACTION_QUICK_VIEW} intent.
* <li>Enumeration of features here is not meant to restrict capabilities of the quick viewer.
* Quick viewer can implement features not listed below.
* <li>Features included at this time are: {@link QuickViewConstants#FEATURE_VIEW},
* {@link QuickViewConstants#FEATURE_EDIT}, {@link QuickViewConstants#FEATURE_DOWNLOAD},
* {@link QuickViewConstants#FEATURE_SEND}, {@link QuickViewConstants#FEATURE_PRINT}.
* <p>
* Requirements:
* <li>Quick viewer shouldn't show a feature if the feature is absent in
* {@link #EXTRA_QUICK_VIEW_FEATURES}.
* <li>When {@link #EXTRA_QUICK_VIEW_FEATURES} is not present, quick viewer should follow
* internal policies.
* <li>Presence of an feature in {@link #EXTRA_QUICK_VIEW_FEATURES}, does not constitute a
* requirement that the feature be shown. Quick viewer may, according to its own policies,
* disable or hide features.
*
* @see #ACTION_QUICK_VIEW
*/
public static final String EXTRA_QUICK_VIEW_FEATURES =
"android.intent.extra.QUICK_VIEW_FEATURES";
/**
* Optional boolean extra indicating whether quiet mode has been switched on or off.
* When a profile goes into quiet mode, all apps in the profile are killed and the

68
core/java/android/content/QuickViewConstants.java Normal file
View File

@@ -0,0 +1,68 @@
/*
* 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.content;
/**
* Constants for {@link Intent#ACTION_QUICK_VIEW}.
*/
public class QuickViewConstants {
private QuickViewConstants() {}
/**
* Feature to view a document using system standard viewing mechanism, like
* {@link Intent#ACTION_VIEW}.
*
* @see Intent#EXTRA_QUICK_VIEW_FEATURES
* @see Intent#ACTION_QUICK_VIEW
*/
public static final String FEATURE_VIEW = "android:view";
/**
* Feature to view a document using system standard editing mechanism, like
* {@link Intent#ACTION_EDIT}.
*
* @see Intent#EXTRA_QUICK_VIEW_FEATURES
* @see Intent#ACTION_QUICK_VIEW
*/
public static final String FEATURE_EDIT = "android:edit";
/**
* Feature to view a document using system standard sending mechanism, like
* {@link Intent#ACTION_SEND}.
*
* @see Intent#EXTRA_QUICK_VIEW_FEATURES
* @see Intent#ACTION_QUICK_VIEW
*/
public static final String FEATURE_SEND = "android:send";
/**
* Feature to download a document to the local file system.
*
* @see Intent#EXTRA_QUICK_VIEW_FEATURES
* @see Intent#ACTION_QUICK_VIEW
*/
public static final String FEATURE_DOWNLOAD = "android:download";
/**
* Feature to print a document.
*
* @see Intent#EXTRA_QUICK_VIEW_FEATURES
* @see Intent#ACTION_QUICK_VIEW
*/
public static final String FEATURE_PRINT = "android:print";
}