From 04c1f72d4c8ff2763c6961b6eae77a10abc00b66 Mon Sep 17 00:00:00 2001 From: Android Partner Docs Date: Tue, 21 Aug 2018 09:08:03 -0700 Subject: Docs: Changes to source.android.com - 209604809 Add note about dm-verity for low-ram devices where it onl... by Danielle Roberts - 209604691 Update August acknowledgements for CVE-2018-9441 by Danielle Roberts - 209486466 Add LEVEL_3 to Camera versioning by Kenneth Lau - 209486462 CL to update external severity ratings to the v6 severity... by Android Partner Docs - 209444238 Update _translation.yaml to exclude 2018 bulletins by Danielle Roberts - 209427959 Add arrow icon to external links in lists by Kenneth Lau - 209424658 Devsite localized content from translation request 968451. by Android Partner Docs - 209424637 Devsite localized content from translation request 968450. by Android Partner Docs - 209424628 Devsite localized content from translation request 966380. by Android Partner Docs - 209424625 Devsite localized content from translation request 964306. by Android Partner Docs - 209267798 Replaces gendered pronouns by a gender-neutral alternative. by Android Partner Docs - 209227647 Devsite localized content from translation request 965625. by Android Partner Docs - 209227634 Devsite localized content from translation request 957852. by Android Partner Docs - 209212984 Adding additional kernel configs by Heidi von Markham - 209202145 Fix typo by Kenneth Lau - 209200899 Change to external links by Kenneth Lau - 209199945 Add links to Wi-Fi Infrastructure Features by Kenneth Lau - 209197210 Update BiometricPrompt architecture diagram by Danielle Roberts - 209175201 Add missing method handle types to dex-format.html by Android Partner Docs - 209168733 Fix formatting issues by Kenneth Lau - 209045992 Remove "" typo that's causing localization to break by Danielle Roberts - 209045924 Remove "" typo that's causing localization to fail by Danielle Roberts - 209045830 Update header id that's causing localization failures by Danielle Roberts - 209042219 Update documentation for no more static java libraries. by Android Partner Docs - 209031438 Remove previously redirected landing pages by Clay Murphy - 209023482 Add a additional kernel requirement information for eBPF ... by Android Partner Docs - 209011451 Clarify documentation on conventions for method overloadi... by Android Partner Docs - 208971152 Create a BLE for Hearing Aids page on SAC. by Christina Nguyen - 208933222 Add "Matching AVB Version during OTA" section. by Android Partner Docs - 208891110 Update correct version for CTS 7.0_r24. Wrong version was... by Android Partner Docs - 208878378 Update CTS/CTS-Verifier downloads for CTS-Aug-2018 Releas... by Android Partner Docs - 208855756 Devsite localized content from translation request 965636. by Android Partner Docs - 208855746 Devsite localized content from translation request 964314. by Android Partner Docs - 208738524 Add version information by Kenneth Lau - 208733023 Update security researcher acknowledgements by Danielle Roberts - 208724203 Fix changelog links, messed up in last errata run. by Gina Dimino - 208723122 Add missing word "Android" by Android Partner Docs - 208700832 Devsite localized content from translation request 954736. by Android Partner Docs - 208688134 Devsite localized content from translation request 960242. by Android Partner Docs - 208688127 Devsite localized content from translation request 952102. by Android Partner Docs - 208672491 Fix file paths in immediate directory that were broken by... by Christina Nguyen - 208571761 Add Wi-Fi Infrastructure Features document by Kenneth Lau PiperOrigin-RevId: 209604809 Change-Id: If554e158c7c400736ca7722cce279231a53e0933 --- en/devices/architecture/hidl/versioning.html | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) (limited to 'en/devices/architecture/hidl') diff --git a/en/devices/architecture/hidl/versioning.html b/en/devices/architecture/hidl/versioning.html index c67910d9..fe4ec95d 100644 --- a/en/devices/architecture/hidl/versioning.html +++ b/en/devices/architecture/hidl/versioning.html @@ -219,7 +219,7 @@ as a method parameter), use the fully-qualified type name:

(e.g., android.hardware.nfc).
  • VERSION is the dot-separated major.minor-version format of the package (e.g., 1.0).
    • -
  • UDT is the the dot-separated name of a HIDL UDT. +
  • UDT is the dot-separated name of a HIDL UDT. Since HIDL supports nested UDTs and HIDL interfaces can contain UDTs (a type of nested declaration), dots are used to access the names.
    • @@ -656,10 +656,12 @@ enum Brightness : @1.0::Brightness { AUTOMATIC }; enum Color : @1.0::Brightness { HW_GREEN, RAINBOW }; -

    Unless a method warrants a new name, it should be named similarly to what it -is extending. For example, the method foo_1_1 in -@1.1::IFoo may replace the functionality of the foo -method in @1.0::IFoo.

    +

    If a method can have a new semantic name (for instance +fooWithLocation) then that is preferred. Otherwise, it should be +named similarly to what it is extending. For example, the method +foo_1_1 in @1.1::IFoo may replace the functionality +of the foo method in @1.0::IFoo if there is no better +alternative name.

    Package-level versioning

    HIDL versioning occurs at the package level; after a package is published, it -- cgit v1.2.3