Merge pull request #23 from Shopify/runmad.dynamic-framework-cocoapods

Dynamic framework, Cocoapods fixes, Carthage support, readmes

.gitignore

-Ibuild/*
-*/Output/*
+# Xcode
+#
+# gitignore contributors: remember to update Global/Xcode.gitignore, Objective-C.gitignore & Swift.gitignore
+
+## Build generated
+build/
+DerivedData
+
+## Various settings
 *.pbxuser
 !default.pbxuser
 *.mode1v3
@@ -9,14 +16,16 @@ Ibuild/*
 *.perspectivev3
 !default.perspectivev3
 xcuserdata
+
+## Other
 *.xccheckout
 *.moved-aside
-DerivedData
-*.hmap
-*.ipa
 *.xcuserstate
-Pods/
-.DS_Store
+*.xcscmblueprint
 .ruby-version
 *Sample*/Buy.framework
 *-INTERNAL.*
+
+## Obj-C/Swift specific
+*.hmap
+*.ipa

Mobile Buy SDK Sample Apps/Sample App Advanced/Mobile Buy SDK Advanced Sample/Info.plist

@@ -15,7 +15,7 @@
 	<key>CFBundlePackageType</key>
 	<string>APPL</string>
 	<key>CFBundleShortVersionString</key>
-	<string>1.2</string>
+	<string>1.2.1</string>
 	<key>CFBundleSignature</key>
 	<string>????</string>
 	<key>CFBundleURLTypes</key>

Mobile Buy SDK Sample Apps/Sample App Advanced/Mobile Buy SDK Advanced Sample/ProductListViewController.m

