Debug the Commerce Cloud Endless Aisle App

Set Loggable Categories

You set the loggable categories that appear in the Appcelerator Studio console or in the Admin Dashboard. When you initially start viewing logs, you might want to specify "all" to ensure you get as much information as possible.

You can set the loggable category to be very specific. When you set a loggable category, all of its sub-categories are also logged. For more details, see Logging.

When running the app from Appcelerator Studio, you can view the console to see the logging information.

In Appcelerator Studio console window, click the Log level icon and select Trace.

Debug the App Code

You can set breakpoints in the code; you have to set breakpoints in the Resources directory for anything outside of the controllers directory (models, lib). For controllers you can set the breakpoint in the original file.
If the Derived File Encountered dialog, which asks "This file is derived. Do you really want to edit it?" appears, click No.
You can run the app in debug mode by selecting Run > Debug As.
Set Up Error Logging for Endless Aisle and change Send Email to Endless Aisle Admin and Endless Aisle Admin Email Addresses.

Note: If you set a breakpoint, but it's never reached, see details on debugging in Titanium http://docs.appcelerator.com/platform/latest/#!/guide/Alloy_Debugging_and_Troubleshooting-section-34637808_AlloyDebuggingandTroubleshooting-Debugging.

Run the App in the Simulator and iPad

When customizing the Endless Aisle app in Appcelerator Studio, you run the app in the simulator. When ready, you can then deploy the app to a device, such as an iPad.

You can use the same wifi when running the app in the simulator and on the device.
The simulator doesn't support connecting to payment devices, except for Adyen devices over Ethernet, in which case the device and simulator must be on the same network. To test payment in the simulator, you enable simulating payment in user.js by setting allow_simulate_payment : true . Before deploying the app to a device, you should disable simulating payment.

Debug Modules

Xcode Debugger and Appcelerator Studio Debugger can be connected to the same iOS process at the same time for debugging, which allows for debugging JavaScript and Objective-C code at the same time.

You must change “Release” to “Debug” in the build.py file in the module’s code directory to create debug builds.

To connect a running app to Xcode, in the Debug menu, select Attach to Process. Select the Endless Aisle app. You can then set breakpoints and step through the code. You can view the console to see information such as the iOS logging statements.

View the Console for the Device

When you have deployed the Endless Aisle app to a device, such as an iPad, you can connect the device to your development machine to view the console log of the device.

Install the app on the device.
Start the Endless Aisle app.
Open Xcode.
Click the Devices tab.
Select the device that is connected to the iPad.
Select the console for the device.

Debug in the Store

You should set up error logging for Endless Aisle. If a store associate encounters a JavaScript error in the app, a dialog appears with the error, for example "Can't find variable: items at enterAddressNoState.js (line 45)". The associate can enter information about what actions they were performing and send that information to the admin email address.

Use the Admin Dashboard

To access the Admin Dashboard in the app, tap the Hamburger Menu and select Admin Dashboard. You can use the Admin Dashboard while customizing and debugging the app or even in the store to gather information including:

The version of the app
App settings:, the store, app timeout, whether simulate payments and image zoom are enabled, and store availability settings
The storefront host URL, OCAPI base URL, and OCAPI client ID

To assist in debugging, the Admin Dashboard also lets you:

Clear the locally stored catalog and product data from the cache
Email the app configuration data to the address specified when you set up error logging for Endless Aisle.
Run unit tests and basic functionality tests
The model tests that are available with the Endless Aisle source are configured to run with the out-of-the-box app. To be able to test your app, you modify the data that the tests use. To change the data that the tests use, you modify the app/assets/config/modelTest.js file. You should specify data that is valid for all the stores where the app is deployed. When you run the tests, you should be aware that they use the current login session. You shouldn't be shopping on behalf of a customer; the tests can modify basket contents. You also might not want to be logged in as an associate (other than the one specified in the app/assets/config/modelTest.js file).

Note: You can run only one test at a time.
View and email logs for loggable categories that you specify on the fly
You can see the most recent 100 lines of the console log. This is the same content that appears in the Appcelerator Studio console. You might want to specify "all" as the loggable category to ensure you get as much information as possible.

View Server Code Logs

To view the Endless Aisle server logs you configure Business Manager.

Set Up Server Side Logging.
In Business Manager, select Administration > Site Development > Development Setup to check the server logs (error*.log).