This is an archive related to a previous version of Esri Maps for MicroStrategy. If you need the current version go to http://doc.arcgis.com/en/maps-for-microstrategy/.

Compile the mobile app

Before you can deploy the Esri Maps for MicroStrategy Mobile app, you must compile it. Before completing the following steps, ensure that you have satisfied all the Developer prerequisites listed in Supported environments > Esri Maps for MicroStrategy Mobile.

Extract and copy the MicroStrategy Mobile SDK contents

Begin by extracting the contents of the MicroStrategy Mobile SDK from the DMG image on your local hard drive.

  1. Unzip <MicroStrategy_Mobile_client_version>_iOS_SDK_dmg.zip.
  2. Double-click MicroStrategy Mobile SDK.dmg.
  3. Click Agree. MicroStrategy Mobile SDK appears on the desktop.
  4. Copy all contents of the image to your installation location: <EM4MMInstall>.
  5. Copy the em4mm directory from the ISO image to the <EM4MMInstall> directory.

Open the MicroStrategy Mobile project with Xcode

  1. Browse to the <EM4MMInstall> directory.
  2. In Xcode, open MicroStrategyMobile.xcodeproj in the MicroStrategyMobile folder.

Set the build identifier and choose the team

Update your identity information build identifier, and choose the team creating the build.

  1. Choose the MicroStrategyMobile project in the Xcode Project Navigator.
  2. Remove the MicroStrategyMobileIphone target as follows:
    1. In the Targets area, right-click MicroStrategyMobileIphone and choose Delete.
    2. In the Xcode menu, choose Product > Scheme > Manage Schemes.
    3. Choose the MicroStrategyMobileIphone scheme and click the Delete button (–) to delete this scheme.
    4. Click OK to return to the targets.
  3. Choose the MicroStrategyMobileIpad target.
  4. On the General tab, specify the Bundle Identifier for the app. See the Apple web site for specific instructions.
  5. Choose the team with correct provisions to build or deploy your app.

Add the Esri Maps for MicroStrategy config.xml file to the project

To add the config.xml file, do the following:

  1. Copy the config.xml file from the <EM4MMInstall>\em4mm directory to the MicroStrategy Mobile project directory, <EM4MMInstall>\MicroStrategyMobile.
  2. From the Xcode Project Navigator, right-click the project and choose Add Files to “MicroStrategyMobile”.
  3. Choose config.xml on the Open File dialog box.
  4. On the Open File dialog box, under Add to targets, check the MicroStrategyMobileIPad check boxes.
  5. Click the Add button.

Copy and configure the vis.plist file

Copy the existing vis.plist file from the Resources directory in the MicroStrategy Mobile SDK for iOS, paste the vis.plist file into the Custom > Resources directory, and then add the Esri Maps for MicroStrategy <key> and <string> to the vis.plist file.

  1. From the Xcode Project Navigator, choose Resources > FinalBundle.bundle > Contents > Resources > vis.plist.
  2. Right-click vis.plist and choose Show in Finder.

    The Finder window will open with the vis.plist file selected.

  3. Right-click vis.plist and choose Copy.
  4. Return to the Xcode Project Navigator, choose Custom > FinalBundle.bundle > Contents > Resources.
  5. Right-click Resources and choose Show in Finder.
  6. Open the Resources directory in the Finder window and paste the vis.plist file in the Finder window.
  7. Return to the Xcode Project Navigator, choose Custom > FinalBundle.bundle > Contents > Resources.
  8. Right-click vis.plist and click Open As > Source Code.
  9. In the right pane, after the <dict> tag, add the following XML code:
    <key>em4mstr</key>
    <string>Em4MstrWidgetViewer</string>

Add framework files to the project

Add the Em4Mstr.framework file and the dependency frameworks to the project.

  1. Choose the project file in Xcode Project Navigator.
  2. In the window on the right, browse to and choose the MicroStrategyMobileIPad target.
  3. Click the Build Phases tab.
  4. Expand Link Binary With Libraries.
  5. Scroll down and click the + button.
  6. To add the Em4Mstr.framework file to the project, do the following:
    1. On the dialog box that opens, click Add Other.
    2. Browse to the <EM4MMInstall>\em4mm folder and choose Em4Mstr.framework.
    3. Click Open.

Add the Em4Mstr.bundle to the project

  1. Choose the MicroStrategyMobile project in Xcode Project Navigator.
  2. In the window on the right, choose the MicroStrategyMobileIPad target.
  3. Click the Build Phases tab.
  4. Expand Copy Bundle Resources.
  5. Scroll down and click the + button.
  6. On the dialog box that opens, click Add Other.
  7. Browse to <EM4MMInstall>\em4mm \Em4Mstr.framework\Resources and choose Em4Mstr.bundle.
  8. Click Open and complete the default settings.

Verify framework search paths

Verifying framework search paths will prevent linker errors in Xcode.

  1. Go to the Build settings tab, and scroll down to Search Paths.
  2. Expand the Search Paths section.
  3. Select the Framework Search Path setting.
  4. Double-click the Framework Search Path value and ensure that direct paths to the Library folder and the em4mm folder are reflected in the value.
  5. If direct paths are not listed, then add the following direct paths to the framework search path:
    • /<EM4MMInstall>/em4mm
    • /<EM4MMInstall>/Library
  6. Here is an example of an updated framework search path: $(inherited) "$(SRCROOT)/../Library" /Users/usr9999/Desktop/New\ Folder/em4mInstall/em4mm /Users/usr999/Desktop/New\ Folder/em4mInstall/Library

Choose the active scheme and build the project

To finish compiling the mobile app, set the active scheme to MicroStrategyMobileIpad, and build the project.

  1. From the Product drop-down menu, choose Scheme and check MicroStrategyMobileIPad.
  2. From the Product drop-down menu, choose Build.