Implement <appview>

extensions/common/api/app_runtime.idl

 // Copyright 2014 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 // Use the <code>chrome.app.runtime</code> API to manage the app lifecycle.
 // The app runtime manages app installation, controls the event page, and can
 // shut down the app at anytime.
 namespace app.runtime {
 
   [inline_doc] dictionary LaunchItem {
@@ skipping 24 matching lines @@
     // The referrer URL for the <code>onLaunched</code> event triggered by a
     // matching URL handler in the <code>url_handlers</code> manifest key.
     DOMString? referrerUrl;
 
     // Whether the app is being launched in a <a
     // href="https://support.google.com/chromebook/answer/3134673">Chrome OS
     // kiosk session</a>.
     boolean? isKioskSession;
   };
 
+  [inline_doc] dictionary AppEmbeddingRequest {

[not at google - send to devlin, 2014/07/08 20:54:14]

inline_doc is automatic for types that are only used once

[Fady Samuel, 2014/07/08 21:53:10]

Done.

+    long? id;
+
+    DOMString embedderExtensionId;
+
+    [nocompile] static void allow(DOMString url, object api, DOMString schema);
+
+    [nocompile] static void deny();

[not at google - send to devlin, 2014/07/08 20:54:14]

these all need comments

[Fady Samuel, 2014/07/08 21:53:10]

Done.

+  };
+
   interface Events {
+    // Fired when an embedding app requests to embed this app.
+    static void onAppEmbeddingRequest(AppEmbeddingRequest request);

[not at google - send to devlin, 2014/07/08 20:54:14]

hum. this change needs to go through actual API review.

[Fady Samuel, 2014/07/08 21:53:10]

I'll write up an API proposal in parallel. appview is behind a flag and all
these APIs cannot be accessed unless --enable-app-view is turned on. Let's land
this first, and then we can chat about it and iterate over API once everyone can
play around with it.

[not at google - send to devlin, 2014/07/08 22:10:46]

That's not quite true, this event can still be listened to even if there's not
really a way to fire it.

since this documentation will go live basically immediately please add a note
that it only makes sense to listen to this event from dev channel and with the
--enable-app-view flag.

[Fady Samuel, 2014/07/09 15:15:48]

Done.

+
     // Fired when an app is launched from the launcher.
     static void onLaunched(optional LaunchData launchData);
 
     // Fired at Chrome startup to apps that were running when Chrome last shut
     // down.
     static void onRestarted();
   };
 };