[sdl2] Bump to 2.24.2 (#27591)

* [sdl2] Bump to 2.24.2.

* [sdl2] Add a usage file.

* [sdl2] Update baseline and version history.

* [sdl2] Update `SDL2_VERSION` variable.

* [sdl2] Update `HEAD_REF`.

* Use VERSION.

Co-authored-by: Billy Robert O'Neal III <bion@microsoft.com>

ports/sdl2/portfile.cmake

@@ -1,10 +1,10 @@
-set(SDL2_VERSION 2.24.1)
+vcpkg_minimum_required(VERSION 2022-10-12) # for ${VERSION}
 vcpkg_from_github(
     OUT_SOURCE_PATH SOURCE_PATH
     REPO libsdl-org/SDL
-    REF a1d1946dcba6509f0679f507b57e7b228d32e6f8 #vrelease-2.24.1
-    SHA512 78794c5142153d9d7516815f6e9b2c153ab3cab466cbc35635d27d9bb7cd9cbfa2bb66b63569454d2de89975eba8a662d79ccba87204a263ddbf0bfd339b6926
-    HEAD_REF master
+    REF release-${VERSION}
+    SHA512 4050afc804b65617f3e9097d5173edb05abd3a15872ad5c79bf85e874758c72ebf7ce9768eb1c9969099b1b82d04a1b65505774d0b851c0541e032da9b2e1ad1
+    HEAD_REF main
     PATCHES
         0001-sdl2-Enable-creation-of-pkg-cfg-file-on-windows.patch
         0002-sdl2-skip-ibus-on-linux.patch
@@ -114,4 +114,5 @@ endif()
 
 vcpkg_fixup_pkgconfig()
 
+file(INSTALL "${CMAKE_CURRENT_LIST_DIR}/usage" DESTINATION "${CURRENT_PACKAGES_DIR}/share/${PORT}")
 file(INSTALL "${SOURCE_PATH}/LICENSE.txt" DESTINATION "${CURRENT_PACKAGES_DIR}/share/${PORT}" RENAME copyright)

ports/sdl2/usage

@@ -0,0 +1,8 @@
+sdl2 provides CMake targets:
+
+    find_package(SDL2 CONFIG REQUIRED)
+    target_link_libraries(main
+        PRIVATE
+        $<TARGET_NAME_IF_EXISTS:SDL2::SDL2main>
+        $<IF:$<TARGET_EXISTS:SDL2::SDL2>,SDL2::SDL2,SDL2::SDL2-static>
+    )

ports/sdl2/vcpkg.json

@@ -1,6 +1,6 @@
 {
   "name": "sdl2",
-  "version": "2.24.1",
+  "version": "2.24.2",
   "description": "Simple DirectMedia Layer is a cross-platform development library designed to provide low level access to audio, keyboard, mouse, joystick, and graphics hardware via OpenGL and Direct3D.",
   "homepage": "https://www.libsdl.org/download-2.0.php",
   "license": "Zlib",

versions/baseline.json

@@ -6757,7 +6757,7 @@
       "port-version": 4
     },
     "sdl2": {
-      "baseline": "2.24.1",
+      "baseline": "2.24.2",
       "port-version": 0
     },
     "sdl2-gfx": {

versions/s-/sdl2.json

@@ -1,5 +1,10 @@
 {
   "versions": [
+    {
+      "git-tree": "e44330d071add4e1c92af34650cfc3b20642640f",
+      "version": "2.24.2",
+      "port-version": 0
+    },
     {
       "git-tree": "565601c4ca1fdc5656fa7c474f0a50af24073a0c",
       "version": "2.24.1",