Clarify the framework conversion section

Also, switch to embedding the Swift standard
libraries in the app's Frameworks directory.
It works just as well (@executable_path/../Frameworks
is one of the framework's rpaths) and is
consistent with typical Swift apps.

Author: nanotech

README.md

@@ -201,22 +201,56 @@ Text marked as `{}` will vary.
 
 ## Converting the Swift App to a Framework
 
-Create a new Cocoa Framework target in the Xcode project
-named SwiftAppLibrary, then change the Target Membership of
-`AppDelegate.swift` and `MainMenu.xib` to only SwiftAppLibrary
-in Xcode's File Inspector in the right sidebar:
+Create a new Cocoa Framework target in the Xcode project,
+
+![Select the Cocoa Framework template](tutorial/xcode-cocoa-framework-template-icon.png)
+
+with Swift as the default language.
+
+![Select Swift as the default language](tutorial/xcode-create-project-language-swift.png)
+
+Name the framework SwiftAppLibrary.
+
+### Framework Configuration
+
+To move over our application code and UI, change the Target
+Membership of `AppDelegate.swift` and `MainMenu.xib` in Xcode's
+File Inspector in the right sidebar so that they are only
+included in SwiftAppLibrary:
 
 ![Target Membership](tutorial/xcode-target-membership.png)
 
-In the new framework's build settings, set **Always Embed Swift
-Standard Libraries** to **Yes**.
+Xcode will place the built framework in a temporary directory
+(`~/Library/Developer/Xcode/DerivedData/`) with an unpredictable
+subpath. So that Cabal will be able to find the framework for
+linking, add a new **Run Script** build phase to create a
+symlink to the built framework in `build/`:
+
+```sh
+set -u
+ln -sf "${BUILT_PRODUCTS_DIR}/${FULL_PRODUCT_NAME}" "${PROJECT_DIR}/build/"
+```
+
+### App Bundle Configuration
 
 Drag the `SwiftHaskell` executable we built previously with
 Stack into Xcode from the `build/` directory that we symlinked
 it into, but do not add it to any targets when prompted:
 
 ![The SwiftHaskell executable in Xcode](tutorial/xcode-files-swifthaskell-executable.png)
 
+When Xcode creates Swift frameworks, it expects that the
+application that links the framework will include the Swift
+standard libraries. Xcode automatically adds these libraries to
+Swift applications. Since our application executable is built
+with Haskell and not Swift, we'll need to explicitly tell Xcode
+to include the Swift standard libraries in our application.
+
+In the app target's Build Settings tab, set **Always Embed Swift
+Standard Libraries** to **Yes**:
+
+![Always Embed Swift Standard Libraries: Yes](tutorial/xcode-embed-swift-standard-libs.png)
+
 In the SwiftHaskell app target's Build Phases, remove the
 **Compile Sources** and **Link Binary With Libraries**
 phases, and add a new **Copy Files** phase that copies the
@@ -227,14 +261,6 @@ directory:
 
 ![Copy into Executables](tutorial/xcode-copy-files-swifthaskell-executable.png)
 
-Finally, in the SwiftAppLibrary framework target's Build Phases,
-add a new **Run Script** phase to create a symlink to the built
-framework for us to link to from Cabal:
-
-```sh
-set -u
-ln -sf "${BUILT_PRODUCTS_DIR}/${FULL_PRODUCT_NAME}" "${PROJECT_DIR}/build/"
-```
 
 Build the SwiftAppLibrary framework in Xcode to prepare for the
 next sections.

SwiftHaskell.xcodeproj/project.pbxproj

@@ -395,7 +395,6 @@
 		BFABC4641E4C1DD1006036C6 /* Debug */ = {
 			isa = XCBuildConfiguration;
 			buildSettings = {
-				ALWAYS_EMBED_SWIFT_STANDARD_LIBRARIES = YES;
 				CODE_SIGN_IDENTITY = "";
 				COMBINE_HIDPI_IMAGES = YES;
 				DEFINES_MODULE = YES;
@@ -423,7 +422,6 @@
 		BFABC4651E4C1DD1006036C6 /* Release */ = {
 			isa = XCBuildConfiguration;
 			buildSettings = {
-				ALWAYS_EMBED_SWIFT_STANDARD_LIBRARIES = YES;
 				CODE_SIGN_IDENTITY = "";
 				COMBINE_HIDPI_IMAGES = YES;
 				DEFINES_MODULE = YES;
@@ -450,6 +448,7 @@
 		BFABC4E61E4D781D006036C6 /* Debug */ = {
 			isa = XCBuildConfiguration;
 			buildSettings = {
+				ALWAYS_EMBED_SWIFT_STANDARD_LIBRARIES = YES;
 				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
 				COMBINE_HIDPI_IMAGES = YES;
 				INFOPLIST_FILE = SwiftHaskell/Info.plist;
@@ -462,6 +461,7 @@
 		BFABC4E71E4D781D006036C6 /* Release */ = {
 			isa = XCBuildConfiguration;
 			buildSettings = {
+				ALWAYS_EMBED_SWIFT_STANDARD_LIBRARIES = YES;
 				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
 				COMBINE_HIDPI_IMAGES = YES;
 				INFOPLIST_FILE = SwiftHaskell/Info.plist;