|
| 1 | +Disabling Android Studio Instant Run :bdg-warning:`Legacy` :bdg-success:`AS` |
| 2 | +============================================================================ |
| 3 | + |
| 4 | +.. attention:: |
| 5 | + *Instant Run* was removed in Android Studio version 3.5, and |
| 6 | + is no longer an issue for versions of Android Studio that are |
| 7 | + Android Studio 3.5 or newer. However, this article remains for |
| 8 | + those using *FIRST* Tech Challenge Software Development Kit |
| 9 | + (SDK) v7.1 and older with previous versions of Android Studio. |
| 10 | + |
| 11 | +Introduction |
| 12 | +~~~~~~~~~~~~ |
| 13 | + |
| 14 | +If you are an Android Studio user, one of **the most important steps to |
| 15 | +take** is to disable Android Studio Instant Run. Instant Run is a |
| 16 | +feature that is designed to streamline the development process by |
| 17 | +reducing the time to apply code changes to your app. Unfortunately, |
| 18 | +Instant Run is limited in function and when used with the *FIRST* Tech |
| 19 | +Challenge Android Studio project folder, can cause **severe** and |
| 20 | +**difficult-to-troubleshoot** problems. |
| 21 | + |
| 22 | +Teams who use Android Studio **must** disable Instant Run. |
| 23 | + |
| 24 | +Locating Instant Run Settings |
| 25 | +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| 26 | + |
| 27 | +When you first launch Android Studio a Welcome screen should appear. You |
| 28 | +can navigate to the Instant Run Settings from this Welcome screen by |
| 29 | +selecting the “Configure->Settings” item from the “Configure” dropdown |
| 30 | +list in the lower right hand corner of the screen. |
| 31 | + |
| 32 | +.. image:: images/ConfigureSettings.jpg |
| 33 | + |
| 34 | +On the left hand side of the Settings window, there should be a category |
| 35 | +called “Build, Execution, Deployment”. Within this category, click on |
| 36 | +the “Instant Run” subcategory to display the Instant Run settings for |
| 37 | +your Android Studio installation. By default, Instant Run is enabled |
| 38 | +when you first install Android Studio. Uncheck the “Enable Instant Run |
| 39 | +to hot swap code/resource changes on deploy (default enabled)” option |
| 40 | +and then click on the “OK” button to disable Instant Run. |
| 41 | + |
| 42 | +.. image:: images/InstantRunConfiguration.jpg |
| 43 | + |
| 44 | +Additional Information |
| 45 | +~~~~~~~~~~~~~~~~~~~~~~ |
| 46 | + |
| 47 | +The Google Android Developer website has additional information about |
| 48 | +Instant Run. It also has instructions on how to disable this feature: |
| 49 | + |
| 50 | +https://developer.android.com/studio/run |
0 commit comments