From f4269f59b52b8acc83239e62f07898bcd380cbcf Mon Sep 17 00:00:00 2001
From: Android Partner Docs hardware/libhardware/include/hardware
.
For details, see hardware/audio.h.
+href="https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/audio.h">audio.h.
android.hardware.usb.host.xml
feature flagExample: get HVAC Temperature
Figure 2. Get HVAC temperature (CD = +
Figure 2. Get HVAC temperature (CS = CarService, VNS = VehicleNetworkService, VHAL = Vehicle HAL)
The interface is defined by Android and AOSP contributors, and the implementation is provided by the manufacturer of the device.
The sensor HAL interface is located in hardware/libhardware/include/hardware
.
- See sensors.h for additional details.
The HAL implementation specifies what version of the HAL interface it
implements by setting your_poll_device.common.version
. The existing HAL
diff --git a/en/devices/tech/ota/tools.html b/en/devices/tech/ota/tools.html
index 32eec985..1b26f918 100644
--- a/en/devices/tech/ota/tools.html
+++ b/en/devices/tech/ota/tools.html
@@ -23,11 +23,12 @@
-
The ota_from_target_files tool provided in
-build/tools/releasetools
can build two types of package: full
- and incremental. The tool takes the target-files .zip file
-produced by the Android build system as input.
The ota_from_target_files
+tool provided in build/tools/releasetools
can build two types of
+package: full and incremental. The tool takes the
+target-files .zip file produced by the Android build system as
+input.
A full update is one where the entire final state of the device @@ -62,8 +63,8 @@ done.
The ota_update.zip is now ready to be sent to test devices (everything is signed with the test key). For user devices, generate and use your own private -keys as detailed in Signing builds for release. +keys as detailed in Signing builds + for release.
An incremental update contains a set of binary patches to be applied diff --git a/en/devices/tech/test_infra/tradefed/fundamentals/lifecycle.html b/en/devices/tech/test_infra/tradefed/fundamentals/lifecycle.html index f5c836d1..a46bb22c 100644 --- a/en/devices/tech/test_infra/tradefed/fundamentals/lifecycle.html +++ b/en/devices/tech/test_infra/tradefed/fundamentals/lifecycle.html @@ -26,17 +26,17 @@
The lifecycle of a test executed using TradeFederation is composed of four separate stages, designed around formally defined interfaces.
Xiaoyong Zhou of Xiaoyong Zhou of Indiana University Bloomington
(@xzhou, zhou.xiaoyong@gmail.com)
Qualcomm Product Security Initiative
-Roee Hay (@roeehay, roeehay@gmail.com)
Robert Craig of
diff --git a/en/security/overview/app-security.html b/en/security/overview/app-security.html
index 6501c68f..ea20c611 100644
--- a/en/security/overview/app-security.html
+++ b/en/security/overview/app-security.html
@@ -33,33 +33,40 @@
The main Android application building blocks are: AndroidManifest.xml: The AndroidManifest.xml file is the control file that tells the system what to do with
+ AndroidManifest.xml: The AndroidManifest.xml
+ file is the control file that tells the system what to do with
all the top-level components (specifically activities, services, broadcast
receivers, and content providers described below) in an application. This also
specifies which permissions are required. Activities: An Activity is, generally, the code for a single, user-focused task. It usually
+ Activities: An Activity
+ is, generally, the code for a single, user-focused task. It usually
includes displaying a UI to the user, but it does not have to -- some
Activities never display UIs. Typically, one of the application's Activities
is the entry point to an application. Services: A Service is a body of code that runs in the background. It can run in its own process,
- or in the context of another application's process. Other components "bind" to
+ Services: A Service
+ is a body of code that runs in the background. It can run in its own
+ process, or in the context of another application's process. Other components "bind" to
a Service and invoke methods on it via remote procedure calls. An example of a
Service is a media player: even when the user quits the media-selection UI, the
user probably still intends for music to keep playing. A Service keeps the
music going even when the UI has completed. Broadcast Receiver: A BroadcastReceiver is an object that is instantiated when an IPC mechanism
- known as an Intent is issued by the operating system or another application. An application may
- register a receiver for the low battery message, for example, and change its
- behavior based on that information. Broadcast Receiver: A BroadcastReceiver
+ is an object that is instantiated when an IPC mechanism
+ known as an Intent
+ is issued by the operating system or another application. An application
+ may register a receiver for the low battery message, for example, and
+ change its behavior based on that information.
The Android Permission Model: Accessing Protected APIs
diff --git a/en/security/overview/updates-resources.html b/en/security/overview/updates-resources.html
index 48a43340..c524b5ff 100644
--- a/en/security/overview/updates-resources.html
+++ b/en/security/overview/updates-resources.html
@@ -1,6 +1,6 @@
-
The Android security team finds security vulnerabilities through internal research and also responds to bugs reported by third parties. Sources of -external bugs include issues reported through the Android Open Source -Project (AOSP) Security -bug report template, published and pre-published academic research, +external bugs include issues reported through the Android +Security Issue template, published and pre-published academic research, upstream open source project maintainers, notifications from our device manufacturer partners, and publicly disclosed issues posted on blogs or social media.
@@ -42,9 +41,9 @@ media.Any developer, Android user, or security researcher can notify the Android -security team of potential security issues through the AOSP bug tracker Security -bug report template.
+security team of potential security issues through the +Android Security Issue template.Bugs marked as security issues are not externally visible, but they may eventually be made visible after the issue is evaluated or resolved. If you diff --git a/en/source/community.html b/en/source/community.html index b2e414a4..2e78a9c8 100644 --- a/en/source/community.html +++ b/en/source/community.html @@ -68,8 +68,6 @@ page. For other information about Android, refer to the following resources.
*Please note: the Android Open Source Project (AOSP) issue tracker is +
The Android Open Source Project (AOSP) issue tracker is intended only for bugs and feature requests related to the core Android software stack, and is a technical tool for the Open Source community.
-This is not a customer support forum. -You can find support for Nexus devices on -Google's Nexus support site. +
This is not a customer support forum. For support information, see the +Nexus and +Pixel help centers. Support for other devices is provided by the device manufacturers or by the carriers selling those devices.
Support for Google applications is through Google's support site. Support -for 3rd-party applications is with each application's developer, e.g. +for third-party applications is with each application's developer, e.g. through the contact information provided on Google Play.
Here's the life of a bug, in a nutshell:
A bug is filed, and has the state "New".
-An AOSP maintainer periodically reviews and triages bugs. Bugs are -triaged into one of four "buckets": New, Open, No-Action, or Resolved.
-Each bucket includes a number of states that provide more detail on the -fate of the issue.
-Bugs in the "Resolved" bucket will eventually be included in a future -release of the Android software.
-Here is some additional information on each bucket, what it means, and how -it's handled.
-New issues include bug reports that are not yet being acted upon. The two -states are:
+ + ++We use the Status field in Issue Tracker to specify the status +of an issue in the resolution process. This is consistent with the definitions +specified in the Issue + Tracker documentation. +
++New issues include bug reports that are not yet being acted upon. The two states +are: +
New: - The bug report has not yet been triaged (that is, reviewed by an AOSP maintainer.)
-NeedsInfo: - The bug report has insufficient information to act -upon. The person who reported the bug needs to provide additional detail -before it can be triaged. If enough time passes and no new information is -provided, the bug may be closed by default, as one of the No-Action -states.
-This bucket contains bugs that need action, but which are still -unresolved, pending a change to the source code.
++This bucket contains bugs that need action, but which are still unresolved, +pending a change to the source code. +
Unassigned: - The bug report has been recognized as an adequately -detailed report of a legitimate issue, but has not yet been assigned to an -AOSP contributor to be fixed.
-Assigned: - Like Unassigned, but the bug has been -actually assigned to a specific contributor to fix.
-Typically, a given bug will start in Unassigned, where it -will remain until someone intends to resolve it, at which -point it will enter Assigned. However, -note that this isn't a guarantee, and it's not uncommon for bugs to go from -Unassigned to one of the Resolved states.
-In general, if a bug is in one of these Open states, the AOSP team has -recognized it as a legitimate issue, and a high-quality contribution fixing -that bug is likely to get accepted. However, it's impossible to guarantee a -fix in time for any particular release.
- -This bucket contains bugs that have for one reason or another been -determined to not require any action.
++Typically, a bug starts in Assigned, and remains there until +someone intends to resolve it, at which point it enters +Accepted. However, note that this isn't a guarantee, and it's +not uncommon for bugs to go from Assigned to one of the +Resolved states. +
++In general, if a bug is in one of these Open states, the AOSP team has +recognized it as a legitimate issue, and a high-quality contribution fixing that +bug is likely to get accepted. However, it's impossible to guarantee a fix in +time for any particular release. +
++This bucket contains bugs that are deemed to not require any action. +
Spam: - A kind soul sent us some delicious pork products, that we, -regrettably, do not want.
-Duplicate: - There was already an identical report in the issue tracker. Any actual -action will be reported on that report.
-Unreproducible: - An AOSP contributor attempted to reproduce the -behavior described, and was unable to do so. This sometimes means that the bug -is legitimate but simply rare or difficult to reproduce, and sometimes means -that the bug was fixed in a later release.
-Obsolete: - Similar to Unreproducible, but with a reasonable certainty -that the bug did exist in the reported version but was already fixed in -a later release.
-WorkingAsIntended: - An AOSP maintainer has determined that the -behavior described isn't a bug, but is the intended behavior. This state is -also commonly referred to as "WAI".
-Declined: - This is like WorkingAsIntended, except -typically used for feature requests instead of bugs. That is, an AOSP -maintainer has determined that the request is not going to be implemented in -Android.
-NotEnoughInformation: - The report didn't have enough information to be able to take any action.
-UserError: - The report was the result of a user making a mistake while using Android, -e.g. typing a wrong password and therefore not being able to connect to a -server.
-WrongForum: - The report cannot be handled in AOSP, typically because it is related -to a customized device or to an external application.
-Question: - Someone mistook the issue tracker for a help forum.
-This bucket contains bugs that have had action taken, and are now -considered resolved.
++This bucket contains bugs that have had action taken, and are now considered +resolved. +
Released: - This bug has been fixed, and is included in a formal release. -When this state is set, we try to also set a -property indicating which release it was fixed in.
-FutureRelease: - This bug has been fixed (or feature implemented) in -a source tree, but has not yet been included in a formal release.
-The states and lifecycle above are how we generally try to track software. +
+The states and lifecycle above are how we generally try to track software. However, Android contains a lot of software and gets a correspondingly large number of bugs. As a result, sometimes bugs don't make it through all the states in a formal progression. We do try to keep the system up to date, but we tend to do so in periodic "bug sweeps" where we review the database and make updates.
-