com.segment.analytics.AbstractIntegration Maven / Gradle / Ivy

Go to download
package com.segment.analytics;

import android.app.Activity;
import android.content.Context;
import android.os.Bundle;

/**
 * A base class for Integrations. An integration will only be created if the server sends us
 * settings for it.
 * 
 * This could exist as an interface, but we'll want an abstract class anyway since not all
 * integrations require all methods to be implemented.
 *
 * @param  The type of the backing instance. This isn't strictly necessary, but serves as
 * documentation for what type to expect with {@link #getUnderlyingInstance()}
 */
abstract class AbstractIntegration {
  static final String VIEWED_EVENT_FORMAT = "Viewed %s Screen";

  /**
   * Initialize the integration. Implementations should wrap any errors, including missing settings
   * and permission in {@link IllegalStateException}. If this method call completes without
   * an error, the integration is assumed to be initialize and ready.
   */
  abstract void initialize(Context context, JsonMap settings, boolean debuggingEnabled)
      throws IllegalStateException;

  /**
   * The underlying instance for this provider - used for integration specific actions. This will
   * be null for SDK's that maintain a shared instance (e.g. Amplitude).
   */
  T getUnderlyingInstance() {
    // Only Mixpanel and GoogleAnalytics don't have shared instances so no need to make all
    // integrations include this.
    return null;
  }

  abstract String key();

  // Application Callbacks, same as Application$ActivityLifecycleCallbacks
  void onActivityCreated(Activity activity, Bundle savedInstanceState) {

  }

  void onActivityStarted(Activity activity) {

  }

  void onActivityResumed(Activity activity) {
  }

  void onActivityPaused(Activity activity) {
  }

  void onActivityStopped(Activity activity) {
  }

  void onActivitySaveInstanceState(Activity activity, Bundle outState) {
  }

  void onActivityDestroyed(Activity activity) {
  }

  // Analytics Actions
  void identify(IdentifyPayload identify) {
  }

  void group(GroupPayload group) {
  }

  void track(TrackPayload track) {
  }

  void alias(AliasPayload alias) {
  }

  void screen(ScreenPayload screen) {
  }

  void flush() {

  }
}