Add processing for a master profile json file on first run. Allows:

- set home page / show home button
- show bookmarks bar

Review URL: http://codereview.chromium.org/7369

git-svn-id: svn://svn.chromium.org/chrome/trunk/src@3542 0039d316-1c4b-4281-b951-d872f2087c98

1 files changed, 50 insertions, 5 deletions

diff --git a/chrome/browser/first_run.h b/chrome/browser/first_run.h
index 7d98580..c9e439c 100644
--- a/chrome/browser/first_run.h
+++ b/chrome/browser/first_run.h
@@ -2,8 +2,8 @@
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
-#ifndef CHROME_BROWSER_FIRST_RUN_H__
-#define CHROME_BROWSER_FIRST_RUN_H__
+#ifndef CHROME_BROWSER_FIRST_RUN_H_
+#define CHROME_BROWSER_FIRST_RUN_H_
 
 #include "base/basictypes.h"
 #include "base/command_line.h"
@@ -50,9 +50,54 @@ class FirstRun {
   // FirstRun::ImportSettings().
   static int ImportWithUI(Profile* profile, const CommandLine& cmdline);
 
+  // These are the possible results of calling ProcessMasterPreferences.
+  enum MasterPrefResult {
+    MASTER_PROFILE_NOT_FOUND          = 0,
+    MASTER_PROFILE_ERROR              = 1,
+    MASTER_PROFILE_SHOW_EULA          = 2,
+    MASTER_PROFILE_NO_FIRST_RUN_UI    = 4
+  };
+
+  // The master preferences is a JSON file with the same entries as the
+  // 'Default\Preferences' file. This function locates this file from
+  // master_pref_path or if that path is empty from the default location
+  // which is '<path to chrome.exe>\master_preferences', and process it
+  // so it becomes the default preferences in profile pointed by user_data_dir.
+  //
+  // Since this function destroys any existing prefs file, it is meant to be
+  // invoked only on first run. The current use of this function is to set the
+  // following 3 properties:
+  // - default home page
+  // - show bookmark bar
+  // - show home page button
+  //
+  // A prototypical 'master_preferences' file looks like this:
+  //
+  // {
+  //   "browser": {
+  //      "show_home_button": true
+  //   },
+  //   "bookmark_bar": {
+  //      "show_on_all_tabs": true
+  //   },
+  //   "homepage": "http://slashdot.org",
+  //   "homepage_is_newtabpage": false
+  // }
+  //
+  // A reserved "distribution" entry in the file will be used to group
+  // other installation properties such as the EULA display. This entry will
+  // be ignored at other times.
+  // Currently only the following return values are used:
+  // MASTER_PROFILE_NOT_FOUND : Typical outcome for organic installs.
+  // MASTER_PROFILE_ERROR : A critical error processing the master profile.
+  // MASTER_PROFILE_SHOW_FIRST_RUN_UI : master profile processed ok.
+  static MasterPrefResult ProcessMasterPreferences(
+      const std::wstring& user_data_dir,
+      const std::wstring& master_prefs_path);
+
  private:
   // This class is for scoping purposes.
-  DISALLOW_EVIL_CONSTRUCTORS(FirstRun);
+  DISALLOW_COPY_AND_ASSIGN(FirstRun);
 };
 
 // This class contains the actions that need to be performed when an upgrade
@@ -81,7 +126,7 @@ class FirstRunBrowserProcess : public BrowserProcessImpl {
   virtual GoogleURLTracker* google_url_tracker() { return NULL; }
 
  private:
-  DISALLOW_EVIL_CONSTRUCTORS(FirstRunBrowserProcess);
+  DISALLOW_COPY_AND_ASSIGN(FirstRunBrowserProcess);
 };
 
 // Show the First Run UI to the user, allowing them to create shortcuts for
@@ -89,5 +134,5 @@ class FirstRunBrowserProcess : public BrowserProcessImpl {
 // |profile| and perhaps some other tasks.
 void OpenFirstRunDialog(Profile* profile);
 
-#endif  // CHROME_BROWSER_FIRST_RUN_H__
+#endif  // CHROME_BROWSER_FIRST_RUN_H_