Use angle as GL provider on Kivy 3.0.0.dev0 (and above) (#928)

* WIP TESTS ANGLE

* WIP

* WIP

* Revert some defaults, disable opengl only on sdl3

* Revert OpenGLES removal

* Patch setup only in case of sdl2 usage (sdl3 uses angle)

* Revery kivy version to default

* Update angle to latest release

Author: misl6

kivy_ios/recipes/angle/__init__.py

@@ -0,0 +1,46 @@
+import os
+import shutil
+
+from kivy_ios.toolchain import GenericPlatform, Recipe, cache_execution
+
+
+class IphoneAllUniversalPlatform(GenericPlatform):
+
+    @property
+    def name(self):
+        return "iphoneall-universal"
+
+
+class ANGLERecipe(Recipe):
+    version = "chromium-7151_rev1"
+    url = "https://github.com/kivy/angle-builder/releases/download/{version}/angle-iphoneall-universal.tar.gz"
+    include_dir = ["include"]
+    libraries = ["libEGL.a", "libGLESv2.a"]
+
+    @property
+    def platforms_to_build(self):
+        yield IphoneAllUniversalPlatform(self.ctx)
+
+    @cache_execution
+    def build_all(self):
+        self.install_include()
+        self.install()
+
+    @cache_execution
+    def install(self):
+        xcframework_folder = os.path.join(self.ctx.dist_dir, "xcframework")
+
+        build_dir = self.get_build_dir(
+            plat=IphoneAllUniversalPlatform(self.ctx)
+        )
+
+        for fn in os.listdir(build_dir):
+            if fn.endswith(".xcframework"):
+                shutil.copytree(
+                    os.path.join(build_dir, fn),
+                    os.path.join(xcframework_folder, fn),
+                    dirs_exist_ok=True,
+                )
+
+
+recipe = ANGLERecipe()

kivy_ios/recipes/kivy/__init__.py

@@ -27,8 +27,7 @@ class KivyRecipe(CythonRecipe):
         "urllib3",
         "filetype",
     ]
-    pbx_frameworks = [
-        "OpenGLES",
+    _base_pbx_frameworks = [
         "Accelerate",
         "CoreMedia",
         "CoreVideo",
@@ -85,6 +84,21 @@ def get_required_sdl_version(self):
 
         return self._required_sdl_version
 
+    @property
+    def pbx_frameworks(self):
+        if self.get_required_sdl_version() == "sdl2":
+            return self._base_pbx_frameworks + [
+                "OpenGLES",
+            ]
+        elif self.get_required_sdl_version() == "sdl3":
+            return self._base_pbx_frameworks + [
+                "Metal",
+            ]
+        else:
+            raise ValueError(
+                f"Unsupported SDL version: {self.get_required_sdl_version()}"
+            )
+
     @property
     def depends(self):
         if self.get_required_sdl_version() == "sdl2":
@@ -100,6 +114,7 @@ def depends(self):
                 "sdl3_image",
                 "sdl3_ttf",
                 "sdl3_mixer",
+                "angle",
             ]
         else:
             raise ValueError(
@@ -118,7 +133,8 @@ def get_recipe_env(self, plat):
                 ]
             )
         elif self.get_required_sdl_version() == "sdl3":
-            env["USE_ANGLE_GL_BACKEND"] = "0"
+            env["KIVY_ANGLE_INCLUDE_DIR"] = join(self.ctx.dist_dir, "include", "common", "angle")
+            env["KIVY_ANGLE_LIB_DIR"] = join(self.ctx.dist_dir, "frameworks", plat.sdk)
             env["KIVY_SDL3_PATH"] = ":".join(
                 [
                     join(self.ctx.dist_dir, "include", "common", "sdl3"),
@@ -154,7 +170,8 @@ def get_recipe_env(self, plat):
         return env
 
     def build_platform(self, plat):
-        self._patch_setup()
+        if self.get_required_sdl_version() == "sdl2":
+            self._patch_setup()
         super().build_platform(plat)
 
     def _patch_setup(self):

kivy_ios/recipes/sdl3/__init__.py

@@ -27,7 +27,7 @@ def prebuild_platform(self, plat):
         if self.has_marker("patched"):
             return
         self.apply_patch("uikit-transparent.patch")
-        # self.apply_patch("disable-hidapi.patch")
+        self.apply_patch("disable-opengl.patch")
         self.set_marker("patched")
 
     def build_platform(self, plat):

kivy_ios/recipes/sdl3/disable-opengl.patch

@@ -0,0 +1,15 @@
+--- SDL3-3.2.8/include/build_config/SDL_build_config_ios.h.orig	2025-06-26 21:36:13
++++ SDL3-3.2.8/include/build_config/SDL_build_config_ios.h	2025-06-26 21:37:02
+@@ -177,9 +177,9 @@
+ 
+ /* Enable OpenGL ES */
+ #if !TARGET_OS_MACCATALYST && !TARGET_OS_VISION
+-#define SDL_VIDEO_OPENGL_ES2 1
+-#define SDL_VIDEO_OPENGL_ES 1
+-#define SDL_VIDEO_RENDER_OGL_ES2 1
++#define SDL_VIDEO_OPENGL_ES2 0
++#define SDL_VIDEO_OPENGL_ES 0
++#define SDL_VIDEO_RENDER_OGL_ES2 0
+ #endif
+ 
+ /* Metal supported on 64-bit devices running iOS 8.0 and tvOS 9.0 and newer

kivy_ios/tools/liblink

@@ -23,6 +23,10 @@ while i < len(sys.argv):
         libs.append(opt)
         continue
 
+    if opt.startswith("-F"):
+        libs.append(opt)
+        continue
+
     if opt in ("-r", "-pipe", "-no-cpp-precomp"):
         continue
 

kivy_ios/tools/templates/{{ cookiecutter.project_name }}-ios/main.m

@@ -38,6 +38,10 @@ int main(int argc, char *argv[]) {
     putenv("KIVY_AUDIO=sdl2");
     putenv("KIVY_GL_BACKEND=sdl2");
 
+    // WIP_ Will move to angle and sdl3 as default in the future
+    // Set KIVY_GL_BACKEND=angle if building for kivy==master branch
+    // putenv("KIVY_GL_BACKEND=angle");
+
     // IOS_IS_WINDOWED=True disables fullscreen and then statusbar is shown
     putenv("IOS_IS_WINDOWED=False");