4.8.1

Miscellaneous changes

• [offline] Better error reporting when building offline indices

4.8

New features

• Compatibility with Swift 3.1. (#294) Note: Swift 3.1 being source-compatible with Swift 3.0, version 4.7 was already compatible out of the box, but this one eliminates a few compile-time warnings.
• Support new search parameters in the Query class:
  • disableExactOnAttributes (#369)
  • offset & length (#369)
  • percentileComputation (#365)
  • restrictHighlightAndSnippetArrays (#366)
• Properties of the query classes (AbstractQuery and its derivates) are now KVO-observable (#339)
• Add an option to choose a custom queue for completion handlers (#334). By default, the main queue is used.

Other changes

• The userAgents property (managing the User-Agent HTTP header) is now a static property of the Client class. This should ease its use by other libraries, most notably InstantSearch Core.
• [offline] Unify Index and OfflineIndex under a new Searchable protocol. This makes possible generic algorithms that work with any kind of index (MirroredIndex being a subclass of Index already).
• Shorter README. The complete reference is now only on https://www.algolia.com/doc/api-client/swift/.

4.7

New features

• Support facetingAfterDistinct query parameter
• Support maxFacetHits parameter when searching for facet values
• [offline] Support offline search for facet values

Bug fixes

• (#285) Fix race condition when searching while activating mirrored mode

Other changes

• Update URL of generated reference documentation

4.6.1

Bug fixes

• [offline] Fix reachability handling in onlineOnly request strategy

4.6

New features

• [offline] Support manual building of local indices (MirroredIndex and OfflineIndex)
• [offline] Support fallback logic when getting individual objects

Bug fixes

• (#168) Use network reachability to decide whether to perform online requests
• [offline] Fix race condition in instantiation of local index

4.5

Note: This new version brings a major improvement in the request retry logic (fallback mechanism used when one or more API hosts are down or unreachable). For that reason, an upgrade to this or a later version is strongly recommended for all users of this API Client.

New features

• (#158) Support the responseFields query parameter

Bug fixes

• (#157) New retry logic: stateful host statuses. This should help largely minimize the impact of DNS resolution failures or other long-lasting network problems. Note that the timeout for statuses can be controlled via the AbstractClient.hostStatusTimeout property.

Other changes

• Support more than one polygon in the insidePolygon query parameter. Warning: This breaks backward-compatibility for this specific parameter.

4.4

New features

• (#140) Support searching for facet values (Index.searchForFacetValues(...))
• New method AbstractQuery.clear() to remove all parameters

Other changes

• Open the Query class (along with some of its methods) to allow subclassing in other libraries
• Make available as a static utility the method to build a query string from a dictionary of parameters (AbstractQuery.build(build(parameters:))

4.3

New features

• (#152) Add support for Algolia Places

4.2

New features

• Add support for a list of languages in the ignorePlurals query parameter. Warning: This breaks backward-compatibility for this specific parameter.

Bug fixes

• (#144) Fix compilation warning with Xcode 8.1

Other changes

• (Objective-C bridging) Switch back to only one Query class. Note: This change is backward-compatible at the source level, provided that:
  • Objective-C code did not reference the BaseQuery type explicitly
  • Swift code did not reference the _objc_Query type explicitly

4.1

New features

• Support the createIfNotExists parameter in partial updates
• [offline] Offline-only indices

Bug fixes

• (#134) Use new format version when retrieving index settings
• Fix asynchronous dispatch of some completion handlers (were called outside the main thread)

Other changes

• Rename attributesToIndex to searchableAttributes