lineageos

LineageOS 开发

本技能介绍 LineageOS 定制 ROM 开发，涵盖从同步源代码到构建和贡献。

入门

初始化源代码

mkdir ~/lineage && cd ~/lineage

# Install repo (if needed)
mkdir -p ~/.bin
curl https://storage.googleapis.com/git-repo-downloads/repo > ~/.bin/repo
chmod a+x ~/.bin/repo
export PATH="$HOME/.bin:$PATH"

# Init LineageOS 21 (Android 14)
repo init -u https://github.com/LineageOS/android.git -b lineage-21.0 --git-lfs

# Sync
repo sync -c -j$(nproc) --force-sync --no-tags --no-clone-bundle

构建命令

# Setup environment
source build/envsetup.sh

# Setup device (syncs device repos too)
breakfast <device>

# Build flashable ZIP
brunch <device>
# Or separately:
breakfast <device>
mka bacon

# Output: out/target/product/<device>/lineage-21.0-*-UNOFFICIAL-<device>.zip

---

基本命令

命令	用途
breakfast <device>	设置设备并同步依赖项
brunch <device>	执行 breakfast 并进行完整构建
mka bacon	构建可刷入的 ZIP
mka bootimage	仅构建内核
mka systemimage	仅构建系统
repopick <change>	从 Gerrit 拣选提交

---

设备树

必需文件

device/<vendor>/<device>/
├── lineage_<device>.mk      # Product makefile
├── lineage.dependencies     # Repo dependencies
├── vendorsetup.sh           # Add to lunch
├── BoardConfig.mk           # Hardware config
├── device.mk                # Packages and configs
└── extract-files.sh         # Vendor blob extraction

lineage_.mk

# Inherit device
$(call inherit-product, device/vendor/device/device.mk)

# Inherit LineageOS common
$(call inherit-product, vendor/lineage/config/common_full_phone.mk)

PRODUCT_NAME := lineage_device
PRODUCT_DEVICE := device
PRODUCT_BRAND := Vendor
PRODUCT_MODEL := Device Name
PRODUCT_MANUFACTURER := Vendor

lineage.dependencies

[
  {
    "repository": "android_kernel_vendor_device",
    "target_path": "kernel/vendor/device"
  },
  {
    "repository": "android_device_vendor_device-common",
    "target_path": "device/vendor/device-common"
  },
  {
    "repository": "proprietary_vendor_device",
    "target_path": "vendor/device"
  }
]

---

repopick - 从 Gerrit 拣选提交

# Single change
repopick 12345

# Multiple changes
repopick 12345 12346 12347

# By topic
repopick -t feature-topic

# With dependencies
repopick -Q 12345

# Force overwrite local changes
repopick -f 12345

# Show what would be picked
repopick -n 12345

查找变更编号

1. 访问 https://review.lineageos.org
2. 搜索变更
3. 变更编号位于 URL 中或页面上

---

Vendor Blob

从设备提取

cd device/vendor/device
./extract-files.sh

从 OTA/Factory Image 提取

./extract-files.sh ~/Downloads/ota.zip

proprietary-files.txt 格式

# Audio HAL
vendor/lib64/hw/audio.primary.platform.so
vendor/etc/audio_policy_configuration.xml

# With destination path
vendor/lib64/lib.so:vendor/lib64/libfoo.so

# From another device
vendor/lib64/lib.so|other_device

---

LineageOS 功能

Trust 界面

显示设备完整性的安全仪表板：

# device.mk
PRODUCT_PACKAGES += \
    LineageTrust

LiveDisplay

硬件加速的显示调节：

PRODUCT_PACKAGES += \
    [email protected]

样式 / 主题

系统主题支持：

PRODUCT_PACKAGES += \
    ThemePicker

---

关键目录

路径	用途
vendor/lineage/	LineageOS 扩展
lineage-sdk/	LineageOS SDK
device/<vendor>/<device>/	设备树
kernel/<vendor>/<device>/	内核源代码
vendor/<vendor>/	专有 Blob

---

贡献

设置 Gerrit 访问权限

git config --global review.review.lineageos.org.username <username>

提交变更

# Create branch
repo start my-feature .

# Make changes
git add -A
git commit -m "subsystem: Short description

Detailed explanation.

Change-Id: <auto-generated>"

# Push for review
git push ssh://<username>@review.lineageos.org:29418/<project> HEAD:refs/for/<branch>

提交消息格式

subsystem: Short description

Longer explanation wrapped at 72 characters.
Explain why, not what.

Change-Id: I1234567890abcdef...

---

常见问题

Breakfast 失败 - 缺少仓库

# Re-sync device tree
repo sync device/vendor/device kernel/vendor/device vendor/device

构建失败 - SELinux

# Find denials
adb shell dmesg | grep "avc: denied"

# Generate policy (on host)
adb shell dmesg | audit2allow -p out/target/product/<device>/root/sepolicy

缺少 Blob

检查 logcat 中的：

E linker: cannot find symbol...
E ServiceManager: Could not find service...

将缺少的文件添加到 proprietary-files.txt 并重新提取。

---

快速参考

# Full workflow
source build/envsetup.sh
breakfast cheeseburger
brunch cheeseburger

# Just kernel
mka bootimage

# Cherry-pick fix
repopick 12345

# Sync everything
repo sync -c -j$(nproc)

# Sync one project
repo sync packages/apps/Settings

# Clean build
m clean && brunch <device>