For more information see the QA Console FAQ page.
The Apptimize QA console is a framework that can be integrated into your mobile app. It enables you to preview variants in different combinations from all of your active feature flags and experiments on a simulator or device. This approach of QA works well for customers with large teams that would like to test hands-on while using the app. Integrating the QA console is a simple one-time process. Once the console is in place, it works by overriding your allocations and forcing your selected variants internally.
The QA console is only intended to be integrated into debug/developer-build versions of your app and should not be included in releases to your end-users.
-
Download the latest release of the
qaconsole.aar
from here. -
Create or open an Android Studio project.
-
Click File—> New —> New Module. In the window that appears, select Import .JAR/.AAR Package and click Next.
-
Expand Gradle Scripts and open
build.gradle (for Module:app)
. Addimplementation project (":qaconsole")
dependencies. -
Open the source for the main activity or the activity where you wish to integrate QAConsole.
-
Add a private variable for QAConsole
private QAConsole qaConsole;
-
Initialize a new QAConsole in your
onCreate()
methodqaConsole = new QAConsole(getApplicationContext(), “<apptimizeAppKey>”);
-
Open the Apptimize dashboard, create and then launch your experiments.
-
Now run your app on a device/emulator.
-
If you are running on device, shake the device to launch the Apptimize QA Console.
-
Alternatively, you can launch the Apptimize QA Console programmatically.
// Add the following line to your onCreate method after initializing the qaConsole.
console.isShakeGestureEnabled = false;
// Call the launch method when you wish to display the console.
console.launchQAConsoleActivity();
-
In order to display Instant Updates while using the QA console to force specific variants, you will need to set
ApptimizeOptions
valuesetForceVariantsShowWinnersAndInstantUpdates(true)
Boolean value totrue
and pass the options when callingApptimize.setup
. For example:final String appKey = "YourAppKey"; final ApptimizeOptions options = new ApptimizeOptions(); options.setForceVariantsShowWinnersAndInstantUpdates(false); // ... set any additional options here Apptimize.setup(self, appKey, options);