Skip to content

293 add single header option to xcode project files #294

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
OneLoneCoder merged 2 commits into from
Sep 16, 2026
Merged

293 add single header option to xcode project files #294

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
2c30e7b
Issue293 Added Single Header project to xcode project file
Johnnyg63 Sep 15, 2026
0edfc5d
Enhance README with detailed XCode setup instructions
Johnnyg63 Sep 15, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
41 changes: 37 additions & 4 deletions dev/xcode_macos/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,14 +7,47 @@


<ul>
<li>Launch XCode and select **Clone and existing project** <br/> <img src="https://github.com/user-attachments/assets/6f3bab51-06e9-422d-acb8-27f5bfbce974"/></li>
<li>Enter the repo git link and click **Clone** <br/> <img src="https://github.com/user-attachments/assets/48273ab4-5941-43b0-ad2c-33adb70be23c" /> </li>
<li>Once the project is cloned, XCode will automatically detect the olcPGE3.xcodeproj folder and load the solution for you</li>
<li>Finally althought the olcPGE3.xcodeproj is displayed as a folder in GitHub, XCode will detected and display it as an XCode project <br/> <img src="https://github.com/user-attachments/assets/83453229-f3df-4f7f-a919-b842179abe64" /> </li>
<li>
1:Naviage to <a href="https://github.com/OneLoneCoder/olcPixelGameEngine3">https://github.com/OneLoneCoder/olcPixelGameEngine3</a><br/>
2: Select the <b>Main</b> branch <br/>
3: Click the green <b>Code</b> button dropdown <br/>
4: Click the <b>Copy</b> button to copy the git url <br/>
<img width="899" height="545" alt="image" src="https://github.com/user-attachments/assets/eda18c2a-c04b-4d33-9a6e-e9ccdab8847d" /><br/>
</li>
<li>
Launch XCode and select <b>Clone Git Repository...</b><br/>
<img width="688" height="420" alt="image" src="https://github.com/user-attachments/assets/a1316453-484b-4ee3-9db4-ea4271434f30" /><br/>
</li>
<li>
1 :Enter the repo git link and click <b>Clone</b> <br/>
<img width="688" height="420" alt="image" src="https://github.com/user-attachments/assets/2cbd1ba6-6df2-474c-bdde-fbbdca2ec4ff" /> <br/>
2: At the branch prompt select <b>main</b> <br/>
3: At the folder prompt select defaults <br/>
</li>
<li>
Open the xcode-macos folder and double click olcPGE3.xcodeproj<br>
<img width="1536" height="284" alt="image" src="https://github.com/user-attachments/assets/f116d949-c78f-41c9-ae14-50fd898239fd" /> <br/>
Wait for the project to load<br/>
</li>
<li>
1: Select Project Filter <br/>
2: Select Project,
<br/> - <b>olcPGE</b> is a Multi-header file, builds all headers in the **src** directory
<br/> - <b>olcPGE_SH</b> is a Single-header file (released version), builds the selected example in the <b>examples</b> directory using olcPixelGameEngine3.h
<img width="1385" height="888" alt="image" src="https://github.com/user-attachments/assets/12a0e283-5e9b-4a6d-bf33-1bb72f87899f" /> <br/>
3: Press play and watch the magic happen <br>
</li>
<li>
<hr/>
**IMPORTANT**<br/> This Xcode project is setup using all the defaults of xcode, therefore the debug/release folders are held within the xcode **Derived Data** folder, hence why the project is setup to auto copy the **assets** folder to the debug/release output. <br/>
If you use a different setup, please edit the xcode project settings to suit
<hr/>
</li>

</ul>

