Google Git
Sign in
android/device/google/cuttlefish/ec21fc79e
commit
ec21fc79e802b47b01b35329530b7cf25381d827
[log]
author
Inseob Kim <inseob@google.com>
Wed Apr 23 13:39:13 2025 +0900
committer
Inseob Kim <inseob@google.com>
Thu Apr 24 07:07:53 2025 -0700
tree
91db7f72bd5b206fed02f08e172f23e5e0e274b1
parent
a5db17fc867ec850405aa6435097f634ec6c14b0 [diff]
Enforce Treble labeling on cuttlefish

Treble labeling means the following:

1) All platform processes are marked as "coredomain".
2) All platform processes are labeled by platform SEPolicy.
3) All platform files are labeled by platform SEPolicy.
4) All vendor processes are NOT marked as "coredomain".

To ensure better updatability, this turns on Treble labeling enforcement
on cuttlefish.

Flag: TEST_ONLY

Bug: 412504639
Test: build
Change-Id: I47fa0aed193a31c8d17afb8606a997f474c2e7cc
2 files changed
tree: 91db7f72bd5b206fed02f08e172f23e5e0e274b1
  1. .vscode/
  2. apex/
  3. build/
  4. common/
  5. guest/
  6. host/
  7. recovery/
  8. shared/
  9. tests/
  10. tools/
  11. vsoc_arm/
  12. vsoc_arm64/
  13. vsoc_arm64_minidroid/
  14. vsoc_arm64_only/
  15. vsoc_arm64_pgagnostic/
  16. vsoc_arm_minidroid/
  17. vsoc_riscv64/
  18. vsoc_riscv64_minidroid/
  19. vsoc_x86/
  20. vsoc_x86_64/
  21. vsoc_x86_64_host/
  22. vsoc_x86_64_minidroid/
  23. vsoc_x86_64_only/
  24. vsoc_x86_64_pgagnostic/
  25. rustfmt.toml ⇨ ../../../build/soong/scripts/rustfmt.toml
  26. .clang-format
  27. Android.bp
  28. AndroidProducts.mk
  29. CleanSpec.mk
  30. debian_substitution_marker
  31. default-permissions.xml
  32. dtb.img
  33. iwyu.imp
  34. OWNERS
  35. OWNERS_techleads
  36. PREUPLOAD.cfg
  37. README.md
  38. required_images
  39. TEST_MAPPING
README.md

Note

For all host tools development please refer to https://github.com/google/android-cuttlefish/blob/main/docs/HostToolsMigration.md for more information.

Cuttlefish Getting Started

Try Cuttlefish

  1. Make sure virtualization with KVM is available.

    grep -c -w "vmx\|svm" /proc/cpuinfo

    This should return a non-zero value. If running on a cloud machine, this may take cloud-vendor-specific steps to enable. For Google Compute Engine specifically, see the GCE guide.

ARM specific steps:

  • When running on an ARM machine, the most direct way is to check for the existence of /dev/kvm. Note that this method can also be used to confirm support of KVM on any environment.

  1. Download, build, and install the host debian packages:

    sudo apt install -y git devscripts config-package-dev debhelper-compat golang curl
git clone https://github.com/google/android-cuttlefish
cd android-cuttlefish
# Install build dependencies and build debian packages
./tools/buildutils/build_packages.sh
sudo dpkg -i ./cuttlefish-base_*_*64.deb || sudo apt-get install -f
sudo dpkg -i ./cuttlefish-user_*_*64.deb || sudo apt-get install -f
sudo usermod -aG kvm,cvdnetwork,render $USER
sudo reboot

    The reboot will trigger installing additional kernel modules and applying udev rules.

  2. Go to http://ci.android.com/

  3. Enter a branch name. Start with aosp-main if you don‘t know what you’re looking for

  4. Navigate to aosp_cf_x86_64_phone and click on userdebug for the latest build

For ARM, use branch aosp-main-throttled and device target aosp_cf_arm64_only_phone-trunk_staging-userdebug

  1. Click on Artifacts

  2. Scroll down to the OTA images. These packages look like aosp_cf_x86_64_phone-img-xxxxxx.zip -- it will always have img in the name. Download this file

  3. Scroll down to cvd-host_package.tar.gz. You should always download a host package from the same build as your images.

  4. On your local system, combine the packages:

    mkdir cf
cd cf
tar xvf /path/to/cvd-host_package.tar.gz
unzip /path/to/aosp_cf_x86_64_phone-img-xxxxxx.zip

  5. Launch cuttlefish with:

$ HOME=$PWD ./bin/launch_cvd

Debug Cuttlefish

You can use adb to debug it, just like a physical device:

$ ./bin/adb -e shell

Launch Viewer (WebRTC)

When launching with ---start_webrtc (the default), you can see a list of all available devices at https://localhost:8443 . For more information, see the WebRTC on Cuttlefish documentation.

Stop Cuttlefish

You will need to stop the virtual device within the same directory as you used to launch the device.

$ HOME=$PWD ./bin/stop_cvd