cmake+xcode: add exports file for Apple

Author: madebr

.github/workflows/main.yml

@@ -18,7 +18,7 @@ jobs:
         - { name: Windows (MSVC),       os: windows-latest, shell: sh,   cmake: '-DPerl_ROOT=C:/Strawberry/perl/bin/ -DSDLMIXER_VENDORED=ON -GNinja', msvc: 1, shared: 1, static: 0, artifact: 'SDL3_mixer-VC-x64' }
         - { name: Windows (mingw64),    os: windows-latest, shell: 'msys2 {0}', msystem: mingw64, msys-env: mingw-w64-x86_64, shared: 1, static: 0, artifact: 'SDL3_mixer-mingw64',
             cmake: '-DSDLMIXER_VENDORED=OFF -G "Ninja Multi-Config"' }
-        - { name: Linux,                os: ubuntu-latest, shell: sh, cmake: '-DSDLMIXER_VENDORED=ON -GNinja', shared: 1, static: 0, artifact: 'SDL3_mixer-linux-x64' }
+        - { name: Linux,                os: ubuntu-latest, shell: sh, cmake: '-DSDLMIXER_VENDORED=ON -GNinja', shared: 1, static: 0, test-exports: true, artifact: 'SDL3_mixer-linux-x64' }
         - { name: 'Linux (static)',     os: ubuntu-latest, shell: sh, cmake: '-DSDLMIXER_VENDORED=ON -DBUILD_SHARED_LIBS=OFF -GNinja', shared: 0, static: 1, artifact: 'SDL3_mixer-static-linux-x64' }
         - { name: Macos,                os: macos-latest,  shell: sh, cmake: '-DSDLMIXER_VENDORED=ON -GNinja', shared: 1, static: 0, artifact: 'SDL3_mixer-macos' }
 
@@ -141,6 +141,12 @@ jobs:
       run: |
         cmake --build build/ --target package
 
+    - name: Verify exports files
+      if: ${{ matrix.platform.test-exports }}
+      run: |
+        set -e
+        python src/genexports.py
+        git diff --exit-code -- src/SDL_mixer.sym src/SDL_mixer.exports
     - name: Verify CMake configuration files
       run: |
         cmake -S cmake/test -B cmake_config_build \

CMakeLists.txt

@@ -279,11 +279,14 @@ if(NOT ANDROID)
         VERSION "${SO_VERSION}"
     )
     if(APPLE)
-        cmake_minimum_required(VERSION 3.17...3.28)
         set_target_properties(${sdl3_mixer_target_name} PROPERTIES
             MACHO_COMPATIBILITY_VERSION "${DYLIB_COMPAT_VERSION}"
             MACHO_CURRENT_VERSION "${DYLIB_CURRENT_VERSION}"
         )
+        set_property(TARGET ${sdl3_mixer_target_name} APPEND PROPERTY LINK_DEPENDS
+                "${PROJECT_SOURCE_DIR}/src/SDL_mixer.exports")
+        target_link_options(${sdl3_mixer_target_name} PRIVATE
+                "SHELL:-Wl,-exported_symbols_list,${PROJECT_SOURCE_DIR}/src/SDL_mixer.exports")
     endif()
 endif()
 if(SDLMIXER_BUILD_SHARED_LIBS)

Xcode/SDL_mixer.xcodeproj/project.pbxproj

@@ -618,6 +618,7 @@
 		00B7E48D097EC6B300826121 /* Debug */ = {
 			isa = XCBuildConfiguration;
 			buildSettings = {
+				EXPORTED_SYMBOLS_FILE = "$(SRCROOT)/../src/SDL_mixer.exports";
 			};
 			name = Debug;
 		};
@@ -724,6 +725,7 @@
 		F3B38D58296F8E79005DA6D3 /* Release */ = {
 			isa = XCBuildConfiguration;
 			buildSettings = {
+				EXPORTED_SYMBOLS_FILE = "$(SRCROOT)/../src/SDL_mixer.exports";
 			};
 			name = Release;
 		};

