Update xcode tutorial to demonstrate project setup without templates #270
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
eXpl0it3r
force-pushed
the
xcode_update
branch
from
b9fe3ef to
13ef12d
Compare
eXpl0it3r
reviewed
Dec 19, 2025
| You can find more details in [this document](https://developer.apple.com/library/mac/#documentation/DeveloperTools/Conceptual/DynamicLibraries/ "Go to Apple's documentation about dylib"). | ||
| - Frameworks are fundamentally the same as dylibs, except that they can encapsulate external resources. | ||
| Here is [the in-depth documentation](https://developer.apple.com/library/mac/#documentation/MacOSX/Conceptual/BPFrameworks/Frameworks.html "Go to Apple's documentation about framework"). | ||
| Then, in order to start developing SFML applications, you have to install the following items: |
Member
There was a problem hiding this comment.
Ah, seems like a leftover line from before
eXpl0it3r
requested changes
Dec 19, 2025
Member
eXpl0it3r
left a comment
eXpl0it3r
left a comment
There was a problem hiding this comment.
Would be great to add periods at the end of the sentences / paragraphs.
| - **Xcode templates** | ||
| This feature is optional but we strongly recommend that you install it. | ||
| Copy the SFML directory from templates to `~/Library/Developer/Xcode/Templates` (create the folders if they don't exist yet). | ||
| Now you have a basic project with a `main.cpp` file for your code. You can replace the contents with this SFML code to draw a green circle: |
Member
There was a problem hiding this comment.
Each sentence should be on its own line, for better diffs
| But currently it will not build, as we need to configure Xcode so it can find SFML's headers and libraries | ||
|
|
||
|  | ||
| For header paths, select your project on the sidebar, go to the build settings tab and set the Header Search paths (filter can help find the setting) to the `include` folder in your unpacked SFML folder (or brew include folder if using brew, e.g. `/opt/homebrew/include`) |
Member
There was a problem hiding this comment.
Suggested change
| For header paths, select your project on the sidebar, go to the build settings tab and set the Header Search paths (filter can help find the setting) to the `include` folder in your unpacked SFML folder (or brew include folder if using brew, e.g. `/opt/homebrew/include`) | |
| For header paths, select your project on the sidebar, go to the build settings tab and set the Header Search paths (filter can help find the setting) to the `include` folder in your unpacked SFML folder, e.g. `<sfml-install-path>/include` (or brew include folder if using brew, e.g. `/opt/homebrew/include`) |
|
|
||
|  | ||
|
|
||
| For library paths, do the same for the Library Search path setting, using the `lib` folder in your unpacked SFML folder (or brew lib folder if using brew, e.g. `/opt/homebrew/lib`) |
Member
There was a problem hiding this comment.
Suggested change
| For library paths, do the same for the Library Search path setting, using the `lib` folder in your unpacked SFML folder (or brew lib folder if using brew, e.g. `/opt/homebrew/lib`) | |
| For library paths, do the same for the Library Search path setting, using the `lib` folder in your unpacked SFML folder, .e.g `<sfml-install-path>/lib` (or brew lib folder if using brew, e.g. `/opt/homebrew/lib`) |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
With imminent removal of our xcode templates (SFML/SFML#3622) the tutorials need updating (frankly they needed it anyway as they are very old)
This replaces the template tutorial with the manual project setup for both static and dynamic linking
Framework setup is omitted as I found some issues when testing them (I never use them normally) so want to try and work them out first, and there's possibly even an argument that we shouldn't bother shipping frameworks at all, for a separate discussion