The preceding steps described how to configure the server side Store.Mobile.REST module of CRS-IUA. It is important that CRS-IUA’s iOS client is configured and built through Xcode so that the configuration matches the server-side setup.

To get started, open the StoreWorkspace workspace located in the directory where you unzipped the files, at:

<home>/MobileCommerceiOS/StoreWorkspace.xcworkspace

Configuration

To get CRS-IUA up and running in your environment, configure the following MobileCommerce-Info.plist entries:

Additionally, for a release build intended for production ATG_USE_HTTPS should be set to “YES” in order to enable SSL. This is strongly recommended and will require additional supporting configuration within your infrastructure to fully enable SSL.

Use this method of configuration when distributing an app, since the values of the MobileCommerce-Info.plist are used by default until they are manually overridden in the settings bundle. Refer to the Apple documentation on how to enable building and installing the device for your device.

Settings Bundle

The iOS client includes a Settings bundle located <home>/MobileCommerceiOS/ATGMobileStore/MobileCommerce/Settings.bundle, where <home> is the directory where you extracted the distribution. This bundle manages server settings, such as ports, host, and Site ID, from the Settings app. This bundle is included in CRS-IUA for demonstration purposes. Once CRS-IUA is installed on the iOS device, touch MobileStore in Settings and configure the Host and Port server settings to point to your dedicated server.

Use the Settings bundle for configuration when demonstrating the application since you can quickly change server settings without rebuilding the app and reinstalling. You may want to remove the setting bundle when releasing an app and use the values defined in MobileCommerce-Info.plist.

Note: Once the app is installed, you can also configure these setting by touching Settings > MobileStore.

Build Settings and Related Warnings

Since IUA shares considerable code with Oracle Commerce Assisted Selling Application (ASA), build setting changes in ASA have affected IUA also in this release. Both IUA and ASA versions 11.1 are developed for iOS 7.1 in Xcode 5.1. In Xcode 5.1 Apple added arm64 to the default Standard Architecture build setting. However, 64-bit versions of the libraries required for the sled hardware integration added for swiping a card and checking out from ASA were not available at the time of implementation and as a result the build settings for the Agent project were changed from the default (which builds 64-bit binaries) to the setting that builds 32-bit binaries. In Xcode, you will see many warnings related to this, such as Validate Project Settings and Update to recommended settings.