abouttreesummaryrefslogcommitdiff
diff options
context:
space:
mode:
authorJules Aguillon2022-01-15 19:03:53 +0100
committerJules Aguillon2022-01-15 19:03:53 +0100
commit854eb431f3d5ab04a0362b65759e2321d1660051 (patch)
tree6e2381dbd626e2a983cbc5fe7c2ee9163b97afd1
parentd4eef00a8a07771fb9a8cf02f38c23854276e6cf (diff)
downloadunexpected-keyboard-854eb431f3d5ab04a0362b65759e2321d1660051.tar.gz
unexpected-keyboard-854eb431f3d5ab04a0362b65759e2321d1660051.zip
CONTRIBUTING: Document debug installation failure
-rw-r--r--CONTRIBUTING.md22
1 files changed, 22 insertions, 0 deletions
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index f3f44ae..7e16ccb 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -39,3 +39,25 @@ make installd
The debug version of the application won't be removed, both versions will stay
installed at the same time.
+
+## Debugging the application: INSTALL_FAILED_UPDATE_INCOMPATIBLE
+
+`make installd` can fail with the following error message:
+
+```
+adb: failed to install _build/juloo.keyboard2.debug.apk: Failure [INSTALL_FAILED_UPDATE_INCOMPATIBLE: Package juloo.keyboard2.debug signatures do not match previously installed version; ignoring!]
+make: *** [Makefile:20: installd] Error 1
+```
+
+The application can't be "updated" because the temporary certificate has been
+lost. The solution is to uninstall and install again:
+
+```sh
+adb uninstall juloo.keyboard2.debug
+```
+
+Then again:
+
+```sh
+make installd
+```