Install and launch kiosk app from cached crx file at start up.

chrome/browser/chromeos/app_mode/kiosk_app_manager.h

 // Copyright 2013 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.
 
 #ifndef CHROME_BROWSER_CHROMEOS_APP_MODE_KIOSK_APP_MANAGER_H_
 #define CHROME_BROWSER_CHROMEOS_APP_MODE_KIOSK_APP_MANAGER_H_
 
 #include <string>
 #include <vector>
 
@@ skipping 11 matching lines @@
 
 class PrefRegistrySimple;
 class Profile;
 
 namespace base {
 class RefCountedString;
 }
 
 namespace extensions {
 class Extension;
+class ExternalLoader;
 }
 
 namespace chromeos {
 
 class KioskAppData;
+class KioskAppExternalLoader;
 class KioskAppManagerObserver;
 
 // KioskAppManager manages cached app data.
 class KioskAppManager : public KioskAppDataDelegate,
                         public ExternalCache::Delegate {
  public:
   enum ConsumerKioskAutoLaunchStatus {
     // Consumer kiosk mode auto-launch feature can be enabled on this machine.
     CONSUMER_KIOSK_AUTO_LAUNCH_CONFIGURABLE,
     // Consumer kiosk auto-launch feature is enabled on this machine.
@@ skipping 96 matching lines @@
 
   // Updates app data from the |app| in |profile|. |app| is provided to cover
   // the case of app update case where |app| is the new version and is not
   // finished installing (e.g. because old version is still running). Otherwise,
   // |app| could be NULL and the current installed app in |profile| will be
   // used.
   void UpdateAppDataFromProfile(const std::string& app_id,
                                 Profile* profile,
                                 const extensions::Extension* app);
 
+  // Gets the file path and version information of the cached crx with |app_id|.
+  // Returns true if the app is found in cache.
+  bool GetCachedCrx(const std::string& app_id,

[xiyuan, 2014/07/08 21:50:59]

nit: It seems we no longer need to expose crx path directly. The function is
used for testing existence of cached crx.

How about change this to:
bool HasCachedCrx(const std::string& app_id) const;

[jennyz, 2014/07/12 00:03:20]

This function is still needed in KioskAppManagerTest for verifying the cached
crx's version and file path. So I added a HasCachedCrx, and moved the
GetCachedCrx to private functions.

+                    base::FilePath* file_path,
+                    std::string* version);
+
+  // Returns true if the extension with |id| is pending for caching crx file
+  // for the first time.
+  bool IsExtensionPendingForCache(const std::string& id);
+
+  // Returns true if the extensions with |id| is pending for update check.
+  // The crx file fo the extension has been cached previously.
+  bool IsExtensionPendingForUpdateCheck(const std::string& id);

[xiyuan, 2014/07/08 21:50:59]

We can probably merge this with IsExtensionPendingForCache. The outside world
only needs to know whether the crx of given |id| is being downloaded or not.

[jennyz, 2014/07/12 00:03:20]

We don't need both functions now, removed.

+
   void AddObserver(KioskAppManagerObserver* observer);
   void RemoveObserver(KioskAppManagerObserver* observer);
 
+  // Creates extensions::ExternalLoader for installing kiosk apps during their
+  // first time launch.
+  extensions::ExternalLoader* CreateExternalLoader();
+
+  // Installs kiosk app with |id|.
+  void InstallKioskApp(const std::string& id);

[xiyuan, 2014/07/08 21:50:59]

nit: InstallKioskApp -> InstallFromCache to be more clear about what the code
does.

[jennyz, 2014/07/12 00:03:20]

Done.

+
+  bool external_loader_created() const { return external_loader_created_; }
+
  private:
   friend struct base::DefaultLazyInstanceTraits<KioskAppManager>;
   friend struct base::DefaultDeleter<KioskAppManager>;
   friend class KioskAppManagerTest;
   friend class KioskTest;
 
   enum AutoLoginState {
     AUTOLOGIN_NONE      = 0,
     AUTOLOGIN_REQUESTED = 1,
     AUTOLOGIN_APPROVED  = 2,
     AUTOLOGIN_REJECTED  = 3,
   };
 
   KioskAppManager();
   virtual ~KioskAppManager();
 
   // Stop all data loading and remove its dependency on CrosSettings.
   void CleanUp();
 
   // Gets KioskAppData for the given app id.
   const KioskAppData* GetAppData(const std::string& app_id) const;
   KioskAppData* GetAppDataMutable(const std::string& app_id);
 
-  // Update app data |apps_| based on CrosSettings.
+  // Updates app data |apps_| based on CrosSettings.
   void UpdateAppData();
 
   // KioskAppDataDelegate overrides:
   virtual void GetKioskAppIconCacheDir(base::FilePath* cache_dir) OVERRIDE;
   virtual void OnKioskAppDataChanged(const std::string& app_id) OVERRIDE;
   virtual void OnKioskAppDataLoadFailure(const std::string& app_id) OVERRIDE;
 
   // ExternalCache::Delegate:
   virtual void OnExtensionListsUpdated(
       const base::DictionaryValue* prefs) OVERRIDE;
@@ skipping 17 matching lines @@
   void OnOwnerFileChecked(
       const GetConsumerKioskAutoLaunchStatusCallback& callback,
       bool* owner_present);
 
   // Reads/writes auto login state from/to local state.
   AutoLoginState GetAutoLoginState() const;
   void SetAutoLoginState(AutoLoginState state);
 
   void GetCrxCacheDir(base::FilePath* cache_dir);
 
-  bool GetCachedCrx(const std::string& app_id,
-                    base::FilePath* file_path,
-                    std::string* version);
-
   // True if machine ownership is already established.
   bool ownership_established_;
   ScopedVector<KioskAppData> apps_;
   std::string auto_launch_app_id_;
   ObserverList<KioskAppManagerObserver, true> observers_;
 
   scoped_ptr<CrosSettings::ObserverSubscription>
       local_accounts_subscription_;
   scoped_ptr<CrosSettings::ObserverSubscription>
       local_account_auto_login_id_subscription_;
 
   scoped_ptr<ExternalCache> external_cache_;
 
+  // The extension external loader for installing kiosk app.
+  bool external_loader_created_;
+  base::WeakPtr<KioskAppExternalLoader> external_loader_;
+
   DISALLOW_COPY_AND_ASSIGN(KioskAppManager);
 };
 
 }  // namespace chromeos
 
 #endif  // CHROME_BROWSER_CHROMEOS_APP_MODE_KIOSK_APP_MANAGER_H_