Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(5101)

Unified Diff: chrome/common/extensions/docs/templates/intros/fileSystemProvider.html

Issue 1088883002: Add events for configuring and adding new providers to FSP API. (Closed) Base URL: https://chromium.googlesource.com/chromium/src.git@master
Patch Set: Fixed. Created 5 years, 8 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View side-by-side diff with in-line comments
Download patch
Index: chrome/common/extensions/docs/templates/intros/fileSystemProvider.html
diff --git a/chrome/common/extensions/docs/templates/intros/fileSystemProvider.html b/chrome/common/extensions/docs/templates/intros/fileSystemProvider.html
index 7ca0ab38c80a3907636ac3abf58904e6b9a74e6c..2e95f18005116a2ee02751a078e5b87c87c814fe 100644
--- a/chrome/common/extensions/docs/templates/intros/fileSystemProvider.html
+++ b/chrome/common/extensions/docs/templates/intros/fileSystemProvider.html
@@ -22,25 +22,64 @@ Use cases include decompressing archives and accessing files in a cloud
service other than Drive.
</p>
-<h2 id="archives">File handlers</h2>
+<h2 id="archives">Mounting file systems</h2>
<p>
-Provided file systems can either provide file system contents from an external
-source (such as a remote server), or using a local file (such as an archive) as
-its input.
+Providing extensions can either provide file system contents from an external
+source (such as a remote server or a USB device), or using a local file (such as
+an archive) as its input.
</p>
<p>
-In the second case, the providing extension should have a
+For file handlers, the providing extension should have a
<a href="manifest/file_handlers">file_handlers</a> manifest entry in order
to be launched when the file is selected in the file manager.
When the extension is executed with a file to be handled, it has to mount a
file system and start serving contents from the provided file.
</p>
+<p>
+If the source is network or a device, then the file system should be mounted
+when <a href="#event-onMountRequested">onMountDialogRequested</a> event is
+called.
+</p>
+<p>
+ <table>
+ <tr>
+ <th>
+ <a href="#property-options-source">Source</a> of the file system data
+ </th>
+ <th>Entry point</th>
+ </tr>
+ <tr>
+ <td>
+ <code>"FILE"</code>
+ </td>
+ <td>
+ <a href="apps/app_runtime#event-onLaunched">onLaunched</a>
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <code>"DEVICE"</code>, <code>"NETWORK"</code>
+ </td>
+ <td>
+ <a href="#event-onMountRequested">onMountRequested</a>
+ </td>
+ </tr>
+ </table>
+</p>
+
+<h2 id="archives">Configuring file systems</h2>
+<p>
+Provided file systems once mounted can be configured via the
+<a href="#event-onConfigureRequested">onConfigureRequested</a> event.
+It's especially useful for file systems which provide contents via network in
+order to set proper credentials. Handling this event is optional.
+</p>
<h2 id="archives">Life cycle</h2>
<p>
Provided file systems once mounted are remembered by Chrome and remounted
automatically after reboot or restart. Hence, once a file system is
-<a href="method-mount">mounted</a> by a providing extension, it will stay until
+<a href="#method-mount">mounted</a> by a providing extension, it will stay until
either the extension is unloaded, or the extension calls the
<a href="#method-unmount"> unmount</a> method.
</p>

Powered by Google App Engine
This is Rietveld 408576698