Skip to content

Initial Android docs#274

Open
JonnyPtn wants to merge 1 commit intoSFML:feature/prep_3.1.0from
JonnyPtn:android
Open

Initial Android docs#274
JonnyPtn wants to merge 1 commit intoSFML:feature/prep_3.1.0from
JonnyPtn:android

Conversation

@JonnyPtn
Copy link
Contributor

@JonnyPtn JonnyPtn commented Feb 9, 2026

Partial fix of #273

About time we had some - This covers the most common and simple method people should use, building an app via Android Studio/Gradle

Worth noting the cmake code here references the non-existent 3.1.0 SFML branch which includes some fixes that I'd prefer not to document the workarounds for here

@JonnyPtn
Copy link
Contributor Author

JonnyPtn commented Feb 9, 2026

I've not mentioned about backgrounding here - I'd think we want to have a more general "mobile" page which can cover the shared behaviour (backgrounding, orientation changes, etc.)?

@eXpl0it3r
Copy link
Member

I've not mentioned about backgrounding here - I'd think we want to have a more general "mobile" page which can cover the shared behaviour (backgrounding, orientation changes, etc.)?

Sounds like a good idea to me!

Copy link
Member

@eXpl0it3r eXpl0it3r left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Initial review with capitalization and new lines.

Also, rebased onto master.

Copy link
Member

@eXpl0it3r eXpl0it3r left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Some small comma stuff, otherwise it should be ready


!!! note

Android does not use executables, so where you would normally `add_executable(...)` in CMake on other platforms, you must instead do `add_library(... SHARED)` for Android.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we add some reason as to why and/or add a link?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not really sure what useful info could be added here without going into quite some detail about the JNI/NDK and stuff. Best I can find is this: https://developer.android.com/ndk/guides/concepts#main_components

Do you think that's useful to link?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yeah, I believe the link could be useful. As a user of something, I usually don't like when the text doesn't provide some reasoning, even if it's just "because they say so, see link".

@JonnyPtn JonnyPtn requested a review from eXpl0it3r February 23, 2026 19:26
@eXpl0it3r eXpl0it3r changed the base branch from master to feature/prep_3.1.0 February 23, 2026 21:52
@eXpl0it3r
Copy link
Member

Retargeted, rebased and moved the files for the SFML 3.1 tutorials.

@JonnyPtn
Copy link
Contributor Author

Added link and a few more notes on android app structure and squashed

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants