mobile/android/android-components/docs/changelog_archive.md

   1 ---
   2 layout: page
   3 title: Changelog Archive
   4 permalink: /changelog/archive
   5 ---
   6
   7 # 0.56.4
   8 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.56.3...v0.56.4)
   9 * [Dependencies](https://github.com/mozilla-mobile/android-components/blob/v0.56.4/buildSrc/src/main/java/Dependencies.kt)
  10 * [Gecko](https://github.com/mozilla-mobile/android-components/blob/v0.56.4/buildSrc/src/main/java/Gecko.kt)
  11 * [Configuration](https://github.com/mozilla-mobile/android-components/blob/v0.56.4/buildSrc/src/main/java/Config.kt)
  12
  13 * Imported updated translations.
  14
  15 # 0.56.3
  16 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.56.2...v0.56.3)
  17 * [Dependencies](https://github.com/mozilla-mobile/android-components/blob/v0.56.3/buildSrc/src/main/java/Dependencies.kt)
  18 * [Gecko](https://github.com/mozilla-mobile/android-components/blob/v0.56.3/buildSrc/src/main/java/Gecko.kt)
  19 * [Configuration](https://github.com/mozilla-mobile/android-components/blob/v0.56.3/buildSrc/src/main/java/Config.kt)
  20
  21 * **service-firefox-accounts**
  22   * Disabled periodic device event polling.
  23
  24 # 0.56.2
  25 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.56.1...v0.56.2)
  26 * [Dependencies](https://github.com/mozilla-mobile/android-components/blob/v0.56.2/buildSrc/src/main/java/Dependencies.kt)
  27 * [Gecko](https://github.com/mozilla-mobile/android-components/blob/v0.56.2/buildSrc/src/main/java/Gecko.kt)
  28 * [Configuration](https://github.com/mozilla-mobile/android-components/blob/v0.56.2/buildSrc/src/main/java/Config.kt)
  29
  30 * **browser-menu**
  31   * Added `endOfMenuAlwaysVisible` property/parameter to `BrowserMenuBuilder` constructor and to `BrowserMenu.show` function.
  32     When is set to true makes sure the bottom of the menu is always visible, this allows use cases like [#3211](https://github.com/mozilla-mobile/android-components/issues/3211).
  33
  34 # 0.56.1
  35 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.56.0...v0.56.1)
  36 * [Dependencies](https://github.com/mozilla-mobile/android-components/blob/v0.56.1/buildSrc/src/main/java/Dependencies.kt)
  37 * [Gecko](https://github.com/mozilla-mobile/android-components/blob/v0.56.1/buildSrc/src/main/java/Gecko.kt)
  38 * [Configuration](https://github.com/mozilla-mobile/android-components/blob/v0.56.1/buildSrc/src/main/java/Config.kt)
  39
  40 * **service-firefox-accounts**
  41   * `FxaAccountManager` will is now able to complete re-authentication flow after encountering an auth problem (e.g. password change)
  42   * `FxaAccountManager` will now attempt to automatically recover from a certain class of temporary auth problems.
  43   * `FirefoxAccount` grew a new method: `checkAuthorizationStatusAsync`, used to facilitate above flows.
  44   * It is no longer necessary to pass in the "profile" scope to `FxaAccountManager`, as it will always obtain it regardless. Specifying that scope has no effect.
  45   * ⚠️ **This is a breaking change**: `FirefoxAccount` methods that used to take `Array<String>` of scopes now take `Set<String>` of scopes.
  46
  47 # 0.56.0
  48
  49 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.55.0...v0.56.0)
  50 * [Milestone](https://github.com/mozilla-mobile/android-components/milestone/59?closed=1)
  51 * [Dependencies](https://github.com/mozilla-mobile/android-components/blob/v0.56.0/buildSrc/src/main/java/Dependencies.kt)
  52 * [Gecko](https://github.com/mozilla-mobile/android-components/blob/v0.56.0/buildSrc/src/main/java/Gecko.kt)
  53 * [Configuration](https://github.com/mozilla-mobile/android-components/blob/v0.56.0/buildSrc/src/main/java/Config.kt)
  54
  55 * **samples-firefox-accounts**
  56   * Switch FxA sample to production servers, fix pairing.
  57
  58 * **service-firefox-accounts**
  59   * `FxaAccountManager` will is now able to complete re-authentication flow after encountering an auth problem (e.g. password change)
  60   * `FxaAccountManager` will now attempt to automatically recover from a certain class of temporary auth problems.
  61   * `FirefoxAccount` grew a new method: `checkAuthorizationStatusAsync`, used to facilitate above flows.
  62   * It is no longer necessary to pass in the "profile" scope to `FxaAccountManager`, as it will always obtain it regardless. Specifying that scope has no effect.
  63   * ⚠️ **This is a breaking change**: `FirefoxAccount` methods that used to take `Array<String>` of scopes now take `Set<String>` of scopes.
  64
  65 * **browser-domains**
  66   * New domain autocomplete providers `ShippedDomainsProvider` and `CustomDomainsProvider` that
  67     should be used instead of deprecated `DomainAutoCompleteProvider`.
  68
  69 * **service-glean**
  70   * The length limit on labels in labeled metrics has been increased from 30 to 61 characters.  See [1556684](https://bugzilla.mozilla.org/show_bug.cgi?id=1556684).
  71   * Timespan metrics have a new API for setting the timespan directly: `sumRawNanos` and `setRawNanos`.
  72
  73 * **support-base**
  74   * Fixed multiple potential leaks in `ObserverRegistry` (used internally by many classes in other components like `SessionManager`, `EngineSession` and others).
  75
  76 * **browser-icons**
  77   * Fixed possible `NullPointerException` when disk cache is written to concurrently.
  78
  79 * **lib-crash**
  80   * Crash reports sent to Sentry now contain optional environment information, if a parameter is passed.
  81
  82 * **browser-session**
  83   * ⚠️ **This is a breaking change**: Added `url` parameter to `Session.Observer.onLoadRequest()`.
  84
  85 * **support-ktx**
  86   * ⚠️ **This is a breaking change**: Removed `Drawable.toBitmap()` in favour of the Android Core KTX version.
  87   * ⚠️ **This is a breaking change**: Removed `Context.systemService()` in favour of the Android Core KTX version.
  88
  89 * **browser-session**
  90   * Added `Session.hasParentSession` to indicate whether a `Session` was opened from a parent `Session` such as opening a new tab from a link context menu ("Open in new tab").
  91
  92 * **feature-app-links**
  93   * Add a flag to allow the app to not detect an external app if the user has told android to use the browser as default.
  94   * Turn off interception of web links.
  95
  96 # 0.55.0
  97
  98 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.54.0...v0.55.0)
  99 * [Milestone](https://github.com/mozilla-mobile/android-components/milestone/58?closed=1)
 100 * [Dependencies](https://github.com/mozilla-mobile/android-components/blob/v0.55.0/buildSrc/src/main/java/Dependencies.kt)
 101 * [Gecko](https://github.com/mozilla-mobile/android-components/blob/v0.55.0/buildSrc/src/main/java/Gecko.kt)
 102 * [Configuration](https://github.com/mozilla-mobile/android-components/blob/v0.55.0/buildSrc/src/main/java/Config.kt)
 103
 104 * **browser-search**
 105   * `SearchEngineManager.load()` is deprecated. Use `SearchEngineManager.loadAsync()` instead.
 106
 107 * **browser-menu**
 108   * Fixed a bug where overscroll effects would appear on the overflow menu.
 109   * Added enter and exit animations.
 110
 111 * **browser-session**
 112   * Added handler for `onWebAppManifestLoaded` to update `session.webAppManifest`.
 113   * Moved `WebAppManifest` to concept-engine.
 114
 115 * **concept-engine**
 116   * Added `onWebAppManifestLoaded` to `EngineSession`, called when the engine finds a web app manifest.
 117   * Added `WebAppManifest` from browser-session.
 118
 119 * **concept-sync**, **service-accounts**
 120   * ⚠️ **This is a breaking behavior change**: API changes to facilitate error handling; new method on AccountObserver interface.
 121   * Added `onAuthenticationProblems` observer method, used for indicating that account needs to re-authenticate (e.g. after a password change).
 122   * `FxaAccountManager` gained a new method, `accountNeedsReauth`, that could be used for the same purpose.
 123   * `DeviceConstellation` methods that returned `Deferred<Unit>` now return `Deferred<Boolean>`, with a success flag.
 124   * `OAuthAccount` methods that returned `Deferred` values now have an `Async` suffix in their names.
 125   * `OAuthAccount` and `DeviceConstellation` methods that returned `Deferred<T>` (for some T) now return `Deferred<T?>`, where `null` means failure.
 126   * `FirefoxAccount`, `FirefoxDeviceConstellation` and `FirefoxDeviceManager` now handle all expected `FxAException`.
 127   * Fixes device name not changing in FxaDeviceConstellation after setDeviceNameAsync is called.
 128
 129 * **engine-gecko-nightly**, **engine-gecko-beta**, **engine-system**, **concept-engine**
 130   * Added `EngineView.canScrollVerticallyUp()` for pull to refresh.
 131   * Added engine API to clear browsing data.
 132
 133 * **browser-storage-sync**
 134   * `recordVisit` and `recordObservation` will no longer throw when processing invalid URLs.
 135
 136   ```kotlin
 137   // Clear all browsing data
 138   engine.clearData(BrowsingData.all())
 139
 140   // Clear all caches
 141   engine.clearData(BrowsingData.allCaches())
 142
 143   // Clear cookies only for the provided host
 144   engine.clearData(BrowsingData.select(BrowsingData.COOKIES), host = "mozilla.org")
 145   ```
 146
 147 * **engine-system**:
 148   * Added `EngineView.canScrollVerticallyUp()` for pull to refresh.
 149
 150 * **browser-engine-gecko-nightly**
 151   * This component now has a hard dependency on the new [universal GeckoView build](https://bugzilla.mozilla.org/show_bug.cgi?id=1508976) that is no longer architecture specific (ARM, x86, ..). With that apps no longer need to specify the GeckoView build themselves and synchronize the used version with Android Components. Additionally apps can now make use of [APK splits](https://developer.android.com/studio/build/configure-apk-splits) or [Android App Bundles (AAB)](https://developer.android.com/guide/app-bundle).
 152
 153 * **service-glean**
 154   * Disabling telemetry through `setUploadEnabled` now clears all metrics (except first_run_date) immediately.
 155   * The string length limit for `StringMetricType` was raised from 50 to 100 characters.
 156
 157 * **feature-session**
 158   * Added `SwipeRefreshFeature` which adds pull to refresh to browsers.
 159
 160 * **feature-tab-collections**
 161   * Added option to remove all collections and their tabs: `TabCollectionStorage.removeAllCollections()`.
 162
 163 * **feature-media**
 164   * Added `RecordingDevicesNotificationFeature` to show an ongoing notification while recording devices (camera, microphone) are used by web content.
 165
 166 * **concept-push**
 167   * 🆕 Added a new component for supporting push notifications.
 168
 169 * **lib-push-firebase**
 170   * 🆕 Added a new component for Firebase Cloud Messaging push support.
 171
 172   ```kotlin
 173   class FirebasePush : AbstractFirebasePushService()
 174   ```
 175
 176   * In your Manifest you need to make the service visible:
 177
 178   ```xml
 179   <service android:name=".FirebasePush">
 180     <intent-filter>
 181         <action android:name="com.google.firebase.MESSAGING_EVENT" />
 182     </intent-filter>
 183   </service>
 184   ```
 185 * **feature-sync**
 186   * Fixed a bug that caused the Sync Manager to crash on initial startup cases.
 187
 188 * **feature-push**
 189   * 🆕 Added a new component for Autopush messaging support.
 190
 191   ```kotlin
 192   class Application {
 193     override fun onCreate() {
 194       PushProcessor.install(services.push)
 195     }
 196   }
 197
 198   class Services {
 199     val push by lazy {
 200       val config = PushConfig(
 201         senderId = "my-app",
 202         serverHost = "push.services.mozilla.com",
 203         serviceType = ServiceType.FCM,
 204         protocol = Protocol.HTTPS
 205       )
 206
 207       // You need to use a supported push service (Firebase is one of them).
 208       val pushService = FirebasePush()
 209
 210       AutoPushFeature(context, pushService, config).also { it.initialize() }
 211     }
 212   }
 213
 214   class MyActivity {
 215     override fun onCreate() {
 216       services.push.registerForSubscriptions(object : PushSubscriptionObserver {
 217         override fun onSubscriptionAvailable(subscription: AutoPushSubscription) { }
 218       })
 219
 220       services.push.registerForPushMessages(PushType.Services, object: Bus.Observer<PushType, String> {
 221         override fun onEvent(type: PushType, message: String) { }
 222       })
 223     }
 224   }
 225   ```
 226
 227   * Checkout the component documentation for more details.
 228
 229 * **support-ktx**
 230   * Added `Context.hasCamera()` to check if the device has a camera.
 231
 232 # 0.54.0
 233
 234 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.53.0...v0.54.0)
 235 * [Milestone](https://github.com/mozilla-mobile/android-components/milestone/57?closed=1)
 236 * [Dependencies](https://github.com/mozilla-mobile/android-components/blob/v0.54.0/buildSrc/src/main/java/Dependencies.kt)
 237 * [Gecko](https://github.com/mozilla-mobile/android-components/blob/v0.54.0/buildSrc/src/main/java/Gecko.kt)
 238 * [Configuration](https://github.com/mozilla-mobile/android-components/blob/v0.54.0/buildSrc/src/main/java/Config.kt)
 239
 240 * **browser-engine-gecko**, **browser-engine-gecko-beta**, **browser-engine-gecko-nightly**
 241   * **Merge day!**
 242     * `browser-engine-gecko-release`: GeckoView 67.0
 243     * `browser-engine-gecko-beta`: GeckoView 68.0
 244     * `browser-engine-gecko-nightly`: GeckoView 69.0
 245
 246 * ⚠️ **Deprecated components**: `feature-session-bundling`, `ui-doorhanger`, `ui-progress` (See blog posting).
 247
 248 * **service-pocket**
 249   * Added `PocketEndpointRaw` and `PocketJSONParser` for low-level access.
 250
 251 * **browser-menu**
 252   * Added `BrowserMenuHighlightableItem`. Its `highlight` property allows you to set the background and an image that appears on the right.
 253
 254 * **feature-findinpage**
 255   * Find in Page Bar now displays 0/0 for no matches found with new attr findInPageNoMatchesTextColor
 256
 257 * **feature-customtabs**
 258   * Fixed a bug where menu actions would not work for all Custom Tab sessions.
 259
 260 * **support-test**
 261   * Added `testContext` property for retrieving application context from tests.
 262
 263 * **browser-session**
 264   * Added `AllSessionsObserver` helper that automatically subscribes and unsubscribes to all `Session` instances that get added/removed.
 265
 266 * **support-base**
 267   * Added `Build` object that contains information about the current Android Components build (like version number and git hash).
 268
 269 * **lib-crash**
 270   * Crash reports sent to Sentry now contain additional tags about the used Android Components version and setup (prefixed with "ac.").
 271
 272 * **browser-awesomebar**, **feature-awesomebar**
 273   * Fixed an issue where `SuggestionProvider.onInputChanged()` was called before `SuggestionProvider.onInputStarted()`.
 274   * Added ability for `SuggestionProvider` to return an initial list of suggestions from `onInputStarted()`.
 275   * Modified `ClipboardSuggestionProvider` to already return a suggestions from `onInputStarted()` if the clipboard contains a URL.
 276
 277 * **feature-app-links**
 278   *  🆕 New component: to detect and open links in other non-browser apps.
 279   * Use cases to parse intent:// URLs, query the package manager for activities and generate Play store URLs.
 280
 281 * **browser-engine-gecko-nightly**, **concept-engine**:
 282   * Added `EngineSession.Observer.onRecordingStateChanged()` to get list of recording devices currently used by web content.
 283
 284 * **support-base**
 285   * Added helper for providing unique stable `Int` notification ids based on a `String` tag to avoid id conflicts between components and app code.
 286
 287   ```kotlin
 288   // Get a unique id for the provided tag
 289   val id = NotificationIds.getIdForTag(context, "mozac.my.feature")
 290
 291   // Extension methods for showing and cancelling notifications
 292   NotificationManagerCompat
 293       .from(context)
 294       .notify(context, "mozac.my.feature", notification)
 295
 296   NotificationManagerCompat
 297       .from(context)
 298       .cancel(context, "mozac.my.feature")
 299   ```
 300
 301 # 0.53.0
 302
 303 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.52.0...v0.53.0)
 304 * [Milestone](https://github.com/mozilla-mobile/android-components/milestone/56?closed=1)
 305 * [Dependencies](https://github.com/mozilla-mobile/android-components/blob/v0.53.0/buildSrc/src/main/java/Dependencies.kt)
 306 * [Gecko](https://github.com/mozilla-mobile/android-components/blob/v0.53.0/buildSrc/src/main/java/Gecko.kt)
 307 * [Configuration](https://github.com/mozilla-mobile/android-components/blob/v0.53.0/buildSrc/src/main/java/Config.kt)
 308
 309 * **concept-engine**, **browser-engine-gecko-nightly** and **browser-engine-gecko-beta**:
 310   * Added new policies for Safe Browsing: `TrackingProtectionPolicy.SAFE_BROWSING_MALWARE`, `TrackingProtectionPolicy.SAFE_BROWSING_UNWANTED`, `TrackingProtectionPolicy.SAFE_BROWSING_PHISHING`, `TrackingProtectionPolicy.SAFE_BROWSING_HARMFUL` and `TrackingProtectionPolicy.SAFE_BROWSING_ALL`.
 311   * Added a new policy category : `trackingProtectionPolicy.recommended()` contains all the recommended policies categories. It blocks ads, analytics, social, test trackers, plus all the safe browsing policies.
 312
 313 * **browser-engine-system**
 314   * ⚠️ **This is a breaking behavior change**: built-in `WebView`'s on-screen zoom controls are hidden by default.
 315
 316 * **browser-icons**
 317   * Added disk cache for icons.
 318
 319 * **feature-session**:
 320   * Added `EngineViewBottomBehavior`: A `CoordinatorLayout.Behavior` implementation to be used with [EngineView] when placing a toolbar at the bottom of the screen. This implementation will update the vertical clipping of the `EngineView` so that bottom-aligned web content will be drawn above the browser toolbar.
 321   * New use case `SettingsUseCases.UpdateTrackingProtectionUseCase`: Updates Tracking Protection for the engine and all open sessions.
 322
 323 * **feature-prompts** and **browser-engine-gecko-nightly**
 324   * Now input type file are working.
 325
 326 * **browser-session**
 327   * Fixed a bug where the title and icon of a `Session` was cleared too early.
 328
 329 * **browser-contextmenu**
 330   * Added ability to provide a custom `SnackbarDelegate` to show a customized `Snackbar`.
 331
 332 # 0.52.0
 333
 334 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.51.0...v0.52.0)
 335 * [Milestone](https://github.com/mozilla-mobile/android-components/milestone/55?closed=1)
 336 * [Dependencies](https://github.com/mozilla-mobile/android-components/blob/v0.52.0/buildSrc/src/main/java/Dependencies.kt)
 337 * [Gecko](https://github.com/mozilla-mobile/android-components/blob/v0.52.0/buildSrc/src/main/java/Gecko.kt)
 338 * [Configuration](https://github.com/mozilla-mobile/android-components/blob/v0.52.0/buildSrc/src/main/java/Config.kt)
 339
 340 * ℹ️ **Migrated all components to [AndroidX](https://developer.android.com/jetpack/androidx).**
 341
 342 * ℹ️ **Upgraded Gradle to 5.3.1**
 343   * ⚠️ This requires using the 1.3.30 Kotlin gradle plugin or higher.
 344
 345 * **feature-tab-collections**
 346   * 🆕 New component: Feature implementation for saving, restoring and organizing collections of tabs.
 347
 348 * **feature-readerview**
 349   * 🆕 New component/feature that provides reader mode functionality. To see a complete and working example of how to integrate this new component, check out the `ReaderViewIntegration` class in our [Sample Browser](https://github.com/mozilla-mobile/android-components/tree/main/samples/browser).
 350   ```kotlin
 351       val readerViewFeature = ReaderViewFeature(context, engine, sessionManager, controlsView) { available ->
 352           // This lambda is invoked to indicate whether or not reader view is available
 353           // for the page loaded by the selected session (for the current tab)
 354       }
 355
 356       // To activate reader view
 357       readerViewFeature.showReaderView()
 358
 359       // To deactivate reader view
 360       readerViewFeature.hideReaderView()
 361
 362       // To show the appearance (font, color scheme) controls
 363       readerViewFeature.showControls()
 364
 365       // To hide the appearance (font, color scheme) controls
 366       readerViewFeature.hideControls()
 367   ```
 368
 369 * **feature-readerview**
 370   * Fix disappearing title in Custom Tab toolbar.
 371
 372 * **feature-sitepermissions**
 373   * Added ability to configure default (checked/unchecked) state for "Remember decision" checkbox. Provide `dialogConfig` into `SitePermissionsFeature` for this. Checkbox is checked by default.
 374   * ⚠️ **This is a breaking API change**: ``anchorView`` property has been removed if you want to change the position of the prompts use the ``promptsStyling`` property.
 375   * Added new property ``context``. It must be provided in the constructor.
 376   * Do not save new site permissions in private sessions.
 377   * Added ``sessionId`` property for adding site permissions on custom tabs.
 378   * Allow prompts styling via ``PromptsStyling``
 379   ```kotlin
 380     data class PromptsStyling(
 381         val gravity: Int,
 382         val shouldWidthMatchParent: Boolean = false,
 383         @ColorRes
 384         val positiveButtonBackgroundColor: Int? = null,
 385         @ColorRes
 386         val positiveButtonTextColor: Int? = null
 387     )
 388   ```
 389
 390 * **feature-customtabs**
 391   * Fix session not being removed when the close button was clicked.
 392
 393 * **service-glean**
 394    * ⚠️ **This is a breaking API change**: Custom pings must be explicitly
 395      registered with Glean at startup time. See
 396      `components/service/glean/docs/pings/custom.md` for more information.
 397
 398 * **ui-autocomplete**
 399   * Added an optional `shouldAutoComplete` boolean to `setText` which is currently used by `updateUrl` in `EditToolbar`.
 400
 401 * **browser-toolbar**
 402   * Modified `EditToolbar`'s `updateUrl` function to take a `shouldAutoComplete` boolean. By default a call to this function does **not** autocomplete. Generally you want to disable autocomplete when calling `updateUrl` if the text is a search term.
 403   See `editMode` in `BrowserToolbar` and `setText` in `InlineAutocompleteEditText` for more information.
 404
 405 * **browser-engine-system**
 406   * Added support for Authentication dialogs on SystemEngineView.
 407
 408 * **concept-engine**, **browser-engine-gecko-nightly**
 409   * Added `suspendMediaWhenInactive` setting to control whether media should be suspended when the session is inactive. The default is `false`.
 410   ```kotlin
 411   // To provide a default when creating the engine:
 412   GeckoEngine(runtime, DefaultSettings(suspendMediaWhenInactive = true))
 413
 414   // To change the value for a specific session:
 415   engineSession.settings.suspendMediaWhenInactive = true
 416   ```
 417
 418 * **service-firefox-accounts**
 419   * ⚠️ **This is a breaking API change**:
 420   * `OAuthAccount` now has a new `deviceConstellation` method.
 421   * `FxaAccountManager`'s constructor now takes a `DeviceTuple` parameter.
 422   * Added integration with FxA devices and device events.
 423   * First supported event type is Send Tab.
 424   * It's now possible to receive and send tabs from/to devices in the `DeviceConstellation`.
 425   * `samples-sync` application provides a detailed integration example of these new APIs.
 426   * Brief example:
 427   ```kotlin
 428   val deviceConstellationObserver = object : DeviceConstellationObserver {
 429     override fun onDevicesUpdate(constellation: ConstellationState) {
 430         // Process the following:
 431         // constellation.currentDevice
 432         // constellation.otherDevices
 433     }
 434   }
 435   val deviceEventsObserver = object : DeviceEventsObserver {
 436     override fun onEvents(events: List<DeviceEvent>) {
 437         events.filter { it is DeviceEvent.TabReceived }.forEach {
 438             val tabReceivedEvent = it as DeviceEvent.TabReceived
 439             // process received tab(s).
 440         }
 441     }
 442   }
 443   val accountObserver = object : AccountObserver {
 444     // ... other methods ...
 445     override fun onAuthenticated(account: OAuthAccount) {
 446         account.deviceConstellation().registerDeviceObserver(
 447             observer = deviceConstellationObserver,
 448             owner = this@MainActivity,
 449             autoPause = true
 450         )
 451     }
 452   }
 453   val accountManager = FxaAccountManager(
 454     this,
 455     Config.release(CLIENT_ID, REDIRECT_URL),
 456     arrayOf("profile", "https://identity.mozilla.com/apps/oldsync"),
 457     DeviceTuple(
 458         name = "Doc Example App",
 459         type = DeviceType.MOBILE,
 460         capabilities = listOf(DeviceCapability.SEND_TAB)
 461     ),
 462     syncManager
 463   )
 464   accountManager.register(accountObserver, owner = this, autoPause = true)
 465   accountManager.registerForDeviceEvents(deviceEventsObserver, owner = this, autoPause = true)
 466   ```
 467
 468 * **feature-prompts**
 469   * ⚠️ **This is a breaking API change**:
 470   * `PromptFeature` constructor adds an optional `sessionId`. This should use the custom tab session id if available.
 471
 472 * **browser-session**
 473   * Added `SessionManager.runWithSessionIdOrSelected(sessionId: String?)` run function block on a session ID. If the session does not exist, then uses the selected session.
 474
 475 # 0.51.0
 476
 477 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.50.0...v0.51.0)
 478 * [Milestone](https://github.com/mozilla-mobile/android-components/milestone/54?closed=1)
 479 * [Dependencies](https://github.com/mozilla-mobile/android-components/blob/v0.51.0/buildSrc/src/main/java/Dependencies.kt)
 480 * [Gecko](https://github.com/mozilla-mobile/android-components/blob/v0.51.0/buildSrc/src/main/java/Gecko.kt)
 481 * [Configuration](https://github.com/mozilla-mobile/android-components/blob/v0.51.0/buildSrc/src/main/java/Config.kt)
 482
 483 * **browser-awesomebar**
 484   * Fixed an issue where new suggestions would leave you scrolled to the middle of the list
 485
 486 * **browser-errorpages**
 487   * Added `%backButton%` replacement for buttons that need the text "Go Back" instead of "Try Again"
 488
 489 * **browser-session**, **browser-engine-gecko-nightly**, **browser-engine-system**
 490   * Fixed an issue causing `Session.searchTerms` getting cleared to early. Now the search terms will stay assigned to the `Session` until a new request, triggered by a user interaction like clicking a link, started loading (ignoring redirects).
 491   * Added setting of desktop view port when requesting desktop site
 492
 493 * **feature-customtabs**
 494   * Added fact emitting.
 495   * Bugfix to call with app-contributed pending intents from menu items and action buttons.
 496   * Added ability to decide where menu items requested by the launching app should be inserted into the combined menu by setting `menuItemIndex`
 497
 498 * **service-glean**
 499    * ⚠️ **This is a breaking API change**: Timespan and timing distribution
 500      metrics now have a thread-safe API. See `adding-new-metrics.md` for more
 501      information.
 502    * A method for sending metrics on custom pings has been added. See
 503      `docs/pings/custom.md` for more information.
 504
 505 * **concept-engine**
 506   * Add boolean `allowAutoplayMedia` setting.
 507   * ⚠️ **This is a breaking API change:**
 508   * Added new method to `HistoryTrackingDelegate` interface: `shouldStoreUri(uri: String): Boolean`.
 509   * `VisitType` is now part of `HistoryTrackingDelegate`'s `onVisited` method signature
 510
 511 * **feature-session**
 512   * `HistoryDelegate` now implements a blocklist of URI schemas.
 513
 514 * **browser-engine-gecko-nightly**
 515   * Implement `allowAutoplayMedia` in terms of `autoplayDefault`.
 516   * ⚠️ **This is a breaking API change**
 517   * Added API for bidirectional messaging between Android and installed web extensions:
 518     ```kotlin
 519        engine.installWebExtension(EXTENSION_ID, EXTENSION_URL,
 520             onSuccess = { installedExt -> it }
 521         )
 522
 523       val messageHandler = object : MessageHandler {
 524           override fun onPortConnected(port: Port) {
 525             // Called when a port was connected as a result of a
 526             // browser.runtime.connectNative call in JavaScript.
 527             // The port can be used to send messages to the web extension:
 528             port.postMessage(jsonObject)
 529           }
 530
 531           override fun onPortDisconnected(port: Port) {
 532             // Called when the port was disconnected or the corresponding session closed.
 533           }
 534
 535           override fun onPortMessage(message: Any, port: Port) {
 536             // Called when a message was received on the provided port as a
 537             // result of a call to port.postMessage in JavaScript.
 538           }
 539
 540           override fun onMessage(message: Any, source: EngineSession?): Any {
 541             // Called when a message was received as a result of a
 542             // browser.runtime.sendNativeMessage call in JavaScript.
 543           }
 544       }
 545
 546       // To listen to message events from content scripts call:
 547       installedExt.registerContentMessageHandler(session, EXTENSION_ID, messageHandler)
 548
 549       // To listen to message events from background scripts call:
 550       installedExt.registerBackgroundMessageHandler(EXTENSION_ID, messageHandler)
 551     ```
 552
 553 * **browser-icons**
 554   * Added an in-memory caching mechanism reducing disk/network loads.
 555
 556 * **browser-tabstray**
 557   * Add `TabThumbnailView` to Tabs Tray show the top of the thumbnail and fill up the width of the tile.
 558   * Added swipe gesture support with a `TabTouchCallback` for the TabsTray.
 559
 560 * **concept-storage**, **browser-storage-memory**, **browser-storage-sync**
 561   * ⚠️ **This is a breaking API change**
 562   * Added new method `getVisitsPaginated`; use it to paginate history.
 563   * Added `excludeTypes` param to `getDetailedVisits`; use it to query only subsets of history.
 564   * Added new `getBookmarksWithUrl` method for checking if a site is already bookmarked
 565   * Added new `getBookmark` method for obtaining the details of a single bookmark by GUID
 566
 567 * **browser-storage-sync**
 568   * `PlacesBookmarksStorage` now supports synchronization!
 569
 570 * **support-utils**
 571   * Add `URLStringUtils` to unify parsing of strings that may be URLs.
 572
 573 * **support-ktx**
 574     - Add `URLStringUtils` `isURLLike()` and `toNormalizedURL()`.
 575     - Update the implementation for `String.isUrl()` and `String.toNormalizedUrl()` to the new one above.
 576
 577 * **concept-sync**
 578   * ⚠️ **This is a breaking API change**
 579   * `OAuthAccount` now has a new method `registerPersistenceCallback`.
 580
 581 * **service-fxa**
 582   * `FxaAccountManager` is now using a state persistence callback to keep FxA account state up-to-date as it changes.
 583
 584 # 0.50.0
 585
 586 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.49.0...v0.50.0)
 587 * [Milestone](https://github.com/mozilla-mobile/android-components/milestone/53?closed=1)
 588 * [Dependencies](https://github.com/mozilla-mobile/android-components/blob/v0.50.0/buildSrc/src/main/java/Dependencies.kt)
 589 * [Gecko](https://github.com/mozilla-mobile/android-components/blob/v0.50.0/buildSrc/src/main/java/Gecko.kt)
 590 * [Configuration](https://github.com/mozilla-mobile/android-components/blob/v0.50.0r/buildSrc/src/main/java/Config.kt)
 591
 592 * **browser-toolbar**
 593   * Added `titleView` to `DisplayToolbar` which displays the title of the page. Various options are able to modified such as
 594    `titleTextSize`, `titleColor`, and `displayTitle`. In custom tabs, the URL will now only display the hostname.
 595   * Changed `UrlRenderConfiguration` to include a `RenderStyle` parameter where you can specify how the URL renders
 596
 597 * **support-ktx**
 598   * Added extension property `Uri.isHttpOrHttps`.
 599
 600 * **browser-icons**
 601   * ⚠️ **This is a breaking API change**: Creating a `BrowserIcons` instance requires a `Client` object (from `concept-fetch`) now.
 602
 603 * **browser-engine-gecko-nightly**:
 604   * Added new content blocking category for [fingerprinting](https://en.wikipedia.org/wiki/Device_fingerprint): `TrackingProtectionPolicy.FINGERPRINTING`.
 605
 606 * **feature-findinpage**
 607    * Find in Page now emits facts
 608
 609 * **feature-awesomebar**
 610    * Added `BookmarksStorageSuggestionProvider`
 611
 612 * **browser-toolbar**
 613    * Adds `browserToolbarProgressBarGravity` attr with options `top` and `bottom` (default).
 614    * Adds the ability to long click the urlView
 615
 616 * **service-glean**
 617    * ⚠️ **This is a breaking API change**: The technically public, but not
 618      intended for public use, part of the glean API has been renamed from
 619      `mozilla.components.service.glean.metrics` to
 620      `mozilla.components.service.glean.private`.
 621    * ⚠️ **This is a breaking API change**: Labeled metrics are now their own
 622      distinct metric types in the `metrics.yaml` file. For example, for a
 623      labeled counter, rather than using `type: counter` and `labeled: true`, use
 624      `type: labeled_counter`. See bugzilla 1540725.
 625
 626 * **concept-engine**
 627    * Adds `automaticLanguageAdjustment` setting, which should hint to implementations to send
 628    language specific headers to websites. Implementation in `browser-engine-gecko-nightly`.
 629
 630 * **service-firefox-accounts**
 631    * The service no longer accepts a `successPath` option. Instead the service uses the OAuth `redirectUri`.
 632
 633 * **support-base**
 634   * Added optional callback to `Consumable` to get invoked once value gets consumed:
 635
 636   ```kotlin
 637   val consumable = Consumable.from(42) {
 638     // Value got consumed.
 639   }
 640   ```
 641
 642 # 0.49.0
 643
 644 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.48.0...v0.49.0)
 645 * [Milestone](https://github.com/mozilla-mobile/android-components/milestone/52?closed=1)
 646 * [Dependencies](https://github.com/mozilla-mobile/android-components/blob/v0.49.0/buildSrc/src/main/java/Dependencies.kt)
 647 * [Gecko](https://github.com/mozilla-mobile/android-components/blob/v0.49.0/buildSrc/src/main/java/Gecko.kt)
 648 * [Configuration](https://github.com/mozilla-mobile/android-components/blob/v0.49.0/buildSrc/src/main/java/Config.kt)
 649
 650 * **feature-contextmenu**
 651    * Clicking on a context menu item now emits a fact
 652
 653 * **browser-awesomebar**
 654    * `DefaultSuggestionViewHolder` now centers titles if no description is provided by the suggestion.
 655
 656 * **browser-engine-gecko-***
 657   * Added `automaticFontSizeAdjustment` engine setting for automatic font size adjustment,
 658   in line with system accessibility settings. The default is `true`.
 659   ```kotlin
 660   GeckoEngine(runtime, DefaultSettings(automaticFontSizeAdjustment = true))
 661   ```
 662
 663 * **feature-awesomebar**
 664   * Added optional `icon` parameter to `SearchSuggestionProvider`
 665
 666 * **feature-qr**
 667   * 🆕 New component/feature that provides functionality for scanning QR codes.
 668
 669     ```kotlin
 670       val qrFeature = QrFeature(
 671           context,
 672           fragmentManager = supportFragmentManager,
 673           onNeedToRequestPermissions = { permissions ->
 674               requestPermissions(this, permissions, REQUEST_CODE_CAMERA_PERMISSIONS)
 675           },
 676           onScanResult = { qrScanResult ->
 677               // qrScanResult is a String (e.g. a URL) returned by the QR scanner
 678           }
 679       )
 680       // When ready to scan simply call
 681       qrFeature.scan()
 682     ```
 683
 684 * **concept-storage**
 685   * ⚠️ **This is a breaking API change!** for non-component implementations of `HistoryStorage`.
 686   * `HistoryStorage` got new API: `deleteVisit`.
 687
 688 * **browser-search**
 689   * Imported `list.json` and search plugins from Fennec from 2019-03-29.
 690   * Added support for `searchDefault` and `searchOrder`.
 691   * ⚠️ **This is a breaking API change**: `SearchEngineProvider.loadSearchEngines` returns a new data class `SearchEngineList` (was `List<SearchEngine>`).
 692
 693 * **browser-storage-sync**, **browser-storage-memory**
 694   * Implementations of `concept-storage`/`HistoryStorage` expose newly added `deleteVisit`.
 695
 696 * **browser-toolbar**
 697   * Add TalkBack support for page load status.
 698   * Added option to add "edit actions" that will show up next to the URL in edit mode.
 699   * Added option to set a listener for clicks on the site security indicator (globe / lock icon).
 700   * The `toolbar` now emits a fact `COMMIT` when the user has edited the URL. [More information](https://github.com/mozilla-mobile/android-components/blob/main/components/browser/toolbar/README.md).
 701
 702 * **browser-engine-gecko-nightly**
 703   * Added new `TrackingProtectionPolicy` category for blocking cryptocurrency miners (`TrackingProtectionPolicy.CRYPTOMINING`).
 704
 705 * **support-ktx**
 706   * Added `Intent.toSafeIntent()`.
 707   * Added `MotionEvent.use {}` (like `AutoCloseable.use {}`).
 708   * Added `Bitmap.arePixelsAllTheSame()`.
 709   * Added `Context.appName` returns the name (label) of the application or the package name as a fallback.
 710
 711 * **concept-fetch**
 712   * Added support for interceptors. Interceptors are a powerful mechanism to monitor, modify, retry, redirect or record requests as well as responses going through a `Client`. See the [concept-fetch README](https://github.com/mozilla-mobile/android-components/tree/main/components/concept/fetch) for example implementations of interceptors.
 713
 714 * 💥 **Better crash handling** (#2568, #2569, #2570, #2571)
 715   * **browser-engine-gecko-nightly**: `EngineSession.Observer.onCrashStateChange()` gets invoked if the content process of a session crashed. Internally a new `GeckoSession` will be created. By default this new session will just render a white page (`about:blank`) and not recover the last state. This prevents crash loops and let's the app decide (and show UI) when to restore. Calling `EngineSession.recoverFromCrash()` will try to restore the last known state from before the crash.
 716   * **browser-session**: `Session.crashed` now exposes if a `Session` has crashed.
 717   * **feature-session**: New use case: `SessionUseCases.CrashRecoveryUseCase`.
 718
 719 # 0.48.0
 720
 721 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.47.0...v0.48.0)
 722 * [Milestone](https://github.com/mozilla-mobile/android-components/milestone/51?closed=1)
 723 * [Dependencies](https://github.com/mozilla-mobile/android-components/blob/v0.48.0/buildSrc/src/main/java/Dependencies.kt)
 724 * [Gecko](https://github.com/mozilla-mobile/android-components/blob/v0.48.0/buildSrc/src/main/java/Gecko.kt)
 725 * [Configuration](https://github.com/mozilla-mobile/android-components/blob/v0.48.0/buildSrc/src/main/java/Config.kt)
 726
 727 * **browser-engine-gecko**, **browser-engine-gecko-beta**, **browser-engine-gecko-nightly**
 728   * **Merge day!**
 729     * `browser-engine-gecko-release`: GeckoView 66.0
 730     * `browser-engine-gecko-beta`: GeckoView 67.0
 731     * `browser-engine-gecko-nightly`: GeckoView 68.0
 732
 733 * **browser-session**
 734   * Session now exposes a list of `Media` instances representing playable media on the currently displayed page (see `concept-engine`).
 735
 736 * **concept-engine**, **browser-engine-gecko-nightly**
 737   * Added `Media` class representing a playable media element on the the currently displayed page. Consumers can subscribe to `Media` instances in order to receive updates whenever the state of a `Media` object changes. Currently only the "playback state" is exposed. Consumers can control playback through the
 738   attached `Media.Controller` instance.
 739
 740 * **concept-fetch**
 741   * ⚠️ **This is a breaking API change!**: `Headers.Common` was renamed to `Headers.Names`.
 742   * Added `Headers.Values`.
 743
 744 * **service-pocket**
 745   * Access an article's text-to-speech listen metadata via `PocketListenEndpoint.getListenArticleMetadata`.
 746   * ⚠️ **This is a breaking API change!**: `PocketGlobalVideoRecommendation.id` is now a Long instead of an Int
 747
 748 * **browser-engine-gecko-nightly**
 749   * `GeckoEngine` will throw a `RuntimeException` if the `GeckoRuntime` shuts down unsolicited.
 750
 751 * **feature-awesomebar**
 752   * `SearchSuggestionProvider` and `AwesomeBarFeature` now allow setting a search suggestion limit.
 753
 754 * **feature-findinpage**
 755   * ⚠️ **This is a breaking API change!**: `FindInPageFeature` constructor now takes an `EngineView` instance.
 756   * Blur controlled `EngineView` for better screen reader accessibility.
 757   * Announce result count for screen reader users.
 758
 759 * **support-android-test**
 760   * Added `ViewMatchers` that take Boolean arguments instead of requiring inversion via the `not` Matcher: e.g. `hasFocus(false)` instead of `not(hasFocus())`
 761   * Added `ViewInteraction` extension functions like `assertHasFocus(Boolean)` for short-hand.
 762   * Added `Matchers.maybeInvertMatcher` to optionally apply `not` based on the Boolean argument
 763   * Added `ViewInteraction.click()` extension function for short-hand.
 764
 765 * **service-glean**
 766   * ⚠️ **This is a breaking API change!**: `Configuration` now accepts a Lazy<Client> to make sure the HTTP client (lib) is initialized lazily.
 767     ```kotlin
 768       val config = Configuration(httpClient = lazy { GeckoViewFetchClient(context, GeckoRuntime()) })
 769       Glean.initialize(context, config)
 770     ```
 771 * **feature-accounts**, **service-firefox-account**
 772   * Added API to start an FxA pairing flow. See `FirefoxAccountsAuthFeature.beginPairingAuthentication` and `FxaAccountsManager.beingAuthentication` respectively.
 773
 774 * **concept-storage**
 775   * ⚠️ **This is a breaking API change!** for non-component implementations of `HistoryStorage`.
 776   * `HistoryStorage` got new APIs: `deleteEverything`, `deleteVisitsSince`, `deleteVisitsBetween`, `deleteVisitsFor`, `prune` and `runMaintenance`.
 777   * Added `BookmarksStorage` for handling the saving, searching, and management of browser bookmarks.
 778
 779 * **browser-storage-sync**, **browser-storage-memory**
 780   * Implementations of `concept-storage`/`HistoryStorage` expose the newly added APIs.
 781
 782 * **browser-storage-sync**
 783   * Implementations of `concept-storage`/`BookmarksStorage` expose the newly added APIs.
 784
 785 # 0.47.0
 786
 787 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.46.0...v0.47.0)
 788 * [Milestone](https://github.com/mozilla-mobile/android-components/milestone/50?closed=1)
 789 * [Dependencies](https://github.com/mozilla-mobile/android-components/blob/v0.47.0/buildSrc/src/main/java/Dependencies.kt)
 790 * [Gecko](https://github.com/mozilla-mobile/android-components/blob/v0.47.0/buildSrc/src/main/java/Gecko.kt)
 791 * [Configuration](https://github.com/mozilla-mobile/android-components/blob/v0.47.0/buildSrc/src/main/java/Config.kt)
 792
 793 * **browser-session**
 794   * Added `Session.webAppManifest` to expose the [Web App Manifest](https://developer.mozilla.org/en-US/docs/Web/Manifest) of the currently visible page. This functionality will only be available in [GeckoView](https://mozilla.github.io/geckoview/)-flavored [concept-engine](https://github.com/mozilla-mobile/android-components/tree/main/components/concept/engine) implementations.
 795   * Added `WebAppManifestParser` to create [WebAppManifest](https://mozac.org/api/mozilla.components.browser.session.manifest/-web-app-manifest/) from JSON.
 796
 797 * **browser-menu**
 798    * Added `TwoStateButton` in `BrowserMenuItemToolbar` that will change resources based on the `isInPrimaryState` lambda and added ability to disable the button with optional `disableInSecondaryState` argument.
 799
 800 * **browser-toolbar**
 801   * Adds `onCancelEditing` to `onEditListener` in `BrowserToolbar` which is fired when a back button press occurs while the keyboard is displayed.
 802     This is especially useful if you want to call `activity.onBackPressed()` to navigate away rather than just dismiss the keyboard.
 803     Its return value is used to determine if `displayMode` will switch from edit to view.
 804
 805 * **concept-sync**
 806   * 🆕 New component which describes sync-related interfaces, such as SyncManager, SyncableStore, SyncStatusObserver and others.
 807
 808 * **concept-storage**
 809   * ⚠️ **This is a breaking API change!**: Removed sync-related interfaces. See **concept-sync**.
 810   * **HistoryStorage** interface has a new method: `getDetailedVisits(start, end) -> List<VisitInfo>`. It provides detailed information about page visits (title, visit type, timestamp, etc).
 811
 812 * **browser-storage-memory**, **browser-storage-sync**:
 813   * Added implementations for the new getDetailedVisits API from **concept-storage**.
 814
 815 * **feature-sync**
 816   * ⚠️ **This is a breaking API change!** Complete overhaul of this component.
 817   * Added `BackgroundSyncManager`, a WorkManager-based implementation of the SyncManager defined in `concept-sync`.
 818   * An instance of a SyncManager is an entry point for interacting with background data synchronization.
 819   * See component's README for usage details.
 820
 821 * **browser-engine-system** and **browser-engine-gecko-nightly**
 822   * ⚠️ **This is a breaking API change**: The [`captureThumbnail`](https://github.com/mozilla-mobile/android-components/blob/1b1600a7e8aa83a7e7d09b30cecd49762f7781f5/components/concept/engine/src/main/java/mozilla/components/concept/engine/EngineSession.kt#L245) function has been moved to [`EngineView`](https://github.com/mozilla-mobile/android-components/blob/1b1600a7e8aa83a7e7d09b30cecd49762f7781f5/components/concept/engine/src/main/java/mozilla/components/concept/engine/EngineView.kt#L15). From now on for taking screenshots automatically you will have to opt-in by using `ThumbnailsFeature`. The decision was made to reduce overhead memory consumption for apps that are not using screenshots. Find more info in [feature-session](https://github.com/mozilla-mobile/android-components/blob/main/components/feature/session/README.md) and a practical example can be found in the [sample-browser project](https://github.com/mozilla-mobile/android-components/blob/main/samples/browser).
 823
 824 * **feature-session-bundling**
 825   * Saving, restoring and removing `SessionBundle` instances need to happen on a worker thread now (off the main thread).
 826   * The actual session state is now saved on the file system outside of the internally used SQLite database.
 827
 828 * **support-ktx**
 829   * Added `File.truncateDirectory()` to remove all files (and sub directories) in a directory.
 830   * Added `Activity.applyOrientation(manifest: WebAppManifest)` extension method for applying orientation modes #2291.
 831   * Added `Context.isMainProcess` and `Context.runOnlyInMainProcess(block: () -> Unit)` to detect when you're running on the main process.
 832 ```kotlin
 833       // true if we are running in the main process otherwise false .
 834       val isMainProcess = context.isMainProcess()
 835
 836       context.runOnlyInMainProcess {
 837             /* This function is only going to run if we are
 838                 in the main process, otherwise it won't be executed.  */
 839        }
 840 ```
 841
 842 * **feature-pwa**
 843   * 🆕 New component that provides functionality for supporting Progressive Web Apps (PWA).
 844
 845 * **feature-session**
 846   * Adds support for the picture-in-picture mode in `PictureInPictureFeature`.
 847
 848 * **browser-storage-sync**
 849   * Changed how Rust Places database connections are maintained, based on [new reader/writer APIs](https://github.com/mozilla/application-services/pull/718).
 850
 851 * **service-pocket**
 852   * Access the list of global video recommendations via `PocketEndpoint.getGlobalVideoRecommendations`.
 853
 854 * **concept-fetch**
 855   * Added common HTTP header constants in `Headers.Common`. This collection is incomplete: add your own!
 856
 857 # 0.46.0
 858
 859 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.45.0...v0.46.0)
 860 * [Milestone](https://github.com/mozilla-mobile/android-components/milestone/49?closed=1)
 861 * [Dependencies](https://github.com/mozilla-mobile/android-components/blob/v0.46.0/buildSrc/src/main/java/Dependencies.kt)
 862 * [Gecko](https://github.com/mozilla-mobile/android-components/blob/v0.46.0/buildSrc/src/main/java/Gecko.kt)
 863 * [Configuration](https://github.com/mozilla-mobile/android-components/blob/v0.46.0/buildSrc/src/main/java/Config.kt)
 864
 865 * **browser-awesomebar**
 866   * Adds ability to remove `SuggestionProvider`s with `removeProviders` and `removeAllProviders`
 867
 868 * **browser-menu**
 869   * ⚠️ **This is a breaking API change!**: Removed redundant `BrowserMenuImageText` `contentDescription`
 870   * Adds `textSize` parameter to `SimpleBrowserMenuItem`
 871
 872 * **concept-fetch**
 873   * ⚠️ **This is a breaking API change**: the [`Response`](https://mozac.org/api/mozilla.components.concept.fetch/-response/) properties `.success` and `.clientError` were renamed to `.isSuccess` and `isClientError` respectively to match Java conventions.
 874
 875 * **feature-downloads**
 876   * Fixing bug #2265. In some occasions, when trying to download a file, the download failed and the download notification shows "Unsuccessful download".
 877
 878 * **feature-search**
 879   * Adds default search engine var to `SearchEngineManager`
 880   * Adds optional `SearchEngine` to `invoke()` in `SearchUseCases`
 881
 882 * **service-experiments**
 883   * A new client-side experiments SDK for running segmenting user populations to run multi-branch experiments on them. This component is going to replace `service-fretboard`. The SDK is currently in development and the component is not ready to be used yet.
 884
 885 * * **browser-icons**
 886   * Adding a decoder for decoding ICO files see #2040.
 887
 888 * **service-pocket**
 889   * 🆕 New component to interact with the Pocket APIs.
 890
 891 # 0.45.0
 892
 893 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.44.0...v0.45.0)
 894 * [Milestone](https://github.com/mozilla-mobile/android-components/milestone/47?closed=1)
 895 * [Dependencies](https://github.com/mozilla-mobile/android-components/blob/v0.45.0/buildSrc/src/main/java/Dependencies.kt)
 896 * [Gecko](https://github.com/mozilla-mobile/android-components/blob/v0.45.0/buildSrc/src/main/java/Gecko.kt)
 897 * [Configuration](https://github.com/mozilla-mobile/android-components/blob/v0.45.0/buildSrc/src/main/java/Config.kt)
 898
 899 * Mozilla App Services dependency upgraded: **0.18.0** 🔺
 900   * [0.18.0 release notes](https://github.com/mozilla/application-services/releases/tag/v0.18.0)
 901
 902 * **browser-engine-gecko-nightly**
 903   * Added API to install web extensions:
 904
 905   ```kotlin
 906   val borderify = WebExtension("borderify", "resource://android/assets/extensions/borderify/")
 907   engine.installWebExtension(borderify) {
 908       ext, throwable -> Log.log(Log.Priority.ERROR, "MyApp", throwable, "Failed to install ${ext.id}")
 909   }
 910   ```
 911
 912 * **feature-search**
 913   * Added `newPrivateTabSearch` `NewTabSearchUseCase`
 914
 915 * **feature-toolbar**
 916   * Added ability to color parts of the domain (e.g. [registrable domain](https://url.spec.whatwg.org/#host-registrable-domain)) by providing a `UrlRenderConfiguration`:
 917
 918   ```kotlin
 919   ToolbarFeature(
 920     // ...
 921     ToolbarFeature.UrlRenderConfiguration(
 922         publicSuffixList, // Use a shared global instance
 923         registrableDomainColor = 0xFFFF0000.toInt(),
 924         urlColor = 0xFF00FF00.toInt()
 925     )
 926   ```
 927
 928 * **browser-toolbar**
 929   * `BrowserToolbar` `cancelView` is now `clearView` with new text clearing behavior and color attribute updated from `browserToolbarCancelColor` to `browserToolbarClearColor`
 930
 931 * **concept-awesomebar**
 932   * ⚠️ **This is a breaking API change**: [AwesomeBar.Suggestion](https://mozac.org/api/mozilla.components.concept.awesomebar/-awesome-bar/-suggestion/) instances must now declare the provider that created them.
 933
 934 * **browser-awesomebar**
 935   * [BrowserAwesomeBar](https://mozac.org/api/mozilla.components.browser.awesomebar/-browser-awesome-bar/) is now replacing suggestions "in-place" if their ids match. Additionally `BrowserAwesomeBar` now automatically scrolls to the top whenever the entered text changes.
 936
 937 * **feature-customtabs**
 938   * Now returns false in `onBackPressed()` if feature is not initialized
 939
 940 * **support-android-test**
 941   * 🆕 New component to be used for helpers used in instrumented (on device) tests (`src/androidTest`). This component complements `support-test` which is focused on helpers used in local unit tests (`src/test`).
 942   * Added helper `LiveData.awaitValue()` which subscribes to the `LiveData` object and blocks until a value was observed. Returns the value or throws an `InterruptedException` if no value was observed (customizable timeout).
 943
 944 * **feature-session-bundling**
 945   * Added optional `since` parameter to `SessionBundleStorage.bundles()` and `SessionBundleStorage.bundlesPaged()`.
 946
 947 # 0.44.0
 948
 949 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.43.0...v0.44.0)
 950 * [Milestone](https://github.com/mozilla-mobile/android-components/milestone/46?closed=1)
 951 * [Dependencies](https://github.com/mozilla-mobile/android-components/blob/v0.44.0/buildSrc/src/main/java/Dependencies.kt)
 952 * [Gecko](https://github.com/mozilla-mobile/android-components/blob/v0.44.0/buildSrc/src/main/java/Gecko.kt)
 953 * [Configuration](https://github.com/mozilla-mobile/android-components/blob/v0.44.0/buildSrc/src/main/java/Config.kt)
 954
 955 * **browser-menu**
 956   * Added option to set background color by overriding `mozac_browser_menu_background` color resource.
 957
 958     ```xml
 959     <color name="mozac_browser_menu_background">DESIRED_COLOR</color>
 960     ```
 961     **OR**
 962       ```xml
 963       <style name="Mozac.Browser.Menu" parent="" tools:ignore="UnusedResources">
 964         <item name="cardBackgroundColor">YOUR_COLOR</item>
 965       </style>
 966     ```
 967
 968   * Added option to style `SimpleBrowserMenuItem` and `BrowserMenuImageText` with `textColorResource`.
 969
 970 * **browser-toolbar**
 971   * Added option to configure fading edge length by using `browserToolbarFadingEdgeSize` XML attribute.
 972   * Added `BrowserToolbar` attribute `browserToolbarCancelColor` to color the cancel icon.
 973
 974 * **feature-toolbar**
 975   * `ToolbarPresenter` now handles situations where no `Session` is selected.
 976
 977 * **intent-processor**
 978   * Intent processor now lets you set `isPrivate` which will open process intents as private tabs
 979
 980 * **service-fretboard (Kinto)**
 981   * ⚠️ **This is a breaking API change!**
 982   * Now makes use of our concept-fetch module when communicating with the server. This allows applications to specify which HTTP client library to use e.g. apps already using GeckoView can now specify that the `GeckoViewFetchClient` should be used. As a consequence, the fetch client instance now needs to be provided when creating a `KintoExperimentSource`.
 983
 984   ```kotlin
 985     val fretboard = Fretboard(
 986       KintoExperimentSource(
 987         baseUrl,
 988         bucketName,
 989         collectionName,
 990         // Specify that the GV-based fetch client should be used.
 991         GeckoViewFetchClient(context)
 992       ),
 993       experimentStorage
 994   )
 995   ```
 996
 997 * **feature-session-bundling**
 998   * Added `SessionBundleStorage.autoClose()`: When "auto close" is enabled the currently active `SessionBundle` will automatically be closed and a new `SessionBundle`  will be started if the bundle lifetime expires while the app is in the background.
 999
1000 * **browser-engine-gecko**, **browser-engine-gecko-beta**, **browser-engine-gecko-nightly**:
1001   * Fixed an issue that caused [autofill](https://developer.android.com/guide/topics/text/autofill) to not work with those components.
1002
1003 * **feature-sitepermissions**
1004   * 🆕 A feature for showing site permission request prompts. For more info take a look at the [docs](https://github.com/mozilla-mobile/android-components/blob/main/components/feature/sitepermissions/README.md).
1005
1006 * **browser-session**
1007   * Added `SelectionAwareSessionObserver.observeIdOrSelected(sessionId: String?)` to observe the session based on a session ID. If the session does not exist, then observe the selected session.
1008
1009 # 0.43.0
1010
1011 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.42.0...v0.43.0)
1012 * [Milestone](https://github.com/mozilla-mobile/android-components/milestone/45?closed=1)
1013 * [Dependencies](https://github.com/mozilla-mobile/android-components/blob/v0.43.0/buildSrc/src/main/java/Dependencies.kt)
1014 * [Gecko](https://github.com/mozilla-mobile/android-components/blob/v0.43.0/buildSrc/src/main/java/Gecko.kt)
1015 * [Configuration](https://github.com/mozilla-mobile/android-components/blob/v0.43.0/buildSrc/src/main/java/Config.kt)
1016
1017 * **browser-engine-system**
1018   * Added support for [JavaScript confirm alerts](https://developer.mozilla.org/en-US/docs/Web/API/Window/confirm) on WebView.
1019
1020 * **browser-icons**
1021   * 🆕 New component for loading and storing website icons (like [Favicons](https://en.wikipedia.org/wiki/Favicon)).
1022   * Supports generating a "fallback" icon if no icon could be loaded.
1023
1024 * **concept-fetch**
1025   * Added API to specify whether or not cookies should be sent with a request. This can be controlled using the `cookiePolicy` parameter when creating a `Request`.
1026
1027   ```kotlin
1028   // Do not send cookies with this request
1029   client.fetch(Request(url, cookiePolicy = CookiePolicy.OMIT)).use { response ->
1030     val body = response.body.string()
1031   }
1032   ```
1033   * Added flag to specify whether or not caches should be used. This can be controlled with the `useCaches` parameter when creating a `Request`.
1034
1035   ```kotlin
1036   // Force a network request (do not use cached responses)
1037   client.fetch(Request(url, useCaches = false)).use { response ->
1038     val body = response.body.string()
1039   }
1040   ```
1041
1042 * **feature-awesomebar**
1043   * ⚠️ **This is a breaking API change!**
1044   * Now makes use of our concept-fetch module when fetching search suggestions. This allows applications to specify which HTTP client library to use e.g. apps already using GeckoView can now specify that the `GeckoViewFetchClient` should be used. As a consequence, the fetch client instance now needs to be provided when adding a search provider.
1045
1046   ```kotlin
1047   AwesomeBarFeature(layout.awesomeBar, layout.toolbar, layout.engineView)
1048     .addHistoryProvider(components.historyStorage, components.sessionUseCases.loadUrl)
1049     .addSessionProvider(components.sessionManager, components.tabsUseCases.selectTab)
1050     .addSearchProvider(
1051       components.searchEngineManager.getDefaultSearchEngine(requireContext()),
1052       components.searchUseCases.defaultSearch,
1053       // Specify that the GV-based fetch client should be used.
1054       GeckoViewFetchClient(context))
1055   ```
1056
1057 * **ui-doorhanger**
1058   * Added `DoorhangerPrompt` - a builder for creating a prompt `Doorhanger` providing a way to present decisions to users.
1059
1060 * **feature-downloads**
1061   * Ignoring schemes that are not https or http [#issue 554](https://github.com/mozilla-mobile/reference-browser/issues/554)
1062
1063 * **support-ktx**
1064   * Added `Uri.hostWithoutCommonPrefixes` to return the host with common prefixes removed:
1065
1066   ```kotlin
1067   "https://www.mozilla.org"
1068       .toUri()
1069       .hostWithoutCommonPrefixes // mozilla.org
1070
1071   "https://mobile.twitter.com/home"
1072       .toUri()
1073       .hostWithoutCommonPrefixes  // twitter.com
1074
1075   "https://m.facebook.com/"
1076       .toUri()
1077       .hostWithoutCommonPrefixes
1078   ```
1079
1080   ℹ️ Note that this method only strips common prefixes like "www", "m" or "mobile". If you are interested in extracting something like the [eTLD](https://en.wikipedia.org/wiki/Public_Suffix_List) from a host then use [PublicSuffixList](https://mozac.org/api/mozilla.components.lib.publicsuffixlist/-public-suffix-list/) of the `lib-publicsuffixlist` component.
1081
1082   * Added `String.toUri()` as a shorthand for `Uri.parse()` and in addition to other `to*()` methods already available in the Kotlin Standard Library.
1083
1084 * **support-utils**
1085   * Added `Browsers` utility class for collecting and analyzing information about installed browser applications.
1086
1087 * **browser-session**, **feature-session-bundling**
1088   * `SessionStorage` and `SessionBundleStorage` now save and restore the title of `Session` objects.
1089   * `SessionManager.restore()` now allows passing in empty snapshots.
1090
1091 * **feature-session-bundling**
1092   * Empty snapshots are no longer saved in the database:
1093     * If no restored bundle exists then no new bundle is saved for an empty snapshot.
1094     * If there is an active bundle then the bundle will be removed instead of updated with the empty snapshot.
1095
1096 * **browser-toolbar**, **concept-toolbar**
1097   * ⚠️ **This is a breaking API change**: The interface of the "URL commit listener" changed from `(String) -> Unit` to `(String) -> Boolean`. If the function returns `true` then the toolbar will automatically switch to "display mode". If no function is set or if the function returns false the toolbar remains in "edit mode".
1098   * Added `private` field (`Boolean`): Enables/Disables private mode. In private mode the IME should not update any personalized data such as typing history and personalized language model based on what the user typed.
1099   * The background and foreground color of the autocomplete suggestion can now be styled:
1100
1101   ```xml
1102   <mozilla.components.browser.toolbar.BrowserToolbar
1103       ...
1104       app:browserToolbarSuggestionBackgroundColor="#ffffcc00"
1105       app:browserToolbarSuggestionForegroundColor="#ffff4444"/>
1106   ```
1107
1108 # 0.42.0
1109
1110 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.41.0...v0.42.0)
1111 * [Milestone](https://github.com/mozilla-mobile/android-components/milestone/44?closed=1)
1112 * [API reference](https://mozilla-mobile.github.io/android-components/api/0.42.0/index)
1113 * [Dependencies](https://github.com/mozilla-mobile/android-components/blob/v0.42.0/buildSrc/src/main/java/Dependencies.kt)
1114 * [Gecko](https://github.com/mozilla-mobile/android-components/blob/v0.42.0/buildSrc/src/main/java/Gecko.kt)
1115 * [Configuration](https://github.com/mozilla-mobile/android-components/blob/v0.42.0/buildSrc/src/main/java/Config.kt)
1116
1117 * **engine-gecko-nightly**
1118   * Now also serves as an implementation of `concept-fetch` by providing the new `GeckoViewFetchClient`. This allows applications to rely on Gecko's networking capabilities when issuing HTTP requests, even outside the browser view (GeckoView).
1119
1120 * **feature-prompts**, **browser-engine-gecko***
1121   * Added support for [JavaScript Confirm dialogs](https://developer.mozilla.org/en-US/docs/Web/API/Window/confirm).
1122
1123 * **feature-session**
1124   * Fixed an issue causing `EngineViewPresenter` to render a selected `Session` even though it was configured to show a fixed `Session`. This issue caused a crash (`IllegalStateException: Display already acquired`) in the [Reference Browser](https://github.com/mozilla-mobile/reference-browser) when a "Custom Tab" and the "Browser" tried to render the same `Session`.
1125   * Fixed an issue where back and forward button handling would not take place on the session whose ID was provided.
1126
1127 * **feature-search**
1128   * Added `SearchUseCases.NewTabSearchUseCase` and interface `SearchUseCase` (implemented by `DefaultSearchUseCase` and `NewTabSearchUseCase`).
1129
1130 * **browser-engine-system**
1131   * Added support for [JavaScript prompt alerts](https://developer.mozilla.org/en-US/docs/Web/API/Window/prompt) on WebView.
1132
1133 * **feature-customtabs**
1134   * Fixed an issue causing the `closeListener` to be invoked even when the current session isn't a Custom Tab.
1135   * Fixed an issue with the image resources in the toolbar were not tinted when an app provided a light colour for the background.
1136
1137 * **support-base**
1138   * Added `ViewBoundFeatureWrapper` for wrapping `LifecycleAwareFeature` references that will automatically be cleared if the provided `View` gets detached. This is helpful for fragments that want to keep a reference to a `LifecycleAwareFeature` (e.g. to be able call `onBackPressed()`) that itself has strong references to `View` objects. In cases where the fragment gets detached (e.g. to be added to the backstack) and the `View` gets detached (and destroyed) the wrapper will automatically stop the `LifecycleAwareFeature`  and clear all references..
1139   * Added generic `BackHandler` interface for fragments, features and other components that want to handle 'back' button presses.
1140
1141 * **ui-doorhanger**
1142   * 🆕 New component: A `Doorhanger` is a floating heads-up popup that can be anchored to a view. They are presented to notify the user of something that is important (e.g. a content permission request).
1143
1144 * **feature-sitepermissions**
1145   * 🆕 New component: A feature that will subscribe to the selected session, and will provide an UI for all the incoming appPermission and contentPermission request.
1146
1147 # 0.41.0
1148
1149 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.40.0...v0.41.0)
1150 * [Milestone](https://github.com/mozilla-mobile/android-components/milestone/43?closed=1)
1151 * [API reference](https://mozilla-mobile.github.io/android-components/api/0.41.0/index)
1152 * [Dependencies](https://github.com/mozilla-mobile/android-components/blob/v0.41.0/buildSrc/src/main/java/Dependencies.kt)
1153 * [Gecko](https://github.com/mozilla-mobile/android-components/blob/v0.41.0/buildSrc/src/main/java/Gecko.kt)
1154 * [Configuration](https://github.com/mozilla-mobile/android-components/blob/v0.41.0/buildSrc/src/main/java/Config.kt)
1155
1156 * Mozilla App Services dependency upgraded: **0.15.0** 🔺
1157   * [0.15.0 release notes](https://github.com/mozilla/application-services/releases/tag/v0.15.0)
1158
1159 * **browser-engine-gecko-nightly**
1160   * Tweaked `NestedGeckoView` to "stick" to `AppBar` in nested scroll, like other Android apps. This is possible after a [fix](https://bugzilla.mozilla.org/show_bug.cgi?id=1515774) in APZ gesture detection.
1161
1162 * **feature-browser**
1163   * Added `BrowserToolbar` attributes to color the menu.
1164
1165   ```xml
1166   <mozilla.components.browser.toolbar.BrowserToolbar
1167       android:id="@+id/toolbar"
1168       android:layout_width="match_parent"
1169       android:layout_height="56dp"
1170       android:background="#aaaaaa"
1171       app:browserToolbarMenuColor="@color/photonBlue50"
1172       app:browserToolbarInsecureColor="@color/photonRed50"
1173       app:browserToolbarSecureColor="@color/photonGreen50" />
1174   ```
1175
1176 * **feature-contextmenu**
1177   * Fixed Context Menus feature to work with Custom Tabs by passing in the session ID when applicable.
1178
1179 * **feature-customtabs**
1180   * Added a temporary workaround for Custom Tab intents not being recognized when using the Jetifier tool.
1181
1182 * **feature-downloads**
1183   * ⚠️ **This is a breaking API change!**
1184   * The required permissions are now passed to the `onNeedToRequestPermissions` callback.
1185
1186   ```kotlin
1187   downloadsFeature = DownloadsFeature(
1188       requireContext(),
1189       sessionManager = components.sessionManager,
1190       fragmentManager = childFragmentManager,
1191       onNeedToRequestPermissions = { permissions ->
1192           requestPermissions(permissions, REQUEST_CODE_DOWNLOAD_PERMISSIONS)
1193       }
1194   )
1195   ```
1196
1197   * Removed the `onPermissionsGranted` method in favour of `onPermissionsResult` which handles both granted and denied permissions. This method should be invoked from `onRequestPermissionsResult`:
1198
1199   ```kotlin
1200    override fun onRequestPermissionsResult(requestCode: Int, permissions: Array<String>, grantResults: IntArray) {
1201       when (requestCode) {
1202           REQUEST_CODE_DOWNLOAD_PERMISSIONS -> downloadsFeature.onPermissionsResult(permissions, grantResults)
1203       }
1204     }
1205   ```
1206
1207   * Fixed Downloads feature to work with Custom Tabs by passing in the session ID when applicable.
1208
1209  * **feature-prompts**
1210    * ⚠️ **This is a breaking API change!**
1211    * These change are similar to the ones for feature-downloads above and aim to provide a consistent way of handling permission requests.
1212    * The required permissions are now passed to the `onNeedToRequestPermissions` callback.
1213
1214    ```kotlin
1215    promptFeature = PromptFeature(
1216       fragment = this,
1217       sessionManager = components.sessionManager,
1218       fragmentManager = requireFragmentManager(),
1219       onNeedToRequestPermissions = { permissions ->
1220           requestPermissions(permissions, REQUEST_CODE_PROMPT_PERMISSIONS)
1221       }
1222    )
1223    ```
1224
1225    * Renamed `onRequestsPermissionsResult` to `onPermissionResult` and allow applications to specify the permission request code. This method should be invoked from `onRequestPermissionsResult`:
1226
1227   ```kotlin
1228    override fun onRequestPermissionsResult(requestCode: Int, permissions: Array<String>, grantResults: IntArray) {
1229       when (requestCode) {
1230           REQUEST_CODE_DOWNLOAD_PERMISSIONS -> downloadsFeature.onPermissionsResult(permissions, grantResults)
1231       }
1232     }
1233   ```
1234
1235 * **feature-contextmenu**
1236   * The component is now performing [haptic feedback](https://material.io/design/platform-guidance/android-haptics.html#) when showing a context menu.
1237
1238 * **browser-engine-gecko**, **browser-engine-gecko-beta**, **browser-engine-gecko-nightly**
1239   * After "Merge Day" and the release of Firefox 65 we updated our gecko-based components to follow the new upstream versions:
1240     * `browser-engine-gecko`: 65.0
1241     * `browser-engine-gecko-beta`: 66.0
1242     * `browser-engine-gecko-nightly`: 67.0
1243
1244 * **browser-toolbar**
1245   * Toolbar URL autocompletion is now performed off the UI thread.
1246
1247 * **concept-storage**
1248   * ⚠️ **This is a breaking API change!**
1249   * `HistoryAutocompleteResult` now includes an `input` field.
1250
1251 * **browser-domains**
1252   * ⚠️ **This is a breaking API change!**
1253   * `DomainAutocompleteResult` now includes an `input` field.
1254
1255 # 0.40.0
1256
1257 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.39.0...v0.40.0)
1258 * [Milestone](https://github.com/mozilla-mobile/android-components/milestone/42?closed=1)
1259 * [API reference](https://mozilla-mobile.github.io/android-components/api/0.40.0/index)
1260 * [Dependencies](https://github.com/mozilla-mobile/android-components/blob/v0.40.0/buildSrc/src/main/java/Dependencies.kt)
1261 * [Gecko](https://github.com/mozilla-mobile/android-components/blob/v0.40.0/buildSrc/src/main/java/Gecko.kt)
1262 * [Configuration](https://github.com/mozilla-mobile/android-components/blob/v0.40.0/buildSrc/src/main/java/Config.kt)
1263
1264 * **support-ktx**
1265   * Added `Lifecycle.addObservers` to observe the lifecycle for multiple classes.
1266
1267   ```kotlin
1268     override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
1269       lifecycle.addObservers(
1270         fullscreenFeature,
1271         sessionFeature,
1272         customTabsToolbarFeature
1273       )
1274     }
1275     ```
1276
1277 * **feature-awesomebar**
1278   * Added ability to show one item per search suggestion ([#1779](https://github.com/mozilla-mobile/android-components/issues/1779))
1279   * Added ability to define custom hooks to be invoked when editing starts or is completed.
1280
1281 * **browser-awesomebar**
1282   * Added ability to let consumers define the layouting of suggestions by implementing `SuggestionLayout` in order to control layout inflation and view binding.
1283
1284   ```kotlin
1285   // Create a ViewHolder for your custom layout.
1286   class CustomViewHolder(view: View) : SuggestionViewHolder(view) {
1287       private val textView = view.findViewById<TextView>(R.id.text)
1288
1289       override fun bind(
1290           suggestion: AwesomeBar.Suggestion,
1291           selectionListener: () -> Unit
1292       ) {
1293           textView.text = suggestion.title
1294           textView.setOnClickListener {
1295               suggestion.onSuggestionClicked?.invoke()
1296               selectionListener.invoke()
1297           }
1298       }
1299   }
1300
1301   // Create a custom SuggestionLayout for controlling view inflation
1302   class CustomSuggestionLayout : SuggestionLayout {
1303       override fun getLayoutResource(suggestion: AwesomeBar.Suggestion): Int {
1304           return android.R.layout.simple_list_item_1
1305       }
1306
1307       override fun createViewHolder(awesomeBar: BrowserAwesomeBar, view: View, layoutId: Int): SuggestionViewHolder {
1308           return CustomViewHolder(view)
1309       }
1310   }
1311   ```
1312
1313   * Added ability to transform suggestions returned by provider (adding data, removing data, filtering suggestions, ...)
1314
1315   ```kotlin
1316   awesomeBar.transformer = object : SuggestionTransformer {
1317       override fun transform(
1318           provider: AwesomeBar.SuggestionProvider,
1319           suggestions: List<AwesomeBar.Suggestion>
1320       ): List<AwesomeBar.Suggestion> {
1321           return suggestions.map { suggestion ->
1322               suggestion.copy(title = "Awesome!")
1323           }
1324       }
1325   }
1326
1327   // Use the custom layout with a BrowserAwesomeBar instance
1328   awesomeBar.layout = CustomSuggestionLayout()
1329   ```
1330
1331 * **lib-publicsuffixlist**
1332   * The public suffix list shipping with this component is now updated automatically in the repository every day (if there are changes).
1333   * Fixed an issue when comparing domain labels against the public suffix list ([#1777](https://github.com/mozilla-mobile/android-components/issues/1777))
1334
1335 * **feature-prompts**, **browser-engine-gecko***
1336   * Added support for [Pop-up windows dialog](https://support.mozilla.org/en-US/kb/pop-blocker-settings-exceptions-troubleshooting#w_what-are-pop-ups).
1337
1338 * **browser-engine-system**
1339   * Preventing JavaScript `confirm()` and `prompt()` until providing proper implementation #1816.
1340
1341 * **feature-search**, **feature-session**
1342   * `SessionUseCases` and `SearchUseCases` now take an optional `onNoSession: String -> Session` lambda parameter. This function will be invoked when executing a use case that requires a (selected) `Session` and no such session is available. This makes using the use cases and feature components usable in browsers that may not always have sessions. The default implementation creates a new `Session` and adds it to the `SessionManager`.
1343
1344 * **support-rustlog**
1345   * 🆕 New component: This component allows consumers of [megazorded](https://mozilla.github.io/application-services/docs/applications/consuming-megazord-libraries.html) Rust libraries produced by application-services to redirect their log output to the base component's log system as follows:
1346   ```kotlin
1347   import mozilla.components.support.rustlog.RustLog
1348   import mozilla.components.support.base.log.Log
1349   // In onCreate, any time after MyMegazordClass.init()
1350   RustLog.enable()
1351   // Note: By default this is enabled at level DEBUG, which can be adjusted.
1352   // (It is recommended you do this for performance if you adjust
1353   // `Log.logLevel`).
1354   RustLog.setMaxLevel(Log.Priority.INFO)
1355   // You can also enable "trace logs", which may include PII
1356   // (but can assist debugging) as follows. It is recommended
1357   // you not do this in builds you distribute to users.
1358   RustLog.setMaxLevel(Log.Priority.DEBUG, true)
1359   ```
1360   * This is pointless to do when not using a megazord.
1361     * Megazording is required due to each dynamically loaded Rust library having its own internal/private version of the Rust logging framework. When megazording, this is still true, but there's only a single dynamically loaded library, and so it's redirected properly. (This could probably be worked around, but it would take a great effort, and given that we expect most production use of these libraries will be using megazords, we accepted this limitation)
1362     * This would be very annoying during initial development (and debugging the sample apps), so by default, we'll log (directly, e.g. not through the base component logger) to logcat when not megazorded.
1363   * Note that you must call `MyMegazordClass.init()` *before* any uses of this class.
1364
1365 * Mozilla App Services library updated to 0.14.0. See [release notes](https://github.com/mozilla/application-services/releases/tag/v0.14.0) for details.
1366   * Important: Users consuming megazords must also update the application-services gradle plugin to version 0.3.0.
1367
1368 * **feature-findinpage**
1369   * 🆕 A new feature component for [finding text in a web page](https://support.mozilla.org/en-US/kb/search-contents-current-page-text-or-links). [Documentation](https://github.com/mozilla-mobile/android-components/blob/main/components/feature/findinpage/README.md).
1370
1371 * **service-firefox-accounts**
1372   * Added `FxaAccountManager`, which encapsulates a lower level accounts API and provides an observable interface for consumers that wish to be notified of account and profile changes.
1373   * Background-worker friendly.
1374   ```kotlin
1375   // Long-lived instance, pinned on an application.
1376   val accountManager = FxaAccountManager(context, Config.release(CLIENT_ID, REDIRECT_URL), arrayOf("profile"))
1377   launch { accountManager.init() }
1378
1379   // Somewhere in a fragment that cares about account state...
1380   accountManager.register(object : AccountObserver {
1381       override fun onLoggedOut() {
1382         ...
1383       }
1384
1385       override fun onAuthenticated(account: FirefoxAccountShaped) {
1386         ...
1387       }
1388
1389       override fun onProfileUpdated(profile: Profile) {
1390         ...
1391       }
1392
1393       override fun onError(error: FxaException) {
1394         ...
1395       }
1396   }
1397
1398   // Reacting to a "sign-in" user action:
1399   launch {
1400     val authUrl = try {
1401         accountManager.beginAuthentication().await()
1402     } catch (error: FxaException) {
1403         // ... display error ui...
1404         return@launch
1405     }
1406     openWebView(authUrl)
1407   }
1408
1409   ```
1410
1411 * **feature-accounts** 🆕
1412   * Added a new `FirefoxAccountsAuthFeature`, which ties together the **FxaAccountManager** with a session manager via **feature-tabs**.
1413
1414 * **browser-toolbar**
1415   * Fixing bug that allowed text behind the security icon being selectable. [Issue #448](https://github.com/mozilla-mobile/reference-browser/issues/448)
1416
1417 # 0.39.0
1418
1419 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.38.0...v0.39.0)
1420 * [Milestone](https://github.com/mozilla-mobile/android-components/milestone/41?closed=1)
1421 * [API reference](https://mozilla-mobile.github.io/android-components/api/0.39.0/index)
1422 * [Dependencies](https://github.com/mozilla-mobile/android-components/blob/main/buildSrc/src/main/java/Dependencies.kt)
1423 * [Gecko](https://github.com/mozilla-mobile/android-components/blob/main/buildSrc/src/main/java/Gecko.kt)
1424 * [Configuration](https://github.com/mozilla-mobile/android-components/blob/main/buildSrc/src/main/java/Config.kt)
1425
1426 * **feature-awesomebar**
1427   * Added `ClipboardSuggestionProvider` - An `AwesomeBar.SuggestionProvider` implementation that returns a suggestions for an URL in the clipboard (if there's any).
1428
1429 * **feature-prompts**, **browser-engine-gecko**
1430   * Added support for [Window.prompt](https://developer.mozilla.org/en-US/docs/Web/API/Window/prompt).
1431   * Fixing Issue [#1771](https://github.com/mozilla-mobile/android-components/issues/1771). Supporting single choice items with sub-menus group.
1432
1433 * **browser-engine-gecko-nightly**
1434   * The GeckoView Nightly dependency is now updated to the latest version automatically in cases where no code changes are required.
1435
1436 * **browser-menu**
1437   * Added [docs](https://github.com/mozilla-mobile/android-components/blob/main/components/browser/menu/README.md#browsermenu) for customizing `BrowserMenu`.
1438   * Added `BrowserMenuDivider`. [For customization take a look at the docs.](https://github.com/mozilla-mobile/android-components/tree/main/components/browser/menu/README.md#BrowserMenuDivider)
1439   * Added [BrowserMenuImageText](https://github.com/mozilla-mobile/android-components/blob/main/components/browser/menu/README.md#BrowserMenuImageText) for show an icon next to text in menus.
1440   * Added support for showing a menu with DOWN and UP orientation (e.g. for supporting menus in bottom toolbars).
1441
1442 * **concept-engine**, **browser-engine-gecko-***
1443   * Added support for enabling tracking protection for specific session type:
1444   ```kotlin
1445   val engine = GeckoEngine(runtime, DefaultSettings(
1446     trackingProtectionPolicy = TrackingProtectionPolicy.all().forPrivateSessionsOnly())
1447   )
1448   ```
1449
1450 * **browser-toolbar**
1451   * Added `BrowserToolbarBottomBehavior` - a [CoordinatorLayout.Behavior](https://developer.android.com/reference/android/support/design/widget/CoordinatorLayout.Behavior) implementation to be used when placing `BrowserToolbar` at the bottom of the screen. This behavior will:
1452     * Show/Hide the `BrowserToolbar` automatically when scrolling vertically.
1453     * On showing a [Snackbar] position it above the `BrowserToolbar`.
1454     * Snap the `BrowserToolbar` to be hidden or visible when the user stops scrolling.
1455
1456 * **lib-publicsuffixlist**
1457   * 🆕 A new component/library for reading and using the [public suffix list](https://publicsuffix.org/). Details can be found in our [docs](https://github.com/mozilla-mobile/android-components/blob/main/components/lib/publicsuffixlist/README.md).
1458
1459 # 0.38.0
1460
1461 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.37.0...v0.38.0),
1462 [Milestone](https://github.com/mozilla-mobile/android-components/milestone/40?closed=1),
1463 [API reference](https://mozilla-mobile.github.io/android-components/api/0.38.0/index)
1464
1465 * Compiled against:
1466   * Android (SDK: 28, Support Libraries: 28.0.0)
1467   * Kotlin (Stdlib: 1.3.10, Coroutines: 1.0.1)
1468   * GeckoView (Nightly: **66.0.20190111093148** 🔺, Beta: 65.0.20181211223337, Release: 64.0.20181214004633)
1469   * Mozilla App Services (FxA: **0.13.3** 🔺, Sync Logins: **0.13.3** 🔺, Places: **0.13.3** 🔺)
1470     * [0.13.0 release notes](https://github.com/mozilla/application-services/releases/tag/v0.13.0)
1471     * [0.13.1 release notes](https://github.com/mozilla/application-services/releases/tag/v0.13.1)
1472     * [0.13.2 release notes](https://github.com/mozilla/application-services/releases/tag/v0.13.2)
1473     * [0.13.3 release notes](https://github.com/mozilla/application-services/releases/tag/v0.13.3)
1474   * Third Party Libs (Sentry: 1.7.14, Okhttp: 3.12.0)
1475
1476 * **support-utils**
1477   * [Improve URL toolbar autocompletion matching](https://github.com/mozilla-mobile/android-components/commit/ff25ec3e6646736e2b4ba3ee1d9fdd9a8412ce8c).
1478
1479 * **browser-session**
1480   * [Improving tab selection algorithm, when removing the selected tab.](https://github.com/mozilla-mobile/android-components/issues/1518)
1481   * [Saving the state when the app goes to the background no longer blocks the UI thread.](https://github.com/mozilla-mobile/android-components/commit/ea811e089cd40c6d1fc9ec688fa5db3e7b023331)
1482
1483 * **browser-engine-system**
1484   * Added support for JavaScript alerts on SystemEngineView.
1485   * [Improving use of internal Webview](https://github.com/mozilla-mobile/android-components/commit/59240f7a71a9f63fc51c1ff65e604f6735196a0e).
1486
1487 * **feature-customtabs**
1488   * Added a close button to a custom tab with back button handling.
1489
1490 * **feature-prompts**, **browser-engine-gecko**
1491   * Added support for Authentication dialogs.
1492   * Added support for [datetime-local](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/datetime-local) and [time](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/time) pickers.
1493   * Added support for [input type color fields](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/color).
1494
1495 * **browser-menu**
1496   * `BrowserMenuItemToolbar` now allows overriding the `visible` lambda.
1497
1498 * **service-sync-logins**, **service-firefox-accounts**, **concept-storage**
1499   * Updated underlying library from 0.12.1 to 0.13.3, see the [release notes for 0.13.0](https://github.com/mozilla/application-services/blob/master/CHANGELOG.md#0130-2019-01-09) for further details on the most substantial changes. ([#1690](https://github.com/mozilla-mobile/android-components/issues/1690))
1500     * sync-logins: Added a new `wipeLocal` method, for clearing all local data.
1501     * sync-logins: Removed `reset` because it served a nonexistent use case, callers almost certainly want `wipeLocal` or `wipe` instead.
1502     * sync-logins: Added `ensureLocked` and `ensureUnlocked` for cases where checking `isLocked` is inconvenient or requires additional locking.
1503     * sync-logins: Allow storage to be unlocked using a `ByteArray` instead of a `String`.
1504     * firefox-accounts: Network errors will now be reported as instances of FxaException.Network, instead of `FxaException.Unspecified`.
1505     * history (concept-storage): PII is no longer logged during syncing (or any other time).
1506
1507 # 0.37.0
1508
1509 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.36.0...v0.37.0),
1510 [Milestone](https://github.com/mozilla-mobile/android-components/milestone/39?closed=1),
1511 [API reference](https://mozilla-mobile.github.io/android-components/api/0.37.0/index)
1512
1513 * Compiled against:
1514   * Android (SDK: 28, Support Libraries: 28.0.0)
1515   * Kotlin (Stdlib: 1.3.10, Coroutines: 1.0.1)
1516   * GeckoView (Nightly: 66.0.20181217093726, Beta: 65.0.20181211223337, Release: 64.0.20181214004633)
1517   * Mozilla App Services (FxA: 0.12.1, Sync Logins: 0.12.1, Places: 0.12.1)
1518   * Third Party Libs (Sentry: 1.7.14, Okhttp: 3.12.0)
1519
1520 * **feature-customtabs**
1521   * Added a new feature `CustomTabsToolbarFeature` which will handle setting up the `BrowserToolbar` with the configurations available in that session:
1522
1523   ```kotlin
1524   CustomTabsToolbarFeature(
1525     sessionManager,
1526     browserToolbar,
1527     sessionId
1528   ).also { lifecycle.addObserver(it) }
1529   ```
1530   Note: this constructor API is still a work-in-progress and will change as more Custom Tabs support is added to it next release.
1531
1532   * Fixed a bug where a third-party app (like Gmail or Slack) could crash when calling warmup().
1533
1534 * **feature-session-bundling**
1535   * 🆕 New component that saves the state of sessions (`SessionManager.Snapshot`) in grouped bundles (e.g. by time).
1536
1537 * **service-telemetry**
1538   * Added new "pocket event" ping builder ([#1606](https://github.com/mozilla-mobile/android-components/issues/1606))
1539   * Added ability to get ping builder by type from `Telemetry` instance.
1540   * ⚠️ **This is a breaking change!** <br/>
1541   HttpURLConnectionTelemetryClient was removed. *service-telemetry* is now using [*concept-fetch*](https://github.com/mozilla-mobile/android-components/tree/main/components/concept/fetch) which allows consumers to use a unified http client. There are two options available currently: [lib-fetch-httpurlconnection](https://github.com/mozilla-mobile/android-components/tree/main/components/lib/fetch-httpurlconnection) (Based on [HttpURLConnection](https://developer.android.com/reference/java/net/HttpURLConnection)) and [lib-fetch-okhttp](https://github.com/mozilla-mobile/android-components/tree/main/components/lib/fetch-okhttp) (Based on [OkHttp](https://github.com/square/okhttp)).
1542
1543   ```Kotlin
1544   // Using HttpURLConnection:
1545   val client = new TelemetryClient(HttpURLConnectionClient())
1546
1547   // Using OkHttp:
1548   val client = TelemetryClient(OkHttpClient())
1549
1550   val telemetry = Telemetry(configuration, storage, client, scheduler)
1551   ```
1552
1553 * **browser-search**
1554   * Updated search plugins ([#1563](https://github.com/mozilla-mobile/android-components/issues/1563))
1555
1556 * **ui-autocomplete**
1557   * Fixed a bug where pressing backspace could skip a character ([#1489](https://github.com/mozilla-mobile/android-components/issues/1489)).
1558
1559 * **feature-customtabs**
1560   * Fixed a bug where a third-party app (like Gmail or Slack) could crash when calling warmup().
1561
1562 * **browser-session**
1563   * Added ability to notify observers when desktop mode changes (`onDesktopModeChange`)
1564
1565 * **browser-menu**
1566   * Added new `BrowserMenuSwitch` for using switch widgets inside the menu.
1567
1568 * **support-ktx**
1569   * Added extension method `Bitmap.withRoundedCorners(cornerRadiusPx: Float)`
1570
1571 * **support-base**
1572   * Introduced `LifecycleAwareFeature` for writing features that depend on a lifecycle.
1573
1574
1575 # 0.36.1
1576
1577 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.36.0...v0.36.1)
1578
1579 * Compiled against:
1580   * Android (SDK: 28, Support Libraries: 28.0.0)
1581   * Kotlin (Stdlib: 1.3.10, Coroutines: 1.0.1)
1582   * GeckoView (Nightly: 66.0.20181217093726, Beta: 65.0.20181211223337, Release: 64.0.20181214004633)
1583   * Mozilla App Services (FxA: 0.12.1, Sync Logins: 0.12.1, Places: 0.12.1)
1584   * Third Party Libs (Sentry: 1.7.14, Okhttp: 3.12.0)
1585
1586 * **feature-customtabs**
1587   * Fixed a bug where a third-party app (like Gmail or Slack) could crash when calling warmup().
1588
1589 # 0.36.0
1590
1591 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.35.0...v0.36.0),
1592 [Milestone](https://github.com/mozilla-mobile/android-components/milestone/38?closed=1),
1593 [API reference](https://mozilla-mobile.github.io/android-components/api/0.36.0/index)
1594
1595 * Compiled against:
1596   * Android (SDK: 28, Support Libraries: 28.0.0)
1597   * Kotlin (Stdlib: 1.3.10, Coroutines: 1.0.1)
1598   * GeckoView (Nightly: 66.0.20181217093726, Beta: 65.0.20181211223337, Release: 64.0.20181214004633)
1599   * Mozilla App Services (FxA: 0.12.1, Sync Logins: 0.12.1, Places: 0.12.1)
1600   * Third Party Libs (Sentry: 1.7.14, Okhttp: 3.12.0)
1601
1602 * **browser-session**
1603   * Added a use case for exiting fullscreen mode.
1604
1605   ```kotlin
1606   val sessionUseCases = SessionUseCases(sessionManager)
1607   if (isFullScreenMode) {
1608     sessionUseCases.exitFullscreen.invoke()
1609   }
1610   ```
1611
1612   * We also added a `FullScreenFeature` that manages fullscreen support.
1613
1614   ```kotlin
1615   val fullScreenFeature = FullScreenFeature(sessionManaager, sessionUseCases) { enabled ->
1616     if (enabled) {
1617       // Make custom views hide.
1618     } else {
1619       // Make custom views unhide.
1620     }
1621   }
1622
1623   override fun onBackPressed() : Boolean {
1624     // Handling back presses when in fullscreen mode
1625     return fullScreenFeature.onBackPressed()
1626   }
1627   ```
1628 * **feature-customtabs**
1629   * Added support for opening speculative connections for a likely future navigation to a URL (`mayLaunchUrl`)
1630
1631 * **feature-prompts**, **engine-gecko-***, **engine-system**
1632   * Added support for file picker requests.
1633
1634     There some requests that are not handled with dialogs, instead they are delegated to other apps
1635     to perform the request, an example is a file picker request. As a result, now you have to override
1636     `onActivityResult` on your `Activity` or `Fragment` and forward its calls to `promptFeature.onActivityResult`.
1637
1638     Additionally, there are requests that need some permission to be granted before they can be performed, like
1639     file pickers that need access to read the selected files. Like `onActivityResult` you need to override
1640     `onRequestPermissionsResult` and forward its calls to `promptFeature.onRequestPermissionsResult`.
1641
1642 * **browser-toolbar**
1643   * The "urlBoxView" is now drawn behind the site security icon (in addition to the URL and the page actions)
1644
1645 # 0.35.1
1646
1647 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.35.0...v0.35.1)
1648
1649 * Compiled against:
1650   * Android (SDK: 28, Support Libraries: 28.0.0)
1651   * Kotlin (Stdlib: 1.3.10, Coroutines: 1.0.1)
1652   * GeckoView (Nightly: 66.0.20181217093726, Beta: 65.0.20181211223337, Release: 64.0.20181214004633)
1653   * Mozilla App Services (FxA: **0.12.1** 🔺, Sync Logins: **0.12.1** 🔺, Places: **0.12.1** 🔺)
1654   * Third Party Libs (Sentry: 1.7.14, Okhttp: 3.12.0)
1655
1656 * Re-release of 0.34.1 with updated App Services dependencies (0.12.1).
1657
1658 # 0.35.0
1659
1660 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.34.0...v0.35.0),
1661 [Milestone](https://github.com/mozilla-mobile/android-components/milestone/37?closed=1),
1662 [API reference](https://mozilla-mobile.github.io/android-components/api/0.35.0/index)
1663
1664 * Compiled against:
1665   * Android (SDK: 28, Support Libraries: 28.0.0)
1666   * Kotlin (Stdlib: 1.3.10, Coroutines: 1.0.1)
1667   * GeckoView (Nightly: **66.0.20181217093726** 🔺, Beta: **65.0.20181211223337** 🔺, Release: **64.0.20181214004633** 🔺)
1668   * Mozilla App Services (FxA: 0.11.5, Sync Logins: 0.11.5, Places: 0.11.5)
1669   * Third Party Libs (Sentry: 1.7.14, Okhttp: 3.12.0)
1670
1671 * **browser-errorpages**
1672   * Localized strings for de, es, fr, it, ja, ko, zh-rCN, zh-rTW.
1673
1674 * **feature-customtabs**
1675   * Added support for warming up the browser process asynchronously.
1676   * ⚠️ **This is a breaking change**
1677   * `CustomTabsService` has been renamed to `AbstractCustomTabsService` and is now an abstract class in order to allow apps to inject the `Engine` they are using. An app that wants to support custom tabs will need to create its own class and reference it in the manifest:
1678
1679   ```kotlin
1680   class CustomTabsService : AbstractCustomTabsService() {
1681     override val engine: Engine by lazy { components.engine }
1682   }
1683   ```
1684 * **feature-prompts**
1685   * Added support for alerts dialogs.
1686   * Added support for date picker dialogs.
1687
1688 * **feature-tabs**
1689   * Added support to remove all or specific types of tabs to the `TabsUseCases`.
1690
1691   ```kotlin
1692   // Remove all tabs
1693   tabsUseCases.removeAllTabs.invoke()
1694   // Remove all regular tabs
1695   tabsUseCases.removeAllTabsOfType.invoke(private = false)
1696   // Remove all private tabs
1697   tabsUseCases.removeAllTabsOfType.invoke(private = true)
1698   ```
1699
1700 * **support-ktx**
1701   New extension function `toDate` that converts a string to a Date object from a formatter input.
1702   ```kotlin
1703        val date = "2019-11-28".toDate("yyyy-MM-dd")
1704   ```
1705
1706 * **concept-engine**, **engine-gecko-beta**, **engine-gecko-nightly**:
1707   * Add setting to enable testing mode which is used in engine-gecko to set `FULL_ACCESSIBILITY_TREE` to `true`. This allows access to the full DOM tree for testing purposes.
1708
1709   ```kotlin
1710   // Turn testing mode on by default when the engine is created
1711   val engine = GeckoEngine(runtime, DefaultSettings(testingModeEnabled=true))
1712
1713   // Or turn testing mode on at a later point
1714   engine.settings.testingModeEnabled = true
1715   ```
1716
1717   * The existing `userAgentString` setting is now supported by `engine-gecko-beta` and `engine-gecko-nightly`.
1718
1719 * **feature-session**
1720   * Added a `HistoryTrackingDelegate` implementation, which previously lived in **feature-storage**.
1721
1722 * **feature-storage**
1723   * Removed! See **feature-session** instead.
1724
1725 * **sample-browser**
1726   * Added in-memory browsing history as one of the AwesomeBar data providers.
1727
1728 * **feature-sync**
1729   * Simplified error handling. Errors are wrapped in a SyncResult, exceptions are no longer thrown.
1730   * `FirefoxSyncFeature`'s constructor now takes a map of `Syncable` instances. That is, the internal list of `Syncables` is no longer mutable.
1731   * `sync` is now a `suspend` function. Callers are expected to manage scoping themselves.
1732   * Ability to observe "sync is running" and "sync is idle" events vs `SyncStatusObserver` interface.
1733   * Ability to query for current sync state (running or idle).
1734   * See included `sample-sync-history` application for example usage of these observers.
1735
1736 # 0.34.2
1737
1738 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.34.1...v0.34.2)
1739
1740 * Compiled against:
1741   * Android (SDK: 28, Support Libraries: 28.0.0)
1742   * Kotlin (Stdlib: 1.3.10, Coroutines: 1.0.1)
1743   * GeckoView (Nightly: 65.0.20181129095546, Beta: 64.0.20181022150107, Release: 63.0.20181018182531)
1744   * Mozilla App Services (FxA: **0.11.5** 🔺, Sync Logins: **0.11.5** 🔺, Places: **0.11.5** 🔺)
1745   * Third Party Libs (Sentry: 1.7.14, Okhttp: 3.12.0)
1746
1747 * Re-release of 0.34.1 with updated App Services dependencies (0.11.5).
1748
1749 # 0.34.1
1750
1751 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.34.0...v0.34.1)
1752
1753 * Compiled against:
1754   * Android (SDK: 28, Support Libraries: 28.0.0)
1755   * Kotlin (Stdlib: 1.3.10, Coroutines: 1.0.1)
1756   * GeckoView (Nightly: **65.0.20181129095546** 🔺, Beta: 64.0.20181022150107, Release: 63.0.20181018182531)
1757   * Mozilla App Services (FxA: 0.11.2, Sync Logins: 0.11.2, Places: 0.11.2)
1758   * Third Party Libs (Sentry: 1.7.14, Okhttp: 3.12.0)
1759
1760 * **browser-engine-gecko-nightly**
1761   * Updated GeckoView dependency.
1762
1763 # 0.34.0
1764
1765 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.33.0...v0.34.0),
1766 [Milestone](https://github.com/mozilla-mobile/android-components/milestone/36?closed=1),
1767 [API reference](https://mozilla-mobile.github.io/android-components/api/0.34.0/index)
1768
1769 * Compiled against:
1770   * Android (SDK: 28, Support Libraries: 28.0.0)
1771   * Kotlin (Stdlib: 1.3.10, Coroutines: 1.0.1)
1772   * GeckoView (Nightly: 65.0.20181123100059, Beta: 64.0.20181022150107, Release: 63.0.20181018182531)
1773   * Mozilla App Services (FxA: **0.11.2** 🔺, Sync Logins: **0.11.2** 🔺, Places: **0.11.2** 🔺)
1774   * Third Party Libs (Sentry: 1.7.14, Okhttp: 3.12.0)
1775
1776 * **browser-engine-gecko-nightly**
1777   * Added support for observing history events and providing visited URLs (`HistoryTrackingDelegate`).
1778
1779 * **browser-engine-system**
1780   * Fixed a crash when calling `SystemEngineSession.saveState()` from a non-UI thread.
1781
1782 * **browser-awesomebar**
1783   * Added ability for search suggestions to span multiple rows.
1784
1785 * **browser-toolbar**
1786   * Fixed rendering issue when displaying site security icons.
1787
1788 * **feature-prompts**
1789   * 🆕 New component: A component that will subscribe to the selected session and will handle all the common prompt dialogs from web content.
1790
1791   ```kotlin
1792   val promptFeature = PromptFeature(sessionManager,fragmentManager)
1793
1794   //It will start listing for new prompt requests for web content.
1795   promptFeature.start()
1796
1797   //It will stop listing for future prompt requests for web content.
1798   promptFeature.stop()
1799   ```
1800
1801 * **feature-session**, **browser-session**, **concept-engine**, **browser-engine-system**:
1802   * Added functionality to observe window requests from the browser engine. These requests can be observed on the session directly using `onOpenWindowRequest` and `onCloseWindowRequest`, but we also provide a feature class, which will automatically open and close the corresponding window:
1803
1804   ```Kotlin
1805   windowFeature = WindowFeature(engine, sessionManager)
1806
1807   override fun onStart() {
1808     windowFeature.start()
1809   }
1810
1811   override fun onStop() {
1812     windowFeature.stop()
1813   }
1814
1815   ```
1816
1817   In addition, to observe window requests the new engine setting `supportMultipleWindows` has to be set to true:
1818
1819   ```Kotlin
1820   val engine = SystemEngine(context,
1821     DefaultSettings(
1822       supportMultipleWindows = true
1823     )
1824   )
1825   ```
1826
1827 * **concept-storage**, **browser-storage-sync**, **services-logins-sync**:
1828   * Added a new interface, `SyncableStore<AuthType>`, which allows a storage layer to be used with `feature-sync`.
1829   * Added a `SyncableStore<SyncAuthInfo>` implementation for `browser-storage-sync`
1830   * Added a `SyncableStore<SyncUnlockInfo>` implementation for `services-logins-sync`.
1831
1832 * **feature-sync**:
1833   * 🆕 New component: A component which orchestrates synchronization of groups of similar `SyncableStore` objects using a `FirefoxAccount`.
1834   * Here is an example of configuring and synchronizing a places-backed `HistoryStorage` (provided by `browser-storage-sync` component):
1835
1836   ```Kotlin
1837   val historyStorage = PlacesHistoryStorage(context)
1838   val featureSync = FirefoxSyncFeature(Dispatchers.IO + job) { authInfo ->
1839       SyncAuthInfo(
1840           fxaAccessToken = authInfo.fxaAccessToken,
1841           kid = authInfo.kid,
1842           syncKey = authInfo.syncKey,
1843           tokenserverURL = authInfo.tokenServerUrl
1844       )
1845   }.also {
1846       it.addSyncable("placesHistory", historyStorage)
1847   }
1848   val syncResult = featureSync.sync().await()
1849   assert(syncResults["placesHistory"]!!.status is SyncOk)
1850   ```
1851
1852 * **service-firefox-accounts**:
1853   * ⚠️ **This is a breaking change**
1854   * We've simplified the API to provide the FxA configuration:
1855
1856   ```Kotlin
1857   // Before
1858   Config.custom(CONFIG_URL).await().use {
1859     config -> FirefoxAccount(config, CLIENT_ID, REDIRECT_URL)
1860   }
1861
1862   // Now
1863   val config = Config(CONFIG_URL, CLIENT_ID, REDIRECT_URL)
1864   FirefoxAccount(config)
1865   ```
1866
1867   A full working example can be found [here](https://github.com/mozilla-mobile/android-components/blob/main/samples/firefox-accounts/src/main/java/org/mozilla/samples/fxa/MainActivity.kt).
1868
1869 # 0.33.0
1870
1871 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.32.0...v0.33.0),
1872 [Milestone](https://github.com/mozilla-mobile/android-components/milestone/35?closed=1),
1873 [API reference](https://mozilla-mobile.github.io/android-components/api/0.33.0/index)
1874
1875 * Compiled against:
1876   * Android (SDK: 28, Support Libraries: 28.0.0)
1877   * Kotlin (Stdlib: **1.3.10** 🔺, Coroutines: 1.0.1)
1878   * GeckoView (Nightly: **65.0.20181123100059** 🔺, Beta: 64.0.20181022150107, Release: 63.0.20181018182531)
1879   * Mozilla App Services (FxA: 0.10.0, Sync Logins: 0.10.0, Places: 0.10.0)
1880   * Third Party Libs (Sentry: 1.7.14, Okhttp: 3.12.0)
1881
1882 * **feature-contextmenu**
1883   * 🆕 New component: A component for displaying context menus when *long-pressing* web content.
1884
1885 * **concept-toolbar**: 🆕 Added autocomplete support
1886   * Toolbar concept got a new `setAutocompleteListener` method.
1887   * Added `AutocompleteDelegate` concept which allows tying together autocomplete results with a UI presenter.
1888
1889 * **concept-storage** and all of its implementations
1890   * ⚠️ **This is a breaking change**
1891   * Renamed `getDomainSuggestion` to `getAutocompleteSuggestion`, which now returns a `HistoryAutocompleteResult`.
1892
1893 * **feature-toolbar**
1894   * 🆕 Added new `ToolbarAutocompleteFeature`:
1895
1896   ```Kotlin
1897   toolbarAutocompleteFeature = ToolbarAutocompleteFeature(toolbar).apply {
1898     this.addHistoryStorageProvider(components.historyStorage)
1899     this.addDomainProvider(components.shippedDomainsProvider)
1900   }
1901   ```
1902
1903 * **samples-browser**, **samples-toolbar**
1904   * Converted these samples to use the new `ToolbarAutocompleteFeature`.
1905
1906 * **feature-session**
1907   * Introducing `CoordinateScrollingFeature` a new feature to coordinate scrolling behavior between an `EngineView` and the view that you specify. For a full example take a look at its usages in [Sample Browser](https://github.com/mozilla-mobile/android-components/tree/main/samples/browser).
1908
1909 * **feature-tabs**
1910   * Added a filter to `TabsFeature` to allow you to choose which sessions to show in the TabsTray. This is particularly useful if you want to filter out private tabs based on some UI interaction:
1911
1912   ```kotlin
1913   val tabsFeature = TabsFeature(
1914     tabsTray,
1915     sessionManager,
1916     closeTabsTray = closeTabs()
1917   )
1918   tabsFeature.filterTabs {
1919     it.private
1920   }
1921   ```
1922
1923 * **engine-gecko,engine-gecko-beta and engine-gecko-nightly**
1924   * Fixing bug [#1333](https://github.com/mozilla-mobile/android-components/issues/1333). This issue didn't allow to use a `GeckoEngineSession` after sending a crash report.
1925
1926 # 0.32.2
1927
1928 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.32.1...v0.32.2),
1929 [API reference](https://mozilla-mobile.github.io/android-components/api/0.32.0/index)
1930
1931 * Compiled against:
1932   * Android (SDK: **28** 🔺, Support Libraries: **28.0.0** 🔺)
1933   * Kotlin (Stdlib: 1.3.0, Coroutines: 1.0.1)
1934   * GeckoView (Nightly: **65.0.20181116100120** 🔺, Beta: 64.0.20181022150107, Release: 63.0.20181018182531)
1935   * Mozilla App Services (FxA: **0.10.0** 🔺, Sync Logins: **0.10.0** 🔺, Places: **0.10.0** 🔺)
1936
1937 * **ui-autocomplete**
1938   * Fixed problem handling backspaces as described in [Issue 1489](https://github.com/mozilla-mobile/android-components/issues/1489)
1939
1940 * **browser-search**
1941   * Updated search codes (see [Issue 1563](https://github.com/mozilla-mobile/android-components/issues/1563) for details)
1942
1943 # 0.32.1
1944
1945 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.32.0...v0.32.1),
1946 [API reference](https://mozilla-mobile.github.io/android-components/api/0.32.0/index)
1947
1948 * Compiled against:
1949   * Android (SDK: **28** 🔺, Support Libraries: **28.0.0** 🔺)
1950   * Kotlin (Stdlib: 1.3.0, Coroutines: 1.0.1)
1951   * GeckoView (Nightly: **65.0.20181116100120** 🔺, Beta: 64.0.20181022150107, Release: 63.0.20181018182531)
1952   * Mozilla App Services (FxA: **0.10.0** 🔺, Sync Logins: **0.10.0** 🔺, Places: **0.10.0** 🔺)
1953
1954 * **browser-session**
1955   * Fixed concurrency problem and related crash described in [Issue 1624](https://github.com/mozilla-mobile/android-components/issues/1624)
1956
1957 # 0.32.0
1958
1959 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.31.0...v0.32.0),
1960 [Milestone](https://github.com/mozilla-mobile/android-components/milestone/34?closed=1),
1961 [API reference](https://mozilla-mobile.github.io/android-components/api/0.32.0/index)
1962
1963 * Compiled against:
1964   * Android (SDK: **28** 🔺, Support Libraries: **28.0.0** 🔺)
1965   * Kotlin (Stdlib: 1.3.0, Coroutines: 1.0.1)
1966   * GeckoView (Nightly: **65.0.20181116100120** 🔺, Beta: 64.0.20181022150107, Release: 63.0.20181018182531)
1967   * Mozilla App Services (FxA: **0.10.0** 🔺, Sync Logins: **0.10.0** 🔺, Places: **0.10.0** 🔺)
1968
1969 * ⚠️ **This is the first release compiled against Android SDK 28.**
1970
1971 * **browser-domains**
1972   * Deprecated `DomainAutoCompleteProvider` in favour of `CustomDomainsProvider` and `ShippedDomainsProvider`.
1973
1974 * **lib-crash**
1975   * The state of the "Send crash report" checkbox is now getting saved and restored once the dialog is shown again.
1976   * The crash reporter can now sends reports if the prompt is closed by pressing the back button.
1977
1978 * **lib-fetch-httpurlconnection**
1979   * 🆕 New component: `concept-fetch` implementation using [HttpURLConnection](https://developer.android.com/reference/java/net/HttpURLConnection.html).
1980
1981 * **lib-fetch-okhttp**
1982   * 🆕 New component: `concept-fetch` implementation using [OkHttp](https://github.com/square/okhttp).
1983
1984 * **browser-session**:
1985   * Replace `DefaultSessionStorage` with a new configurable implementation called `SessionStorage`:
1986
1987   ```kotlin
1988   SessionStorage().autoSave(sessionManager)
1989     .periodicallyInForeground(interval = 30, unit = TimeUnit.SECONDS)
1990     .whenGoingToBackground()
1991     .whenSessionsChange()
1992   ```
1993
1994 # 0.31.0
1995
1996 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.30.0...v0.31.0),
1997 [Milestone](https://github.com/mozilla-mobile/android-components/milestone/33?closed=1),
1998 [API reference](https://mozilla-mobile.github.io/android-components/api/0.31.0/index)
1999
2000 * Compiled against:
2001   * Android (SDK: 27, Support Libraries: 27.1.1)
2002   * Kotlin (Stdlib: **1.3.0** 🔺, Coroutines: **1.0.1** 🔺)
2003   * GeckoView (Nightly: **65.0.20181107100135** 🔺, Beta: 64.0.20181022150107, Release: 63.0.20181018182531)
2004
2005 * **concept-storage**, **browser-storage-memory**, **browser-storage-sync**
2006   * Added a `getDomainSuggestion` method to `HistoryStorage` which is intended to power awesomebar-like functionality.
2007   * Added basic implementations of `getDomainSuggestion` to existing storage components.
2008
2009 * **browser-session**, **concept-engine**, **browser-engine-system**, **browser-engine-gecko(-beta/nightly)**:
2010   * ⚠️ **This is a breaking change**
2011   * Added functionality to observe permission requests from the browser engine. We have now removed the workaround that automatically granted permission to play protected (DRM) media. Permission requests can be observed via the browser session:
2012
2013   ```Kotlin
2014   // Grant permission to all DRM content
2015   permissionObserver = object : SelectionAwareSessionObserver(sessionManager) {
2016       override fun onContentPermissionRequested(session: Session, permissionRequest: PermissionRequest): Boolean =
2017           permissionRequest.grantIf { it is Permission.ContentProtectedMediaId }
2018   }
2019
2020   override fun onStart() {
2021     // Observe permission requests on selected sessions
2022     permissionObserver.observeSelected()
2023   }
2024
2025   override fun onStop() {
2026     permissionObserver.stop()
2027   }
2028
2029   ```
2030
2031 * **concept-engine**, **engine-system**:
2032   * ⚠️ **This is a breaking change**
2033   * Web font blocking is now controlled by an engine setting only. `TrackingProtectionPolicy.WEBFONTS` was removed:
2034
2035   ```Kotlin
2036   // Disable web fonts by default
2037   SystemEngine(runtime, DefaultSettings(webFontsEnabled = false))
2038   ```
2039
2040 * **feature-customtabs**
2041   * 🆕 New component for providing custom tabs functionality. `CustomTabsService` was moved from `browser-session` to this new component.
2042
2043 * **browser-awesomebar**
2044   * Various colors of the Awesome Bar can now be styled:
2045
2046   ```XML
2047     <mozilla.components.browser.awesomebar.BrowserAwesomeBar
2048       ..
2049       mozac:awesomeBarTitleTextColor="#ffffff"
2050       mozac:awesomeBarDescriptionTextColor="#dddddd"
2051       mozac:awesomeBarChipTextColor="#ffffff"
2052       mozac:awesomeBarChipBackgroundColor="#444444" />
2053   ```
2054
2055 * **browser-toolbar**, **feature-toolbar**
2056   * Added support for displaying the site security indicator (lock/globe icon).
2057
2058 * **concept-fetch**
2059   * 🆕 New component defining an abstract definition of an HTTP client for fetching resources. Later releases will come with components implementing this concept using HttpURLConnection, OkHttp and Necko/GeckoView. Eventually all HTTP client code in the components will be replaced with `concept-fetch` and consumers can decide what HTTP client implementation components should use.
2060
2061 * [**Reference Browser**](https://github.com/mozilla-mobile/reference-browser)
2062   * Integrated crash reporting with [`lib-crash`](https://github.com/mozilla-mobile/android-components/tree/main/components/lib/crash).
2063   * Added awesome bar with [`browser-awesomebar`](https://github.com/mozilla-mobile/android-components/tree/main/components/browser/awesomebar).
2064   * Toolbar is hiding automatically now when scrolling web content.
2065   * Added "Sync Now" button to preferences (without functionality in this release)
2066   * Updated theme colors.
2067
2068 # 0.30.0
2069
2070 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.29.0...v0.30.0),
2071 [Milestone](https://github.com/mozilla-mobile/android-components/milestone/32?closed=1),
2072 [API reference](https://mozilla-mobile.github.io/android-components/api/0.30.0/index)
2073
2074 * Compiled against:
2075   * Android (SDK: 27, Support Libraries: 27.1.1)
2076   * Kotlin (Stdlib: 1.2.71, Coroutines: 0.30.2)
2077   * GeckoView (Nightly: 65.0.20181023100123, Beta: 64.0.20181022150107, Release: 63.0.20181018182531)
2078 * **concept-storage**
2079   * ⚠️ **These are a breaking API changes**
2080   * Added a `getSuggestions` method to `HistoryStorage`, which is intended to power search, autocompletion, etc.
2081   * Added a `cleanup` method to `HistoryStorage`, which is intended to allow signaling to implementations to cleanup any allocated resources.
2082   * `HistoryStorage` methods `recordVisit` and `recordObservation` are now `suspend`.
2083   * `HistoryStorage` methods `getVisited()` and `getVisited(uris)` now return `Deferred`.
2084 * 🆕 Added **browser-storage-memory** ✨
2085   * Added an in-memory implementation of `concept-storage`.
2086 * 🆕 Added **browser-storage-sync** ✨
2087   * Added an implementation of `concept-storage` which is backed by the Rust Places library provided by [application-services](https://github.com/mozilla/application-services).
2088 * **service-firefox-accounts**:
2089   * ⚠️ **This is a breaking API change**
2090   * The `FxaResult` type served as a custom promise-like type to support older versions of Java. We have now removed this type and switched to Kotlin's `Deferred` instead. We've also made sure all required types are `Closeable`:
2091
2092   ```kotlin
2093   // Before
2094   Config.custom(CONFIG_URL).then { config: Config ->
2095     account = FirefoxAccount(config, CLIENT_ID, REDIRECT_URL)
2096   }
2097
2098   // Now
2099   val account = async {
2100     Config.custom(CONFIG_URL).await().use { config ->
2101       FirefoxAccount(config, CLIENT_ID, REDIRECT_URL)
2102     }
2103   }
2104   ```
2105   In case error handling is needed, the new API will also become easier to work with:
2106   ```kotlin
2107   // Before
2108   account.beginOAuthFlow(scopes, wantsKeys).then({ url ->
2109     showLoginScreen(url)
2110   }, { exception ->
2111     handleException(exception)
2112   })
2113
2114   // Now
2115   async {
2116       try {
2117         account.beginOAuthFlow(scopes, wantsKeys).await()
2118       } catch (e: FxaException) {
2119         handleException(e)
2120       }
2121   }
2122
2123   ```
2124 * **browser-engine-system, browser-engine-gecko, browser-engine-gecko-beta and browser-engine-gecko-nightly**:
2125   Adding support for using `SystemEngineView` and `GeckoEngineView` in a `CoordinatorLayout`.
2126   This allows to create nice transitions like hiding the toolbar when scrolls.
2127 * **browser-session**
2128   * Fixed an issue where a custom tab `Session?` could get selected after removing the currently selected `Session`.
2129 * **browser-toolbar**:
2130   * Added TwoStateButton that will change drawables based on the `isEnabled` listener. This is particularly useful for
2131   having a reload/cancel button.
2132
2133   ```kotlin
2134   var isLoading: Boolean // updated by some state change.
2135   BrowserToolbar.TwoStateButton(
2136       reloadDrawable,
2137       "reload button",
2138       cancelDrawable,
2139       "cancel button",
2140       { isLoading }
2141   ) { /* On-click listener */ }
2142   ```
2143   * ⚠️ **These are a breaking API changes:** BrowserToolbar APIs for Button and ToggleButton have also been updated to accept `Drawable` instead of resource IDs.
2144
2145   ```kotlin
2146   // Before
2147   BrowserToolbar.Button(R.drawable.image, "image description") {
2148     // perform an action on click.
2149   }
2150
2151   // Now
2152   val imageDrawable: Drawable = Drawable()
2153   BrowserToolbar.Button(imageDrawable, "image description") {
2154     // perform an action on click.
2155   }
2156
2157   // Before
2158   BrowserToolbar.ToggleButton(
2159     R.drawable.image,
2160     R.drawable.image_selected,
2161     "image description",
2162     "image selected description") {
2163     // perform an action on click.
2164   }
2165
2166   // Now
2167   val imageDrawable: Drawable = Drawable()
2168   val imageSelectedDrawable: Drawable = Drawable()
2169   BrowserToolbar.ToggleButton(
2170     imageDrawable,
2171     imageSelectedDrawable,
2172     "image description",
2173     "image selected description") {
2174     // perform an action on click.
2175   }
2176   ```
2177 * **concept-awesomebar**
2178   * 🆕 New component: An abstract definition of an awesome bar component.
2179 * **browser-awesomebar**
2180   * 🆕 New component: A customizable [Awesome Bar](https://support.mozilla.org/en-US/kb/awesome-bar-search-firefox-bookmarks-history-tabs) implementation for browsers.A
2181 * **feature-awesomebar**
2182   * 🆕 New component: A component that connects a [concept-awesomebar](https://github.com/mozilla-mobile/android-components/components/concept/awesomebar/README.md) implementation to a [concept-toolbar](https://github.com/mozilla-mobile/android-components/components/concept/toolbar/README.md) implementation and provides implementations of various suggestion providers.
2183
2184 # 0.29.0
2185
2186 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.28.0...v0.29.0),
2187 [Milestone](https://github.com/mozilla-mobile/android-components/milestone/31?closed=1),
2188 [API reference](https://mozilla-mobile.github.io/android-components/api/0.29.0/index)
2189
2190 * Compiled against:
2191   * Android (SDK: 27, Support Libraries: 27.1.1)
2192   * Kotlin (Stdlib: **1.2.71** 🔺, Coroutines: **0.30.2** 🔺)
2193   * GeckoView (Nightly: **65.0.20181023100123** 🔺, Beta: **64.0.20181022150107** 🔺, Release: **63.0.20181018182531** 🔺)
2194 * **browser-toolbar**:
2195   * Added new listener to get notified when the user is editing the URL:
2196   ```kotlin
2197   toolbar.setOnEditListener(object : Toolbar.OnEditListener {
2198       override fun onTextChanged(text: String) {
2199           // Fired whenever the user changes the text in the address bar.
2200       }
2201
2202       override fun onStartEditing() {
2203           // Fired when the toolbar switches to edit mode.
2204       }
2205
2206       override fun onStopEditing() {
2207           // Fired when the toolbar switches back to display mode.
2208       }
2209   })
2210   ```
2211   * Added new toolbar APIs:
2212   ```kotlin
2213   val toolbar = BrowserToolbar(context)
2214   toolbar.textColor: Int = getColor(R.color.photonRed50)
2215   toolbar.hintColor: Int = getColor(R.color.photonGreen50)
2216   toolbar.textSize: Float = 12f
2217   toolbar.typeface: Typeface = Typeface.createFromFile("fonts/foo.tff")
2218   ```
2219   These attributes are also available in XML (except for typeface):
2220
2221     ```xml
2222     <mozilla.components.browser.toolbar.BrowserToolbar
2223       android:id="@+id/toolbar"
2224       app:browserToolbarTextColor="#ff0000"
2225       app:browserToolbarHintColor="#00ff00"
2226       app:browserToolbarTextSize="12sp"
2227       android:layout_width="match_parent"
2228       android:layout_height="wrap_content"/>
2229     ```
2230
2231   * [API improvement](https://github.com/mozilla-mobile/android-components/issues/772) for more flexibility to create a `BrowserToolbar.Button`,
2232   and `BrowserToolbar.ToggleButton`, now you can provide a custom padding:
2233   ```kotlin
2234   val padding = Padding(start = 16, top = 16, end = 16, bottom = 16)
2235   val button = BrowserToolbar.Button(mozac_ic_back, "Forward", padding = padding) {}
2236   var toggle = BrowserToolbar.ToggleButton(mozac_ic_pin, mozac_ic_pin_filled, "Pin", "Unpin", padding = padding) {}
2237   ```
2238 * **concept-toolbar**:
2239   * [API improvement](https://github.com/mozilla-mobile/android-components/issues/772) for more flexibility to create a `Toolbar.ActionToggleButton`,
2240   `Toolbar.ActionButton`, `Toolbar.ActionSpace` and `Toolbar.ActionImage`, now you can provide a custom padding:
2241   ```kotlin
2242   val padding = Padding(start = 16, top = 16, end = 16, bottom = 16)
2243   var toggle = Toolbar.ActionToggleButton(0, mozac_ic_pin_filled, "Pin", "Unpin", padding = padding) {}
2244   val button = Toolbar.ActionButton(mozac_ic_back, "Forward", padding = padding) {}
2245   val space = Toolbar.ActionSpace(pxToDp(128), padding = padding)
2246   val image = Toolbar.ActionImage(brand, padding = padding)
2247   ```
2248 * **support-base**:
2249   * A new class add for representing an Android Padding.
2250     ```kotlin
2251     val padding = Padding(16, 24, 32, 40)
2252     val (start, top, end, bottom) = padding
2253     ```
2254 * **support-ktx**:
2255   * A new extension function that allows you to set `Padding` object to a `View`.
2256     ```kotlin
2257     val padding = Padding(16, 24, 32, 40)
2258     val view = View(context)
2259     view.setPadding(padding)
2260     ```
2261 * **concept-engine**, **browser-engine-system**, **browser-engine-gecko(-beta/nightly)**
2262   * `RequestInterceptor` was enhanced to support loading an alternative URL.
2263   :warning: **This is a breaking change for the `RequestInterceptor` method signature!**
2264   ```kotlin
2265   // To provide alternative content the new InterceptionResponse.Content type needs to be used
2266   requestInterceptor = object : RequestInterceptor {
2267       override fun onLoadRequest(session: EngineSession, uri: String): InterceptionResponse? {
2268           return when (uri) {
2269               "sample:about" -> InterceptionResponse.Content("<h1>I am the sample browser</h1>")
2270               else -> null
2271           }
2272       }
2273   }
2274   // To provide an alternative URL the new InterceptionResponse.Url type needs to be used
2275   requestInterceptor = object : RequestInterceptor {
2276       override fun onLoadRequest(session: EngineSession, uri: String): InterceptionResponse? {
2277           return when (uri) {
2278               "sample:about" -> InterceptionResponse.Url("sample:aboutNew")
2279               else -> null
2280           }
2281       }
2282   }
2283   ```
2284 * **concept-storage**:
2285   * Added a new concept for describing an interface for storing browser data. First iteration includes a description of `HistoryStorage`.
2286 * **feature-storage**:
2287   * Added a first iteration of `feature-storage`, which includes `HistoryTrackingFeature` that ties together `concept-storage` and `concept-engine` and allows engines to track history visits and page meta information. It does so by implementing `HistoryTrackingDelegate` defined by `concept-engine`.
2288   Before adding a first session to the engine, initialize the history tracking feature:
2289   ```kotlin
2290   val historyTrackingFeature = HistoryTrackingFeature(
2291       components.engine,
2292       components.historyStorage
2293   )
2294   ```
2295   Once the feature has been initialized, history will be tracked for all subsequently added sessions.
2296 * **sample-browser**:
2297   * Updated the sample browser to track browsing history using an in-memory history storage implementation (how much is actually tracked in practice depends on which engine is being used. As of this release, only `SystemEngine` provides a full set of necessary APIs).
2298 * **lib-crash**
2299   * Added option to display additional message in prompt and define the theme to be used:
2300   ```kotlin
2301   CrashReporter(
2302       promptConfiguration = CrashReporter.PromptConfiguration(
2303         // ..
2304
2305         // An additional message that will be shown in the prompt
2306         message = "We are very sorry!"
2307
2308         // Use a custom theme for the prompt (Extend Theme.Mozac.CrashReporter)
2309         theme = android.R.style.Theme_Holo_Dialog
2310       )
2311       // ..
2312   ).install(applicationContext)
2313   ```
2314   * Showing the crash prompt won't play the default activity animation anymore.
2315   * Added a new sample app `samples-crash` to show and test crash reporter integration.
2316 * **feature-tabs**:
2317   * `TabsToolbarFeature` is now adding a `TabCounter` from the `ui-tabcounter` component to the toolbar.
2318 * **lib-jexl**
2319   * New component for evaluating Javascript Expression Language (JEXL) expressions. This implementation is based on [Mozjexl](https://github.com/mozilla/mozjexl) used at Mozilla, specifically as a part of SHIELD and Normandy. In a future version of Fretboard JEXL will allow more complex rules for experiments. For more see [documentation](https://github.com/mozilla-mobile/android-components/blob/main/components/lib/jexl/README.md).
2320 * **service-telemetry**
2321   * Added option to send list of experiments in event pings: `Telemetry.recordExperiments(Map<String, Boolean> experiments)`
2322   * Fixed an issue where `DebugLogClient` didn't use the provided log tag.
2323 * **service-fretboard**
2324   * Fixed an issue where for some locales a `MissingResourceException` would occur.
2325 * **browser-engine-system**
2326   * Playback of protected media (DRM) is now granted automatically.
2327 * **browser-engine-gecko**
2328   * Updated components to follow merge day: (Nightly: 65.0, Beta: 64.0, Release: 63.0)
2329
2330 # 0.28.0
2331
2332 Release date: 2018-10-23
2333
2334 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.27.0...v0.28.0),
2335 [Milestone](https://github.com/mozilla-mobile/android-components/milestone/30?closed=1),
2336 [API reference](https://mozilla-mobile.github.io/android-components/api/0.28.0/index)
2337
2338 ⚠️ **Note**: This and upcoming releases are **only** available from *maven.mozilla.org*.
2339
2340 * Compiled against:
2341   * Android (SDK: 27, Support Libraries: 27.1.1)
2342   * Kotlin (Stdlib: 1.2.61, Coroutines: 0.23.4)
2343   * GeckoView
2344     * Nightly: 64.0.20181004100221
2345     * Beta: 63.0b3 (0269319281578bff4e01d77a21350bf91ba08620)
2346     * Release: 62.0 (9cbae12a3fff404ed2c12070ad475424d0ae869f)
2347 * **concept-engine**
2348   * Added `HistoryTrackingDelegate` interface for integrating engine implementations with history storage backends. Intended to be used via engine settings.
2349 * **browser-engine**
2350   * `Download.fileName` cannot be `null` anymore. All engine implementations are guaranteed to return a proposed file name for Downloads now.
2351 * **browser-engine-gecko-***, **browser-engine-system**
2352   * Added support for `HistoryTrackingDelegate`, if it's specified in engine settings.
2353 * **browser-engine-servo**
2354   * Added a new experimental *Engine* implementation based on the [Servo Browser Engine](https://servo.org/).
2355 * **browser-session** - basic session hierarchy:
2356   * Sessions can have a parent `Session` now. A `Session` with a parent will be added *after* the parent `Session`. On removal of a selected `Session` the parent `Session` can be selected automatically if desired:
2357   ```kotlin
2358   val parent = Session("https://www.mozilla.org")
2359   val session = Session("https://www.mozilla.org/en-US/firefox/")
2360
2361   sessionManager.add(parent)
2362   sessionManager.add(session, parent = parent)
2363
2364   sessionManager.remove(session, selectParentIfExists = true)
2365   ```
2366 * **browser-session** - obtaining an restoring a SessionsSnapshot:
2367   * It's now possible to request a SessionsSnapshot from the `SessionManager`, which encapsulates currently active sessions, their order and state, and which session is the selected one. Private and Custom Tab sessions are omitted from the snapshot. A new public `restore` method allows restoring a `SessionsSnapshot`.
2368   ```kotlin
2369   val snapshot = sessionManager.createSnapshot()
2370   // ... persist snapshot somewhere, perhaps using the DefaultSessionStorage
2371   sessionManager.restore(snapshot)
2372   ```
2373   * `restore` follows a different observer notification pattern from regular `add` flow. See method documentation for details. A new `onSessionsRestored` notification is now available.
2374 * **browser-session** - new SessionStorage API, new DefaultSessionStorage data format:
2375   * Coupled with the `SessionManager` changes, the SessionStorage API has been changed to operate over `SessionsSnapshot`. New API no longer operates over a SessionManager, and instead reads/writes snapshots which may used together with the SessionManager (see above). An explicit `clear` method is provided for wiping SessionStorage.
2376   * `DefaultSessionStorage` now uses a new storage format internally, which allows maintaining session ordering and preserves session parent information.
2377 * **browser-errorpages**
2378   * Added translation annotations to our error page strings. Translated strings will follow in a future release.
2379 * **service-glean**
2380   * A new client-side telemetry SDK for collecting metrics and sending them to Mozilla's telemetry service. This component is going to eventually replace `service-telemetry`. The SDK is currently in development and the component is not ready to be used yet.
2381 * **lib-dataprotect**
2382   * The `Keystore` class and its `encryptBytes()` and `decryptBytes()` methods are now open to simplify mocking in unit tests.
2383 * **ui-tabcounter**
2384   * The `TabCounter` class is now open and can get extended.
2385 * **feature-downloads**
2386   * Now you're able to provide a dialog before a download starts and customize it to your wish. Take a look at the [updated docs](https://github.com/mozilla-mobile/android-components/blob/main/components/feature/downloads/README.md).
2387
2388 # 0.27.0
2389
2390 Release date: 2018-10-16
2391
2392 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.26.0...v0.27.0),
2393 [Milestone](https://github.com/mozilla-mobile/android-components/milestone/27?closed=1),
2394 [API reference](https://mozilla-mobile.github.io/android-components/api/0.27.0/index)
2395
2396 * Compiled against:
2397   * Android (SDK: 27, Support Libraries: 27.1.1)
2398   * Kotlin (Stdlib: 1.2.61, Coroutines: 0.23.4)
2399   * GeckoView
2400     * Nightly: **64.0.20181004100221** 🔺
2401     * Beta: 63.0b3 (0269319281578bff4e01d77a21350bf91ba08620)
2402     * Release: 62.0 (9cbae12a3fff404ed2c12070ad475424d0ae869f)
2403 * **browser-engine-system**
2404   * Fixed a bug where `SystemEngineSession#exitFullScreenMode` didn't invoke the internal callback to exit the fullscreen mode.
2405   * A new field `defaultUserAgent` was added to `SystemEngine` for testing purposes. This is to circumvent calls to `WebSettings.getDefaultUserAgent` which fails with a `NullPointerException` in Robolectric. If the `SystemEngine` is used in Robolectric tests the following code will be needed:
2406     ```kotlin
2407     @Before
2408     fun setup() {
2409         SystemEngine.defaultUserAgent = "test-ua-string"
2410     }
2411     ```
2412 * **browser-engine-gecko-nightly**:
2413   * Enabled [Java 8 support](https://developer.android.com/studio/write/java8-support) to meet upstream [GeckoView requirements](https://mail.mozilla.org/pipermail/mobile-firefox-dev/2018-September/002411.html). Apps using this component need to enable Java 8 support as well:
2414   ```Groovy
2415   android {
2416     ...
2417     compileOptions {
2418       sourceCompatibility JavaVersion.VERSION_1_8
2419       targetCompatibility JavaVersion.VERSION_1_8
2420     }
2421   }
2422   ```
2423 * **browser-search**
2424   * Fixed an issue where a locale change at runtime would not update the search engines.
2425 * **browser-session**:
2426   * Added reusable functionality for observing sessions, which also support observering the currently selected session, even if it changes.
2427   ```kotlin
2428   class MyFeaturePresenter(
2429       private val sessionManager: SessionManager
2430   ) : SelectionAwareSessionObserver(sessionManager) {
2431
2432       fun start() {
2433           // Always observe changes to the selected session even if the selection changes
2434           super.observeSelected()
2435
2436           // To observe changes to a specific session the following method can be used:
2437           // super.observeFixed(session)
2438       }
2439
2440       override fun onUrlChanged(session: Session, url: String) {
2441           // URL of selected session changed
2442       }
2443
2444       override fun onProgress(session: Session, progress: Int) {
2445          // Progress of selected session changed
2446       }
2447
2448       // More observer functions...
2449   }
2450   ```
2451 * **browser-errorpages**
2452   * Added more detailed documentation in the README.
2453 * **feature-downloads**
2454   * A new components for apps that want to process downloads, for more examples take a look at [here](https://github.com/mozilla-mobile/android-components/blob/main/components/feature/downloads/README.md).
2455 * **lib-crash**
2456   * A new generic crash reporter component that can report crashes to multiple services ([documentation](https://github.com/mozilla-mobile/android-components/blob/main/components/lib/crash/README.md)).
2457 * **support-ktx**
2458   * Added new helper method to run a block of code with a different StrictMode policy:
2459   ```kotlin
2460   StrictMode.allowThreadDiskReads().resetAfter {
2461     // In this block disk reads are not triggering a strict mode violation
2462   }
2463   ```
2464   * Added a new helper for checking if you have permission to do something or not:
2465   ```kotlin
2466     var isGranted = context.isPermissionGranted(INTERNET)
2467     if (isGranted) {
2468         //You can proceed
2469     } else {
2470         //Request permission
2471     }
2472   ```
2473 * **support-test**
2474   * Added a new helper for granting permissions in  Robolectric tests:
2475   ```kotlin
2476      val context = RuntimeEnvironment.application
2477      var isGranted = context.isPermissionGranted(INTERNET)
2478
2479      assertFalse(isGranted) //False permission is not granted yet.
2480
2481      grantPermission(INTERNET) // Now you have permission.
2482
2483      isGranted = context.isPermissionGranted(INTERNET)
2484
2485      assertTrue(isGranted) // True :D
2486   ```
2487
2488 # 0.26.0
2489
2490 Release date: 2018-10-05
2491
2492 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.25.1...v0.26.0),
2493 [Milestone](https://github.com/mozilla-mobile/android-components/milestone/26?closed=1),
2494 [API reference](https://mozilla-mobile.github.io/android-components/api/0.26.0/index)
2495
2496 * Compiled against:
2497   * Android (SDK: 27, Support Libraries: 27.1.1)
2498   * Kotlin (Stdlib: 1.2.61, Coroutines: 0.23.4)
2499   * GeckoView
2500     * Nightly: 64.0.20180905100117
2501     * Beta: 63.0b3 (0269319281578bff4e01d77a21350bf91ba08620)
2502     * Release: 62.0 (9cbae12a3fff404ed2c12070ad475424d0ae869f)
2503
2504 * ⚠️ **Releases are now getting published on [maven.mozilla.org](http://maven.mozilla.org/?prefix=maven2/org/mozilla/components/)**.
2505   * Additionally all artifacts published now use an artifact name that matches the gradle module name (e.g. `browser-toolbar` instead of just `toolbar`).
2506   * All artifacts are published with the group id `org.mozilla.components` (`org.mozilla.photon` is not being used anymore).
2507   * For a smooth transition all artifacts still get published on JCenter with the old group ids and artifact ids. In the near future releases will only be published on maven.mozilla.org. Old releases will remain on JCenter and not get removed.
2508 * **browser-domains**
2509   * Removed `microsoftonline.com` from the global and localized domain lists. No content is being served from that domain. Only subdomains like `login.microsoftonline.com` are used.
2510 * **browser-errorpages**
2511   * Added error page support for multiple error types.
2512     ```kotlin
2513     override fun onErrorRequest(
2514         session: EngineSession,
2515         errorType: ErrorType, // This used to be an Int
2516         uri: String?
2517     ): RequestInterceptor.ErrorResponse? {
2518         // Create an error page.
2519         val errorPage = ErrorPages.createErrorPage(context, errorType)
2520         // Return it to the request interceptor to take care of default error cases.
2521         return RequestInterceptor.ErrorResponse(errorPage)
2522     }
2523     ```
2524   * :warning: **This is a breaking change for the `RequestInterceptor#onErrorRequest` method signature!**
2525 * **browser-engine-**
2526   * Added a setting for enabling remote debugging.
2527   * Creating an `Engine` requires a `Context` now.
2528       ```kotlin
2529        val geckoEngine = GeckoEngine(context)
2530        val systemEngine = SystemEngine(context)
2531       ```
2532 * **browser-engine-system**
2533   * The user agent string now defaults to WebView's default, if not provided, and to the user's default, if provided. It can also be read and changed:
2534     ```kotlin
2535     // Using WebView's default
2536     val engine = SystemEngine(context)
2537
2538     // Using customized WebView default
2539     val engine = SystemEngine(context)
2540     engine.settings.userAgentString = buildUserAgentString(engine.settings.userAgentString)
2541
2542     // Using custom default
2543     val engine = SystemEngine(context, DefaultSettings(userAgentString = "foo"))
2544     ```
2545   * The tracking protection policy can now be set, both as a default and at any time later.
2546     ```kotlin
2547     // Set the default tracking protection policy
2548     val engine = SystemEngine(context, DefaultSettings(
2549       trackingProtectionPolicy = TrackingProtectionPolicy.all())
2550     )
2551
2552     // Change the tracking protection policy
2553     engine.settings.trackingProtectionPolicy = TrackingProtectionPolicy.select(
2554       TrackingProtectionPolicy.AD,
2555       TrackingProtectionPolicy.SOCIAL
2556     )
2557     ```
2558 * **browser-engine-gecko(-*)**
2559   * Creating a `GeckoEngine` requires a `Context` now. Providing a `GeckoRuntime` is now optional.
2560 * **browser-session**
2561   * Fixed an issue that caused a Custom Tab `Session` to get selected if it is the first session getting added.
2562   * `Observer` instances that get attached to a `LifecycleOwner` can now automatically pause and resume observing whenever the lifecycle pauses and resumes. This behavior is off by default and can be enabled by using the `autoPause` parameter when registering the `Observer`.
2563     ```kotlin
2564     sessionManager.register(
2565         observer = object : SessionManager.Observer {
2566             // ...
2567         },
2568         owner = lifecycleOwner,
2569         autoPause = true
2570     )
2571     ```
2572   * Added an optional callback to provide a default `Session` whenever  `SessionManager` is empty:
2573     ```kotlin
2574     val sessionManager = SessionManager(
2575         engine,
2576         defaultSession = { Session("https://www.mozilla.org") }
2577     )
2578     ```
2579 * **service-telemetry**
2580   * Added `Telemetry.getClientId()` to let consumers read the client ID.
2581   * `Telemetry.recordSessionEnd()` now takes an optional callback to be executed upon failure - instead of throwing `IllegalStateException`.
2582 * **service-fretboard**
2583   * Added `ValuesProvider.getClientId()` to let consumers specify the client ID to be used for bucketing the client. By default fretboard will generate and save an internal UUID used for bucketing. By specifying the client ID consumers can use the same ID for telemetry and bucketing.
2584   * Update jobs scheduled with `WorkManagerSyncScheduler` will now automatically retry if the configuration couldn't get updated.
2585   * The update interval of `WorkManagerSyncScheduler` can now be configured.
2586   * Fixed an issue when reading a corrupt experiments file from disk.
2587   * Added a workaround for HttpURLConnection throwing ArrayIndexOutOfBoundsException.
2588 * **ui-autocomplete**
2589   * Fixed an issue causing desyncs between the soft keyboard and `InlineAutocompleteEditText`.
2590 * **samples-firefox-accounts**
2591   * Showcasing new pairing flow which allows connecting new devices to existing accounts using a QR code.
2592
2593 # 0.25.1 (2018-09-27)
2594
2595 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.25...v0.25.1),
2596 [Milestone](https://github.com/mozilla-mobile/android-components/milestone/28?closed=1),
2597 [API reference](https://mozilla-mobile.github.io/android-components/api/0.25.1/index)
2598
2599 * Compiled against:
2600   * Android
2601     * SDK: 27
2602     * Support Libraries: 27.1.1
2603   * Kotlin
2604     * Standard library: 1.2.61
2605     * Coroutines: 0.23.4
2606   * GeckoView
2607     * Nightly: 64.0.20180905100117
2608     * Beta: 63.0b3 (0269319281578bff4e01d77a21350bf91ba08620)
2609     * Release: 62.0 (9cbae12a3fff404ed2c12070ad475424d0ae869f)
2610
2611 * **browser-engine-system**: Fixed a `NullPointerException` in `SystemEngineSession.captureThumbnail()`.
2612
2613 # 0.25 (2018-09-26)
2614
2615 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.24...v0.25),
2616 [Milestone](https://github.com/mozilla-mobile/android-components/milestone/25?closed=1),
2617 [API reference](https://mozilla-mobile.github.io/android-components/api/0.25/index)
2618
2619 * Compiled against:
2620   * Android
2621     * SDK: 27
2622     * Support Libraries: 27.1.1
2623   * Kotlin
2624     * Standard library: 1.2.61
2625     * Coroutines: 0.23.4
2626   * GeckoView
2627     * Nightly: 64.0.20180905100117
2628     * Beta: 63.0b3 (0269319281578bff4e01d77a21350bf91ba08620)
2629     * Release: 62.0 (9cbae12a3fff404ed2c12070ad475424d0ae869f)
2630
2631 * ⚠️ **This is the last release compiled against Android SDK 27. Upcoming releases of the components will require Android SDK 28**.
2632 * **service-fretboard**:
2633   * Fixed a bug in `FlatFileExperimentStorage` that caused updated experiment configurations not being saved to disk.
2634   * Added [WorkManager](https://developer.android.com/reference/kotlin/androidx/work/WorkManager) implementation for updating experiment configurations in the background (See ``WorkManagerSyncScheduler``).
2635   * `Experiment.id` is not accessible by component consumers anymore.
2636 * **browser-engine-system**:
2637   * URL changes are now reported earlier; when the URL of the main frame changes.
2638   * Fixed an issue where fullscreen mode would only take up part of the screen.
2639   * Fixed a crash that could happen when loading invalid URLs.
2640   * `RequestInterceptor.onErrorRequest()` can return custom error page content to be displayed now (the original URL that caused the error will be preserved).
2641 * **feature-intent**: New component providing intent processing functionality (Code moved from *feature-session*).
2642 * **support-utils**: `DownloadUtils.guessFileName()` will replace extension in the URL with the MIME type file extension if needed (`http://example.com/file.aspx` + `image/jpeg` -> `file.jpg`).
2643
2644 # 0.24 (2018-09-21)
2645
2646 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.23...v0.24),
2647 [Milestone](https://github.com/mozilla-mobile/android-components/milestone/24?closed=1),
2648 [API reference](https://mozilla-mobile.github.io/android-components/api/0.24/index)
2649
2650 * Compiled against:
2651   * Android
2652     * SDK: 27
2653     * Support Libraries: 27.1.1
2654   * Kotlin
2655     * Standard library: 1.2.61
2656     * Coroutines: 0.23.4
2657   * GeckoView
2658     * Nightly: 64.0.20180905100117
2659     * Beta: 63.0b3 (0269319281578bff4e01d77a21350bf91ba08620)
2660     * Release: 62.0 (9cbae12a3fff404ed2c12070ad475424d0ae869f)
2661
2662 * **dataprotect**:
2663   * Added a component using AndroidKeyStore to protect user data.
2664   ```kotlin
2665   // Create a Keystore and generate a key
2666   val keystore: Keystore = Keystore("samples-dataprotect")
2667   keystore.generateKey()
2668
2669   // Encrypt data
2670   val plainText = "plain text data".toByteArray(StandardCharsets.UTF_8)
2671   val encrypted = keystore.encryptBytes(plain)
2672
2673   // Decrypt data
2674   val samePlainText = keystore.decryptBytes(encrypted)
2675   ```
2676 * **concept-engine**: Enhanced settings to cover most common WebView settings.
2677 * **browser-engine-system**:
2678   * `SystemEngineSession` now provides a way to capture a screenshot of the actual content of the web page just by calling `captureThumbnail`
2679 * **browser-session**:
2680   * `Session` exposes a new property called `thumbnail` and its internal observer also exposes a new listener `onThumbnailChanged`.
2681
2682   ```Kotlin
2683   session.register(object : Session.Observer {
2684       fun onThumbnailChanged(session: Session, bitmap: Bitmap?) {
2685               // Do Something
2686       }
2687   })
2688   ```
2689
2690   * `SessionManager` lets you notify it when the OS is under low memory condition by calling to its new function `onLowMemory`.
2691
2692 * **browser-tabstray**:
2693
2694    * Now on `BrowserTabsTray` every tab gets is own thumbnail :)
2695
2696 * **support-ktx**:
2697
2698    * Now you can easily query if the OS is under low memory conditions, just by using `isOSOnLowMemory()` extension function on `Context`.
2699
2700   ```Kotlin
2701   val shouldReduceMemoryUsage = context.isOSOnLowMemory()
2702
2703   if (shouldReduceMemoryUsage) {
2704       //Deallocate some heavy objects
2705   }
2706   ```
2707
2708   * `View.dp` is now`Resource.pxtoDp`.
2709
2710   ```Kotlin
2711   // Before
2712   toolbar.dp(104)
2713
2714   // Now
2715   toolbar.resources.pxToDp(104)
2716   ```
2717 * **samples-browser**:
2718    * Updated to show the new features related to tab thumbnails. Be aware that this feature is only available for `systemEngine` and you have to switch to the build variant `systemEngine*`.
2719
2720 # 0.23 (2018-09-13)
2721
2722 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.22...v0.23),
2723 [Milestone](https://github.com/mozilla-mobile/android-components/milestone/23?closed=1),
2724 [API reference](https://mozilla-mobile.github.io/android-components/api/0.23/index)
2725
2726 * Compiled against:
2727   * Android
2728     * SDK: 27
2729     * Support Libraries: 27.1.1
2730   * Kotlin
2731     * Standard library: 1.2.61
2732     * Coroutines: 0.23.4
2733   * GeckoView
2734     * Nightly: 64.0.20180905100117
2735     * Beta: 63.0b3 (0269319281578bff4e01d77a21350bf91ba08620)
2736     * Release: 62.0 (9cbae12a3fff404ed2c12070ad475424d0ae869f)
2737
2738 * Added initial documentation for the browser-session component: https://github.com/mozilla-mobile/android-components/blob/main/components/browser/session/README.md
2739 * **sync-logins**: New component for integrating with Firefox Sync (for Logins). A sample app showcasing this new functionality can be found at: https://github.com/mozilla-mobile/android-components/tree/main/samples/sync-logins
2740 * **browser-engine-**:
2741   * Added support for fullscreen mode and the ability to exit it programmatically if needed.
2742   ```Kotlin
2743   session.register(object : Session.Observer {
2744       fun onFullScreenChange(enabled: Boolean) {
2745           if (enabled) {
2746               // ..
2747               sessionManager.getEngineSession().exitFullScreenMode()
2748           }
2749       }
2750   })
2751   ```
2752 * **concept-engine**, **browser-engine-system**, **browser-engine-gecko(-beta/nightly)**:
2753   * We've extended support for intercepting requests to also include intercepting of errors
2754   ```Kotlin
2755   val interceptor = object : RequestInterceptor {
2756     override fun onErrorRequest(
2757       session: EngineSession,
2758       errorCode: Int,
2759       uri: String?
2760     ) {
2761       engineSession.loadData("<html><body>Couldn't load $uri!</body></html>")
2762     }
2763   }
2764   // GeckoEngine (beta/nightly) and SystemEngine support request interceptors.
2765   GeckoEngine(runtime, DefaultSettings(requestInterceptor = interceptor))
2766   ```
2767 * **browser-engine-system**:
2768     * Added functionality to clear all browsing data
2769     ```Kotlin
2770     sessionManager.getEngineSession().clearData()
2771     ```
2772     * `onNavigationStateChange` is now called earlier (when the title of a web page is available) to allow for faster toolbar updates.
2773 * **feature-session**: Added support for processing `ACTION_SEND` intents (`ACTION_VIEW` was already supported)
2774
2775   ```Kotlin
2776   // Triggering a search if the provided EXTRA_TEXT is not a URL
2777   val searchHandler: TextSearchHandler = { searchTerm, session ->
2778        searchUseCases.defaultSearch.invoke(searchTerm, session)
2779   }
2780
2781   // Handles both ACTION_VIEW and ACTION_SEND intents
2782   val intentProcessor = SessionIntentProcessor(
2783       sessionUseCases, sessionManager, textSearchHandler = searchHandler
2784   )
2785   intentProcessor.process(intent)
2786   ```
2787 * Replaced some miscellaneous uses of Java 8 `forEach` with Kotlin's for consistency and backward-compatibility.
2788 * Various bug fixes (see [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.22...v0.23) for details).
2789
2790 # 0.22 (2018-09-07)
2791
2792 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.21...v0.22),
2793 [Milestone](https://github.com/mozilla-mobile/android-components/milestone/22?closed=1),
2794 [API reference](https://mozilla-mobile.github.io/android-components/api/0.22/index)
2795
2796 * Compiled against:
2797   * Android
2798     * SDK: 27
2799     * Support Libraries: 27.1.1
2800   * Kotlin
2801     * Standard library: 1.2.61
2802     * Coroutines: 0.23.4
2803   * GeckoView
2804     * Nightly: **64.0.20180905100117** 🔺
2805     * Beta: **63.0b3** (0269319281578bff4e01d77a21350bf91ba08620) 🔺
2806     * Release: **62.0** (9cbae12a3fff404ed2c12070ad475424d0ae869f) 🔺
2807
2808 * We now provide aggregated API docs. The docs for this release are hosted at: https://mozilla-mobile.github.io/android-components/api/0.22
2809 * **browser-engine-**:
2810   * EngineView now exposes lifecycle methods with default implementations. A `LifecycleObserver` implementation is provided which forwards events to EngineView instances.
2811   ```kotlin
2812   lifecycle.addObserver(EngineView.LifecycleObserver(view))
2813   ```
2814   * Added engine setting for blocking web fonts:
2815   ```kotlin
2816   GeckoEngine(runtime, DefaultSettings(webFontsEnabled = false))
2817   ```
2818   * `setDesktopMode()` was renamed to `toggleDesktopMode()`.
2819 * **browser-engine-system**: The `X-Requested-With` header is now cleared (set to an empty String).
2820 * **browser-session**: Desktop mode can be observed now:
2821   ```Kotlin
2822   session.register(object : Session.Observer {
2823       fun onDesktopModeChange(enabled: Boolean) {
2824           // ..
2825       }
2826   })
2827   ```
2828 * **service-fretboard**:
2829   * `Fretboard` now has synchronous methods for adding and clearing overrides: `setOverrideNow()`, `clearOverrideNow`, `clearAllOverridesNow`.
2830   * Access to `Experiment.id` is now deprecated and is scheduled to be removed in a future release (target: 0.24). The `id` is an implementation detail of the underlying storage service and was not meant to be exposed to apps.
2831 * **ui-tabcounter**: Due to a packaging error previous releases of this component didn't contain any compiled code. This is the first usable release of the component.
2832
2833
2834 # 0.21 (2018-08-31)
2835
2836 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.20...v0.21),
2837 [Milestone](https://github.com/mozilla-mobile/android-components/milestone/21?closed=1),
2838 [API reference](https://mozilla-mobile.github.io/android-components/api/0.21/index)
2839
2840 * Compiled against:
2841   * Android support libraries 27.1.1
2842   * Kotlin Standard library **1.2.61** 🔺
2843   * Kotlin coroutines 0.23.4
2844   * GeckoView
2845     * Nightly: **63.0.20180830111743** 🔺
2846     * Beta: **62.0b21** (7ce198bb7ce027d450af3f69a609896671adfab8) 🔺
2847     * Release: 61.0 (785d242a5b01d5f1094882aa2144d8e5e2791e06)
2848
2849 * **concept-engine**, **engine-system**, **engine-gecko**: Added API to set default session configuration e.g. to enable tracking protection for all sessions by default.
2850     ```Kotlin
2851     // DefaultSettings can be set on GeckoEngine and SystemEngine.
2852     GeckoEngine(runtime, DefaultSettings(
2853         trackingProtectionPolicy = TrackingProtectionPolicy.all(),
2854         javascriptEnabled = false))
2855     ```
2856 * **concept-engine**, **engine-system**, **engine-gecko-beta/nightly**:
2857   * Added support for intercepting request and injecting custom content. This can be used for internal pages (e.g. *focus:about*, *firefox:home*) and error pages.
2858     ```Kotlin
2859     // GeckoEngine (beta/nightly) and SystemEngine support request interceptors.
2860     GeckoEngine(runtime, DefaultSettings(
2861         requestInterceptor = object : RequestInterceptor {
2862             override fun onLoadRequest(session: EngineSession, uri: String): RequestInterceptor.InterceptionResponse? {
2863                 return when (uri) {
2864                     "sample:about" -> RequestInterceptor.InterceptionResponse("<h1>I am the sample browser</h1>")
2865                     else -> null
2866                }
2867            }
2868        }
2869     )
2870     ```
2871   * Added APIs to support "find in page".
2872     ```Kotlin
2873         // Finds and highlights all occurrences of "hello"
2874         engineSession.findAll("hello")
2875
2876         // Finds and highlights the next or previous match
2877         engineSession.findNext(forward = true)
2878
2879         // Clears the highlighted results
2880         engineSession.clearFindMatches()
2881
2882         // The current state of "Find in page" can be observed on a Session object:
2883         session.register(object : Session.Observer {
2884             fun onFindResult(session: Session, result: FindResult) {
2885                 // ...
2886             }
2887         })
2888     ```
2889 * **browser-engine-gecko-nightly**: Added option to enable/disable desktop mode ("Request desktop site").
2890     ```Kotlin
2891         engineSession.setDesktopMode(true, reload = true)
2892     ```
2893 * **browser-engine-gecko(-nightly/beta)**: Added API for observing long presses on web content (links, audio, videos, images, phone numbers, geo locations, email addresses).
2894     ```Kotlin
2895         session.register(object : Session.Observer {
2896             fun onLongPress(session: Session, hitResult: HitResult): Boolean {
2897                 // HitResult is a sealed class representing the different types of content that can be long pressed.
2898                 // ...
2899
2900                 // Returning true will "consume" the event. If no observer consumes the event then it will be
2901                 // set on the Session object to be consumed at a later time.
2902                 return true
2903             }
2904         })
2905     ```
2906 * **lib-dataprotect**: New component to protect local user data using the [Android keystore system](https://developer.android.com/training/articles/keystore). This component doesn't contain any code in this release. In the next sprints the Lockbox team will move code from the [prototype implementation](https://github.com/linuxwolf/android-dataprotect) to the component.
2907 * **support-testing**: New helper test function to assert that a code block throws an exception:
2908     ```Kotlin
2909     expectException(IllegalStateException::class) {
2910         // Do something that should throw IllegalStateException..
2911     }
2912     ```
2913
2914 # 0.20 (2018-08-24)
2915
2916 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.19.1...v0.20),
2917 [Milestone](https://github.com/mozilla-mobile/android-components/milestone/19?closed=1),
2918 [API reference](https://mozilla-mobile.github.io/android-components/api/0.20/index)
2919
2920 * Compiled against:
2921   * Android support libraries 27.1.1
2922   * Kotlin Standard library 1.2.60
2923   * Kotlin coroutines 0.23.4
2924   * GeckoView
2925     * Nightly: **63.0.20180820100132** 🔺
2926     * Beta: 62.0b15 (7ce198bb7ce027d450af3f69a609896671adfab8)
2927     * Release: 61.0 (785d242a5b01d5f1094882aa2144d8e5e2791e06)
2928
2929 * GeckoView Nightly dependencies are now pulled in from *maven.mozilla.org*.
2930 * **engine-system**: Added tracking protection functionality.
2931 * **concept-engine**, **browser-session**, **feature-session**: Added support for private browsing mode.
2932 * **concept-engine**, **engine-gecko**, **engine-system**: Added support for modifying engine and engine session settings.
2933
2934 # 0.19.1 (2018-08-20)
2935
2936 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.19...v0.19.1),
2937 [Milestone](https://github.com/mozilla-mobile/android-components/milestone/20?closed=1),
2938 [API reference](https://mozilla-mobile.github.io/android-components/api/0.19.1/index)
2939
2940 * Compiled against:
2941   * Android support libraries 27.1.1
2942   * Kotlin Standard library 1.2.60
2943   * Kotlin coroutines 0.23.4
2944   * GeckoView
2945     * Nightly: 63.0.20180810100129 (2018.08.10, d999fb858fb2c007c5be4af72bce419c63c69b8e)
2946     * Beta: 62.0b15 (7ce198bb7ce027d450af3f69a609896671adfab8)
2947     * Release: 61.0 (785d242a5b01d5f1094882aa2144d8e5e2791e06)
2948
2949 * **browser-toolbar**: Replaced `ui-progress` component with default [Android Progress Bar](https://developer.android.com/reference/android/widget/ProgressBar) to fix CPU usage problems.
2950 * **ui-progress**: Reduced high CPU usage when idling and not animating.
2951
2952
2953 # 0.19 (2018-08-17)
2954
2955 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.18...v0.19),
2956 [Milestone](https://github.com/mozilla-mobile/android-components/milestone/18?closed=1),
2957 [API reference](https://mozilla-mobile.github.io/android-components/api/0.19/index)
2958
2959 * Compiled against:
2960   * Android support libraries 27.1.1
2961   * Kotlin Standard library 1.2.60
2962   * Kotlin coroutines 0.23.4
2963   * GeckoView
2964     * Nightly: 63.0.20180810100129 (2018.08.10, d999fb858fb2c007c5be4af72bce419c63c69b8e)
2965     * Beta: 62.0b15 (7ce198bb7ce027d450af3f69a609896671adfab8)
2966     * Release: 61.0 (785d242a5b01d5f1094882aa2144d8e5e2791e06)
2967
2968 * **concept-engine**, **engine-system**, **engine-gecko**: Added new API to load data and HTML directly (without loading a URL). Added the ability to stop loading a page.
2969 * **ui-autocomplete**: Fixed a bug that caused soft keyboards and the InlineAutocompleteEditText component to desync.
2970 * **service-firefox-accounts**: Added JNA-specific proguard rules so consumers of this library don't have to add them to their app (see https://github.com/java-native-access/jna/blob/main/www/FrequentlyAskedQuestions.md#jna-on-android for details). Underlying libfxa_client.so no longer depends on versioned .so names. All required dependencies are now statically linked which simplified our dependency setup as well.
2971
2972 # 0.18 (2018-08-10)
2973
2974 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.17...v0.18),
2975 [Milestone](https://github.com/mozilla-mobile/android-components/milestone/16?closed=1),
2976 [API reference](https://mozilla-mobile.github.io/android-components/api/0.18/index)
2977
2978 * Compiled against:
2979   * Android support libraries 27.1.1
2980   * Kotlin Standard library 1.2.60
2981   * Kotlin coroutines 0.23.4
2982   * GeckoView
2983     * Nightly: **63.0.20180810100129** (2018.08.10, d999fb858fb2c007c5be4af72bce419c63c69b8e) 🔺
2984     * Beta: **62.0b15** (7ce198bb7ce027d450af3f69a609896671adfab8) 🔺
2985     * Release: 61.0 (785d242a5b01d5f1094882aa2144d8e5e2791e06)
2986
2987 * **engine-gecko-beta**: Since the [Load Progress Tracking API](https://bugzilla.mozilla.org/show_bug.cgi?id=1437988) was uplifted to GeckoView Beta  _engine-gecko-beta_ now reports progress via `EngineSession.Observer.onProgress()`.
2988 * **service-fretboard**: KintoExperimentSource can now validate the signature of the downloaded experiments configuration (`validateSignature` flag). This ensures that the configuration was signed by Mozilla and was not modified by a bad actor. For now the `validateSignature` flag is off by default until this has been tested in production. Various bugfixes and refactorings.
2989 * **service-firefox-accounts**: JNA native libraries are no longer part of the AAR and instead referenced as a dependency. This avoids duplication when multiple libraries depend on JNA.
2990 * **ui-tabcounter**: New UI component - A button that shows the current tab count and can animate state changes. Extracted from Firefox Rocket.
2991 * API references for every release are now generated and hosted online: [https://mozilla-mobile.github.io/android-components/reference/](https://mozilla-mobile.github.io/android-components/reference/)
2992 * Documentation and more is now hosted at: [https://mozilla-mobile.github.io/android-components/](https://mozilla-mobile.github.io/android-components/). More content coming soon.
2993 * **tooling-lint**: New (internal-only) component containing custom lint rules.
2994
2995
2996 # 0.17 (2018-08-03)
2997
2998 * Compiled against:
2999   * Android support libraries 27.1.1
3000   * Kotlin Standard library **1.2.60** 🔺
3001   * Kotlin coroutines 0.23.4
3002   * GeckoView
3003     * Nightly: **63.0.20180801100114** (2018.08.01, af6a7edf0069549543f2fba6a8ee3ea251b20829) 🔺
3004     * Beta: **62.0b13** (dd92dec96711e60a8c6a49ebe584fa23a453a292) 🔺
3005     * Release: 61.0 (785d242a5b01d5f1094882aa2144d8e5e2791e06)
3006
3007 * **support-base**: New base component containing small building blocks for other components. Added a [simple logging API](https://github.com/mozilla-mobile/android-components/blob/main/components/support/base/README.md) that allows components to log messages/exceptions but lets the consuming app decide what gets logged and how.
3008 * **support-utils**: Some classes have been moved to the new _support-base_ component.
3009 * **service-fretboard**: ⚠️ Breaking change: `ExperimentDescriptor` instances now operate on the experiment name instead of the ID.
3010 * **ui-icons**: Added new icons (used in _Firefox Focus_ UI refresh): `mozac_ic_arrowhead_down`, `mozac_ic_arrowhead_up`, `mozac_ic_check`, `mozac_ic_device_desktop`, `mozac_ic_mozilla`, `mozac_ic_open_in`, `mozac_ic_reorder`.
3011 * **service-firefox-accounts**: Added [documentation](https://github.com/mozilla-mobile/android-components/blob/main/components/service/firefox-accounts/README.md).
3012 * **service-fretboard**: Updated [documentation](https://github.com/mozilla-mobile/android-components/blob/main/components/service/fretboard/README.md).
3013 * **browser-toolbar**: Fixed an issue where the toolbar content disappeared if a padding value was set on the toolbar.
3014
3015 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.16.1...v0.17), [Milestone](https://github.com/mozilla-mobile/android-components/milestone/15?closed=1)
3016
3017 # 0.16.1 (2018-07-26)
3018
3019 * Compiled against:
3020   * Android support libraries 27.1.1
3021   * Kotlin Standard library 1.2.51
3022   * Kotlin coroutines 0.23.4
3023   * GeckoView
3024     * Nightly: 63.0.20180724100046 (2018.07.24, 1e5fa52a612e8985e12212d1950a732954e00e45)
3025     * Beta: 62.0b9 (d7ab2f3df0840cdb8557659afd46f61afa310379)
3026     * Release: 61.0 (785d242a5b01d5f1094882aa2144d8e5e2791e06)
3027
3028 * **service-telemetry**: Allow up to 200 extras in event pings.
3029
3030 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.16...v0.16.1), [Milestone](https://github.com/mozilla-mobile/android-components/milestone/17?closed=1)
3031
3032 # 0.16 (2018-07-25)
3033
3034 * Compiled against:
3035   * Android support libraries 27.1.1
3036   * Kotlin Standard library 1.2.51
3037   * Kotlin coroutines 0.23.4
3038   * GeckoView
3039     * Nightly: 63.0.20180724100046 (2018.07.24, 1e5fa52a612e8985e12212d1950a732954e00e45)
3040     * Beta: 62.0b9 (d7ab2f3df0840cdb8557659afd46f61afa310379)
3041     * Release: 61.0 (785d242a5b01d5f1094882aa2144d8e5e2791e06)
3042
3043 * **service-fretboard**: Experiments can now be filtered by release channel. Added helper method to get list of active experiments.
3044 * **service-telemetry**: Added option to report active experiments in the core ping.
3045 * **service-firefox-accounts**, **sample-firefox-accounts**: libjnidispatch.so is no longer in the tree but automatically fetched from tagged GitHub releases at build-time. Upgraded to fxa-rust-client library 0.2.1. Renmaed armeabi directory to armeabi-v7a.
3046 * **browser-session**, **concept-engine**: Exposed website title and tracking protection in session and made observable.
3047 * **browser-toolbar**: Fixed bug that prevented the toolbar from being displayed at the bottom of the screen. Fixed animation problem when multiple buttons animated at the same time.
3048 * Various bugfixes and refactorings (see commits below for details)
3049 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.15...v0.16), [Milestone](https://github.com/mozilla-mobile/android-components/milestone/14?closed=1)
3050
3051 # 0.15 (2018-07-20)
3052
3053 * Compiled against:
3054   * Android support libraries 27.1.1
3055   * Kotlin Standard library 1.2.51
3056   * Kotlin coroutines 0.23.4
3057   * GeckoView
3058     * Nightly: 63.0.20180704100138 (2018.07.04, 1c235a552c32ba6c97e6030c497c49f72c7d48a8)
3059     * Beta: 62.0b5 (801112336847960bbb9a018695cf09ea437dc137)
3060     * Release: 61.0 (785d242a5b01d5f1094882aa2144d8e5e2791e06)
3061
3062 * **service-firefox-accounts**, **sample-firefox-accounts**: Added authentication flow using WebView. Introduced functionality to persist and restore FxA state in shared preferences to keep users signed in between applications restarts. Increased test coverage for library.
3063 * **service-fretboard**: New component for segmenting users in order to run A/B tests and rollout features gradually.
3064 * **browser-session**: Refactored session observer to provide session object and changed values to simplify observer implementations. Add source (origin) information to Session.
3065 * **browser-search**: Introduced new functionality to retrieve search suggestions.
3066 * **engine-system**, **engine-gecko**, **browser-session**: Exposed downloads in engine components and made them consumable from browser session.
3067 * **engine-gecko**: Added optimization to ignore initial loads of about:blank.
3068
3069 * Various bugfixes and refactorings (see commits below for details)
3070 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.14...v0.15), [Milestone](https://github.com/mozilla-mobile/android-components/milestone/13?closed=1)
3071
3072 # 0.14 (2018-07-13)
3073
3074 * Compiled against:
3075   * Android support libraries 27.1.1
3076   * Kotlin Standard library 1.2.51
3077   * Kotlin coroutines 0.23.4
3078   * GeckoView
3079     * Nightly: 63.0.20180704100138 (2018.07.04, 1c235a552c32ba6c97e6030c497c49f72c7d48a8)
3080     * Beta: 62.0b5 (801112336847960bbb9a018695cf09ea437dc137)
3081     * Release: 61.0 (785d242a5b01d5f1094882aa2144d8e5e2791e06)
3082
3083 * **support-test**: A new component with helpers for testing components.
3084 * **browser-session**: New method `SessionManager.removeSessions()` for removing all sessions *except custom tab sessions*. `SessionManager.selectedSession` is now nullable. `SessionManager.selectedSessionOrThrow` can be used in apps that will always have at least one selected session and that do not want to deal with a nullable type.
3085 * **feature-sessions**: `SessionIntentProcessor` can now be configured to open new tabs for incoming [Intents](https://developer.android.com/reference/android/content/Intent).
3086 * **ui-icons**: Mirrored `mozac_ic_pin` and `mozac_ic_pin_filled` icons.
3087 * **service-firefox-accounts**: Renamed the component from *service-fxa* for clarity. Introduced `FxaResult.whenComplete()` to be called when the `FxaResult` and the whole chain of `then` calls is completed with a value. Synchronized blocks invoking Rust calls.
3088 * Various bugfixes and refactorings (see commits below for details)
3089 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.13...v0.14), [Milestone](https://github.com/mozilla-mobile/android-components/milestone/12?closed=1)
3090
3091 # 0.13 (2018-07-06)
3092
3093 * Compiled against:
3094   * Android support libraries 27.1.1
3095   * Kotlin Standard library 1.2.51
3096   * Kotlin coroutines 0.23.4
3097   * GeckoView
3098     * Nightly: 63.0.20180704100138 (2018.07.04, 1c235a552c32ba6c97e6030c497c49f72c7d48a8)
3099     * Beta: 62.0b5
3100     * Release: 61.0
3101
3102 * **service-fxa**, **samples-fxa**: Various improvements to FxA component API (made calls asynchronous and introduced error handling)
3103 * **browser-toolbar**: Added functionality to observer focus changes (`setOnEditFocusChangeListener`)
3104 * **concept-tabstray**, **browser-tabstray**, **features-tabs**: New components to provide browser tabs functionality
3105 * **sample-browser**: Updated to support multiple tabs
3106
3107 * **API changes**:
3108   * InlineAutocompleteEditText: `onAutocomplete` was renamed to `applyAutocompleteResult`
3109   * Toolbar: `setOnUrlChangeListener` was renamed to `setOnUrlCommitListener`
3110
3111 * Various bugfixes and refactorings (see commits below for details)
3112 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.12...v0.13)
3113
3114 # 0.12 (2018-06-29)
3115
3116 * Compiled against:
3117   * Android support libraries 27.1.1
3118   * Kotlin Standard library 1.2.50
3119   * Kotlin coroutines 0.23.3
3120   * GeckoView Nightly
3121     * date: 2018.06.27
3122     * version: 63.0.20180627100018
3123     * revision: 1c235a552c32ba6c97e6030c497c49f72c7d48a8
3124
3125 * **service-fxa**, **samples-fxa**: Added new library/component for integrating with Firefox Accounts, and a sample app to demo its usage
3126 * **samples-browser**: Moved all browser behaviour into standalone fragment
3127 * Various bugfixes and refactorings (see commits below for details)
3128
3129 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.11...v0.12)
3130
3131 # 0.11 (2018-06-22)
3132
3133 * Compiled against:
3134   * Android support libraries 27.1.1
3135   * Kotlin Standard library 1.2.41
3136   * Kotlin coroutines 0.22.5
3137   * GeckoView Nightly
3138     * date: 2018.06.21
3139     * version: 62.0.20180621100051
3140     * revision: e834d23a292972ab4250a8be00e6740c43e41db2
3141
3142 * **feature-session**, **browser-session**: Added functionality to process CustomTabsIntent.
3143 * **engine-gecko**: Created separate engine-gecko variants/modules for nightly/beta/release channels.
3144 * **browser-toolbar**: Added support for setting autocomplete filter.
3145 * Various refactorings (see commits below for details)
3146
3147 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.10...v0.11)
3148
3149 # 0.10 (2018-06-14)
3150
3151 * Compiled against:
3152   * Android support libraries 27.1.1
3153   * Kotlin Standard library 1.2.41
3154   * Kotlin coroutines 0.22.5
3155   * GeckoView Nightly
3156     * date: 2018.05.16
3157     * version: 62.0.20180516100458
3158     * revision: dedd25bfd2794eaba95225361f82c701e49c9339
3159
3160 * **browser-session**: Added Custom Tabs configuration to session. Added new functionality that allows attaching a lifecycle owner to session observers so that observer can automatically be unregistered when the associated lifecycle ends.
3161 * **service-telemetry**: Updated createdTimestamp and createdDate fields for mobile-metrics ping
3162
3163 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.9...v0.10)
3164
3165 # 0.9 (2018-06-06)
3166
3167 * Compiled against:
3168   * Android support libraries 27.1.1
3169   * Kotlin Standard library 1.2.41
3170   * Kotlin coroutines 0.22.5
3171   * GeckoView Nightly
3172     * date: 2018.05.16
3173     * version: 62.0.20180516100458
3174     * revision: dedd25bfd2794eaba95225361f82c701e49c9339
3175
3176 * **feature-session**, **engine-gecko**, **engine-system**: Added functionality and API to save/restore engine session state and made sure it's persisted by default (using `DefaultSessionStorage`)
3177 * **concept-toolbar**: Use "AppCompat" versions of ImageButton and ImageView. Add `notifyListener` parameter to `setSelected` and `toggle` to specify whether or not listeners should be invoked.
3178
3179 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.8...v0.9)
3180
3181 # 0.8 (2018-05-30)
3182
3183 * Compiled against:
3184   * Android support libraries 27.1.1
3185   * Kotlin Standard library 1.2.41
3186   * Kotlin coroutines 0.22.5
3187   * GeckoView Nightly
3188     * date: 2018.05.16
3189     * version: 62.0.20180516100458
3190     * revision: dedd25bfd2794eaba95225361f82c701e49c9339
3191
3192 * **browser-session**, **engine-gecko**, **engine-system**: Added SSL information and secure state to session, and made it observable.
3193 * **browser-toolbar**: Introduced page, browser and navigation actions and allow for them to be dynamically shown, hidden and updated. Added ability to specify custom behaviour for clicks on URL in display mode. Added support for custom background actions. Enabled layout transitions by default.
3194 * **service-telemetry**: Added new mobile-metrics ping type.
3195
3196 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.7...v0.8)
3197
3198 # 0.7 (2018-05-24)
3199
3200 * Compiled against:
3201   * Android support libraries 27.1.1
3202   * Kotlin Standard library 1.2.41
3203   * Kotlin coroutines 0.22.5
3204   * GeckoView Nightly
3205     * date: 2018.05.16
3206     * version: 62.0.20180516100458
3207     * revision: dedd25bfd2794eaba95225361f82c701e49c9339
3208
3209 * **browser-toolbar**: Added support for dynamic actions. Made site security indicator optional. Added support for overriding default height and padding.
3210 * **feature-session**: Added new use case implementation to support reloading URLs. Fixed bugs when restoring sessions from storage. Use `AtomicFile` for `DefaultSessionStorage`.
3211 * **feature-search**: New component - Connects an (concept) engine implementation with the browser search module and provides search related use case implementations e.g. searching using the default provider.
3212 * **support-ktx**: Added extension method to check if a `String` represents a URL.
3213 * **samples-browser**: Added default search integration using the new feature-search component.
3214 * **samples-toolbar**: New sample app - Shows how to customize the browser-toolbar component.
3215
3216 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.6...v0.7)
3217
3218 # 0.6 (2018-05-16)
3219
3220 * Compiled against:
3221   * Android support libraries 27.1.1
3222   * Kotlin Standard library 1.2.41
3223   * Kotlin coroutines 0.22.5
3224   * GeckoView Nightly
3225     * date: 2018.05.16
3226     * version: 62.0.20180516100458
3227     * revision: dedd25bfd2794eaba95225361f82c701e49c9339
3228
3229 * **browser-menu**: New component - A generic menu with customizable items for browser toolbars.
3230 * **concept-session-storage**: New component - Abstraction layer for hiding the actual session storage implementation.
3231 * **feature-session**: Added `DefaultSessionStorage` which is used if no other implementation of `SessionStorage` (from the new concept module) is provided. Introduced a new `SessionProvider` type which simplifies the API for use cases and components and removed the `SessionMapping` type as it's no longer needed.
3232 * **support-ktx**: Added extension methods to `View` for checking visibility (`View.isVisible`, `View.isInvisible` and `View.isGone`).
3233 * **samples-browser**: Use new browser menu component and switch to Gecko as default engine.
3234
3235 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.5.1...v0.6)
3236
3237 # 0.5.1 (2018-05-03)
3238
3239 * Compiled against:
3240   * Android support libraries 27.1.1
3241   * Kotlin Standard library 1.2.41
3242   * Kotlin coroutines 0.22.5
3243   * GeckoView Nightly
3244     * date: 2018.04.10
3245     * version: 61.0.20180410100334
3246     * revision: a8061a09cd7064a8783ca9e67979d77fb52e001e
3247
3248 * **browser-domains**: Simplified API of `DomainAutoCompleteProvider` which now uses a dedicated result type instead of a callback and typealias.
3249 * **browser-toolbar**: Added various enhancements to support edit and display mode and to navigate back/forward.
3250 * **feature-session**: Added `SessionIntentProcessor` which provides reuseable functionality to handle incoming intents.
3251 * **sample-browser**: Sample application now handles the device back button and reacts to incoming (ACTION_VIEW) intents.
3252 * **support-ktx**: Added extension methods to `View` for converting dp to pixels (`View.dp`), showing and hiding the keyboard (`View.showKeyboard` and `View.hideKeyboard`).
3253 * **service-telemetry**: New component - A generic library for generating and sending telemetry pings from Android applications to Mozilla's telemetry service.
3254 * **ui-icons**: New component - A collection of often used browser icons.
3255 * **ui-progress**: New component - An animated progress bar following the Photon Design System.
3256
3257 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.4...v0.5)
3258
3259 # 0.5 (2018-05-02)
3260
3261 _Due to a packaging bug this release is not usable. Please use 0.5.1 instead._
3262
3263 # 0.4 (2018-04-19)
3264
3265 * Compiled against:
3266   * Android support libraries 27.1.1
3267   * Kotlin Standard library 1.2.31
3268   * Kotlin coroutines 0.22.5
3269
3270 * **browser-search**: New module - Search plugins and companion code to load, parse and use them.
3271 * **browser-domains**: Auto-completion of full URLs (instead of just domains) is now supported.
3272 * **ui-colors** module (org.mozilla.photon:colors) now includes all photon colors.
3273 * **ui-fonts**: New module - Convenience accessor for fonts used by Mozilla.
3274 * Multiple (Java/Kotlin) package names have been changed to match the naming of the module. Module names usually follow the template "$group-$name" and package names now follow the same scheme: "mozilla.components.$group.$name". For example the code of the "browser-toolbar" module now lives in the "mozilla.components.browser.toolbar" package. The group and artifacts Ids in Maven/Gradle have not been changed at this time.
3275
3276 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.3...v0.4)
3277
3278 # 0.3 (2018-04-05)
3279
3280 * Compiled against:
3281   * Android support libraries 27.1.1
3282   * Kotlin Standard library 1.2.30
3283   * Kotlin coroutines 0.19.3
3284
3285 * New component: **ui-autocomplete** - A set of components to provide autocomplete functionality. **InlineAutocompleteEditText** is a Kotlin version of the inline autocomplete widget we have been using in Firefox for Android and Focus/Klar for Android.
3286 * New component: **browser-domains** - Localized and customizable domain lists for auto-completion in browsers.
3287 * New components (Planning phase; Not for consumption yet): engine, engine-gecko, session, toolbar
3288
3289 * [Commits](https://github.com/mozilla-mobile/android-components/compare/v0.2.2...v0.3)
3290
3291 # 0.2.2 (2018-03-27)
3292
3293 * Compiled against:
3294   * Android support libraries 27.1.0
3295   * Kotlin Standard library 1.2.30
3296
3297 * First release with synchronized version numbers.