Add a private API method to install a webstore app from Files.app

chrome/common/extensions/api/file_browser_private.json

Index: chrome/common/extensions/api/file_browser_private.json
diff --git a/chrome/common/extensions/api/file_browser_private.json b/chrome/common/extensions/api/file_browser_private.json
index 98fb729224ec85660984670e94cf192f1b20e66a..695f0fb93c1b85295cc11d2d0c95d3162f550ea9 100644
--- a/chrome/common/extensions/api/file_browser_private.json
+++ b/chrome/common/extensions/api/file_browser_private.json
@@ -1173,6 +1173,38 @@
             ]
           }
         ]
+      },
+      {
+        "name": "installWebstoreItem",
+        "type": "function",
+        "description": "Requests to install a webstore item.",
+        "parameters": [
+          {
+            "name": "item_id",
+            "type": "string",
+            "description": "The id of the item to install."
+          },
+          {
+            "name": "callback",
+            "type": "function",
+            "parameters": [
+              {
+                "type": "object",
+                "properties": {
+                  "result": {
+                    "type": "boolean",
+                    "description": "True if the item is installed. False if failed or aborted."
+                  },
+                  "error": {
+                    "type": "string",
+                    "optional": true,
+                    "description": "Reason of failure."
+                  }
+                }

[asargent_no_longer_on_chrome, 2013/08/29 22:26:04]

nit: instead of having a callback where you pass a boolean for success failure
and a string for error details, our usual pattern is to use
chrome.runtime.lastError and chrome.runtime.lastError instead. You already get
these set for free by setting error_ to the error string and calling
SendResponse(false) in your InstallWebstoreItemFunction code. 

You can just have a no-parameters callback here, and in the description just say
something like "callers should check chrome.runtime.lastError to determine if
there was any failure, in which case chrome.runtime.lastError.message will
contain a reason for the failure"

[yoshiki, 2013/08/30 06:02:49]

I didn't know that. Thanks. Done

+              }
+            ]
+          }
+        ]
       }
     ],
     "events": [