API changes between releases
If you are migrating from a previous version of IBM MobileFirst™ Quality Assurance, review the API changes between releases.
Hybrid
The following table shows the changes to the APIs that were released with the JavaScript hybrid components in September 2015. These updates also apply to the Apache Cordova plugin, the native Android SDK, and the iOS native SDK:The following table lists the existing, new, and deprecated APIs.
| Deprecated | Replacement |
|---|---|
| MQA.startSession() | MQA.startNewSession () |
| MQA.stopSession() | No replacement |
| MQA.isReady() | No replacement |
| MQA.isSetup() | No replacement |
| New | MQA.log(message) |
| New | MQA.verbose(message) |
| New | MQA.info(message) |
| New | MQA.warn(message) |
| New | MQA.error(message) |
| MQA.feedback(message) | MQA.sendFeedback(message) |
| New | MQA.feedback(title) |
| New | MQA.feedback(title, placeholder) |
| MQA.bug() | MQA.showReportScreen() |
| MQA.guard | No replacement |
Android
The classes in the com.apphance.android package are deprecated and replaced by the classes that are contained in the com.ibm.mqa package. Although the com.apphance.android package remains for compatibility with earlier versions, use the classes in the com.ibm.mqa package because additional functions are added only to this package.The following table lists the deprecated classes in the first column, and their replacements
in the second column.
| Deprecated | Replacement |
|---|---|
| com.apphance.android (package) | com.ibm.mqa (package) |
| com.apphance.android.Apphance | com.ibm.mqa.MQA |
| com.apphance.android.Log | com.ibm.mqa.Log |
| com.apphance.android.activity (package) | No direct replacement. See the classes in the com.ibm.mqa.ui package. |
| com.apphance.android.activity.ApphanceActivity | |
| com.apphance.android.activity.ApphanceListActivity | |
| com.apphance.android.activity.ApphancePreferenceActivity | |
| com.apphance.android.common | com.ibm.mqa.config |
| com.apphance.android.common.Configuration | com.ibm.mqa.config.Configuration |
| com.apphance.android.common.IBuilder | com.ibm.mqa.config.IBuilder |
| com.apphance.android.ui (package) | com.ibm.mqa.ui (package) |
| com.apphance.android.ui.FeedbackActivity | com.ibm.mqa.ui.FeedbackActivity |
| com.apphance.android.ui.ProblemActivity | com.ibm.mqa.ui.ProblemActivity |
| com.apphance.android.ui.ScreenshotEditorActivity | com.ibm.mqa.ui.ScreenshotEditorActivity |
The following new classes are introduced in the com.ibm.mqa package.
- com.ibm.mqa.dialog
- com.ibm.mqa.dialog.ProductionFeedbackDialog
The following methods in the com.apphance.android class are deprecated,
and there are no replacements.
- public static ScreenshotHelper getScreenshotHelper()
- public static void clear()
- public static boolean init(Context context)
- public static void setReportOnShakeEnabled(boolean enabled)
- public static boolean isReportOnShakeEnabled()
- public static void addOnLoginFinishedListener(OnLoginFinishedListener lfl)
- public static void finish()
- public static boolean removeOnLoginFinishedListener(OnLoginFinishedListener lfl)
- public static void dispatchLoginFinish(final boolean success)
- public static void addOnProblemReportedListener(OnProblemReportedListener prl)
- public static boolean removeOnProblemReportedListener(OnProblemReportedListener prl)
- public static void dispatchProblemReport(final String message)
- public static void log(final String level, final String tag, final String message)
- public static void log(final String level, final String tag, final String message, final DebugInfo debugInfo)
- public static void invokeOriginalEntryPoint(Context context)
- public static void flush()
- public static String getApiKey()
- public static Mode getMode()
- public static void setDefaultUser(String defaultUser)
- public static String getDefaultUser()
- public static Activity getCurrentActivity()
- public static void setServerURL(String url)
- public static String getServerURL()
- public static boolean isStarted()
iOS
The APHLogger protocol is deprecated and replaced by the MQALogger protocol. Although the APHLogger protocol remains for compatibility with earlier versions, use the MQALogger protocol because additional functions are added only to MQALogger.The following table lists the deprecated protocols and their
replacements.
| Deprecated | Replacement |
|---|---|
| APHLogger | MQALogger |
| APHLogLevel | MQALogLevel (including log levels) |
| APHUncaughtExceptionHandler | MQAUncaughtExceptionHandler |
| APHLog | MQALog |
| APHExtendedLog | MQAExtendedLog |
| defaultSettings (for example: [[APHLogger defaultSettings] ...... ]) | settings (for example: [[MQALogger settings] ...... ] |
The following new modes are introduced in the [MQALogger
settings] protocol for Objective-C:
- [[MQALogger settings] setMode:MQAModeMarket];
- [[MQALogger settings] setMode:MQAModeQA];
The following mode in the [MQALogger settings] protocol
for Objective-C is deprecated, and there is no replacement:
- [[MQALogger settings] setMode:MQAModeSilent];
The following new modes are introduced in the [MQALogger
settings] protocol for Swift:
- MQALogger.settings().mode = MQAMode.QA;
- MQALogger.settings().mode = MQAMode.Market;
- MQALogger.settings().mode = MQAMode.Silent;