iOS Hybrid Web Container Customization

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

You can customize the Hybrid Web Container in a variety of ways.

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

The WorkFlow directory contains directories such as Classes, libs, and includes, as well as images and other files. It also contains the WorkFlow.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 inlcuded in the WorkFlow 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. Sybase recommends that you always test your changes before using the resulting application.