Tintenfisch: Erstellen Sie ein benutzerdefiniertes Gerät

Auf dieser Seite wird beschrieben, wie Sie ein benutzerdefiniertes Cuttlefish-Gerät erstellen. Cuttlefish umfasst vordefinierte Gerätetypen in verschiedenen Formfaktoren, wie in AndroidProducts.mk aufgeführt. Zusätzlich zu den allgemeinen Geräteanpassungsoptionen, die unter „Hinzufügen eines neuen Geräts“ beschrieben werden, können Sie Cuttlefish-spezifische Anpassungen vornehmen, z. B. Voreinstellungen für die Platinenkonfiguration virtueller Geräte (vsoc_x88_64, vsoc_arm64, vsoc_riscv64), vorgefertigte Kernel-Voreinstellungen, vorgefertigte Bootloader-Voreinstellungen, Herstellereigenschaften, Systemkonfigurationen und verschachtelte Konfigurationen Virtualisierungsunterstützung und Anzeigeoptionen. Eine vollständige Liste der Build-Zeitparameter, die angepasst werden können, finden Sie unter device/google/cuttlefish/vsoc_x86_64/phone/aosp_cf.mk .

In den folgenden Schritten wird beschrieben, wie Sie ein fiktives x86-64- big_phone Gerät erstellen, das zehnmal so groß ist wie ein gewöhnliches Cuttlefish-Gerät.

Von einem vorhandenen Ziel erben

So erben Sie von einem vorhandenen Ziel:

  • Erstellen Sie ein Verzeichnis device/google/cuttlefish/vsoc_x86_64/ big_phone .
  • Erstellen Sie in diesem Verzeichnis eine aosp_cf.mk Datei.
$(call inherit-product, device/google/cuttlefish/vsoc_x86_64_phone.mk)

PRODUCT_NAME: big_phone
PRODUCT_DEVICE: vsoc_x86_64
PRODUCT_MANUFACTURER := My Company
PRODUCT_MODEL: My Company very large phone

PRODUCT_VENDOR_PROPERTIES += \
    ro.soc.manufacturer=$(PRODUCT_MANUFACTURER) \
    ro.soc.model=$(PRODUCT_DEVICE)

Fügen Sie ein Mittagsziel hinzu

Fügen Sie das lunch in die device/google/cuttlefish/AndroidProducts.mk ein:

PRODUCT_MAKEFILES := \
  ...
  big_phone:$(LOCAL_DIR)/vsoc_x86_64/big_phone/aosp_cf.mk
  ...
lunch big_phone

Definieren Sie die JSON-Konfiguration

Um das Cuttlefish-Gerät zu starten, erstellen Sie eine JSON-Konfigurationsdatei mit dem Namen big_phone .json mit einer hierarchischen Struktur, die die Geräteeigenschaften darstellt. Beispielsweise können Sie in der JSON-Konfigurationsdatei Optionen wie den für die VM zugewiesenen RAM und die Anzeigekonfiguration angeben. Diese Datei muss sich nicht im AOSP-Baum befinden. Einzelheiten zum JSON-Format für Konfigurationen finden Sie unter Kanonische Konfigurationen .

{
  "instances":
      [
        {
          "vm": {
            "memory_mb": 40960,
          },
          "graphics": {
            "displays": [
              {
                "width": 7200,
                "height": 12800,
                "dpi": 320
              }
            ]
          }
        }
      ]
}

Um die Konfiguration zu starten, führen Sie Folgendes aus:

cvd start --config_file=big_phone.json

Führen Sie launch_cvd (Legacy) aus.

Bestimmte Konfigurationseigenschaften sind im hierarchischen JSON-Konfigurationsformat nicht verfügbar. Für solche Konfigurationen können Sie die Standardwerte launch_cvd Flags aus einem einstufigen JSON-Wörterbuch festlegen. Eine vollständige Liste aller Konfigurationsoptionen finden Sie unter cf_flags_validator.cpp .

Im Folgenden wird ein Beispiel dafür beschrieben, wie Sie die Standardwerte der launch_cvd Flag-Optionen mithilfe einer JSON-Konfigurationsdatei überschreiben und den Cuttlefish-Launcher zum Starten der benutzerdefinierten Konfiguration aktivieren.

  1. Erstellen Sie eine JSON-Konfigurationsdatei, device/google/cuttlefish/shared/config/config_ big_phone .json , mit benutzerdefinierten Werten.

    {
      "x_res": 7200,
      "y_res": 12800,
      "dpi": 320,
      "memory_mb": 40960,
      "ddr_mem_mb": 49150,
    }
    
  2. Damit der Cuttlefish-Launcher die big_phone Konfiguration starten kann, stellen Sie sicher, dass er Zugriff auf die device/google/cuttlefish/shared/config/config_ big_phone .json hat, indem Sie Folgendes tun:

    1. Deklarieren Sie das JSON-Artefakt als Build-Artefakt, indem Sie die Zeilengruppe „ prebuilt_etc_host “ in der device/google/cuttlefish/shared/config/Android.bp hinzufügen.

      prebuilt_etc_host {
          name: "cvd_config_big_phone.json",
          src: "config_big_phone.json",
          sub_dir: "cvd_config",
      }
      
    2. Fügen Sie die resultierende Build-Artefakt-Deklaration zum Cuttlefish-Launcher hinzu, indem Sie Folgendes in device/google/cuttlefish/shared/device.mk ausführen.

      $(call soong_config_append,cvd,launch_configs,cvd_config_big_phone)
      
    3. Erstellen Sie eine android_info.txt Datei und verknüpfen Sie die big_phone Konfiguration mit der Datei, indem Sie die folgende Zeile zu device/google/cuttlefish/vsoc_x86_64/ big_phone /aosp_cf.mk hinzufügen:

      TARGET_BOARD_INFO_FILE := device/google/cuttlefish/vsoc_x86_64/<var>big_phone</var>/android-info.txt
      
    4. Beschriften Sie den Gerätetyp mit der big_phone -Konfiguration, indem Sie device/google/cuttlefish/vsoc_x86_64/ big_phone /android-info.txt mit Folgendem füllen:

      config=big_phone