com.chartboost.sdk.Libraries

Class CBLogging

java.lang.Object

com.chartboost.sdk.Libraries.CBLogging

public final class CBLogging
extends java.lang.Object

API for sending log output.

Generally, use the CBLogging.v() CBLogging.d() CBLogging.i() CBLogging.w() and CBLogging.e() methods.

The order in terms of verbosity, from least to most is ERROR, WARN, INFO, DEBUG, VERBOSE.

Tip: A good convention is to declare a TAG constant in your class:

private static final String TAG = "MyActivity";

and use that in subsequent calls to the log methods.

Tip: Don't forget that when you make a call like

Log.v(TAG, "index=" + i);

that when you're building the string to pass into Log.d, the compiler uses a StringBuilder and at least three allocations occur: the StringBuilder itself, the buffer, and the String object. Realistically, there is also another buffer allocation and copy, and even more pressure on the gc. That means that if your log message is filtered out, you might be doing significant work and incurring significant overhead.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	CBLogging.Level Enum describing what is logged by the Chartboost SDK

Field Summary

Fields

Modifier and Type	Field and Description
static CBLogging.Level	level Private boolean variable to enable and disable logging

Method Summary

Modifier and Type	Method and Description
static void	d(java.lang.String tag, java.lang.String msg) Send a android.util.Log log message.
static void	d(java.lang.String tag, java.lang.String msg, java.lang.Throwable tr) Send a android.util.Log log message and log the exception.
static void	e(java.lang.String tag, java.lang.String msg) Send an android.util.Log log message.
static void	e(java.lang.String tag, java.lang.String msg, java.lang.Throwable tr) Send a android.util.Log log message and log the exception.
static void	i(java.lang.String tag, java.lang.String msg) Send an android.util.Log log message.
static void	i(java.lang.String tag, java.lang.String msg, java.lang.Throwable tr) Send a android.util.Log log message and log the exception.
static void	integrationError(java.lang.String msg) Send an android.util.Log integration log message.
static void	integrationWarning(java.lang.String msg) Send an android.util.Log integration log message.
static void	v(java.lang.String tag, java.lang.String msg) Send a android.util.Log log message.
static void	v(java.lang.String tag, java.lang.String msg, java.lang.Throwable tr) Send a android.util.Log log message and log the exception.
static void	w(java.lang.String tag, java.lang.String msg) Send a android.util.Log log message.
static void	w(java.lang.String tag, java.lang.String msg, java.lang.Throwable tr) Send a android.util.Log log message and log the exception.
static void	wtf(java.lang.String tag, java.lang.String msg) What a Terrible Failure: Report a condition that should never happen.
static void	wtf(java.lang.String tag, java.lang.String msg, java.lang.Throwable tr) What a Terrible Failure: Report an exception that should never happen.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

level

public static CBLogging.Level level

Private boolean variable to enable and disable logging

Method Detail

integrationError

public static void integrationError(java.lang.String msg)

Send an android.util.Log integration log message.

Parameters:

msg - The message you would like logged. It cannot be null

integrationWarning

public static void integrationWarning(java.lang.String msg)

Send an android.util.Log integration log message.

Parameters:

msg - The message you would like logged. It cannot be null

d

public static void d(java.lang.String tag,
                     java.lang.String msg)

Send a android.util.Log log message.

Parameters:

tag - Used to identify the source of a log message. It usually identifies the class or activity where the log call occurs.

msg - The message you would like logged. It cannot be null

d

public static void d(java.lang.String tag,
                     java.lang.String msg,
                     java.lang.Throwable tr)

Send a android.util.Log log message and log the exception.

Parameters:

tag - Used to identify the source of a log message. It usually identifies the class or activity where the log call occurs.

msg - The message you would like logged. It cannot be null

tr - An exception to log

e

public static void e(java.lang.String tag,
                     java.lang.String msg)

Send an android.util.Log log message.

Parameters:

tag - Used to identify the source of a log message. It usually identifies the class or activity where the log call occurs.

msg - The message you would like logged.It cannot be null

e

public static void e(java.lang.String tag,
                     java.lang.String msg,
                     java.lang.Throwable tr)

Send a android.util.Log log message and log the exception.

Parameters:

tag - Used to identify the source of a log message. It usually identifies the class or activity where the log call occurs.

msg - The message you would like logged. It cannot be null

tr - An exception to log

v

public static void v(java.lang.String tag,
                     java.lang.String msg)

Send a android.util.Log log message.

Parameters:

tag - Used to identify the source of a log message. It usually identifies the class or activity where the log call occurs.

msg - The message you would like logged. It cannot be null

v

public static void v(java.lang.String tag,
                     java.lang.String msg,
                     java.lang.Throwable tr)

Send a android.util.Log log message and log the exception.

Parameters:

tag - Used to identify the source of a log message. It usually identifies the class or activity where the log call occurs.

msg - The message you would like logged. It cannot be null

tr - An exception to log

w

public static void w(java.lang.String tag,
                     java.lang.String msg)

Send a android.util.Log log message.

Parameters:

tag - Used to identify the source of a log message. It usually identifies the class or activity where the log call occurs.

msg - The message you would like logged. It cannot be null

w

public static void w(java.lang.String tag,
                     java.lang.String msg,
                     java.lang.Throwable tr)

Send a android.util.Log log message and log the exception.

Parameters:

tag - Used to identify the source of a log message. It usually identifies the class or activity where the log call occurs.

msg - The message you would like logged. It cannot be null

tr - An exception to log

i

public static void i(java.lang.String tag,
                     java.lang.String msg)

Send an android.util.Log log message.

Parameters:

tag - Used to identify the source of a log message. It usually identifies the class or activity where the log call occurs.

msg - The message you would like logged. It cannot be null

i

public static void i(java.lang.String tag,
                     java.lang.String msg,
                     java.lang.Throwable tr)

Send a android.util.Log log message and log the exception.

Parameters:

tag - Used to identify the source of a log message. It usually identifies the class or activity where the log call occurs.

msg - The message you would like logged. It cannot be null

tr - An exception to log

wtf

public static void wtf(java.lang.String tag,
                       java.lang.String msg)

What a Terrible Failure: Report a condition that should never happen. The error will always be logged at level ASSERT with the call stack. Depending on system configuration, a report may be added to the android.os.DropBoxManager and/or the process may be terminated immediately with an error dialog.

Parameters:

tag - Used to identify the source of a log message.

msg - The message you would like logged. It cannot be null

wtf

public static void wtf(java.lang.String tag,
                       java.lang.String msg,
                       java.lang.Throwable tr)

What a Terrible Failure: Report an exception that should never happen. Similar to #wtf(Object, String), with a message as well.

Parameters:

tag - Used to identify the source of a log message.

msg - The message you would like logged. It cannot be null.

tr - An exception to log. May be null.