Add library evolution support

Author: Kyle-Ye

.github/workflows/compatibility_tests.yml

@@ -20,6 +20,7 @@ jobs:
       OPENGRAPHICS_BUILD_FOR_DARWIN_PLATFORM: 1
       OPENGRAPHICS_WERROR: 1
       OPENGRAPHICS_COREGRAPHICS: 1
+      OPENGRAPHICS_LIBRARY_EVOLUTION: 0
       GH_TOKEN: ${{ github.token }}
     steps:
       - uses: actions/checkout@v4

.github/workflows/macos.yml

@@ -19,6 +19,7 @@ jobs:
       OPENGRAPHICS_BUILD_FOR_DARWIN_PLATFORM: 1
       OPENGRAPHICS_WERROR: 1
       OPENGRAPHICS_COREGRAPHICS: 0
+      OPENGRAPHICS_LIBRARY_EVOLUTION: 0
       GH_TOKEN: ${{ github.token }}
     steps:
       - uses: actions/checkout@v4

.github/workflows/ubuntu.yml

@@ -18,6 +18,7 @@ jobs:
       OPENGRAPHICS_BUILD_FOR_DARWIN_PLATFORM: 0
       OPENGRAPHICS_WERROR: 1
       OPENGRAPHICS_COREGRAPHICS: 0
+      OPENGRAPHICS_LIBRARY_EVOLUTION: 0
     container: swift:${{ matrix.swift_version }}-jammy
     steps:
       - uses: actions/checkout@v4

Package.swift

@@ -31,16 +31,30 @@ let isXcodeEnv = Context.environment["__CFBundleIdentifier"] == "com.apple.dt.Xc
 
 let development = envEnable("OPENGRAPHICS_DEVELOPMENT")
 
+// MARK: - [env] OPENGRAPHICS_COREGRAPHICS
+
 let coreGraphicsCondition = envEnable("OPENGRAPHICS_COREGRAPHICS", default: buildForDarwinPlatform)
 if coreGraphicsCondition {
     sharedSwiftSettings.append(.define("OPENGRAPHICS_COREGRAPHICS"))
 }
 
+// MARK: - [env] OPENGRAPHICS_WERROR
+
 let warningsAsErrorsCondition = envEnable("OPENGRAPHICS_WERROR", default: isXcodeEnv && development)
 if warningsAsErrorsCondition {
     sharedSwiftSettings.append(.unsafeFlags(["-warnings-as-errors"]))
 }
 
+// MARK: - [env] OPENGRAPHICS_LIBRARY_EVOLUTION
+
+let libraryEvolutionCondition = envEnable("OPENGRAPHICS_LIBRARY_EVOLUTION", default: buildForDarwinPlatform)
+
+if libraryEvolutionCondition {
+    // NOTE: -enable-library-evolution will cause module verify failure for `swift build`.
+    // Either set OPENGRAPHICS_LIBRARY_EVOLUTION=0 or add `-Xswiftc -no-verify-emitted-module-interface` after `swift build`
+    sharedSwiftSettings.append(.unsafeFlags(["-enable-library-evolution", "-no-verify-emitted-module-interface"]))
+}
+
 let package = Package(
     name: "OpenGraphics",
     products: [