chrome/installer/gcapi_mac/gcapi.h

   1 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #ifndef CHROME_INSTALLER_GCAPI_MAC_GCAPI_H_
   6 #define CHROME_INSTALLER_GCAPI_MAC_GCAPI_H_
   7
   8 // Error conditions for GoogleChromeCompatibilityCheck().
   9 #define GCCC_ERROR_ALREADYPRESENT                (1 << 0)
  10 #define GCCC_ERROR_ACCESSDENIED                  (1 << 1)
  11 #define GCCC_ERROR_OSNOTSUPPORTED                (1 << 2)
  12 #define GCCC_ERROR_ALREADYOFFERED                (1 << 3)
  13 #define GCCC_ERROR_INTEGRITYLEVEL                (1 << 4)
  14
  15 #ifdef __cplusplus
  16 extern "C" {
  17 #endif
  18
  19 // This function returns nonzero if Google Chrome should be offered.
  20 // If the return value is 0, |reasons| explains why.  If you don't care for the
  21 // reason, you can pass NULL for |reasons|.
  22 int GoogleChromeCompatibilityCheck(unsigned* reasons);
  23
  24 // This function installs Google Chrome in the application folder and optionally
  25 // sets up the brand code and master prefs.
  26 // |source_path| Path to an uninstalled Google Chrome.app directory, for example
  27 //               in a mounted dmg, in file system representation.
  28 // |brand_code| If not NULL, a string containing the brand code Google Chrome
  29 //              should use. Has no effect if Google Chrome has an embedded brand
  30 //              code. Overwrites existing brand files.
  31 // |master_prefs_contents| If not NULL, the _contents_ of a master prefs file
  32 //                         Google Chrome should use. This is not a path.
  33 //                         Overwrites existing master pref files.
  34 // Returns nonzero if Google Chrome was successfully copied. If copying
  35 // succeeded but writing of master prefs, brand code, or other noncrucial
  36 // setup tasks fail, this still returns nonzero.
  37 // Returns 0 if the installation failed, for example if Google Chrome was
  38 // already installed, or no disk space was left.
  39 int InstallGoogleChrome(const char* source_path,
  40                         const char* brand_code,
  41                         const char* master_prefs_contents,
  42                         unsigned master_prefs_contents_size);
  43
  44 // This function launches Google Chrome after a successful install, or it does
  45 // a best-effort search to launch an existing installation if
  46 // InstallGoogleChrome() returned GCCC_ERROR_ALREADYPRESENT.
  47 int LaunchGoogleChrome();
  48
  49 #ifdef __cplusplus
  50 }  // extern "C"
  51 #endif
  52
  53 #endif  // CHROME_INSTALLER_GCAPI_MAC_GCAPI_H_