<p>
<ul >
<b>Some simple rules:</b>
<li>The olcPGE3.xcodeproj folder and files are all auto generated</li>
<li>The olcPGE3.xcodeproj folder and files should never be editied outside of XCode itself</li>
Expand Down
152 changes: 151 additions & 1 deletion dev/xcode_macos/olcPGE3.xcodeproj/project.pbxproj
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,11 +3,18 @@
archiveVersion = 1;
classes = {
};
objectVersion = 56;
objectVersion = 70;
objects = {

/* Begin PBXBuildFile section */
460496082E362F190047E223 /* test_mh.cpp in Sources */ = {isa = PBXBuildFile; fileRef = 460495FB2E300E0F0047E223 /* test_mh.cpp */; };
4610525930593E6D00C2BC3A /* OpenGL.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = 46E85DF82E39135B00B74FA3 /* OpenGL.framework */; };
4610525A30593E6D00C2BC3A /* MetalKit.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = 46B1E5942E40F8B0009734EC /* MetalKit.framework */; };
4610525B30593E6D00C2BC3A /* AppKit.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = 46B1E5922E40F8A6009734EC /* AppKit.framework */; };
4610525C30593E6D00C2BC3A /* Metal.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = 46E85DFC2E39137100B74FA3 /* Metal.framework */; };
4610525D30593E6D00C2BC3A /* QuartzCore.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = 46E85DFA2E39136800B74FA3 /* QuartzCore.framework */; };
4610525E30593E6D00C2BC3A /* Foundation.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = 46E85DF62E39135300B74FA3 /* Foundation.framework */; };
4610526630593EE400C2BC3A /* assets in CopyFiles */ = {isa = PBXBuildFile; fileRef = 4610526530593EE400C2BC3A /* assets */; };
46152BD72FE2DD1E00DCAC34 /* hw_touch.cpp in Sources */ = {isa = PBXBuildFile; fileRef = 46152BD62FE2DD1E00DCAC34 /* hw_touch.cpp */; };
462680A42E69D03800799C36 /* image.cpp in Sources */ = {isa = PBXBuildFile; fileRef = 460495EC2E300E000047E223 /* image.cpp */; };
462680A52E69D15C00799C36 /* OpenGL.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = 46E85DF82E39135B00B74FA3 /* OpenGL.framework */; };
Expand All @@ -32,6 +39,16 @@
/* End PBXBuildFile section */

/* Begin PBXCopyFilesBuildPhase section */
4610525F30593E6D00C2BC3A /* CopyFiles */ = {
isa = PBXCopyFilesBuildPhase;
buildActionMask = 12;
dstPath = "";
dstSubfolderSpec = 7;
files = (
4610526630593EE400C2BC3A /* assets in CopyFiles */,
);
runOnlyForDeploymentPostprocessing = 0;
};
8998CE1E2E057F4E007DDD96 /* CopyFiles */ = {
isa = PBXCopyFilesBuildPhase;
buildActionMask = 2147483647;
Expand Down Expand Up @@ -67,6 +84,9 @@
460495F12E300E000047E223 /* window.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = window.h; sourceTree = "<group>"; };
460495F22E300E000047E223 /* window.cpp */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.cpp.cpp; path = window.cpp; sourceTree = "<group>"; };
460495FB2E300E0F0047E223 /* test_mh.cpp */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.cpp.cpp; path = test_mh.cpp; sourceTree = "<group>"; };
4610522030593E6300C2BC3A /* olcPixelGameEngine3.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; name = olcPixelGameEngine3.h; path = /Users/mickymacm4/Documents/olcPixelGameEngine3_Issue293/olcPixelGameEngine3.h; sourceTree = "<absolute>"; };
4610526330593E6D00C2BC3A /* olcPGE3_SH */ = {isa = PBXFileReference; explicitFileType = "compiled.mach-o.executable"; includeInIndex = 0; path = olcPGE3_SH; sourceTree = BUILT_PRODUCTS_DIR; };
4610526530593EE400C2BC3A /* assets */ = {isa = PBXFileReference; lastKnownFileType = folder; name = assets; path = ../../examples/assets; sourceTree = "<group>"; };
46152BD52FE2DD1E00DCAC34 /* hw_touch.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = hw_touch.h; sourceTree = "<group>"; };
46152BD62FE2DD1E00DCAC34 /* hw_touch.cpp */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.cpp.cpp; path = hw_touch.cpp; sourceTree = "<group>"; };
462680D02E6C3C4500799C36 /* gpu_iface.cpp */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.cpp.cpp; path = gpu_iface.cpp; sourceTree = "<group>"; };
Expand Down Expand Up @@ -103,7 +123,64 @@
8998CE372E057F92007DDD96 /* transform2d.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = transform2d.h; sourceTree = "<group>"; };
/* End PBXFileReference section */

