Home | History | Annotate | Download | only in docs
      1 <!-- Copyright 2016 The Chromium Authors. All rights reserved.
      2      Use of this source code is governed by a BSD-style license that can be
      3      found in the LICENSE file.
      4 -->
      5 
      6 # Devil: Persistent Device List
      7 
      8 ## What is it?
      9 
     10 A persistent device list that stores all expected devices between builds. It
     11 is used by non-swarmed bots to detect any missing/extra devices attached to
     12 them.
     13 
     14 This will be no longer needed when all bots are switched over to swarming.
     15 
     16 ## Bots
     17 
     18 The list is usually located at:
     19 
     20   - `~/.android/known_devices.json`.
     21 
     22 Look at recipes listed below in order to find more up to date location.
     23 
     24 ## Local Runs
     25 
     26 The persistent device list is unnecessary for local runs. It is only used on the
     27 bots that upload data to the perf dashboard.
     28 
     29 ## Where it is used
     30 
     31 The persistent device list is used in the
     32 [chromium_android](https://cs.chromium.org/chromium/build/scripts/slave/recipe_modules/chromium_android/api.py?q=known_devices_file)
     33 recipe module, and consumed by the
     34 [device_status.py](https://cs.chromium.org/chromium/src/third_party/catapult/devil/devil/android/tools/device_status.py?q=\-\-known%5C-devices%5C-file)
     35 script among others.
     36