Skip to content
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
86 lines (65 sloc) 2.37 KB

ShipBook SDK for iOS

About Shipbook

ShipBook gives you the power to remotely gather, search and analyze your user logs and exceptions in the cloud, on a per-user & session basis.


ShipBook works with SWIFT 4.2 (min. version 3), Objective-C and from iOS 10.

Installation via CocoaPods

ShipBookSDK is only available through CocoaPods. Once you have installed CocoaPods, add the following line to your Podfile and run pod install:

pod 'ShipBookSDK'

Integrating ShipBook into your code

In your AppDelegate file, add the following:

@import ShipBookSDK;

Then, add the following to - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions:

[ShipBook startWithAppId:@"YOUR_APP_ID" appKey:@"YOUR_APP_KEY"];

To have a log on each class you need to create a logger.
For Example, in MainViewController:

@import ShipBookSDK;

The usage of the log:

LogE(@"the log message"); // Error log
LogW(@"the log message"); // Warning log
LogI(@"the log message"); // Info log
LogD(@"the log message"); // Debug log
LogV(@"the log message"); // Verbose log

Linking ShipBook to a user’s information

The SDK allows the option to associate each session with specific user information.

Register user:

The best practice is to set registerUser before ShipBook.start. It will also work after this point however, it will require an additional api request.

[ShipBook registerUserWithUserId: @"USER_ID",
                        userName: @"USER_NAME",
                        fullName: @"USER NAME",
                           email: @"USER_EMAIL",
                     phoneNumber: @"USER_PHONE_NUMBER",
                  additionalInfo: @"STRING DICTIONARY OF KEY VALUE"];

The only required parameter is userId.


To logout the user, add the following code to your app’s logout function.

[ShipBook logout];


To log the user’s screen information, add the following code

[ShipBook screenWithName: @"SCREEN_NAME"];

The best practice is to add this code to viewWillAppear in the view controller.


Elisha Sterngold (ShipBook Ltd.)


ShipBookSDK is available under the MIT license. See the LICENSE file for more info.

You can’t perform that action at this time.