From 2765e003a5ed5923345dc6540ed5d57874207a14 Mon Sep 17 00:00:00 2001 From: Alexander Taylor Date: Tue, 4 Jun 2019 22:37:37 +0100 Subject: [PATCH] Added readme for on device unit tests --- testapps/on_device_unit_tests/README.rst | 31 ++++++++++++++++++++++++ 1 file changed, 31 insertions(+) create mode 100644 testapps/on_device_unit_tests/README.rst diff --git a/testapps/on_device_unit_tests/README.rst b/testapps/on_device_unit_tests/README.rst new file mode 100644 index 0000000000..1415fbb6a4 --- /dev/null +++ b/testapps/on_device_unit_tests/README.rst @@ -0,0 +1,31 @@ +On device unit tests +==================== + +This test app runs a set of unit tests, to help confirm that the +python-for-android build is actually working properly. + +The main tests are for the recipes built in the apk. Each module (or +other tool) is at least imported and subject to some basic check. + +This app is experimental, it doesn't yet support things like testing +only the requirements you ask for (so if you build with requirements +other than those specified, the tests may fail). It also has no gui +yet, the results must be checked via logcat. + +Building the app +================ + +This app should be built using buildozer, which it also serves as a +test for:: + + $ buildozer android debug + +Install on an Android device:: + + $ adb install -r adb install -r bin/p4aunittests-0.1-debug.apk + # or + $ buildozer android deploy + +Run the app and check in logcat that all the tests pass:: + + $ adb logcat | grep python # or look up the adb syntax for this