App Uploads

Building your app for the simulator

To run tests on the simulator you need to build your app for the simulator. Standard iOS build output as .ipa file, what we need it a .app file (that actually is a folder)

To build your app for the simulator you can use the following command:

Build for simulator

xcodebuild -workspace MyApp.xcproject \
  -scheme MyApp \
  -configuration Debug \
  -sdk iphonesimulator \
  -derivedDataPath build \
  build

# The .app bundle lands at:
# build/Build/Products/Debug-iphonesimulator/MyApp.app

# Zip it for upload
cd build/Build/Products/Debug-iphonesimulator
zip -r MyApp.app.zip MyApp.app
# or using tar
tar -czf MyApp.app.tar.gz MyApp.app

Uploading via the dashboard

To upload an app, go to your project and click on the Mobile tab. Then click on the Browse Files button. Select the .app.zip or .app.tar.gz file you built. Upload app via dashboard

Uploading via the API

You can upload apps programmatically using the REST API

curl -X POST https://tester.army/api/v1/projects/{projectId}/mobile \
  -H "Authorization: Bearer <YOUR API KEY>" \
  -F "file=@<PATH TO YOUR APP BUILD ARCHIVE>"

To auto-delete the upload after a set time (useful for CI builds), pass removeAfter in seconds:

curl -X POST https://tester.army/api/v1/projects/{projectId}/mobile \
  -H "Authorization: Bearer <YOUR API KEY>" \
  -F "file=@<PATH TO YOUR APP BUILD ARCHIVE>" \
  -F "removeAfter=3600"

Get your key from the TesterArmy dashboard under Team Settings → API Keys.

See the Mobile Apps API reference for the full response schema, listing, and deletion endpoints.

Storage limits

Each project has a storage limit of 2GB. You can upload multiple apps as long as you stay within the limit. Single upload can be up to 2GB.

App metadata

When you upload an app, we extract the following metadata from the app:

Bundle ID
App Version
Build Version
Icon