iOS Hybrid Web Container Customization

The Hybrid Web Container project that comes with SAP Mobile Platform is accompanied by libraries and the source code necessary for you to build the Hybrid Web Container.

Before getting started, unzip the directory that contains the Hybrid Web Container project as outlined in Building the Hybrid Web Container Using the Provided iOS Source Code. The Hybrid Web Container project unzips to a directory called HWC. Any references to a directory path in these procedures are relative to that top-level HWC directory.

The HWC directory contains directories such as Classes, libs, and includes, as well as images and other files. It also contains the HWC.xcodeproj, which is the Xcode project that builds the Hybrid Web Container, and is the project that is referenced in the customization procedures.

Whenever a customization requires a source code modification, there is a reference to “touch points” in the code. These references are annotated with IOS_CUSTOMIZATION_POINT and a descriptor identifying the customization to which they belong.

For example, all code areas associated with removing the PIN screen are annotated with IOS_CUSTOMIZATION_POINT_PIN. The touch points are typically accompanied by brief comments in the code explaining the necessary changes. Only source code files contain these touch points. The procedures describe where to modify plist files, strings files, and other non-source code files, but you must locate where to apply those changes.

The CustomizationHelper.m file included in the HWC project under the Classes group folder in the Xcode Project Navigator is used to encapsulate some of your customizations in a single place. In many cases, this file contains sample implementations of the customizations that you can follow.

Note: After performing any customizations, you must rebuild the project. SAP recommends that you always test your changes before using the resulting application.
Related tasks
Building the iOS Hybrid Web Container Using the Provided Source Code