Limited support

 

This version of the product is in limited support. However, the documentation is available for your convenience. You will not be able to leave comments. Click here to view the documentation for the current version.

Rebranding the Apple iOS client application

The following process describes how to rebrand the BMC Digital Workplace  mobile application 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 Digital Workplace , 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 rebranding procedure described in this uses the iOS re-signing and re-branding utility. This utility automates the task of rebranding the BMC Digital Workplace  mobile application with your custom images and colors.

Notes

  • You must have Mac OS X version 10.11 or later and Xcode 9.4.1 (9F2000) or later to use the iOS re-signing and rebranding utility.
  • To successfully complete rebranding and re-signing the Apple iOS client, BMC recommends following the steps exactly as described in this topic.

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 in the Apple developer documentation 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 the Apple iOS client application for Enterprise distribution 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

This procedure provides instructions to rebrand the BMC Digital Workplace  mobile application by using the iOS re-signing and rebranding utility. For the manual procedure, see To rebrand the Apple iOS client manually.

  1. Create new graphic files according to the specifications in icon graphics, splash screen graphics, and logo image graphic.
  2. Download or copy the iOS re-signing and rebranding utility Resign.dmg file to your Mac computer.
    The utility is available at the following locations: DigitalWorkplace_HOME\Smart_IT_MyIT\IPA\download\utils directory, where DigitalWorkplace_HOME is the installation directory.
  3. Open the Resign.dmg file and run the ResigningUtility.app application.
  4. Select Digital Workplace application and click Next.
  5. Select a version and click Next.
  6. Create a new re-signing project or open an existing one.
    If you are creating a new project, provide the following details:
    1. Project Name—Give the re-signing project a name, for example, MyITResignDemo.
    2. Project Location—Select a directory location for storing the project.

    The utility creates a project file, for example DigitalResignDemo.resign and different subdirectories within the project directory.

    Note

    The re-signing and rebranding is done within the same project.

  7. Go to the Rebranding tab and perform the rebranding of various items as follows:
    • Use the color picker tool to change the colors of the brand button, brand text, navigation bar, and navigation text.
      You can also enter the RGB code or hexadecimal value of a color.
    • Choose whether you want to remove the BMC Logo, white login background, and full app name.
    • Change the default images by dragging and dropping new images that you created in step 1.
    The images are copied to the Rebranding subfolder within your project folder. 
  8. Re-sign the Apple iOS client application.

Icon graphics

This section lists all supported application icon sizes and their usage. 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

This section lists all supported splash screen sizes. The splash screen is displayed 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.

Note

Graphics are not shown in actual size.


 Graphic

 Size in pixels

File name

640 x 960LaunchImage-700@2x.png

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

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

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

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

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

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

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 resource is optional. 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.

750x120 pixels maximum

(starting from version 3.3.02)

app-logo-image.png

To rebrand the Apple iOS client manually

  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 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
    
  5. Re-sign the Apple iOS client application.

Flags for rebranding

The following flags are built into the application for rebranding.

 FlagDescription
appNameThis short name of the app is displayed under the icon and throughout the app, except where the full name is displayed.
myit-full-app-nameThe full name of the app is displayed when the app is starting up, in the connection, login, and sync screens.
serverThe app will auto-connect to this server.
serverportWhen the app auto-connects to the server, it connects to this port.
usernameThe app will auto-login with this user name.
passwordThe app will auto-login with this password.
themecolorThis color applies to several UI elements throughout the app such as the navigation bar, menu and so on.
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

theme-text-color

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

theme-menu-header

Set the color of the left-side menu header.

navItemUpdatesChange the name of the "Updates" feature in the app navigation menu.
hideReserveDo not allow the ability to reserve locations.
hide-login-panelDo not show a background image for the login panel.
hide-logoDo not display the logo on login panel, connection screen, or the splash screen.
hideContactITDo not display the option to contact IT.

hideBMCPolicy

Do not display the BMC Policy link on the Settings page.
hideSplashShadow

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

Where to go from here

Re-signing the Apple iOS client application for Enterprise distribution

This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

Comments