Blaster4385/adevtool
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
No description
343 commits 1 branch 0 tags 9.8 MiB
TypeScript 98.5%
Shell 1.3%
JavaScript 0.2%
Find a file
Danny Lin dc90c82fe2 package: Update keywords
2021-12-25 02:05:25 -08:00
.github github: Add funding links 2021-12-23 00:17:59 -08:00
bin Create oclif project 2021-11-06 23:34:51 -07:00
config config: pixel: minimal: Exclude all AiAi overlays 2021-12-23 00:56:55 -08:00
docs docs: Fix generate typos 2021-12-25 01:28:06 -08:00
scripts scripts: Add script to list updated system apps 2021-12-14 18:43:43 -08:00
src Reformat all code with Prettier 2021-12-25 02:05:23 -08:00
.editorconfig Create oclif project 2021-11-06 23:34:51 -07:00
.eslintignore Create oclif project 2021-11-06 23:34:51 -07:00
.gitignore gitignore: Ignore IDEA project 2021-12-25 01:27:16 -08:00
.prettierrc prettier: Add initial config 2021-12-25 01:47:05 -08:00
LICENSE Add MIT license 2021-11-15 17:45:08 -08:00
package.json package: Update keywords 2021-12-25 02:05:25 -08:00
README.md docs: Add initial bringup guide as copy of update 2021-12-23 00:47:18 -08:00
tsconfig.json tsconfig: Enable ES module interop 2021-11-23 20:14:09 -08:00
yarn.lock package: Add prettier, remove eslint and mocha 2021-12-25 01:46:48 -08:00

README.md

adevtool

Android device support and bringup tool, designed for maximum automation and speed.

Features

This tool automates the following tasks for devices that mostly run AOSP out-of-the-box (e.g. Google Pixel):

  • Downloading factory images and full OTA packages
  • Generating a list of proprietary files
  • Resolving overridden build rules and building modules from source (when possible)
  • Extracting, converting, and mounting factory images
  • Extracting proprietary files
  • Extracting bootloader and radio firmware
  • Finding and adding missing system properties
  • Overriding build fingerprint to help pass SafetyNet
  • Adding missing SELinux policies
  • Adding missing HALs to vendor interface manifests
  • Generating resource overlays for device configs
  • Fixing privileged app signing certificates referenced in SELinux policies

This typically results in better device support with fewer bugs and issues, and makes it possible to quickly add support for new devices.

Non-AOSP devices

Pixel devices will benefit from the most automation, but several features can still be used to ease manual bringup on other devices:

  • Extract files from proprietary-files.txt up to 10x faster than LineageOS extract-utils
  • Compare a built system against stock images to find missing files, properties, and vendor interface declarations
  • List system files relevant to bringup (in all partitions)
  • Resolve overridden build rules from build warnings
  • Check SELinux policies to identify apps that should be presigned

Installation

Pre-requisites:

  • Node.js
  • Optional:
    • For converting sparse factory images: simg2img
    • For extracting OTA packages: payload-dumper-go
    • For extracting OTAs or factory images: unzip
    • For generating overlays: AAPT2 (included in AOSP and Android SDK)

To run adevtool without installation:

npx adevtool

To install adevtool globally using npm:

npm install -g adevtool

Using Yarn:

yarn global add adevtool

Usage

License

This tool is licensed under the MIT license, ensuring that anyone is free to use it for any purpose in compliance with the license. Contributions are welcome!