Home | History | Annotate | Download | only in gcapi_mac 
      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_
     54