Xcode can't find headers file from added frameworks
12:36 17 Apr 2026

I'm trying to turn my Python kivymd project into an app, and I'm going crazy... Maybe it's related, but I'm working on a VMware virtual machine, newest mac version, and newest Xcode version. Aside from being a bit slow and laggy sometimes, I didn't see any major problems or differences from a normal Mac.

In Xcode on Mac, I'm trying to #include , and I did add the SDL2.framework to the project both at the "Build Phases/Link Binary With Libraries" and the "General/Frameworks, Libraries, and Embedded content", in "Build Settings/Header Search Paths" I added the $(PROJECT_DIR)/SDL2.framework path, the $(PROJECT_DIR)/SDL2.framework is added in the "Framework Search Paths" as recursive, and still it says for the , that the file is not found. I checked with the Finder, and the SDL2.framwork/Headers/SDL.h does exist. It's definitely registered at frameworks, cause it was automatically added to embed frameworks, and its under frameworks category. And yes, I did select the project under targets.

If I messed something obvious up or I didn't provide enough data, please tell me, I'm trying my best currently, didn't rush here first trouble, did use Google.

I also checked multiple posts, asked Gemini for help, nothing worked, been dealing with this for over 6 hours at least:
Stackoverflow similar issue
Lazyfoo ios SDL2 guide
I also checked 3 other similar stackoverflow posts, none of them was my issue.

Build Phases Screenshot
General Screenshot
Code screenshot

PS.: Sorry for the ugly code indentation, Stackoverflow kept insisting I have code somewhere

ios xcode macos kivy frameworks