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

blueloveTH · 2024-03-22T12:20:33Z

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

blueloveTH · 2024-03-23T15:37:41Z

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 · 2024-03-23T17:43:57Z

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 · 2024-03-24T05:53:06Z

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.

Update ios.yml

blueloveTH · 2024-03-25T13:43:04Z

Added iOS build workflow to CI.

This reverts commit a552997.

raysan5 · 2024-04-01T16:08:50Z

@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 · 2024-04-01T16:10:14Z

.github/workflows/ios.yml

+    - name: Build Xcode15 project
+      run: |
+        cd projects/Xcode15
+        curl -L https://github.com/raysan5/raylib/files/14743869/libEGL.xcframework.zip --output libEGL.xcframework.zip


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

parser/output/raylib_api.lua

raysan5 · 2024-04-01T16:12:19Z

projects/Xcode15/raylib/.gitignore

@@ -0,0 +1 @@
+Frameworks


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

raysan5 · 2024-04-01T16:15:12Z

src/rlgl.h

@@ -815,7 +815,19 @@ RLAPI void rlLoadDrawQuad(void);     // Load and draw a quad
    #include "external/glad.h"          // GLAD extensions loading library, includes OpenGL headers
 #endif

-#if defined(GRAPHICS_API_OPENGL_ES3)
+#if defined(PLATFORM_IOS)


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 · 2024-04-01T16:16:03Z

src/rlgl.h

+        #error "GL_GLEXT_PROTOTYPES required on PLATFORM_IOS"
+    #endif
+    #include "libGLESv2/GLES/glext.h"
+    #include "libGLESv2/GLES2/gl2.h"


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

raysan5 · 2024-04-01T16:18:17Z

src/platforms/rcore_ios.c

+        if(touchs[i] == touch) return i + 1;
+    }
+    // clear unused touch pairs before insert
+    for(int i = 0; i < MAX_TOUCH_POINTS; i++){


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

src/platforms/rcore_ios.c

raysan5 · 2024-04-01T16:23:05Z

src/platforms/rcore_ios.c

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


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

blueloveTH · 2024-04-02T02:40:29Z

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

This reverts commit 4a7b666.

This reverts commit 5db5720.

neondeex · 2024-05-02T15:26:11Z

Interesting.. will colaborate soon

init

d0a13c6

This comment was marked as outdated.

Sign in to view

create XCode15 project targeting iOS

0caa413

blueloveTH changed the title ~~[rcore] Draft: Try to implement rcore_ios.c~~ [rcore] Porting raylib into iOS and implement rcore_ios.c Mar 23, 2024

blueloveTH changed the title ~~[rcore] Porting raylib into iOS and implement rcore_ios.c~~ [rcore] Porting raylib to iOS and implement rcore_ios.c Mar 23, 2024

blueloveTH added 2 commits March 23, 2024 18:53

Update rcore_ios.c

b3b2d50

some update

dfc6dc2

This comment was marked as outdated.

Sign in to view

blueloveTH added 2 commits March 24, 2024 01:01

the first working version

d1ffab4

some fix

cae863a

blueloveTH added 3 commits March 24, 2024 01:59

prepare to add touch callbacks

2900607

Update rcore_ios.c

74da3b7

support more touches

9f7dec6

blueloveTH marked this pull request as ready for review March 24, 2024 05:51

This comment was marked as outdated.

Sign in to view

blueloveTH and others added 10 commits March 24, 2024 14:27

some fix

c66c9e9

change pointId[] to long long

a552997

Update raylib_api.* by CI

5db5720

Update rcore_ios.c

c0ac347

Update rcore_ios.c

3a9649d

upgrade to GRAPHICS_API_OPENGL_ES3

67fb284

Update rlgl.h

0a9ea31

Update project.pbxproj

cd1b81d

Create ios.yml

33ccfd9

Update ios.yml

ed861d0

Update ios.yml

blueloveTH force-pushed the master branch from acf5d1d to ed861d0 Compare March 25, 2024 13:33

blueloveTH force-pushed the master branch from 060d8c9 to da46011 Compare March 25, 2024 13:37

Update ios.yml

2e29d3f

blueloveTH and others added 14 commits March 27, 2024 13:35

Update rcore_ios.c

ee2a307

Update rcore_ios.c

e6afac8

Update rcore_ios.c

e5ecddf

Update rcore_ios.c

86b3ba2

Update rcore_ios.c

c124623

Update rcore_ios.c

f3c4d49

Revert "change pointId[] to long long"

d1a8b86

This reverts commit a552997.

revert long long change

faaa623

Update raylib_api.* by CI

4a7b666

Update rcore_ios.c

bc34ea6

Update rcore_ios.c

3c12964

Update rcore_ios.c

b69cee5

Update rcore_ios.c

5241819

Update rcore_ios.c

d10d888

raysan5 reviewed Apr 1, 2024

View reviewed changes

blueloveTH and others added 9 commits April 3, 2024 15:14

Revert "Update raylib_api.* by CI"

8fbec6f

This reverts commit 4a7b666.

Revert "Update raylib_api.* by CI"

7f9400c

This reverts commit 5db5720.

Update rcore_ios.c

cd8f5f9

Update rcore_ios.c

c5c41f9

Update rcore_android.c

c4a42a3

Update rcore_android.c

918c394

Update main.c

d68b8eb

Update project.pbxproj

a3873bf

Update rcore_ios.c

1de43bf

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

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

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

blueloveTH commented Mar 22, 2024 •

edited

This comment was marked as outdated.

blueloveTH commented Mar 23, 2024 •

edited

This comment was marked as outdated.

This comment was marked as outdated.

blueloveTH commented Mar 23, 2024 •

edited

blueloveTH commented Mar 24, 2024

This comment was marked as outdated.

blueloveTH commented Mar 25, 2024

raysan5 commented Apr 1, 2024

raysan5 Apr 1, 2024

raysan5 Apr 1, 2024

raysan5 Apr 1, 2024

raysan5 Apr 1, 2024

raysan5 Apr 1, 2024

raysan5 Apr 1, 2024

blueloveTH commented Apr 2, 2024

neondeex commented May 2, 2024

		@@ -0,0 +1 @@
		Frameworks

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

Are you sure you want to change the base?

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

Conversation

blueloveTH commented Mar 22, 2024 • edited

Current Demo (iPhone 8)

Steps

Functions

Prebuilt ANGLE libraries for iOS

References

This comment was marked as outdated.

blueloveTH commented Mar 23, 2024 • edited

This comment was marked as outdated.

This comment was marked as outdated.

blueloveTH commented Mar 23, 2024 • edited

blueloveTH commented Mar 24, 2024

This comment was marked as outdated.

blueloveTH commented Mar 25, 2024

raysan5 commented Apr 1, 2024

raysan5 Apr 1, 2024

Choose a reason for hiding this comment

raysan5 Apr 1, 2024

Choose a reason for hiding this comment

raysan5 Apr 1, 2024

Choose a reason for hiding this comment

raysan5 Apr 1, 2024

Choose a reason for hiding this comment

raysan5 Apr 1, 2024

Choose a reason for hiding this comment

raysan5 Apr 1, 2024

Choose a reason for hiding this comment

blueloveTH commented Apr 2, 2024

neondeex commented May 2, 2024

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

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

blueloveTH commented Mar 22, 2024 •

edited

blueloveTH commented Mar 23, 2024 •

edited

blueloveTH commented Mar 23, 2024 •

edited