| <?xml version="1.0" encoding="UTF-8"?> |
| <!-- |
| Copyright 2014 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. |
| --> |
| |
| <sample> |
| <name>DocumentCentricRecents</name> |
| <group>UI</group> |
| <package>com.example.android.documentcentricapps</package> |
| |
| <!-- change minSdk if needed--> |
| <minSdk>21</minSdk> |
| |
| <strings> |
| <intro> |
| <![CDATA[ |
| This sample shows the basic usage of the new \"Document Centric Apps\" API. |
| It let\'s you create new documents in the system overview menu and persists its |
| state through reboots. If \"Task per document\" is checked a new task will be |
| created for every new document in the overview menu. |
| ]]> |
| </intro> |
| </strings> |
| |
| <template src="base"/> |
| |
| <metadata> |
| <status>PUBLISHED</status> |
| <categories>UI</categories> |
| <technologies>Android</technologies> |
| <languages>Java</languages> |
| <solutions>Mobile</solutions> |
| <level>INTERMEDIATE</level> |
| <icon>screenshots/big_icon.png</icon> |
| <screenshots> |
| <img>screenshots/1-activity.png</img> |
| <img>screenshots/2-overview.png</img> |
| </screenshots> |
| <api_refs> |
| <android>android.app.Activity</android> |
| <android>android.content.Intent.FLAG_ACTIVITY_NEW_DOCUMENT</android> |
| </api_refs> |
| <description> |
| <![CDATA[ |
| Sample demonstrating the basic usage of the new 'Document Centric Apps' API. |
| It let's you create new documents in the system overview menu and persists its |
| state through reboots. |
| ]]> |
| </description> |
| <intro> |
| <![CDATA[ |
| This sample shows the basic usage of the new Document-Centric Apps API. The new |
| API modifies the meaning of the Intent#FLAG_ACTIVITY_CLEAR_WHEN_TASK_RESET flag, which is |
| now deprecated. In versions before L it serves to define a boundary between the main task and a |
| subtask. The subtask holds a different thumbnail and all activities in it are finished when the |
| task is reset. In L this flag causes a full break with the task that launched it. As such it has |
| been renamed to Intent#FLAG_ACTIVITY_NEW_DOCUMENT. |
| |
| This sample mainly uses Intent flags in code. But Activities can also specify in their manifests |
| that they shall always be launched into a new task in the above manner using the new activity |
| attribute documentLaunchMode which may take on one of three values, “intoExisting” equivalent to |
| NEW_DOCUMENT, “always” equivalent to NEW_DOCUMENT | MULTIPLE_TASK, “none” the default, and |
| “never” which will negate the effect of any attempt to launch the activity with NEW_DOCUMENT. |
| ]]> |
| </intro> |
| </metadata> |
| </sample> |