Document-centric Android Droidcon Berlin 2015 

Overview ● Storage Access Framework ● Document-centric Overview Screen 

Storage Access Framework ● framework to browse and open documents, images, and other files across preferred document storage providers ● standard, easy-to-use UI to let users access documents in a consistent way across apps 

Getting content the hard way Custom file picker 

Getting content the hard way Custom file picker 

Getting content the hard way Custom file picker 

Getting content the old way ACTION_GET_CONTENT before the introduction of the Storage Access Framework 

Getting content the “new” way Android 4.4+ ● Document Providers at the top ● “Legacy” providers at the bottom 

SAF User Interface 

SAF User Interface 

SAF User Interface 

SAF User Interface 

Getting content Intent intent = new Intent(Intent.ACTION_GET_CONTENT); intent.setType("image/*"); intent.addCategory(Intent.CATEGORY_OPENABLE); Intent chooserIntent = Intent.createChooser(i, null); startActivityForResult(chooserIntent, requestCode); 

Getting content Intent intent = new Intent(Intent.ACTION_GET_CONTENT); intent.setType("image/*"); intent.addCategory(Intent.CATEGORY_OPENABLE); intent.putExtra(Intent.EXTRA_ALLOW_MULTIPLE, true); Intent chooserIntent = Intent.createChooser(i, null); startActivityForResult(chooserIntent, requestCode); intent.putExtra(Intent.EXTRA_ALLOW_MULTIPLE, true); 

Getting content - onActivityResult if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) { ClipData clipData = data.getClipData(); if (clipData != null) { // read URIs from ClipData return; } } // read URI from Intent.getData() 

Options for saving content ● Download Manager ● Share Intent ● Write to hardcoded directories ● … 

Picking a directory Use third-party app to select directory 

Picking a directory Use third-party app to select directory private static final String[][] PICK_DIRECTORY_INTENTS = { { "org.openintents.action.PICK_DIRECTORY", "file://" }, { "com.estrongs.action.PICK_DIRECTORY", "file://" }, { Intent.ACTION_PICK, "folder://" }, { "com.androidworkz.action.PICK_DIRECTORY", "file://" } }; 

Saving content the hard way Custom UI ● Cloud providers need to be supported by the app 

Saving content the new way ACTION_CREATE_DOCUMENT 

Saving content the new way Intent intent = new Intent(Intent.ACTION_CREATE_DOCUMENT); intent.setType("image/jpeg"); intent.putExtra(Intent.EXTRA_TITLE, "corgi.jpg"); intent.addCategory(Intent.CATEGORY_OPENABLE); startActivityForResult(intent, requestCode); 

Picking a directory the new way Intent intent = new Intent(Intent.ACTION_OPEN_DOCUMENT_TREE); startActivityForResult(intent, requestCode); // in onActivityResult - receive URI for document tree String rootDocumentId = DocumentsContract.getTreeDocumentId(treeUri); Uri rootDocumentUri = DocumentsContract.buildDocumentUriUsingTree( treeUri, rootDocumentId); Uri newDocumentUri = DocumentsContract.createDocument( contentResolver, rootDocumentUri, "image/png", "new.png"); 

Picking a directory the new way ACTION_OPEN_DOCUMENT_TREE Not even implemented by the Google Drive app :( 

Overview Screen ● Introduced with Android 5.0 ● Previously app-centric Recent Apps Screen 

App-centric world Recent Apps one entry per app 

Document-centric world Overview Screen one entry per document 

How to create a new document task? Ideally, it just works Intent intent = new Intent(Intent.ACTION_VIEW); intent.setData(Uri.parse("mailto:[email protected]")); intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_WHEN_TASK_RESET); startActivity(intent); 

How to create a new document task? Ideally, it just works Intent intent = new Intent(Intent.ACTION_VIEW); intent.setData(Uri.parse("mailto:[email protected]")); intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_WHEN_TASK_RESET); startActivity(intent); Intent.FLAG_ACTIVITY_CLEAR_WHEN_TASK_RESET 

How to create a new document task? Ideally, it just works Intent intent = new Intent(Intent.ACTION_VIEW); intent.setData(Uri.parse("mailto:[email protected]")); intent.addFlags(Intent.FLAG_ACTIVITY_NEW_DOCUMENT); startActivity(intent); Intent.FLAG_ACTIVITY_NEW_DOCUMENT 

When to use FLAG_ACTIVITY_NEW_DOCUMENT? ● Potentially whenever starting an external activity ● When multiple entries for your app in the Overview Screen are desirable 

More Activity Flags ● With FLAG_ACTIVITY_NEW_DOCUMENT existing tasks will be brought to the front ● Use FLAG_ACTIVITY_MULTIPLE_TASK to force creation of a new task 

documentLaunchMode ● always ● intoExisting ● never ● none Use this rather than the Intent flag! attribute in manifest 

TaskDescription 

TaskDescription TaskDescription taskDescription = new TaskDescription(title, icon, Color.DKGRAY); setTaskDescription(taskDescription); 

Manage document tasks ● Activity.finishAndRemoveTask() ● ActivityManager.getAppTasks() ○ finishAndRemoveTask() ○ moveToFront() ○ startActivity(…) ○ getTaskInfo().baseIntent ○ … 

makeTaskLaunchBehind Document tasks are grouped when makeTaskLaunchBehind is used 

makeTaskLaunchBehind Intent newDocumentIntent = …; ActivityOptions options = ActivityOptions.makeTaskLaunchBehind(); startActivity(newDocumentIntent, options.toBundle()); 

persistableMode attribute in manifest ● persistRootOnly (default) ● persistNever ● persistAcrossReboots ○ PeristableBundle 

Summary ● SAF makes many things easier ○ Not a solution for pre-KitKat devices ○ Support isn’t great right now :( ● Document tasks solve many small issues ● It’s easy to get started. Do it now! 

Thank you! Questions? 

Bonus slide: Corgis CC BY-SA 2.0 Source: https://flic.kr/p/dZrnNm 

Further questions? Email: [email protected] Google+: +cketti