chrome/common/extensions/extension_constants.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_COMMON_EXTENSIONS_EXTENSION_CONSTANTS_H_
   6 #define CHROME_COMMON_EXTENSIONS_EXTENSION_CONSTANTS_H_
   7
   8 #include <string>
   9
  10 #include "base/basictypes.h"
  11 #include "url/gurl.h"
  12
  13 namespace extension_urls {
  14
  15 // This returns the compile-time constant webstore update url specific to
  16 // Chrome. Usually you should prefer using GetWebstoreUpdateUrl.
  17 GURL GetDefaultWebstoreUpdateUrl();
  18
  19 // Field to use with webstore URL for tracking launch source.
  20 extern const char kWebstoreSourceField[];
  21
  22 // Values to use with webstore URL launch source field.
  23 extern const char kLaunchSourceAppList[];
  24 extern const char kLaunchSourceAppListSearch[];
  25 extern const char kLaunchSourceAppListInfoDialog[];
  26
  27 }  // namespace extension_urls
  28
  29 namespace extension_misc {
  30
  31 // The extension id of the bookmark manager.
  32 extern const char kBookmarkManagerId[];
  33
  34 // The extension id of the Chrome component application.
  35 extern const char kChromeAppId[];
  36
  37 // The extension id of the Cloud Print component application.
  38 extern const char kCloudPrintAppId[];
  39
  40 // The extension id of the Easy Unlock component application.
  41 extern const char kEasyUnlockAppId[];
  42
  43 // The extension id of the Enterprise Web Store component application.
  44 extern const char kEnterpriseWebStoreAppId[];
  45
  46 // The extension id of GMail application.
  47 extern const char kGmailAppId[];
  48
  49 // The extension id of the Google Doc application.
  50 extern const char kGoogleDocAppId[];
  51
  52 // The extension id of the Google Play Music application.
  53 extern const char kGooglePlayMusicAppId[];
  54
  55 // The extension id of the Google Search application.
  56 extern const char kGoogleSearchAppId[];
  57
  58 // The extension id of the Google Sheets application.
  59 extern const char kGoogleSheetsAppId[];
  60
  61 // The extension id of the Google Slides application.
  62 extern const char kGoogleSlidesAppId[];
  63
  64 // The extension id of the HTerm app for ChromeOS.
  65 extern const char kHTermAppId[];
  66
  67 // The extension id of the HTerm dev app for ChromeOS.
  68 extern const char kHTermDevAppId[];
  69
  70 // The extension id of the Identity API UI application.
  71 extern const char kIdentityApiUiAppId[];
  72
  73 // The extension id of the Crosh component app for ChromeOS.
  74 extern const char kCroshBuiltinAppId[];
  75
  76 // The extension id of the hotword audio verification dialogue app.
  77 extern const char kHotwordAudioVerificationAppId[];
  78
  79 // The extension id of the hotword voice search trigger extension.
  80 extern const char kHotwordExtensionId[];
  81
  82 // The extension id of the new (experimental) hotword extension.
  83 extern const char kHotwordNewExtensionId[];
  84
  85 // The extension id of the hotword shared module.
  86 extern const char kHotwordSharedModuleId[];
  87
  88 // The extension id of the settings application.
  89 extern const char kSettingsAppId[];
  90
  91 // The extension id of the Youtube application.
  92 extern const char kYoutubeAppId[];
  93
  94 // The extension id of the in-app payments support application.
  95 extern const char kInAppPaymentsSupportAppId[];
  96
  97 // The buckets used for app launches.
  98 enum AppLaunchBucket {
  99   // Launch from NTP apps section while maximized.
 100   APP_LAUNCH_NTP_APPS_MAXIMIZED,
 101
 102   // Launch from NTP apps section while collapsed.
 103   APP_LAUNCH_NTP_APPS_COLLAPSED,
 104
 105   // Launch from NTP apps section while in menu mode.
 106   APP_LAUNCH_NTP_APPS_MENU,
 107
 108   // Launch from NTP most visited section in any mode.
 109   APP_LAUNCH_NTP_MOST_VISITED,
 110
 111   // Launch from NTP recently closed section in any mode.
 112   APP_LAUNCH_NTP_RECENTLY_CLOSED,
 113
 114   // App link clicked from bookmark bar.
 115   APP_LAUNCH_BOOKMARK_BAR,
 116
 117   // Nvigated to an app from within a web page (like by clicking a link).
 118   APP_LAUNCH_CONTENT_NAVIGATION,
 119
 120   // Launch from session restore.
 121   APP_LAUNCH_SESSION_RESTORE,
 122
 123   // Autolaunched at startup, like for pinned tabs.
 124   APP_LAUNCH_AUTOLAUNCH,
 125
 126   // Launched from omnibox app links.
 127   APP_LAUNCH_OMNIBOX_APP,
 128
 129   // App URL typed directly into the omnibox (w/ instant turned off).
 130   APP_LAUNCH_OMNIBOX_LOCATION,
 131
 132   // Navigate to an app URL via instant.
 133   APP_LAUNCH_OMNIBOX_INSTANT,
 134
 135   // Launch via chrome.management.launchApp.
 136   APP_LAUNCH_EXTENSION_API,
 137
 138   // Launch an app via a shortcut. This includes using the --app or --app-id
 139   // command line arguments, or via an app shim process on Mac.
 140   APP_LAUNCH_CMD_LINE_APP,
 141
 142   // App launch by passing the URL on the cmd line (not using app switches).
 143   APP_LAUNCH_CMD_LINE_URL,
 144
 145   // User clicked web store launcher on NTP.
 146   APP_LAUNCH_NTP_WEBSTORE,
 147
 148   // App launched after the user re-enabled it on the NTP.
 149   APP_LAUNCH_NTP_APP_RE_ENABLE,
 150
 151   // URL launched using the --app cmd line option, but the URL does not
 152   // correspond to an installed app. These launches are left over from a
 153   // feature that let you make desktop shortcuts from the file menu.
 154   APP_LAUNCH_CMD_LINE_APP_LEGACY,
 155
 156   // User clicked web store link on the NTP footer.
 157   APP_LAUNCH_NTP_WEBSTORE_FOOTER,
 158
 159   // User clicked [+] icon in apps page.
 160   APP_LAUNCH_NTP_WEBSTORE_PLUS_ICON,
 161
 162   // User clicked icon in app launcher main view.
 163   APP_LAUNCH_APP_LIST_MAIN,
 164
 165   // User clicked app launcher search result.
 166   APP_LAUNCH_APP_LIST_SEARCH,
 167
 168   // User clicked the chrome app icon from the app launcher's main view.
 169   APP_LAUNCH_APP_LIST_MAIN_CHROME,
 170
 171   // User clicked the webstore icon from the app launcher's main view.
 172   APP_LAUNCH_APP_LIST_MAIN_WEBSTORE,
 173
 174   // User clicked the chrome app icon from the app launcher's search view.
 175   APP_LAUNCH_APP_LIST_SEARCH_CHROME,
 176
 177   // User clicked the webstore icon from the app launcher's search view.
 178   APP_LAUNCH_APP_LIST_SEARCH_WEBSTORE,
 179   APP_LAUNCH_BUCKET_BOUNDARY,
 180   APP_LAUNCH_BUCKET_INVALID
 181 };
 182
 183 // The extension id of the ChromeVox extension.
 184 extern const char kChromeVoxExtensionId[];
 185
 186 #if defined(OS_CHROMEOS)
 187 // Path to preinstalled ChromeVox screen reader extension (relative to
 188 // |chrome::DIR_RESOURCES|).
 189 extern const char kChromeVoxExtensionPath[];
 190 // Name of ChromeVox manifest file.
 191 extern const char kChromeVoxManifestFilename[];
 192 // Name of ChromeVox guest manifest file.
 193 extern const char kChromeVoxGuestManifestFilename[];
 194 // Extension id, path (relative to |chrome::DIR_RESOURCES|) and IME engine
 195 // id for the builtin-in Braille IME extension.
 196 extern const char kBrailleImeExtensionId[];
 197 extern const char kBrailleImeExtensionPath[];
 198 extern const char kBrailleImeEngineId[];
 199 // Path to preinstalled Connectivity Diagnostics extension.
 200 extern const char kConnectivityDiagnosticsPath[];
 201 extern const char kConnectivityDiagnosticsKioskPath[];
 202 extern const char kConnectivityDiagnosticsLauncherPath[];
 203 // Path to preinstalled speech synthesis extension.
 204 extern const char kSpeechSynthesisExtensionPath[];
 205 // The extension id of the speech synthesis extension.
 206 extern const char kSpeechSynthesisExtensionId[];
 207 // The extension id of the wallpaper manager application.
 208 extern const char kWallpaperManagerId[];
 209 // The extension id of the first run dialog application.
 210 extern const char kFirstRunDialogId[];
 211 // The extension id of the new ZIP unpacker extension.
 212 extern const char kZIPUnpackerExtensionId[];
 213 #endif
 214
 215 // What causes an extension to be installed? Used in histograms, so don't
 216 // change existing values.
 217 enum CrxInstallCause {
 218   INSTALL_CAUSE_UNSET = 0,
 219   INSTALL_CAUSE_USER_DOWNLOAD,
 220   INSTALL_CAUSE_UPDATE,
 221   INSTALL_CAUSE_EXTERNAL_FILE,
 222   INSTALL_CAUSE_AUTOMATION,
 223   NUM_INSTALL_CAUSES
 224 };
 225
 226 // The states that an app can be in, as reported by chrome.app.installState
 227 // and chrome.app.runningState.
 228 extern const char kAppStateNotInstalled[];
 229 extern const char kAppStateInstalled[];
 230 extern const char kAppStateDisabled[];
 231 extern const char kAppStateRunning[];
 232 extern const char kAppStateCannotRun[];
 233 extern const char kAppStateReadyToRun[];
 234
 235 // The path part of the file system url used for media file systems.
 236 extern const char kMediaFileSystemPathPart[];
 237
 238 // The key used for signing some pieces of data from the webstore.
 239 extern const uint8 kWebstoreSignaturesPublicKey[];
 240 extern const int kWebstoreSignaturesPublicKeySize;
 241
 242 }  // namespace extension_misc
 243
 244 #endif  // CHROME_COMMON_EXTENSIONS_EXTENSION_CONSTANTS_H_