/* Begin PBXFileSystemSynchronizedBuildFileExceptionSet section */
4610526430593E6D00C2BC3A /* PBXFileSystemSynchronizedBuildFileExceptionSet */ = {
isa = PBXFileSystemSynchronizedBuildFileExceptionSet;
membershipExceptions = (
olcPGE3_AntiAliasing.cpp,
olcPGE3_BatchesOfFills.cpp,
olcPGE3_BatchesOfLines.cpp,
olcPGE3_BlendingModes.cpp,
olcPGE3_Camera2D_Tiles.cpp,
olcPGE3_CirclesEllipses.cpp,
olcPGE3_Extensions.cpp,
olcPGE3_Fish.cpp,
olcPGE3_FrameGraph.cpp,
"olcPGE3_ImageQuads-FromMemory.cpp",
olcPGE3_ImageQuads.cpp,
olcPGE3_ImageRect.cpp,
olcPGE3_ImageRegion.cpp,
olcPGE3_ImageScaleRotate.cpp,
olcPGE3_ImageTiling.cpp,
olcPGE3_Keyboard.cpp,
olcPGE3_Lines.cpp,
olcPGE3_LocalTransforms.cpp,
olcPGE3_Mouse.cpp,
olcPGE3_Pixels.cpp,
olcPGE3_PixelShaders.cpp,
olcPGE3_Polygons.cpp,
olcPGE3_Rectangles.cpp,
olcPGE3_Shockwave.cpp,
olcPGE3_SimplePixelShaders.cpp,
olcPGE3_TextBasics.cpp,
olcPGE3_TextFontMap.cpp,
olcPGE3_Touch.cpp,
olcPGE3_WorldTransform.cpp,
);
target = 4610524630593E6D00C2BC3A /* olcPGE3_SH */;
};
/* End PBXFileSystemSynchronizedBuildFileExceptionSet section */

/* Begin PBXFileSystemSynchronizedRootGroup section */
4610521930593E6300C2BC3A /* examples */ = {isa = PBXFileSystemSynchronizedRootGroup; exceptions = (4610526430593E6D00C2BC3A /* PBXFileSystemSynchronizedBuildFileExceptionSet */, ); explicitFileTypes = {}; explicitFolders = (); name = examples; path = /Users/mickymacm4/Documents/olcPixelGameEngine3_Issue293/examples; sourceTree = "<absolute>"; };
4610521F30593E6300C2BC3A /* extensions */ = {isa = PBXFileSystemSynchronizedRootGroup; explicitFileTypes = {}; explicitFolders = (); name = extensions; path = /Users/mickymacm4/Documents/olcPixelGameEngine3_Issue293/extensions; sourceTree = "<absolute>"; };
4610522730593E6300C2BC3A /* utilities */ = {isa = PBXFileSystemSynchronizedRootGroup; explicitFileTypes = {}; explicitFolders = (); name = utilities; path = /Users/mickymacm4/Documents/olcPixelGameEngine3_Issue293/utilities; sourceTree = "<absolute>"; };
/* End PBXFileSystemSynchronizedRootGroup section */

