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.


Related topics

Rebranding-the-Universal-Client

Deploying-clients

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.

List of all supported application icon sizes


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.

List of all supported splash screen sizes

Note

Graphics are not shown in actual size.


 Graphic

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

 

new logo.png

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

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

Manual method to rebrand the mobile application
  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.

Where to go from here

Re-signing-the-Apple-iOS-client-application-for-Enterprise-distribution