From e4e76ac72e4041617b8434672ea11d5c1f020cc3 Mon Sep 17 00:00:00 2001
From: Sam Lantinga <[EMAIL REDACTED]>
Date: Mon, 13 Jan 2025 13:50:02 -0800
Subject: [PATCH] Added INTRO-xcode.md
---
docs/INTRO-xcode.md | 16 ++++++++++++++++
1 file changed, 16 insertions(+)
create mode 100644 docs/INTRO-xcode.md
diff --git a/docs/INTRO-xcode.md b/docs/INTRO-xcode.md
new file mode 100644
index 0000000000000..5f0a62aba8963
--- /dev/null
+++ b/docs/INTRO-xcode.md
@@ -0,0 +1,16 @@
+
+# Introduction to SDL with Xcode
+
+The easiest way to use SDL is to include it as a subproject in your project.
+
+We'll start by creating a simple project to build and run [hello.c](hello.c)
+
+- Create a new project in Xcode, using the App template and selecting Objective C as the language
+- Remove the .h and .m files that were automatically added to the project
+- Remove the main storyboard that was automatically added to the project
+- On iOS projects, select the project, select the main target, select the Info tab, look for "Custom iOS Target Properties", and remove "Main storyboard base file name" and "Application Scene Manifest"
+- Right click the project and select "Add Files to [project]", navigate to the SDL docs directory and add the file hello.c
+- Right click the project and select "Add Files to [project]", navigate to the SDL Xcode/SDL directory and add SDL.xcodeproj
+- Select the project, select the main target, select the General tab, look for "Frameworks, Libaries, and Embedded Content", and add SDL3.framework
+- Build and run!
+