
android-cuttlefish终极入门指南如何在5分钟内在Linux上免费运行Android虚拟设备【免费下载链接】android-cuttlefishCuttlefish host support debian package.项目地址: https://gitcode.com/gh_mirrors/an/android-cuttlefishandroid-cuttlefish 是 CuttlefishAndroid虚拟设备AVD的官方宿主机端工具项目它把复杂的宿主环境打包成可直接安装的 Debian 软件包让你只需几条 apt 命令就能在 Linux 上免费启动一台 Android 虚拟机还能通过浏览器直接操作——无需任何真机。 什么是 android-cuttlefishCuttlefish 是 AOSP 生态中的开源 Android 虚拟设备可运行在本地 Linuxx86_64 / ARM64上也支持部署到云端 GCE 实例。android-cuttlefish 项目的价值就是把这些宿主端工具封装成一套开箱即用的 Debian 包软件包作用cuttlefish-base核心包提供 Android 虚拟设备所需的静态资源与命令行工具cuttlefish-user本地 Web 服务器让你在浏览器中操作虚拟设备cuttlefish-orchestration面向多实例编排场景替代 cuttlefish-usercuttlefish-integration在 Google Compute Engine 上运行所需附加工具 只装cuttlefish-base即可运行虚拟机再装cuttlefish-user体验更佳。 5分钟快速开始一键安装步骤第一步注册 apt 仓库并安装软件包在 Debian / Ubuntu 系统上执行sudo curl -fsSL https://us-apt.pkg.dev/doc/repo-signing-key.gpg \ -o /etc/apt/trusted.gpg.d/artifact-registry.asc echo deb https://us-apt.pkg.dev/projects/android-cuttlefish-artifacts android-cuttlefish main \ | sudo tee -a /etc/apt/sources.list.d/artifact-registry.list sudo apt update sudo apt install cuttlefish-base cuttlefish-user第二步授权用户组并重启sudo usermod -aG kvm,cvdnetwork,render $USER sudo reboot这两行会把你的用户加入 KVM 虚拟化、虚拟网络与图形渲染所需的用户组重启会触发额外内核模块安装与 udev 规则生效。第三步启动你的 Android 虚拟设备安装好 Android 系统镜像后用cvd命令行工具即可管理虚拟设备实例cvd create default # 创建一个 Android 虚拟设备实例 cvd start default # 启动 cvd stop default # 关闭cvd工具采用「瘦客户端 持久化后台服务」架构负责拉起 ADB、WebRTC、日志监控、WiFi/蓝牙等所有支撑组件整个启动链路如下 喜欢源码编译可执行git clone https://gitcode.com/gh_mirrors/an/android-cuttlefish再用tools/buildutils/build_packages.sh脚本构建 .deb 包最后sudo apt install ./cuttlefish-base_*.deb即可详见仓库根目录的 README.md。 自定义虚拟机配置CPU、内存、网络与图形Cuttlefish 通过cvd命令行提供数十个配置项并按功能分类组织vm 分类虚拟机核心参数CPU 数量cpus、内存memory_mb、虚拟机管理器crosvm/qemu/gem5、内核kernel与安全security等核心选项都在这里connectivity 分类网络与连接涵盖 WiFi、蓝牙以及蜂窝调制解调器模拟器modem simulator方便测试联网与通话相关功能磁盘布局接近真实设备虚拟设备内部的镜像boot、system、super 等分区由assemble_cvd模块组装结构贴近真机 浏览器里操作 Androidcuttlefish-user Web 界面cuttlefish-user会启动一个本地 Web 服务Host Orchestrator WebRTC把虚拟设备的屏幕、输入与音频实时推流到浏览器鼠标键盘即可操作 Android 虚拟机从图中可以看到完整链路浏览器通过 HTTPS 连接 Host Orchestratorwebrtc 组件在中间桥接屏幕帧、键盘/触摸与音频最终送达 Cuttlefish 虚拟机。 进阶玩法容器镜像与云端部署容器镜像项目提供预装 cuttlefish 软件包的容器镜像支持 x86_64 / ARM64可直接拉取或用container/image/image-builder.sh自行构建Docker / Podman 均可详见container/README.md。Google Compute Engine安装cuttlefish-integration后可把 Android 虚拟设备托管到 GCE 实例基础镜像构建脚本见tools/baseimage/。❓ 常见问题 FAQQ1启动失败提示 KVM 相关错误确认宿主机 CPU 支持硬件虚拟化egrep -c (vmx|svm) /proc/cpuinfo应大于 0并确认已完成第二步的加组与重启。Q2安装后运行 cvd 提示权限不足检查用户是否已加入kvm、cvdnetwork、render三个组必要时重新登录或重启系统。Q3不想自己管理服务器想直接在云端跑使用容器镜像配合 Cloud Orchestrator参考container/README.md的说明即可。 项目结构导览路径说明base/cvd/cuttlefish/host/Android 虚拟设备宿主端工具核心启动器、Web 前端等base/cvd/cuttlefish/host/commands/cvd/cvd 命令行工具前端与配置解析base/debian/、frontend/debian/Debian 软件包配置文件container/容器镜像构建与 podcvd 组件e2etests/端到端测试用例创建、重启、快照等tools/buildutils/build_packages.sh.deb 软件包一键构建脚本docs/HostToolsMigration.md宿主工具迁移说明文档有了 android-cuttlefish一台普通 Linux 机器 5 分钟就能免费跑起 Android 虚拟设备。现在就来试试cvd create启动你的第一台虚拟手机吧【免费下载链接】android-cuttlefishCuttlefish host support debian package.项目地址: https://gitcode.com/gh_mirrors/an/android-cuttlefish创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考