iOS plugin built for Godot 4.4.1 - Build failed on Xcode

[ManuelMacchia]

Godot 4.4.1
Mac OS Sequoia 15.5
XCode 16.2

% clang --version
Apple clang version 16.0.0 (clang-1600.0.26.6)
Target: arm64-apple-darwin24.5.0
Thread model: posix
InstalledDir: /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin

I've apparently compiled, in a proper way, the iOS plugin for Game Center and iCloud following the steps on the main README file. I've enable the plugins on the export panel for the iOS platform, but once I opened xCode and try to build the app, it failed due to the following errors:

Undefined symbol: D_METHODP(char const*, char const* const**, unsigned int)
Undefined symbol: ClassDB::bind_methodfi(unsigned int, MethodBind*, bool, MethodDefinition const&, Variant const**, int)
The result is the same if I try to enable one plugin per time.
I tried to re-compile everything multiple times. Here the steps in details (for the GameCenter plugin but I see the same results with other plugins, like iCloud):

1. Clone the repo and its submodule
   git clone --recursive https://github.com/godotengine/godot-ios-plugins.git

2. update the godot repo to the version 4.4
   cd godot git fetch git checkout origin/4.4

3. Generate Godot headers
   scons platform=ios target=editor

4. From the main directory godot-ios-plugins - Building a .xcframework library

scons target=release_debug arch=arm64 simulator=yes plugin=gamecenter version=4.0
./scripts/generate_xcframework.sh gamecenter release_debug 4.0

Then I copied the files godot-ios-plugins/plugins/gamecenter/gamecenter.gdip and godot-ios-plugins/bin/gamecenter.release_debug.xcframework into the folder, on my Godot project, /res/ios/plugins. Then renamed gamecenter.release_debug.xcframework to gamecenter.xcframework

Any suggestion?
Thanks

