Mobile application debugging  

Introduction

During the process of developing custom solutions for the Mobile Creatio application, you need to repeatedly perform application debug.

Mobile application is not an application of a hybrid type (mobile web application in the native shell) and you can debug it via Google Chrome Developer tools in the Mobile device mode. More information about debugging the application code via browser development tools can be found in the “Client code debugging“ article.

To launch a mobile application in the debug mode:

1. Get the files necessary for debugging the mobile application.
2. Launch the startchrome.bat.
3. Enter the debug mode for mobile devices in the Google Chrome.
4. Make the necessary settings and synchronize the mobile application Creatio.

Getting the necessary files

Contact the support team to get the files for debugging a mobile application. Support team will provide an archive with corresponding files. Extract archive to any folder (for example, C:\сreatio\Mobile ) (Fig. 1).

Fig. 1. The contents of the unpacked archive

Launch of the startchrome_withcookie.bat

The startchrome_withcookie.bat is located in the root folder of unpacked archive. The Google Chrome will launch after executing the startchrome.bat.

When you first start the browser with the startchrome.bat, an information window will appear, warning you about saving the files to the file system (Fig. 2). Allow the saving of the files. Close the warning about the --disable-web-security unsupported file (Fig. 2).

Fig. 2. Information window with warning

Running emulator for Google Chrome browser version 80 and up

You cannot currently run the emulator for Google Chrome browser version 80 and up using the standard mechanism.

We recommend the following running algorithm:

1. Download Google Chrome Portable 79  and install it to the root of disk D:
2. Enter the following changes in the startchrome_withcookie.bat file:

   @echo off
   SET PAGEPATH=appV2\MobileApp\MobileMainPage.html
   start D:\GoogleChromePortable\GoogleChromePortable.exe --disable-features=IsolateOrigins,site-per-process --allow-file-access-from-files --disable-web-security --disable-popup-blocking --user-data-dir="%~dp0\\ChromeUserData" --enable-device-mode "file:///%~dp0%PAGEPATH%?platform=webkit&usecookie=true"
   

    

   ATTENTION

   Pay attention to the path of Google Chrome Portable! If the GoogleChromePortable.exe file is installed in a different directory, change the file accordingly.

3. Run startchrome_withcookie.bat.

The execution of startchrome_withcookie.bat will launch the Google Chrome with the settings page of Mobile Creatio application (Fig. 3).

Fig. 3. Mobile application settings page

Switching to mobile application debugging mode

To access the developer tools in Google Chrome, press F12 key or Ctrl + Shift + I keys. You can debug the local version of the mobile application in the browser. More information about debugging application code via browser development tools can be found in the “Client code debugging“ article article.

 

 

Configuring and synchronization of the mobile application

At first login to the mobile application, you need to enter the HTTP address of the Creatio application on the settings page. To do this, you need to start debug process and click the [Continue] button (Fig. 4). After that, enter user name and password (Fig. 5).

Fig. 4. Settings page of the local mobile application

Fig. 5. Login page

After configuration and login, the local version of mobile application will behave as an application installed to the mobile device. The native functions of the mobile device (for example, working with the camera, downloading files, etc.) will not be supported. More information about working with mobile device in Creatio can be found in the Mobile Creatio documentation.