Skip to main content
Version: v11.9.4

WavePulse - To Inspect and Debug APK/IPA File

WavePulse is a feature in WaveMaker, designed to provide real-time diagnostics for applications. It helps developers to ensure that their applications are running smoothly by offering insights into various metrics and logs.

WavePulse is particularly useful for maintaining high-performance applications, ensuring stability, and providing end-users with a seamless experience. It enhances the process of debugging by allowing you to inspect the APK or IPA file of an application with out requiring mobile phone to be connected to system. Remote debugging is possible.

To access WavePulse, click here.

Key Features​

  • Debug using IPA and APK: Uses IPA or APK file to debug rather than using the React Native Zip file of an application.
  • Simple Setup: Simplifies the process of setup as it requires only one tool, WavePulse and few steps to get started with it.
  • Debugging on Real Devices: Debugging can be done on any device given WavePulse is enabled in the application to be debugged.
  • Importing and Exporting Debugging Session: Debugging session can be easily exported or imported using WavePulse.
  • Viewing WaveMaker Specific Data: WaveMaker specific component and other details can be easily viewed. User can find every detail at one place, like:
    • Console logs
    • Network
    • Element Tree with Properties and Styles
    • Timeline of various events
    • Storage
    • Info

WavePulse Debug Architecture​

Debugging is the process of identifying, analyzing, and resolving issues in an application. This step makes sure that the application functions as expected. WavePulse allows you to debug the APK or IPA file of an application on a mobile device where the application details required for debugging can be viewed in the web browser.

note

JavaScript debugging is not supported in WavePulse.

Debugging Architecture

The debugging architecture using WavePulse includes the following steps.

Steps in WaveMaker Studio​

1. In WaveMaker studio, enable WavePulse.
2. Generate APK or IPA file

Steps in Web Browser​

3. Open WavePulse application and go to step 4.
5. Establish connection between WavePulse web application and mobile device by providing application ID. Go to step 6.
8. Now, the debug session of the application can be viewed in WavePulse.

Steps in Mobile Device​

4. In mobile device, download and install the APK or IPA file.
6. Using mobile device scanner, scan QR code to run the application.
7. Application is launched. To view the debug session go to step 8.

Enable WavePulse in Application​

An application can be debugged using the APK or IPA file. To get the APK or IPA that can be debugged using the WavePulse,

  1. Go to File Explorer.
  2. Navigate to src/main/webapp/wm_rn_config.json to find the wm_rn_config.json file.
  3. Inside wm_rn_config.json. set enableWavePulse and enablelogs as true. Click Save. This enables the WavePulse in the application and you can view console logs.
danger

WaveMaker recommends enabling and using WavePulse only for pre-release builds. It is advised to disable WavePulse, in builds for Play store or App Store submissions.

Generate APK/IPA file using React Native Zip file​

APK for Android and IPA for iOS can be generated using React Native zip file that is a package of project data. To know the process of generating APK and IPA file, you can either use

Connection between Web Browser and Mobile Device​

A connection is established between WavePulse and Application to record and view debugging session associated with the actions performed in the application.

Follow the steps below to establish the connection:

note

When using any private network with restrictions, ensure that the mobile device can access WavePulse web application in your network.

  1. Open WavePulse web application and enter the application ID that is fetched from Settings > Build Preferences page.

  2. Install the APK/IPA on your mobile device and close the app before scanning the QR code.

  3. Scan the QR code in WavePulse or use the link below it to launch the app in debug mode.

  4. Grant permission to connect the mobile application to the debugging session in WavePulse.