halide · alexreinking · Aug 20, 2023 · Aug 20, 2023 · Aug 20, 2023 · Aug 20, 2023
diff --git a/CMakeLists.txt b/CMakeLists.txt
@@ -1,4 +1,12 @@
-cmake_minimum_required(VERSION 3.22...3.23)
+cmake_minimum_required(VERSION 3.24)
+
+# Use our dependency provider by default, but make it easy to
+# override
+
+if (NOT DEFINED CMAKE_PROJECT_TOP_LEVEL_INCLUDES)
+    set(CMAKE_PROJECT_TOP_LEVEL_INCLUDES "${CMAKE_CURRENT_LIST_DIR}/cmake/dependencies.cmake")
+endif ()
+
 project(Halide
         VERSION 17.0.0
         DESCRIPTION "Halide compiler and libraries"

diff --git a/README.md b/README.md
@@ -185,6 +185,9 @@ If you wish to build Halide in a separate directory, you can do that like so:
 
 # Building Halide with CMake
 
+Halide requires CMake 3.24 or newer. For guidance on installing a recent CMake
+version, please see [README_cmake.md](./README_cmake.md#installing-cmake).
+
 ### MacOS and Linux
 
 Follow the above instructions to build LLVM or acquire a suitable binary

diff --git a/README_cmake.md b/README_cmake.md
@@ -67,12 +67,11 @@ we strongly suggest reading through the [CMake documentation][cmake-docs] first.
 
 ## Installing CMake
 
-Halide requires at least version 3.22, which was released in November 2021.
-Fortunately, getting a recent version of CMake couldn't be easier, and there are
-multiple good options on any system to do so. Generally, one should always have
-the most recent version of CMake installed system-wide. CMake is committed to
-backwards compatibility and even the most recent release can build projects over
-a decade old.
+Halide requires at least version 3.24. Fortunately, getting a recent version of
+CMake is easy, and there are multiple good options on any system to do so.
+Generally, one should always have the most recent version of CMake installed
+system-wide. CMake is committed to backwards compatibility and even the most
+recent release can build projects over a decade old.
 
 ### Cross-platform
 
@@ -90,13 +89,14 @@ See the [PyPI website][pypi-cmake] for more details.
 
 On Windows, there are three primary methods for installing an up-to-date CMake:
 
-1. If you have Visual Studio 2019 installed, you can get CMake 3.17 through the
-   Visual Studio installer. This is the recommended way of getting CMake if you
-   are able to use Visual Studio 2019. See Microsoft's
-   [documentation][vs2019-cmake-docs] for more details.
-2. If you use [Chocolatey][chocolatey], its [CMake package][choco-cmake] is kept
+1. If you have Visual Studio installed, you can get a recent CMake version through
+   the Visual Studio installer. This is the recommended way of getting CMake if you
+   are able to use Visual Studio 2019. See Microsoft's [documentation][vs2019-cmake-docs]
+   for more details.
+2. On Windows 11 and newer, `winget install cmake` should work out of the box.
+3. If you use [Chocolatey][chocolatey], its [CMake package][choco-cmake] is kept
    up to date. It should be as simple as `choco install cmake`.
-3. Otherwise, you should install CMake from [Kitware's website][cmake-download].
+4. Otherwise, you should install CMake from [Kitware's website][cmake-download].
 
 ### macOS
 
@@ -116,18 +116,13 @@ is also a viable option.
 
 There are a few good ways to install a modern CMake on Ubuntu:
 
-1. If you're on Ubuntu Linux 22.04 (Jammy Jellyfish), then simply running
-   `sudo apt install cmake` will get you CMake 3.22.
-2. If you are on an older Ubuntu release or would like to use the newest CMake,
-   try installing via the snap store: `snap install cmake`. Be sure you do not
-   already have `cmake` installed via APT. The snap package automatically stays
-   up to date.
-3. For older versions of Debian, Ubuntu, Mint, and derivatives, Kitware provides
-   an [APT repository][cmake-apt] with up-to-date releases. Note that this is
-   still useful for Ubuntu 20.04 because it will remain up to date.
-4. If all else fails, you might need to build CMake from source (eg. on old
-   Ubuntu versions running on ARM). In that case, follow the directions posted
-   on [Kitware's website][cmake-from-source].
+1. On any Ubuntu release, you can get the newest CMake via the snap
+   store: `snap install cmake`. Be sure you do not already have `cmake` installed
+   via APT. The snap package automatically stays up to date.
+2. If you do not wish to use Snap, Kitware provides an [APT repository][cmake-apt]
+   with up-to-date releases. Compatible with Debian, Ubuntu, Mint, and derivatives.
+3. If all else fails, you might need to build CMake from source. In that case,
+   follow the directions posted on [Kitware's website][cmake-from-source].
 
 For other Linux distributions, check with your distribution's package manager or
 use pip as detailed above. Snap packages might also be available.
@@ -575,7 +570,7 @@ No matter how you intend to use Halide, you will need some basic CMake
 boilerplate.
 
 ```cmake
-cmake_minimum_required(VERSION 3.22)
+cmake_minimum_required(VERSION 3.24)
 project(HalideExample)
 
 set(CMAKE_CXX_STANDARD 17)  # or newer

diff --git a/apps/CMakeLists.txt b/apps/CMakeLists.txt
@@ -2,7 +2,7 @@
 # Test apps from the perspective of a consuming project.
 ##
 
-cmake_minimum_required(VERSION 3.22)
+cmake_minimum_required(VERSION 3.24)
 project(Halide_apps)
 
 enable_testing()

diff --git a/apps/HelloBaremetal/CMakeLists.txt b/apps/HelloBaremetal/CMakeLists.txt
@@ -1,4 +1,4 @@
-cmake_minimum_required(VERSION 3.22)
+cmake_minimum_required(VERSION 3.24)
 
 project(HelloBaremetal)
 

diff --git a/apps/HelloBaremetal/cmake-external_project/CMakeLists.txt b/apps/HelloBaremetal/cmake-external_project/CMakeLists.txt
@@ -1,4 +1,4 @@
-cmake_minimum_required(VERSION 3.22)
+cmake_minimum_required(VERSION 3.24)
 
 # Enable assembly language (.s) support additionally
 project(HelloBaremetal LANGUAGES C CXX ASM)

diff --git a/apps/HelloBaremetal/cmake-external_project/generator/CMakeLists.txt b/apps/HelloBaremetal/cmake-external_project/generator/CMakeLists.txt
@@ -1,4 +1,4 @@
-cmake_minimum_required(VERSION 3.22)
+cmake_minimum_required(VERSION 3.24)
 
 project(HelloBaremetal-gen)
 

diff --git a/apps/HelloBaremetal/cmake-super_build/CMakeLists.txt b/apps/HelloBaremetal/cmake-super_build/CMakeLists.txt
@@ -1,4 +1,4 @@
-cmake_minimum_required(VERSION 3.22)
+cmake_minimum_required(VERSION 3.24)
 
 project(HelloBaremetal-Super)
 

diff --git a/apps/HelloBaremetal/cmake-super_build/app/CMakeLists.txt b/apps/HelloBaremetal/cmake-super_build/app/CMakeLists.txt
@@ -1,4 +1,4 @@
-cmake_minimum_required(VERSION 3.22)
+cmake_minimum_required(VERSION 3.24)
 
 # Enable assembly language (.s) support additionally
 project(HelloBaremetal-app LANGUAGES C CXX ASM)

diff --git a/apps/HelloBaremetal/cmake-super_build/generator/CMakeLists.txt b/apps/HelloBaremetal/cmake-super_build/generator/CMakeLists.txt
@@ -1,4 +1,4 @@
-cmake_minimum_required(VERSION 3.22)
+cmake_minimum_required(VERSION 3.24)
 
 project(HelloBaremetal-gen)
 

diff --git a/apps/HelloBaremetal/cmake-twice/CMakeLists.txt b/apps/HelloBaremetal/cmake-twice/CMakeLists.txt
@@ -1,4 +1,4 @@
-cmake_minimum_required(VERSION 3.22)
+cmake_minimum_required(VERSION 3.24)
 
 # Enable assembly language (.s) support additionally
 project(HelloBaremetal LANGUAGES C CXX ASM)

diff --git a/apps/HelloWasm/CMakeLists.txt b/apps/HelloWasm/CMakeLists.txt
@@ -1,4 +1,4 @@
-cmake_minimum_required(VERSION 3.22)
+cmake_minimum_required(VERSION 3.24)
 project(HelloWasm)
 
 enable_testing()

diff --git a/apps/bgu/CMakeLists.txt b/apps/bgu/CMakeLists.txt
@@ -1,4 +1,4 @@
-cmake_minimum_required(VERSION 3.22)
+cmake_minimum_required(VERSION 3.24)
 project(bgu)
 
 enable_testing()

diff --git a/apps/bilateral_grid/CMakeLists.txt b/apps/bilateral_grid/CMakeLists.txt
@@ -1,4 +1,4 @@
-cmake_minimum_required(VERSION 3.22)
+cmake_minimum_required(VERSION 3.24)
 project(bilateral_grid)
 
 enable_testing()

diff --git a/apps/blur/CMakeLists.txt b/apps/blur/CMakeLists.txt
@@ -1,4 +1,4 @@
-cmake_minimum_required(VERSION 3.22)
+cmake_minimum_required(VERSION 3.24)
 project(blur)
 
 enable_testing()

diff --git a/apps/c_backend/CMakeLists.txt b/apps/c_backend/CMakeLists.txt
@@ -1,4 +1,4 @@
-cmake_minimum_required(VERSION 3.22)
+cmake_minimum_required(VERSION 3.24)
 project(c_backend)
 
 enable_testing()

diff --git a/apps/camera_pipe/CMakeLists.txt b/apps/camera_pipe/CMakeLists.txt
@@ -1,4 +1,4 @@
-cmake_minimum_required(VERSION 3.22)
+cmake_minimum_required(VERSION 3.24)
 project(camera_pipe)
 
 enable_testing()

diff --git a/apps/compositing/CMakeLists.txt b/apps/compositing/CMakeLists.txt
@@ -1,4 +1,4 @@
-cmake_minimum_required(VERSION 3.22)
+cmake_minimum_required(VERSION 3.24)
 project(compositing)
 
 enable_testing()

diff --git a/apps/conv_layer/CMakeLists.txt b/apps/conv_layer/CMakeLists.txt
@@ -1,4 +1,4 @@
-cmake_minimum_required(VERSION 3.22)
+cmake_minimum_required(VERSION 3.24)
 project(conv_layer)
 
 enable_testing()

diff --git a/apps/cuda_mat_mul/CMakeLists.txt b/apps/cuda_mat_mul/CMakeLists.txt
@@ -1,4 +1,4 @@
-cmake_minimum_required(VERSION 3.22)
+cmake_minimum_required(VERSION 3.24)
 project(cuda_mat_mul)
 
 # This just checks whether CUDA is available ahead of time to allow

diff --git a/apps/depthwise_separable_conv/CMakeLists.txt b/apps/depthwise_separable_conv/CMakeLists.txt
@@ -1,4 +1,4 @@
-cmake_minimum_required(VERSION 3.22)
+cmake_minimum_required(VERSION 3.24)
 project(depthwise_separable_conv)
 
 enable_testing()

diff --git a/apps/fft/CMakeLists.txt b/apps/fft/CMakeLists.txt
@@ -1,4 +1,4 @@
-cmake_minimum_required(VERSION 3.22)
+cmake_minimum_required(VERSION 3.24)
 project(fft)
 
 enable_testing()

diff --git a/apps/hannk/CMakeLists.txt b/apps/hannk/CMakeLists.txt
@@ -1,4 +1,4 @@
-cmake_minimum_required(VERSION 3.22)
+cmake_minimum_required(VERSION 3.24)
 project(hannk)
 
 # We need to set this for some of the subprojects pulled in by TFLite (eg flatbuffers)

diff --git a/apps/hannk/cmake/superbuild/CMakeLists.txt b/apps/hannk/cmake/superbuild/CMakeLists.txt
@@ -1,4 +1,4 @@
-cmake_minimum_required(VERSION 3.22...3.23)
+cmake_minimum_required(VERSION 3.24)
 project(hannk_superbuild LANGUAGES NONE)
 
 ##

diff --git a/apps/harris/CMakeLists.txt b/apps/harris/CMakeLists.txt
@@ -1,4 +1,4 @@
-cmake_minimum_required(VERSION 3.22)
+cmake_minimum_required(VERSION 3.24)
 project(harris)
 
 enable_testing()

diff --git a/apps/hist/CMakeLists.txt b/apps/hist/CMakeLists.txt
@@ -1,4 +1,4 @@
-cmake_minimum_required(VERSION 3.22)
+cmake_minimum_required(VERSION 3.24)
 project(hist)
 
 enable_testing()

diff --git a/apps/iir_blur/CMakeLists.txt b/apps/iir_blur/CMakeLists.txt
@@ -1,4 +1,4 @@
-cmake_minimum_required(VERSION 3.22)
+cmake_minimum_required(VERSION 3.24)
 project(iir_blur)
 
 enable_testing()

diff --git a/apps/interpolate/CMakeLists.txt b/apps/interpolate/CMakeLists.txt
@@ -1,4 +1,4 @@
-cmake_minimum_required(VERSION 3.22)
+cmake_minimum_required(VERSION 3.24)
 project(interpolate)
 
 enable_testing()

diff --git a/apps/lens_blur/CMakeLists.txt b/apps/lens_blur/CMakeLists.txt
@@ -1,4 +1,4 @@
-cmake_minimum_required(VERSION 3.22)
+cmake_minimum_required(VERSION 3.24)
 project(lens_blur)
 
 enable_testing()

diff --git a/apps/linear_algebra/CMakeLists.txt b/apps/linear_algebra/CMakeLists.txt
@@ -1,4 +1,4 @@
-cmake_minimum_required(VERSION 3.22)
+cmake_minimum_required(VERSION 3.24)
 project(linear_algebra)
 
 enable_testing()

diff --git a/apps/local_laplacian/CMakeLists.txt b/apps/local_laplacian/CMakeLists.txt
@@ -1,4 +1,4 @@
-cmake_minimum_required(VERSION 3.22)
+cmake_minimum_required(VERSION 3.24)
 project(local_laplacian)
 
 enable_testing()

diff --git a/apps/max_filter/CMakeLists.txt b/apps/max_filter/CMakeLists.txt
@@ -1,4 +1,4 @@
-cmake_minimum_required(VERSION 3.22)
+cmake_minimum_required(VERSION 3.24)
 project(max_filter)
 
 enable_testing()

diff --git a/apps/nl_means/CMakeLists.txt b/apps/nl_means/CMakeLists.txt
@@ -1,4 +1,4 @@
-cmake_minimum_required(VERSION 3.22)
+cmake_minimum_required(VERSION 3.24)
 project(nl_means)
 
 enable_testing()

diff --git a/apps/resize/CMakeLists.txt b/apps/resize/CMakeLists.txt
@@ -1,4 +1,4 @@
-cmake_minimum_required(VERSION 3.22)
+cmake_minimum_required(VERSION 3.24)
 project(resize)
 
 enable_testing()

diff --git a/apps/stencil_chain/CMakeLists.txt b/apps/stencil_chain/CMakeLists.txt
@@ -1,4 +1,4 @@
-cmake_minimum_required(VERSION 3.22)
+cmake_minimum_required(VERSION 3.24)
 project(stencil_chain)
 
 enable_testing()

diff --git a/apps/unsharp/CMakeLists.txt b/apps/unsharp/CMakeLists.txt
@@ -1,4 +1,4 @@
-cmake_minimum_required(VERSION 3.22)
+cmake_minimum_required(VERSION 3.24)
 project(unsharp)
 
 enable_testing()

diff --git a/apps/wavelet/CMakeLists.txt b/apps/wavelet/CMakeLists.txt
@@ -1,4 +1,4 @@
-cmake_minimum_required(VERSION 3.22)
+cmake_minimum_required(VERSION 3.24)
 project(wavelet)
 
 enable_testing()

diff --git a/cmake/BundleStatic.cmake b/cmake/BundleStatic.cmake
@@ -1,4 +1,4 @@
-cmake_minimum_required(VERSION 3.22)
+cmake_minimum_required(VERSION 3.24)
 
 ##
 # This module provides a utility for bundling a set of IMPORTED

diff --git a/cmake/FindHalide_WebGPU.cmake b/cmake/FindHalide_WebGPU.cmake
@@ -1,4 +1,4 @@
-cmake_minimum_required(VERSION 3.22)
+cmake_minimum_required(VERSION 3.24)
 
 # tip: uncomment this line to get better debugging information if find_library() fails
 # set(CMAKE_FIND_DEBUG_MODE TRUE)

diff --git a/cmake/HalideGeneratorHelpers.cmake b/cmake/HalideGeneratorHelpers.cmake
@@ -1,4 +1,4 @@
-cmake_minimum_required(VERSION 3.22)
+cmake_minimum_required(VERSION 3.24)
 
 option(Halide_NO_DEFAULT_FLAGS "When enabled, suppresses recommended flags in add_halide_generator" OFF)
 

diff --git a/cmake/HalideTargetHelpers.cmake b/cmake/HalideTargetHelpers.cmake
@@ -1,4 +1,4 @@
-cmake_minimum_required(VERSION 3.22)
+cmake_minimum_required(VERSION 3.24)
 
 ##
 # Utilities for manipulating Halide target triples

diff --git a/cmake/TargetExportScript.cmake b/cmake/TargetExportScript.cmake
@@ -1,4 +1,4 @@
-cmake_minimum_required(VERSION 3.22)
+cmake_minimum_required(VERSION 3.24)
 
 include(CheckLinkerFlag)