Merge "Docs: Remove defunct group from Updates and Resoruces"
diff --git a/src/devices/tech/dalvik/jit-compiler.jd b/src/devices/tech/dalvik/jit-compiler.jd
index 0e39829..419153b 100644
--- a/src/devices/tech/dalvik/jit-compiler.jd
+++ b/src/devices/tech/dalvik/jit-compiler.jd
@@ -175,7 +175,8 @@
Initial JIT performance vs pre-compiled depends on the the app, but in general
they are quite close. It might be worth noting that precompiled apps will not
be profiled and as such will take more space and may miss on other
-optimizations. </p>
+optimizations.
+</p>
<p>
In Android 7.0, there's a generic way to specify the level of
@@ -198,13 +199,17 @@
</pre>
<p>
+See the <a href="#recommendation">Recommendation</a> section for use.
+</p>
+
+<p>
Note the reference to A/B over-the-air (OTA) updates here.
</p>
<p>
Check <code>$ adb shell cmd package compile</code> for usage. Note all commands
-are preceded by a dollar ($) sign that should be excluded when copying and
-pasting. A few common use cases:
+in this document are preceded by a dollar ($) sign that should be excluded when
+copying and pasting. A few common use cases:
</p>
<h3 id="turn-on-jit-logging">Turn on JIT logging</h3>
@@ -258,9 +263,94 @@
-a</code></li>
</ul>
+<h2 id="recommendation">Recommendation</h2>
+
+<p>
+Note that it is strongly recommended to use the default following
+<code>pm.dexopt</code> settings and it is the only path we have tested and will
+support.
+</p>
+
+<pre>
+pm.dexopt.install=interpret-only
+pm.dexopt.bg-dexopt=speed-profile
+pm.dexopt.boot=verify-profile (or interpret-only)
+</pre>
+
+<p>
+Here’s a detailed explanation about the <code>pm.dexopt</code> options, and the
+reasoning for our recommendations:
+</p>
+
+<pre>
+pm.dexopt.install
+</pre>
+
+<p>
+This is the compilation filter used when installing application through the
+Play Store. For faster installs we recommend <code>interpret-only</code>.
+</p>
+
+<pre>
+pm.dexopt.bg-dexopt
+</pre>
+
+<p>
+This is the compilation filter used when the device is idle and charging and
+fully charged. We recommend using <code>speed-profile</code> to take advantage
+of profile guided compilation and save on storage.
+</p>
+
+<pre>
+pm.dexopt.ab-ota
+</pre>
+
+<p>
+This is the compilation filter used when doing an A/B over-the-air (OTA)
+update. If the device supports A/B OTA, we recommend using
+<code>speed-profile</code> to take advantage of profile guided compilation and
+save on storage.
+</p>
+
+<pre>
+pm.dexopt.nsys-library
+pm.dexopt.shared-apk
+pm.dexopt.core-app
+</pre>
+
+<p>
+You can use these different options to control how to compile essentially
+applications used by other applications. For such applications, we recommend
+the <code>speed</code> filter, as the platform does not support efficient
+profiling of them.
+</p>
+
+<pre>
+pm.dexopt.first-boot
+</pre>
+
+<p>
+The compilation filter for the first time the device ever boots. The filter
+used here will only affect the boot time after factory. We recommend the filter
+<code>interpret-only</code> for it, to avoid long times before a user gets to
+use the phone for the very first time. Note that if all applications in /system
+are already speed compiled, <code>pm.dexopt.first-boot</code> has no effect.
+</p>
+
+<pre>
+pm.dexopt.boot
+</pre>
+
+<p>
+The compilation filter used after an over-the-air update. We
+<strong>strongly</strong> recommend <code>verify-profile</code> for this
+option, to avoid very long updates.
+</p>
+
<h2 id="validation">Validation</h2>
<p>
To ensure their version of the feature works as intended, device implementers
should run the ART test in <code>android/art/test</code>. Also, see the CTS
-test <code>hostsidetests/compilation</code> for userdedug builds. </p>
+test <code>hostsidetests/compilation</code> for userdedug builds.
+</p>
diff --git a/src/index.jd b/src/index.jd
index 9ad6a5e..02cecec 100644
--- a/src/index.jd
+++ b/src/index.jd
@@ -40,15 +40,39 @@
<div class="wrap">
<div class="landing-docs">
- <div class="col-10">
+ <div class="col-9">
<h3>What's New</h3>
+<h4>New Android Build Numbers and CTS Downloads</h4>
+<p>Android 7.0 R.1, 6.0 R9, 5.1 R10, and 5.0 R9 Compatibility Test Suite (CTS)
+and CTS Verifier are available for <strong><a
+href="{@docRoot}compatibility/cts/downloads.html#android-70">Download</a></strong>.
+Also, new <strong><a
+href="{@docRoot}source/build-numbers.html#source-code-tags-and-builds">Build
+Numbers</a></strong> have been published for Android 7.0 on Nexus 6P, Nexus 5X,
+Nexus 9 (volantis), Nexus Player, and Pixel C and Android 6.0 on Nexus 5, Nexus
+5X, Nexus 6, Nexus 6P, and Nexus 9 (volantis).</p>
+
+<h4>Feedback Fixes</h4>
+<p>User feedback has resulted in the addition of the <a
+href="https://g.co/ABH">g.co/ABH</a> warning about operating system safety to
+the <em>User experience</em> section of <strong><a
+href="{@docRoot}security/verifiedboot/verified-boot.html#user_experience">Verifying
+Boot</a></strong> and timing of security updates to Nexus devices in <strong><a
+href="{@docRoot}security/bulletin/index.html">Android Security
+Bulletins</a></strong>. In addition, <strong><a
+href="{@docRoot}source/read-bug-reports.html">Reading Bug Reports</a></strong>
+now contains information on event log tags, wake locks, and Bluetooth Low
+Energy (BLE) scans.</p>
+
<h4>Key Features</h4>
<p>
<a href="{@docRoot}devices/tech/dalvik/jit-compiler.html"><strong>Just-in-time
(JIT) compiler</strong></a> with code profiling to Android runtime (ART)
-continually improves app performance.
-<a href="{@docRoot}security/encryption/file-based.html"><strong>Direct boot and
+continually improves app performance and now offers <a
+href="{@docRoot}devices/tech/dalvik/jit-compiler.html#recommendation"><strong>Recommendations</a></strong>
+for use. <a
+href="{@docRoot}security/encryption/file-based.html"><strong>Direct boot and
file-based encryption</strong></a> allows certain apps to run securely when
the device is powered on but not unlocked.
<a href="{@docRoot}devices/tech/display/multi-window.html"><strong>Multi-window</strong></a>
@@ -97,74 +121,9 @@
<a href="{@docRoot}devices/tech/display/dnd.html"><strong>suppress visual
interruptions</strong></a>.</p>
-<h4>Android For Work Updates</h4>
-<p>New device administration features include
-<a href="{@docRoot}devices/tech/admin/enterprise-telephony.html"><strong>enterprise
-telephony</strong></a> (cross-profile contact searching and badging, affects
-preloaded Dialer and Contacts apps),
-<a href="{@docRoot}devices/tech/admin/implement.html#HAL_values"><strong>device
-monitoring and health reporting</strong></a> (APIs for apps to query device
-hardware state; device must report correct values in the HAL implementation),
-and
-<a href="{@docRoot}devices/tech/admin/testing-setup.html#troubleshooting"><strong>enterprise
-process logging and device owner triggered bugreports</strong></a> (collect logs
-for user actions on a managed device).</p>
-
-<h4>Power Improvements</h4>
-<p>
-<a href="{@docRoot}devices/tech/power/mgmt.html#doze"><strong>Doze</strong></a>
-now works on devices in motion.
-<a href="{@docRoot}devices/tech/power/mgmt.html#sustained_performance"><strong>Sustained
-performance</strong></a> hints can inform long-running applications of
-device-performance capabilities (requires power HAL changes).
-<a href="{@docRoot}devices/tech/connect/data-saver.html"><strong>Data
-Saver</strong></a> enables restricting background data when on cellular or
-metered networks.
-Android now collects data for
-<a href="{@docRoot}devices/tech/power/values.html#le-bt-scans"><strong>Low
-Energy (LE) scans and Bluetooth</strong></a> traffic.</p>
-
-<h4>Under the Hood</h4>
-<p>Dialer APIs handle all
-<a href="{@docRoot}devices/tech/connect/call-notification.html"><strong>call
-notification</strong></a> logic (instead of sharing with Telecom).
-<a href="{@docRoot}devices/tech/config/namespaces_libraries.html"><strong>Namespaces
-for native libraries</strong></a> prevent apps from using private platform
-native APIs.
-<a href="{@docRoot}source/running.html#flashing-a-device"><strong>Flash
-unlock</strong></a> reports the bootloader's lock status.
-<a href="{@docRoot}devices/tech/connect/ril.html"><strong>Radio
-Interface Layer (RIL)</strong></a> support includes enhancements to error codes,
-versioning, and wakelocks.
-<a href="{@docRoot}devices/tech/config/uicc.html"><strong>UICC carrier
-privilege</strong></a> rules now support Access File Rule (ARF) storage.
-Android now supports the RFID smart card system
-<a href="{@docRoot}devices/tech/connect/felica.html"><strong>Felicity Card
-(FeliCa)</strong></a>.
-Documentation updated for
-<a href="{@docRoot}devices/halref/index.html"><strong>HAL</strong></a>
-and <a href="{@docRoot}reference/packages.html"><strong>TradeFed</strong></a>
-references.</p>
-
-<!--SAVED for FUTURE REFERENCE
-<a href="{@docRoot}source/build-numbers.html">
- <h4>Lollipop and Marshmallow Build Numbers</h4></a>
- <p>New <strong><a
- href="{@docRoot}source/build-numbers.html#source-code-tags-and-builds">Build
- Numbers</a></strong> have been published for Lollipop on Nexus 10 and
- Marshmallow on Nexus 5, Nexus 5X, Nexus 6, Nexus 6P, Nexus 7 (flo/deb), Nexus 9
- (volantis/volantisg), Nexus Player, and Pixel C.</p>
-
-<a href="{@docRoot}compatibility/downloads.html">
- <h4>Android 6.0, 5.1, and 5.0 CTS Downloads</h4></a>
- <p>Android 6.0 R8, 5.1 R9, and 5.0 R8 Compatibility Test Suite (CTS)
- and CTS Verifier are available for <strong><a
- href="{@docRoot}compatibility/cts/downloads.html#android-60">Download</a></strong>.</p>
--->
-
</div>
-<div class="col-5">
+<div class="col-6">
<h3>Getting Started</h3>
<a href="{@docRoot}source/index.html"><h4>Explore the Source</h4></a>
