Document the workaround for make snod on emulator builds
Change-Id: Ibcb05d8c3c78d68ae4c3443283ac1d859c8c4878
diff --git a/src/source/known-issues.md b/src/source/known-issues.md
index 4424438..4b4fe9f 100644
--- a/src/source/known-issues.md
+++ b/src/source/known-issues.md
@@ -69,3 +69,18 @@
**Fix**: While there's no general solution, using python 2.7
and explicitly using `repo sync -j1` have been reported to
improve the situation for some users.
+
+## `make snod` and emulator builds. ##
+
+**Symptom**: When using `make snod` (make system no dependencies)
+on emulator builds, the resulting build doesn't work.
+
+**Cause**: All emulator builds now run Dex optimization at build
+time by default, which requires to follow all dependencies to
+re-optimize the applications each time the framework changes.
+
+**Fix**: Locally disable Dex optimizations with
+`export WITH_DEXPREOPT=false`, delete the existing optimized
+versions with `make installclean` and run a full build to
+re-generate non-optimized versions. After that, `make snod`
+will work.
