benjaminplee / sendaway

Android mock location app useful for automated testing

SendAway

Simple mock location app useful for testing other Android apps.

Allows other applications (e.g. instrumented tests like Espresso or UIAutomator) to broadcast an intent to change the mock location without requiring the application under test (or the test-app) to have mock location permissions or be set as the mock-location app for API 23+.

Getting Started

Work in progress

Installing

Work in progress

Running the tests

Work in progress

Built With

Work in progress

Contributing

Work in progress

Versioning

The Squatter project uses SemVer for versioning and tracks changes in the CHANGELOG.md file. Versions available can also be found as Git tags.

Authors

• Benjamin Lee - benjaminplee

License

This project is licensed under the MIT License - see the LICENSE.txt file for details

Acknowledgments

• Application icon adapted from "Earth" by sagit milshtein from the Noun Project

sendaway's Issues

Setup CI

Setup open CI running unit and connected tests; add to readme

App crashes if permissions are not setup

On API 23+, if app is not given permission to location services and setup as mock location app (or on <23 if mock locations are not enabled in dev console), application crashes.

Application should prompt user for permissions, if not given, or guide user to fix the issue without crashing.

Location mocking is still enabled if app is force closed

Currently the app starts mock location services when the application is launched and stops when it is gracefully shut down.

On/Off of mock location should not be tied to open or running application, but the app should give user the ability to start/stop mocking and show current status.

Ideally, status of mocking-locations should be visible to user without running the app; e.g. via notification and/or icon.

Add Released APK to Releases Page

As a developer wanting to use sendaway, I'd like to have a hosted APK available, so I don't have to build it from source with an Android platform I may not have installed.