The Watson Customer Experience Analytics (CXA) for Mobile Basic Edition SDK documentation is moving soon from the Knowledge Center to the Watson CXA for Mobile DevCenter on IBM developerWorks. The DevCenter is a one-stop shop that provides all the tools developers need to create, develop, and innovate with CXA Mobile. In the DevCenter, you will find step-by-step tutorials, APIs, documentation, community forums, and expert support.

Collecting images from your application with the Target Simulator

Use this task to capture the images in your application so that they can be transferred to the replay server for replay. The Target Simulator tool runs in Mac OS and Windows environments to capture Android and Mac OS application images. You use this tool after you have developed your application and have all of your images imbedded and any time that you embed new images in your application.

Before you begin

Note: This rake tool is mainly created to handle ImageView use cases, and if you notice missing images in replay pages, then you will have to use TargetSimulator to collect missing images in conjunction with it.

If you do not already have the IBM® SDK for Node.js installed on your local machine, download and install the SDK.

Procedure

  1. Extract the Target Simulator archive on the device that you used to create your application.
  2. Start the simulator with the default settings by entering node target_sim.js.
  3. Modify the configuration properties for your platform:
    IF you created your application for an... THEN...
    Android device
    1. Edit the TealeafBasicConfig.properties file.
    2. Set PostMessageUrl: to the URL that application reports is listening on.
    3. Set GetImageDataOnScreenLayout: to YES
    4. Set CachedFileMaxBytesSize: to 2,000,000,000
    5. Save and exit the file.
    iOS device
    1. Edit the TLFConfigurableItems.plist file.
    2. Set PostMessageUrl: to the URL that application reports it is listening on.
    3. Set GetImageDataOnScreenLayout: to YES
    4. Save and exit the file.
  4. Exercise every page in your application to capture all of the images that you added. In the target_sim.js console window, you see a running log of what POSTs were received and what images (if any) were found and saved to the file system.
  5. In the target_sim.js console window, press Control-C to exit the simulator.
  6. Reset the TealeafBasic configuration file to standard run-time settings.
    IF you created your application for an... THEN...
    Android device
    1. Edit the TealeafBasicConfig.properties file.
    2. Set PostMessageUrl: to the URL for the application Target page.
    3. Set GetImageDataOnScreenLayout: to NO
    4. Set CachedFileMaxBytesSize: to your production environment setting.
    5. Save and exit the file.
    iOS device
    1. Edit the TLFConfigurableItems.plist file.
    2. Set GetImageDataOnScreenLayout: to NO
    3. Save and exit the file.
  7. Transfer the images to the replay server.
Parent topic: Target Simulator