Apply default wallpaper from customization manifest.

chrome/browser/chromeos/customization_document.h

 // Copyright (c) 2012 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_CUSTOMIZATION_DOCUMENT_H_
 #define CHROME_BROWSER_CHROMEOS_CUSTOMIZATION_DOCUMENT_H_
 
 #include <string>
 #include <vector>
 
@@ skipping 24 matching lines @@
 
 namespace user_prefs {
 class PrefRegistrySyncable;
 }
 
 // This test is in global namespace so it must be declared here.
 void Test__InitStartupCustomizationDocument(const std::string& manifest);
 
 namespace chromeos {
 
+class CustomizationWallpaperDownloader;
 class ServicesCustomizationExternalLoader;
 
 namespace system {
 class StatisticsProvider;
 }  // system
 
 // Base class for OEM customization document classes.
 class CustomizationDocument {
  public:
   virtual ~CustomizationDocument();
@@ skipping 117 matching lines @@
   // Returns the name of the folder for OEM apps for given |locale|.
   std::string GetOemAppsFolderName(const std::string& locale) const;
 
   // Initialize instance of ServicesCustomizationDocument for tests that will
   // override singleton until ShutdownForTesting is called.
   static void InitializeForTesting();
 
   // Remove instance of ServicesCustomizationDocument for tests.
   static void ShutdownForTesting();
 
+  // This is also used by WallpaperManager to set customized wallpaper path

[Nikita (slow), 2014/04/15 12:39:24]

Comments needs to be updated. It says that these methods are used to set while
these methods are Get*()

[Alexander Alekseev, 2014/04/15 22:47:31]

Done.

+  // to global default before first wallpaper is shown.
+  static base::FilePath GetCustomizedWallpaperCacheDir();
+  static base::FilePath GetCustomizedWallpaperDownloadedFileName();
+
  private:
   friend struct DefaultSingletonTraits<ServicesCustomizationDocument>;
 
   typedef std::vector<base::WeakPtr<ServicesCustomizationExternalLoader> >
       ExternalLoaders;
 
   // C-tor for singleton construction.
   ServicesCustomizationDocument();
 
   // C-tor for test construction.
@@ skipping 38 matching lines @@
   void OnCustomizationNotFound();
 
   // Set OEM apps folder name for AppListSyncableService for |profile|.
   void SetOemFolderName(Profile* profile, const base::DictionaryValue& root);
 
   // Returns the name of the folder for OEM apps for given |locale|.
   std::string GetOemAppsFolderNameImpl(
       const std::string& locale,
       const base::DictionaryValue& root) const;
 
+  // Start download of wallpaper image if needed.
+  void StartOEMWallpaperDownload(const GURL& wallpaper_url);
+
+  // Check downloaded wallpaper and start download if needed.

[Nikita (slow), 2014/04/15 12:39:24]

nit:
start applying? or it does redownload as well?

[Alexander Alekseev, 2014/04/15 22:47:31]

If we do not have final two rescaled wallpaper files matching
wallpaper URL from customization manifest, wallpaper will be downloaded again.
There is no restart "in the middle of the process".

+  void CheckAndApplyWallpaper();

[Nikita (slow), 2014/04/15 12:39:24]

nit: What does "check" mean in this context?

[Alexander Alekseev, 2014/04/15 22:47:31]

Check that current customized wallpaper cache exists and matches manifest.

+
+  // Intermediate function to pass the result of PathExists to ApplyWallpaper.
+  void OnCheckedWallpaperCacheExists(scoped_ptr<bool> exists);
+
+  // Called after downloaded wallpaper has been checked.
+  void ApplyWallpaper(bool default_wallpaper_file_exists);
+
+  // Set Shell default wallpaper to customized.
+  // It's wrapped as a callback and passed as a parameter to
+  // CustomizationWallpaperDownloader.
+  void OnCustomizedWallpaperDownloaded(bool success, const GURL& wallpaper_url);

[Nikita (slow), 2014/04/15 12:39:24]

nit: Rename to OnOEMWallpaperDownloaded() to match
StartOEMWallpaperDownload()

[Alexander Alekseev, 2014/04/15 22:47:31]

Done.

+
   // Services customization manifest URL.
   GURL url_;
 
   // URLFetcher instance.
   scoped_ptr<net::URLFetcher> url_fetcher_;
 
   // How many times we already tried to fetch customization manifest file.
   int num_retries_;
 
   // Manifest fetch is already in progress.
   bool fetch_started_;
 
   // Delay between checks for network online state.
   base::TimeDelta network_delay_;
 
   // Known external loaders.
   ExternalLoaders external_loaders_;
 
+  scoped_ptr<CustomizationWallpaperDownloader> wallpaper_downloader_;
+
   // Weak factory for callbacks.
   base::WeakPtrFactory<ServicesCustomizationDocument> weak_ptr_factory_;
 
   DISALLOW_COPY_AND_ASSIGN(ServicesCustomizationDocument);
 };
 
 }  // namespace chromeos
 
 #endif  // CHROME_BROWSER_CHROMEOS_CUSTOMIZATION_DOCUMENT_H_