diff --git a/BREAKING_CHANGES.md b/BREAKING_CHANGES.md index ddb05cd32c..8ffdf20477 100644 --- a/BREAKING_CHANGES.md +++ b/BREAKING_CHANGES.md @@ -2,6 +2,33 @@ # Version 8.0.0 +## Change + +The minimum supported compilers and deployment targets have been updated, with +the new minimums listed in the top level [README](README.md). + +MinGW is no longer supported. + +**Possible Issues** + +You may no longer be able to build JUCE projects or continue targeting older +platforms. + +**Workaround** + +If you cannot build your project, update your build machine to a more modern +operating system and compiler. + +There is no workaround to target platforms that predate the new minimum +deployment targets. + +**Rationale** + +New features of JUCE require both more modern compilers and deployment targets. + +The amount of investment MinGW support requires is unsustainable. + + ## Change The [JUCE End User Licence Agreement](https://juce.com/legal/juce-8-licence/) diff --git a/README.md b/README.md index a1e1cdbfd3..871d7e4a9d 100644 --- a/README.md +++ b/README.md @@ -1,17 +1,17 @@ ![alt text](https://assets.juce.com/juce/JUCE_banner_github.png "JUCE") -JUCE is an open-source cross-platform C++ application framework for creating high quality +JUCE is an open-source cross-platform C++ application framework for creating desktop and mobile applications, including VST, VST3, AU, AUv3, AAX and LV2 audio plug-ins and plug-in hosts. JUCE can be easily integrated with existing projects via CMake, or can be used as a project generation tool via the [Projucer](#the-projucer), which supports -exporting projects for Xcode (macOS and iOS), Visual Studio, Android Studio, Code::Blocks +exporting projects for Xcode (macOS and iOS), Visual Studio, Android Studio, and Linux Makefiles as well as containing a source code editor. ## Getting Started The JUCE repository contains a [master](https://github.com/juce-framework/JUCE/tree/master) and [develop](https://github.com/juce-framework/JUCE/tree/develop) branch. The develop branch -contains the latest bugfixes and features and is periodically merged into the master +contains the latest bug fixes and features and is periodically merged into the master branch in stable [tagged releases](https://github.com/juce-framework/JUCE/releases) (the latest release containing pre-built binaries can be also downloaded from the [JUCE website](https://juce.com/get-juce)). @@ -22,12 +22,14 @@ tool) or with CMake. ### The Projucer The repository doesn't contain a pre-built Projucer so you will need to build it -for your platform - Xcode, Visual Studio and Linux Makefile projects are located in -[extras/Projucer/Builds](/extras/Projucer/Builds) -(the minimum system requirements are listed in the __System Requirements__ section below). -The Projucer can then be used to create new JUCE projects, view tutorials and run examples. -It is also possible to include the JUCE modules source code in an existing project directly, -or build them into a static or dynamic library which can be linked into a project. +for your platform - Xcode, Visual Studio and Linux Makefile projects are located +in [extras/Projucer/Builds](/extras/Projucer/Builds) (the minimum system +requirements are listed in the [minimum system +requirements](#minimum-system-requirements) section below). The Projucer can +then be used to create new JUCE projects, view tutorials and run examples. It +is also possible to include the JUCE modules source code in an existing project +directly, or build them into a static or dynamic library which can be linked +into a project. For further help getting started, please refer to the JUCE [documentation](https://juce.com/learn/documentation) and @@ -56,20 +58,20 @@ of the target you wish to build. #### Building JUCE Projects -- __C++ Standard__: 17+ -- __macOS/iOS__: Xcode 10.1 (macOS 10.13.6) -- __Windows__: Windows 8.1 and Visual Studio 2017 +- __C++ Standard__: 17 +- __macOS/iOS__: Xcode 12.4 (Intel macOS 10.15.4, Apple Silicon macOS 11.0) +- __Windows__: Visual Studio 2019 (Windows 10) - __Linux__: g++ 7.0 or Clang 6.0 (for a full list of dependencies, see [here](/docs/Linux%20Dependencies.md)). -- __Android__: Android Studio on Windows, macOS or Linux +- __Android__: Android Studio (NDK 26) on Windows, macOS or Linux #### Deployment Targets -- __macOS__: macOS 10.9 -- __Windows__: Windows Vista +- __macOS__: macOS 10.11 +- __Windows__: Windows 10 - __Linux__: Mainstream Linux distributions -- __iOS__: iOS 9.0 -- __Android__: Jelly Bean (API 16) +- __iOS__: iOS 12 +- __Android__: Android 5 - Lollipop (API Level 21) ## Contributing