Docs: Changes to source.android.com

  - 189377827 hikey960: Use Image.gz-dtb as a kernel image by Android Partner Docs <noreply@android.com>
  - 189349681 Moving VTS from devices/tech to compatibility/vts (and im... by Heidi von Markham <hvm@google.com>
  - 189244963 Augment USB Audio CTS doc with additional peripherals by Clay Murphy <claym@google.com>
  - 189185354 New reports page for Android Security YIR and home page u... by Danielle Roberts <daroberts@google.com>
  - 189059228 Update CTS/CTS-Verifier downloads for CTS-Mar-2018 Releases by Android Partner Docs <noreply@android.com>
  - 189043885 Devsite localized content from translation request 6cb273... by Android Partner Docs <noreply@android.com>
  - 189038438 Devsite localized content from translation request 1306aa... by Android Partner Docs <noreply@android.com>
  - 189038430 Devsite localized content from translation request cbcbd6... by Android Partner Docs <noreply@android.com>
  - 188908346 Devsite localized content from translation request 946829... by Android Partner Docs <noreply@android.com>
  - 188908252 Devsite localized content from translation request 4ade76... by Android Partner Docs <noreply@android.com>
  - 188908248 Devsite localized content from translation request 3a86a7... by Android Partner Docs <noreply@android.com>
  - 188908238 Devsite localized content from translation request 090d64... by Android Partner Docs <noreply@android.com>
  - 188877475 Updated "Develop CTS" page to by Android Partner Docs <noreply@android.com>
  - 188805462 Devsite localized content from translation request 429221... by Android Partner Docs <noreply@android.com>
  - 188791843 CDD: Relax Overview title count requirement. by Android Partner Docs <noreply@android.com>
  - 188751143 Devsite localized content from translation request 1e4322... by Android Partner Docs <noreply@android.com>
  - 188751132 Devsite localized content from translation request 9e5f9b... by Android Partner Docs <noreply@android.com>
  - 188560973 CDD: SD card encryption required for the primary external... by Android Partner Docs <noreply@android.com>
  - 188560351  by Android Partner Docs <noreply@android.com>
  - 188418844 Add links and path to source files for Data Saver by Clay Murphy <claym@google.com>
  - 188368136 CDD: Apps can use ACTION_OPEN_DOCUMENT_TREE to write to s... by Android Partner Docs <noreply@android.com>
  - 188364381  by Android Partner Docs <noreply@android.com>
  - 188363534 CDD: Fixing typos in the USB section by Android Partner Docs <noreply@android.com>
  - 188360294 CDD: Relax Overview title count requirement. by Android Partner Docs <noreply@android.com>
  - 188351043 Devsite localized content from translation request e77cb5... by Android Partner Docs <noreply@android.com>
  - 188346717 CDD: Relax Near-ultrasound microphone SNR requirement. by Android Partner Docs <noreply@android.com>
  - 188344574 CDD: Updated section 3.8.10 Lock Screen Media Control to ... by Android Partner Docs <noreply@android.com>
  - 188269274  by Android Partner Docs <noreply@android.com>
  - 188268739 CDD: Relax Overview title count requirement. by Android Partner Docs <noreply@android.com>
  - 188254167 Add AOSP links to Android & Pixel bulletins by Danielle Roberts <daroberts@google.com>
  - 188246295  by Android Partner Docs <noreply@android.com>
  - 188243208  by Android Partner Docs <noreply@android.com>
  - 188235190 Devsite localized content from translation request f764fc... by Android Partner Docs <noreply@android.com>
  - 188213222 Add tag for Pixel C release for March 2018. by Android Partner Docs <noreply@android.com>
  - 188209010 Devsite localized content from translation request 8fd2a1... by Android Partner Docs <noreply@android.com>

PiperOrigin-RevId: 189377827
Change-Id: I6f068548537b775ce3f2f086d87633726b1286b0

1 files changed, 51 insertions, 16 deletions

diff --git a/en/compatibility/5.1/android-5.1-cdd.html b/en/compatibility/5.1/android-5.1-cdd.html
index c2927814..377d9f9d 100644
--- a/en/compatibility/5.1/android-5.1-cdd.html
+++ b/en/compatibility/5.1/android-5.1-cdd.html
@@ -1413,7 +1413,7 @@ implementations including the recents function navigation key as detailed in <a
 <ul>
   <li>MUST display affiliated recents as a group that moves together.</li>
   <li>MUST support at least up to 20 displayed activities.</li>
-  <li>MUST at least display the title of 4 activities at a time.</li>
+  <li>SHOULD at least display the title of 4 activities at a time.</li>
   <li>SHOULD display highlight color, icon, screen title in recents.</li>
   <li>MUST implement the screen pinning behavior [<a href="http://developer.android.com/about/versions/android-5.0.html#ScreenPinning">Resources, 33</a>] and provide the user with a settings menu to toggle the feature.</li>
   <li>SHOULD display a closing affordance ("x") but MAY delay this until user
@@ -2150,7 +2150,8 @@ hardware.</p>
 
 <p>While some of the requirements outlined in this section are stated as SHOULD
 since Android 4.3, the Compatibility Definition for a future version is planned
-to change these to MUST. Existing and new Android devices are <strong>very strongly encouraged</strong> to meet these requirements, or they will not be able to attain Android
+to change these to MUST. Existing and new Android devices are <strong>STRONGLY RECOMMENDED</strong>
+to meet these requirements that are stated as SHOULD, or they will not be able to attain Android
 compatibility when upgraded to the future version.</p>
 
 <h3 id="5_4_1_raw_audio_capture">5.4.1. Raw Audio Capture</h3>
@@ -3825,11 +3826,15 @@ Shared storage MUST otherwise be writable by any application that obtains that
 permission.</p>
 
 <p>Device implementations that include multiple shared storage paths (such as both
-an SD card slot and shared internal storage) MUST NOT allow Android
-applications to write to the secondary external storage, except for their
-package-specific directories on the secondary external storage, but SHOULD
-expose content from both storage paths transparently through Android&rsquo;s media
-scanner service and android.provider.MediaStore.</p>
+an SD card slot and shared internal storage) MUST allow only pre-installed and
+privileged Android applications with the WRITE_EXTERNAL_STORAGE permission to
+write to the secondary external storage, except when writing to their
+package-specific directories or within the <code>URI</code> returned by firing
+the <code>ACTION_OPEN_DOCUMENT_TREE</code> intent.</p>
+
+<p>However, device implementations SHOULD expose content from
+both storage paths transparently through Android's media scanner service
+and android.provider.MediaStore.</p>
 
 <p>Regardless of the form of shared storage used, if the device implementation
 has a USB port with USB peripheral mode support, it MUST provide some mechanism
