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 PDF extension.
  89 extern const char kPdfExtensionId[];
  90
  91 // The extension id of the Office Viewer component extension.
  92 extern const char kQuickOfficeComponentExtensionId[];
  93
  94 // The extension id of the Office Viewer extension on the internal webstore.
  95 extern const char kQuickOfficeInternalExtensionId[];
  96
  97 // The extension id of the Office Viewer extension.
  98 extern const char kQuickOfficeExtensionId[];
  99
 100 // The extension id of the settings application.
 101 extern const char kSettingsAppId[];
 102
 103 // The extension id used for testing streamsPrivate
 104 extern const char kStreamsPrivateTestExtensionId[];
 105
 106 // The extension id of the Youtube application.
 107 extern const char kYoutubeAppId[];
 108
 109 // The extension id of the in-app payments support application.
 110 extern const char kInAppPaymentsSupportAppId[];
 111
 112 // The buckets used for app launches.
 113 enum AppLaunchBucket {
 114   // Launch from NTP apps section while maximized.
 115   APP_LAUNCH_NTP_APPS_MAXIMIZED,
 116
 117   // Launch from NTP apps section while collapsed.
 118   APP_LAUNCH_NTP_APPS_COLLAPSED,
 119
 120   // Launch from NTP apps section while in menu mode.
 121   APP_LAUNCH_NTP_APPS_MENU,
 122
 123   // Launch from NTP most visited section in any mode.
 124   APP_LAUNCH_NTP_MOST_VISITED,
 125
 126   // Launch from NTP recently closed section in any mode.
 127   APP_LAUNCH_NTP_RECENTLY_CLOSED,
 128
 129   // App link clicked from bookmark bar.
 130   APP_LAUNCH_BOOKMARK_BAR,
 131
 132   // Nvigated to an app from within a web page (like by clicking a link).
 133   APP_LAUNCH_CONTENT_NAVIGATION,
 134
 135   // Launch from session restore.
 136   APP_LAUNCH_SESSION_RESTORE,
 137
 138   // Autolaunched at startup, like for pinned tabs.
 139   APP_LAUNCH_AUTOLAUNCH,
 140
 141   // Launched from omnibox app links.
 142   APP_LAUNCH_OMNIBOX_APP,
 143
 144   // App URL typed directly into the omnibox (w/ instant turned off).
 145   APP_LAUNCH_OMNIBOX_LOCATION,
 146
 147   // Navigate to an app URL via instant.
 148   APP_LAUNCH_OMNIBOX_INSTANT,
 149
 150   // Launch via chrome.management.launchApp.
 151   APP_LAUNCH_EXTENSION_API,
 152
 153   // Launch an app via a shortcut. This includes using the --app or --app-id
 154   // command line arguments, or via an app shim process on Mac.
 155   APP_LAUNCH_CMD_LINE_APP,
 156
 157   // App launch by passing the URL on the cmd line (not using app switches).
 158   APP_LAUNCH_CMD_LINE_URL,
 159
 160   // User clicked web store launcher on NTP.
 161   APP_LAUNCH_NTP_WEBSTORE,
 162
 163   // App launched after the user re-enabled it on the NTP.
 164   APP_LAUNCH_NTP_APP_RE_ENABLE,
 165
 166   // URL launched using the --app cmd line option, but the URL does not
 167   // correspond to an installed app. These launches are left over from a
 168   // feature that let you make desktop shortcuts from the file menu.
 169   APP_LAUNCH_CMD_LINE_APP_LEGACY,
 170
 171   // User clicked web store link on the NTP footer.
 172   APP_LAUNCH_NTP_WEBSTORE_FOOTER,
 173
 174   // User clicked [+] icon in apps page.
 175   APP_LAUNCH_NTP_WEBSTORE_PLUS_ICON,
 176
 177   // User clicked icon in app launcher main view.
 178   APP_LAUNCH_APP_LIST_MAIN,
 179
 180   // User clicked app launcher search result.
 181   APP_LAUNCH_APP_LIST_SEARCH,
 182
 183   // User clicked the chrome app icon from the app launcher's main view.
 184   APP_LAUNCH_APP_LIST_MAIN_CHROME,
 185
 186   // User clicked the webstore icon from the app launcher's main view.
 187   APP_LAUNCH_APP_LIST_MAIN_WEBSTORE,
 188
 189   // User clicked the chrome app icon from the app launcher's search view.
 190   APP_LAUNCH_APP_LIST_SEARCH_CHROME,
 191
 192   // User clicked the webstore icon from the app launcher's search view.
 193   APP_LAUNCH_APP_LIST_SEARCH_WEBSTORE,
 194   APP_LAUNCH_BUCKET_BOUNDARY,
 195   APP_LAUNCH_BUCKET_INVALID
 196 };
 197
 198 // The extension id of the ChromeVox extension.
 199 extern const char kChromeVoxExtensionId[];
 200
 201 #if defined(OS_CHROMEOS)
 202 // Path to preinstalled ChromeVox screen reader extension (relative to
 203 // |chrome::DIR_RESOURCES|).
 204 extern const char kChromeVoxExtensionPath[];
 205 // Name of ChromeVox manifest file.
 206 extern const char kChromeVoxManifestFilename[];
 207 // Name of ChromeVox guest manifest file.
 208 extern const char kChromeVoxGuestManifestFilename[];
 209 // Extension id, path (relative to |chrome::DIR_RESOURCES|) and IME engine
 210 // id for the builtin-in Braille IME extension.
 211 extern const char kBrailleImeExtensionId[];
 212 extern const char kBrailleImeExtensionPath[];
 213 extern const char kBrailleImeEngineId[];
 214 // Path to preinstalled Connectivity Diagnostics extension.
 215 extern const char kConnectivityDiagnosticsPath[];
 216 extern const char kConnectivityDiagnosticsKioskPath[];
 217 extern const char kConnectivityDiagnosticsLauncherPath[];
 218 // Path to preinstalled speech synthesis extension.
 219 extern const char kSpeechSynthesisExtensionPath[];
 220 // The extension id of the speech synthesis extension.
 221 extern const char kSpeechSynthesisExtensionId[];
 222 // The extension id of the wallpaper manager application.
 223 extern const char kWallpaperManagerId[];
 224 // The extension id of the first run dialog application.
 225 extern const char kFirstRunDialogId[];
 226 // The extension id of the new ZIP unpacker extension.
 227 extern const char kZIPUnpackerExtensionId[];
 228 #endif
 229
 230 // What causes an extension to be installed? Used in histograms, so don't
 231 // change existing values.
 232 enum CrxInstallCause {
 233   INSTALL_CAUSE_UNSET = 0,
 234   INSTALL_CAUSE_USER_DOWNLOAD,
 235   INSTALL_CAUSE_UPDATE,
 236   INSTALL_CAUSE_EXTERNAL_FILE,
 237   INSTALL_CAUSE_AUTOMATION,
 238   NUM_INSTALL_CAUSES
 239 };
 240
 241 // The states that an app can be in, as reported by chrome.app.installState
 242 // and chrome.app.runningState.
 243 extern const char kAppStateNotInstalled[];
 244 extern const char kAppStateInstalled[];
 245 extern const char kAppStateDisabled[];
 246 extern const char kAppStateRunning[];
 247 extern const char kAppStateCannotRun[];
 248 extern const char kAppStateReadyToRun[];
 249
 250 // The path part of the file system url used for media file systems.
 251 extern const char kMediaFileSystemPathPart[];
 252
 253 // The key used for signing some pieces of data from the webstore.
 254 extern const uint8 kWebstoreSignaturesPublicKey[];
 255 extern const int kWebstoreSignaturesPublicKeySize;
 256
 257 }  // namespace extension_misc
 258
 259 #endif  // CHROME_COMMON_EXTENSIONS_EXTENSION_CONSTANTS_H_