1. 项目概述为什么你需要这份“代号地图”如果你是一名Android开发者、ROM爱好者或者仅仅是喜欢折腾自己手机的用户那么你一定在某个时刻遇到过这样的困惑在XDA论坛上看到一个针对“raven”的刷机包或者在AOSPAndroid开源项目的源码目录里看到一个叫“oriole”的文件夹又或者在查看设备日志时发现一个陌生的“代号”codename却完全不知道它对应的是哪款市面上的手机。这个“代号”就是谷歌和各大手机厂商在内部开发时为每一款Android设备起的“小名”。它不同于我们熟知的“Pixel 6 Pro”或“小米12S Ultra”这样的市场名称Marketing Name而是一个唯一的、用于技术识别和底层开发的标识符。“谷歌官方 Android 设备和代号对照表”本质上就是一份将这两个世界连接起来的“密码本”。它不是为了普通消费者准备的而是面向开发者、极客和高级用户的“工程图纸”。这份对照表的价值远超你的想象。当你想为你的设备编译一个自定义内核你需要知道它的代号来定位正确的内核源码和驱动。当你在排查一个仅在某款设备上出现的系统级Bug时日志中的代号是定位问题的关键线索。当你想要下载特定设备的工厂镜像进行救砖或者寻找与之匹配的GSI通用系统映像时代号是确保文件兼容性的唯一凭证。没有这份对照表你就像在一个庞大的迷宫里摸索而有了它你就获得了一张精确的导航图。2. 核心价值与使用场景深度解析2.1 不只是名字代号的技术内涵设备代号并非随意取之。它通常是一个单词有时是动物如“marlin”枪鱼、“walleye”玻璃梭鲈、食物如“sargo”小眼重牙鲷一种鱼也算食物吧、地点或其他有特色的名词。这个代号会在设备的整个生命周期中被烙印在多个关键位置构建指纹Build Fingerprint在adb shell getprop ro.build.fingerprint命令的输出中你会看到类似google/raven/raven:13/TP1A.220624.014/8927612:user/release-keys的信息。这里的raven就是代号。设备树Device Tree在AOSP源码的device/目录下你会看到以厂商和代号命名的文件夹如device/google/raven。这里包含了该设备所有硬件相关的配置、内核编译规则和启动脚本。内核源码分支在厂商发布的内核源码仓库中分支名通常包含代号。工厂镜像与OTA包文件名谷歌官方提供的刷机包文件名如raven-tp1a.220624.014-factory-xxxxxx.zip其中的raven指明了适用的设备。因此掌握代号意味着你能够精准地定位到与你的设备硬件完全匹配的软件资源这是进行任何深度定制或问题排查的基础。2.2 四大核心应用场景2.2.1 场景一AOSP源码编译与定制ROM开发这是对照表最硬核的用途。如果你想从源码编译一个纯净的AOSP系统刷入你的Pixel手机第一步就是根据你的设备代号在lunch菜单中选择正确的编译目标例如aosp_raven-userdebug。如果你要开发或移植一个第三方ROM如LineageOS你需要为你的设备创建或找到一个对应的“设备树”而设备树的核心标识就是代号。没有正确的代号编译出的系统根本无法在你的硬件上启动。注意即便同一系列手机不同型号的代号也可能不同。例如Pixel 6的代号是oriole黄鹂鸟而Pixel 6 Pro的代号是raven渡鸦。刷错了代号的文件轻则功能异常重则导致设备变砖。2.2.2 场景二系统调试与日志分析当应用出现兼容性问题或系统发生崩溃时查看日志是首要手段。在logcat或bugreport中系统会频繁引用设备代号来标识硬件模块或驱动。例如一个显卡驱动的错误堆栈中可能包含msm_drm和代号信息。你能快速知道这个错误是否是你的设备所特有的还是在同一代号家族的设备中普遍存在。这对于向开源社区或厂商反馈问题至关重要因为你需要提供准确的设备信息。2.2.3 场景三刷机与救砖操作无论是通过fastboot刷入官方工厂镜像还是通过自定义Recovery刷入第三方ZIP包确认设备代号是操作前的“黄金法则”。很多刷机教程的第一步就是让你进入fastboot模式通过fastboot getvar product命令来验证设备代号。这能有效防止你误下载了其他设备的镜像从而避免不可逆的损坏。2.2.4 场景四寻找设备专属资源与支持在开发者社区如XDA、GitHub上资源都是按设备代号进行分区的。你想找Pixel 7的TWRP Recovery那你需要去pantherPixel 7或cheetahPixel 7 Pro的版块。你想找某个内核模块的源码你需要在代码仓库中搜索代号。对照表是你高效利用这些社区资源的钥匙。3. 如何获取与构建你自己的对照表谷歌官方并没有一个集中、静态的网页来维护一份完整的“对照表”。信息是分散的需要我们从多个权威源头进行收集和验证。以下是我在实践中总结的可靠方法。3.1 官方核心信息源AOSP源码中的“产品列表” 这是最权威的源头。在AOSP源码的build/make/target/product/目录下或者各厂商设备树目录下的AndroidProducts.mk文件中定义了编译目标与代号的映射。你可以通过搜索PRODUCT_MAKEFILES或PRODUCT_NAME来查找。例如在device/google/raven/AndroidProducts.mk中你会看到PRODUCT_MAKEFILES : $(LOCAL_DIR)/aosp_raven.mk这就明确了raven这个目标。# 在AOSP源码根目录下你可以尝试用grep命令搜索 find . -name AndroidProducts.mk -type f | xargs grep -l aosp_ | head -20谷歌开发者网站的Factory Images页面 访问 developers.google.com/android/images 或 developers.google.com/android/ota 。虽然页面上显示的是市场名称如Pixel 8但当你点击链接下载时观察浏览器下载的文件名。例如cheetah-ota-ap1a.240405.002-9d6d12e3.zip这里的cheetah就是Pixel 7 Pro的代号。通过分析所有可下载的文件名你可以构建出谷歌亲儿子系列的完整对照表。代号的使用历史维基百科与社区文档 维基百科上“Google Pixel”等词条以及像“LineageOS Wiki”这样的第三方ROM文档通常会详细列出历代设备的代号。这些是很好的辅助验证来源。3.2 构建与维护你的本地对照表单纯收藏网页是不够的。我建议你建立一份自己的、可维护的对照表格式可以是一个Markdown文件、一个电子表格或一个简单的JSON数据库。包含以下字段字段说明示例代号 (Codename)设备内部唯一标识raven市场名称 (Marketing Name)公开发售的名称Pixel 6 Pro厂商 (Manufacturer)设备制造商Google产品系列 (Series)所属系列Pixel 6发布年份 (Year)设备发布年份2021关键硬件标识如SoC型号用于区分相似代号Tensor GS101AOSP编译目标在lunch菜单中的选项aosp_raven-userdebug官方镜像关键词在镜像文件名中出现的部分raven备注其他信息如特殊变体仅指代特定存储/区域版本你可以写一个简单的Python脚本定期从AOSP的Git仓库中拉取最新信息解析AndroidProducts.mk文件或者爬取谷歌镜像站的页面请遵守robots.txt来半自动化地更新这份表格。3.3 实操快速查询你的设备代号对于你手头的设备最快的方式是使用ADB命令adb shell getprop | grep -E \(ro.product.device|ro.product.name|ro.product.model)\关键属性是ro.product.device它通常返回的就是代号。ro.product.model返回的往往是市场型号如Pixel 6 Pro。在fastboot模式下可以使用fastboot getvar all命令在输出信息中查找product:字段。4. 进阶应用从对照表到实际问题解决有了对照表我们能做什么更深入的事情下面结合几个真实案例。4.1 案例为老旧设备寻找可用的GSI假设你有一台型号很老的平板厂商早已停止系统更新。你想通过刷入GSI来让它“焕发新生”。首先你需要确定设备的代号和硬件架构arm64还是x86。然后你可以去GSI发布页面如Phhusson的Treble项目寻找兼容的GSI。但更重要的是你需要根据代号去XDA论坛或GitHub上搜索device/厂商/代号的社区维护设备树或适配补丁。因为GSI是通用的但设备的硬件驱动如摄像头、传感器是特殊的这些社区项目往往提供了让GSI在你的特定设备上完美运行的“胶水”代码。4.2 案例排查设备专属的相机故障你在自己编译的ROM上发现相机无法启动。日志显示错误来源于vendor.qti.hardware.camera.postproc服务。首先通过代号确认你的设备是sunfishPixel 4a。然后你去AOSP的device/google/sunfish目录下检查device.mk或BoardConfig.mk文件看看相机相关的专有Blob库vendor/下的库文件是否被正确包含。你还可以去谷歌的私有驱动仓库需要单独下载中找到sunfish对应的驱动包检查其中的相机HAL实现。没有代号你连该从哪里开始找问题都不知道。4.3 案例理解“代号家族”与软件复用有时多款设备会共享一个基础代号形成一个“家族”。例如redfin是Pixel 5的代号但某些软件组件可能被barbetPixel 5a复用。在对照表中做好关联记录可以帮助你理解软件更新的范围。当一个安全补丁说修复了redfin的某个驱动漏洞时作为barbet的用户你也应该警惕并主动关注自己设备的更新。这体现了对照表在安全层面的延伸价值。5. 常见陷阱与疑难解答即使手握对照表实践中也会踩坑。这里记录几个高频问题。5.1 陷阱一区域变体与运营商定制版这是最大的坑。同一款市场名称的设备可能因为销售地区或运营商不同而有多个细微差别的硬件版本它们有时会共用核心代号但拥有不同的子型号或硬件标识。例如三星的Galaxy S22国际版代号可能是r0q而韩国版或某个运营商定制版可能是r8q。它们的刷机包通常不通用。实操心得在寻找任何刷机资源前务必进入手机的“设置-关于手机”中确认完整的“型号”号码如SM-S9010而不仅仅是依赖代号。并优先寻找与你的具体型号号码完全匹配的资源。5.2 陷阱二代号的“生命周期”一个代号并非永远指向同一台设备。在极少数情况下厂商可能会在开发后期更换代号。或者一个在早期测试版中出现的代号最终并未对应到量产机型。因此对照表需要注明信息来源的时效性。最可靠的永远是当前设备系统属性中读取到的代号以及官方最新源码/镜像中使用的代号。5.3 疑难如何确认一个未知的代号当你从二手市场拿到一台工程机或者遇到一个非常冷门的设备网上查不到任何信息时提取Build Prop通过adb pull /system/build.prop仔细查看所有以ro.开头的属性特别是ro.product.device,ro.product.board,ro.product.manufacturer,ro.product.model。查看硬件信息在/proc/device-tree/或/sys/devices/目录下可能包含主板型号信息。反查内核如果设备能获取到内核源码内核的defconfig文件如sunfish_defconfig通常会直接包含代号。社区求助将你收集到的所有信息特别是build.prop片段和fastboot getvar all的输出注意脱敏个人信息发布到像XDA这样的专业论坛通常会有资深爱好者认出它。5.4 工具推荐自动化辅助Scrcpy在电脑上显示和控制Android设备其命令行版本在连接时会输出设备代号。Device Info HW一款功能强大的Android应用可以详细列出设备的所有硬件和软件信息包括确切的代号。Google‘s Android Open Source Project Search直接在 cs.android.com 上搜索代号可以快速找到该设备在AOSP中的所有相关源码和配置文件。维护一份准确、即时的设备和代号对照表就像是Android深度玩家的“个人知识库”基础设施。它不会直接让你的设备跑得更快但能在你需要进行开发、调试、拯救设备或探索可能性时为你节省无数个小时的搜索和试错时间。这份表格的价值会随着你接触的设备越多、折腾得越深而愈发凸显。我自己的对照表已经从最初的几十行扩展到了包含数百个条目并且还在不断更新它已经成为了我解决无数技术问题的起点。
Android设备代号对照表：开发者必备的硬件识别与资源定位指南
1. 项目概述为什么你需要这份“代号地图”如果你是一名Android开发者、ROM爱好者或者仅仅是喜欢折腾自己手机的用户那么你一定在某个时刻遇到过这样的困惑在XDA论坛上看到一个针对“raven”的刷机包或者在AOSPAndroid开源项目的源码目录里看到一个叫“oriole”的文件夹又或者在查看设备日志时发现一个陌生的“代号”codename却完全不知道它对应的是哪款市面上的手机。这个“代号”就是谷歌和各大手机厂商在内部开发时为每一款Android设备起的“小名”。它不同于我们熟知的“Pixel 6 Pro”或“小米12S Ultra”这样的市场名称Marketing Name而是一个唯一的、用于技术识别和底层开发的标识符。“谷歌官方 Android 设备和代号对照表”本质上就是一份将这两个世界连接起来的“密码本”。它不是为了普通消费者准备的而是面向开发者、极客和高级用户的“工程图纸”。这份对照表的价值远超你的想象。当你想为你的设备编译一个自定义内核你需要知道它的代号来定位正确的内核源码和驱动。当你在排查一个仅在某款设备上出现的系统级Bug时日志中的代号是定位问题的关键线索。当你想要下载特定设备的工厂镜像进行救砖或者寻找与之匹配的GSI通用系统映像时代号是确保文件兼容性的唯一凭证。没有这份对照表你就像在一个庞大的迷宫里摸索而有了它你就获得了一张精确的导航图。2. 核心价值与使用场景深度解析2.1 不只是名字代号的技术内涵设备代号并非随意取之。它通常是一个单词有时是动物如“marlin”枪鱼、“walleye”玻璃梭鲈、食物如“sargo”小眼重牙鲷一种鱼也算食物吧、地点或其他有特色的名词。这个代号会在设备的整个生命周期中被烙印在多个关键位置构建指纹Build Fingerprint在adb shell getprop ro.build.fingerprint命令的输出中你会看到类似google/raven/raven:13/TP1A.220624.014/8927612:user/release-keys的信息。这里的raven就是代号。设备树Device Tree在AOSP源码的device/目录下你会看到以厂商和代号命名的文件夹如device/google/raven。这里包含了该设备所有硬件相关的配置、内核编译规则和启动脚本。内核源码分支在厂商发布的内核源码仓库中分支名通常包含代号。工厂镜像与OTA包文件名谷歌官方提供的刷机包文件名如raven-tp1a.220624.014-factory-xxxxxx.zip其中的raven指明了适用的设备。因此掌握代号意味着你能够精准地定位到与你的设备硬件完全匹配的软件资源这是进行任何深度定制或问题排查的基础。2.2 四大核心应用场景2.2.1 场景一AOSP源码编译与定制ROM开发这是对照表最硬核的用途。如果你想从源码编译一个纯净的AOSP系统刷入你的Pixel手机第一步就是根据你的设备代号在lunch菜单中选择正确的编译目标例如aosp_raven-userdebug。如果你要开发或移植一个第三方ROM如LineageOS你需要为你的设备创建或找到一个对应的“设备树”而设备树的核心标识就是代号。没有正确的代号编译出的系统根本无法在你的硬件上启动。注意即便同一系列手机不同型号的代号也可能不同。例如Pixel 6的代号是oriole黄鹂鸟而Pixel 6 Pro的代号是raven渡鸦。刷错了代号的文件轻则功能异常重则导致设备变砖。2.2.2 场景二系统调试与日志分析当应用出现兼容性问题或系统发生崩溃时查看日志是首要手段。在logcat或bugreport中系统会频繁引用设备代号来标识硬件模块或驱动。例如一个显卡驱动的错误堆栈中可能包含msm_drm和代号信息。你能快速知道这个错误是否是你的设备所特有的还是在同一代号家族的设备中普遍存在。这对于向开源社区或厂商反馈问题至关重要因为你需要提供准确的设备信息。2.2.3 场景三刷机与救砖操作无论是通过fastboot刷入官方工厂镜像还是通过自定义Recovery刷入第三方ZIP包确认设备代号是操作前的“黄金法则”。很多刷机教程的第一步就是让你进入fastboot模式通过fastboot getvar product命令来验证设备代号。这能有效防止你误下载了其他设备的镜像从而避免不可逆的损坏。2.2.4 场景四寻找设备专属资源与支持在开发者社区如XDA、GitHub上资源都是按设备代号进行分区的。你想找Pixel 7的TWRP Recovery那你需要去pantherPixel 7或cheetahPixel 7 Pro的版块。你想找某个内核模块的源码你需要在代码仓库中搜索代号。对照表是你高效利用这些社区资源的钥匙。3. 如何获取与构建你自己的对照表谷歌官方并没有一个集中、静态的网页来维护一份完整的“对照表”。信息是分散的需要我们从多个权威源头进行收集和验证。以下是我在实践中总结的可靠方法。3.1 官方核心信息源AOSP源码中的“产品列表” 这是最权威的源头。在AOSP源码的build/make/target/product/目录下或者各厂商设备树目录下的AndroidProducts.mk文件中定义了编译目标与代号的映射。你可以通过搜索PRODUCT_MAKEFILES或PRODUCT_NAME来查找。例如在device/google/raven/AndroidProducts.mk中你会看到PRODUCT_MAKEFILES : $(LOCAL_DIR)/aosp_raven.mk这就明确了raven这个目标。# 在AOSP源码根目录下你可以尝试用grep命令搜索 find . -name AndroidProducts.mk -type f | xargs grep -l aosp_ | head -20谷歌开发者网站的Factory Images页面 访问 developers.google.com/android/images 或 developers.google.com/android/ota 。虽然页面上显示的是市场名称如Pixel 8但当你点击链接下载时观察浏览器下载的文件名。例如cheetah-ota-ap1a.240405.002-9d6d12e3.zip这里的cheetah就是Pixel 7 Pro的代号。通过分析所有可下载的文件名你可以构建出谷歌亲儿子系列的完整对照表。代号的使用历史维基百科与社区文档 维基百科上“Google Pixel”等词条以及像“LineageOS Wiki”这样的第三方ROM文档通常会详细列出历代设备的代号。这些是很好的辅助验证来源。3.2 构建与维护你的本地对照表单纯收藏网页是不够的。我建议你建立一份自己的、可维护的对照表格式可以是一个Markdown文件、一个电子表格或一个简单的JSON数据库。包含以下字段字段说明示例代号 (Codename)设备内部唯一标识raven市场名称 (Marketing Name)公开发售的名称Pixel 6 Pro厂商 (Manufacturer)设备制造商Google产品系列 (Series)所属系列Pixel 6发布年份 (Year)设备发布年份2021关键硬件标识如SoC型号用于区分相似代号Tensor GS101AOSP编译目标在lunch菜单中的选项aosp_raven-userdebug官方镜像关键词在镜像文件名中出现的部分raven备注其他信息如特殊变体仅指代特定存储/区域版本你可以写一个简单的Python脚本定期从AOSP的Git仓库中拉取最新信息解析AndroidProducts.mk文件或者爬取谷歌镜像站的页面请遵守robots.txt来半自动化地更新这份表格。3.3 实操快速查询你的设备代号对于你手头的设备最快的方式是使用ADB命令adb shell getprop | grep -E \(ro.product.device|ro.product.name|ro.product.model)\关键属性是ro.product.device它通常返回的就是代号。ro.product.model返回的往往是市场型号如Pixel 6 Pro。在fastboot模式下可以使用fastboot getvar all命令在输出信息中查找product:字段。4. 进阶应用从对照表到实际问题解决有了对照表我们能做什么更深入的事情下面结合几个真实案例。4.1 案例为老旧设备寻找可用的GSI假设你有一台型号很老的平板厂商早已停止系统更新。你想通过刷入GSI来让它“焕发新生”。首先你需要确定设备的代号和硬件架构arm64还是x86。然后你可以去GSI发布页面如Phhusson的Treble项目寻找兼容的GSI。但更重要的是你需要根据代号去XDA论坛或GitHub上搜索device/厂商/代号的社区维护设备树或适配补丁。因为GSI是通用的但设备的硬件驱动如摄像头、传感器是特殊的这些社区项目往往提供了让GSI在你的特定设备上完美运行的“胶水”代码。4.2 案例排查设备专属的相机故障你在自己编译的ROM上发现相机无法启动。日志显示错误来源于vendor.qti.hardware.camera.postproc服务。首先通过代号确认你的设备是sunfishPixel 4a。然后你去AOSP的device/google/sunfish目录下检查device.mk或BoardConfig.mk文件看看相机相关的专有Blob库vendor/下的库文件是否被正确包含。你还可以去谷歌的私有驱动仓库需要单独下载中找到sunfish对应的驱动包检查其中的相机HAL实现。没有代号你连该从哪里开始找问题都不知道。4.3 案例理解“代号家族”与软件复用有时多款设备会共享一个基础代号形成一个“家族”。例如redfin是Pixel 5的代号但某些软件组件可能被barbetPixel 5a复用。在对照表中做好关联记录可以帮助你理解软件更新的范围。当一个安全补丁说修复了redfin的某个驱动漏洞时作为barbet的用户你也应该警惕并主动关注自己设备的更新。这体现了对照表在安全层面的延伸价值。5. 常见陷阱与疑难解答即使手握对照表实践中也会踩坑。这里记录几个高频问题。5.1 陷阱一区域变体与运营商定制版这是最大的坑。同一款市场名称的设备可能因为销售地区或运营商不同而有多个细微差别的硬件版本它们有时会共用核心代号但拥有不同的子型号或硬件标识。例如三星的Galaxy S22国际版代号可能是r0q而韩国版或某个运营商定制版可能是r8q。它们的刷机包通常不通用。实操心得在寻找任何刷机资源前务必进入手机的“设置-关于手机”中确认完整的“型号”号码如SM-S9010而不仅仅是依赖代号。并优先寻找与你的具体型号号码完全匹配的资源。5.2 陷阱二代号的“生命周期”一个代号并非永远指向同一台设备。在极少数情况下厂商可能会在开发后期更换代号。或者一个在早期测试版中出现的代号最终并未对应到量产机型。因此对照表需要注明信息来源的时效性。最可靠的永远是当前设备系统属性中读取到的代号以及官方最新源码/镜像中使用的代号。5.3 疑难如何确认一个未知的代号当你从二手市场拿到一台工程机或者遇到一个非常冷门的设备网上查不到任何信息时提取Build Prop通过adb pull /system/build.prop仔细查看所有以ro.开头的属性特别是ro.product.device,ro.product.board,ro.product.manufacturer,ro.product.model。查看硬件信息在/proc/device-tree/或/sys/devices/目录下可能包含主板型号信息。反查内核如果设备能获取到内核源码内核的defconfig文件如sunfish_defconfig通常会直接包含代号。社区求助将你收集到的所有信息特别是build.prop片段和fastboot getvar all的输出注意脱敏个人信息发布到像XDA这样的专业论坛通常会有资深爱好者认出它。5.4 工具推荐自动化辅助Scrcpy在电脑上显示和控制Android设备其命令行版本在连接时会输出设备代号。Device Info HW一款功能强大的Android应用可以详细列出设备的所有硬件和软件信息包括确切的代号。Google‘s Android Open Source Project Search直接在 cs.android.com 上搜索代号可以快速找到该设备在AOSP中的所有相关源码和配置文件。维护一份准确、即时的设备和代号对照表就像是Android深度玩家的“个人知识库”基础设施。它不会直接让你的设备跑得更快但能在你需要进行开发、调试、拯救设备或探索可能性时为你节省无数个小时的搜索和试错时间。这份表格的价值会随着你接触的设备越多、折腾得越深而愈发凸显。我自己的对照表已经从最初的几十行扩展到了包含数百个条目并且还在不断更新它已经成为了我解决无数技术问题的起点。
