Changes

Since version 0.5.0

Fixes

• Fix crash when trying to create ViewModels with zero constructor arguments
• Fix crash when requesting activityViewModel from a fragment.
• Add consumer proguard rules to vector module
• Fix improper ViewModel instantiation when factory does not implement create method
• withState actions are now treated as side-effects
• Make Kotlin, Fragment, ViewModel SavedState and Coroutines libraries part
  of the public API in Gradle

New Features

• New Documentation website covering components of this library, as well as real world usage scenarios.
• A brand new StateProcessor built using the select expression
• Add a new simple sample app to the repository

A lot of new features in this release, including automatic ViewModel creation, support for assisted inject factories, and more.

New:

• Add new viewmodel delegates for Fragments and Activities for automatic viewmodel
  creation.
• Better support for libraries such as AssistedInject, because of overloaded versions of
  viewmodel delegates which accept a factory lambda for the viewmodel.
• Easier state persistence in SavedStateVectorViewModel, using the new KEY_SAVED_STATE
  for storing state objects in the saved state handle and a new setStateAndPersist method.
• Migrate Sample app to use Dagger and AssistedInject

Other:

• Deprecate setInitialState method
• Reflection benchmarks in the benchmark module

The library is stuck on androidx.lifecycle v2.2.0-alpha04 for now because of a SavedStateController bug in version 2.2.0-alpha05.

There is a ton of new stuff in this release. Please file issues if you have a bug report or a feature request.

Features:

• Add SavedStateVectorViewModel which has access to SavedStateHandle to easily persist state
• Change LiveData based state observable from VectorViewModel to a Kotlin Flow based observable
• Updated sample app with support for editing entities

Fixes:

• Remove unused Fragment dependency from vector module

Deprecations:

• Deprecate renderState() method in VectorFragment in favour or a parameterized implementation

New:

• Internal refactoring of StateStore into sub-components
• Target Android Q
• Update to Coroutines 1.3.0-RC

Features

• Add logging feature. StateStore and ViewModel now log state changes if
  logging is enabled
• Update Kotlin to 1.3.40

Fixes

• Fix CoroutineScope in Application class of Sample app
• Update Android Gradle Plugin and sample app dependencies

New features:

• StateStore is now built using Coroutine Actors, performance is much improved.
• setState and withState in VectorViewModel are no longer suspend functions, so they can be called outside a coroutine scope as well.

Fixes:

• Fix implementation of CoroutineScope in VectorFragment

Misc:

• Sample app now handles state persistence in the AddEntityFragment

Any community contributions are welcome.

This is the initial release of Vector. Please provide us with any feedback or suggestions you may have.

Contributions are welcome.