@@ -3856,13 +3861,15 @@ USB host mode.</p>
 <ul>
   <li>The port MUST be connectable to a USB host that has a standard type-A or type
 -C USB port.</li>
-  <li>The port SHOULD use micro-A, micro-AB or type-C USB form factor. Existing and
-new Android devices are <strong>very strongly encouraged to meet these requirements</strong> so they will be able to upgrade to the future platform releases.</li>
-  <li>The port SHOULD be centered in the middle of an edge. Device implementations
-SHOULD either locate the port on the bottom of the device (according to natural
+  <li>The port SHOULD use micro-B, micro-AB or Type-C USB form factor. Existing and
+new Android devices are <strong>STRONGLY RECOMMENDED to meet these requirements</strong>
+so they will be able to upgrade to future platform releases.</li>
+  <li>The port SHOULD either be located on the bottom of the device (according to natural
 orientation) or enable software screen rotation for all apps (including home
 screen), so that the display draws correctly when the device is oriented with
-the port at bottom. Existing and new Android devices are <strong>very strongly encouraged to meet these requirements</strong> so they will be able to upgrade to future platform releases.</li>
+the port at bottom. Existing and new Android devices are <strong>STRONGLY RECOMMENDED
+to meet these requirements</strong> so they will be able to upgrade to future platform
+releases.</li>
   <li>It SHOULD implement the Android Open Accessory (AOA) API and specification as
 documented in the Android SDK documentation, and if it is an Android Handheld
 device it MUST implement the AOA API. Device implementations implementing the
@@ -3873,7 +3880,7 @@ AOA specification:
 documentation [<a href="http://developer.android.com/reference/android/hardware/usb/UsbConstants.html#USB_CLASS_AUDIO">Resources, 98</a>].</li>
   </ul></li>
   <li>It SHOULD implement support to draw 1.5 A current during HS chirp and traffic
-as specified in the USB battery charging specification [<a href="http://www.usb.org/developers/docs/devclass_docs/USB_Battery_Charging_1.2.pdf">Resources, 99</a>]. Existing and new Android devices are <strong>very strongly encouraged to meet these requirements</strong> so they will be able to upgrade to the future platform releases.</li>
+as specified in the USB Battery Charging Specification, Revision 1.2 [<a href="http://www.usb.org/developers/docs/devclass_docs/BCv1.2_070312.zip">Resources, 99</a>]. Existing and new Android devices are <strong>STRONGLY RECOMMENDED to meet these requirements</strong> so they will be able to upgrade to the future platform releases.</li>
   <li>The value of iSerialNumber in USB standard device descriptor MUST be equal to
 the value of android.os.Build.SERIAL.</li>
 </ul>
@@ -3891,7 +3898,7 @@ documentation [<a href="http://developer.android.com/reference/android/hardware/
   <li>MUST implement the Android USB host API as documented in the Android SDK, and
 MUST declare support for the hardware feature android.hardware.usb.host [<a href="http://developer.android.com/guide/topics/connectivity/usb/host.html">Resources, 100</a>].</li>
   <li>SHOULD support the Charging Downstream Port output current range of 1.5 A ~ 5 A
-as specified in the USB Battery Charging Specifications [<a href="http://www.usb.org/developers/docs/devclass_docs/USB_Battery_Charging_1.2.pdf">Resources, 99</a>].</li>
+as specified in the USB Battery Charging Specification, Revision 1.2 [<a href="http://www.usb.org/developers/docs/devclass_docs/BCv1.2_070312.zip">Resources, 99</a>].</li>
 </ul>
 
 <h2 id="7_8_audio">7.8. Audio</h2>
@@ -4142,7 +4149,7 @@ ensure that applications owned by and running on behalf a given user cannot
 list, read, or write to data owned by any other user. Note that removable
 media, such as SD card slots, can allow one user to access another&rsquo;s data by
 means of a host PC. For this reason, device implementations that use removable
-media for the external storage APIs MUST encrypt the contents of the SD card if
+media for the primary external storage APIs MUST encrypt the contents of the SD card if
 multiuser is enabled using a key stored only on non-removable media accessible
 only to the system. As this will make the media unreadable by a host PC, device
 implementations will be required to switch to MTP or a similar system to
@@ -4407,6 +4414,10 @@ Definition in this release. </p>
     <td>Clarified notification requirement for Android Watch, Television and
         Automotive implementations.</td>
  </tr>
+  <tr>
+    <td>3.8.8. Activity Switching</td>
+    <td>Relax Overview title count requirement.</td>
+ </tr>
  <tr>
     <td>3.8.10. Lock Screen Media Control</td>
     <td>Clarified requirement for Android Watch and Automotive implementations.</td>
@@ -4436,6 +4447,10 @@ Definition in this release. </p>
     <td>5.1.3 Video Codecs</td>
     <td>Added Android automotive requirements.</td>
  </tr>
+   <tr>
+    <td>5.4. Audio Recording</td>
+    <td>Clarified language at the beginning of the section to ensure MUST requirements are read as REQUIRED.</td>
+ </tr>
  <tr>
     <td>7.1.1.3. Screen Density</td>
     <td>Added a new screen dpi (280dpi).</td>
@@ -4479,7 +4494,19 @@ Definition in this release. </p>
  </tr>
  <tr>
     <td>7.6.2. Application Shared Storage</td>
-    <td>Updated requirements when support for host machine access is mandatory.</td>
+    <td>Updated requirements when support for host machine access is mandatory.</td>    
+ </tr>
+  <tr>
+    <td>7.7 USB</td>
+    <td>Fixing typos in USB section</td>
+ </tr>
+ <tr>
+    <td>7.6.2. Application Shared Storage</td>
+    <td>Updated requirements that pre-installed system apps may write to secondary external storage.</td>
+ </tr>
+ <tr>
+    <td>7.6.2. Application Shared Storage</td>
+    <td>Apps can use ACTION_OPEN_DOCUMENT_TREE to write to secondary ext. storage</td>    
  </tr>
  <tr>
     <td>7.8.1. Microphone</td>
@@ -4489,6 +4516,14 @@ Definition in this release. </p>
     <td>8.2. File I/O Access Performance</td>
     <td>Clarified requirements.</td>
  </tr>
+   <tr>
+    <td>
+9.5. Multi-User Support
+</td>
+    <td>
+SD card encryption required for the primary external storage.
+</td>
+ </tr>
  <tr>
     <td>9.8. Privacy</td>
     <td>Added privacy requirement for preloaded VPNs.</td>