This documentation supports the 1.6 version of Remedy with Smart IT.

To view the latest version, select the version from the Product version menu.

Rebranding Smart IT on Apple iOS

This topic was edited by a BMC Contributor and has not been approved.  More information.

This topic describes how to rebrand Smart IT on Apple Watch and Apple iOS devices. Irrespective of whether you rebrand manually, or by using the utility, you must ensure 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:

VisitDetails
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 throughtheApplestore.
Apple Developer portal

Provides development tools, and documentation needed to develop Apple iOS apps.

Managing your teamDescribes 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 SiteProvides information about the bundle IDs.

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.

Note

The images given below are sample images. The exact resolution specifications are given in the table.


 Application icon graphics

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.png58x58

iPhone - Settings

AppIcon40x40@2x.png80x80iPhone - Spotlight
AppIcon60x60@2x.png120x120iPhone App Icon
AppIcon60x60@3x.png180x180iPhone App Icon
AppIcon40x40.png40x40iPad Settings
AppIcon40x40~ipad.png40x40iPad Spotlight
AppIcon40x40@2x~ipad.png80x80iPad Spotlight
AppIcon76x76~ipad.png76x76iPad App Icon
AppIcon76x76@2x~ipad.png152x152iPad App Icon
AppIcon83.5x83.5@2x.png167x167iPad Pro Icon
 Apple watch graphics

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.png38 mm Apple Watch48x48

Notification Center

Icon-27_5@2x.png42 mm Apple Watch57x57Notification Center
Icon-29@2x.png38 mm and 42 Apple Watch58x58Companion Settings
Icon-29@3x.png38 mm and 42 Apple Watch87x87Companion Settings
Icon-40@2x.png38 mm and 42 Apple Watch80x80Home Screen
Icon-44@2x.png42 mm Apple Watch88x88Long Look
Icon-86@2x.png38 mm Apple Watch172x172Short Look
Icon-98@2x.png42 mm Apple Watch196x196Short Look
 Splash screen graphics

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 nameSupported devices

Resolution

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

iPhone 7 Plus, iPhone 6s Plus – 5.5 inch devices1242×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 devices640×1136

LaunchImage-700@2x.png

iPhone 4, iPhone 4S – 3.5 inch devices640×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 21536x2048

Note

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

Download or copy the iOS re-signing and rebranding utility on your Mac computer. Depending on the version of Smart IT that you are using, the utility is available at the following locations:

  • Version 1.6 or later—MYIT_HOME\Smart_IT_MyIT\IPA\download\utils directory, where MYIT_HOME is the installation directory.
  • Version 1.4, 1.5, and 1.5.01—BMC Communities.

To rebrand, follow these steps:

  1. Open the Resign.dmg file and run the ResigningUtility.app application.
  2. In the Application name field, select Smart IT, and click Next.
  3. Select an appropriate Smart IT version, and click Next.
  4. 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.

    Note

    Re-signingandrebrandingisdonewithinthesameproject.

  5. 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. 
  6. Re-sign Smart IT on Apple iOS.

To rebrand Smart IT manually

