Version 2021

Add Intro Animation for iOS

You can customize your application to display animated effects when it is launched. MicroStrategy provides two types of animation that each use an image you provide:

  • Glowing globe is a spinning transparent globe whose surface is covered with glowing strands of colors. The application uses the colors from the image you provide. 
  • Spinning logo is a spinning, rotating circular chain of repeated logos. The application uses the image you provide as the logo.

To add intro animation to your application:

  1. Open the MicroStrategyMobile project in Xcode. 

  2. Save the image file to use for the animation under MicroStrategyMobile -> Custom-> FinalBundle.bundle -> Contents -> Resources.

    Right-click Resources and choose Show in Finder. Add the image file to the Resources folder. 

  3. ClosedAdd MSTRCustomizations.plist to the MicroStrategyMobile -> Custom folder, if it has not already been added.

    MSTRCustomizations.plist is not included in the out-of-the-box MicroStrategyMobile Xcode project. It must be added manually as follows:

    1. Expand MicroStrategyMobile, right-click Custom, and choose Add Files to "MicroStrategyMobile". 
    2. Select MSTRCustomizations.plist.
    3. Under Add to targets, select the check box for MicroStrategyMobileIPad, MicroStrategyMobileIPhone, or both. 
    4. Click Add.
  4. Double-click MSTRCustomizations.plist. On the popup properties editor, right-click Root and choose Add Row. Add the following keys, which specify the image file and the type of animation to use. 

    Key Description Values

    IntroAnimationImage

     

    The existence of this parameter, together with IntroAnimationType, indicates that intro animation should be used. The image file specified as the value of this parameter provides the colors for glowing globe animation and the logo for spinning logo animation.

     

    For example, myIntroImage.png

    IntroAnimationType

     

    The existence of this parameter, together with IntroAnimationImage, indicates that intro animation should be used. The value of this parameter specifies the type animation that should be displayed.  

     

     

    Possible values: 1 or 2

     

    1: Glowing globe

    2:  Spinning logo

     

When the application is launched, it checks for the existence of the keys, IntroAnimationImage and IntroAnimationType. If it finds them, it tries to load the animation image specified by IntroAnimationImage from MicroStrategyMobile -> Custom-> FinalBundle.bundle -> Contents -> Resources. If it finds the image, it adds the type of animation specified by IntroAnimationType

See the Adding Intro Animation sample for an example of an application with intro animation.