From 0743bca58961582078f4e8199fe9a6fa044036eb Mon Sep 17 00:00:00 2001
From: Robert Ly <robertly@google.com>
Date: Wed, 10 Sep 2014 10:50:46 -0700
Subject: [PATCH] docs: add 64k method limit note

Change-Id: I6590fc996331c1f2024276d338c4035f2cb0f18d
---
 docs/html/tools/building/index.jd | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/docs/html/tools/building/index.jd b/docs/html/tools/building/index.jd
index c64942ff7d254..c1f301943ab83 100644
--- a/docs/html/tools/building/index.jd
+++ b/docs/html/tools/building/index.jd
@@ -79,3 +79,14 @@ page.title=Building and Running
     running on a device.</li>
   </ul>
 
+<p class="note"><b>Note:</b> Apps are limited to a 64K method reference limit. If your app reaches
+this limit, the build process outputs the following error message:
+
+<pre>Unable to execute dex: method ID not in [0, 0xffff]: 65536.</pre>
+
+To avoid this, you can
+<a href="http://android-developers.blogspot.com.es/2011/07/custom-class-loading-in-dalvik.html">load
+secondary dex files at runtime</a> and use
+<a href="http://developer.android.com/tools/help/proguard.html">ProGuard</a> to strip out unnecessary
+class references (Proguard only works when building in release mode).
+</p>
\ No newline at end of file