You can manually rebrand Smart IT on iOS.

  1. Edit the supported splash screen, login screen, and connection background files.

  2. Place the provisioning profiles that you created in the /path/SmartIT-ResignDir folder, and rename the files to SmartIT.mobileprovision, SmartITWatch.mobileprovision, and SmartITWatchExtension.mobileprovision.
  3. Set the bundle IDs to match the application ID set on the Apple Development portal (for example, com.companyName.SmartIT.watch, com.companyName.SmartIT.watch.extension, and com.companyName.SmartIT).

    cd /path/SmartIT-ResignDir
     
    /usr/libexec/PlistBuddy -c "Set CFBundleIdentifier com.companyName.SmartIT"
    ./Payload/Galileo.app/Info.plist
    
    /usr/libexec/PlistBuddy -c "Set CFBundleIdentifier com.companyName.SmartIT.watch" 
    ./Payload/Galileo.app/Watch/Watch.app/Info.plist
    
    /usr/libexec/PlistBuddy -c "Set CFBundleIdentifier com.companyName.SmartIT.watch.extension"
    ./Payload/Galileo.app/Watch/Watch.app/PlugIns/Watch\
    Extension.appex/Info.plist
     
    /usr/libexec/PlistBuddy -c "Set WKCompanionAppBundleIdentifier com.companyName.SmartIT" 
    ./Payload/Galileo.app/Watch/Watch.app/Info.plist 
     
    /usr/libexec/PlistBuddy -c "Set NSExtension:NSExtensionAttributes:WKAppBundleIdentifier com.companyName.SmartIT.watch" ./Payload/Galileo.app/Watch/Watch.app/PlugIns/Watch\ Extension.appex/Info.plist

    Use the code shown in this table.

    ToUse the code
    Set the application name that is displayed on the iOS devices. APPLICATIONNAME—The name of your application. For example, Smart IT or Acme Smart IT.
    /usr/libexec/PlistBuddy -c "Set CFBundleDisplayName APPLICATIONNAME" 
    ./Payload/Galileo.app/Info.plist
    Set the long application name that appears on the splash screen. LONGAPPNAMEThe long name of your application. For example, Remedy with Smart IT.
    /usr/libexec/PlistBuddy -c "Set galileo-full-app-name LONGAPPNAME" 
    ./Payload/Galileo.app/Info.plist
    Set the Apple Watch name.
    WATCHNAMEThe title that is displayed on the Apple Watch application. For example, Smart IT.
    /usr/libexec/PlistBuddy -c "Set CFBundleDisplayName WATCHNAME" 
    ./Payload/Galileo.app/Watch/Watch.app/Info.plist
     
    /usr/libexec/PlistBuddy -c "Set CFBundleDisplayName WATCHNAME" 
    ./Payload/Galileo.app/Watch/Watch.app/PlugIns/Watch\ Extension.appex/Info.plist
    Set the default Smart IT server to your Smart IT server.
    SERVERYour Smart IT server name. For example, SmartIT.acme.com.
    /usr/libexec/PlistBuddy -c "Set galileo-server SERVER" ./Payload/Galileo.app/Info.plist
    Set the default port for your Smart IT server.
    PORT—The TCP port for clients to access the server. For example, 9000 or 8888.
    /usr/libexec/PlistBuddy -c "Set galileo-port PORT" ./Payload/Galileo.app/Info.plist

    Set the default Internet protocol.
    PROTOCOL—Set either HTTP or HTTPS.

    Note

    If you do not set a value for galileo-http-schema, the client first tries to connect by using HTTPS until a timeout limit is reached. It then tries HTTP. If you are using HTTP, to avoid the timeout delay, it is recommended that you set this value to HTTPS.

    /usr/libexec/PlistBuddy -c "Set galileo-http-schema PROTOCOL" ./Payload/Galileo.app/Info.plist
    Set the color of the button on the login and connection page.
    /usr/libexec/PlistBuddy -c "Set galileo-custom-brand-button-color-hex 0xff0000" ./Payload/Galileo.app/Info.plist
    Set the color of the text of the application name on the login and connection page.
    /usr/libexec/PlistBuddy -c "Set galileo-custom-brand-text-color-hex 0xff0000" ./Payload/Galileo.app/Info.plist
    Remove the BMC logo on the login and connection page, set the value to YES.
    /usr/libexec/PlistBuddy -c "Set galileo-custom-remove-bmc-logo YES" ./Payload/Galileo.app/Info.plist
    Set the color of the top level navigation bar background, set the hex color value.
    /usr/libexec/PlistBuddy -c "Set galileo-custom-navigation-bar-color-hex 0xff0000" ./Payload/Galileo.app/Info.plist
    Set the color of the top level navigation bar text, set the hex color value.
    /usr/libexec/PlistBuddy -c "Set galileo-custom-navigation-text-color-hex 0xff0000" ./Payload/Galileo.app/Info.plist
    Remove the white background on the login and connection page, set the value to YES.
    /usr/libexec/PlistBuddy -c "Set galileo-custom-remove-login-white-background YES" ./Payload/Galileo.app/Info.plist
    Remove the application name (full-app-name) on the login and connection page, set the value to YES.
    /usr/libexec/PlistBuddy -c "Set galileo-custom-remove-login-full-app-name YES" ./Payload/Galileo.app/Info.plist

    Login screen rebranding

    Navigation rebranding

  4. Replace the mobile provision file.

    cp "SmartITWatchExtension.mobileprovision" 
    "./Payload/Galileo.app/Watch/Watch.app/PlugIns/Watch Extension.appex/embedded.mobileprovision"
    
    cp "SmartITWatch.mobileprovision"
    "./Payload/Galileo.app/Watch/Watch.app/embedded.mobileprovision"
    
    cp "SmartIT.mobileprovision" "./Payload/Galileo.app/embedded.mobileprovision"
  5. Remove the BMC code signature.

    rm -r "./Payload/Galileo.app/Watch/Watch.app/PlugIns/Watch Extension.appex/_CodeSignature/"
    
    rm -r "./Payload/Galileo.app/Watch/Watch.app/_CodeSignature"
    
    rm -r "./Payload/Galileo.app/_CodeSignature"
  6. Re-sign the IPA using the name of your company Apple iOS Distribution certificate installed on this machine in place of "iPhone Distribution: BMC Software, Inc.".

    /usr/bin/codesign -f -s "iPhone Distribution: BMC Software, Inc." --entitlements
    "./SmartITWatchExtension.entitlements"
    "./Payload/Galileo.app/Watch/Watch.app/PlugIns/Watch Extension.appex"
    
    /usr/bin/codesign -f -s "iPhone Distribution: BMC Software, Inc." --entitlements
    "./SmartITWatch.entitlements" "./Payload/Galileo.app/Watch/Watch.app"
    
    /usr/bin/codesign -f -s "iPhone Distribution: BMC Software, Inc." --entitlements
    "./SmartIT.entitlements" "./Payload/Galileo.app"
  7. Create the .ipa zip file.

    zip -qr "SmartIT-rebranded.ipa" Payload

    You must provide this new .ipa file when you deploy Smart IT to your users.

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.

  1. Log in to the server that hosts the Smart IT server.
  2. Stop the Tomcat instance that executes the Smart IT server.
  3. In the Tomcat home folder, locate and open the external-conf folder.
  4. In the external-conf folder, create a certification subfolder.
  5. Place the .p12 file that contains the new APNS certificate that you created in the certification subfolder.
  6. Log in to the Oracle or Microsoft SQL database used for Smart IT.
  7. Go to the PUSH_NOTIFICATION_CERT table, and query for records.
  8. To change the iOS APNS certificate record:
    1. 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.
    2. In the iOS_Password row, in plain text, replace the current password with the password of your .p12 file.
  9. Click Save.
  10. Start the Tomcat instance.
    Any notifications to iOS devices from your server (ortenantinmultitenant environments) are sent using the new certificate.

Where to go from here

Deploying Smart IT to your users

Re-signing Smart IT on Apple iOS

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

Comments