Rebranding Smart IT on Apple iOS
This topic describes how to rebrand Smart IT on Apple Watch and Apple iOS devices. You must rebrand Smart IT by using the utility. Make sure that you meet all the pre-requisites provided at Preparing to re-sign and rebrand Smart IT on Apple iOS.
Before you begin
Your company must be a member of the Apple Enterprise Program to obtain the required development tools from the developer portal. See the following resources for more information:
Visit Details Apple Enterprise Program application - Only a company or an organization with a D-U-N-S number can apply for the enterprise program.
- An enterprise account allows you to distribute the rebranded application internally among your users.
- An organization account enables you to distribute applications only through the Apple store.
Apple Developer portal Provides development tools, and documentation needed to develop Apple iOS apps.
Managing your team Describes how to assign the team agent role to the user who is going to rebrand Smart IT. Accessing Member Center and iTunes Connect Provides information about the necessary certificates and provisioning profiles. Apple Developer Site Provides information about bundle identifiers. - Download BMC iOS Rebranding Utility Version 21.3.00 from BMC Electronic Product Distribution (EPD) portal.
Supported graphics for rebranding
This section lists all supported application icons, splash screen graphics, and Apple watch icons. For more information about required and recommended icons, see Apple iOS Human Interface Guidelines: Icon and Images Sizes in the Apple iOS developer documentation.
Important
The images given below are sample images. The exact resolution specifications are given in the table.
For rebranding Smart IT on Apple iOS the following Application Icon graphic is used:
The following table lists all supported application icon sizes.
Graphic Name | Resolution | Usage |
|---|---|---|
| AppIcon29x29@2x.png | 58x58 | iPhone - Settings |
| AppIcon40x40@2x.png | 80x80 | iPhone - Spotlight |
| AppIcon60x60@2x.png | 120x120 | iPhone App Icon |
| AppIcon60x60@3x.png | 180x180 | iPhone App Icon |
| AppIcon40x40.png | 40x40 | iPad Settings |
| AppIcon40x40~ipad.png | 40x40 | iPad Spotlight |
| AppIcon40x40@2x~ipad.png | 80x80 | iPad Spotlight |
| AppIcon76x76~ipad.png | 76x76 | iPad App Icon |
| AppIcon76x76@2x~ipad.png | 152x152 | iPad App Icon |
| AppIcon83.5x83.5@2x.png | 167x167 | iPad Pro Icon |
For rebranding Smart IT on Apple iOS the following Apple watch graphic is used:
The following table lists the details of all supported Apple watch graphics.
Graphic Name | Supported Devices | Resolution | Usage |
|---|---|---|---|
| Icon-24@2x.png | 38 mm Apple Watch | 48x48 | Notification Center |
| Icon-27_5@2x.png | 42 mm Apple Watch | 57x57 | Notification Center |
| Icon-29@2x.png | 38 mm and 42 Apple Watch | 58x58 | Companion Settings |
| Icon-29@3x.png | 38 mm and 42 Apple Watch | 87x87 | Companion Settings |
| Icon-40@2x.png | 38 mm and 42 Apple Watch | 80x80 | Home Screen |
| Icon-44@2x.png | 42 mm Apple Watch | 88x88 | Long Look |
| Icon-86@2x.png | 38 mm Apple Watch | 172x172 | Short Look |
| Icon-98@2x.png | 42 mm Apple Watch | 196x196 | Short Look |
The splash screen displays when the application launches. For rebranding Smart IT on Apple iOS the following splash screen graphics are used:
Landscape mode | Portrait mode |
|---|---|
Example: iPadLandscape.png
| Example: iPadPortrait@png
|
The following table lists the details of all supported splash screen graphics.
| Graphic name | Supported devices | Resolution |
|---|---|---|
LaunchImage-800-Portrait-736h@3x.png | iPhone 7 Plus, iPhone 6s Plus – 5.5 inch devices | 1242×2208 |
LaunchImage-800-667h@2x.png | iPhone 7, iPhone 6s, iPhone 6 – 4.7 inch devices | 750×1334 |
LaunchImage-700-568h@2x.png | iPhone SE, iPhone5, 5S, 5c - 4 inch devices | 640×1136 |
LaunchImage-700@2x.png | iPhone 4, iPhone 4S – 3.5 inch devices | 640×960 |
LaunchImage-700-Portrait~ipad.png | iPad2 (old model) | 768x1024 |
LaunchImage-700-Portrait@2x~ipad.png | 9.7-inch iPad Pro, iPad Air 2, iPad mini 4, iPad mini 2 | 1536x2048 |
Important
LaunchImage-700@2x.png and Portrait~ipadgraphics are required to support 4-inch size devices (iPhone 4, iPhone 4S) and iPad (2nd generation), respectively. These devices have 9.3.5 as last supported iOS version.
To rebrand Smart IT by using the utility
- Open the Resign.dmg file and run the ResigningUtility.app application.
- In the Application name field, select Smart IT, and click Next.
- Select an appropriate Smart IT version, and click Next.
- Create a new re-signing project, and provide the following details:
Project Name—Give the re-signing project a name, for example, SmartITResignDemo.
Project Location—Select a directory on your Mac machine for storing the project.
The utility creates a project fileforexample, SmartITResignDemo.resign and different sub-directories within the project directory.
Important
Re-signing and rebranding is done within the same project.
Go to the Rebranding tab, and rebrand various items:
- Use the color picker tool to change the color 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 the new images that you created.
The images are copied to the Rebranding subfolder within your project folder.
- Use the color picker tool to change the color of the brand button, brand text, navigation bar, and navigation text.
- Re-sign Smart IT on Apple iOS.
To replace the Smart IT APNS certificate with your APNS certificate
After you rebrand, you must replace the Smart IT APNS certificate with your APNS certificate.
If you are a BMC Helix user, you must first send the APNS certificate to BMC Support. Attach your APNS certificate to your request, and then submit it to BMC support. For more information, see
BMC Helix Subscriber Information
.
If you are an on-premises user, use these steps to replace the Smart IT APNS certificate:
- Use DBFileSync_utility to copy the APNS certificate to the relevant folder.
- Stop the Tomcat instance that executes the Smart IT server.
- In the Tomcat home folder, locate and open the external-conf folder.
- In the external-conf folder, create a certification subfolder.
- Place the .p12 file that contains the new APNS certificate that you created in the certification subfolder.
- Log in to the Oracle or Microsoft SQL database used for Smart IT.
- Go to the PUSH_NOTIFICATION_CERT table, and query for records.
- To change the iOS APNS certificate record:
- In the iOS_Cert field, replace the current value (the default value is GalileoAPNsProduction.p12) with the name of the .p12 file that contains your new APNS certificate.
- In the iOS_Password row, in plain text, replace the current password with the password of your .p12 file.
- Click Save.
Start the Tomcat instance.
Any notifications to iOS devices from your server (or tenant in multitenant environments) are sent using the new certificate.
Comments
Log in or register to comment.