/* Begin PBXFrameworksBuildPhase section */
4610525830593E6D00C2BC3A /* Frameworks */ = {
isa = PBXFrameworksBuildPhase;
buildActionMask = 2147483647;
files = (
4610525930593E6D00C2BC3A /* OpenGL.framework in Frameworks */,
4610525A30593E6D00C2BC3A /* MetalKit.framework in Frameworks */,
4610525B30593E6D00C2BC3A /* AppKit.framework in Frameworks */,
4610525C30593E6D00C2BC3A /* Metal.framework in Frameworks */,
4610525D30593E6D00C2BC3A /* QuartzCore.framework in Frameworks */,
4610525E30593E6D00C2BC3A /* Foundation.framework in Frameworks */,
);
runOnlyForDeploymentPostprocessing = 0;
};
8998CE1D2E057F4E007DDD96 /* Frameworks */ = {
isa = PBXFrameworksBuildPhase;
buildActionMask = 2147483647;
Expand Down Expand Up @@ -136,6 +213,11 @@
8998CE172E057F4E007DDD96 = {
isa = PBXGroup;
children = (
4610526530593EE400C2BC3A /* assets */,
4610521930593E6300C2BC3A /* examples */,
4610521F30593E6300C2BC3A /* extensions */,
4610522030593E6300C2BC3A /* olcPixelGameEngine3.h */,
4610522730593E6300C2BC3A /* utilities */,
8998CE322E057F92007DDD96 /* src */,
8998CE2A2E057F85007DDD96 /* tests */,
46E85DF52E39135300B74FA3 /* Frameworks */,
Expand All @@ -147,6 +229,7 @@
isa = PBXGroup;
children = (
8998CE202E057F4E007DDD96 /* olcPGE3 */,
4610526330593E6D00C2BC3A /* olcPGE3_SH */,
);
name = Products;
sourceTree = "<group>";
Expand Down Expand Up @@ -220,6 +303,28 @@
/* End PBXGroup section */

/* Begin PBXNativeTarget section */
4610524630593E6D00C2BC3A /* olcPGE3_SH */ = {
isa = PBXNativeTarget;
buildConfigurationList = 4610526030593E6D00C2BC3A /* Build configuration list for PBXNativeTarget "olcPGE3_SH" */;
buildPhases = (
4610524730593E6D00C2BC3A /* Sources */,
4610525830593E6D00C2BC3A /* Frameworks */,
4610525F30593E6D00C2BC3A /* CopyFiles */,
);
buildRules = (
);
dependencies = (
);
fileSystemSynchronizedGroups = (
4610521930593E6300C2BC3A /* examples */,
4610521F30593E6300C2BC3A /* extensions */,
4610522730593E6300C2BC3A /* utilities */,
);
name = olcPGE3_SH;
productName = olcPGE3;
productReference = 4610526330593E6D00C2BC3A /* olcPGE3_SH */;
productType = "com.apple.product-type.tool";
};
8998CE1F2E057F4E007DDD96 /* olcPGE3 */ = {
isa = PBXNativeTarget;
buildConfigurationList = 8998CE272E057F4E007DDD96 /* Build configuration list for PBXNativeTarget "olcPGE3" */;
Expand All @@ -232,6 +337,11 @@
);
dependencies = (
);
fileSystemSynchronizedGroups = (
4610521930593E6300C2BC3A /* examples */,
4610521F30593E6300C2BC3A /* extensions */,
4610522730593E6300C2BC3A /* utilities */,
);
name = olcPGE3;
productName = olcPGE3;
productReference = 8998CE202E057F4E007DDD96 /* olcPGE3 */;
Expand Down Expand Up @@ -265,11 +375,19 @@
projectRoot = "";
targets = (
8998CE1F2E057F4E007DDD96 /* olcPGE3 */,
4610524630593E6D00C2BC3A /* olcPGE3_SH */,
);
};
/* End PBXProject section */

/* Begin PBXSourcesBuildPhase section */
4610524730593E6D00C2BC3A /* Sources */ = {
isa = PBXSourcesBuildPhase;
buildActionMask = 2147483647;
files = (
);
runOnlyForDeploymentPostprocessing = 0;
};
8998CE1C2E057F4E007DDD96 /* Sources */ = {
isa = PBXSourcesBuildPhase;
buildActionMask = 2147483647;
Expand All @@ -296,6 +414,29 @@
/* End PBXSourcesBuildPhase section */

/* Begin XCBuildConfiguration section */
4610526130593E6D00C2BC3A /* Debug */ = {
isa = XCBuildConfiguration;
buildSettings = {
CODE_SIGN_STYLE = Automatic;
DEVELOPMENT_TEAM = "";
ENABLE_HARDENED_RUNTIME = YES;
HEADER_SEARCH_PATHS = "$[PROJECT_DIR]/";
PRODUCT_NAME = "$(TARGET_NAME)";
};
name = Debug;
};
4610526230593E6D00C2BC3A /* Release */ = {
isa = XCBuildConfiguration;
buildSettings = {
"CODE_SIGN_IDENTITY[sdk=macosx*]" = "-";
CODE_SIGN_STYLE = Automatic;
DEVELOPMENT_TEAM = "";
ENABLE_HARDENED_RUNTIME = YES;
HEADER_SEARCH_PATHS = "$[PROJECT_DIR]/";
PRODUCT_NAME = "$(TARGET_NAME)";
};
name = Release;
};
8998CE252E057F4E007DDD96 /* Debug */ = {
isa = XCBuildConfiguration;
buildSettings = {
Expand Down Expand Up @@ -430,6 +571,15 @@
/* End XCBuildConfiguration section */

/* Begin XCConfigurationList section */
4610526030593E6D00C2BC3A /* Build configuration list for PBXNativeTarget "olcPGE3_SH" */ = {
isa = XCConfigurationList;
buildConfigurations = (
4610526130593E6D00C2BC3A /* Debug */,
4610526230593E6D00C2BC3A /* Release */,
);
defaultConfigurationIsVisible = 0;
defaultConfigurationName = Release;
};
8998CE1B2E057F4E007DDD96 /* Build configuration list for PBXProject "olcPGE3" */ = {
isa = XCConfigurationList;
buildConfigurations = (
Expand Down
79 changes: 79 additions & 0 deletions dev/xcode_macos/olcPGE3.xcodeproj/xcshareddata/xcschemes/olcPGE3_SH.xcscheme
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,79 @@
<?xml version="1.0" encoding="UTF-8"?>
<Scheme
LastUpgradeVersion = "2630"
version = "1.7">
<BuildAction
parallelizeBuildables = "YES"
buildImplicitDependencies = "YES"
buildArchitectures = "Automatic">
<BuildActionEntries>
<BuildActionEntry
buildForTesting = "YES"
buildForRunning = "YES"
buildForProfiling = "YES"
buildForArchiving = "YES"
buildForAnalyzing = "YES">
<BuildableReference
BuildableIdentifier = "primary"
BlueprintIdentifier = "4610524630593E6D00C2BC3A"
BuildableName = "olcPGE3_SH"
BlueprintName = "olcPGE3_SH"
ReferencedContainer = "container:olcPGE3.xcodeproj">
</BuildableReference>
</BuildActionEntry>
</BuildActionEntries>
</BuildAction>
<TestAction
buildConfiguration = "Debug"
selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
shouldUseLaunchSchemeArgsEnv = "YES"
shouldAutocreateTestPlan = "YES">
</TestAction>
<LaunchAction
buildConfiguration = "Debug"
selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
launchStyle = "0"
useCustomWorkingDirectory = "NO"
ignoresPersistentStateOnLaunch = "NO"
debugDocumentVersioning = "YES"
debugServiceExtension = "internal"
allowLocationSimulation = "YES"
viewDebuggingEnabled = "No">
<BuildableProductRunnable
runnableDebuggingMode = "0">
<BuildableReference
BuildableIdentifier = "primary"
BlueprintIdentifier = "4610524630593E6D00C2BC3A"
BuildableName = "olcPGE3_SH"
BlueprintName = "olcPGE3_SH"
ReferencedContainer = "container:olcPGE3.xcodeproj">
</BuildableReference>
</BuildableProductRunnable>
</LaunchAction>
<ProfileAction
buildConfiguration = "Release"
shouldUseLaunchSchemeArgsEnv = "YES"
savedToolIdentifier = ""
useCustomWorkingDirectory = "NO"
debugDocumentVersioning = "YES">
<BuildableProductRunnable
runnableDebuggingMode = "0">
<BuildableReference
BuildableIdentifier = "primary"
BlueprintIdentifier = "4610524630593E6D00C2BC3A"
BuildableName = "olcPGE3_SH"
BlueprintName = "olcPGE3_SH"
ReferencedContainer = "container:olcPGE3.xcodeproj">
</BuildableReference>
</BuildableProductRunnable>
</ProfileAction>
<AnalyzeAction
buildConfiguration = "Debug">
</AnalyzeAction>
<ArchiveAction
buildConfiguration = "Release"
revealArchiveInOrganizer = "YES">
</ArchiveAction>
</Scheme>