[ ![Build Status] travis-image ] travis [ ![Release] release-image ] releases [ license-image ] license
Add analytics to your Java software with the Snowplow snowplow event tracker for Android snowplow. See also: [Snowplow Java Tracker] snowplow-java-tracker.
With this tracker you can collect event data from your Android-based applications, games or frameworks.
Assuming git, [Vagrant] vagrant-install and [VirtualBox] virtualbox-install installed:
host$ git clone https://github.com/snowplow/snowplow-android-tracker.git
host$ cd snowplow-android-tracker
host$ vagrant up && vagrant ssh
guest$ cd /vagrant
guest$ ./gradlew clean buildContinuing from the instructions above:
guest$ echo no | android create avd --force -n test -t android-19 --abi default/armeabi-v7a
guest$ emulator -avd test -no-skin -no-audio -no-window &
guest$ ./ci/wait_for_emulator ## Note: This line can take quite a few minutes to execute
guest$ adb shell input keyevent 82 &
guest$ ./gradlew connectedCheck You can now also setup a testing endpoint to send events to a local server using the combination of Ngrok and Mountebank.
guest$ cd /vagrant
guest$ chmod +x ./testing/setup.bash
guest$ ./testing/setup.bash ## Will launch Mountebank and Ngrok in the backgroundThen go to any browser in your host machine and type:
http://localhost:4040/- Ngrok Web Interfacehttp://localhost:2525/- Mountebank Web Interface
In the Ngrok interface take note of the tunnel URL, this is what you will use to send events.
| Technical Docs | Setup Guide | Roadmap | Contributing |
|---|---|---|---|
| ![i1] techdocs-image | ![i2] setup-image | ![i3] roadmap-image | ![i4] contributing-image |
| [Technical Docs] techdocs | [Setup Guide] setup | Roadmap roadmap | Contributing contributing |
The Snowplow Android Tracker is copyright 2014 Snowplow Analytics Ltd.
Licensed under the [Apache License, Version 2.0] license (the "License"); you may not use this software except in compliance with the License.
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.