aboutsummaryrefslogtreecommitdiff
path: root/en/devices
diff options
context:
space:
mode:
authorAndroid Partner Docs <noreply@android.com>2018-05-14 13:22:16 -0700
committerClay Murphy <claym@google.com>2018-05-14 14:52:17 -0700
commitacab5f65ac9673faf39d4b64d0937a7cfb69dddd (patch)
tree4bb7614a9743af97c0fbcad8f35e2b837a130a30 /en/devices
parent93b256109ebf25a3880bb32aec9a3a2b7b8dd247 (diff)
downloadsource.android.com-acab5f65ac9673faf39d4b64d0937a7cfb69dddd.tar.gz
Docs: Changes to source.android.com
- 196556741 Automated g4 rollback of changelist 195735838. by Android Partner Docs <noreply@android.com> - 196537805 Correct link for A-70986337 by Danielle Roberts <daroberts@google.com> - 196536907 Update broken link to point to new source by Christina Nguyen <cqn@google.com> - 196524339 Devsite localized content from translation request 4637e6... by Android Partner Docs <noreply@android.com> - 196524319 Devsite localized content from translation request 987838... by Android Partner Docs <noreply@android.com> - 196524157 Devsite localized content from translation request 324901... by Android Partner Docs <noreply@android.com> - 196524148 Devsite localized content from translation request fc3d82... by Android Partner Docs <noreply@android.com> - 196524135 Devsite localized content from translation request b68270... by Android Partner Docs <noreply@android.com> - 196342804 Add May 2018 security bulletins and build numbers to News by Clay Murphy <claym@google.com> - 196309016 Updating end-user UI paths for battery optimizations. by Heidi von Markham <hvm@google.com> - 196286488 Add Modular Kernel Requirements to News section by Clay Murphy <claym@google.com> - 196278207 Update ambient capabilities page by Kenneth Lau <kennethlau@google.com> - 196267757 Added AOSP links to May bulletins. by Android Partner Docs <noreply@android.com> - 196042172 Scott Bauer ack change per tkensinger@ request by Android Partner Docs <noreply@android.com> - 196039262 Updating the 8.0 CDD. by Gina Dimino <gdimino@google.com> - 195856571 Replace preview links with the redirect, permanent links. by Android Partner Docs <noreply@android.com> - 195829803 Devsite localized content from translation request 6036d9... by Android Partner Docs <noreply@android.com> - 195823927 Devsite localized content from translation request ecf40b... by Android Partner Docs <noreply@android.com> PiperOrigin-RevId: 196556741 Change-Id: Ia1830213d5e90bb80da0c241834d3c07538ea63a
Diffstat (limited to 'en/devices')
-rw-r--r--en/devices/tech/config/ambient.html89
-rw-r--r--en/devices/tech/config/filesystem.html12
-rw-r--r--en/devices/tech/connect/data-saver.html9
-rw-r--r--en/devices/tech/display/adaptive-icons.html37
-rw-r--r--en/devices/tech/display/retail-mode.html2
-rw-r--r--en/devices/tech/power/mgmt.html23
-rw-r--r--en/devices/tv/index.html2
7 files changed, 100 insertions, 74 deletions
diff --git a/en/devices/tech/config/ambient.html b/en/devices/tech/config/ambient.html
index 97f43f58..1330e145 100644
--- a/en/devices/tech/config/ambient.html
+++ b/en/devices/tech/config/ambient.html
@@ -1,6 +1,6 @@
<html devsite>
<head>
- <title>Implementing Ambient Capabilities</title>
+ <title>Ambient Capabilities</title>
<meta name="project_path" value="/_project.yaml" />
<meta name="book_path" value="/_book.yaml" />
</head>
@@ -31,17 +31,60 @@
those capabilities.
</p>
<p>
- Ambient capabilities allows system services to configure capabilities in their
- <code>.rc</code> files, bringing all their configuration into a single file,
- instead of having to split capabilities configuration to the
- <code>fs_config.c</code> file.
+ Ambient capabilities allows system services launched by init to configure
+ capabilities in their <code>.rc</code> files, bringing configuration into
+ a single file instead of splitting configuration in the
+ <code>fs_config.c</code> file. This means that for any service launched by
+ init, you can use the <code>.rc</code> file associated with the service to
+ configure capabilities for that service.
</p>
+ <p>
+ Ambient capabilities are the preferred mechanism for setting capabilities
+ for services launched by init (this method keeps all aspects for the service
+ configuration in a single <code>.rc</code> file). We recommend using ambient
+ capabilities instead of <a href="/devices/tech/config/filesystem#configuring-the-caps-section">
+ configuring file system capabilities using the caps
+ section</a> in <code>config.fs</code> files.
+ </p>
+ <p>
+ When setting capabilities for services <strong>not launched by init</strong>,
+ continue to configure file system capabilities using
+ <code>fs_config.c</code>.
+ </p>
+
+ <h2 id="enabling-ambient-capabilities">Enabling ambient capabilities</h2>
+ <p>
+ To enable ambient capabilities for a given service, use the
+ <code>capabilities</code> keyword in init. For current init language
+ details, refer to the
+ <a href="https://android.googlesource.com/platform/system/core/+/master/init/README.md">
+ init README.md</a>.
+ </p>
+ <p>
+ For example, to enable ambient capabilities for the AOSP service
+ <code>wificond</code>, the
+ <a href="https://android.googlesource.com/platform/system/connectivity/wificond/+/master/wificond.rc">
+ .rc file</a> for the <code>wificond</code> service sets up the appropriate
+ user and groups and gives the service the specified capabilities using the
+ <code>capabilities</code> keyword:
+ </p>
+
+<pre class="prettyprint">
+service wificond /system/bin/wificond
+ class main
+ user wifi
+ group wifi net_raw net_admin
+ capabilities NET_RAW NET_ADMIN
+</pre>
+
<h2 id="reference-implementation">Reference implementation</h2>
<p>
The reference implementation is the Android common kernel <a
href="https://android.googlesource.com/kernel/common/">https://android.googlesource.com/kernel/common/</a>
</p>
<h2 id="required-patches">Required patches</h2>
+ <aside class="note"><strong>Note:</strong> The Android kernels 3.10 (android-3.10) and 3.14 (android-3.14) have been deprecated and removed.</aside>
+
<p>
Required patches have been backported to all the relevant Android common kernel
branches.
@@ -52,17 +95,7 @@
has been backported in:
</p>
<ul>
- <li>android-3.10 branch:
- <ul>
- <li><a
- href="https://android.googlesource.com/kernel/common/+/bdcd4484f1b399dfcb2fd7dd82b6869b2b6b60cd">https://android.googlesource.com/kernel/common/+/bdcd4484f1b399dfcb2fd7dd82b6869b2b6b60cd</a>
- </ul>
- <li>android-3.14 branch:
- <ul>
- <li><a
- href="https://android.googlesource.com/kernel/common/+/5440f16f1296ca05f33dfde51e8bb7ad48699640">https://android.googlesource.com/kernel/common/+/5440f16f1296ca05f33dfde51e8bb7ad48699640</a>
- </ul>
- <li>android-3.18:
+ <li>android-3.18:
<ul>
<li><a
href="https://android.googlesource.com/kernel/common/+/d6a9a74487e86b528c44965f871de75671b6adb0">https://android.googlesource.com/kernel/common/+/d6a9a74487e86b528c44965f871de75671b6adb0</a>
@@ -81,16 +114,6 @@
</p>
<ul>
- <li>android-3.10 branch:
- <ul>
- <li><a
- href="https://android.googlesource.com/kernel/common/+/ef89def080c52eb7ea6a9455eb32b1b05867133b">https://android.googlesource.com/kernel/common/+/ef89def080c52eb7ea6a9455eb32b1b05867133b</a>
- </ul>
- <li>android-3.14 branch:
- <ul>
- <li><a
- href="https://android.googlesource.com/kernel/common/+/f75626b3092fad4e0bd8f2aed06947352781eb77">https://android.googlesource.com/kernel/common/+/f75626b3092fad4e0bd8f2aed06947352781eb77</a>
- </ul>
<li>android-3.18:
<ul>
<li><a
@@ -103,20 +126,6 @@
</ul>
</ul>
- <p>
- A memory leak fix <a
- href="https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=6d6f3328422a3bc56b0d8dd026a5de845d2abfa7">https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=6d6f3328422a3bc56b0d8dd026a5de845d2abfa7</a>,
- needed for kernels < 3.18, has been backported in:
- </p>
-
- <ul>
- <li>android-3.10 branch:
- <ul>
- <li><a
- href="https://android.googlesource.com/kernel/common/+/900e52782988ee11a1cb7d600e9edea48fc70f0f">https://android.googlesource.com/kernel/common/+/900e52782988ee11a1cb7d600e9edea48fc70f0f</a></li>
- </ul>
- </ul>
-
<h2 id="validation">Validation</h2>
<p>
<a
diff --git a/en/devices/tech/config/filesystem.html b/en/devices/tech/config/filesystem.html
index 73633943..d6569c37 100644
--- a/en/devices/tech/config/filesystem.html
+++ b/en/devices/tech/config/filesystem.html
@@ -104,6 +104,18 @@ system capabilities) and an AIDs section (for configuring OEM-specific AIDs).
</p>
<h3 id="configuring-the-caps-section">Configuring the caps section</h3>
+
+<aside class="note"><strong>Note:</strong>
+<a href="/devices/tech/config/ambient">Ambient capabilities</a> are the preferred
+mechanism for setting capabilities for services launched by init (this method
+keeps all aspects for the service configuration in a single <code>.rc</code>
+file). We recommend using ambient capabilities for these services instead of
+configuring file system capabilities using the caps section in
+<code>config.fs</code> files. When setting capabilities for services
+<strong>not launched by init</strong>, continue to configure file system
+capabilities using <code>fs_config.c</code>.</aside>
+
+
<p>The caps section supports setting
<a href="http://man7.org/linux/man-pages/man7/capabilities.7.html" class="external">file
system capabilities</a> on filesystem objects within the build (the filesystem
diff --git a/en/devices/tech/connect/data-saver.html b/en/devices/tech/connect/data-saver.html
index 32e3d6aa..133d3e55 100644
--- a/en/devices/tech/connect/data-saver.html
+++ b/en/devices/tech/connect/data-saver.html
@@ -31,7 +31,7 @@ this functionality to the user.
</p>
<p>
-The <a href="https://developer.android.com/preview/features/data-saver.html">Data Saver</a>
+The <a href="https://developer.android.com/training/basics/network-ops/data-saver">Data Saver</a>
feature can be turned on or off by the user. App developers
should use a new API to check if Data Saver mode is on. If it is on, the app
developers can handle the situation gracefully by tuning their applications for
@@ -50,7 +50,8 @@ ensures desired background data exchange when Data Saver is on per user control.
Since the Data Saver is a feature in the platform, device manufacturers gain its
functionality by default with the N release. Find the source files in:</br>
<a class="external"
- href="https://android.googlesource.com/platform/packages/apps/Settings/+/master/src/com/android/settings/datausage">packages/apps/Settings/src/com/android/settings/datausage</a>
+ href="https://android.googlesource.com/platform/packages/apps/Settings/+/master/src/com/android/settings/datausage">
+ packages/apps/Settings/src/com/android/settings/datausage</a>
</p>
<h3 id="settings-interface">Settings interface</h3>
@@ -93,10 +94,10 @@ apply Data Saver.</p>
<p>
All app developers must act to implement Data Saver, including OEMs and
carriers with preloaded apps. See
-<a href="https://developer.android.com/preview/features/data-saver.html">Data
+<a href="https://developer.android.com/training/basics/network-ops/data-saver">Data
Saver on developer.android.com</a> for app developer instructions on detecting
and monitoring Data Saver states. See the sections below for additional details
-helpful to partners. </p>
+helpful to partners.</p>
<p>
To optimize for Data Saver mode, apps should:
diff --git a/en/devices/tech/display/adaptive-icons.html b/en/devices/tech/display/adaptive-icons.html
index 815e9b9c..5d74b10c 100644
--- a/en/devices/tech/display/adaptive-icons.html
+++ b/en/devices/tech/display/adaptive-icons.html
@@ -43,11 +43,14 @@
Developer documentation:
</p><ul>
<li><a
- href="https://developer.android.com/preview/features/adaptive-icons.html">https://developer.android.com/preview/features/adaptive-icons.html</a>
+ href="https://developer.android.com/guide/practices/ui_guidelines/icon_design_adaptive">
+ https://developer.android.com/guide/practices/ui_guidelines/icon_design_adaptive</a>
<li><a
- href="https://developer.android.com/reference/android/graphics/drawable/AdaptiveIconDrawable.html">https://developer.android.com/reference/android/graphics/drawable/AdaptiveIconDrawable.html</a>
+ href="https://developer.android.com/reference/android/graphics/drawable/AdaptiveIconDrawable.html">
+ https://developer.android.com/reference/android/graphics/drawable/AdaptiveIconDrawable.html</a>
<li><a
- href="https://developer.android.com/reference/android/graphics/drawable/Icon.html#createWithAdaptiveBitmap(android.graphics.Bitmap)">https://developer.android.com/reference/android/graphics/drawable/Icon.html#createWithAdaptiveBitmap(android.graphics.Bitmap)</a></li></ul>
+ href="https://developer.android.com/reference/android/graphics/drawable/Icon.html#createWithAdaptiveBitmap(android.graphics.Bitmap)">
+ https://developer.android.com/reference/android/graphics/drawable/Icon.html#createWithAdaptiveBitmap(android.graphics.Bitmap)</a></li></ul>
<p>
Source code:
@@ -61,7 +64,7 @@
<pre
class="prettyprint">&lt;!-- Specifies the path that is used by AdaptiveIconDrawable class to crop launcher icons. -->
- &lt;string name="config_icon_mask" translatable="false">"M50,0L100,0 100,100 0,100 0,0z"&lt;/string></pre>
+ &lt;string name="config_icon_mask" translatable="false">"M50,0L100,0 100,100 0,100 0,0z"&lt;/string></pre>
<p>
The format and syntax of the string follow the <a
href="https://www.w3.org/TR/SVG/paths.html">W3, SVG standard for path
@@ -86,25 +89,25 @@
<pre
class="prettyprint">package android.graphics.drawable;
public class AdaptiveIconDrawable extends Drawable implements Drawable.Callback {
- method public Drawable getBackground();
- method public Drawable getForeground();
- method public Path getIconMask();
- method public Region getSafeZone();
- method public float getExtraInsetFraction();
- method public int getOpacity();
- method public void invalidateDrawable(Drawable);
- method public void scheduleDrawable(Drawable, Runnable, long);
- method public void setAlpha(int);
- method public void setColorFilter(ColorFilter);
- method public void setOpacity(int);
- method public void unscheduleDrawable(android.graphics.drawable.Drawable, java.lang.Runnable);
+ method public Drawable getBackground();
+ method public Drawable getForeground();
+ method public Path getIconMask();
+ method public Region getSafeZone();
+ method public float getExtraInsetFraction();
+ method public int getOpacity();
+ method public void invalidateDrawable(Drawable);
+ method public void scheduleDrawable(Drawable, Runnable, long);
+ method public void setAlpha(int);
+ method public void setColorFilter(ColorFilter);
+ method public void setOpacity(int);
+ method public void unscheduleDrawable(android.graphics.drawable.Drawable, java.lang.Runnable);
}</pre>
<pre
class="prettyprint">public class Icon extends Parceleable {
- method public Bitmap createWithAdaptiveBitmap();
+ method public Bitmap createWithAdaptiveBitmap();
}</pre>
<h2>Reference Implementation</h2>
<p>
diff --git a/en/devices/tech/display/retail-mode.html b/en/devices/tech/display/retail-mode.html
index 5e124735..40ab1710 100644
--- a/en/devices/tech/display/retail-mode.html
+++ b/en/devices/tech/display/retail-mode.html
@@ -121,7 +121,7 @@ Settings.System</a> settings.</li>
Android Developer definitions</a> of users, profiles, and accounts</li>
<li><a href="https://developer.android.com/reference/android/app/admin/DevicePolicyManager.html">
Device Policy Manager API documentation</a></li>
- <li><a href="https://developer.android.com/samples/DeviceOwner/index.html">
+ <li><a href="https://github.com/googlesamples/android-DeviceOwner/#readme">
Sample Device Owner app</a></li>
</ul>
diff --git a/en/devices/tech/power/mgmt.html b/en/devices/tech/power/mgmt.html
index c54821f0..dc441428 100644
--- a/en/devices/tech/power/mgmt.html
+++ b/en/devices/tech/power/mgmt.html
@@ -308,9 +308,9 @@ details, refer to
<a href="https://developer.android.com/training/monitoring-device-state/doze-standby.html#testing_doze_and_app_standby">Testing
Doze and App Standby</a>.</p>
-<p class="note"><strong>Note</strong>: MMS/SMS/Telephony services function independently
-of Doze and will always wake client apps even while the device remains in Doze
-mode.</p>
+<aside class="note"><strong>Note</strong>: MMS/SMS/Telephony services function
+independently of Doze and will always wake client apps even while the device
+remains in Doze mode.</aside>
<h2 id="exempt-apps">Exempting applications</h2>
<p>You can exempt applications from being subject to Doze or App Standby.
@@ -332,15 +332,16 @@ these reasons, we strongly recommend that you do not exempt third-party
applications and instead exempt only cloud messaging services or apps with
similar functions.</p>
-<p>Apps exempted by default are listed in a single view in <em>Settings >
-Battery</em>. This list is used for exempting the app from both Doze and App
-Standby modes. To provide transparency to the user, the Settings menu
-<strong>MUST</strong> show all exempted applications.</p>
+<p>Apps exempted by default are listed in a single view in <em>Settings > App
+&amp; Notifications > Special app access > Battery Optimization</em>. This list
+is used for exempting the app from both Doze and App Standby modes. To provide
+transparency to the user, the Settings menu <strong>MUST</strong> show all
+exempted applications.</p>
-<p>Users can manually exempt apps via <em>Settings > Battery > Battery
-optimization > All apps</em> and then selecting the app to turn off (or back on)
-optimization. However, users cannot unexempt any application or service that is
-exempted by default in the system image.</p>
+<p>Users can manually exempt apps via <em>Settings > App &amp; Notifications >
+<var>APP-NAME</var> > Battery > Battery Optimization</em> and then selecting the
+app to turn off (or back on) optimization. However, users cannot unexempt any
+application or service that is exempted by default in the system image.</p>
</body>
</html>
diff --git a/en/devices/tv/index.html b/en/devices/tv/index.html
index 2d330c20..e02cc8b2 100644
--- a/en/devices/tv/index.html
+++ b/en/devices/tv/index.html
@@ -556,7 +556,7 @@ recording to users when requested.</li>
<p>
For more information about implementing Recording features in your TV Input
service, see this <a
-href="https://developer.android.com/preview/features/tv-recording-api.html">TV
+href="https://developer.android.com/training/tv/tif/content-recording">TV
Recording</a> article.
</p>
generated by cgit v1.2.3 (git 2.25.1) at 2024-07-02 11:39:41 +0000