Notice

Now Balto is still in beta.
If you would like to use Balto, please contact us.

Balto-SDK

BaltoSDK is a SDK for Balto.
Balto is the place where beta meets feedback. Distribute your test apps and get instant feedback from your team directly from the app.

Installation

Notice

Requires iOS 9.0+

To manually add to your project

1. Open your Xcode project.
2. Drag & drop BaltoSDK.framework in the Xcode->Project->General->Embedded Binaries.

Setup

You need to add script phase from 'BuildPhases'.

1. Open your Xcode project. (If you use CocoaPods, open your Xcode workspace.)
2. Add Xcode->Project->BuildPhases->Run Script
3. Add the following a line to script editor:

/bin/sh "${PROJECT_DIR}/BaltoSDK.framework/run.sh"
# If you use CocoaPods
#/bin/sh "${SRCROOT}/Pods/Balto-SDK/BaltoSDK.framework/run.sh"
# If you use Carthage.
#/bin/sh "${SRCROOT}/Carthage/Build/iOS/BaltoSDK.framework/run.sh"

Usage

Add the following lines to AppDelegate.swift.

import BaltoSDK

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
    Balto.with()
    return true
}

func application(_ app: UIApplication, open url: URL, options: [UIApplicationOpenURLOptionsKey : Any] = [:]) -> Bool {
    Balto.returnFromBalto(openURL: url, options: options)
    return true
}

If you want to set other gesture, you can choose some gestures.

// Custom swipe gesture.
Balto.withCustomSwipe(numberOfTouchesRequired: Int, direction: UISwipeGestureRecognizerDirection)
// Long press. Default minimum press duration is 0.5.
Balto.withLongPress()
// Custom long press
Balto.withLongPress(minimumPressDuration: CFTimeInterval)

If you want to hide the menu of Balto, please add option parameter.

Balto.with(options: [kBaltoHideMenu: true])
Balto.withLongPress(minimumPressDuration: 2.0, options: [kBaltoHideMenu: true])
Balto.withCustomSwipe(numberOfTouchesRequired: 2, direction: .down, options: [kBaltoHideMenu: true])

If you want to change the display for each screen, please call these methods at that timing.

Balto.show()
Balto.hide()

You need some setting if you use the Objective-C.

Xcode->Project->Build Settings->Build Options->Embedded Content Contains Swift Code->YES