Added README.

README is untested and unproofed but I believe I picked up all the salient points to make things work.

Author: mharper

ObjCApp/ViewController.m

@@ -17,10 +17,8 @@ @implementation ViewController
 
 - (void)viewDidLoad {
   [super viewDidLoad];
-  SimpleClass *sc = [[SimpleClass alloc] init:@"Dammit Objective C!!!"];
+  SimpleClass *sc = [[SimpleClass alloc] init:@"Hello Swift framework from Objective C!!!"];
   [sc printMessage];
-  
-  // Do any additional setup after loading the view, typically from a nib.
 }
 
 - (void)didReceiveMemoryWarning {

README.md

@@ -0,0 +1,91 @@
+# SimpleFramework
+
+## Overview
+
+The purpose of this project is to demonstrate (and remember) how to create a Swift framework for iOS that in turn uses Objective-C code.  Then, this framework is used by two different iOS apps -- one Swift and one Objective-C.
+
+## Creating the Framework
+
+1. Create a new Xcode project.
+1. Create a new Cocoa Touch framework target using Swift.
+2. Create a new Objective C Cocoa Touch class named `SFClass` as a subclass of `NSObject`.
+3. Select `SFClass.h` and make sure its Target Membership is `SimpleFramework` _and_ "Public". Turns out this is _critical_.
+3. Add the following code to `SFClass.h`:
+
+ ```
+ -(void) printMessage:(NSString *) message;
+
+ ```
+
+1. Add the following code to `SFClass.m`:
+
+ ```
+-(void) printMessage:(NSString *) message {
+  NSLog(@"The message is %@", message);
+}
+
+ ```
+
+1. Create a new Swift class named `SimpleClass` as a subclass of `NSObject` and add the following code to `SimpleClass.swift`. Note the usage of `public` in front of the class, the initializer, and the `printMessage` method. This makes the class and methods available to those who consume the framework.
+
+ ```
+public class SimpleClass: NSObject {
+  
+  var message: String
+  var object: SFClass = SFClass()
+  
+  public init(_ newMessage: String) {
+    self.message = newMessage
+  }
+  
+  public func printMessage() {
+    object.printMessage(self.message)
+  }
+}
+ ```
+1. When you created the framework target, Xcode automatically created `SimpleFramework.h` for you. Add the following to that file:
+
+ ```
+#import "SFClass.h"
+ ```
+
+## Consuming the Framework from a Swift app
+
+1. Create a new single-view iOS app target in the project and name it `SwiftApp` and use Swift.
+2. Select the new target and go to the `General` settings.  Under `Embedded Binaries`, click the `+` and add `SimpleFramework.framework`.
+3. In the `ViewController.swift` file that was created, add the following line at the top:
+
+ ```
+ import SimpleFramework
+ ```
+ 
+ and the following method should replace the existing `viewDidLoad`:
+ 
+ ```
+  override func viewDidLoad() {
+    super.viewDidLoad()
+    let sc = SimpleClass("Hello Swift framework from Swift!!!")
+    sc.printMessage()
+  }
+```
+
+## Consuming the Framework from an Objective-C app
+1. Create a new single-view iOS app target in the project and name it `ObjCApp` and use Objective C.
+2. Select the new target and go to the `General` settings.  Under `Embedded Binaries`, click the `+` and add `SimpleFramework.framework`.
+3. Under the `Build Settings` for the target, find the setting for `Embedded Content Contains Swift Code` and set it to `Yes`.
+4. In the ViewController.m file that was created, add the following line at the top:
+
+ ```
+ @import SimpleFramework;
+ ```
+ 
+ and the following method should replace the existing `viewDidLoad`:
+ 
+ ```
+- (void)viewDidLoad {
+  [super viewDidLoad];
+  SimpleClass *sc = [[SimpleClass alloc] init:@"Hello Swift framework from Objective C!!!"];
+  [sc printMessage];
+}
+```
+

SimpleFramework.xcodeproj/project.pbxproj

@@ -106,6 +106,7 @@
 		D8AA993219E47B0C00CEAFA5 /* Base */ = {isa = PBXFileReference; lastKnownFileType = file.storyboard; name = Base; path = Base.lproj/Main.storyboard; sourceTree = "<group>"; };
 		D8AA993419E47B0C00CEAFA5 /* Images.xcassets */ = {isa = PBXFileReference; lastKnownFileType = folder.assetcatalog; path = Images.xcassets; sourceTree = "<group>"; };
 		D8AA993719E47B0C00CEAFA5 /* Base */ = {isa = PBXFileReference; lastKnownFileType = file.xib; name = Base; path = Base.lproj/LaunchScreen.xib; sourceTree = "<group>"; };
+		D8AA995019E4801700CEAFA5 /* README.md */ = {isa = PBXFileReference; lastKnownFileType = net.daringfireball.markdown; path = README.md; sourceTree = "<group>"; };
 /* End PBXFileReference section */
 
 /* Begin PBXFrameworksBuildPhase section */
@@ -146,6 +147,7 @@
 		D8AA98C419E4665900CEAFA5 = {
 			isa = PBXGroup;
 			children = (
+				D8AA995019E4801700CEAFA5 /* README.md */,
 				D8AA98D019E4665900CEAFA5 /* SimpleFramework */,
 				D8AA98DA19E4665900CEAFA5 /* SimpleFrameworkTests */,
 				D8AA98FB19E4769200CEAFA5 /* SwiftApp */,

SwiftApp/ViewController.swift

@@ -13,7 +13,7 @@ class ViewController: UIViewController {
 
   override func viewDidLoad() {
     super.viewDidLoad()
-    let sc = SimpleClass("Dammit Swift!!!")
+    let sc = SimpleClass("Hello Swift framework from Swift!!!")
     sc.printMessage()
   }