Close Menu

bmscore

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus non urna vitae nisi faucibus lacinia. Sed sollicitudin elit felis, ut sodales urna aliquet et. Aliquam mollis urna at justo rutrum, eu laoreet libero mattis. Aenean at lorem auctor, mollis ligula non, luctus justo.


To start using BMS Core, you need to install it on your project. Follow the steps below:

  1. Step 1: Open your terminal.
  2. Step 2: Navigate to your project directory.
  3. Step 3: Run the command pod init to create a Podfile (if you haven’t already).
  4. Step 4: Add the following line to your Podfile:
    pod 'BMSAnalytics', '~> x.x.x' (replace x.x.x with the latest version).
  5. Step 5: Save the Podfile and run the command pod install.

After installation, you can import BMS Core into your project:

  1. Step 1: Open your project in Xcode.
  2. Step 2: Open your project’s AppDelegate.swift file.
  3. Step 3: Add the following line at the top of the file:
    import BMSCore


Before using any BMS Core features, you need to initialize it:

// Initialize BMS Core
BMSClient.sharedInstance.initialize(bluemixRegion: .usSouth)


BMS Core provides powerful logging capabilities for your app:

// Log a message
BMSLogger.shared.logger.debug(message: "This is a debug log.")

// Log a formatted message
BMSLogger.shared.logger.info(message: "User %{public}@ logged in.", details: ["username": "john.doe"])

BMS Core allows you to make network requests easily:

// Create a request URL
let url = URL(string: "https://api.example.com/data")

// Create a request object
let request = URLRequest(url: url!)

// Send the request
BMSURLSessionManager.shared.sendRequest(request) { response, error in
    if let error = error {
        print("Error: \(error)")
    } else if let response = response {
        print("Response: \(response)")
    }
}

BMS Core offers built-in support for various authentication mechanisms:

BMS Core supports authentication with IBM Cloud App ID:

// Initialize App ID
let appIdRegion = AppID.REGION.usSouth
let appId = AppID.sharedInstance
appId.initialize(tenantId: "your-tenant-id", bluemixRegion: appIdRegion)

// Authenticate user
appId.login() { identityToken, error in
    if let error = error {
        print("Authentication failed: \(error)")
    } else if let identityToken = identityToken {
        print("Authentication succeeded. Identity token: \(identityToken)")
    }
}

BMS Core provides comprehensive error handling capabilities:

BMS Core defines the following error types:

  • BMSA‌‌PIError: Represents errors encountered when making network requests.
  • BMSAu‌‌‌‌thenticationError: Represents authentication-related errors.
  • BMSBa‌‌s‌eError: The base class for all BMS Core errors.

Here is an example of error handling in BMS Core:

// Perform a network request
BMSURLSessionManager.shared.sendRequest(request) { response, error in
    if let error = error as? BMSAPIError {
        print("Network request failed. Error code: \(error.errorCode)")
    } else {
        print("Network request succeeded.")
    }
}

That covers the key features of BMS Core. Feel free to explore the documentation and source code for more detailed information.