What's Changed

• Fix issue with child controllers frozen at detach time not re-attaching

Full Changelog: https://github.com/bluelinelabs/Conductor/compare/4.0.0-preview-3...4.0.0-preview-4

What's Changed

• Fix ConcurrentModificationException when manipulating backstack during instantiation by @EricKuck in https://github.com/bluelinelabs/Conductor/commit/4d4d8bfbd1cb328030c447701e498b18f91cb43a

Full Changelog: https://github.com/bluelinelabs/Conductor/compare/4.0.0-preview-2...4.0.0-preview-3

What's Changed

• Fix NPE when removing view reference by @MarioNoll in https://github.com/bluelinelabs/Conductor/pull/678

Full Changelog: https://github.com/bluelinelabs/Conductor/compare/3.1.6...3.1.7

What's Changed

• Convert dependencies to version catalogs by @EricKuck in https://github.com/bluelinelabs/Conductor/pull/675
• Add leak detection for destroyed controller views by @pyricau in https://github.com/bluelinelabs/Conductor/pull/676

New Contributors

• @pyricau made their first contribution in https://github.com/bluelinelabs/Conductor/pull/676

Full Changelog: https://github.com/bluelinelabs/Conductor/compare/3.1.5...3.1.6

What's Changed

• Fix issue where child controllers may not get their onPause event soon enough by @EricKuck in https://github.com/bluelinelabs/Conductor/pull/672
• Set awaitingParentAttach to false on detach, even if not currently attached by @EricKuck in https://github.com/bluelinelabs/Conductor/pull/673
• Fix edge case NPE when the user hits the back button very rapidly during state restoration by @EricKuck in https://github.com/bluelinelabs/Conductor/pull/674

Full Changelog: https://github.com/bluelinelabs/Conductor/compare/3.1.4...3.1.5

Full Changelog: https://github.com/bluelinelabs/Conductor/compare/3.1.3...3.1.4

What's Changed

• Add PopRootControllerMode to address Android 12 back button behavior by @EricKuck in https://github.com/bluelinelabs/Conductor/pull/663

Full Changelog: https://github.com/bluelinelabs/Conductor/compare/3.1.2...3.1.3

Full Changelog: https://github.com/bluelinelabs/Conductor/compare/3.1.1...3.1.2

What's Changed

• Update LeakCanary to 2.7. by @PaulWoitaschek in https://github.com/bluelinelabs/Conductor/pull/650
• Migrate to the maven-publish plugin. by @PaulWoitaschek in https://github.com/bluelinelabs/Conductor/pull/651
• Kotlin backstack by @PaulWoitaschek in https://github.com/bluelinelabs/Conductor/pull/652
• Apply the kotlin plugin to lint module; by @MarioNoll in https://github.com/bluelinelabs/Conductor/pull/653

Full Changelog: https://github.com/bluelinelabs/Conductor/compare/3.1.0...3.1.1

What's Changed

• Add basic support for compose. by @PaulWoitaschek in https://github.com/bluelinelabs/Conductor/pull/644

Full Changelog: https://github.com/bluelinelabs/Conductor/compare/3.0.1...3.1.0

Full Changelog: https://github.com/bluelinelabs/Conductor/compare/3.1.7...3.1.8

What's Changed

• Convert demo app to Kotlin w/ ViewBinding by @EricKuck in https://github.com/bluelinelabs/Conductor/pull/635

Full Changelog: https://github.com/bluelinelabs/Conductor/compare/3.0.0...3.0.1

What's Changed

• Specify the current api for the IssueRegistry. by @PaulWoitaschek in https://github.com/bluelinelabs/Conductor/pull/460
• Update AutoDispose to 1.0.0-RC2 by @ShaishavGandhi in https://github.com/bluelinelabs/Conductor/pull/469
• Fix README typos by @abyrnes in https://github.com/bluelinelabs/Conductor/pull/479
• Migrate to AndroidX. Fixes #490 by @PaulWoitaschek in https://github.com/bluelinelabs/Conductor/pull/492
• Upgrade AutoDispose to 1.0.0 by @ShaishavGandhi in https://github.com/bluelinelabs/Conductor/pull/497
• Fix MainActivity from leaking by releasing the listeners kept by handler by @xxfast in https://github.com/bluelinelabs/Conductor/pull/502
• Keep ControllerChangeHandler default constructor in Proguard rules by @DSteve595 in https://github.com/bluelinelabs/Conductor/pull/550
• Fix TransitionChangeHandlers getting stuck when two are run simultaneously by @DSteve595 in https://github.com/bluelinelabs/Conductor/pull/547
• Fixed outdated readme by @dtrabo in https://github.com/bluelinelabs/Conductor/pull/576
• Add androidx-transition module, update demos by @DSteve595 in https://github.com/bluelinelabs/Conductor/pull/584
• Fix #527, Memory leak in SharedElementTransitionChangeHandler by @chris-horner in https://github.com/bluelinelabs/Conductor/pull/528
• Fix Conductor pending changes lock, related to #287 discussion by @soniccat in https://github.com/bluelinelabs/Conductor/pull/570
• Fixed having a not attached child controller after popping back to the parent by @soniccat in https://github.com/bluelinelabs/Conductor/pull/571
• Introduce Kotlin (and Java 8) by @PaulWoitaschek in https://github.com/bluelinelabs/Conductor/pull/585
• Updated lint. by @PaulWoitaschek in https://github.com/bluelinelabs/Conductor/pull/587
• Add platform transition module by @chris-horner in https://github.com/bluelinelabs/Conductor/pull/591
• Fix ignore removesFromViewOnPush by @MatnazaroFF in https://github.com/bluelinelabs/Conductor/pull/600
• Fixes regression in pushing to child router while detached by @EricKuck in https://github.com/bluelinelabs/Conductor/pull/607
• Lint changehandler subclass fix by @PaulWoitaschek in https://github.com/bluelinelabs/Conductor/pull/627
• Don't remove host references on configuration changes by @EricKuck in https://github.com/bluelinelabs/Conductor/pull/629
• Adds ViewPager2 Adapter by @EricKuck in https://github.com/bluelinelabs/Conductor/pull/594

