[rcore] Porting raylib to iOS and implement rcore_ios.c

[blueloveTH]

I would like to take the initial step to add iOS support for raylib.
I am going to add rcore_ios.c and implement an iOS's platform layer.
I will update this pr on my progress.

Current Demo (iPhone 8)

RPReplay_Final1711259172.MP4

Steps

• Create an empty iOS game project in XCode
• Compile ANGLE and get libEGL.xcframework and libGLESv2.xcframework
• Fill rcore_ios.c and compile raylib
• Link all of the above with an example source file

Functions

• void PollInputEvents(void)
• int InitPlatform(void)
• void ClosePlatform(void)

Prebuilt ANGLE libraries for iOS

Users need to add the following ANGLE libraries into Xcode.
libEGL.xcframework.zip
libGLESv2.xcframework.zip

References

• will it support iOS? #2681
• Linking raylib against ANGLE on MacOS #2998
• https://medium.com/@grplyler/building-and-linking-googles-angle-with-raylib-on-macos-67b07cd380a3
• [build] Try to support iOS platform #330
• https://github.com/levinli303/ANGLESwiftUI/tree/main

[blueloveTH]

Hi @raysan5 . I need your help. iOS always use a UIApplicationMain function to start the game. UIApplicationMain is an extern function which is hidden for me. It runs forever.

int main(int argc, char * argv[]) {
    return UIApplicationMain(argc, argv, nil, NSStringFromClass([AppDelegate class]));
}

It seems does not expose detailed control to allow us to achieve the following:

int main() {
  library_init();
  // game init code here
  while(we_have_not_quit_the_game) {
    library_message_loop();
    library_init_render();
    // render stuff
    library_end_render();
    // update game state
  }
  library_shutdown();
}

See https://stackoverflow.com/questions/2187684/how-can-i-remove-uiapplicationmain-from-an-iphone-application.

What we can do is registering render callbacks via CADisplayLink. I cannot find a way to give users full control of the game loop.

I can try a callback-based api like this. However, this requires a minor change of existing raylib projects if they want to run on iOS.

extern void ios_ready();
extern void ios_update();
extern void ios_destroy();

Old project should adapt their main function into this in order to be cross-platform between iOS and other platforms:

#ifndef PLATFORM_IOS
int main(int argc, char** argv){
    // store as global variables if you need
    ios_ready();
    while(!WindowShouldClose()) ios_update();
    ios_destroy();
    return 0;
}
#endif

[blueloveTH]

Question: I see there is a feature: InitWindow(0, 0, "title") will set as full screen. How is it achieved?

Should I override CORE.Window.screen.width and CORE.Window.screen.height in InitPlatform with device width and height?

[blueloveTH]

Now rcore_ios.c has basic functionalities including graphics, audio and touch input. I've marked this PR as ready for review. I will continue to work for more details and wait for raysan5's comment.

[raysan5]

@blueloveTH Excuse my late response and thank you very much for working on this great improvement. iOS platform has been missing from raylib for +10 years and I'm happy to see that some user implemented it.

My main concern is the iOS application approach that completely differs from all the other platforms. All raylib examples work exactly as they are on all the supported platforms and requiring a complete re-design for iOS is not the ideal situation.

Is it possible to use a similar approach to Android one? Embedding the App management inside raylib?

Also note that the provided rcore_ios.c implementation does not follow raylib code conventions. It would be nice to follow them when possible.

[raysan5]

Where are those files located? It looks a bit dodgy... isn't there a better approach?

[raysan5]

Why is this .gitignore file required? Could't it be avoided?

[raysan5]

If possible I'd prefer to keep rlgl as platform-agnostic as possible, would it be possible to move this configuration to the build system or rcore.c instead of manage it here?

[raysan5]

Why GLES2 and GLES3 are included if only GLES3 is needed?

[raysan5]

raylib adds one space after if, else, for and always aligns brackets.

[raysan5]

I imagine this is the biggest issue with iOS implementation, isn't there another alternative?

[blueloveTH]

Thanks for your review. I am going to resolve them soon.

[neondeex]

Interesting.. will colaborate soon

[zeroxer]

Any new progress？

[jonpittock]

also interested :D?

[blueloveTH]

I am a bit busy recently :/ It works on my branch. I may sync it with the latest raylib if I have time.

[celioreyes]

@blueloveTH do you have local changes on your branch?

I have this running on my mac/iphone now and planning on allocating some free time on this as I also need raylib ios for a project I'm working on.

Anything you need for collaboration?

Do you have your Makefile/CMake changes to compile Raylib to ios local?

[lzralbu]

To use raylib with Emscripten it's already necessary to give up the main loop control(unless one's willing to add ASYNCIFY which has a nonnegligible overhead).

So I like the idea of a callback based design. Maybe something along the lines of SDL3 main callback functions.

Here's how they handle the quirks of each platform, including iOS.

[leftbones]

Definitely interested in this. This is the dream, being able to make cross platform mobile apps and games with raylib would be amazing.

[raysan5]

@leftbones Unfortunately the code structure required for this iOS implementation is hardly compatible with raylib structure, not sure if it's possible to use another structure, more similar to Android one.

[blueloveTH]

There may be internal functions that Apple does not expose allowing us to take full control of the main loop.

[jackwlee01]

Perhaps the newly merged SDL_GPU as a backend would be a better approach for targeting iOS, and consoles!!!

[calvin2021y]

@leftbones Unfortunately the code structure required for this iOS implementation is hardly compatible with raylib structure, not sure if it's possible to use another structure, more similar to Android one.

sokol seems support IOS event loop, can we learn some idea from them....