src/SDL_mixer.exports

@@ -0,0 +1,87 @@
+# SDL3_mixer.dylib exports
+_MIX_Init
+_MIX_Quit
+_MIX_Version
+_MIX_CreateMixer
+_MIX_CreateMixerDevice
+_MIX_DestroyMixer
+_MIX_GetNumAudioDecoders
+_MIX_GetAudioDecoder
+_MIX_GetMixerFormat
+_MIX_LoadAudio_IO
+_MIX_LoadAudio
+_MIX_LoadAudioWithProperties
+_MIX_LoadRawAudio_IO
+_MIX_LoadRawAudio
+_MIX_LoadRawAudioNoCopy
+_MIX_CreateSineWaveAudio
+_MIX_GetAudioProperties
+_MIX_DestroyAudio
+_MIX_CreateTrack
+_MIX_DestroyTrack
+_MIX_SetTrackAudio
+_MIX_SetTrackAudioStream
+_MIX_SetTrackIOStream
+_MIX_SetTrackRawIOStream
+_MIX_TagTrack
+_MIX_UntagTrack
+_MIX_SetTrackPlaybackPosition
+_MIX_GetTrackPlaybackPosition
+_MIX_TrackMSToFrames
+_MIX_TrackFramesToMS
+_MIX_AudioMSToFrames
+_MIX_AudioFramesToMS
+_MIX_MSToFrames
+_MIX_FramesToMS
+_MIX_PlayTrack
+_MIX_PlayTag
+_MIX_PlayAudio
+_MIX_StopTrack
+_MIX_StopAllTracks
+_MIX_StopTag
+_MIX_PauseTrack
+_MIX_PauseAllTracks
+_MIX_PauseTag
+_MIX_ResumeTrack
+_MIX_ResumeAllTracks
+_MIX_ResumeTag
+_MIX_TrackPlaying
+_MIX_TrackPaused
+_MIX_SetMasterGain
+_MIX_GetMasterGain
+_MIX_SetTrackGain
+_MIX_GetTrackGain
+_MIX_SetTagGain
+_MIX_SetTrackFrequencyRatio
+_MIX_GetTrackFrequencyRatio
+_MIX_SetTrackOutputChannelMap
+_MIX_SetTrackStoppedCallback
+_MIX_CreateGroup
+_MIX_SetTrackGroup
+_MIX_DestroyGroup
+_MIX_GetGroupMixer
+_MIX_GetTrackMixer
+_MIX_SetPostMixCallback
+_MIX_SetGroupPostMixCallback
+_MIX_SetTrackRawCallback
+_MIX_SetTrackCookedCallback
+_MIX_Generate
+_MIX_GetAudioDuration
+_MIX_TrackLooping
+_MIX_GetTrackAudio
+_MIX_GetTrackAudioStream
+_MIX_GetTrackRemaining
+_MIX_SetTrack3DPosition
+_MIX_GetTrack3DPosition
+_MIX_GetAudioFormat
+_MIX_GetMixerProperties
+_MIX_GetTrackProperties
+_MIX_GetGroupProperties
+_MIX_SetTrackStereo
+_MIX_CreateAudioDecoder
+_MIX_CreateAudioDecoder_IO
+_MIX_DestroyAudioDecoder
+_MIX_GetAudioDecoderProperties
+_MIX_DecodeAudio
+_MIX_GetAudioDecoderFormat
+# extra symbols go here (don't modify this line)

src/SDL_mixer.sym

@@ -85,5 +85,6 @@ SDL3_mixer_0.0.0 {
     MIX_GetAudioDecoderProperties;
     MIX_DecodeAudio;
     MIX_GetAudioDecoderFormat;
+    # extra symbols go here (don't modify this line)
   local: *;
 };