Version 1.2

Start-up Package

2 | 1 8

Table Of Contents Start your Implementation ........................................................................................................................ 3

Steps Overview .............................................................................................................................. 3

(Required) Enroll in the iOS Developer Enterprise Program .......................................................... 3

Provide Graphic Design Assets and Theme Configuration ............................................................. 4

Specify Configuration Details ......................................................................................................... 7

(Required) Provide Distribution Files ............................................................................................ 11

Summary & Checklist ............................................................................................................................. 12

Appendices .............................................................................................................................................. 13

iOS App Re-signing Concepts ...................................................................................................... 14

Advanced Re-Branding ................................................................................................................ 16

3 | 1 8

Back to Table of Contents

Start your Implementation

Implementing your SharePlus application requires you to complete five steps to start the process and correctly configure your application. This section helps you achieve these steps to meet your needs and personalize its look and feel. The IOS Developer Enterprise Program will allow you to distribute your application internally. While in the Graphic Design and Configuration steps you will have the chance to customize, trim or modify many of the features that SharePlus provides. This will allow you to better control how users interact with the application. In the Distribution stage you will provide us with two important files (provided by Apple Inc.) to digitally sign the application so it becomes yours when it is built.

Steps Overview Start your SharePlus project implementation following these steps:

1. (Required) Enroll in the iOS Developer Enterprise Program

2. Provide Graphic Design Assets and Theme Configuration

3. Specify Application Configuration Details

4. (Required) Provide Distribution Files

Enroll in the iOS Developer Enterprise Program To distribute the app internally, Apple requires you to be part of the iOS Developer Enterprise Program.

You just need to fill a form in Apple’s website to start the process and then wait for Apple’s response.

Once you complete the process, Apple will provide you an account that will be needed to complete the

Distribution step.

Timeframe

This process usually takes at least two weeks and it depends entirely on Apple’s approval. So, if you are

not part of this program already, it is important that you start the process as soon as possible.

ENROLL https://developer.apple.com/programs/start/enterprise/

4 | 1 8

Provide Graphic Design Assets and Theme Configuration In this step you will provide our engineers with the application icons, splashes and passcode lock

headers they need to personalize your application’s graphics. These include icons your application will

show in the iOS User Interface along with other images the application itself will use when it is launched.

Besides the graphic assets, you may provide a desired theme configuration to adjust the color palette.

Samples

Download the Sample Graphics package from http://download.infragistics.com/shareplus/site/4.0.html.

Application Re-Branding

Re-branding can be achieved through the inclusion of customized assets and the configuration of the

application color settings (theme).

List of Re-Branding PNG Images

Re-branding images include:

Application Icons, used in the Springboard, iTunes Artwork, device settings, Spotlight.

Splash screens, images displayed when first launching the app while the interface loads.

Passcode Lock headers, you can optionally change the Passcode Lock header.

App Icons Springboard / iOS home screen

iTunes Artwork

Device settings

Spotlight search

5 | 1 8

Splash screens

Passcode Lock headers

Basic Re-Branding

This iOS7 Application Re-Branding method is quick and straightforward, but it has some minor drawbacks. The method requires only three images that will be stretched to match all the required sizes for the application icons, splash screens and passcode lock headers.

Minor drawbacks for images generated with this re-branding method:

Images are stretched and won’t be pixel-perfect. This means that for the trained eye, severalimage quality factors like sharpness or distortion may suffer.

The app icon image is heavily stretched, ranging from 1024 x 1024 to 76 x 76 px.To make your logo noticeable in small icons, the logo should cover most of the image canvas.

Image provided Result

6 | 1 8

Important considerations on graphic assets:

All images must follow these general requirements:

o No transparency, except the Passcode Lock header

o 72 dpi

o PNG format

In the list below you will find the minimum required images for iOS7.

Required Images iOS VERSION IMAGE LOCATION DEVICE MIN SIZE (px) TENTATIVE NAME

iOS7

All App Icons iPad/iPhone 1024 x 1024 app-icon@2x

All Splash Screens iPad/iPhone 2048 x 1536 default-Landscape@2x

All Passcode lock headers iPad/iPhone 948 x 292 header@2x

Note: If you need information regarding iOS6 or you want to have more control over the

re-branding process, refer to the Advanced Re-Branding section in the Appendices.

The Application’s Theme

With the iOS7 theme, you can adjust the UI appearance in iOS7 environments according to your needs.

7 | 1 8

Theme Configuration Form

Adjust the UI appearance in iOS7 environments by definining a key color in the application.

Enable Theme Management:

iOS7 RGB Color Settings:

Tint Color R: G: B:

Specify Configuration Details You can make SharePlus fit your company’s needs by customizing SharePlus features’ settings or even

trim those features you don’t want by filling in the configuration form.

Guidance

Please refer to Chapter 1: Planning Configuration in SharePlus 4.0 Administrator Guide for guidance. For

a complete list of available settings check the Configuration Reference appendix in SharePlus 4.0

Administrator Guide and contact your Sales Engineer.

Application Configuration Form

APPLICATION NAME

Name:

INFO Application display name, cannot be larger than 13 characters

CONFIGURATION BROADCAST

Remote Configuration URL:

INFO

Configuration Broadcast allows system administrators to broadcast and replicate SharePlus’ configurations to all devices that have it installed. A remote configuration file is loaded by SharePlus every time the application is launched in order to load any existing update. Please refer to the Configuration Broadcast Guide for further information.

FEATURES

Allow SITES Administration:

INFO Allow add/edit/delete SharePoint sites in SharePlus.

Include Pre-configured SITES:

8 | 1 8

Allow LISTS Administration:

INFO Allow the user to set up SharePlus’ list settings of any SharePoint list.

Allow LISTS Offline Support Administration:

INFO Allow the user to set up SharePlus’ list Offline settings of any SharePoint list.

Allow ITEMS Administration:

INFO Allow the user to perform actions over items. Includes add, edit, delete, check out, approve/reject, copy URL, email URL, and save as draft actions.

Allow LOCAL FILES Section:

INFO Allow the user to copy documents from libraries, send documents via email, and share data via Wi-Fi (download and upload).

Show GLOBAL SETTINGS:

INFO Show auto-lock settings, connection timeouts, application logs, synchronization idle time settings, and other low-level parameters.

GLOBAL SETTINGS Configuration:

CONFIGURE CONNECTIVITY

Specify Connection timeout (seconds):

INFO Amount of seconds the app waits for a response before assuming a time out.