P.S: this step (https://github.com/godot-sdk-integrations/godot-ios-plugins?tab=readme-ov-file#building-a-a-library) on the doc cannot work, the script generate_static_library.sh is not available on the script folder of the plugin

[zestybean]

Godot 4.x Compatibility Fix - Working for 4.5

Overview

This document describes the fix applied to make the Godot iOS plugins compatible with Godot 4.5.1. The main issue was related to header file imports that changed location in Godot 4.x.

Problem Description

When building the gamecenter plugin (and potentially other plugins), the compilation failed with the following error:

plugins/gamecenter/game_center.mm:36:9:{36:9-36:38}: fatal error: 'platform/ios/app_delegate.h' file not found [1]
   36 |  #import "platform/ios/app_delegate.h"

Root Cause

In Godot 4.x, the iOS platform structure was reorganized. Key header files were moved from platform/ios/ to drivers/apple_embedded/:

• platform/ios/app_delegate.h → drivers/apple_embedded/godot_app_delegate.h
• platform/ios/view_controller.h → drivers/apple_embedded/view_controller.h

Solution Applied

Files Modified

plugins/gamecenter/game_center.mm

Before:

#if VERSION_MAJOR == 4
#import "platform/ios/app_delegate.h"
#import "platform/ios/view_controller.h"
#else
#import "platform/iphone/app_delegate.h"
#import "platform/iphone/view_controller.h"
#endif

After:

#if VERSION_MAJOR == 4
#import "drivers/apple_embedded/godot_app_delegate.h"
#import "drivers/apple_embedded/view_controller.h"
#else
#import "platform/iphone/app_delegate.h"
#import "platform/iphone/view_controller.h"
#endif

Build Process

Prerequisites

1. Extract Headers: Ensure Godot headers are extracted before building:

   ./scripts/extract_headers.sh

2. Godot Version: Use version parameter 4.0 for Godot 4.x builds (the build system currently supports 3.x and 4.0)

Building Individual Plugins

To build a specific plugin for Godot 4.x:

# Build for ARM64 device
scons target=release_debug arch=arm64 plugin=gamecenter version=4.0

# Build for x86_64 simulator
scons target=release_debug arch=x86_64 simulator=yes plugin=gamecenter version=4.0

# Build for ARM64 simulator
scons target=release_debug arch=arm64 simulator=yes plugin=gamecenter version=4.0

Generating XCFramework

To generate a complete xcframework for a plugin:

./scripts/generate_xcframework.sh gamecenter release_debug 4.0

This will:

1. Compile static libraries for all architectures
2. Create fat libraries for simulators
3. Generate an xcframework containing both device and simulator binaries

Available Plugins

The following plugins are available for building:

• gamecenter - Game Center integration
• inappstore - In-App Purchase functionality
• icloud - iCloud integration
• camera - Camera access
• arkit - ARKit functionality
• apn - Apple Push Notifications
• photo_picker - Photo picker functionality

Verification

After applying the fix, the following operations should complete successfully:

1. Compilation: All plugin compilations for Godot 4.x complete without header errors
2. XCFramework Generation: The xcframework creation process completes successfully
3. Multi-Architecture Support: Builds work for both device (ARM64) and simulator (x86_64, ARM64) architectures

Testing the Fix

To verify the fix works correctly:

# Test gamecenter plugin build
./scripts/generate_xcframework.sh gamecenter release_debug 4.0

# Check the generated xcframework
ls -la bin/gamecenter.release_debug.xcframework

Expected output should show an xcframework with both ios-arm64 and ios-arm64_x86_64-simulator directories.

Notes

• This fix maintains backward compatibility with Godot 3.x through conditional compilation
• The build system parameter should be 4.0 for all Godot 4.x versions (4.0, 4.1, 4.2, 4.3, 4.4, 4.5, etc.)
• Other plugins may require similar header path updates if they import iOS platform headers

Related Files

• plugins/gamecenter/game_center.mm - Main fix applied here
• scripts/extract_headers.sh - Extracts Godot headers needed for compilation
• scripts/generate_xcframework.sh - Builds complete xcframework
• SConstruct - Build configuration file

Compatibility Matrix

Godot Version	Build Parameter	Status
3.x	3.x	✅ Supported
4.0 - 4.5	4.0	✅ Fixed

Date Fixed: October 6, 2025

[ManuelMacchia]

Hey zestybean,

thanks for your response.
Unfortunately I didn't solve the issue and I'm still stuck with the following errors, when I try to build the app on Xcode and run it on my iPad:

Undefined symbol: D_METHODP(char const*, char const* const**, unsigned int)

Undefined symbol: ClassDB::bind_methodfi(unsigned int, MethodBind*, bool, MethodDefinition const&, Variant const**, int)

Not sure to understand this part:

In Godot 4.x, the iOS platform structure was reorganized. Key header files were moved from platform/ios/ to drivers/apple_embedded/:
platform/ios/app_delegate.h → drivers/apple_embedded/godot_app_delegate.h
platform/ios/view_controller.h → drivers/apple_embedded/view_controller.h

I cloned the repo of the godot-ios-plugins and checked out the Godot version 4.4, and I properly see the files app_delegate.h and view_controller.h on the folder platform/ios and I don't have any directory apple_embedded under the drivers one

I tried to change the file plugins/gamecenter/game_center.mm in this way

from

#if VERSION_MAJOR == 4
#import "platform/ios/app_delegate.h"
#import "platform/ios/view_controller.h"
#else
#import "platform/iphone/app_delegate.h"
#import "platform/iphone/view_controller.h"
#endif

to

#if VERSION_MAJOR == 4
#import "platform/ios/godot_app_delegate.h"
#import "platform/ios/view_controller.h"
#else
#import "platform/iphone/app_delegate.h"
#import "platform/iphone/view_controller.h"
#endif

With the same results on the build phase on XCode. Let me add I don't have any error while compiling the plugin nor during the export of project to iOS

I tried to compile the plugin gamecenter using the already existing headers on the Godot 4.4 version folder /godot-ios-plugins/godot [4.4] or using the Headers extracted with the script

./scripts/extract_headers.sh