← ClaudeAtlas

android-mainline-portlisted

把主线 Linux 和桌面发行版移植到 Android 手机、平板的操作手册与经验库(高通 + Ubuntu GNOME 实践)。覆盖评估、构建、bootloader、设备树、显示、触控、音频、无线、充电、休眠、双系统、内核换代、打包、测试与发布。用户想在安卓设备上跑原生 Linux、移植主线内核、fastboot 启动自制内核、排查外设在主线下不工作、把几台设备合到同一棵内核,或评估设备能否移植时使用。
yzddmr6/android-mainline-port · ★ 119 · AI & Automation · score 86
Install: claude install-skill yzddmr6/android-mainline-port
# 安卓设备移植主线 Linux ## 这份 skill 怎么组织 - **外层框架**(本文件和 `references/`):先做什么、后做什么,工作原则,技术决策,怎么判断通过。相对稳定。 - **经验库**(`experience/`):按领域写的推荐路线、完成标准和具体的坑(现象、原因、怎么确认、怎么解决、适用范围)。随项目追加。 经验来自几台高通平板移植到 Ubuntu 26.04 + GNOME 的过程(主线内核 6.17 到 7.4,2026 年)。流程、纪律和验证方法通用;启动链、固件协议、资源管理和电源策略按目标平台核对;手机特有的蜂窝通话、短信、定位没有覆盖。Ubuntu 相关部分换发行版时按 `references/ubuntu.md` 最后一节调整。版本号、接口名、上游进度有时效性,标了年份的事实使用前先核对上游现状;上游已经解决的问题,直接用更简单的办法。 规则都写成"默认做法 + 什么条件下怎么做 + 为什么 + 不适用的情况"。先理解"为什么":遇到规则没覆盖的情况,按同样的机制判断,不要机械套用。 ## 怎么用 - **新项目**:按下面的流程从第 0 步开始,每一步先读 `references/process.md` 对应小节,再读相关的 `experience/` 文件。 - **中途接手**:先读项目自己的 AGENTS.md、状态页、交接页和技术债表,再定位到流程中的哪一步。 - **做技术决策**:先读 `references/decisions.md` 对应一节的默认做法和规则。 - **改一个有状态的控制子系统**(充电、显示电源生命周期、挂起交接、温控):先读 `references/control-models.md`,再改代码。 - **排查故障**:先按 `experience/patterns.md` 判断问题属于哪一类、按通用步骤排查;再用日志里的错误码、函数名、配置项在 `experience/` 里 `grep` 找具体条目。 - **只做评估**:完成第 0 步,输出评估报告和决策清单。 ## 流程 | 步 | 做什么 | 完成标准 | 主要参考 | |---|---|---|---| | 0 立项 | 建工作区;资料池(上游、在审补丁、同 SoC 社区、厂商源码、同类项目);按接口词做复用调研;硬件清单;选型;估算;和用户确认决策 | 用户确认决策清单;确认前不碰设备 | `references/process.md`、`references/decisions.md`、`references/discipline.md` | | 1 构建环境 | 工具链、ccache、长期 OUT、根文件系统构建方式;原样构建一次社区参考内核 | 参考内核可复现,增量构建几分钟 | `references/build-environment.md` | | 2 取证与备份 | root;按确认的范围备份并校验;取出运行时设备树、固件、PMIC 电压、显示参数、原厂命令序列;建原厂能力清单并记下用户层的原厂基准数字;准备恢复 | 备份两侧哈希一致;恢复镜像在手;原厂能力清单建好 | `references/process.md`、`experience/usb-and-storage.md` | | 3 首次启动 | 离线搞清 bootloader;最小设备树;时标探针;驻留内存、块设备只读的 initramfs + USB 网络 + 超时回退 | 主机能连 shell,超时自动