From 46e2b3ac182f632efafff19041cc91abb80f68d2 Mon Sep 17 00:00:00 2001 From: Steve Mitchell Date: Sun, 29 Sep 2024 10:47:48 -0400 Subject: [PATCH 1/2] Update QuickStartGuide - add library --- Docs/QuickStartGuide.md | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/Docs/QuickStartGuide.md b/Docs/QuickStartGuide.md index d3fe74e..bfaf60a 100644 --- a/Docs/QuickStartGuide.md +++ b/Docs/QuickStartGuide.md @@ -4,9 +4,11 @@ This is a quick start guide to creating the most minimal Turbo iOS application f 1. First, create a new iOS app from the Xcode File > New > Project menu and choose the default iOS "App" template. Note: When using XCode >= 12, be sure to choose "Storyboard" under "Interface" and "UIKit App Delegate" under "Lifecycle" in the project creation dialog. -2. Select your app's main top-level project, go to the Swift Packages tab and add the Turbo iOS dependency by entering in `https://github.com/hotwired/turbo-ios`. +2. Select your app's main top-level project in the Navigator panel, and select the project in the Project and Targets list, and go to the Dependencies tab and add the Turbo iOS dependency by entering in `https://github.com/hotwired/turbo-ios`. -3. Open the `SceneDelegate`, and replace the entire file with this code: +3. In the Project and Targets List, select the main Target, and in the General tab, scroll down to Frameworks, Libraries, and Embedded Content. Add the Turbo Library within the Turbo Package. + +4. Open the `SceneDelegate`, and replace the entire file with this code: ```swift import UIKit import Turbo @@ -49,8 +51,8 @@ extension SceneDelegate: SessionDelegate { } ``` -4. Hit run, and you have a basic working app. You can now tap links and navigate the demo back and forth in the simulator. We've only touched the very core requirements here of creating a `Session` and handling a visit. +5. Hit run, and you have a basic working app. You can now tap links and navigate the demo back and forth in the simulator. We've only touched the very core requirements here of creating a `Session` and handling a visit. -5. You can change the url we use for the initial visit to your web app. Note: if you're running your app locally without https, you'll need to adjust your `NSAppTransportSecurity` settings in the Info.plist to allow arbitrary loads. +6. You can change the url we use for the initial visit to your web app. Note: if you're running your app locally without https, you'll need to adjust your `NSAppTransportSecurity` settings in the Info.plist to allow arbitrary loads. -6. A real application will want to customize the view controller, respond to different visit actions, gracefully handle errors, and build a more powerful routing system. Read the rest of the documentation to learn more. +7. A real application will want to customize the view controller, respond to different visit actions, gracefully handle errors, and build a more powerful routing system. Read the rest of the documentation to learn more. From 551ae070ce1f6345db08f44b4b6a1411562307e2 Mon Sep 17 00:00:00 2001 From: Steve Mitchell Date: Sun, 29 Sep 2024 10:59:33 -0400 Subject: [PATCH 2/2] XCode > 12 should be default --- Docs/QuickStartGuide.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Docs/QuickStartGuide.md b/Docs/QuickStartGuide.md index bfaf60a..e8bf3bd 100644 --- a/Docs/QuickStartGuide.md +++ b/Docs/QuickStartGuide.md @@ -2,9 +2,9 @@ This is a quick start guide to creating the most minimal Turbo iOS application from scratch get up and running in a few minutes. This will support basic back/forward navigation, but will not be a fully functional application. -1. First, create a new iOS app from the Xcode File > New > Project menu and choose the default iOS "App" template. Note: When using XCode >= 12, be sure to choose "Storyboard" under "Interface" and "UIKit App Delegate" under "Lifecycle" in the project creation dialog. +1. First, create a new iOS app from the Xcode File > New > Project menu and choose the default iOS "App" template. Be sure to choose "Storyboard" under "Interface" in the project creation dialog. -2. Select your app's main top-level project in the Navigator panel, and select the project in the Project and Targets list, and go to the Dependencies tab and add the Turbo iOS dependency by entering in `https://github.com/hotwired/turbo-ios`. +2. Select your app's main top-level project in the Navigator panel, and select the project in the Project and Targets list, and go to the Package Dependencies tab and add the Turbo iOS dependency by entering in `https://github.com/hotwired/turbo-ios`. 3. In the Project and Targets List, select the main Target, and in the General tab, scroll down to Frameworks, Libraries, and Embedded Content. Add the Turbo Library within the Turbo Package.