Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Moved the troubleshooting section into an excerpt macro

...

OptionDescription
-infoplistfile <INFO_PLIST_FILE>Xcode project's Info.plist file with path (iOS only). If this parameter is not included, the utility will try to automatically locate it.
-customrulesfile <CUSTOM_RULES_FILE>Android project's custom_rules.xml file with path (Android only). If this parameter is not included, the utility will try to automatically locate it.
-launchurl <APP_NAME>://<PARAMETERS>Launch URL to start the app (Android only). Avoid spaces and underscores. If this parameter is not included, the utility will try to automatically locate it. Example: "my-app://launch"
-appobjectname <APP_OBJECT_NAME> Name of the Mobile App object created in the Appcelerator Test server. By default, the name is <APP_NAME>_<APP_GUID>.
-donotcreateapp Do not create a Mobile App object in the Appcelerator Test server.
-universalapp Create a Mobile App object compatible with both iOS and Android.
-overwriteapp Replace the Mobile App object if it already exists.
-previewmode Run in Preview mode to examine the console output for these parameters. If this option is not included, then the utility runs in full mode and the project is changed.
-proxyserver <PROXY_SERVER> HTTP proxy server name.
-proxyport <PROXY_PORT> HTTP proxy port number.
-proxyusername <PROXY_USERNAME> HTTP proxy user name (if any).
-proxypassword <PROXY_PASSWORD>HTTP proxy password (if any).
-version Print Utility Version.
-reporterrors Utility will automatically report errors to Appcelerator Test along with any relevant files.
-donotreporterrors Utility will not report any errors to Appcelerator Test.
-addheadersearchpath Add Appcelerator Test header files to "Header Search Paths" build setting (iOS only).
-useforceloadlinkerflag Add -force_load flag to "Other Linker Flags" build setting (iOS only).
-removelibraryfrombuildphase Prevents the library to be added to "Link Binary With Libraries" step of Build Phases (iOS only).

Troubleshooting

Excerpt

Application does not Specify a CFBundleExecutable

This error can occur when installing an iOS app bundle that has been dynamically instrumented for testing after compilation. 

Image Modified

As a workaround you can "statically" instrument the Xcode project, compile the project, and then install app bundle to the device. For steps on statically instrumenting an Xcode project, see the iOS Project

  example

   example.

Resource Not Found

If you receive the following error:

Code Block
com.appcelerator.mattwrapper.rest.RESTException: Error executing GET request! Received error code: 404
{"success":false,"description":"Resource Not Found","code":404}

Make sure

the

the appkey

parameter

 parameter is correct.

Fails with "java.lang.OutOfMemoryError: Java heap space" when targeting an APK file

 Add the -Xmx2g

option

 option to the Java command to increase the JVM heap size.

Code Block
java -Xmx2g -jar appcelerator-test.jar -apk ~/Documents/Eclipse_Workspace/SampleProject/SampleProject.apk -androidsdk ~/opts/android-sdk/ -appkey "11111111-2222-3333-4444-555555555555" -dashboardurl https://platform.appcelerator.com -username user@appcelerator.com -password secret