@@ -67,7 +67,11 @@
 - (void)viewDidLoad {
     [super viewDidLoad];
     
-    self.title = @"Products";
+    if (self.collection) {
+        self.title = self.collection.title;
+    } else {
+        self.title = @"All Products";
+    }
     
     [self.tableView registerClass:[UITableViewCell class] forCellReuseIdentifier:@"Cell"];
     [self.tableView registerClass:[ProductViewControllerToggleTableViewCell class] forCellReuseIdentifier:@"ProductViewControllerToggleCell"];

Mobile Buy SDK Sample Apps/Sample App Advanced/README.md

+# Mobile Buy SDK Advanced Sample App
+
+The Advanced Sample App demonstrates how to perform several tasks related to creating a checkout.
+
+- Fetch collections
+- Fetch products
+- Optionally present using the `BUYProductViewController`
+- Create a checkout
+- Apply shipping rate
+- Apply gift cards and discounts
+- Complete checkout via web view, native checkout implementation, and Apple Pay
+
+### Getting started
+
+First, add your shop domain, API key and Channel ID to the `CollectionListViewController.m` macros.
+
+```objc
+#define SHOP_DOMAIN @"<shop_domain>"
+#define API_KEY @"<api_key>"
+#define CHANNEL_ID @"<channel_id>"
+```
+
+
+### Overview
+
+The Advanced Sample App demonstrates several tasks that can be performed using the Mobile Buy SDK.  Each task is broken up into seperate view controllers. Polling endpoints are represented as NSOperations which can easily be utilized in your own apps.
+
+### Classes
+#### View Controllers
+
+###### `CollectionListViewController`
+* Initializes the `BUYClient`
+* Fetches collections and displays them in a list
+* Optionally allows for fetch of the first product page
+
+###### `ProductListViewController`
+* Fetches the products and displays them in a list
+* Can present a product using the `BUYProductViewController` and demo the theme settings on the controller, or
+* Creates a checkout with the selected product and pushes to the `ShippingRatesTableViewController`
+
+###### `ShippingRatesTableViewController`
+* Fetches the shipping rates for the checkout using `GetShippingRatesOperation`
+* Updates the checkout with the selected shipping rate and pushes to the `PreCheckoutViewController`
+
+###### `PreCheckoutViewController`
+* Displays a summary of the checkout
+* Allows for discounts and gift cards to be added to the checkout
+
+###### `CheckoutViewController`
+* Displays a summary of the checkout
+* Checkout using a credit card
+* Web checkout using Safari
+* Checkout using Apple Pay
+
+#### `NSOperation`s
+
+###### `GetShopOperation`
+* `NSOperation` based class to fetch the shop object
+
+###### `GetShippingRatesOperation`
+* `NSOperation` based class to poll for shipping rates
+
+###### `GetCompletionStatusOperation`
+* `NSOperation` based class to poll for the checkout completion status
+
+### Apple Pay
+
+Apple Pay is implemented in the CheckoutViewController.  It utilizes the `BUYApplePayHelpers` class which acts as the delegate for the `PKPaymentAuthorizationViewController`.  Setting the `MerchantId` is required to use Apple Pay.  For more information about supporting Apple Pay in your app, please consult [https://docs.shopify.com/mobile-buy-sdk/ios/enable-apple-pay](https://docs.shopify.com/mobile-buy-sdk/ios/enable-apple-pay).

Mobile Buy SDK Sample Apps/Sample App Swift/Mobile Buy SDK Swift Sample/Info.plist

@@ -15,7 +15,7 @@
 	<key>CFBundlePackageType</key>
 	<string>APPL</string>
 	<key>CFBundleShortVersionString</key>
-	<string>1.2</string>
+	<string>1.2.1</string>
 	<key>CFBundleSignature</key>
 	<string>????</string>
 	<key>CFBundleVersion</key>

Mobile Buy SDK Sample Apps/Sample App Swift/Mobile Buy SDK Swift Sample/ViewController.swift

@@ -25,6 +25,7 @@
 //
 
 import UIKit
+import Buy
 
 class ViewController: UIViewController {
 

Mobile Buy SDK Sample Apps/Sample App Swift/README.md

+# Mobile Buy SDK Sample Swift App
+
+The Swift sample app demonstrates how to use the SDK within a Swift app. The app includes an Objective-C bridging header.
+
+### Getting started
+
+First, add your shop domain, API key and Channel ID to the `ViewController.swift`.
+
+```swift
+let shopDomain = ""
+let apiKey = ""
+let channelId = ""
+let productId = ""
+```
+
+### Overview
+
+The sample app also demonstrates how to use the `BUYClient` to obtain a product by calling `getProductById()`.
+
+```swift
+client.getProductById(productId) { (product, error) -> Void in
+}
+```

Mobile Buy SDK Sample Apps/Sample App Web/Mobile Buy SDK Web Sample/Info.plist

@@ -15,7 +15,7 @@
 	<key>CFBundlePackageType</key>
 	<string>APPL</string>
 	<key>CFBundleShortVersionString</key>
-	<string>1.2</string>
+	<string>1.2.1</string>
 	<key>CFBundleSignature</key>
 	<string>????</string>
 	<key>CFBundleVersion</key>

Mobile Buy SDK Sample Apps/Sample App Web/README.md

+# Mobile Buy SDK Sample Web App
+
+The web sample app demonstrates how you can load your shop's website in a webview, and support Apple Pay.
+
+### Getting started
+
+First, add your shop domain, API key and Channel ID to the `AppDelegate.h` macros.
+
+```objc
+#define SHOP_DOMAIN @"<shop_domain>"
+#define API_KEY @"<api_key>"
+#define CHANNEL_ID @"<channel_id>"
+```
+	
+To support Apple Pay, add your Merchant ID as well.
+
+```objc
+#define MERCHANT_ID @"<merchant_id>"
+```
+
+### Overview
+
+The sample app instantiates a view controller which is a subclass of `BUYStoreViewController`.  This displays a webview with your shop, but intercepts the checkout to support Apple Pay.
+
+The sample app also demonstrates how to use the `BUYClient` to obtain shop details by calling `getShop:`
+
+```objc
+[self.provider getShop:^(BUYShop *shop, NSError *error) {
+    dispatch_async(dispatch_get_main_queue(), ^{
+        if (error == nil && shop) {
+            self.title = shop.name;
+        }
+        else {
+            NSLog(@"Error fetching shop: %@", error.localizedDescription);
+        }
+    });
+}];
+```

Mobile Buy SDK.xcworkspace/contents.xcworkspacedata

-<?xml version="1.0" encoding="UTF-8"?>
-<Workspace
-   version = "1.0">
-   <FileRef
-      location = "group:Mobile Buy SDK/Mobile Buy SDK.xcodeproj">
-   </FileRef>
-   <FileRef
-      location = "group:Mobile Buy SDK Sample Apps/Sample App Web/Mobile Buy SDK Web Sample.xcodeproj">
-   </FileRef>
-   <FileRef
-      location = "group:Mobile Buy SDK Sample Apps/Sample App Swift/Mobile Buy SDK Swift Sample.xcodeproj">
-   </FileRef>
-   <FileRef
-      location = "group:Mobile Buy SDK Sample Apps/Sample App Advanced/Mobile Buy SDK Advanced Sample.xcodeproj">
-   </FileRef>
-</Workspace>

Mobile Buy SDK.xcworkspace/xcshareddata/Mobile Buy SDK.xcscmblueprint

-{
-  "DVTSourceControlWorkspaceBlueprintPrimaryRemoteRepositoryKey" : "150992371D08DE0BC2C0F7D24AB62392DB6F1E4C",
-  "DVTSourceControlWorkspaceBlueprintWorkingCopyRepositoryLocationsKey" : {
-
-  },
-  "DVTSourceControlWorkspaceBlueprintWorkingCopyStatesKey" : {
-    "150992371D08DE0BC2C0F7D24AB62392DB6F1E4C" : 0,
-    "B8AB7D59AD74F224C9D65CE20D7D3C30D5100598" : 0,
-    "27386CDE6C45B5519FB1AD62B45ACA8C18A2EFF0" : 0
-  },
-  "DVTSourceControlWorkspaceBlueprintIdentifierKey" : "F65CB188-9FFA-4AD7-8982-12C88FB79C9D",
-  "DVTSourceControlWorkspaceBlueprintWorkingCopyPathsKey" : {
-    "150992371D08DE0BC2C0F7D24AB62392DB6F1E4C" : "mobile-buy-sdk-ios\/",
-    "B8AB7D59AD74F224C9D65CE20D7D3C30D5100598" : "mobile-buy-sdk-private",
-    "27386CDE6C45B5519FB1AD62B45ACA8C18A2EFF0" : "mobile-buy-sdk-private\/Submodules"
-  },
-  "DVTSourceControlWorkspaceBlueprintNameKey" : "Mobile Buy SDK",
-  "DVTSourceControlWorkspaceBlueprintVersion" : 204,
-  "DVTSourceControlWorkspaceBlueprintRelativePathToProjectKey" : "Mobile Buy SDK.xcworkspace",
-  "DVTSourceControlWorkspaceBlueprintRemoteRepositoriesKey" : [
-    {
-      "DVTSourceControlWorkspaceBlueprintRemoteRepositoryURLKey" : "github.com:Shopify\/mobile-buy-sdk-ios.git",
-      "DVTSourceControlWorkspaceBlueprintRemoteRepositorySystemKey" : "com.apple.dt.Xcode.sourcecontrol.Git",
-      "DVTSourceControlWorkspaceBlueprintRemoteRepositoryIdentifierKey" : "150992371D08DE0BC2C0F7D24AB62392DB6F1E4C"
-    },
-    {
-      "DVTSourceControlWorkspaceBlueprintRemoteRepositoryURLKey" : "github.com:Shopify\/BUYPaymentButton.git",
-      "DVTSourceControlWorkspaceBlueprintRemoteRepositorySystemKey" : "com.apple.dt.Xcode.sourcecontrol.Git",
-      "DVTSourceControlWorkspaceBlueprintRemoteRepositoryIdentifierKey" : "27386CDE6C45B5519FB1AD62B45ACA8C18A2EFF0"
-    },
-    {
-      "DVTSourceControlWorkspaceBlueprintRemoteRepositoryURLKey" : "github.com:Shopify\/mobile-buy-sdk-private.git",
-      "DVTSourceControlWorkspaceBlueprintRemoteRepositorySystemKey" : "com.apple.dt.Xcode.sourcecontrol.Git",
-      "DVTSourceControlWorkspaceBlueprintRemoteRepositoryIdentifierKey" : "B8AB7D59AD74F224C9D65CE20D7D3C30D5100598"
-    }
-  ]
-}
\ No newline at end of file

Mobile Buy SDK/Mobile Buy SDK.xcodeproj/xcshareddata/xcschemes/Buy Dynamic.xcscheme

+<?xml version="1.0" encoding="UTF-8"?>
+<Scheme
+   LastUpgradeVersion = "0700"
+   version = "1.3">
+   <BuildAction
+      parallelizeBuildables = "YES"
+      buildImplicitDependencies = "YES">
+      <BuildActionEntries>
+         <BuildActionEntry
+            buildForTesting = "YES"
+            buildForRunning = "YES"
+            buildForProfiling = "YES"
+            buildForArchiving = "YES"
+            buildForAnalyzing = "YES">
+            <BuildableReference
+               BuildableIdentifier = "primary"
+               BlueprintIdentifier = "901930E11BC5B9BC00D1134E"
+               BuildableName = "Buy.framework"
+               BlueprintName = "Buy Dynamic"
+               ReferencedContainer = "container:Mobile Buy SDK.xcodeproj">
+            </BuildableReference>
+         </BuildActionEntry>
+      </BuildActionEntries>
+   </BuildAction>
+   <TestAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      shouldUseLaunchSchemeArgsEnv = "YES">
+      <Testables>
+      </Testables>
+      <AdditionalOptions>
+      </AdditionalOptions>
+   </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">
+      <MacroExpansion>
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "901930E11BC5B9BC00D1134E"
+            BuildableName = "Buy.framework"
+            BlueprintName = "Buy Dynamic"
+            ReferencedContainer = "container:Mobile Buy SDK.xcodeproj">
+         </BuildableReference>
+      </MacroExpansion>
+      <AdditionalOptions>
+      </AdditionalOptions>
+   </LaunchAction>
+   <ProfileAction
+      buildConfiguration = "Release"
+      shouldUseLaunchSchemeArgsEnv = "YES"
+      savedToolIdentifier = ""
+      useCustomWorkingDirectory = "NO"
+      debugDocumentVersioning = "YES">
+      <MacroExpansion>
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "901930E11BC5B9BC00D1134E"
+            BuildableName = "Buy.framework"
+            BlueprintName = "Buy Dynamic"
+            ReferencedContainer = "container:Mobile Buy SDK.xcodeproj">
+         </BuildableReference>
+      </MacroExpansion>
+   </ProfileAction>
+   <AnalyzeAction
+      buildConfiguration = "Debug">
+   </AnalyzeAction>
+   <ArchiveAction
+      buildConfiguration = "Release"
+      revealArchiveInOrganizer = "YES">
+   </ArchiveAction>
+</Scheme>

Mobile Buy SDK/Mobile Buy SDK/Buy.h

@@ -24,33 +24,36 @@
 //  THE SOFTWARE.
 //
 
-#import <Buy/BUYAddress.h>
-#import <Buy/BUYCart.h>
-#import <Buy/BUYCheckout.h>
-#import <Buy/BUYCreditCard.h>
-#import <Buy/BUYDiscount.h>
-#import <Buy/BUYGiftCard.h>
-#import <Buy/BUYLineItem.h>
-#import <Buy/BUYClient.h>
-#import <Buy/BUYClient+Test.h>
-#import <Buy/BUYImage.h>
-#import <Buy/BUYOption.h>
-#import <Buy/BUYOptionValue.h>
-#import <Buy/BUYOrder.h>
-#import <Buy/BUYProduct.h>
-#import <Buy/BUYProductVariant.h>
-#import <Buy/BUYShippingRate.h>
-#import <Buy/BUYShop.h>
-#import <Buy/BUYStoreViewController.h>
-#import <Buy/BUYTaxLine.h>
-#import <Buy/BUYViewController.h>
-#import <Buy/BUYApplePayAdditions.h>
-#import <Buy/BUYApplePayHelpers.h>
-#import <Buy/BUYPaymentButton.h>
-#import <Buy/BUYProductViewController.h>
-#import <Buy/BUYTheme.h>
-#import <Buy/BUYCartLineItem.h>
-#import <Buy/BUYCollection.h>
-#import <Buy/BUYMaskedCreditCard.h>
-#import <Buy/BuyError.h>
-#import <Buy/Buy-Bridging-Header.h>
+/**
+ *  Umbrella header used for Cocoapods
+ */
+
+#import "BUYApplePayAdditions.h"
+#import "BUYApplePayHelpers.h"
+#import "BUYAddress.h"
+#import "BUYCart.h"
+#import "BUYCartLineItem.h"
+#import "BUYCheckout.h"
+#import "BUYClient+Test.h"
+#import "BUYClient.h"
+#import "BUYCollection.h"
+#import "BUYCreditCard.h"
+#import "BUYDiscount.h"
+#import "BUYError.h"
+#import "BUYGiftCard.h"
+#import "BUYImage.h"
+#import "BUYLineItem.h"
+#import "BUYMaskedCreditCard.h"
+#import "BUYOption.h"
+#import "BUYOptionValue.h"
+#import "BUYOrder.h"
+#import "BUYPaymentButton.h"
+#import "BUYProduct.h"
+#import "BUYProductVariant.h"
+#import "BUYProductViewController.h"
+#import "BUYShippingRate.h"
+#import "BUYShop.h"
+#import "BUYStoreViewController.h"
+#import "BUYTaxLine.h"
+#import "BUYTheme.h"
+#import "BUYViewController.h"

Mobile Buy SDK/Mobile Buy SDK/Info.plist

@@ -15,7 +15,7 @@
 	<key>CFBundlePackageType</key>
 	<string>FMWK</string>
 	<key>CFBundleShortVersionString</key>
-	<string>1.2</string>
+	<string>1.2.1</string>
 	<key>CFBundleSignature</key>
 	<string>????</string>
 	<key>CFBundleVersion</key>

Mobile Buy SDK/Mobile Buy SDK/Static Framework/Buy.h

+//
+//  Buy.h
+//  Mobile Buy SDK
+//
+//  Created by Shopify.
+//  Copyright (c) 2015 Shopify Inc. All rights reserved.
+//
+//  Permission is hereby granted, free of charge, to any person obtaining a copy
+//  of this software and associated documentation files (the "Software"), to deal
+//  in the Software without restriction, including without limitation the rights
+//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+//  copies of the Software, and to permit persons to whom the Software is
+//  furnished to do so, subject to the following conditions:
+//
+//  The above copyright notice and this permission notice shall be included in
+//  all copies or substantial portions of the Software.
+//
+//  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+//  THE SOFTWARE.
+//
+
+#import <UIKit/UIKit.h>
+
+//! Project version number for BuyDynamic.
+FOUNDATION_EXPORT double BuyDynamicVersionNumber;
+
+//! Project version string for BuyDynamic.
+FOUNDATION_EXPORT const unsigned char BuyDynamicVersionString[];
+
+#import <Buy/BUYAddress.h>
+#import <Buy/BUYCart.h>
+#import <Buy/BUYCheckout.h>
+#import <Buy/BUYCreditCard.h>
+#import <Buy/BUYDiscount.h>
+#import <Buy/BUYGiftCard.h>
+#import <Buy/BUYLineItem.h>
+#import <Buy/BUYClient.h>
+#import <Buy/BUYClient+Test.h>
+#import <Buy/BUYImage.h>
+#import <Buy/BUYOption.h>
+#import <Buy/BUYOptionValue.h>
+#import <Buy/BUYOrder.h>
+#import <Buy/BUYProduct.h>
+#import <Buy/BUYProductVariant.h>
+#import <Buy/BUYShippingRate.h>
+#import <Buy/BUYShop.h>
+#import <Buy/BUYStoreViewController.h>
+#import <Buy/BUYTaxLine.h>
+#import <Buy/BUYViewController.h>
+#import <Buy/BUYApplePayAdditions.h>
+#import <Buy/BUYApplePayHelpers.h>
+#import <Buy/BUYPaymentButton.h>
+#import <Buy/BUYProductViewController.h>
+#import <Buy/BUYTheme.h>
+#import <Buy/BUYCartLineItem.h>
+#import <Buy/BUYCollection.h>
+#import <Buy/BUYMaskedCreditCard.h>
+#import <Buy/BUYError.h>

Mobile-Buy-SDK.podspec

 Pod::Spec.new do |s|
   s.name         = 'Mobile-Buy-SDK'
-  s.version      = '1.2.0'
+  s.version      = '1.2.1'
   s.summary      = 'Sell with Shopify in iOS apps'
   s.description  = 'Shopify’s Mobile Buy SDK makes it simple to sell physical products inside your mobile app. With a few lines of code, you can connect your app with the Shopify platform and let your users buy your products using Apple Pay or their credit card.'
   s.homepage     = 'https://developers.shopify.com/mobile-buy-sdk'
@@ -9,9 +9,9 @@ Pod::Spec.new do |s|
   s.platform     = :ios, '8.0'
   s.source       = { :git => 'https://github.com/Shopify/mobile-buy-sdk-ios.git', :tag => s.version }
   s.source_files = 'Mobile Buy SDK/Mobile Buy SDK/**/*.{h,m,mm}'
-  s.exclude_files = 'Mobile Buy SDK/Mobile Buy SDK/Buy.h'
-  s.public_header_files = 'Mobile Buy SDK/Mobile Buy SDK/**/*.{h}'
-  s.module_map   = 'Mobile Buy SDK/Mobile Buy SDK/Buy.modulemap'
+  s.public_header_files = 'Mobile Buy SDK/Mobile Buy SDK/**/*.h'
+  s.exclude_files = 'Mobile Buy SDK/Mobile Buy SDK/Static Framework/*'
+  s.module_name   = 'Buy'
   s.frameworks   = 'PassKit'
   s.libraries    = 'c++'
   s.requires_arc = true

README.md

@@ -16,15 +16,17 @@ Please find all documentation on the [Mobile Buy SDK for iOS page](https://docs.
 
 ### Installation
 
-#### Manual Installation (Project)
-
 <a href="../../releases/latest">Download the latest version</a>
 
+#### Dynamic Framework Installation
+
 1. Drag the `Mobile Buy SDK.xcodeproj` into your existing project
 2. Add the `Buy` target as a `Target Dependancy` in the `Build Phases` of your project's target
-3. Add the `Buy` target in the `Link Binary with Libraries` section in `Build Phases`
+3. Add the `Buy` (second target on the list is the Dynamic framework) target in the `Embedded Binaries` section in `Build Phases`
+
+See the [Sample Apps](/Mobile Buy SDK Sample Apps/) for an example of Dynamic Framework usage.
 
-#### Manual Installation (Framework)
+#### Static Framework Installation
 
 If you would like to not include the Mobile Buy SDK Project within your existing project, you can link directly to the `Buy.framework`.
 
@@ -42,6 +44,10 @@ pod "Mobile-Buy-SDK"
 
 Then run `pod install`
 
+```objc
+#import "Buy.h"
+```
+
 #### Carthage
 
 Add the following line to your Cartfile
@@ -84,17 +90,19 @@ Consult the [Usage Section](https://docs.shopify.com/mobile-buy-sdk/ios/integrat
 
 ### Building the SDK
 
-Clone this repo or download as .zip and open `Mobile Buy SDK.xcworkspace`.
+Clone this repo or download as .zip and open `Mobile Buy SDK.xcodeproj`.
 
-The workspace includes the Mobile Buy SDK project and the sample app projects. The sample apps can also be opened outside the workspace with the `.xcodeproj` files found in the sample app folders. However, if you need to use breakpoints or inspect methods in the SDK, run the sample apps from the workspace.
+The workspace includes the Mobile Buy SDK project.
 
 ### Mobile Buy SDK Targets and schemes
 
 The Mobile Buy SDK includes a number of targets and schemes:
 
-* **Buy**: This is the Mobile Buy SDK framework. This build is based on the current build configuration. To build a universal framework that can run on a device and on the Simulator and to be included in your app, please refer to the `Universal Framework` target below
+* **Buy**: This is the Mobile Buy SDK static framework. This build is based on the current build configuration. To build a universal framework that can run on a device and on the Simulator and to be included in your app, please refer to the `Universal Framework` target below
 
-* **Universal Framework**: This builds the framework using `build_universal.sh` script in the `Universal Framework` target and copies the built framework in the `/Mobile Buy SDK Sample Apps` folder. Build this target if you have made any changes to the framework that you want to test with the sample apps as the sample apps do not build the framework directly but embed the already built framework
+* **Buy Dynamic**: This is the Mobile Buy SDK dynamic framework. Please refer to the installation section above.
+
+* **Universal Framework**: This builds a static framework using `build_universal.sh` script in the `Universal Framework` target and copies the built framework in the `/Mobile Buy SDK Sample Apps` folder. This is a fat binary that includes arm and i386 slices. Build this target if you have made any changes to the framework that you want to test with the sample apps as the sample apps do not build the framework directly but embed the already built framework
 
 * **Mobile Buy SDK Tests**: Tests for the Mobile Buy SDK framework. See instructions below
 
@@ -102,6 +110,16 @@ The Mobile Buy SDK includes a number of targets and schemes:
 
 * **Playground**: This target is a basic app that depends directly on the `Buy` framework target and builds the framework every time using the `Playground` app's build configuration. You may use this app and target to play around with the SDK. Be sure not to check in any changes you may have made in files related to this app
 
+### Sample Apps
+
+The repo includes 3 sample apps. Each sample apps embeds the dynamic framework and includes readme files with more information:
+
+* [Advanced Sample App](/Mobile Buy SDK Sample Apps/Sample App Advanced/README.md)
+* [Swift Sample App](/Mobile Buy SDK Sample Apps/Sample App Swift/README.md)
+* [Web Sample App](/Mobile Buy SDK Sample Apps/Sample App Web/README.md)
+
+We suggest you take a look at the **Advanced Sample App** and test your shop with the sample app before you begin. If you run into any issues, the **Advanced Sample App** is also a great resource for debugging integration issues and checkout.
+
 ### Unit Tests
 
 To run the Mobile Buy SDK integration tests against an actual shop, you will need a Shopify shop that is publicly accessible (not password protected). Please note that the integration tests **will create an order** on that shop. This is to validate that the SDK works properly with Shopify.  Modify the **test_shop_data.json** file to contain your shop's credentials and the required product IDs, gift cards, and discounts as necessary.

Scripts/run_tests.sh

-xcodebuild test -workspace "Mobile Buy SDK.xcworkspace" \
+xcodebuild test -project "Mobile Buy SDK/Mobile Buy SDK.xcodeproj" \
 -scheme "Mobile Buy SDK Tests" \
 -sdk iphonesimulator \
 -destination 'platform=iOS Simulator,name=iPhone 6,OS=9.0'