Rebranding the Apple iOS client
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.
- Create new graphic files according to the specifications in icon graphics, splash screen graphics, and logo image graphic.
- 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: DigitalWorkplaceHome\DWP\IPA\download\utils directory, where DigitalWorkplaceHome is the installation directory. - Open the Resign.dmg file and run the ResigningUtility.app application.
- Select Digital Workplace application and click Next.
- Select a version and click Next.
- Create a new re-signing project or open an existing one.
If you are creating a new project, provide the following details:- Project Name—Give the re-signing project a name, for example, MyITResignDemo.
- 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.
- 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.
- Use the color picker tool to change the colors of the brand button, brand text, navigation bar, and navigation text.
- 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.
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.
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
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.
Where to go from here
Re-signing the Apple iOS client application for Enterprise distribution
Comments
Log in or register to comment.