Installation

Prerequisites

Understand more regarding core messaging concepts at Apps > Messaging

Understand more regarding messaging at Apps > Messaging

JavaScript

If you're using npm:

npm install @dashx/browser

If you're using yarn:

yarn add @dashx/browser

Configure the DashX client as early as possible in your application:

import DashX from '@dashx/browser'

DashX.configure({
    publicKey: '<YOUR PUBLIC KEY>', // required
    baseUri: '<YOUR BASE URI>', // optional
    targetEnvironment: '<YOUR ENVIRONMENT>' // optional
})

iOS

The minimum supported version for iOS is 12.0. To set the Minimum SDK target:

1. Open your iOS project in XCode
2. Select your Target > General > Deployment Info > Ensure that the version is set to 12.0+

Using Cocoapods

1. Update your Podfile:

platform :ios, '12.0' # must be 12 or higher
# ...
target 'YOUR_TARGET_NAME' do
    # ...
    pod 'DashX'
    # ...
end

2. Open Terminal in your project's root directory and run:

pod install

Using Carthage

1. Specify the dependency in your Cartfile:

github "dashxhq/dashx-ios"

2. Run the following command:

carthage update

Using Swift Package Manager

1. In your Xcode project, go to File > Add Packages
2. Paste the following URL in "Search or Enter Package URL":

https://github.com/dashxhq/dashx-ios.git

Android

1. Add Maven Central repository to your settings.gradle file:

settings.gradle

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        // ...
        mavenCentral()
    }
}

2. Add dashx-android as a dependency in your module-level build.gradle file:

app/build.gradle

dependencies {
    // ...
    implementation 'com.dashx:dashx-android:1.0.9'
}

3. Enable Java 1.8 source compatibility if you haven't yet.

app/build.gradle

android {
    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_1_8
        targetCompatibility = JavaVersion.VERSION_1_8
    }
}

tip

If you're using Android Studio, you should hit the Sync Now button that pops up after modifying build.gradle.

DashX needs to be initialized as early as possible in your application's lifecycle, which is generally in an instance of the Android Application class:

app/src/main/application/MyApplication.kt

import android.app.Application;
import com.dashx.sdk.DashX;

public class MyApplication extends Application {
public void onCreate() {
    super.onCreate();

    DashX.configure(
        context = this,
        publicKey = "...", // required
        baseURI = "...", // optional
        targetEnvironment = "...", // optional
    )
}
}

If your product uses multiple environments, a good practice is to:

• create productFlavors for each environment,
• use buildConfigField to declare your DashX configuration, and then
• use BuildConfig to pass your configuration as parameters.

Node.js

If you're using npm:

npm install @dashx/node

If you're using yarn:

yarn add @dashx/node

const DashX = require('@dashx/node');

// Initialize DashX SDK
const dx = DashX.createClient({
  publicKey: process.env.DASHX_PUBLIC_KEY,
  privateKey: process.env.DASHX_PRIVATE_KEY,
});

The SDK can also be initialized with no parameters, dashx-node will then look for these env variables DASHX_PUBLIC_KEY and DASHX_PRIVATE_KEY.

const DashX = require('@dashx/node');

// Initialize DashX SDK
const dx = DashX.createClient();

Python

pip install dashx

Ruby

Add this line to your application's Gemfile:

gem 'dashx'

And then execute:

$ bundle install

Or install it yourself as:

$ gem install dashx

require 'dashx'

# Initialize DashX SDK
DashX.configure do |config|
  config.public_key = ENV['DASHX_PUBLIC_KEY']
  config.private_key = ENV['DASHX_PRIVATE_KEY']
end