New Contributors

• @ShaishavGandhi made their first contribution in https://github.com/bluelinelabs/Conductor/pull/469
• @abyrnes made their first contribution in https://github.com/bluelinelabs/Conductor/pull/479
• @xxfast made their first contribution in https://github.com/bluelinelabs/Conductor/pull/502
• @DSteve595 made their first contribution in https://github.com/bluelinelabs/Conductor/pull/550
• @dtrabo made their first contribution in https://github.com/bluelinelabs/Conductor/pull/576
• @chris-horner made their first contribution in https://github.com/bluelinelabs/Conductor/pull/528
• @MatnazaroFF made their first contribution in https://github.com/bluelinelabs/Conductor/pull/600

Full Changelog: https://github.com/bluelinelabs/Conductor/compare/2.1.5...3.0.0

Conductor 4.0's second public preview

Updates from preview-1

• Removed LifecycleController and merged lifecycle support into the main Controller class
• Activity-hosted Routers now default to PopRootControllerMode.NEVER, which has always been the suggested setting.
• Removed first-party support for AutoDispose
• Added a back handling demo to the demo app

Predictive back opt-in updates

Changes needed to fully support predictive back gestures in your app:

• Call setOnBackPressedDispatcherEnabled(true) on your Activity's Router.
• Remove the override of onBackPressed() from the Activity. No replacement is needed.
• Opt in to predictive back gestures in your manifest file as shown here.
• Replace any override of handleBack(), which is now deprecated, with an OnBackPressedCallback. Example callback:

    onBackPressedDispatcher?.addCallback(lifecycleOwner, object : OnBackPressedCallback(enabled = true) {
      override fun handleOnBackPressed() {
        println("back handled")
      }
    })

Conductor 4.0's first public preview

Conductor 4.0 is coming soon. It is already being used in production with many, many millions of users. It is, however, not guaranteed to be API stable. As such, it is being released as a preview rather than a standard release. Preview in this context is not a commentary on stability. It is considered to be up to the same quality standards as the current 3.x stable release.

Other than some Kotlin migrations and dependency updates, there are two primary changes in this release:

Support for predictive back gestures

This is an opt-in change. If no changes are made in your codebase, you shouldn't experience any functionality changes.

Changes needed to fully support predictive back gestures in your app:

• Call both setPopRootControllerMode(PopRootControllerMode.NEVER) and setOnBackPressedDispatcherEnabled(true) on your Activity's Router.
• Remove the override of onBackPressed() from the Activity. No replacement is needed.
• Opt in to predictive back gestures in your manifest file as shown here
• Replace any override of handleBack(), which is now deprecated, with an OnBackPressedCallback. Example callback:

    // "this" must be a LifecycleOwner
    onBackPressedDispatcher?.addCallback(this, object : OnBackPressedCallback(enabled = true) {
      override fun handleOnBackPressed() {
        println("back handled")
      }
    })

AndroidX backing

This is an opt-out change, and is enabled by default. Conductor has historically relied on platform Fragments to receive lifecycle events. This has resulted in a few shortcomings as functionality has been added to AndroidX Fragments, but is only available in newer API versions for the platform versions. Conductor will now automatically use AndroidX backing under two conditions: your Activity extends FragmentActivity and allowExperimentalAndroidXBacking = false is not passed into the Conductor.attachRouter method.

What's Changed

• Don't pop the final controller in pager adapters. Fixes #681 by @EricKuck in https://github.com/bluelinelabs/Conductor/pull/682
• Make change start/end callbacks when parent controller is popped. Fixes #683 by @EricKuck in https://github.com/bluelinelabs/Conductor/pull/684

Full Changelog: https://github.com/bluelinelabs/Conductor/compare/3.1.9...3.2.0

What's Changed

• Update ancestor change listeners to prevent memory leak by @EricKuck in https://github.com/bluelinelabs/Conductor/pull/680

Full Changelog: https://github.com/bluelinelabs/Conductor/compare/3.1.8...3.1.9

• Lots and lots of bug fixes
• First official release with support for architecture components's lifecycle
• Added SharedElementTransitionChangeHandler, which handles transitions much more robustly
• Removed all synthetic accessors, lowering overall method count

• Added onContextAvailable and onContextUnavailable callback to controllers (helpful for dependency injection)

• Added modules for Autodispose and Architecture Components's Lifecycle

• Fixes issue where calling setBackstack repeatedly could result in a situation where multiple ControllerChangeHandlers are executing at the same time and interfering with each others states (#263)

• Fixes a case that caused the incorrect change handler to execute when setting the backstack (fixes #286)

• Now ensures that parent controller is restored after process death (fixes #300)

• Fixes issue when immediately creating two routers in the same Activity (fixes #299)

• Fixes attach state management when a controller is pushed while the Activity is paused. (Fixes #303)

• shouldShowRequestPermissionRationale now returns the correct result. Fixes #317

• Args are now restored to a controller after process death even if there is only a no-arg constructor. Fixes #313

• Fixes views never attaching if the host activity is stopped before inflation (#273)
• Now properly handles pushing and popping controllers immediately back-to-back (#274)
• Fixes horizontal change handlers in ViewPagers (#279)