MultiExcerpt named 'space-announcement' was not found
The multiexcerpt named 'space-announcement' was not found. Please check the page name and MultiExcerpt name used in the MultiExcerpt Include macro.

Rebranding 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 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 MyIT, rebranding changes to the Universal client and the iOS mobile clients 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 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 MyIT

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

  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-highlight $theme-nav-highlight" Payload/MyIT.app/Info.plist
    /usr/libexec/PlistBuddy -c "Set theme-text-color $theme-text-color" Payload/MyIT.app/Info.plist
    /usr/libexec/PlistBuddy -c "Set theme-menu-header $theme-menu-header" 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
    /usr/libexec/PlistBuddy -c "Set hideBMCPolicy $hideBMCPolicy" Payload/MyIT.app/Info.plist
    /usr/libexec/PlistBuddy -c "Set hideSplashShadow $hideSplashShadow" 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

58x58AppIcon29x29@2x.png

iPhone - Settings

80x80AppIcon40x40@2x.pngiPhone - Spotlight
120x120AppIcon60x60@2x.pngiPhone App Icon
180x180AppIcon60x60@3x.pngiPhone App Icon
40x40AppIcon40x40.pngiPad Settings
40x40AppIcon40x40~ipad.pngiPad Spotlight
80x80AppIcon40x40@2x~ipad.pngiPad Spotlight
76x76AppIcon76x76~ipad.pngiPad App Icon
152x152AppIcon76x76@2x~ipad.pngiPad App Icon
167x167AppIcon83.5x83.5@2x.pngiPad Pro 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.

GraphicSize in pixels

File name

Display is not the actual size.

640 x 960LaunchImage-700@2x.png

Display is not the actual size.

640 x 1136LaunchImage-700-568h@2x.png

Display is not the actual size.

1024 x 768LaunchImage-700-Landscape~ipad.png

Display is not the actual size.

2048 x 1536LaunchImage-700-Landscape@2x~ipad.png

Display is not the actual size.

768 x 1024LaunchImage-700-Portrait~ipad.png

Display is not the actual size.

1536x2048LaunchImage-700-Portrait@2x~ipad.png

Display is not the actual size.

750 x 1334LaunchImage-800-667h@2x.png

Display is not the actual size.

1242 x 2208LaunchImage-800-Portrait-736h@3x.png

Logo image graphic

You can use the following graphic for changing the original BMC logo on the splash screen. Add this graphic to the new_splash folder, along with the other splash screen graphics.

Note

This is an optional resource. If you want to retain the original BMC logo on the splash screen, do not add this image file to the new_splash folder.

Graphic 
Size in pixels

File name

Note: Display size and background color is not actual. The actual image has a transparent background with white text. Click the image to preview it.

600 x 300app-logo-image.png

Flags for rebranding

The following flags are built into the application for rebranding.

FlagDescriptionFormat
appNameThis short name of the app is displayed under the icon and throughout the app, except where the full name is displayed.

String

e.g. "MyIT"

myit-full-app-nameThe full name of the app is displayed when the app is starting up, in the connection, login, and sync screens.

String

e.g. "MyIT"

serverThe app will auto-connect to this server.

String

e.g. "myserver.domain.com"

serverportWhen the app auto-connects to the server, it connects to this port.

String

e.g. "9000"

usernameThe app will auto-login with this user name.

String

e.g. "Mary"

passwordThe app will auto-login with this password.

String

e.g. "password"

themecolorThis color applies to several UI elements throughout the app such as the navigation bar, menu and so on.

String

e.g. "#00FFFF"

theme-nav-highlight

This color applies to several UI elements, such as the following elements:

  • The highlight line that is displayed under the navigation bar (the default color is orange)
  • The Connect and Login buttons
  • The highlighted text in menu

String

e.g. "#00FFF"

theme-text-color

Set the text color for several UI elements such as navigation and menu text.

String

e.g. "#00FFF"

theme-menu-header

Set the color of the left-side menu header.

String

e.g. "#00FFF"

navItemUpdatesChange the name of the "Updates" feature in the app navigation menu.

String

e.g. "Updates"

navItemAppZone

Change the name of the "AppZone" feature in the app navigation menu.

Note: BMC AppZone is a legacy feature that is available only if you have enabled and integrated it prior to the upgrade to MyIT 3.3.00

String

e.g. "AppZone"

hideReserveDo not allow the ability to reserve locations.

String

e.g. "YES", "NO"

hide-login-panelDo not show a background image for the login panel.e.g. "YES", "NO"
hide-logoDo not display the logo on login panel, connection screen, or the splash screen.e.g. "YES", "NO"
hideContactITDo not display the option to contact IT.e.g. "YES", "NO"

hideBMCPolicy

Do not display the BMC Policy link on the Settings page.e.g. "YES", "NO"
hideSplashShadow

Do not display top shadow on splash, connection, and login screens.

e.g. "YES", "NO"

Where to go next

Re-signing 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 MyIT for Apple iOS

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

Comments