Changelog

Dependency changes

• Building for Android now requires CMake 3.7 with builtin Android crosscompilation support, the old toolchains were removed. Only the Clang and libc++ toolchain is now supported, support for GCC and libstdc++ was dropped, as it was still missing some important C++11 functionality. See Cross-compiling for Android for more information.

New features

• New CORRADE_PLUGINMANAGER_NO_DYNAMIC_PLUGIN_SUPPORT preprocessor #define and CMake variable for easier distinction of platforms without dynamic plugin loading support

Build system

• Stable version of Corrade is now available as a binary package in the ArchLinux [community] repo
• Homebrew macOS packages were updated to install the stable version by default
• Fixed the Debian package to not include a revision. While just a warning on Ubuntu, it's a hard error on Debian. (See mosra/corrade#44.)

Bug fixes

• The Android ADB test runner was not correctly propagating TestSuite CORRADE_TEST_* environment variables to the executable
• Wrong destruction order of PluginManager::Manager instances could lead to an infinite loop if cross-manager plugin dependencies were involved. Now an assertion fires instead.
• Fixed usage of Utility::ConfigurationValue specializations to support types without default constructors and be able to return non-default-constructed instances for empty values.

Deprecated APIs

• The Corrade/Utility/AndroidStreamBuffer.h header is deprecated, use Corrade/Utility/AndroidLogStreamBuffer.h instead
• PluginManager::Manager::instance() is deprecated as it has a confusing naming, use PluginManager::Manager::instantiate() instead

Potential compatibility breakages, removed APIs

• Removed the unnecessarily opaque CORRADE_PLUGIN_INTERFACE() macro. Define a public static std::string pluginInterface() function instead. See PluginManager::AbstractPlugin for more information.
• Moved the CORRADE_PLUGIN_REGISTER() macro to Corrade/PluginManager/AbstractManager.h from Corrade/PluginManager/AbstractPlugin.h to reduce header dependencies

Documentation

• A new Developers guide page containing step-by-step checklists for maintainers and core developers
• Updating the docs with compiled code snippets to ensure they don't get out of sync with the code
• Various documentation updates, clarifications and fixes

Dependency changes

