Upload or Edit a Mobile App

Overview

ObservePoint offers an easy setup process for mobile apps with the ability to upload different app files and test with a wide testbed of emulator options. These include several devices and operating system versions for both iOS and Android devices. Uploading an app allows the user to create journeys that monitor important workflow within an app and monitor tag data.

Uploading a mobile app is the first step in mobile app testing. Once uploaded, all users who have permissions to the folder where the app resides can access the app and create journeys to validate the analytics integration.

Step-by-Step

To upload an app:

Click Create New > Mobile Apps in the top left nav bar

Select a folder

Give the app a name. The best practice is to include the version of the app and/or the OS in the name if you plan on uploading more than one version of the same app.

Drag and drop or browse to the app file you want to upload.

Check the notifications box if you want to receive email notices for all journeys on this app. Normally you would leave this blank in favor of selecting the notifications option inside the rules you create for the journey.

Click Upload to securely transfer a copy of the app to the ObservePoint server.

Each account has a set limit of apps that can be uploaded, defined by the contract.

Preparing iOS App Files

Your .app bundle must represent an iOS Simulator build of your app. A simulator build can be run in the iOS Simulator via Xcode. This is different than an IPA file, which is compiled for ARM architecture CPUs and can only be run on physical iOS devices.

One way to get the iOS Simulator build is to run your app in an iOS Simulator, and then to find the file that is automatically generated. After running in the iOS Simulator via Xcode, look in:~/Library/Developer/Xcode/DerivedData/<project-name>/Build/Products/Debug-iphonesimulator/

You may also generate the iOS Simulator build of your app by building it directly via the command line using xcodebuild.

If you have a .xcodeproj file, you may run:xcodebuild -sdk iphonesimulator

If you have a .xcworkspace file, you may run:xcodebuild -sdk iphonesimulator -workspace <your_workspace_name>.xcworkspace/ -scheme <your-scheme> -configuration Debug.

In order to get the name of your Scheme, you may run:

xcodebuild -list -workspace <your_workspace_name>.xcworkspace

Once the build command completes successfully, you may then zip the .app bundle found in:build/Debug-iphonesimulator/

Preparing Android App Files

Build your app in either Android Studio or by running the command./gradlew assembleDebug.

Then look in your project directory:<project-name>/<app-module-name>/build/outputs/apk/

If you are having trouble running your uploaded Android app in AppAssurance, we recommend trying to run the same APK on a physical Android device. If that works, you can also try running the APK in the Android x86 emulators provided by Google.