This version of the documentation supports the 3.2 version of BMC Digital Workplace Basic. Click here to view the documentation for the current version.

Rebranding BMC MyIT for Apple iOS

This topic was edited by a BMC Contributor and has not been approved.  More information.

The following process describes how to rebrand BMC MyIT so that you can deploy a customized mobile app to end users who use Apple iOS devices. The mobile application is built using Swift and Objective-C for both 32- and 64-bit architectures. This means that the mobile application can be used on both 32-bit and 64-bit devices.

Warning

When you upgrade BMC MyIT, rebranding changes do not persist. Before you upgrade, create a backup so that you can restore your changes after the upgrade.

If you need assistance with rebranding the application, contact BMC Support, or your local account team.

The process involves the following procedures:

Before you begin

You must be a member of the Apple Enterprise Program to obtain the required development tools from the Apple Developer Portal. See the following resources for more information:

  • Apple Enterprise Program application—Apple requires you to be a company or organization with a D-U-N-S number to apply. An enterprise account allows you to distribute the rebranded application internally. An organization account enables you to distribute applications through the Apple store only.
  • Apple Developer Portal—Contains the development tools and documentation for developing Apple iOS apps.
  • Managing Your Team—Describes how to assign appropriate team roles.

See Re-signing BMC MyIT for Apple iOS for information about creating the certificate and re-signing the application. Making changes to the visual design files is not part of the re-signing process.

To rebrand the Apple iOS client for BMC MyIT

  1. Create the new graphic files according to the specifications in icon graphics and splash screen graphics.

  2. Create a folder for the icons (new_icons) and a folder for the splash screens (new_splash), and put the graphic files into those folders.

  3. Copy the icons into the application by issuing the following commands:
    cp -r new_icons/. Payload/MyIT.app/
    cp -r new_splash/. Payload/MyIT.app/
  4. Configure the built-in flags for rebranding, as in the following example:
    cd /path/MyIT-ResignDir
    /usr/libexec/PlistBuddy -c "Set CFBundleDisplayName $appName" Payload/MyIT.app/Info.plist
    /usr/libexec/PlistBuddy -c "Set myit-full-app-name $myit-full-app-name" Payload/MyIT.app/Info.plist
    /usr/libexec/PlistBuddy -c "Set myit-server $server" Payload/MyIT.app/Info.plist
    /usr/libexec/PlistBuddy -c "Set myit-port $serverport" Payload/MyIT.app/Info.plist
    /usr/libexec/PlistBuddy -c "Set myit-user $username" Payload/MyIT.app/Info.plist
    /usr/libexec/PlistBuddy -c "Set myit-pass $password" Payload/MyIT.app/Info.plist
    /usr/libexec/PlistBuddy -c "Set theme-dark $themecolor" Payload/MyIT.app/Info.plist
    /usr/libexec/PlistBuddy -c "Set theme-nav-bar $theme-nav-bar" Payload/MyIT.app/Info.plist
    /usr/libexec/PlistBuddy -c "Set theme-nav-highlight $theme-nav-highlight" Payload/MyIT.app/Info.plist
    /usr/libexec/PlistBuddy -c "Set navItemUpdates $navItemUpdates" Payload/MyIT.app/Info.plist
    /usr/libexec/PlistBuddy -c "Set navItemAppzone $navItemAppzone" Payload/MyIT.app/Info.plist
    /usr/libexec/PlistBuddy -c "Set hideReserve $hideReserve" Payload/MyIT.app/Info.plist
    /usr/libexec/PlistBuddy -c "Set hide-login-panel $hide-login-panel" Payload/MyIT.app/Info.plist
    /usr/libexec/PlistBuddy -c "Set hide-logo $hide-logo" Payload/MyIT.app/Info.plist
    /usr/libexec/PlistBuddy -c "Set hideContactIT $hideContactIT" Payload/MyIT.app/Info.plist

     

Icon graphics

The following table lists all supported application icon sizes. For more information about required and recommended icons, see Apple iOS Human Interface Guidelines: Icon and Images Sizes in the Apple iOS developer documentation.

Graphic
Size in pixels

File name

Usage

58x58 AppIcon@2x.png

iPhone - Settings

80x80 AppIcon80x80@2x.png iPhone - Spotlight
120x120 AppIcon120x120@2x.png iPhone App Icon
180x180 AppIcon180x180@3x.png iPhone App Icon
40x40 AppIcon40x40.png iPad Settings
80x80 AppIcon80x80@2x.png iPad Settings
40x40 AppIcon40x40~ipad.png iPad Spotlight
80x80 AppIcon80x80@2x~ipad.png iPad Spotlight
76x76 AppIcon76x76~ipad.png iPad App Icon
152x152 AppIcon76x76@2x~ipad.png iPad App Icon

Splash screen graphics

The following table lists all supported splash screen sizes. The splash screen displays when the application launches. For more information about required and recommended icons, see Apple iOS Human Interface Guidelines: Icon and Images Sizes in the Apple iOS developer documentation.

Graphic Size in pixels

File name

Display is not the actual size.

768 x 1024 Default@2x.png

Display is not the actual size.

640 x 1136 Default-568h@2x.png

Display is not the actual size.

750 x 1334 Default-667h@2x.png

Display is not the actual size.

 1242 x 2208  Default-736h@3x.png

Display is not the actual size.

1024 x 768 Default-Landscape~ipad.png

Display is not the actual size.

768 x 1024 Default-Portrait~ipad.png

Display is not the actual size.

1536 x 2048 Default-Portrait@2x~ipad.png

Display is not the actual size.

2048 x 1536 Default-Landscape@2x~ipad.png

Flags for rebranding

The following flags are built into the application for rebranding.

Flag Description
appName This short name of the app is displayed under the icon and throughout the app, except where the full name is displayed.
myit-full-app-name The full name of the app is displayed when the app is starting up, in the connection, login, and sync screens.
server The app will auto-connect to this server.
serverport When the app auto-connects to the server, it connects to this port.
username The app will auto-login with this user name.
password The app will auto-login with this password.
themecolor This color applies to several UI elements throughout the app.
theme-nav-bar Set the color for the navigation bar.
theme-nav-highlight Set the color for highlight line that is displayed under the navigation bar. The default color is orange.
navItemUpdates Change the name of the "Updates" feature in the app navigation menu.
navItemAppZone Change the name of the "AppZone" feature in the app navigation menu.
hideReserve Do not allow the ability to reserve locations.
hide-login-panel Do not show a background image for the login panel.
hide-logo Do not display the logo on login panel, connection screen, or the splash screen.
hideContactIT Do not display the option to contact IT.

Where to go next

Re-signing BMC MyIT for Apple iOS

Related topics

Apple Developer Portal

Apple iOS Human Interface Guidelines: Icon and Images Sizes in the Apple iOS Developer Library documentation

Apple Enterprise Program application in the Apple Developer Portal

Re-signing BMC MyIT for Apple iOS

Was this page helpful? Yes No Submitting... Thank you

Comments

  1. Marco antonio Martinez valdez

    I can Rebranding BMC MyIT for Android?

    Apr 11, 2017 09:07
    1. Michele Marques

      The Android client application can be rebranded. However, because of the Android architecture, you cannot perform this rebranding on your own; you must work with Professional Services.

      Apr 12, 2017 10:04