• Completely removed NaCl support (see https://blog.chromium.org/2017/05/goodbye-pnacl-hello-webassembly.html)
• Dropped support for the old MinGW32 (only MinGW-w64 is supported now)
• Bumped minimal CMake version to 2.8.12
• Removed support for OSX 10.8 and older
• Dropped the compatibility branch and all support for MSVC 2013 and GCC < 4.7

New features

• MSVC 2015 and 2017 support in master branch. It needs some workarounds, thus the compatibility is controlled using MSVC2015_COMPATIBILITY / MSVC2017_COMPATIBILITY CMake option, which is then exposed as CORRADE_MSVC2015_COMPATIBILITY / CORRADE_MSVC2017_COMPATIBILITY CMake variable and preprocessor macro. See mosra/corrade#34.
• Windows RT (Store/Phone) support. Builds for that platform have CORRADE_TARGET_WINDOWS_RT CMake variable and preprocessor macro defined.
• iOS support, integration of TestSuite with Xcode XCTest
• WebAssembly support when building for Emscripten

Changes and improvements

• Various updates and code modernization (see mosra/corrade#33)

Build system

• Continuous testing for Linux, OSX, Windows MSVC, Windows MinGW, Windows RT, iOS, Android and Emscripten on Travis CI and AppVeyor CI, with code coverage on codecov.io; replacing the unmaintained and outdated Jenkins configuration
• Support for CMake subprojects. You can now clone Corrade into a subdirectory in your project and add it using add_subdirectory(). The find_package() command will then use the CMake subproject instead of looking for it in system-wide locations.
• Reworked CMake buildsystem to use the new imported target workflow, see Using Corrade with CMake for more information
• CMake targets are now organized in folders for better development experience in IDEs such as Visual Studio or Xcode
• Enabling -Wmissing-prototypes warning on Clang when CORRADE_USE_PEDANTIC_FLAGS property is enabled
• It's now possible to build only parts of the library using WITH_* CMake options and find_package() needs to request particular parts of the library that are used; see Downloading and building Corrade and Using Corrade with CMake for more information
• corrade_add_plugin() now properly installs plugin *.dll to bin/ and *.lib to lib/ on Windows
• Added Homebrew package (see mosra/corrade#22)
• Added corrade_find_dlls_for_libs() CMake macro
• MACOSX_RPATH is now enabled by default on CMake 3.0+
• Enabling only C++ in CMake project() call, if possible, to speed up initial CMake run
• Fixed building on TDM-GCC (see mosra/corrade#35)
• Fixed various MSVC compilation issues (see mosra/corrade#28)
• Various fixes for builds without deprecated features enabled (see mosra/corrade#24, mosra/corrade#32)
• Properly passing /std:c++14 or /std:c++14 when CORRADE_CXX_STANDARD is set to 14 or 17

Bug fixes

• Containers::ArrayView::data() on non-const data now properly returns non-const pointer
• Worked around function template merging on MSVC, which caused different signals being merged into one in Interconnect library
• Added a workaround to interface macro defined by windows.h that broke PluginManager headers
• Calling CORRADE_EXPECT_FAIL() more than once in a single block caused multiple definition errors
• Second row in Utility::Arguments help output was not properly indented for named arguments
• Prefixed Utility::Arguments failed on encountering value starting with -
• Utility::Directory::mkpath() now properly returns false if path creation fails
• Fixed Utility::Directory::rm() for directories on Emscripten
• Fixed unaligned reads and iterative digesting in Utility::Sha1
• Properly re-running CMake and updating dependencies when resource configuration file added by corrade_add_resource() changes
• Fixed Containers::LinkedList::move() called on an item itself

Deprecated APIs

• Containers::ArrayReference is deprecated, use the shorter Containers::ArrayView name instead
• Containers::Array::zeroInitialized() is deprecated, use Containers::Array::Array(ValueInitT, std::size_t) instead
• Containers::Array::from() is deprecated, use Containers::Array::Array(InPlaceInitT, std::initializer_list<T>) instead
• Utility::Arguments::setHelpKey() is deprecated as its functionality was merged into Utility::Arguments::setHelp()
• Utility::Debug::setOutput() is deprecated and superseded by scoped output, see Utility::Debug class documentation for more information
• Utility::sleep() is deprecated, use Utility::System::sleep() instead
• CORRADE_*_LIBRARIES, CORRADE_*_INCLUDE_DIRS and CORRADE_RC_EXECUTABLE CMake variables are deprecated in favor of Corrade::* imported targets, CORRADE_CXX_FLAGS is deprecated in favor of CORRADE_CXX_STANDARD and CORRADE_USE_PEDANTIC_FLAGS properties. See Using Corrade with CMake for more information.

Potential compatibility breakages, removed APIs

• PluginManager::AbstractPlugin now takes plugin name via const& instead of by-value
• Reversed parameter order of CORRADE_EXPECT_FAIL_IF() to be more intuitive
• The Utility::Debug::setFlags() function was removed, use Utility::Debug::nospace and Utility::Debug::noNewlineAtTheEnd() instead
• The Utility::Directory, Utility::String and Utility::Unicode classes are now a namespace (might break using declarations, but otherwise it's fully source-compatible)
• corrade_add_test() CMake macro now calls target_link_libraries() with explicit PRIVATE keyword, meaning the users also have to specify PUBLIC/PRIVATE/INTERFACE when calling target_link_libraries() on a test
• All path handling functions in Utility::Directory consistently return and expect only forward slashes as directory separators

Documentation

• New documentation theme powered by m.css and related massive updates of everything
• Various updates and clarifications to the Coding style page
• All example code is put into public domain (or UNLICENSE) to free you from any legal obstacles when reusing the code in your apps.
• The Downloading and building Corrade documentation now prefers package installation instead of manual build
• Documented how to use Vcpkg packages
• Various other updates (see mosra/corrade#26, mosra/corrade#30)

Changelogs for previous versions are available in Archived changelogs.