Go to file
Bilal Elmoussaoui 51d1b13a9c ci: Enable clippy/audit jobs
And run audit after clippy, to avoid a useless install if clippy
fails
2024-08-09 13:23:07 +00:00
src Replace tempdir with tempfile 2024-08-09 13:23:07 +00:00
.gitignore initial commit 2023-05-04 19:01:23 +02:00
.gitlab-ci.yml ci: Enable clippy/audit jobs 2024-08-09 13:23:07 +00:00
Cargo.lock Update dependencies 2024-08-09 13:23:07 +00:00
Cargo.toml Update dependencies 2024-08-09 13:23:07 +00:00
COPYING initial commit 2023-05-04 19:01:23 +02:00
README.md readme: Document the openssl runtime dependency 2023-09-29 16:01:23 +02:00

cvd2img

A tool to transform Android Cuttlefish images into raw disk images that can be used with QEMU (and other VMMs).

Building

Dependencies

  • parted headers and libraries (libparted-dev in Debian, parted-devel in Fedora)
  • clang headers and libraries (libclang-dev in Debian, clang-devel in Fedora)
  • openssl runtime dependency used by avbtool
  • The Rust Toolchain

Generating the executable

With all dependencies in place, it should be as simple as running cargo build. The resulting binary will be in ./target/debug/cvd2img.

Using

Preparing the Cuttlefish Directory

  1. Download a cuttlefish image from http://ci.android.com/. If you don't exactly what to download, read this guide.

  2. Create a directory and unpack for the cuttlefish images and the CVD tools.

mkdir cuttlefish
cd cuttlefish
unzip ~/Downloads/aosp_cf_x86_64_phone-img*.zip
tar xf ~/Downloads/cvd-host_package.tar.gz

Generating the raw disk images

Go back to the cvd2img build directory and execute it pointing to the directory containing the cuttlefish images expanded above:

./target/debug/cvd2img ~/cuttlefish

More options

./target/debug/cvd2img --help
Usage: cvd2img [OPTIONS] <CVD_DIR>

Arguments:
  <CVD_DIR>  Directory containing the Android Cuttlefish images

Options:
  -a, --arch <ARCH>    Architecture of the source images [possible values: x86-64, aarch64]
  -s, --system <FILE>  Output file for the system disk image
  -p, --props <FILE>   Output file for the properties disk image
  -h, --help           Print help
  -V, --version        Print version