Specify Sync idle time (seconds:

INFO Amount of seconds that the app will wait, after being idle, to trigger a sync process.

Specify user agent:

INFO SharePlus’ user agent. If empty, the standard Mozilla user agent will be used.

9 | 1 8

Specify SSL level:

INFO Change the SSL level to be used with secure HTTP connections (HTTPS).

Enable technical log:

INFO Information logs about app’s requests and server’s responses. Logs are generated in Local Files under the “Logs” folder.

CONFIGURE CAFFEINE MODE

Disable device’s auto-lock on preview:

INFO Prevents the device from locking itself when previewing documents.

Disable device’s auto-lock on sync:

INFO Prevents the device from locking itself during the synchronization process.

Device must be plugged in to disable device’s auto-lock:

INFO Enables both auto-lock options only if the device is plugged in.

MISCELLANEOUS

Preview documents on tap:

INFO When tapping a document, default action is to open the document’s preview instead of displaying the item’s details (metadata).

Remove local files after upload:

INFO Remove the local copy of a file after it has been used as an attachment or a new item was created.

Auto hide navigator:

INFO When browsing a list, the navigator (left pane) auto hides by default unless this value is set to No.

10 | 1 8

CONFIGURE PASSCODE LOCK

Show passcode lock settings:

INFO Allow the user to modify the passcode lock settings.

Enable passcode lock by default:

INFO Enable/Disable the passcode lock feature by default.

Default passcode:

INFO Default passcode configured by default.

Force passcode lock:

INFO Force the user to work with a passcode lock. Requires the user to set it up on the first application run.

Prompt passcode lock after:

INFO Time in minutes that the application will remain idle before it becomes locked.

Enable fails handle:

INFO Allow messages to be displayed and actions to be performed when the passcode lock authentication fails.

Maximum amount of failed attempts:

INFO The maximum amount of failed authentication attempts.

Block application:

INFO Specify if the application will be blocked or not.

Wipe data:

INFO Clear internal application data when the user fails to provide the valid passcode lock. Including Local Files, Offline cache, internal database and other user data.

11 | 1 8

Message:

INFO Message to be displayed when the user fails the last attempt, having no more attempts left.

CONFIGURE FEEDBACK

Error reporting email address:

INFO Default email addresses to send errors and feedback reports. Addresses should be specified separated by comma and they will be included in the TO field when composing a new message.

Enable feedback form:

INFO Allows the user to send feedback from inside the application.

NOTES

Provide Distribution Files Details - To digitally sign the application using your Enterprise Certificate, provided to you by Apple

Inc., we need you to create a Distribution Provisioning Profile and a Distribution Certificate with

Apple. By using these two files we are able to legally create a custom build of SharePlus that’s

registered by Apple as yours so you are able to use and legally distribute it as you please.

Note: Take into account that we need a Personal Information Exchange (.p12) file instead of the

certificate (.cer) file.

Guidance - For general information please refer to iOS App Re-signing Concepts in the Appendices.

For deployment-specific information refer to Chapter 1 (Planning Deployment) and Chapter 4

(Deployment) in SharePlus Administrator Guide.

PROVIDE

Your company’s Distribution Provisioning Profile and Distribution Certificate with the password set

when exporting it on the KeyChain Access.

12 | 1 8

Back to Table of Contents

Summary & Checklist

To conclude, the following steps are required to start your application implementation:

1. (Required) Enroll in the iOS Developer Enterprise Program in Apple.

2. Provide the Application’s graphic assets.

3. Complete the Theme Configuration Form.

4. Complete the Application Configuration Form.

5. (Required) Provide the Distribution Provisioning Profile and Distribution Certificate

iOS7 Re-branding assets ready to send SIZE (px) TENTATIVE NAME READY

1024 x 1024 app-icon@2x

2048 x 1536 default-Landscape@2x

948 x 292 header@2x

Configuration Forms filled FORM READY

Theme Configuration

Application Configuration

Distribution Files ready to send

FILE READY

Distribution Provisioning Profile (created with the corresponding bundle ID)

Distribution Certificate (.p12 file)

13 | 1 8

Appendices

Appendix 1: iOS App Re-signing Concepts

Appendix 2: Advanced Re-Branding

14 | 1 8

iOS App Re-signing Concepts

Certificates and Profiles Importance To digitally sign a SharePlus application for enterprise distribution you need two main resources:

Enterprise Distribution Certificate

Distribution Provisioning Profile

Those resource files are owned by companies enrolled in Apple’s Enterprise Program and can be retrieved from apple’s portal.

Enterprise Distribution Certificate The distribution certificate is a private certificate that is provided by Apple. Certificates are created to

help Apple identify your company and, once retrieved, a certificate must be installed to be used in the

application signing process.

Distribution Provisioning Profile The provisioning profile is targeted to one or more apps and can be retrieved from Apple’s portal.

Profiles are created to authorize specific apps to run in iOS devices. A specific app can be uniquely

identified by its bundle ID.

There are two types of provisioning profiles:

Ad-Hoc - It is commonly used for internal testing and is restricted to specific devices.

In-House - It depends only on the App ID and is not limited by device IDs.

About the App ID and Bundle ID

App IDs are used by Apple to identify applications. An App ID is a string composed with two parts, a

Team ID prefix and a bundle ID search string.

The Bundle Identifier (bundle ID) is a unique string used to identify a specific application’s bundle. The

application bundle contains the executable code and all resources required to run the application. The

Team ID prefix is automatically provided by Apple’s portal and identifies a development team.

ENROLL• Join Apple's iOS Developer Enterprise Program

PREPARE TO SIGN• Create and install the DISTRIBUTION CERTIFICATE

• Create and download a PROVISIONING PROFILE

SIGN & DEPLOY• Sign the app IPA

• Add a SharePlus license

• Distribute the app IPA

15 | 1 8

The Certificate-Profile Relation Provisioning Profiles are closely related to the Distribution Certificate. Because of that, if the certificate

expires the distributed application will no longer run.

A Distribution Certificate can have more than one Provisioning Profile associated and a Provisioning

Profile can target more than one bundle ID. Profiles are created for a specific App ID, but you can

include a wildcard (.*) in the App ID specification.

For example, by entering A1B2C3D4E5.com.infragistics.* as the App ID, the same Provisioning Profile

can be used for com.infragistics.shareplus and com.infragistics.reportplus bundle IDs.

Certificate-Profile expiration

Both Distribution Certificates and Provisioning Profiles must be renewed periodically.

Distribution Certificate – valid for 3 years

Provisioning Profile – valid for 1 year

SharePlus License SharePlus app must have a license associated for each application’s bundle identifier (Bundle ID).

SharePlus will not run in a device if the license file (license.splic) is missing or invalid.

The Contoso Company example Contoso company wants to distribute SharePlus Enterprise app internally.

To enable app distribution to iOS devices, Apple requires Contoso to be a part of the iOS Developer

Enterprise Program. A Distribution Certificate (ContosoCertificate.p12) is needed to legally register an

app under Contoso’s name.

Next, Contoso must define a bundle ID (com.contoso.shareplus) in order to identify SharePlus Contoso

application. To register the bundle ID, Contoso needs to create a new App ID

(A1B2C3D4E5.com.contoso.shareplus) in Apple’s Provisioning portal. The Team ID prefix (A1B2C3D4E5)

included in the App ID is provided by Apple.

After that, a Provisioning Profile (SharePlusContoso.mobileprovision) can be created and downloaded

from Apple’s portal to use the previously defined bundle ID (com.contoso.shareplus).

Finally, a SharePlus license (license.splic) provided by Infragistics must be included in the IPA to be

signed. Note that a SharePlus application will not run without a license file.

After gathering all the required resources, the SharePlus Contoso IPA can be signed and distributed by

Contoso company.

For further details about the whole process refer to the Start-up Package document and Application Re-

Signing Process section in the SharePlus Administrator Guide.

Distribution Certificate

Provisioning Profile

App ID Bundle ID

Provisioning Profile

App ID

Bundle ID

Bundle ID

16 | 1 8

Advanced Re-Branding

Re-branding can be achieved through the inclusion of customized assets and the configuration of the

application color settings (theme). As specified in the main chapter, Re-branding assets include:

Application Icons, used in the Springboard, iTunes Artwork, device settings, Spotlight.

Splash screens, images displayed when first launching the app while the interface loads.

Passcode Lock headers, you can optionally change the Passcode Lock header.

Important considerations on graphic assets:

All images must follow these general requirements:

o No transparency, except the Passcode Lock header

o 72 dpi

o PNG format

iTunes Artwork images must be named without the .png extension.

Required images are mandatory.

iOS6-related images are relevant only if you are using devices running iOS6.

iOS7 Complete Re-Branding

In the list below you will find all the required application icons and splash screens for iOS7. Passcode

lock images are also recommended to enhance the application’s user experience.

Required Images iOS VERSION IMAGE LOCATION DEVICE SIZE (px) TENTATIVE NAME

iTunes iTunes Artwork - 512 x 512 iTunesArtwork

1024 x 1024 iTunesArtwork@2x

iOS7

Springboard / iOS Home Screen iPad

76 x 76 appIcon-76x76-ipad

152 x 152 appIcon-76x76@2x-ipad

iPhone 120 x 120 appIcon-60x60@2x-iphone

Launch / Splash Screen

iPad

768 x 1024 default-700-Portrait-ipad

1536 x 2048 default-700-Portrait@2x-ipad

1024 x 768 default-700-Landscape-ipad

2048 x 1536 default-700-Landscape@2x-ipad

iPhone 640 x 960 default-700@2x-iphone

640 x 1136 default-700-568h@2x-iphone

Passcode Images (Recommended) iOS VERSION IMAGE LOCATION DEVICE SIZE (px) TENTATIVE NAME

iOS7 & iOS6 Passcode lock header

iPad 474 x 146 header-ipad

948 x 292 header@2x-ipad

iPhone 292 x 77 header-iphone

584 x 154 header@2x-iphone

17 | 1 8

iOS6 Complete Re-Branding

In the list below you will find all the required application icons and splash screens for iOS6. Passcode

lock images are also recommended to enhance the application’s user experience.

Required Images iOS VERSION IMAGE LOCATION DEVICE SIZE (px) TENTATIVE NAME

iTunes iTunes Artwork - 512 x 512 iTunesArtwork

1024 x 1024 iTunesArtwork@2x

iOS6

Springboard / iOS Home Screen

iPad 72 x 72 appIcon-72x72-ipad

144 x 144 appIcon-72x72@2x-ipad

iPhone 57 x 57 appIcon-57x57-iphone

114 x 114 appIcon-57x57@2x-iphone

Launch / Splash Screen

iPad

768 x 1024 default-Portrait-ipad

1536 x 2048 default-Portrait@2x-ipad

1024 x 768 default-Landscape-ipad

2048 x 1536 default-Landscape@2x-ipad

iPhone

320 x 480 default-iphone

640 x 960 default@2x-iphone

640 x 1136 default-568h@2x-iphone

Passcode Images (Recommended) iOS VERSION IMAGE LOCATION DEVICE SIZE (px) TENTATIVE NAME

iOS6 & iOS7 Passcode lock header

iPad 474 x 146 header-ipad

948 x 292 header@2x-ipad

iPhone 292 x 77 header-iphone

584 x 154 header@2x-iphone

The Application’s Theme

You can adjust the application’s theme according to your needs. There are two different theme

configurations, one for iOS7 and another for iOS6.

With the iOS6 theme, you can adjust the color palette and also apply individual changes to some UI

components like the top and bottom bars.

18 | 1 8

Theme Configuration Form

Enable Theme Management:

iOS6 RGB Color Settings:

Navigation Bar R: G: B:

Search Bar R: G: B:

Toolbar R: G: B:

TabBar R: G: B: