ShipBook SDK for iOS

Apple logo.png iOS remote logs installation

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.

Requirements

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

Installation

ShipBookSDK is available through:

  1. Swift Package Manager

  2. CocoaPods.

  3. Carthage

Using Swift Package Manager

Select File > Swift Packages > Add Package Dependency and enter

Using CocoaPods

Once you have installed CocoaPods, add the following line to your Podfile and run

pod install: 

pod 'ShipBookSDK'

Using Carthage

Add the following line to your Cartfile: 

 

If you use Carthage to build your dependencies, make sure you have added ShipBookSDK.framework to the "Linked Frameworks and Libraries" section of your target, and have included them in your Carthage framework copying build phase.

github "ShipBook/ShipBookSDK-iOS"

Integrating Shipbook into your code

In your AppDelegate file, add the following:

import ShipBookSDK

Then, add the following to  

application(_:didFinishLaunchingWithOptions:):

ShipBook.start(appId:"YOUR_APP_ID", appKey:"YOUR_APP_KEY")

import ShipBookSDK

 

fileprivate let log = ShipBook.getLogger(MainViewController.self)

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

The usage of the log:

log.e("the log message" //    Error log

log.w("the log message")  //    Warning log

log.i("the log message")  //    Info log

log.d("the log message")  //    Debug log

log.v("the log message")  //    Verbose log

If you’d like to add a tag that isn't the name of the class you're using then you can add a custom tag:

import ShipBookSDK

fileprivate let log = ShipBook.getLogger("CUSTOM_TAG")

Enable Shipbook debug logging

If your logs weren't uploaded to Shipbook, or you're experiencing some other issue with Shipbook, you can enable Shipbook debug logging to track down the problem.

ShipBook.enableInnerLog(enable: true)

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.registerUser(userId: "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

Logout

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

ShipBook.logout()

Screen

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

ShipBook.screen(name: "SCREEN_NAME")

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

Additional Information

Automatically Importing ShipBookSDK

If you don’t want to manually add import ShipBookSDK to each source file, you may insert the following code to the AppDelegate file

import ShipBookSDK

public typealias ShipBook = ShipBookSDK.ShipBook

Log.e("the log message" //    Error log

Log.w("the log message")  //    Warning log

Log.i("the log message")  //     Info log

Log.d("the log message")  //    Debug log

Log.v("the log message")  //    Verbose log

Static Function Alternative to getLogger

You may use a static function in place of getLogger. This is not recommended and the caveats are listed below. When a static function activates the logger, the tag will become the filename. The usage of the log:

 

The usage of the log:

As mentioned, working with this static logger isn't ideal:

  • Performance is slower, especially in cases where the log is closed

  • The log’s information is less detailed. Ideally, you should create a logger for each class.

  • The Log name can have a name collision with a local Log class

 

Using Wrappers with ShipBook

If you are already using some kind of a logging system, you may want to write wrappers to send the logs to both systems.

When creating the wrapper on the logs, you will need to implement all the parameters of each log.

 

For example a wrapper for 

log.e() :

func e(_ msg:String,

       tag:String? = nil,

       function: String = #function,

       file: String = #file,

       line: Int = #line) {

  log.e(msg: msg, tag: tag, function: function,file: file,line: line)

 }

You can also implement the function that is receiving all the messages:

 message():

func e(_ msg:String,

       tag:String? = nil,

       function: String = #function,

       file: String = #file,

       line: Int = #line) {

     log.message(msg: msg, severity: .Error, tag: tag, function: function,file: file,line: line)

 }

The severity is an enum:

enum Severity : Int {

   case Off = 0

   case Error

   case Warning

   case Info

   case Debug

   case Verbose

 }

 

+

Integrating Shipbook with firebase crashlytics

To integrate Shipbook with crashlytics just implement the completion callback of   ShipBook.start     as following:

ShipBook.start("YOUR_APP_ID", appKey:"YOUR_APP_KEY") { (sessionUrl: String) -> () in

 

     Crashlytics.sharedInstance().setObjectValue(sessionUrl, forKey: "ShipbookSession") }

License

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

Now you'll have a link to the logs of the specific session in crashlytics.

The link is in the Keys tab of the a specific crash under the key  ShipbookSession .

© 2018 Shipbook Ltd.

  • Facebook Social Icon
  • LinkedIn Social Icon

Animation & Graphic Design: Barel Toledano

Content Writer: Ari Kuchar & Zoe Kabilio

Grammatical edit: Ann Goldberg