View Source Changelog

v0.9.2 - 2024-03-04

  • Updates
    • Improve error message when an OTP application isn't found when building the OTP release script. It's usually due to a dependency typo or wrong targets spec, so point to that.

v0.9.1 - 2022-04-04

  • Updates
    • Improve detection of invalid applications being passed in the :init and :last options.
    • Fall back to a reasonable default when trying to get application modes from the release options. This fixes an exception when building the release.
    • Support release configuration via the release options in a project's mix.exs. Add a :shoehorn key to the release parameters to set :init, :last or the :exxtra_dependencies options.

v0.9.0 - 2022-04-03

This is a major update to Shoehorn that includes breaking changes:

  • The :init configuration option only supports applications now. MFAs are no longer supported and moved to runtime.exs or an Application.start callback.
  • References to use Shoehorn.Handler need to be updated to @behaviour Shoehorn.Handler. This may require implementing additional functions.
  • Elixir 1.9 is no longer supported. Please update to Elixir 1.10 or later.

The main update to Shoehorn is to move all application startup to the boot script. This noticeably improves boot time on many Nerves platforms due to boot scripts being able to load files without traversing the entire Erlang module path list. These traversals are amazingly slow (sometimes seconds) due to a combination of SquashFS slowness in this area and slow overall IO.

Using boot scripts to load all applications has some important improvements in addition to performance:

  • Application start order is deterministic and computed at compile-time. If you want to see the order, take a look at the end of the shoehorn.script in your release directory.
  • Shoehorn alphabetizes the start of applications that could be ordered arbitrarily. This minimizes changes in start ordering when dependencies are added or removed.
  • It enables experimental features like providing additional dependencies (using the :extra_dependencies configuration key) or hinting that dependencies get started as late as possible (the :last configuration key)
  • You can remove the :app configuration key from your Shoehorn configuration. It's no longer needed.

Aside from the change from a macro to a behaviour and possibly needing to implement callback functions, Shoehorn.Handler implementations work the same as before.

v0.8.0 - 2021-10-31

Shoehorn v0.8.0 completely removes support for Distillery.

v0.7.0

Shoehorn 0.7.0 removes support for creating boot scripts using Distillery and only supports using Elixir releases. As a result, the minimum supported version of Elixir is now version 1.9.

v0.6.0

  • Enhancements
    • Added support for Elixir 1.9+ releases.
    • Distillery is now an optional dependency and ~> 2.1.
    • Updated supervisor specs and cleaned up warnings.

v0.5.0

  • Enhancements
    • Exclude distillery, artificery, and mix from the release by default.
    • Removed RPC and application overlay modules.
    • Updated deps and docs.

v0.4.0

  • Enhancements
    • Support for distillery ~> 2.0
    • Support for Elixir ~> 1.7

v0.3.1

For Shoehorn, these are our goals: 1: Fix current issue with prod devices turning to zombies 2: Make it really really difficult to enter a brick state ever.

It was becoming apparent that it is difficult to address goal #1 by changing the defaults without impacting goal #2 at all. We believe that its best to solve goal #1 by opting in and not by modifying the defaults.

In this release, existing projects that do not declare a handler in the config will use Shoehorn.Handler.Ignore.

v0.3.0

The default strategy for how Shoehorn handles OTP application exits has changed. Before this release, if an application were to exit the node would remain running and that applications would remain stopped. This may be desireable for development and test but is typically undesirable in production. This behaviour can be customized by configuring the handler in the config. For example, in dev you can use the module Shoehorn.Handler.Ignore to prevent the node from halting on failure.

  # config/dev.exs

  config :shoehorn,
    handler: Shoehorn.Handler.Ignore

Check out the example application for information on implementing custom strategies.

v0.2.0

Renamed project Shoehorn. It became hard to discuss this project with the name Bootloader.

  • Enhancements
    • :init list can contain :application, {m, f, a}, or {Module, [args]}.

v0.1.3

  • Bug Fixes
    • Add explicit functions for each of the Distillery Plugin behaviour callbacks.

v0.1.2

  • Bug Fixes
    • Only look in :code.lib_dir() for the Application lib dir instead of involving mix
  • Enhancements
    • Warn when an app listed in :init or :app does not exist.
    • Output message about booting using shoehorn during mix release

v0.1.1

  • Bug Fixes
    • Fixed issue with release path being constructed incorrectly.

v0.1.0

Initial release to hex.