vvit / mobile-sdk-ios

Simpo SDK for iOS

Documentation

• init(ucid: string, options: object)

  options
  • dimensions: type: CGSize(width: number, height: number) - the size of the widget itself
  • show: boolean - show or hide the widget
  • position: , type: string, can receive one of the below values:
    • "bottom-left"
    • "bottom-right" (default)
    • "top-left"
    • "top-right"
  • userEmail: type: string
  • userName: type: string
  • uuid: type: string

• open()

  must be called after init, will open Simpo interface

Example

        let ucid = "Enter your UCID here"
        let options = SimpoOptions(show: true, dimensions: CGSize(width: 55, height: 55), userEmail: "[email protected]")
        Simpo.init(ucid: ucid, options: options)

Installation instructions:

• Carthage
• CocoaPods

Carthage

1. Install Carthage

$ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
$ brew install carthage

2. Create Cartfile in the project root dir with the content:

github "actionbario/mobile-sdk-iOS"

3. Install the dependency:

carthage update --platform iOS

4. Add Simpo.framework (located in <project-root>/Carthage/Build/iOS) to the Linked Frameworks and Libraries:
   
5. Add a Run Script build phase with this content:

• shell script (if not exist): /usr/local/bin/carthage copy-frameworks
• input Files: $(SRCROOT)/Carthage/Build/iOS/Simpo.framework
• output Files: $(BUILT_PRODUCTS_DIR)/$(FRAMEWORKS_FOLDER_PATH)/Simpo.framework

6. Optional if CocoaPods script [CP] Embed Pods Frameworks exists.
Solves the AppStore submission issue.
Add a Run Script build phase with the name Carthage Strip Architectures and this content:

FRAMEWORK="Simpo"
FRAMEWORK_EXECUTABLE_PATH="${BUILT_PRODUCTS_DIR}/${FRAMEWORKS_FOLDER_PATH}/$FRAMEWORK.framework/$FRAMEWORK"
EXTRACTED_ARCHS=()

echo "Stripping the Simpo framework"

for ARCH in $ARCHS
do
lipo -extract "$ARCH" "$FRAMEWORK_EXECUTABLE_PATH" -o "$FRAMEWORK_EXECUTABLE_PATH-$ARCH"
EXTRACTED_ARCHS+=("$FRAMEWORK_EXECUTABLE_PATH-$ARCH")
done
lipo -o "$FRAMEWORK_EXECUTABLE_PATH-merged" -create "${EXTRACTED_ARCHS[@]}"
rm "${EXTRACTED_ARCHS[@]}"
rm "$FRAMEWORK_EXECUTABLE_PATH"
mv "$FRAMEWORK_EXECUTABLE_PATH-merged" "$FRAMEWORK_EXECUTABLE_PATH"

CocoaPods

1. Install CocoaPods

$ sudo gem install cocoapods

2. If needed (first time) run:

pod init

3. Install the dependency by adding pod 'SimpoSDK' into the Podfile. Then run:

$ pod update

So the Podfile looks like this:

platform :ios, '9.3'

target '<Project name>' do
  use_frameworks!
  pod 'SimpoSDK'
end