App tester is an app built with all plugins known to vigour which presents the user with an input box allowing him to be redirected wherever. It's intended use is to help with app development.
- Install the app on your device
- Enter a URL (starting with
http(s)://) in the input box
- Tap the button
- Get redirected to that URL
- The app downloaded from that URL can expect the latest versions of all vigour plugins to be available.
Debugging requires the device to be plugged into your computer. Simulators and emulators should also work the same way.
- Open Google Chrome
- Navigate to
- The page opened in app-tester should be listed here, click on it to open it in the dev tools
- To get the device (native) logs, use the Android Debugging Bridge (adb):
adb logcat(more info)
- Open Safari
- In the
developmenu, find the device running the app-tester. In that submenu, you should find the page currently loaded.
- Click on it to open it in the Safari dev tools
- TODO find out how to get access to device (native) logs
When the native code for a plugin changes, a new version of the app-tester has to be built and published to hockeyapp.
Building is as easy as
npm run android or
npm run ios. Of course you will need to have the tools for these platforms installed:
- Android SDKs
- Android debugging bridge (adb)
ANDROID_HOMEenvironment variable must point to the location of the Android SDK installation. In my case, I have:
$ echo $ANDROID_HOME /Users/shawn/android-sdks/
- Xcode command line tools
Publishing to hockeyapp
To publish an app to hockey, you will of course need the credentials to the hockey account, which you can find here
Building for Android creates a
.apk file. Simply upload this file to hockeyapp to allow others to install it.
Building for iOS creates an xcode project and workspace. If you open the workspace in xcode, you can then archive the project and export it as a
.ipa file which can be uploaded to hockey. The archiving and exporting parts require that you have some certificates and provisioning profiles in your keychain. Make sure you make a development build, otherwise the app-tester will lose it's debugging capabilities.