Concepts / Building Search UI / Upgrade guide for InstantSearch Android
Aug. 21, 2019

Upgrade Guide for InstantSearch Android

Upgrade from InstantSearch v1 to v2

InstantSearch v2 introduces a new architecture and new widgets, which brings several breaking changes from the v1.

  • There is no more InstantSearch component automatically connecting widgets. You are now in control of the Searcher and responsible for connecting and disconnecting it from widgets and other components.
  • The widgets are now built around ViewModels, holding their data and business logic.
    Compared to the V1 where widgets were Android Views, now the core of the widget is its view-model, and the UI is behind an interface to ensure minimal coupling.

You can learn more about the philosophy of InstantSearch v2 in What is InstantSearch. Once ready to start migrating, learn the steps to building an InstantSearch v2 application in our getting started guide, and have a look at the new widgets.

The InstantSearch Android v1 documentation is available on the legacy docs page.

Did you find this page helpful?