https://wiki.uotan.cn/api.php?action=feedcontributions&feedformat=atom&user=XiaoleGun
Uotan Wiki · 刷机百科 - 用户贡献 [zh-cn]
2026-06-13T20:55:17Z
用户贡献
MediaWiki 1.41.0
https://wiki.uotan.cn/index.php?title=%E4%B8%BA%E6%96%B0%E8%AE%BE%E5%A4%87%E7%BC%96%E5%86%99Recovery_device_tree&diff=558
为新设备编写Recovery device tree
2024-02-20T08:37:18Z
<p>XiaoleGun：fixup</p>
<hr />
<div><br />
= 为新设备编写 Recovery 的设备树 =<br />
作者: Dark(xiaoleGun)<br />
<br />
时间: 2024.2.20<br />
<br />
协作者:<br />
<br />
== 一些自序 ==<br />
这篇教程中可能有些不对的地方，请各位指正，我也刚接触 Android 设备测开发两年，而且只有在节假日的时候有空一个人瞎捣鼓，为了<s>薅 mjw 羊毛</s>，故写这篇教程，而且我个人更推荐 Aosp Recovery 刷写第三方 ROM，TWRP 可能多多少少有些问题。Root 之类的不需要 TWRP 也可以，可以找到原机 boot 使用 Magisk 进行修补，也可以使用 KernelSU。另外我的语文功底不是很好，写不出辞藻，只能是北方地道的大白话，见谅哈 🤣///<br />
<br />
== 准备工作 ==<br />
1.一颗勇敢的、不怕困难的强大心脏。<br />
<br />
'''<s>两颗心好勇敢 -- Falling in love</s>'''<br />
<br />
2.电脑配置:<br />
{| class="wikitable"<br />
!硬件<br />
!需求<br />
|-<br />
|CPU<br />
|四核或更多<br />
|-<br />
|内存<br />
|8G 或更多<br />
|-<br />
|硬盘<br />
|至少 80G 空余空间<br />
|-<br />
|系统<br />
|WSL 或实体 Linux，建议 Debian 系<br />
|}<br />
3.足够的空闲时间。<br />
<br />
4.Vscode 和 🤏Linux 知识储备<br />
<br />
5.一台完好无损的新设备。<br />
<br />
6.设备原厂的 boot/recovery/vendor_boot 镜像。(推荐 recovery 分区，因为里面包含一些启动必须的.rc(run command)，如果没有该分区，寻找包含官方 recovery 内容的分区。值得注意的是部分设备 recovery 合并到了 boot 中，或是存在于 vendor_boot）<br />
<br />
7.查看自己的设备出厂 Android 版本并确定用途，是用于官方 ROM 还是第三方类原生。出厂版本为 9 及以上的可以使用 twrp-11 及以上分支，9 以下使用 twrp-9 分支。<br />
<br />
== 配置环境 ==<br />
<br />
=== 安装依赖 ===<br />
sudo apt update<br />
sudo apt-get install bc bison build-essential ccache curl flex g++-multilib gcc-multilib git gnupg gperf imagemagick lib32ncurses5-dev lib32readline-dev lib32z1-dev liblz4-tool libncurses5 libncurses5-dev libsdl1.2-dev libssl-dev libxml2 libxml2-utils lzop pngcrush rsync schedtool squashfs-tools xsltproc zip zlib1g-dev xattr openjdk-11-jdk jq android-sdk-libsparse-utils python3 python2 repo<br />
<br />
必要时可以阅读[https://source.android.com/source/using-repo?hl=zh-cn Git 和 Repo]<br />
<br />
=== 配置 Git 和 Repo ===<br />
安装完依赖后，在终端执行。<br />
git config --global user.name "your username"<br />
git config --global user.email "your email"<br />
<br />
=== 同步 TWRP 源码 ===<br />
在自己方便的地方，建立一个目录。<br />
mkdir twrp<br />
cd twrp<br />
根据自己在准备工作中确定的分支同步相应的源码。<br />
<br />
==== TWRP-9 ====<br />
repo init --depth=1 -u <nowiki>https://github.com/minimal-manifest-twrp/platform_manifest_twrp_omni.git</nowiki> -b twrp-9.0<br />
repo sync<br />
<br />
==== TWRP-11 ====<br />
repo init --depth=1 -u <nowiki>https://github.com/minimal-manifest-twrp/platform_manifest_twrp_aosp.git</nowiki> -b twrp-11<br />
repo sync<br />
<br />
==== TWRP-12.1 ====<br />
repo init --depth=1 -u <nowiki>https://github.com/minimal-manifest-twrp/platform_manifest_twrp_aosp.git</nowiki> -b twrp-12.1<br />
repo sync<br />
<br />
== 编写设备树 ==<br />
<blockquote>最基本的开机部分我通过 Redmi K50 做示例，并选取 TWRP-12.1 分支。<br />
<br />
解密部分会单独成一个章节并分为高通和联发科。</blockquote><br />
<br />
=== 获取资料 ===<br />
小米设备一般可以在[https://xiaomirom.com Xiaomirom]中的线刷包获取 boot/recovery/vendor_boot 镜像，其它设备请自行寻找。<br />
<br />
==== 安装工具和依赖 ====<br />
将准备工作中准备的 boot/recovery/vendor_boot 镜像解包，可以用任何工具，我这里使用[https://github.com/cfig/Android_boot_image_editor Android_boot_image_editor]按照自述文件进行依赖安装操作：<br />
<br />
===== Mac(Intel) =====<br />
brew install lz4 xz dtc openjdk@17<br />
echo 'export PATH="/usr/local/opt/openjdk@17/bin:$PATH"' >> ~/.zshrc<br />
source ~/.zshrc<br />
<br />
===== Linux: =====<br />
sudo apt update<br />
sudo apt install git device-tree-compiler lz4 xz-utils zlib1g-dev openjdk-17-jdk gcc g++ python3 python-is-python3 p7zip-full android-sdk-libsparse-utils erofs-utils<br />
<br />
===== Common: =====<br />
git clone <nowiki>https://github.com/cfig/Android_boot_image_editor</nowiki><br />
cd Android_boot_image_editor<br />
<br />
==== 解包 ====<br />
<blockquote>请注意"/"表示或的意思，请不要误以为是一个东西。<br />
<br />
如果不确定分区寻找的是否正确，请尝试将可以的分区进行解包，并查看其ramdisk内是否包含recovery字样的文件</blockquote>将你准备好的boot/recovery/vendor_boot复制到该目录，你可以使用 GUI 或者 CLI。如:<br />
cp <出厂boot/recovery/vendor_boot的绝对路径> boot/recovery/vendor_boot.img<br />
./gradlew unpack<br />
我这里以 Redmi K50 为例<br />
10:12:13.188 [main] INFO cfig.bootimg.v3.VendorBoot -<br />
Unpack Summary of vendor_boot.img<br />
┌───────────────────────────────────────┬──────────────────────────────────────┐<br />
│What │Where │<br />
└───────────────────────────────────────┴──────────────────────────────────────┘<br />
┌───────────────────────────────────────┬──────────────────────────────────────┐<br />
│image info │build/unzip_boot/vendor_boot.json │<br />
├───────────────────────────────────────┼──────────────────────────────────────┤<br />
│ramdisk │build/unzip_boot/ramdisk.img.lz4 │<br />
│-- PLATFORM ramdisk[1/1] │build/unzip_boot/ramdisk.1.lz4 │<br />
│------- extracted rootfs │build/unzip_boot/root.1 │<br />
├───────────────────────────────────────┼──────────────────────────────────────┤<br />
│dtb │build/unzip_boot/dtb │<br />
├───────────────────────────────────────┼──────────────────────────────────────┤<br />
│AVB info │build/unzip_boot/vendor_boot.avb.json │<br />
│\-- signing key │NONE │<br />
└───────────────────────────────────────┴──────────────────────────────────────┘<br />
10:12:13.213 [main] WARN cfig.packable.PackableLauncher - 'unpack' sequence completed<br />
<br />
BUILD SUCCESSFUL in 2s<br />
解包成功后终端会打印出以上信息，其中包含vendor_boot目录结构，我们只需要ramdisk里的部分内容就好了。<br />
ls build/unzip_boot/root.1 # 请根据自己的分区和设备判断ramdisk的命名，一般都直接是ramdisk<br />
不出意外的话会输出以下内容<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/dump/bootedit master ? ls build/unzip_boot/root.1<br />
acct oem<br />
apex plat_file_contexts<br />
bin plat_property_contexts<br />
bugreports postinstall<br />
config proc<br />
d product<br />
data product_file_contexts<br />
data_mirror product_property_contexts<br />
debug_ramdisk prop.default<br />
default.prop res<br />
dev sdcard<br />
etc second_stage_resources<br />
first_stage_ramdisk sepolicy<br />
init storage<br />
init.recovery.hardware.rc sys<br />
init.recovery.mt6895.rc system<br />
lib system_ext<br />
linkerconfig system_ext_file_contexts<br />
miui.factoryreset.fstab system_ext_property_contexts<br />
miui.factoryreset.rc tmp<br />
mnt vendor<br />
odm vendor_dlkm<br />
odm_dlkm vendor_file_contexts<br />
odm_file_contexts vendor_property_contexts<br />
odm_property_contexts<br />
如果包含 init.recovery*的字样，恭喜你成功找到了正确的分区。将这个目录复制到一个自己方便的地方。<br />
<br />
至此资料已经大致齐全了，解密的资料会在解密章节来讲解如何获取。<br />
<br />
=== 初始化目录结构 ===<br />
在 twrp 源码根目录输入<br />
mkdir -p device/vendor/codename<br />
mkdir -p device/vendor/codename/recovery/root<br />
cd device/vendor/codename<br />
vendor指的是供应商，如 xiaomi、oneplus、huawei、vivo、realme。<br />
<br />
codename指的是设备代号，小米设备可以在[https://xiaomirom.com Xiaomirom]查询，其它设备自行查询亦或是在开发者选项勾选 USB 调试通过 adb 尝试获取。<br />
adb shell getprop ro.product.manufacturer # 供应商<br />
adb shell getprop ro.product.device # 设备代号<br />
我的 Redmi K50 会打印以下信息<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/dump/bootedit master ? adb shell getprop ro.product.manufacturer<br />
Xiaomi # 无论打印出来的内容是大写还是小写，在目录结构中我们都采用小写<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/dump/bootedit master ? adb shell getprop ro.product.device<br />
rubens<br />
我的 IQOO NEO5 Lite 会打印以下信息<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/tmp/device/xiaomi/rubens adb shell getprop ro.product.manufacturer<br />
vivo<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/tmp/device/xiaomi/rubens adb shell getprop ro.product.device<br />
PD2118<br />
一般只要不是山寨机，小作坊出来的机子，用这两条命令应该是可以正确获取的。<br />
<br />
=== 初始化构建时必要的文件 ===<br />
无论是 AOSP device tree 亦或是 TWRP device tree 都基本类似于以下结构。<br />
/<br />
├── prebuilt (存放kernel、dtb等预编译文件) # AOSP device tree若使用build kernel则没有该目录<br />
├── recovery/root (存放一些.rc和解密blobs) # 一般用于Recovery device tree<br />
├── Android.mk (Android构建系统首先会检查每个目录的Android.mk，里面包含一些判断，由它包括其所在目录中所有Makefile)<br />
├── AndroidProducts.mk (声明产品的Makefile和lunch时可用的构建类型)<br />
├── BoardConfig.mk (板载配置文件，定义了主板必要的Flag)<br />
├── device.mk (声明设备所需的文件和模块)<br />
└── <ROM>_codename.mk (声明产品特定信息，例如名称、品牌和型号，引用device.mk等) # ROM就比如lineage、arrow等，编译twrp就直接写twrp，twrp-9分支要写onmi<br />
我们把这样的结构称为骨架树(skeleton tree)。<br />
<br />
接下来我们按照以上结构为自己的设备写一份 Recovery device tree。<br />
<br />
在终端使用touch命令创建必要的文件。<br />
touch Android.mk AndroidProducts.mk BoardConfig.mk device.mk twrp_rubens.mk<br />
ls .<br />
不出意外的话会打印出以下信息<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/tmp/device/xiaomi/rubens touch Android.mk AndroidProducts.mk BoardConfig.mk device.mk twrp_rubens.mk<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/tmp/device/xiaomi/rubens ls .<br />
Android.mk BoardConfig.mk prebuilt twrp_rubens.mk<br />
AndroidProducts.mk device.mk recovery<br />
可以下一步了~<br />
<br />
==== 初始 Android.mk 文件 ====<br />
打开 Vscode 并打开设备树目录，你足够强也可以使用 nano、vim 编辑。<br />
<br />
选中 Android.mk 并按照自己的资料复制并更改以下内容<br />
LOCAL_PATH := $(call my-dir)<br />
<br />
ifeq ($(TARGET_DEVICE),codename)<br />
include $(call all-subdir-makefiles,$(LOCAL_PATH))<br />
endif<br />
<br />
* codename是需要你修改的部分<br />
<br />
我修改后是这样的<br />
LOCAL_PATH := $(call my-dir)<br />
<br />
ifeq ($(TARGET_DEVICE),rubens)<br />
include $(call all-subdir-makefiles,$(LOCAL_PATH))<br />
endif<br />
<br />
==== 初始 AndroidProducts.mk 文件 ====<br />
选中 AndroidProducts.mk 并按照自己的资料复制并更改以下内容<br />
PRODUCT_MAKEFILES := \<br />
$(LOCAL_DIR)/<ROM>_<codename>.mk<br />
<br />
COMMON_LUNCH_CHOICES := \<br />
<ROM>_<codename>-eng<br />
我修改后是这样的<br />
PRODUCT_MAKEFILES := \<br />
$(LOCAL_DIR)/twrp_rubens.mk<br />
<br />
COMMON_LUNCH_CHOICES := \<br />
twrp_rubens-eng<br />
<br />
==== 初始 BoardConfig.mk 文件 ====<br />
<blockquote>将之前准备的ramdisk文件夹用新窗口打开 1.找到目录下的 prop.default 或含 prop 字样的文件。以下注释类似 ro.*.*的就是从 prop 中获取的 2.解包 boot/recovery/vendor_boot 的 json<br />
<br />
例如 build/unzip_boot/boot.json</blockquote>选中 BoardConfig.mk 并按照自己的资料复制并更改以下内容<br />
DEVICE_PATH := device/vendor/codename<br />
<br />
# Architecture<br />
TARGET_ARCH := arm64 # ro.bionic.arch<br />
TARGET_ARCH_VARIANT := armv8-a # 64位默认变体<br />
TARGET_CPU_ABI := arm64-v8a # ro.vendor.product.cpu.abilist64 (至少在小米设备上没有找到ro.product.cpu.abilist)<br />
TARGET_CPU_ABI2 := # 64位留空<br />
TARGET_CPU_VARIANT := generic # 默认一般都是通用<br />
TARGET_CPU_VARIANT_RUNTIME := cortex-a55 # ro.bionic.cpu_variant<br />
<br />
TARGET_2ND_ARCH := arm # ro.bionic.2nd_arch<br />
TARGET_2ND_ARCH_VARIANT := $(TARGET_ARCH_VARIANT)<br />
TARGET_2ND_CPU_ABI := armeabi-v7a # ro.vendor.product.cpu.abilist32第一个<br />
TARGET_2ND_CPU_ABI2 := armeabi # ro.vendor.product.cpu.abilist32第二个<br />
TARGET_2ND_CPU_VARIANT := $(TARGET_CPU_VARIANT)<br />
TARGET_2ND_CPU_VARIANT_RUNTIME := $(TARGET_CPU_VARIANT)<br />
<br />
# Assertation<br />
TARGET_OTA_ASSERT_DEVICE := rubens # codename<br />
<br />
# Bootloader<br />
TARGET_BOOTLOADER_BOARD_NAME := rubens # ro.product.board<br />
TARGET_NO_BOOTLOADER := true<br />
TARGET_USES_UEFI := true<br />
<br />
# Build Rule<br />
ALLOW_MISSING_DEPENDENCIES := true # 为了recovery不健全的依赖<br />
<br />
# Kernel - 注释会说明在boot/recovery/vendor_boot.json中对应的变量<br />
BOARD_BOOT_HEADER_VERSION := 4 # headerVersion<br />
BOARD_KERNEL_BASE := 0x3fff8000 # (kernelLoadAddr - 32KB) qcom设备base为0，且没有偏移(offset)<br />
BOARD_KERNEL_CMDLINE := bootopt=64S3,32N2,64N2 # cmdline<br />
BOARD_KERNEL_PAGESIZE := 4096 # pageSize<br />
BOARD_RAMDISK_OFFSET := 0x26f08000 # (ramdisk,loadAddr - BOARD_KERNEL_BASE)<br />
BOARD_KERNEL_TAGS_OFFSET := 0x07c88000 # (tagsLoadAddr - BOARD_KERNEL_BASE)<br />
BOARD_MKBOOTIMG_ARGS += --header_version $(BOARD_BOOT_HEADER_VERSION)<br />
BOARD_MKBOOTIMG_ARGS += --ramdisk_offset $(BOARD_RAMDISK_OFFSET)<br />
BOARD_MKBOOTIMG_ARGS += --tags_offset $(BOARD_KERNEL_TAGS_OFFSET)<br />
<br />
# Kernel - prebuilt<br />
TARGET_PREBUILT_KERNEL := $(DEVICE_PATH)/prebuilt/kernel # 预编译内核相对于android源码根目录的相对路径，vendor_boot机型不需要<br />
TARGET_PREBUILT_DTB := $(DEVICE_PATH)/prebuilt/dtb.img # 同上<br />
BOARD_MKBOOTIMG_ARGS += --dtb $(TARGET_PREBUILT_DTB)<br />
<br />
# Partitions<br />
BOARD_FLASH_BLOCK_SIZE := 262144 # (BOARD_KERNEL_PAGESIZE * 64)<br />
BOARD_BOOTIMAGE_PARTITION_SIZE := 67108864 # boot/recovery/vendor_boot镜像的字节大小需原厂或手机完整提取出来的，不定义会报错<br />
BOARD_RECOVERYIMAGE_PARTITION_SIZE := 67108864 # 同上<br />
BOARD_VENDOR_BOOTIMAGE_PARTITION_SIZE := 67108864 # 同上<br />
BOARD_SYSTEMIMAGE_PARTITION_TYPE := ext4 # 分区类型，查看ramdisk中fstab定义的类型<br />
BOARD_USERDATAIMAGE_FILE_SYSTEM_TYPE := ext4<br />
BOARD_VENDORIMAGE_FILE_SYSTEM_TYPE := ext4<br />
TARGET_COPY_OUT_VENDOR := vendor # 定义vendor目录，例如copy专有blobs要用<br />
BOARD_SUPER_PARTITION_SIZE := 9126805504 # 可以通过blockdev --getsize64 /dev/block/bootdevice/by-name/super获取，需root，如果无法root可以直接使用这个值，不影响twrp启动，可以后续修正<br />
BOARD_SUPER_PARTITION_GROUPS := xiaomi_dynamic_partitions # xiaomi根据你获取资料的vendor替换，是一个动态分区组<br />
BOARD_XIAOMI_DYNAMIC_PARTITIONS_PARTITION_LIST := system vendor product system_ext odm vendor_dlkm odm_dlkm # 根据fstab内的定义，一般flag包含logical都属于动态分区组的一部分<br />
BOARD_XIAOMI_DYNAMIC_PARTITIONS_SIZE := 9122611200 # (BOARD_SUPER_PARTITION_SIZE - 4MB)<br />
<br />
# Platform<br />
TARGET_BOARD_PLATFORM := mt6895 # ro.board.platform<br />
<br />
# Recovery - 基本通用的不影响启动<br />
BOARD_HAS_LARGE_FILESYSTEM := true<br />
TARGET_RECOVERY_PIXEL_FORMAT := RGBX_8888<br />
TARGET_USERIMAGES_USE_EXT4 := true<br />
TARGET_USERIMAGES_USE_F2FS := true<br />
<br />
# Treble<br />
BOARD_VNDK_VERSION := current # 声明VNDK版本<br />
<br />
# Vendor_boot recovery ramdisk<br />
BOARD_MOVE_RECOVERY_RESOURCES_TO_VENDOR_BOOT := true # 将recovery文件复制到vendor_boot<br />
<br />
# Boot recovery ramdisk<br />
#BOARD_USES_RECOVERY_AS_BOOT := true recovery ramdisk合并在boot中启用<br />
<br />
# Verified Boot<br />
BOARD_AVB_ENABLE := true<br />
BOARD_AVB_MAKE_VBMETA_IMAGE_ARGS += --flags 3<br />
<br />
# TWRP Configurations<br />
TW_DEFAULT_LANGUAGE := zh_CN # 默认为中文<br />
TW_EXTRA_LANGUAGES := true # 额外的语言<br />
TW_THEME := portrait_hdpi # 主题<br />
TW_INCLUDE_FASTBOOTD := true # 包括fastbootd，为动态分区<br />
<br />
# 其它flag还有很多，可以在https://xdaforums.com/t/twrp-flags-for-boardconfig-mk.3333970 查找，<br />
# 这篇文章也很老了，但我并不推荐twrp，所以flag我也不是很了解，多翻翻github:)<br />
<br />
# Debug<br />
TARGET_USES_LOGD := true # 调试flag<br />
TWRP_INCLUDE_LOGCAT := true<br />
无注释版<br />
DEVICE_PATH := device/vendor/codename<br />
<br />
# Architecture<br />
TARGET_ARCH := arm64<br />
TARGET_ARCH_VARIANT := armv8-a<br />
TARGET_CPU_ABI := arm64-v8a<br />
TARGET_CPU_ABI2 :=<br />
TARGET_CPU_VARIANT := generic<br />
TARGET_CPU_VARIANT_RUNTIME := cortex-a55<br />
<br />
TARGET_2ND_ARCH := arm<br />
TARGET_2ND_ARCH_VARIANT := $(TARGET_ARCH_VARIANT)<br />
TARGET_2ND_CPU_ABI := armeabi-v7a<br />
TARGET_2ND_CPU_ABI2 := armeabi<br />
TARGET_2ND_CPU_VARIANT := $(TARGET_CPU_VARIANT)<br />
TARGET_2ND_CPU_VARIANT_RUNTIME := $(TARGET_CPU_VARIANT)<br />
<br />
# Assertation<br />
TARGET_OTA_ASSERT_DEVICE := rubens<br />
<br />
# Bootloader<br />
TARGET_BOOTLOADER_BOARD_NAME := rubens<br />
TARGET_NO_BOOTLOADER := true<br />
TARGET_USES_UEFI := true<br />
<br />
# Build Rule<br />
ALLOW_MISSING_DEPENDENCIES := true<br />
<br />
# Kernel<br />
BOARD_BOOT_HEADER_VERSION := 4<br />
BOARD_KERNEL_BASE := 0x3fff8000<br />
BOARD_KERNEL_CMDLINE := bootopt=64S3,32N2,64N2<br />
BOARD_KERNEL_PAGESIZE := 4096<br />
BOARD_RAMDISK_OFFSET := 0x26f08000<br />
BOARD_KERNEL_TAGS_OFFSET := 0x07c88000<br />
BOARD_MKBOOTIMG_ARGS += --header_version $(BOARD_BOOT_HEADER_VERSION)<br />
BOARD_MKBOOTIMG_ARGS += --ramdisk_offset $(BOARD_RAMDISK_OFFSET)<br />
BOARD_MKBOOTIMG_ARGS += --tags_offset $(BOARD_KERNEL_TAGS_OFFSET)<br />
BOARD_KERNEL_IMAGE_NAME := Image<br />
<br />
# Kernel - prebuilt<br />
TARGET_PREBUILT_DTB := $(DEVICE_PATH)/prebuilt/dtb.img<br />
BOARD_MKBOOTIMG_ARGS += --dtb $(TARGET_PREBUILT_DTB)<br />
<br />
# Partitions<br />
BOARD_FLASH_BLOCK_SIZE := 262144<br />
BOARD_BOOTIMAGE_PARTITION_SIZE := 67108864<br />
BOARD_RECOVERYIMAGE_PARTITION_SIZE := 67108864<br />
BOARD_VENDOR_BOOTIMAGE_PARTITION_SIZE := 67108864<br />
BOARD_SYSTEMIMAGE_PARTITION_TYPE := ext4<br />
BOARD_USERDATAIMAGE_FILE_SYSTEM_TYPE := ext4<br />
BOARD_VENDORIMAGE_FILE_SYSTEM_TYPE := ext4<br />
TARGET_COPY_OUT_VENDOR := vendor<br />
BOARD_SUPER_PARTITION_SIZE := 9126805504<br />
BOARD_SUPER_PARTITION_GROUPS := xiaomi_dynamic_partitions<br />
BOARD_XIAOMI_DYNAMIC_PARTITIONS_PARTITION_LIST := system vendor product system_ext odm vendor_dlkm odm_dlkm<br />
BOARD_XIAOMI_DYNAMIC_PARTITIONS_SIZE := 9122611200<br />
<br />
# Platform<br />
TARGET_BOARD_PLATFORM := mt6895<br />
<br />
# Recovery<br />
BOARD_HAS_LARGE_FILESYSTEM := true<br />
TARGET_RECOVERY_PIXEL_FORMAT := RGBX_8888<br />
TARGET_USERIMAGES_USE_EXT4 := true<br />
TARGET_USERIMAGES_USE_F2FS := true<br />
<br />
# Treble<br />
BOARD_VNDK_VERSION := current<br />
<br />
# Vendor_boot recovery ramdisk<br />
BOARD_MOVE_RECOVERY_RESOURCES_TO_VENDOR_BOOT := true<br />
<br />
# Boot recovery ramdisk<br />
#BOARD_USES_RECOVERY_AS_BOOT := true<br />
<br />
# Verified Boot<br />
BOARD_AVB_ENABLE := true<br />
BOARD_AVB_MAKE_VBMETA_IMAGE_ARGS += --flags 3<br />
<br />
# TWRP Configurations<br />
TW_DEFAULT_LANGUAGE := zh_CN<br />
TW_EXTRA_LANGUAGES := true<br />
TW_THEME := portrait_hdpi<br />
TW_INCLUDE_FASTBOOTD := true<br />
<br />
# Debug<br />
TARGET_USES_LOGD := true<br />
TWRP_INCLUDE_LOGCAT := true<br />
这块写了好久我也不确定对不对，请各位指正，尤其是 Kernel 部分。<br />
<br />
==== 初始 device.mk 文件 ====<br />
<br />
* 准备好 prop.default<br />
<br />
选中 AndroidProducts.mk 并按照自己的资料复制并更改以下内容<br />
DEVICE_PATH := device/xiaomi/rubens<br />
<br />
# API<br />
PRODUCT_SHIPPING_API_LEVEL := 31 # ro.board.first_api_level<br />
<br />
# A/B<br />
AB_OTA_UPDATER := true # 启用A/B无缝更新<br />
AB_OTA_PARTITIONS += \ # 定义A/B分区，参考fstab<br />
boot \<br />
dtbo \<br />
system \<br />
product \<br />
vendor \<br />
odm \<br />
odm_dlkm \<br />
vbmeta \<br />
vendor_boot \<br />
vendor_dlkm \<br />
vbmeta_system \<br />
vbmeta_vendor<br />
<br />
PRODUCT_PACKAGES += \<br />
update_engine \<br />
update_engine_sideload \<br />
update_verifier \<br />
checkpoint_gc<br />
<br />
AB_OTA_POSTINSTALL_CONFIG += \<br />
RUN_POSTINSTALL_system=true \<br />
POSTINSTALL_PATH_system=system/bin/mtk_plpath_utils \<br />
FILESYSTEM_TYPE_system=ext4 \<br />
POSTINSTALL_OPTIONAL_system=true<br />
<br />
AB_OTA_POSTINSTALL_CONFIG += \<br />
RUN_POSTINSTALL_vendor=true \<br />
POSTINSTALL_PATH_vendor=bin/checkpoint_gc \<br />
FILESYSTEM_TYPE_vendor=ext4 \<br />
POSTINSTALL_OPTIONAL_vendor=true<br />
<br />
# Dynamic<br />
PRODUCT_USE_DYNAMIC_PARTITIONS := true # 动态分区<br />
<br />
# Soong namespaces<br />
PRODUCT_SOONG_NAMESPACES += $(DEVICE_PATH) # 命名空间<br />
<br />
* A/B 无缝更新部分高通和联发科不一样，联发科设备可以照抄，注意 system/bin/mtk_plpath_utils 就好。高通参考[https://github.com/sekaiacg/android_device_xiaomi_venus_TWRP/tree/android-13 venus twrp tree]，并且高通的[https://git.codelinaro.org/clo/la/platform/hardware/qcom/bootctrl bootctrl]和[https://git.codelinaro.org/clo/la/platform/vendor/qcom-opensource/recovery-ext gpt-utils]可以从 [[CLO]] 拿。<br />
<br />
无注释版<br />
PRODUCT_SHIPPING_API_LEVEL := 31<br />
<br />
# A/B<br />
AB_OTA_UPDATER := true<br />
AB_OTA_PARTITIONS += \<br />
boot \<br />
dtbo \<br />
system \<br />
product \<br />
vendor \<br />
odm \<br />
odm_dlkm \<br />
vbmeta \<br />
vendor_boot \<br />
vendor_dlkm \<br />
vbmeta_system \<br />
vbmeta_vendor<br />
<br />
PRODUCT_PACKAGES += \<br />
update_engine \<br />
update_engine_sideload \<br />
update_verifier \<br />
checkpoint_gc<br />
<br />
AB_OTA_POSTINSTALL_CONFIG += \<br />
RUN_POSTINSTALL_system=true \<br />
POSTINSTALL_PATH_system=system/bin/mtk_plpath_utils \<br />
FILESYSTEM_TYPE_system=ext4 \<br />
POSTINSTALL_OPTIONAL_system=true<br />
<br />
AB_OTA_POSTINSTALL_CONFIG += \<br />
RUN_POSTINSTALL_vendor=true \<br />
POSTINSTALL_PATH_vendor=bin/checkpoint_gc \<br />
FILESYSTEM_TYPE_vendor=ext4 \<br />
POSTINSTALL_OPTIONAL_vendor=true<br />
<br />
# Dynamic<br />
PRODUCT_USE_DYNAMIC_PARTITIONS := true<br />
<br />
# Soong namespaces<br />
PRODUCT_SOONG_NAMESPACES += $(DEVICE_PATH)<br />
<br />
==== 初始 twrp_rubens.mk 文件 ====<br />
选中 AndroidProducts.mk 并按照自己的资料复制并更改以下内容<br />
# Inherit from common AOSP config<br />
$(call inherit-product, $(SRC_TARGET_DIR)/product/base.mk)<br />
$(call inherit-product, $(SRC_TARGET_DIR)/product/core_64_bit_only.mk)<br />
$(call inherit-product, $(SRC_TARGET_DIR)/product/virtual_ab_ota/launch_with_vendor_ramdisk.mk) # vab加载到vendor boot里使用<br />
<br />
# Inherit from TWRP product configuration<br />
$(call inherit-product, vendor/twrp/config/common.mk) # twrp-9分支改为onmi<br />
<br />
# Device specific configs<br />
$(call inherit-product, device/xiaomi/rubens/device.mk)<br />
<br />
# Device identifier<br />
PRODUCT_DEVICE := rubens # 设备型号<br />
PRODUCT_NAME := twrp_rubens # 设备名称<br />
PRODUCT_BRAND := Redmi # 自定义品牌，如果有<br />
PRODUCT_MODEL := 22041211AC # 产品最终用户可见名称<br />
PRODUCT_MANUFACTURER := Xiaomi # 制造商<br />
<br />
PRODUCT_PROPERTY_OVERRIDES += ro.twrp.vendor_boot=true # 对twrp启动vendor_boot支持<br />
无注释版<br />
# Inherit from common AOSP config<br />
$(call inherit-product, $(SRC_TARGET_DIR)/product/base.mk)<br />
$(call inherit-product, $(SRC_TARGET_DIR)/product/core_64_bit_only.mk)<br />
$(call inherit-product, $(SRC_TARGET_DIR)/product/virtual_ab_ota/launch_with_vendor_ramdisk.mk) # vab加载到vendor boot里使用<br />
<br />
# Inherit from TWRP product configuration<br />
$(call inherit-product, vendor/twrp/config/common.mk)<br />
<br />
# Device specific configs<br />
$(call inherit-product, device/xiaomi/rubens/device.mk)<br />
<br />
# Device identifier<br />
PRODUCT_DEVICE := rubens<br />
PRODUCT_NAME := twrp_rubens<br />
PRODUCT_BRAND := Redmi<br />
PRODUCT_MODEL := 22041211AC<br />
PRODUCT_MANUFACTURER := Xiaomi<br />
<br />
PRODUCT_PROPERTY_OVERRIDES += ro.twrp.vendor_boot=true<br />
<br />
==== 初始 recovery 目录 ====<br />
<blockquote>拿出我们好久之前准备的 ramdisk 叭</blockquote>通过tree命令我们可以查看 ramdisk 的树状图，可以很清晰的查看包含的文件<br />
├── acct<br />
├── apex<br />
├── bin -> /system/bin<br />
├── bugreports -> /data/user_de/0/com.android.shell/files/bugreports<br />
├── config<br />
├── d -> /sys/kernel/debug<br />
├── data<br />
├── data_mirror<br />
├── debug_ramdisk<br />
├── default.prop -> prop.default<br />
├── dev<br />
├── etc -> /system/etc<br />
├── first_stage_ramdisk<br />
│ ├── fstab.emmc<br />
│ ├── fstab.mt6895<br />
│ └── system<br />
│ ├── bin<br />
│ │ ├── e2fsck<br />
│ │ ├── linker64<br />
│ │ ├── linker_asan64 -> linker64<br />
│ │ └── snapuserd<br />
│ └── lib64<br />
│ ├── ld-android.so<br />
│ ├── libbase.so<br />
│ ├── libc++.so<br />
│ ├── libc.so<br />
│ ├── libdl.so<br />
│ ├── libext2_blkid.so<br />
│ ├── libext2_com_err.so<br />
│ ├── libext2_e2p.so<br />
│ ├── libext2_quota.so<br />
│ ├── libext2_uuid.so<br />
│ ├── libext2fs.so<br />
│ ├── liblog.so<br />
│ ├── libm.so<br />
│ ├── libsparse.so<br />
│ └── libz.so<br />
├── init -> /system/bin/init<br />
├── init.recovery.hardware.rc<br />
├── init.recovery.mt6895.rc<br />
└── 等等等等...省略大概1000个文件吧<br />
<blockquote>因为避免教程时效性，我们尽可能选取 prebuilt 的办法，如 boot 和 mtk_plpath_utils 都采用预编译。</blockquote>里面有很多文件是没用的，整理一下，对我们有用的只有这些<br />
.<br />
├── first_stage_ramdisk<br />
│ ├── fstab.emmc<br />
│ └── fstab.mt6895<br />
├── init.recovery.mt6895.rc<br />
├── lib<br />
│ └── modules<br />
│ ├── 8250_mtk.ko<br />
│ ├── adapter_class.ko<br />
│ ├── adsp.ko<br />
│ ├── aee_aed.ko<br />
│ ├── aee_hangdet.ko<br />
│ ├── aee_rs.ko<br />
│ ├── blocktag.ko<br />
│ ├── bootprof.ko<br />
│ ├── bq28z610.ko<br />
│ ├── cache-parity.ko<br />
│ ├── cfg80211.ko<br />
│ ├── charger_class.ko<br />
│ └── 省略一百多个模块，这个目录里的东西全要<br />
└── system<br />
├── bin<br />
│ └── mtk_plpath_utils<br />
├── etc<br />
│ ├── init<br />
│ │ │── mtk-plpath-utils.rc<br />
│ │ └──hw<br />
│ │ └──init.rc<br />
│ ├── recovery.fstab<br />
│ ├── security<br />
│ │ └── otacerts.zip<br />
│ └── ueventd.rc<br />
└── lib64<br />
└── hw<br />
└── android.hardware.boot@1.0-impl-1.2-mtkimpl.so<br />
将它们按照以下操作复制<br />
<br />
* first_stage_ramdisk --> recovery/root/first_stage_ramdisk<br />
* init.recovery.mt6895.rc --> recovery/root/init.recovery.mt6895.rc<br />
* lib --> recovery/root/lib<br />
* system --> recovery/root/system (security 和 hw 文件夹里的内容作为备用，不要复制进去) 得到以下目录结构<br />
<br />
.<br />
├── Android.mk<br />
├── AndroidProducts.mk<br />
├── BoardConfig.mk<br />
├── device.mk<br />
├── prebuilt<br />
├── recovery<br />
│ └── root<br />
│ ├── first_stage_ramdisk<br />
│ │ ├── fstab.emmc<br />
│ │ └── fstab.mt6895<br />
│ ├── init.recovery.mt6895.rc<br />
│ ├── lib<br />
│ │ └── modules<br />
│ │ ├── 8250_mtk.ko<br />
│ │ ├── adapter_class.ko<br />
│ │ ├── adsp.ko<br />
│ │ ├── aee_aed.ko<br />
│ │ ├── aee_hangdet.ko<br />
│ │ ├── aee_rs.ko<br />
│ │ ├── blocktag.ko<br />
│ │ └── 省略....<br />
│ └── system<br />
│ ├── bin<br />
│ │ └── mtk_plpath_utils<br />
│ ├── etc<br />
│ │ ├── recovery.fstab<br />
│ │ └── ueventd.rc<br />
│ └── lib64<br />
│ └── hw<br />
│ └── android.hardware.boot@1.0-impl-1.2-mtkimpl.so<br />
└── twrp_rubens.mk<br />
打开 init.recovery.mt6895.rc 添加<br />
on boot<br />
start health-hal-2-1<br />
<br />
on post-fs<br />
start boot-hal-1-2<br />
例如<br />
on post-fs<br />
start boot-hal-1-2<br />
<br />
on init<br />
setprop sys.usb.configfs 1<br />
setprop sys.usb.controller "11201000.usb0"<br />
setprop sys.usb.ffs.aio_compat 1<br />
<br />
on fs && property:ro.debuggable=0<br />
# distinguish USB shoulde connect or not, i.e. CDP vs SDP<br />
# set charging free due to it wait for USB activation<br />
<br />
on boot<br />
start health-hal-2-1<br />
exec u:r:update_engine:s0 root root -- /system/bin/mtk_plpath_utils<br />
<br />
接下来可以开始编译咯~~<br />
<br />
==== 编译 ====<br />
<blockquote>编译前请检查注释是否全部删除</blockquote>twrp 源码根目录执行<br />
. build/envsetup.sh<br />
lunch twrp_codename-eng # twrp-9为onmi<br />
mka vendorbootimage/bootimage/recoveryimage<br />
不出意外的话一路绿灯，如果有报错的话请发邮箱至 1592501605@qq.com 咨询我<br />
<br />
产物在 out/target/product/codename/vendor_boot.img\boot.img\recovery.img<br />
<br />
手机重启到 fastboot 模式，使用 fastboot flash 刷写，例如<br />
fastboot flash vendor_boot /Users/xiaolegun/Downloads/vendor_boot.img<br />
则输出<br />
ERROR: could not clear input pipe; result e0005000, ignoring...<br />
ERROR: could not clear output pipe; result e0005000, ignoring....<br />
Sending 'vendor_boot_a' (65536 KB) OKAY [ 1.396s]<br />
Writing 'vendor_boot_a' OKAY [ 0.167s]<br />
Finished. Total time: 1.625s<br />
就可以重启按电源加音量上尝试了，我自己是一次点亮，但有 bug。<br />
<br />
==== 修 BUG ====<br />
<br />
===== 修复 USB =====<br />
我看到 twrp 控制台有很多报错，第一步肯定是先获取日志，使用logcat命令获取，在此之前先使用adb devices检测一下设备 usb 是否工作正常。<br />
xiaolegun@xiaoleGundeMac-Pro ~ adb devices ✔ 10208 10:05:31<br />
* daemon not running; starting now at tcp:5037<br />
* daemon started successfully<br />
List of devices attached<br />
可以看到adb没有检测到设备，原因一般是 usb 的配置不对，但 usb 是好的。这时可以尝试关闭 mtp，再开启，如果电脑有反应，那么就可以继续下一步了。<br />
<br />
在设备树中的 recovery/root，创建 init.recovery.usb.rc 的文件<br />
touch recovery/root/init.recovery.usb.rc<br />
并导入以下内容<br />
on property:sys.usb.config=mtp,adb<br />
start adbd<br />
<br />
on property:sys.usb.ffs.ready=1 && property:sys.usb.config=mtp,adb<br />
write /config/usb_gadget/g1/configs/b.1/strings/0x409/configuration "mtp_adb"<br />
rm /config/usb_gadget/g1/configs/b.1/f1<br />
rm /config/usb_gadget/g1/configs/b.1/f2<br />
rm /config/usb_gadget/g1/configs/b.1/f3<br />
rm /config/usb_gadget/g1/configs/b.1/f4<br />
rm /config/usb_gadget/g1/configs/b.1/f5<br />
write /config/usb_gadget/g1/idVendor 0x18d1<br />
write /config/usb_gadget/g1/idProduct 0x2d08<br />
symlink /config/usb_gadget/g1/functions/mtp.gs0 /config/usb_gadget/g1/configs/b.1/f1<br />
symlink /config/usb_gadget/g1/functions/ffs.adb /config/usb_gadget/g1/configs/b.1/f2<br />
write /config/usb_gadget/g1/UDC ${sys.usb.controller}<br />
setprop sys.usb.state ${sys.usb.config}<br />
这是我从我维护的 MI 6X 的 device tree 拿过来的，可以在联发科设备上正常工作。这段 shell 的大致意思就是在 usb 配置节点写入 mtp 和 adb 同时工作的字符串，这样 adb 就能顺利工作了。<br />
<br />
此外打开原厂 init.rc 修正一下 usb 设备的 id<br />
# MIUI ADD: START<br />
import /init.recovery.hardware.rc<br />
import /miui.factoryreset.rc<br />
# END<br />
import /init.recovery.${ro.hardware}.rc<br />
<br />
########### 省略一万字<br />
<br />
# MIUI ADD: START<br />
on property:sys.usb.config=mtp,adb && property:sys.usb.configfs=0<br />
write /sys/class/android_usb/android0/enable 0<br />
write /sys/class/android_usb/android0/idVendor 2717<br />
write /sys/class/android_usb/android0/idProduct 904D<br />
write /sys/class/android_usb/android0/functions mtp,adb<br />
write /sys/class/android_usb/android0/enable 1<br />
setprop sys.usb.state ${sys.usb.config}<br />
# END<br />
将/sys/class/android_usb/android0/idVendor和write /sys/class/android_usb/android0/idProduct后面的 id 分别替换到/config/usb_gadget/g1/idVendor和/config/usb_gadget/g1/idProduct处理完就是这样的。<br />
on property:sys.usb.config=mtp,adb<br />
start adbd<br />
<br />
on property:sys.usb.ffs.ready=1 && property:sys.usb.config=mtp,adb<br />
write /config/usb_gadget/g1/configs/b.1/strings/0x409/configuration "mtp_adb"<br />
rm /config/usb_gadget/g1/configs/b.1/f1<br />
rm /config/usb_gadget/g1/configs/b.1/f2<br />
rm /config/usb_gadget/g1/configs/b.1/f3<br />
rm /config/usb_gadget/g1/configs/b.1/f4<br />
rm /config/usb_gadget/g1/configs/b.1/f5<br />
write /config/usb_gadget/g1/idVendor 0x2717<br />
write /config/usb_gadget/g1/idProduct 0x904D<br />
symlink /config/usb_gadget/g1/functions/mtp.gs0 /config/usb_gadget/g1/configs/b.1/f1<br />
symlink /config/usb_gadget/g1/functions/ffs.adb /config/usb_gadget/g1/configs/b.1/f2<br />
write /config/usb_gadget/g1/UDC ${sys.usb.controller}<br />
setprop sys.usb.state ${sys.usb.config}<br />
接下来开机之后 adb 和 mtp 就能同时工作了。<br />
<br />
===== 修复 Resetprop =====<br />
接下来就可以修复其它 bug 了，我看到控制台有一堆红色的报错:<br />
E:Unknown File System:'/mi_ext'<br />
E:Unable to override 'external_storage.projid.enabled' due to missing libresetprop<br />
挂载“/data”失败(Invalid argument)<br />
这三个报错中第二个最好修，第一个次之，第三个与解密有关，放在另一个大章节讲。<br />
<br />
第二个报错只需要在 BoardConfig.mk 中添加<br />
# Tool<br />
TW_INCLUDE_RESETPROP := true<br />
TW_INCLUDE_LIBRESETPROP := true<br />
不用编译测试直接秒杀<br />
<br />
===== 修复挂载 =====<br />
E:Unknown File System:'/mi_ext'<br />
我们打开 recovery/root/system/etc 中的 recovery.fstab，发现里面有很多空格，我们先将它格式化一下，有实力的可以把后面的 flag 也对齐整理好。<br />
<br />
我比较没实力，简单格式化了一下，是这样的<br />
# 1 "vendor/mediatek/proprietary/hardware/fstab/mt6895/fstab.in.mt6895"<br />
# 1 "<built-in>" 1<br />
# 1 "<built-in>" 3<br />
# 341 "<built-in>" 3<br />
# 1 "<command line>" 1<br />
# 1 "<built-in>" 2<br />
# 1 "vendor/mediatek/proprietary/hardware/fstab/mt6895/fstab.in.mt6895" 2<br />
# 173 "vendor/mediatek/proprietary/hardware/fstab/mt6895/fstab.in.mt6895"<br />
system /system erofs ro wait,slotselect,avb=vbmeta_system,logical,first_stage_mount,avb_keys=/avb/q-gsi.avbpubkey:/avb/r-gsi.avbpubkey:/avb/s-gsi.avbpubkey<br />
system /system ext4 ro wait,slotselect,avb=vbmeta_system,logical,first_stage_mount,avb_keys=/avb/q-gsi.avbpubkey:/avb/r-gsi.avbpubkey:/avb/s-gsi.avbpubkey<br />
vendor /vendor erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
vendor /vendor ext4 ro wait,slotselect,avb,logical,first_stage_mount<br />
product /product erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
product /product ext4 ro wait,slotselect,avb,logical,first_stage_mount<br />
mi_ext /mnt/vendor/mi_ext erofs ro wait,slotselect,avb=vbmeta,logical,first_stage_mount,nofail<br />
mi_ext /mnt/vendor/mi_ext ext4 ro wait,slotselect,avb=vbmeta,logical,first_stage_mount,nofail<br />
/mnt/vendor/mi_ext /mi_ext none ro,bind wait,nofail<br />
overlay /product/overlay overlay ro,lowerdir=/mnt/vendor/mi_ext/product/overlay/:/product/overlay check,nofail<br />
overlay /product/app overlay ro,lowerdir=/mnt/vendor/mi_ext/product/app/:/product/app check,nofail<br />
overlay /product/priv-app overlay ro,lowerdir=/mnt/vendor/mi_ext/product/priv-app/:/product/priv-app check,nofail<br />
overlay /product/lib overlay ro,lowerdir=/mnt/vendor/mi_ext/product/lib/:/product/lib check,nofail<br />
overlay /product/lib64 overlay ro,lowerdir=/mnt/vendor/mi_ext/product/lib64/:/product/lib64 check,nofail<br />
overlay /product/bin overlay ro,lowerdir=/mnt/vendor/mi_ext/product/bin/:/product/bin check,nofail<br />
overlay /product/framework overlay ro,lowerdir=/mnt/vendor/mi_ext/product/framework/:/product/framework check,nofail<br />
overlay /product/media overlay ro,lowerdir=/mnt/vendor/mi_ext/product/media/:/product/media check,nofail<br />
overlay /product/opcust overlay ro,lowerdir=/mnt/vendor/mi_ext/product/opcust/:/product/opcust check,nofail<br />
overlay /product/data-app overlay ro,lowerdir=/mnt/vendor/mi_ext/product/data-app/:/product/data-app check,nofail<br />
overlay /product/etc/sysconfig overlay ro,lowerdir=/mnt/vendor/mi_ext/product/etc/sysconfig/:/product/etc/sysconfig check,nofail<br />
overlay /product/etc/permissions overlay ro,lowerdir=/mnt/vendor/mi_ext/product/etc/permissions/:/product/etc/permissions check,nofail<br />
overlay /system/app overlay ro,lowerdir=/mnt/vendor/mi_ext/system/app/:/product/pangu/system/app/:/system/app check,nofail<br />
overlay /system/priv-app overlay ro,lowerdir=/mnt/vendor/mi_ext/system/priv-app/:/product/pangu/system/priv-app/:/system/priv-app check,nofail<br />
overlay /system/framework overlay ro,lowerdir=/product/pangu/system/framework/:/system/framework check,nofail<br />
overlay /system/etc/sysconfig overlay ro,lowerdir=/mnt/vendor/mi_ext/system/etc/sysconfig/:/system/etc/sysconfig check,nofail<br />
overlay /system/etc/permissions overlay ro,lowerdir=/mnt/vendor/mi_ext/system/etc/permissions/:/product/pangu/system/etc/permissions/:/system/etc/permissions check,nofail<br />
system_ext /system_ext erofs ro wait,slotselect,avb=vbmeta_system,logical,first_stage_mount,avb_keys=/avb/q-gsi.avbpubkey:/avb/r-gsi.avbpubkey:/avb/s-gsi.avbpubkey<br />
system_ext /system_ext ext4 ro wait,slotselect,avb=vbmeta_system,logical,first_stage_mount,avb_keys=/avb/q-gsi.avbpubkey:/avb/r-gsi.avbpubkey:/avb/s-gsi.avbpubkey<br />
odm /odm erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
odm /odm ext4 ro wait,slotselect,avb,logical,first_stage_mount<br />
vendor_dlkm /vendor_dlkm erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
odm_dlkm /odm_dlkm erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
/dev/block/by-name/metadata /metadata ext4 noatime,nosuid,nodev,discard wait,check,formattable,first_stage_mount<br />
/dev/block/by-name/userdata /data f2fs noatime,nosuid,nodev,discard,noflush_merge,fsync_mode=nobarrier,reserve_root=134217,resgid=1065,checkpoint_merge,gc_merge,inlinecrypt wait,check,formattable,quota,latemount,resize,reservedsize=128m,checkpoint=fs,fileencryption=aes-256-xts:aes-256-cts:v2+inlinecrypt_optimized,keydirectory=/metadata/vold/metadata_encryption,fsverity<br />
/dev/block/by-name/rescue /cache ext4 noatime,nosuid,nodev,noauto_da_alloc,discard wait,check,formattable<br />
/dev/block/by-name/protect1 /mnt/vendor/protect_f ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/dev/block/by-name/protect2 /mnt/vendor/protect_s ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/dev/block/by-name/nvdata /mnt/vendor/nvdata ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/dev/block/by-name/nvcfg /mnt/vendor/nvcfg ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/dev/block/by-name/persist /mnt/vendor/persist ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/devices/platform/soc/11240000.mmc* auto auto defaults voldmanaged=sdcard1:auto,encryptable=userdata<br />
/devices/platform/usb_xhci* auto vfat defaults voldmanaged=usbotg:auto<br />
/devices/platform/soc/11201000.usb0/11200000.xhci* auto vfat defaults voldmanaged=usbotg:auto<br />
/dev/block/by-name/frp /persistent emmc defaults defaults<br />
/dev/block/by-name/nvram /nvram emmc defaults defaults<br />
/dev/block/by-name/proinfo /proinfo emmc defaults defaults<br />
/dev/block/by-name/lk /bootloader emmc defaults defaults<br />
/dev/block/by-name/lk2 /bootloader2 emmc defaults defaults<br />
/dev/block/by-name/para /para emmc defaults defaults<br />
/dev/block/by-name/misc /misc emmc defaults defaults<br />
/dev/block/by-name/boot /boot emmc defaults first_stage_mount,nofail,slotselect<br />
/dev/block/by-name/vbmeta_vendor /vbmeta_vendor emmc defaults first_stage_mount,nofail,slotselect<br />
/dev/block/by-name/vbmeta_system /vbmeta_system emmc defaults first_stage_mount,nofail,slotselect,avb=vbmeta<br />
/dev/block/by-name/logo /logo emmc defaults defaults<br />
/dev/block/by-name/expdb /expdb emmc defaults defaults<br />
/dev/block/by-name/seccfg /seccfg emmc defaults defaults<br />
/dev/block/by-name/tee1 /tee1 emmc defaults defaults<br />
/dev/block/by-name/tee2 /tee2 emmc defaults defaults<br />
/dev/block/by-name/scp1 /scp1 emmc defaults defaults<br />
/dev/block/by-name/scp2 /scp2 emmc defaults defaults<br />
/dev/block/by-name/sspm_1 /sspm_1 emmc defaults defaults<br />
/dev/block/by-name/sspm_2 /sspm_2 emmc defaults defaults<br />
/dev/block/by-name/dpm_1 /dpm_1 emmc defaults defaults<br />
/dev/block/by-name/dpm_2 /dpm_2 emmc defaults defaults<br />
/dev/block/by-name/mcupm_1 /mcupm_1 emmc defaults defaults<br />
/dev/block/by-name/mcupm_2 /mcupm_2 emmc defaults defaults<br />
/dev/block/by-name/md1img /md1img emmc defaults defaults<br />
/dev/block/by-name/md1dsp /md1dsp emmc defaults defaults<br />
/dev/block/by-name/md1arm7 /md1arm7 emmc defaults defaults<br />
/dev/block/by-name/md3img /md3img emmc defaults defaults<br />
/dev/block/by-name/gz1 /gz1 emmc defaults defaults<br />
/dev/block/by-name/gz2 /gz2 emmc defaults defaults<br />
/dev/block/by-name/spmfw /spmfw emmc defaults defaults<br />
/dev/block/by-name/audio_dsp /audio_dsp emmc defaults defaults<br />
/dev/block/by-name/pi_img /pi_img emmc defaults defaults<br />
/dev/block/by-name/boot_para /boot_para emmc defaults defaults<br />
/dev/block/by-name/odmdtbo /odmdtbo emmc defaults defaults<br />
/dev/block/by-name/dtbo /dtbo emmc defaults defaults<br />
/dev/block/by-name/otp /otp emmc defaults defaults<br />
/dev/block/by-name/vbmeta /vbmeta emmc defaults defaults<br />
这里面有很多无用分区，我们在 twrp 中操作不到，但是我也是第一次适配 MTK 设备，所以不“瞎说”误人子弟了，先把 bug 修好。<br />
<br />
像 xiaomi 这样常见的挂载错误，我自己一般都是尝试把/mnt/vendor 使用 vscode 全部删除，让我们尝试一下。并且要把这一行删除，这行在我看来是重复定义（？而且也没指定分区格式。<br />
/mnt/vendor/mi_ext /mi_ext none ro,bind wait,nofail<br />
整理完之后是这样的<br />
# 1 "vendor/mediatek/proprietary/hardware/fstab/mt6895/fstab.in.mt6895"<br />
# 1 "<built-in>" 1<br />
# 1 "<built-in>" 3<br />
# 341 "<built-in>" 3<br />
# 1 "<command line>" 1<br />
# 1 "<built-in>" 2<br />
# 1 "vendor/mediatek/proprietary/hardware/fstab/mt6895/fstab.in.mt6895" 2<br />
# 173 "vendor/mediatek/proprietary/hardware/fstab/mt6895/fstab.in.mt6895"<br />
system /system erofs ro wait,slotselect,avb=vbmeta_system,logical,first_stage_mount,avb_keys=/avb/q-gsi.avbpubkey:/avb/r-gsi.avbpubkey:/avb/s-gsi.avbpubkey<br />
system /system ext4 ro wait,slotselect,avb=vbmeta_system,logical,first_stage_mount,avb_keys=/avb/q-gsi.avbpubkey:/avb/r-gsi.avbpubkey:/avb/s-gsi.avbpubkey<br />
vendor /vendor erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
vendor /vendor ext4 ro wait,slotselect,avb,logical,first_stage_mount<br />
product /product erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
product /product ext4 ro wait,slotselect,avb,logical,first_stage_mount<br />
mi_ext /mi_ext erofs ro wait,slotselect,avb=vbmeta,logical,first_stage_mount,nofail<br />
mi_ext /mi_ext ext4 ro wait,slotselect,avb=vbmeta,logical,first_stage_mount,nofail<br />
overlay /product/overlay overlay ro,lowerdir=/mi_ext/product/overlay/:/product/overlay check,nofail<br />
overlay /product/app overlay ro,lowerdir=/mi_ext/product/app/:/product/app check,nofail<br />
overlay /product/priv-app overlay ro,lowerdir=/mi_ext/product/priv-app/:/product/priv-app check,nofail<br />
overlay /product/lib overlay ro,lowerdir=/mi_ext/product/lib/:/product/lib check,nofail<br />
overlay /product/lib64 overlay ro,lowerdir=/mi_ext/product/lib64/:/product/lib64 check,nofail<br />
overlay /product/bin overlay ro,lowerdir=/mi_ext/product/bin/:/product/bin check,nofail<br />
overlay /product/framework overlay ro,lowerdir=/mi_ext/product/framework/:/product/framework check,nofail<br />
overlay /product/media overlay ro,lowerdir=/mi_ext/product/media/:/product/media check,nofail<br />
overlay /product/opcust overlay ro,lowerdir=/mi_ext/product/opcust/:/product/opcust check,nofail<br />
overlay /product/data-app overlay ro,lowerdir=/mi_ext/product/data-app/:/product/data-app check,nofail<br />
overlay /product/etc/sysconfig overlay ro,lowerdir=/mi_ext/product/etc/sysconfig/:/product/etc/sysconfig check,nofail<br />
overlay /product/etc/permissions overlay ro,lowerdir=/mi_ext/product/etc/permissions/:/product/etc/permissions check,nofail<br />
overlay /system/app overlay ro,lowerdir=/mi_ext/system/app/:/product/pangu/system/app/:/system/app check,nofail<br />
overlay /system/priv-app overlay ro,lowerdir=/mi_ext/system/priv-app/:/product/pangu/system/priv-app/:/system/priv-app check,nofail<br />
overlay /system/framework overlay ro,lowerdir=/product/pangu/system/framework/:/system/framework check,nofail<br />
overlay /system/etc/sysconfig overlay ro,lowerdir=/mi_ext/system/etc/sysconfig/:/system/etc/sysconfig check,nofail<br />
overlay /system/etc/permissions overlay ro,lowerdir=/mi_ext/system/etc/permissions/:/product/pangu/system/etc/permissions/:/system/etc/permissions check,nofail<br />
system_ext /system_ext erofs ro wait,slotselect,avb=vbmeta_system,logical,first_stage_mount,avb_keys=/avb/q-gsi.avbpubkey:/avb/r-gsi.avbpubkey:/avb/s-gsi.avbpubkey<br />
system_ext /system_ext ext4 ro wait,slotselect,avb=vbmeta_system,logical,first_stage_mount,avb_keys=/avb/q-gsi.avbpubkey:/avb/r-gsi.avbpubkey:/avb/s-gsi.avbpubkey<br />
odm /odm erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
odm /odm ext4 ro wait,slotselect,avb,logical,first_stage_mount<br />
vendor_dlkm /vendor_dlkm erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
odm_dlkm /odm_dlkm erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
/dev/block/by-name/metadata /metadata ext4 noatime,nosuid,nodev,discard wait,check,formattable,first_stage_mount<br />
/dev/block/by-name/userdata /data f2fs noatime,nosuid,nodev,discard,noflush_merge,fsync_mode=nobarrier,reserve_root=134217,resgid=1065,checkpoint_merge,gc_merge,inlinecrypt wait,check,formattable,quota,latemount,resize,reservedsize=128m,checkpoint=fs,fileencryption=aes-256-xts:aes-256-cts:v2+inlinecrypt_optimized,keydirectory=/metadata/vold/metadata_encryption,fsverity<br />
/dev/block/by-name/rescue /cache ext4 noatime,nosuid,nodev,noauto_da_alloc,discard wait,check,formattable<br />
/dev/block/by-name/protect1 /protect_f ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/dev/block/by-name/protect2 /protect_s ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/dev/block/by-name/nvdata /nvdata ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/dev/block/by-name/nvcfg /nvcfg ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/dev/block/by-name/persist /persist ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/devices/platform/soc/11240000.mmc* auto auto defaults voldmanaged=sdcard1:auto,encryptable=userdata<br />
/devices/platform/usb_xhci* auto vfat defaults voldmanaged=usbotg:auto<br />
/devices/platform/soc/11201000.usb0/11200000.xhci* auto vfat defaults voldmanaged=usbotg:auto<br />
/dev/block/by-name/frp /persistent emmc defaults defaults<br />
/dev/block/by-name/nvram /nvram emmc defaults defaults<br />
/dev/block/by-name/proinfo /proinfo emmc defaults defaults<br />
/dev/block/by-name/lk /bootloader emmc defaults defaults<br />
/dev/block/by-name/lk2 /bootloader2 emmc defaults defaults<br />
/dev/block/by-name/para /para emmc defaults defaults<br />
/dev/block/by-name/misc /misc emmc defaults defaults<br />
/dev/block/by-name/boot /boot emmc defaults first_stage_mount,nofail,slotselect<br />
/dev/block/by-name/vbmeta_vendor /vbmeta_vendor emmc defaults first_stage_mount,nofail,slotselect<br />
/dev/block/by-name/vbmeta_system /vbmeta_system emmc defaults first_stage_mount,nofail,slotselect,avb=vbmeta<br />
/dev/block/by-name/logo /logo emmc defaults defaults<br />
/dev/block/by-name/expdb /expdb emmc defaults defaults<br />
/dev/block/by-name/seccfg /seccfg emmc defaults defaults<br />
/dev/block/by-name/tee1 /tee1 emmc defaults defaults<br />
/dev/block/by-name/tee2 /tee2 emmc defaults defaults<br />
/dev/block/by-name/scp1 /scp1 emmc defaults defaults<br />
/dev/block/by-name/scp2 /scp2 emmc defaults defaults<br />
/dev/block/by-name/sspm_1 /sspm_1 emmc defaults defaults<br />
/dev/block/by-name/sspm_2 /sspm_2 emmc defaults defaults<br />
/dev/block/by-name/dpm_1 /dpm_1 emmc defaults defaults<br />
/dev/block/by-name/dpm_2 /dpm_2 emmc defaults defaults<br />
/dev/block/by-name/mcupm_1 /mcupm_1 emmc defaults defaults<br />
/dev/block/by-name/mcupm_2 /mcupm_2 emmc defaults defaults<br />
/dev/block/by-name/md1img /md1img emmc defaults defaults<br />
/dev/block/by-name/md1dsp /md1dsp emmc defaults defaults<br />
/dev/block/by-name/md1arm7 /md1arm7 emmc defaults defaults<br />
/dev/block/by-name/md3img /md3img emmc defaults defaults<br />
/dev/block/by-name/gz1 /gz1 emmc defaults defaults<br />
/dev/block/by-name/gz2 /gz2 emmc defaults defaults<br />
/dev/block/by-name/spmfw /spmfw emmc defaults defaults<br />
/dev/block/by-name/audio_dsp /audio_dsp emmc defaults defaults<br />
/dev/block/by-name/pi_img /pi_img emmc defaults defaults<br />
/dev/block/by-name/boot_para /boot_para emmc defaults defaults<br />
/dev/block/by-name/odmdtbo /odmdtbo emmc defaults defaults<br />
/dev/block/by-name/dtbo /dtbo emmc defaults defaults<br />
/dev/block/by-name/otp /otp emmc defaults defaults<br />
/dev/block/by-name/vbmeta /vbmeta emmc defaults defaults<br />
让我们编译试一下，值得注意的是，twrp 每次更改最好删除 out 重新编译，不要使用如make installclean等命令，可能会开机黑屏或更改不生效。<br />
<br />
经过一分钟，编译好了，刷入，开机，启动！可以看见挂载成功被修好。<br />
<br />
===== 修复屏幕显示 =====<br />
可以看到我们现在屏幕的顶部的时间被摄像头挖孔挡住了。我们使用两个偏移 Flag 来修复它。<br />
<br />
在 BoardConfig.mk 中，加入以下 flag<br />
TW_Y_OFFSET := 106 #导航栏向上<br />
TW_H_OFFSET := -106 #界面整体向下<br />
<br />
===== 修复振动 =====<br />
<blockquote>仅供参考，研究半天发现只有解密功能正常才能修振动，不然会冻屏！！！<br />
<br />
不一定正确，也不一定普遍，仅供指路</blockquote>老设备一般都是正常的，不需要额外处理，新设备使用 aidl hal 需要我们自己处理一下让 service 正常工作。<br />
<br />
挂载 vendor，使用 twrp 的文件管理，在 vendor/etc/vintf/manifest 找到含有 vibrator 字样的文件。打开之后检查是否类似这样的文段<br />
<manifest version="1.0" type="device"><br />
<hal format="aidl" override="true"><br />
<name>android.hardware.vibrator</name><br />
<fqname>IVibrator/vibratorfeature</fqname><br />
</hal><br />
</manifest><br />
那恭喜你，找对了，我的文件名是<br />
<br />
vendor.xiaomi.hardware.vibratorfeature.service.xml<br />
<br />
将它使用adb pull放到电脑上自己方便的位置备用。<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/$/mjw adb pull /vendor/etc/vintf/manifest/vendor.xiaomi.hardware.vibratorfeature.service.xml .<br />
/vendor/etc/vintf/manifest/vendor.xiao...ipped. 0.2 MB/s (1718 bytes in 0.009s)<br />
不看扩展名，到 vendor/bin/hw/找到同名的 service 同样利用adb pull放电脑备用。比如我的叫<br />
<br />
vendor.xiaomi.hardware.vibratorfeature.service<br />
<br />
然后到 vendor/etc/init/找到同名.rc 文件，拉到电脑上，在里面加一条。并在定义 service 的最下面加上seclabel u:r:recovery:s0可以被 recovery 使用。<br />
on boot<br />
start service被定义的名字<br />
例如<br />
on post-fs-data<br />
chown system system /sys/bus/i2c/drivers/aw8697_haptic/2-005a/f0_save<br />
chown system system /sys/bus/i2c/drivers/aw8697_haptic/2-005a/osc_save<br />
chown system system /sys/bus/i2c/drivers/aw8697_haptic/3-005a/osc_save<br />
# 省略一万字<br />
<br />
on boot<br />
start vibratorfeature-hal-service<br />
<br />
service vibratorfeature-hal-service /vendor/bin/hw/vendor.xiaomi.hardware.vibratorfeature.service<br />
class hal<br />
user system<br />
group system input<br />
onrestart restart vibratorfeature<br />
seclabel u:r:recovery:s0<br />
此外这种新设备在内核里还有振动模块需要加载，请到/vendor/modules/1.1/中寻找，例如我这台设备是haptic.ko，用 adb pull 拉取到电脑上，然后<br />
<br />
* haptic.ko --> recovery/root/vendor/modules/1.1<br />
<br />
至此所有必要的资料就准备好了。可能开机后仍然不工作，需要抓取 log 补缺失的 library，当然这是后话了。<br />
<br />
开干！<br />
<br />
在 BoardConfig.mk 中加入以下 flag<br />
TW_SUPPORT_INPUT_AIDL_HAPTICS := true<br />
将备用文件按照以下操作复制<br />
<br />
* vendor.xiaomi.hardware.vibratorfeature.service.xml --> recovery/root/vendor/etc/vintf/manifest<br />
* vendor.xiaomi.hardware.vibratorfeature.service --> recovery/root/vendor/bin/hw<br />
* vendor.xiaomi.hardware.vibratorfeature.service.rc --> recovery/root/vendor/etc/init<br />
<br />
之后编译，刷入，开机，喜提冻屏......<br />
<br />
问题不大，使用adb logcat抓取日志<br />
adb logcat > log.log<br />
打开 log，搜索F linker、linker、library、beginning of crash这几个关键词，我搜索第一个就出来了。<br />
F linker : CANNOT LINK EXECUTABLE "/vendor/bin/hw/vendor.xiaomi.hardware.vibratorfeature.service": library "android.hardware.vibrator-V1-ndk_platform.so" not found: needed by main executable<br />
这段报错的意思就是vendor.xiaomi.hardware.vibratorfeature.service找不到android.hardware.vibrator-V1-ndk_platform.so这个库，所以无法正常工作。<br />
<br />
打开 BoardConfig.mk 加入以下 flag<br />
# Library<br />
TARGET_RECOVERY_DEVICE_MODULES += \<br />
android.hardware.vibrator-V1-ndk_platform.vendor<br />
<br />
TW_RECOVERY_ADDITIONAL_RELINK_LIBRARY_FILES += \<br />
$(TARGET_OUT_SHARED_LIBRARIES)/android.hardware.vibrator-V1-ndk_platform.so<br />
再次编译尝试<br />
<br />
开机之后依然冻屏，继续抓 log，查找<br />
F linker : CANNOT LINK EXECUTABLE "/vendor/bin/hw/vendor.xiaomi.hardware.vibratorfeature.service": library "vendor.hardware.vibratorfeature.IVibratorExt-V1-ndk_platform.so" not found: needed by main executable<br />
vendor.hardware.vibratorfeature字样和我们之前导入的文件长得差不多，一般都是供应商专有文件，所以去设备提取，路径在 vendor/lib64 里，虽然设备冻屏了，但我们可以用adb pull直接拉取到电脑。就像这样。<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/$/mjw adb shell mount /vendor<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/$/mjw adb pull /vendor/lib64/vendor.hardware.vibratorfeature.IVibratorExt-V1-ndk_platform.so .<br />
/vendor/lib64/vendor.hardware.vibratorfeature.IVi...led, 0 skipped. 14.7 MB/s (33552 bytes in 0.002s<br />
将这个文件按照以下提示操作<br />
<br />
* vendor.hardware.vibratorfeature.IVibratorExt-V1-ndk_platform.so --> recovery/root/vendor/lib64<br />
<br />
继续编译测试<br />
<br />
还是冻屏，继续抓 log<br />
F linker : CANNOT LINK EXECUTABLE "/vendor/bin/hw/vendor.xiaomi.hardware.vibratorfeature.service": library "libtinyalsa.so" not found: needed by main executable<br />
这个 library twrp 的源码中应该没有，去设备拿一个 prebuilt 吧<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/$/mjw adb shell mount /system_root<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/$/mjw adb pull /system_root/system/lib64/libtinyalsa.so .<br />
/system_root/system/lib64/libtinyalsa.so: 1 file ...led, 0 skipped. 13.6 MB/s (45032 bytes in 0.003s<br />
将这个文件按照以下提示操作<br />
<br />
* libtinyalsa.so --> recovery/root/system/lib64<br />
<br />
编译测试<br />
<br />
我艹了，还是冻屏，这次搜那几个关键词都搜不到了，搜vibrator看看这鬼东西报什么<br />
E vendor.xiaomi.hardware.vibratorfeature.service: fail to load lib : /vendor/lib64/libaachaptics.so<br />
这次都直接给路径了，直接拿。<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/$/mjw adb shell mount /vendor<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/$/mjw adb pull /vendor/lib64/libaachaptics.so .<br />
/vendor/lib64/libaachaptics.so: 1 file pulled, 0 skipped. 15.8 MB/s (56232 bytes in 0.003s)<br />
将这个文件按照以下提示操作<br />
<br />
* libaachaptics.so --> recovery/root/vendor/lib64<br />
<br />
至此应该没什么问题了，但是有个 flag 貌似要操作 data 内的东西，未解密会导致冻屏，所以等修完解密后再来修振动。<br />
<br />
==== 修复 CPU 温度 ====<br />
使用adb shell + grep命令在手机节点里搜索 type 关键词。<br />
xiaolegun@xiaoleGundeMac-Pro ~ adb shell 'grep "cp_master" /sys/class/thermal/*/type'<br />
/sys/class/thermal/thermal_zone54/type:cp_master<br />
xiaolegun@xiaoleGundeMac-Pro ~ adb shell 'grep "cpu" /sys/class/thermal/*/type'<br />
/sys/class/thermal/thermal_zone1/type:cpu_little1<br />
/sys/class/thermal/thermal_zone10/type:cpu_bigbig1<br />
/sys/class/thermal/thermal_zone11/type:cpu_big6<br />
/sys/class/thermal/thermal_zone12/type:cpu_bigbig2<br />
/sys/class/thermal/thermal_zone2/type:cpu_little2<br />
/sys/class/thermal/thermal_zone3/type:cpu_little3<br />
/sys/class/thermal/thermal_zone4/type:cpu_little4<br />
/sys/class/thermal/thermal_zone5/type:cpu_big1<br />
/sys/class/thermal/thermal_zone6/type:cpu_big2<br />
/sys/class/thermal/thermal_zone7/type:cpu_big3<br />
/sys/class/thermal/thermal_zone8/type:cpu_big4<br />
/sys/class/thermal/thermal_zone9/type:cpu_big5<br />
我这里选用cp_master节点来读取温度。我的节点路径为/sys/class/thermal/thermal_zone54在后面添加 temp 来读取温度，你可以使用cat来检测节点是否可以正常读取温度<br />
adb shell 'cat /sys/class/thermal/thermal_zone54/temp'<br />
如果返回如<br />
28000<br />
这种类似的数值，那多半是没有问题的。<br />
<br />
我们在 BoardConfig.mk 中加入<br />
TW_CUSTOM_CPU_TEMP_PATH := "/sys/class/thermal/thermal_zone54/temp"<br />
至此 cpu 温度就修复好了。<br />
<br />
== 后序 ==<br />
这是我玩 Android 两年内第一次写关于 Android 的文章，内容和措辞可能不是很准确，再加上开学焦虑，租房因租金和房源不顺利，写的很乱，请各位指正。<br />
<br />
此外有什么不懂得，多翻github，善用github搜索，多看看大佬们是怎么解决的。<br />
<br />
解密等有空补，先补作业。<br />
<br />
== 参考资料 ==<br />
[https://source.android.com/docs/setup/create/new-device?hl=zh-cn Google - 添加新设备]<br />
<br />
[https://source.android.com/docs/core/ota/ab?hl=zh-cn Google - A/B（无缝）系统更新]<br />
<br />
[https://blog.lynnrin.moe/posts/ROM-bringup-guide-prebuilt/#boardconfigmk Lynnrin - 快速上手 Android Custom ROM 适配 - Prebuilt Vendor]<br />
<br />
[https://source.android.com/docs/core/architecture/vintf?hl=zh-cn Google - 供应商接口对象]</div>
XiaoleGun
https://wiki.uotan.cn/index.php?title=%E4%B8%BA%E6%96%B0%E8%AE%BE%E5%A4%87%E7%BC%96%E5%86%99Recovery_device_tree&diff=556
为新设备编写Recovery device tree
2024-02-20T06:27:13Z
<p>XiaoleGun：fixup</p>
<hr />
<div><br />
= 为新设备编写 Recovery 的设备树 =<br />
作者: Dark(xiaoleGun)<br />
<br />
时间: 2024.2.20<br />
<br />
协作者:<br />
<br />
== 一些自序 ==<br />
这篇教程中可能有些不对的地方，请各位指正，我也刚接触 Android 设备测开发两年，而且只有在节假日的时候有空一个人瞎捣鼓，为了<s>薅 mjw 羊毛</s>，故写这篇教程，而且我个人更推荐 Aosp Recovery 刷写第三方 ROM，TWRP 可能多多少少有些问题。Root 之类的不需要 TWRP 也可以，可以找到原机 boot 使用 Magisk 进行修补，也可以使用 KernelSU。另外我的语文功底不是很好，写不出辞藻，只能是北方地道的大白话，见谅哈 🤣///<br />
<br />
== 准备工作 ==<br />
1.一颗勇敢的、不怕困难的强大心脏。<br />
<br />
'''<s>两颗心好勇敢 -- Falling in love</s>'''<br />
<br />
2.电脑配置:<br />
{| class="wikitable"<br />
!硬件<br />
!需求<br />
|-<br />
|CPU<br />
|四核或更多<br />
|-<br />
|内存<br />
|8G 或更多<br />
|-<br />
|硬盘<br />
|至少 80G 空余空间<br />
|-<br />
|系统<br />
|WSL 或实体 Linux，建议 Debian 系<br />
|}<br />
3.足够的空闲时间。<br />
<br />
4.Vscode 和 🤏Linux 知识储备<br />
<br />
5.一台完好无损的新设备。<br />
<br />
6.设备原厂的 boot/recovery/vendor_boot 镜像。(推荐 recovery 分区，因为里面包含一些启动必须的.rc(run command)，如果没有该分区，寻找包含官方 recovery 内容的分区。值得注意的是部分设备 recovery 合并到了 boot 中，或是存在于 vendor_boot）<br />
<br />
7.查看自己的设备出厂 Android 版本并确定用途，是用于官方 ROM 还是第三方类原生。出厂版本为 9 及以上的可以使用 twrp-11 及以上分支，9 以下使用 twrp-9 分支。<br />
<br />
== 配置环境 ==<br />
<br />
=== 安装依赖 ===<br />
sudo apt update<br />
sudo apt-get install bc bison build-essential ccache curl flex g++-multilib gcc-multilib git gnupg gperf imagemagick lib32ncurses5-dev lib32readline-dev lib32z1-dev liblz4-tool libncurses5 libncurses5-dev libsdl1.2-dev libssl-dev libxml2 libxml2-utils lzop pngcrush rsync schedtool squashfs-tools xsltproc zip zlib1g-dev xattr openjdk-11-jdk jq android-sdk-libsparse-utils python3 python2 repo<br />
<br />
必要时可以阅读[https://source.android.com/source/using-repo?hl=zh-cn Git 和 Repo]<br />
<br />
=== 配置 Git 和 Repo ===<br />
安装完依赖后，在终端执行。<br />
git config --global user.name "your username"<br />
git config --global user.email "your email"<br />
<br />
=== 同步 TWRP 源码 ===<br />
在自己方便的地方，建立一个目录。<br />
mkdir twrp<br />
cd twrp<br />
根据自己在准备工作中确定的分支同步相应的源码。<br />
<br />
==== TWRP-9 ====<br />
repo init --depth=1 -u <nowiki>https://github.com/minimal-manifest-twrp/platform_manifest_twrp_omni.git</nowiki> -b twrp-9.0<br />
repo sync<br />
<br />
==== TWRP-11 ====<br />
repo init --depth=1 -u <nowiki>https://github.com/minimal-manifest-twrp/platform_manifest_twrp_aosp.git</nowiki> -b twrp-11<br />
repo sync<br />
<br />
==== TWRP-12.1 ====<br />
repo init --depth=1 -u <nowiki>https://github.com/minimal-manifest-twrp/platform_manifest_twrp_aosp.git</nowiki> -b twrp-12.1<br />
repo sync<br />
<br />
== 编写设备树 ==<br />
<blockquote>最基本的开机部分我通过 Redmi K50 做示例，并选取 TWRP-12.1 分支。<br />
<br />
解密部分会单独成一个章节并分为高通和联发科。</blockquote><br />
<br />
=== 获取资料 ===<br />
小米设备一般可以在[https://xiaomirom.com Xiaomirom]中的线刷包获取 boot/recovery/vendor_boot 镜像，其它设备请自行寻找。<br />
<br />
==== 安装工具和依赖 ====<br />
将准备工作中准备的 boot/recovery/vendor_boot 镜像解包，可以用任何工具，我这里使用[https://github.com/cfig/Android_boot_image_editor Android_boot_image_editor]按照自述文件进行依赖安装操作：<br />
<br />
===== Mac(Intel) =====<br />
brew install lz4 xz dtc openjdk@17<br />
echo 'export PATH="/usr/local/opt/openjdk@17/bin:$PATH"' >> ~/.zshrc<br />
source ~/.zshrc<br />
<br />
===== Linux: =====<br />
sudo apt update<br />
sudo apt install git device-tree-compiler lz4 xz-utils zlib1g-dev openjdk-17-jdk gcc g++ python3 python-is-python3 p7zip-full android-sdk-libsparse-utils erofs-utils<br />
<br />
===== Common: =====<br />
git clone <nowiki>https://github.com/cfig/Android_boot_image_editor</nowiki><br />
cd Android_boot_image_editor<br />
<br />
==== 解包 ====<br />
<blockquote>请注意"/"表示或的意思，请不要误以为是一个东西。<br />
<br />
如果不确定分区寻找的是否正确，请尝试将可以的分区进行解包，并查看其ramdisk内是否包含recovery字样的文件</blockquote>将你准备好的boot/recovery/vendor_boot复制到该目录，你可以使用 GUI 或者 CLI。如:<br />
cp <出厂boot/recovery/vendor_boot的绝对路径> boot/recovery/vendor_boot.img<br />
./gradlew unpack<br />
我这里以 Redmi K50 为例<br />
10:12:13.188 [main] INFO cfig.bootimg.v3.VendorBoot -<br />
Unpack Summary of vendor_boot.img<br />
┌───────────────────────────────────────┬──────────────────────────────────────┐<br />
│What │Where │<br />
└───────────────────────────────────────┴──────────────────────────────────────┘<br />
┌───────────────────────────────────────┬──────────────────────────────────────┐<br />
│image info │build/unzip_boot/vendor_boot.json │<br />
├───────────────────────────────────────┼──────────────────────────────────────┤<br />
│ramdisk │build/unzip_boot/ramdisk.img.lz4 │<br />
│-- PLATFORM ramdisk[1/1] │build/unzip_boot/ramdisk.1.lz4 │<br />
│------- extracted rootfs │build/unzip_boot/root.1 │<br />
├───────────────────────────────────────┼──────────────────────────────────────┤<br />
│dtb │build/unzip_boot/dtb │<br />
├───────────────────────────────────────┼──────────────────────────────────────┤<br />
│AVB info │build/unzip_boot/vendor_boot.avb.json │<br />
│\-- signing key │NONE │<br />
└───────────────────────────────────────┴──────────────────────────────────────┘<br />
10:12:13.213 [main] WARN cfig.packable.PackableLauncher - 'unpack' sequence completed<br />
<br />
BUILD SUCCESSFUL in 2s<br />
解包成功后终端会打印出以上信息，其中包含vendor_boot目录结构，我们只需要ramdisk里的部分内容就好了。<br />
ls build/unzip_boot/root.1 # 请根据自己的分区和设备判断ramdisk的命名，一般都直接是ramdisk<br />
不出意外的话会输出以下内容<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/dump/bootedit master ? ls build/unzip_boot/root.1<br />
acct oem<br />
apex plat_file_contexts<br />
bin plat_property_contexts<br />
bugreports postinstall<br />
config proc<br />
d product<br />
data product_file_contexts<br />
data_mirror product_property_contexts<br />
debug_ramdisk prop.default<br />
default.prop res<br />
dev sdcard<br />
etc second_stage_resources<br />
first_stage_ramdisk sepolicy<br />
init storage<br />
init.recovery.hardware.rc sys<br />
init.recovery.mt6895.rc system<br />
lib system_ext<br />
linkerconfig system_ext_file_contexts<br />
miui.factoryreset.fstab system_ext_property_contexts<br />
miui.factoryreset.rc tmp<br />
mnt vendor<br />
odm vendor_dlkm<br />
odm_dlkm vendor_file_contexts<br />
odm_file_contexts vendor_property_contexts<br />
odm_property_contexts<br />
如果包含 init.recovery*的字样，恭喜你成功找到了正确的分区。将这个目录复制到一个自己方便的地方。<br />
<br />
至此资料已经大致齐全了，解密的资料会在解密章节来讲解如何获取。<br />
<br />
=== 初始化目录结构 ===<br />
在 twrp 源码根目录输入<br />
mkdir -p device/vendor/codename<br />
mkdir -p device/vendor/codename/recovery/root<br />
cd device/vendor/codename<br />
vendor指的是供应商，如 xiaomi、oneplus、huawei、vivo、realme。<br />
<br />
codename指的是设备代号，小米设备可以在[https://xiaomirom.com Xiaomirom]查询，其它设备自行查询亦或是在开发者选项勾选 USB 调试通过 adb 尝试获取。<br />
adb shell getprop ro.product.manufacturer # 供应商<br />
adb shell getprop ro.product.device # 设备代号<br />
我的 Redmi K50 会打印以下信息<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/dump/bootedit master ? adb shell getprop ro.product.manufacturer<br />
Xiaomi # 无论打印出来的内容是大写还是小写，在目录结构中我们都采用小写<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/dump/bootedit master ? adb shell getprop ro.product.device<br />
rubens<br />
我的 IQOO NEO5 Lite 会打印以下信息<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/tmp/device/xiaomi/rubens adb shell getprop ro.product.manufacturer<br />
vivo<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/tmp/device/xiaomi/rubens adb shell getprop ro.product.device<br />
PD2118<br />
一般只要不是山寨机，小作坊出来的机子，用这两条命令应该是可以正确获取的。<br />
<br />
=== 初始化构建时必要的文件 ===<br />
无论是 AOSP device tree 亦或是 TWRP device tree 都基本类似于以下结构。<br />
/<br />
├── prebuilt (存放kernel、dtb等预编译文件) # AOSP device tree若使用build kernel则没有该目录<br />
├── recovery/root (存放一些.rc和解密blobs) # 一般用于Recovery device tree<br />
├── Android.mk (Android构建系统首先会检查每个目录的Android.mk，里面包含一些判断，由它包括其所在目录中所有Makefile)<br />
├── AndroidProducts.mk (声明产品的Makefile和lunch时可用的构建类型)<br />
├── BoardConfig.mk (板载配置文件，定义了主板必要的Flag)<br />
├── device.mk (声明设备所需的文件和模块)<br />
└── <ROM>_codename.mk (声明产品特定信息，例如名称、品牌和型号，引用device.mk等) # ROM就比如lineage、arrow等，编译twrp就直接写twrp，twrp-9分支要写onmi<br />
我们把这样的结构称为骨架树(skeleton tree)。<br />
<br />
接下来我们按照以上结构为自己的设备写一份 Recovery device tree。<br />
<br />
在终端使用touch命令创建必要的文件。<br />
touch Android.mk AndroidProducts.mk BoardConfig.mk device.mk twrp_rubens.mk<br />
ls .<br />
不出意外的话会打印出以下信息<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/tmp/device/xiaomi/rubens touch Android.mk AndroidProducts.mk BoardConfig.mk device.mk twrp_rubens.mk<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/tmp/device/xiaomi/rubens ls .<br />
Android.mk BoardConfig.mk prebuilt twrp_rubens.mk<br />
AndroidProducts.mk device.mk recovery<br />
可以下一步了~<br />
<br />
==== 初始 Android.mk 文件 ====<br />
打开 Vscode 并打开设备树目录，你足够强也可以使用 nano、vim 编辑。<br />
<br />
选中 Android.mk 并按照自己的资料复制并更改以下内容<br />
LOCAL_PATH := $(call my-dir)<br />
<br />
ifeq ($(TARGET_DEVICE),codename)<br />
include $(call all-subdir-makefiles,$(LOCAL_PATH))<br />
endif<br />
<br />
* codename是需要你修改的部分<br />
<br />
我修改后是这样的<br />
LOCAL_PATH := $(call my-dir)<br />
<br />
ifeq ($(TARGET_DEVICE),rubens)<br />
include $(call all-subdir-makefiles,$(LOCAL_PATH))<br />
endif<br />
<br />
==== 初始 AndroidProducts.mk 文件 ====<br />
选中 AndroidProducts.mk 并按照自己的资料复制并更改以下内容<br />
PRODUCT_MAKEFILES := \<br />
$(LOCAL_DIR)/<ROM>_<codename>.mk<br />
<br />
COMMON_LUNCH_CHOICES := \<br />
<ROM>_<codename>-eng<br />
我修改后是这样的<br />
PRODUCT_MAKEFILES := \<br />
$(LOCAL_DIR)/twrp_rubens.mk<br />
<br />
COMMON_LUNCH_CHOICES := \<br />
twrp_rubens-eng<br />
<br />
==== 初始 BoardConfig.mk 文件 ====<br />
<blockquote>将之前准备的ramdisk文件夹用新窗口打开 1.找到目录下的 prop.default 或含 prop 字样的文件。以下注释类似 ro.*.*的就是从 prop 中获取的 2.解包 boot/recovery/vendor_boot 的 json<br />
<br />
例如 build/unzip_boot/boot.json</blockquote>选中 BoardConfig.mk 并按照自己的资料复制并更改以下内容<br />
DEVICE_PATH := device/vendor/codename<br />
<br />
# Architecture<br />
TARGET_ARCH := arm64 # ro.bionic.arch<br />
TARGET_ARCH_VARIANT := armv8-a # 64位默认变体<br />
TARGET_CPU_ABI := arm64-v8a # ro.vendor.product.cpu.abilist64 (至少在小米设备上没有找到ro.product.cpu.abilist)<br />
TARGET_CPU_ABI2 := # 64位留空<br />
TARGET_CPU_VARIANT := generic # 默认一般都是通用<br />
TARGET_CPU_VARIANT_RUNTIME := cortex-a55 # ro.bionic.cpu_variant<br />
<br />
TARGET_2ND_ARCH := arm # ro.bionic.2nd_arch<br />
TARGET_2ND_ARCH_VARIANT := $(TARGET_ARCH_VARIANT)<br />
TARGET_2ND_CPU_ABI := armeabi-v7a # ro.vendor.product.cpu.abilist32第一个<br />
TARGET_2ND_CPU_ABI2 := armeabi # ro.vendor.product.cpu.abilist32第二个<br />
TARGET_2ND_CPU_VARIANT := $(TARGET_CPU_VARIANT)<br />
TARGET_2ND_CPU_VARIANT_RUNTIME := $(TARGET_CPU_VARIANT)<br />
<br />
# Assertation<br />
TARGET_OTA_ASSERT_DEVICE := rubens # codename<br />
<br />
# Bootloader<br />
TARGET_BOOTLOADER_BOARD_NAME := rubens # ro.product.board<br />
TARGET_NO_BOOTLOADER := true<br />
TARGET_USES_UEFI := true<br />
<br />
# Build Rule<br />
ALLOW_MISSING_DEPENDENCIES := true # 为了recovery不健全的依赖<br />
<br />
# Kernel - 注释会说明在boot/recovery/vendor_boot.json中对应的变量<br />
BOARD_BOOT_HEADER_VERSION := 4 # headerVersion<br />
BOARD_KERNEL_BASE := 0x3fff8000 # (kernelLoadAddr - 32KB) qcom设备base为0，且没有偏移(offset)<br />
BOARD_KERNEL_CMDLINE := bootopt=64S3,32N2,64N2 # cmdline<br />
BOARD_KERNEL_PAGESIZE := 4096 # pageSize<br />
BOARD_RAMDISK_OFFSET := 0x26f08000 # (ramdisk,loadAddr - BOARD_KERNEL_BASE)<br />
BOARD_KERNEL_TAGS_OFFSET := 0x07c88000 # (tagsLoadAddr - BOARD_KERNEL_BASE)<br />
BOARD_MKBOOTIMG_ARGS += --header_version $(BOARD_BOOT_HEADER_VERSION)<br />
BOARD_MKBOOTIMG_ARGS += --ramdisk_offset $(BOARD_RAMDISK_OFFSET)<br />
BOARD_MKBOOTIMG_ARGS += --tags_offset $(BOARD_KERNEL_TAGS_OFFSET)<br />
<br />
# Kernel - prebuilt<br />
TARGET_PREBUILT_KERNEL := $(DEVICE_PATH)/prebuilt/kernel # 预编译内核相对于android源码根目录的相对路径，vendor_boot机型不需要<br />
TARGET_PREBUILT_DTB := $(DEVICE_PATH)/prebuilt/dtb.img # 同上<br />
BOARD_MKBOOTIMG_ARGS += --dtb $(TARGET_PREBUILT_DTB)<br />
<br />
# Partitions<br />
BOARD_FLASH_BLOCK_SIZE := 262144 # (BOARD_KERNEL_PAGESIZE * 64)<br />
BOARD_BOOTIMAGE_PARTITION_SIZE := 67108864 # boot/recovery/vendor_boot镜像的字节大小需原厂或手机完整提取出来的，不定义会报错<br />
BOARD_RECOVERYIMAGE_PARTITION_SIZE := 67108864 # 同上<br />
BOARD_VENDOR_ROOTIMAGE_PARTITION_SIZE := 67108864 # 同上<br />
BOARD_SYSTEMIMAGE_PARTITION_TYPE := ext4 # 分区类型，查看ramdisk中fstab定义的类型<br />
BOARD_USERDATAIMAGE_FILE_SYSTEM_TYPE := ext4<br />
BOARD_VENDORIMAGE_FILE_SYSTEM_TYPE := ext4<br />
TARGET_COPY_OUT_VENDOR := vendor # 定义vendor目录，例如copy专有blobs要用<br />
BOARD_SUPER_PARTITION_SIZE := 9126805504 # 可以通过blockdev --getsize64 /dev/block/bootdevice/by-name/super获取，需root，如果无法root可以直接使用这个值，不影响twrp启动，可以后续修正<br />
BOARD_SUPER_PARTITION_GROUPS := xiaomi_dynamic_partitions # xiaomi根据你获取资料的vendor替换，是一个动态分区组<br />
BOARD_XIAOMI_DYNAMIC_PARTITIONS_PARTITION_LIST := system vendor product system_ext odm vendor_dlkm odm_dlkm # 根据fstab内的定义，一般flag包含logical都属于动态分区组的一部分<br />
BOARD_XIAOMI_DYNAMIC_PARTITIONS_SIZE := 9122611200 # (BOARD_SUPER_PARTITION_SIZE - 4MB)<br />
<br />
# Platform<br />
TARGET_BOARD_PLATFORM := mt6895 # ro.board.platform<br />
<br />
# Recovery - 基本通用的不影响启动<br />
BOARD_HAS_LARGE_FILESYSTEM := true<br />
TARGET_RECOVERY_PIXEL_FORMAT := RGBX_8888<br />
TARGET_USERIMAGES_USE_EXT4 := true<br />
TARGET_USERIMAGES_USE_F2FS := true<br />
<br />
# Treble<br />
BOARD_VNDK_VERSION := current # 声明VNDK版本<br />
<br />
# Vendor_boot recovery ramdisk<br />
BOARD_MOVE_RECOVERY_RESOURCES_TO_VENDOR_BOOT := true # 将recovery文件复制到vendor_boot<br />
<br />
# Boot recovery ramdisk<br />
#BOARD_USES_RECOVERY_AS_BOOT := true recovery ramdisk合并在boot中启用<br />
<br />
# Verified Boot<br />
BOARD_AVB_ENABLE := true<br />
BOARD_AVB_MAKE_VBMETA_IMAGE_ARGS += --flags 3<br />
<br />
# TWRP Configurations<br />
TW_DEFAULT_LANGUAGE := zh_CN # 默认为中文<br />
TW_EXTRA_LANGUAGES := true # 额外的语言<br />
TW_THEME := portrait_hdpi # 主题<br />
TW_INCLUDE_FASTBOOTD := true # 包括fastbootd，为动态分区<br />
<br />
# 其它flag还有很多，可以在https://xdaforums.com/t/twrp-flags-for-boardconfig-mk.3333970 查找，<br />
# 这篇文章也很老了，但我并不推荐twrp，所以flag我也不是很了解，多翻翻github:)<br />
<br />
# Debug<br />
TARGET_USES_LOGD := true # 调试flag<br />
TWRP_INCLUDE_LOGCAT := true<br />
无注释版<br />
DEVICE_PATH := device/vendor/codename<br />
<br />
# Architecture<br />
TARGET_ARCH := arm64<br />
TARGET_ARCH_VARIANT := armv8-a<br />
TARGET_CPU_ABI := arm64-v8a<br />
TARGET_CPU_ABI2 :=<br />
TARGET_CPU_VARIANT := generic<br />
TARGET_CPU_VARIANT_RUNTIME := cortex-a55<br />
<br />
TARGET_2ND_ARCH := arm<br />
TARGET_2ND_ARCH_VARIANT := $(TARGET_ARCH_VARIANT)<br />
TARGET_2ND_CPU_ABI := armeabi-v7a<br />
TARGET_2ND_CPU_ABI2 := armeabi<br />
TARGET_2ND_CPU_VARIANT := $(TARGET_CPU_VARIANT)<br />
TARGET_2ND_CPU_VARIANT_RUNTIME := $(TARGET_CPU_VARIANT)<br />
<br />
# Assertation<br />
TARGET_OTA_ASSERT_DEVICE := rubens<br />
<br />
# Bootloader<br />
TARGET_BOOTLOADER_BOARD_NAME := rubens<br />
TARGET_NO_BOOTLOADER := true<br />
TARGET_USES_UEFI := true<br />
<br />
# Build Rule<br />
ALLOW_MISSING_DEPENDENCIES := true<br />
<br />
# Kernel<br />
BOARD_BOOT_HEADER_VERSION := 4<br />
BOARD_KERNEL_BASE := 0x3fff8000<br />
BOARD_KERNEL_CMDLINE := bootopt=64S3,32N2,64N2<br />
BOARD_KERNEL_PAGESIZE := 4096<br />
BOARD_RAMDISK_OFFSET := 0x26f08000<br />
BOARD_KERNEL_TAGS_OFFSET := 0x07c88000<br />
BOARD_MKBOOTIMG_ARGS += --header_version $(BOARD_BOOT_HEADER_VERSION)<br />
BOARD_MKBOOTIMG_ARGS += --ramdisk_offset $(BOARD_RAMDISK_OFFSET)<br />
BOARD_MKBOOTIMG_ARGS += --tags_offset $(BOARD_KERNEL_TAGS_OFFSET)<br />
BOARD_KERNEL_IMAGE_NAME := Image<br />
<br />
# Kernel - prebuilt<br />
TARGET_PREBUILT_DTB := $(DEVICE_PATH)/prebuilt/dtb.img<br />
BOARD_MKBOOTIMG_ARGS += --dtb $(TARGET_PREBUILT_DTB)<br />
<br />
# Partitions<br />
BOARD_FLASH_BLOCK_SIZE := 262144<br />
BOARD_BOOTIMAGE_PARTITION_SIZE := 67108864<br />
BOARD_RECOVERYIMAGE_PARTITION_SIZE := 67108864<br />
BOARD_VENDOR_ROOTIMAGE_PARTITION_SIZE := 67108864<br />
BOARD_SYSTEMIMAGE_PARTITION_TYPE := ext4<br />
BOARD_USERDATAIMAGE_FILE_SYSTEM_TYPE := ext4<br />
BOARD_VENDORIMAGE_FILE_SYSTEM_TYPE := ext4<br />
TARGET_COPY_OUT_VENDOR := vendor<br />
BOARD_SUPER_PARTITION_SIZE := 9126805504<br />
BOARD_SUPER_PARTITION_GROUPS := xiaomi_dynamic_partitions<br />
BOARD_XIAOMI_DYNAMIC_PARTITIONS_PARTITION_LIST := system vendor product system_ext odm vendor_dlkm odm_dlkm<br />
BOARD_XIAOMI_DYNAMIC_PARTITIONS_SIZE := 9122611200<br />
<br />
# Platform<br />
TARGET_BOARD_PLATFORM := mt6895<br />
<br />
# Recovery<br />
BOARD_HAS_LARGE_FILESYSTEM := true<br />
TARGET_RECOVERY_PIXEL_FORMAT := RGBX_8888<br />
TARGET_USERIMAGES_USE_EXT4 := true<br />
TARGET_USERIMAGES_USE_F2FS := true<br />
<br />
# Treble<br />
BOARD_VNDK_VERSION := current<br />
<br />
# Vendor_boot recovery ramdisk<br />
BOARD_MOVE_RECOVERY_RESOURCES_TO_VENDOR_BOOT := true<br />
<br />
# Boot recovery ramdisk<br />
#BOARD_USES_RECOVERY_AS_BOOT := true<br />
<br />
# Verified Boot<br />
BOARD_AVB_ENABLE := true<br />
BOARD_AVB_MAKE_VBMETA_IMAGE_ARGS += --flags 3<br />
<br />
# TWRP Configurations<br />
TW_DEFAULT_LANGUAGE := zh_CN<br />
TW_EXTRA_LANGUAGES := true<br />
TW_THEME := portrait_hdpi<br />
TW_INCLUDE_FASTBOOTD := true<br />
<br />
# Debug<br />
TARGET_USES_LOGD := true<br />
TWRP_INCLUDE_LOGCAT := true<br />
这块写了好久我也不确定对不对，请各位指正，尤其是 Kernel 部分。<br />
<br />
==== 初始 device.mk 文件 ====<br />
<br />
* 准备好 prop.default<br />
<br />
选中 AndroidProducts.mk 并按照自己的资料复制并更改以下内容<br />
DEVICE_PATH := device/xiaomi/rubens<br />
<br />
# API<br />
PRODUCT_SHIPPING_API_LEVEL := 31 # ro.board.first_api_level<br />
<br />
# A/B<br />
AB_OTA_UPDATER := true # 启用A/B无缝更新<br />
AB_OTA_PARTITIONS += \ # 定义A/B分区，参考fstab<br />
boot \<br />
dtbo \<br />
system \<br />
product \<br />
vendor \<br />
odm \<br />
odm_dlkm \<br />
vbmeta \<br />
vendor_boot \<br />
vendor_dlkm \<br />
vbmeta_system \<br />
vbmeta_vendor<br />
<br />
PRODUCT_PACKAGES += \<br />
update_engine \<br />
update_engine_sideload \<br />
update_verifier \<br />
checkpoint_gc<br />
<br />
AB_OTA_POSTINSTALL_CONFIG += \<br />
RUN_POSTINSTALL_system=true \<br />
POSTINSTALL_PATH_system=system/bin/mtk_plpath_utils \<br />
FILESYSTEM_TYPE_system=ext4 \<br />
POSTINSTALL_OPTIONAL_system=true<br />
<br />
AB_OTA_POSTINSTALL_CONFIG += \<br />
RUN_POSTINSTALL_vendor=true \<br />
POSTINSTALL_PATH_vendor=bin/checkpoint_gc \<br />
FILESYSTEM_TYPE_vendor=ext4 \<br />
POSTINSTALL_OPTIONAL_vendor=true<br />
<br />
# Dynamic<br />
PRODUCT_USE_DYNAMIC_PARTITIONS := true # 动态分区<br />
<br />
# Soong namespaces<br />
PRODUCT_SOONG_NAMESPACES += $(DEVICE_PATH) # 命名空间<br />
<br />
* A/B 无缝更新部分高通和联发科不一样，联发科设备可以照抄，注意 system/bin/mtk_plpath_utils 就好。高通参考[https://github.com/sekaiacg/android_device_xiaomi_venus_TWRP/tree/android-13 venus twrp tree]，并且高通的[https://git.codelinaro.org/clo/la/platform/hardware/qcom/bootctrl bootctrl]和[https://git.codelinaro.org/clo/la/platform/vendor/qcom-opensource/recovery-ext gpt-utils]可以从 [[CLO]] 拿。<br />
<br />
无注释版<br />
PRODUCT_SHIPPING_API_LEVEL := 31<br />
<br />
# A/B<br />
AB_OTA_UPDATER := true<br />
AB_OTA_PARTITIONS += \<br />
boot \<br />
dtbo \<br />
system \<br />
product \<br />
vendor \<br />
odm \<br />
odm_dlkm \<br />
vbmeta \<br />
vendor_boot \<br />
vendor_dlkm \<br />
vbmeta_system \<br />
vbmeta_vendor<br />
<br />
PRODUCT_PACKAGES += \<br />
update_engine \<br />
update_engine_sideload \<br />
update_verifier \<br />
checkpoint_gc<br />
<br />
AB_OTA_POSTINSTALL_CONFIG += \<br />
RUN_POSTINSTALL_system=true \<br />
POSTINSTALL_PATH_system=system/bin/mtk_plpath_utils \<br />
FILESYSTEM_TYPE_system=ext4 \<br />
POSTINSTALL_OPTIONAL_system=true<br />
<br />
AB_OTA_POSTINSTALL_CONFIG += \<br />
RUN_POSTINSTALL_vendor=true \<br />
POSTINSTALL_PATH_vendor=bin/checkpoint_gc \<br />
FILESYSTEM_TYPE_vendor=ext4 \<br />
POSTINSTALL_OPTIONAL_vendor=true<br />
<br />
# Dynamic<br />
PRODUCT_USE_DYNAMIC_PARTITIONS := true<br />
<br />
# Soong namespaces<br />
PRODUCT_SOONG_NAMESPACES += $(DEVICE_PATH)<br />
<br />
==== 初始 twrp_rubens.mk 文件 ====<br />
选中 AndroidProducts.mk 并按照自己的资料复制并更改以下内容<br />
# Inherit from common AOSP config<br />
$(call inherit-product, $(SRC_TARGET_DIR)/product/base.mk)<br />
$(call inherit-product, $(SRC_TARGET_DIR)/product/core_64_bit_only.mk)<br />
$(call inherit-product, $(SRC_TARGET_DIR)/product/virtual_ab_ota/launch_with_vendor_ramdisk.mk) # vab加载到vendor boot里使用<br />
<br />
# Inherit from TWRP product configuration<br />
$(call inherit-product, vendor/twrp/config/common.mk) # twrp-9分支改为onmi<br />
<br />
# Device specific configs<br />
$(call inherit-product, device/xiaomi/rubens/device.mk)<br />
<br />
# Device identifier<br />
PRODUCT_DEVICE := rubens # 设备型号<br />
PRODUCT_NAME := twrp_rubens # 设备名称<br />
PRODUCT_BRAND := Redmi # 自定义品牌，如果有<br />
PRODUCT_MODEL := 22041211AC # 产品最终用户可见名称<br />
PRODUCT_MANUFACTURER := Xiaomi # 制造商<br />
<br />
PRODUCT_PROPERTY_OVERRIDES += ro.twrp.vendor_boot=true # 对twrp启动vendor_boot支持<br />
无注释版<br />
# Inherit from common AOSP config<br />
$(call inherit-product, $(SRC_TARGET_DIR)/product/base.mk)<br />
$(call inherit-product, $(SRC_TARGET_DIR)/product/core_64_bit_only.mk)<br />
$(call inherit-product, $(SRC_TARGET_DIR)/product/virtual_ab_ota/launch_with_vendor_ramdisk.mk) # vab加载到vendor boot里使用<br />
<br />
# Inherit from TWRP product configuration<br />
$(call inherit-product, vendor/twrp/config/common.mk)<br />
<br />
# Device specific configs<br />
$(call inherit-product, device/xiaomi/rubens/device.mk)<br />
<br />
# Device identifier<br />
PRODUCT_DEVICE := rubens<br />
PRODUCT_NAME := twrp_rubens<br />
PRODUCT_BRAND := Redmi<br />
PRODUCT_MODEL := 22041211AC<br />
PRODUCT_MANUFACTURER := Xiaomi<br />
<br />
PRODUCT_PROPERTY_OVERRIDES += ro.twrp.vendor_boot=true<br />
<br />
==== 初始 recovery 目录 ====<br />
<blockquote>拿出我们好久之前准备的 ramdisk 叭</blockquote>通过tree命令我们可以查看 ramdisk 的树状图，可以很清晰的查看包含的文件<br />
├── acct<br />
├── apex<br />
├── bin -> /system/bin<br />
├── bugreports -> /data/user_de/0/com.android.shell/files/bugreports<br />
├── config<br />
├── d -> /sys/kernel/debug<br />
├── data<br />
├── data_mirror<br />
├── debug_ramdisk<br />
├── default.prop -> prop.default<br />
├── dev<br />
├── etc -> /system/etc<br />
├── first_stage_ramdisk<br />
│ ├── fstab.emmc<br />
│ ├── fstab.mt6895<br />
│ └── system<br />
│ ├── bin<br />
│ │ ├── e2fsck<br />
│ │ ├── linker64<br />
│ │ ├── linker_asan64 -> linker64<br />
│ │ └── snapuserd<br />
│ └── lib64<br />
│ ├── ld-android.so<br />
│ ├── libbase.so<br />
│ ├── libc++.so<br />
│ ├── libc.so<br />
│ ├── libdl.so<br />
│ ├── libext2_blkid.so<br />
│ ├── libext2_com_err.so<br />
│ ├── libext2_e2p.so<br />
│ ├── libext2_quota.so<br />
│ ├── libext2_uuid.so<br />
│ ├── libext2fs.so<br />
│ ├── liblog.so<br />
│ ├── libm.so<br />
│ ├── libsparse.so<br />
│ └── libz.so<br />
├── init -> /system/bin/init<br />
├── init.recovery.hardware.rc<br />
├── init.recovery.mt6895.rc<br />
└── 等等等等...省略大概1000个文件吧<br />
<blockquote>因为避免教程时效性，我们尽可能选取 prebuilt 的办法，如 boot 和 mtk_plpath_utils 都采用预编译。</blockquote>里面有很多文件是没用的，整理一下，对我们有用的只有这些<br />
.<br />
├── first_stage_ramdisk<br />
│ ├── fstab.emmc<br />
│ └── fstab.mt6895<br />
├── init.recovery.mt6895.rc<br />
├── lib<br />
│ └── modules<br />
│ ├── 8250_mtk.ko<br />
│ ├── adapter_class.ko<br />
│ ├── adsp.ko<br />
│ ├── aee_aed.ko<br />
│ ├── aee_hangdet.ko<br />
│ ├── aee_rs.ko<br />
│ ├── blocktag.ko<br />
│ ├── bootprof.ko<br />
│ ├── bq28z610.ko<br />
│ ├── cache-parity.ko<br />
│ ├── cfg80211.ko<br />
│ ├── charger_class.ko<br />
│ └── 省略一百多个模块，这个目录里的东西全要<br />
└── system<br />
├── bin<br />
│ └── mtk_plpath_utils<br />
├── etc<br />
│ ├── init<br />
│ │ │── mtk-plpath-utils.rc<br />
│ │ └──hw<br />
│ │ └──init.rc<br />
│ ├── recovery.fstab<br />
│ ├── security<br />
│ │ └── otacerts.zip<br />
│ └── ueventd.rc<br />
└── lib64<br />
└── hw<br />
└── android.hardware.boot@1.0-impl-1.2-mtkimpl.so<br />
将它们按照以下操作复制<br />
<br />
* first_stage_ramdisk --> recovery/root/first_stage_ramdisk<br />
* init.recovery.mt6895.rc --> recovery/root/init.recovery.mt6895.rc<br />
* lib --> recovery/root/lib<br />
* system --> recovery/root/system (security 和 hw 文件夹里的内容作为备用，不要复制进去) 得到以下目录结构<br />
<br />
.<br />
├── Android.mk<br />
├── AndroidProducts.mk<br />
├── BoardConfig.mk<br />
├── device.mk<br />
├── prebuilt<br />
├── recovery<br />
│ └── root<br />
│ ├── first_stage_ramdisk<br />
│ │ ├── fstab.emmc<br />
│ │ └── fstab.mt6895<br />
│ ├── init.recovery.mt6895.rc<br />
│ ├── lib<br />
│ │ └── modules<br />
│ │ ├── 8250_mtk.ko<br />
│ │ ├── adapter_class.ko<br />
│ │ ├── adsp.ko<br />
│ │ ├── aee_aed.ko<br />
│ │ ├── aee_hangdet.ko<br />
│ │ ├── aee_rs.ko<br />
│ │ ├── blocktag.ko<br />
│ │ └── 省略....<br />
│ └── system<br />
│ ├── bin<br />
│ │ └── mtk_plpath_utils<br />
│ ├── etc<br />
│ │ ├── recovery.fstab<br />
│ │ └── ueventd.rc<br />
│ └── lib64<br />
│ └── hw<br />
│ └── android.hardware.boot@1.0-impl-1.2-mtkimpl.so<br />
└── twrp_rubens.mk<br />
打开 init.recovery.mt6895.rc 添加<br />
on boot<br />
start health-hal-2-1<br />
<br />
on post-fs<br />
start boot-hal-1-2<br />
例如<br />
on post-fs<br />
start boot-hal-1-2<br />
<br />
on init<br />
setprop sys.usb.configfs 1<br />
setprop sys.usb.controller "11201000.usb0"<br />
setprop sys.usb.ffs.aio_compat 1<br />
<br />
on fs && property:ro.debuggable=0<br />
# distinguish USB shoulde connect or not, i.e. CDP vs SDP<br />
# set charging free due to it wait for USB activation<br />
<br />
on boot<br />
start health-hal-2-1<br />
exec u:r:update_engine:s0 root root -- /system/bin/mtk_plpath_utils<br />
<br />
接下来可以开始编译咯~~<br />
<br />
==== 编译 ====<br />
<blockquote>编译前请检查注释是否全部删除</blockquote>twrp 源码根目录执行<br />
. build/envsetup.sh<br />
lunch twrp_codename-eng # twrp-9为onmi<br />
mka vendorbootimage/bootimage/recoveryimage<br />
不出意外的话一路绿灯，如果有报错的话请发邮箱至 1592501605@qq.com 咨询我<br />
<br />
产物在 out/target/product/codename/vendor_boot.img\boot.img\recovery.img<br />
<br />
手机重启到 fastboot 模式，使用 fastboot flash 刷写，例如<br />
fastboot flash vendor_boot /Users/xiaolegun/Downloads/vendor_boot.img<br />
则输出<br />
ERROR: could not clear input pipe; result e0005000, ignoring...<br />
ERROR: could not clear output pipe; result e0005000, ignoring....<br />
Sending 'vendor_boot_a' (65536 KB) OKAY [ 1.396s]<br />
Writing 'vendor_boot_a' OKAY [ 0.167s]<br />
Finished. Total time: 1.625s<br />
就可以重启按电源加音量上尝试了，我自己是一次点亮，但有 bug。<br />
<br />
==== 修 BUG ====<br />
<br />
===== 修复 USB =====<br />
我看到 twrp 控制台有很多报错，第一步肯定是先获取日志，使用logcat命令获取，在此之前先使用adb devices检测一下设备 usb 是否工作正常。<br />
xiaolegun@xiaoleGundeMac-Pro ~ adb devices ✔ 10208 10:05:31<br />
* daemon not running; starting now at tcp:5037<br />
* daemon started successfully<br />
List of devices attached<br />
可以看到adb没有检测到设备，原因一般是 usb 的配置不对，但 usb 是好的。这时可以尝试关闭 mtp，再开启，如果电脑有反应，那么就可以继续下一步了。<br />
<br />
在设备树中的 recovery/root，创建 init.recovery.usb.rc 的文件<br />
touch recovery/root/init.recovery.usb.rc<br />
并导入以下内容<br />
on property:sys.usb.config=mtp,adb<br />
start adbd<br />
<br />
on property:sys.usb.ffs.ready=1 && property:sys.usb.config=mtp,adb<br />
write /config/usb_gadget/g1/configs/b.1/strings/0x409/configuration "mtp_adb"<br />
rm /config/usb_gadget/g1/configs/b.1/f1<br />
rm /config/usb_gadget/g1/configs/b.1/f2<br />
rm /config/usb_gadget/g1/configs/b.1/f3<br />
rm /config/usb_gadget/g1/configs/b.1/f4<br />
rm /config/usb_gadget/g1/configs/b.1/f5<br />
write /config/usb_gadget/g1/idVendor 0x18d1<br />
write /config/usb_gadget/g1/idProduct 0x2d08<br />
symlink /config/usb_gadget/g1/functions/mtp.gs0 /config/usb_gadget/g1/configs/b.1/f1<br />
symlink /config/usb_gadget/g1/functions/ffs.adb /config/usb_gadget/g1/configs/b.1/f2<br />
write /config/usb_gadget/g1/UDC ${sys.usb.controller}<br />
setprop sys.usb.state ${sys.usb.config}<br />
这是我从我维护的 MI 6X 的 device tree 拿过来的，可以在联发科设备上正常工作。这段 shell 的大致意思就是在 usb 配置节点写入 mtp 和 adb 同时工作的字符串，这样 adb 就能顺利工作了。<br />
<br />
此外打开原厂 init.rc 修正一下 usb 设备的 id<br />
# MIUI ADD: START<br />
import /init.recovery.hardware.rc<br />
import /miui.factoryreset.rc<br />
# END<br />
import /init.recovery.${ro.hardware}.rc<br />
<br />
########### 省略一万字<br />
<br />
# MIUI ADD: START<br />
on property:sys.usb.config=mtp,adb && property:sys.usb.configfs=0<br />
write /sys/class/android_usb/android0/enable 0<br />
write /sys/class/android_usb/android0/idVendor 2717<br />
write /sys/class/android_usb/android0/idProduct 904D<br />
write /sys/class/android_usb/android0/functions mtp,adb<br />
write /sys/class/android_usb/android0/enable 1<br />
setprop sys.usb.state ${sys.usb.config}<br />
# END<br />
将/sys/class/android_usb/android0/idVendor和write /sys/class/android_usb/android0/idProduct后面的 id 分别替换到/config/usb_gadget/g1/idVendor和/config/usb_gadget/g1/idProduct处理完就是这样的。<br />
on property:sys.usb.config=mtp,adb<br />
start adbd<br />
<br />
on property:sys.usb.ffs.ready=1 && property:sys.usb.config=mtp,adb<br />
write /config/usb_gadget/g1/configs/b.1/strings/0x409/configuration "mtp_adb"<br />
rm /config/usb_gadget/g1/configs/b.1/f1<br />
rm /config/usb_gadget/g1/configs/b.1/f2<br />
rm /config/usb_gadget/g1/configs/b.1/f3<br />
rm /config/usb_gadget/g1/configs/b.1/f4<br />
rm /config/usb_gadget/g1/configs/b.1/f5<br />
write /config/usb_gadget/g1/idVendor 0x2717<br />
write /config/usb_gadget/g1/idProduct 0x904D<br />
symlink /config/usb_gadget/g1/functions/mtp.gs0 /config/usb_gadget/g1/configs/b.1/f1<br />
symlink /config/usb_gadget/g1/functions/ffs.adb /config/usb_gadget/g1/configs/b.1/f2<br />
write /config/usb_gadget/g1/UDC ${sys.usb.controller}<br />
setprop sys.usb.state ${sys.usb.config}<br />
接下来开机之后 adb 和 mtp 就能同时工作了。<br />
<br />
===== 修复 Resetprop =====<br />
接下来就可以修复其它 bug 了，我看到控制台有一堆红色的报错:<br />
E:Unknown File System:'/mi_ext'<br />
E:Unable to override 'external_storage.projid.enabled' due to missing libresetprop<br />
挂载“/data”失败(Invalid argument)<br />
这三个报错中第二个最好修，第一个次之，第三个与解密有关，放在另一个大章节讲。<br />
<br />
第二个报错只需要在 BoardConfig.mk 中添加<br />
# Tool<br />
TW_INCLUDE_RESETPROP := true<br />
TW_INCLUDE_LIBRESETPROP := true<br />
不用编译测试直接秒杀<br />
<br />
===== 修复挂载 =====<br />
E:Unknown File System:'/mi_ext'<br />
我们打开 recovery/root/system/etc 中的 recovery.fstab，发现里面有很多空格，我们先将它格式化一下，有实力的可以把后面的 flag 也对齐整理好。<br />
<br />
我比较没实力，简单格式化了一下，是这样的<br />
# 1 "vendor/mediatek/proprietary/hardware/fstab/mt6895/fstab.in.mt6895"<br />
# 1 "<built-in>" 1<br />
# 1 "<built-in>" 3<br />
# 341 "<built-in>" 3<br />
# 1 "<command line>" 1<br />
# 1 "<built-in>" 2<br />
# 1 "vendor/mediatek/proprietary/hardware/fstab/mt6895/fstab.in.mt6895" 2<br />
# 173 "vendor/mediatek/proprietary/hardware/fstab/mt6895/fstab.in.mt6895"<br />
system /system erofs ro wait,slotselect,avb=vbmeta_system,logical,first_stage_mount,avb_keys=/avb/q-gsi.avbpubkey:/avb/r-gsi.avbpubkey:/avb/s-gsi.avbpubkey<br />
system /system ext4 ro wait,slotselect,avb=vbmeta_system,logical,first_stage_mount,avb_keys=/avb/q-gsi.avbpubkey:/avb/r-gsi.avbpubkey:/avb/s-gsi.avbpubkey<br />
vendor /vendor erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
vendor /vendor ext4 ro wait,slotselect,avb,logical,first_stage_mount<br />
product /product erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
product /product ext4 ro wait,slotselect,avb,logical,first_stage_mount<br />
mi_ext /mnt/vendor/mi_ext erofs ro wait,slotselect,avb=vbmeta,logical,first_stage_mount,nofail<br />
mi_ext /mnt/vendor/mi_ext ext4 ro wait,slotselect,avb=vbmeta,logical,first_stage_mount,nofail<br />
/mnt/vendor/mi_ext /mi_ext none ro,bind wait,nofail<br />
overlay /product/overlay overlay ro,lowerdir=/mnt/vendor/mi_ext/product/overlay/:/product/overlay check,nofail<br />
overlay /product/app overlay ro,lowerdir=/mnt/vendor/mi_ext/product/app/:/product/app check,nofail<br />
overlay /product/priv-app overlay ro,lowerdir=/mnt/vendor/mi_ext/product/priv-app/:/product/priv-app check,nofail<br />
overlay /product/lib overlay ro,lowerdir=/mnt/vendor/mi_ext/product/lib/:/product/lib check,nofail<br />
overlay /product/lib64 overlay ro,lowerdir=/mnt/vendor/mi_ext/product/lib64/:/product/lib64 check,nofail<br />
overlay /product/bin overlay ro,lowerdir=/mnt/vendor/mi_ext/product/bin/:/product/bin check,nofail<br />
overlay /product/framework overlay ro,lowerdir=/mnt/vendor/mi_ext/product/framework/:/product/framework check,nofail<br />
overlay /product/media overlay ro,lowerdir=/mnt/vendor/mi_ext/product/media/:/product/media check,nofail<br />
overlay /product/opcust overlay ro,lowerdir=/mnt/vendor/mi_ext/product/opcust/:/product/opcust check,nofail<br />
overlay /product/data-app overlay ro,lowerdir=/mnt/vendor/mi_ext/product/data-app/:/product/data-app check,nofail<br />
overlay /product/etc/sysconfig overlay ro,lowerdir=/mnt/vendor/mi_ext/product/etc/sysconfig/:/product/etc/sysconfig check,nofail<br />
overlay /product/etc/permissions overlay ro,lowerdir=/mnt/vendor/mi_ext/product/etc/permissions/:/product/etc/permissions check,nofail<br />
overlay /system/app overlay ro,lowerdir=/mnt/vendor/mi_ext/system/app/:/product/pangu/system/app/:/system/app check,nofail<br />
overlay /system/priv-app overlay ro,lowerdir=/mnt/vendor/mi_ext/system/priv-app/:/product/pangu/system/priv-app/:/system/priv-app check,nofail<br />
overlay /system/framework overlay ro,lowerdir=/product/pangu/system/framework/:/system/framework check,nofail<br />
overlay /system/etc/sysconfig overlay ro,lowerdir=/mnt/vendor/mi_ext/system/etc/sysconfig/:/system/etc/sysconfig check,nofail<br />
overlay /system/etc/permissions overlay ro,lowerdir=/mnt/vendor/mi_ext/system/etc/permissions/:/product/pangu/system/etc/permissions/:/system/etc/permissions check,nofail<br />
system_ext /system_ext erofs ro wait,slotselect,avb=vbmeta_system,logical,first_stage_mount,avb_keys=/avb/q-gsi.avbpubkey:/avb/r-gsi.avbpubkey:/avb/s-gsi.avbpubkey<br />
system_ext /system_ext ext4 ro wait,slotselect,avb=vbmeta_system,logical,first_stage_mount,avb_keys=/avb/q-gsi.avbpubkey:/avb/r-gsi.avbpubkey:/avb/s-gsi.avbpubkey<br />
odm /odm erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
odm /odm ext4 ro wait,slotselect,avb,logical,first_stage_mount<br />
vendor_dlkm /vendor_dlkm erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
odm_dlkm /odm_dlkm erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
/dev/block/by-name/metadata /metadata ext4 noatime,nosuid,nodev,discard wait,check,formattable,first_stage_mount<br />
/dev/block/by-name/userdata /data f2fs noatime,nosuid,nodev,discard,noflush_merge,fsync_mode=nobarrier,reserve_root=134217,resgid=1065,checkpoint_merge,gc_merge,inlinecrypt wait,check,formattable,quota,latemount,resize,reservedsize=128m,checkpoint=fs,fileencryption=aes-256-xts:aes-256-cts:v2+inlinecrypt_optimized,keydirectory=/metadata/vold/metadata_encryption,fsverity<br />
/dev/block/by-name/rescue /cache ext4 noatime,nosuid,nodev,noauto_da_alloc,discard wait,check,formattable<br />
/dev/block/by-name/protect1 /mnt/vendor/protect_f ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/dev/block/by-name/protect2 /mnt/vendor/protect_s ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/dev/block/by-name/nvdata /mnt/vendor/nvdata ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/dev/block/by-name/nvcfg /mnt/vendor/nvcfg ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/dev/block/by-name/persist /mnt/vendor/persist ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/devices/platform/soc/11240000.mmc* auto auto defaults voldmanaged=sdcard1:auto,encryptable=userdata<br />
/devices/platform/usb_xhci* auto vfat defaults voldmanaged=usbotg:auto<br />
/devices/platform/soc/11201000.usb0/11200000.xhci* auto vfat defaults voldmanaged=usbotg:auto<br />
/dev/block/by-name/frp /persistent emmc defaults defaults<br />
/dev/block/by-name/nvram /nvram emmc defaults defaults<br />
/dev/block/by-name/proinfo /proinfo emmc defaults defaults<br />
/dev/block/by-name/lk /bootloader emmc defaults defaults<br />
/dev/block/by-name/lk2 /bootloader2 emmc defaults defaults<br />
/dev/block/by-name/para /para emmc defaults defaults<br />
/dev/block/by-name/misc /misc emmc defaults defaults<br />
/dev/block/by-name/boot /boot emmc defaults first_stage_mount,nofail,slotselect<br />
/dev/block/by-name/vbmeta_vendor /vbmeta_vendor emmc defaults first_stage_mount,nofail,slotselect<br />
/dev/block/by-name/vbmeta_system /vbmeta_system emmc defaults first_stage_mount,nofail,slotselect,avb=vbmeta<br />
/dev/block/by-name/logo /logo emmc defaults defaults<br />
/dev/block/by-name/expdb /expdb emmc defaults defaults<br />
/dev/block/by-name/seccfg /seccfg emmc defaults defaults<br />
/dev/block/by-name/tee1 /tee1 emmc defaults defaults<br />
/dev/block/by-name/tee2 /tee2 emmc defaults defaults<br />
/dev/block/by-name/scp1 /scp1 emmc defaults defaults<br />
/dev/block/by-name/scp2 /scp2 emmc defaults defaults<br />
/dev/block/by-name/sspm_1 /sspm_1 emmc defaults defaults<br />
/dev/block/by-name/sspm_2 /sspm_2 emmc defaults defaults<br />
/dev/block/by-name/dpm_1 /dpm_1 emmc defaults defaults<br />
/dev/block/by-name/dpm_2 /dpm_2 emmc defaults defaults<br />
/dev/block/by-name/mcupm_1 /mcupm_1 emmc defaults defaults<br />
/dev/block/by-name/mcupm_2 /mcupm_2 emmc defaults defaults<br />
/dev/block/by-name/md1img /md1img emmc defaults defaults<br />
/dev/block/by-name/md1dsp /md1dsp emmc defaults defaults<br />
/dev/block/by-name/md1arm7 /md1arm7 emmc defaults defaults<br />
/dev/block/by-name/md3img /md3img emmc defaults defaults<br />
/dev/block/by-name/gz1 /gz1 emmc defaults defaults<br />
/dev/block/by-name/gz2 /gz2 emmc defaults defaults<br />
/dev/block/by-name/spmfw /spmfw emmc defaults defaults<br />
/dev/block/by-name/audio_dsp /audio_dsp emmc defaults defaults<br />
/dev/block/by-name/pi_img /pi_img emmc defaults defaults<br />
/dev/block/by-name/boot_para /boot_para emmc defaults defaults<br />
/dev/block/by-name/odmdtbo /odmdtbo emmc defaults defaults<br />
/dev/block/by-name/dtbo /dtbo emmc defaults defaults<br />
/dev/block/by-name/otp /otp emmc defaults defaults<br />
/dev/block/by-name/vbmeta /vbmeta emmc defaults defaults<br />
这里面有很多无用分区，我们在 twrp 中操作不到，但是我也是第一次适配 MTK 设备，所以不“瞎说”误人子弟了，先把 bug 修好。<br />
<br />
像 xiaomi 这样常见的挂载错误，我自己一般都是尝试把/mnt/vendor 使用 vscode 全部删除，让我们尝试一下。并且要把这一行删除，这行在我看来是重复定义（？而且也没指定分区格式。<br />
/mnt/vendor/mi_ext /mi_ext none ro,bind wait,nofail<br />
整理完之后是这样的<br />
# 1 "vendor/mediatek/proprietary/hardware/fstab/mt6895/fstab.in.mt6895"<br />
# 1 "<built-in>" 1<br />
# 1 "<built-in>" 3<br />
# 341 "<built-in>" 3<br />
# 1 "<command line>" 1<br />
# 1 "<built-in>" 2<br />
# 1 "vendor/mediatek/proprietary/hardware/fstab/mt6895/fstab.in.mt6895" 2<br />
# 173 "vendor/mediatek/proprietary/hardware/fstab/mt6895/fstab.in.mt6895"<br />
system /system erofs ro wait,slotselect,avb=vbmeta_system,logical,first_stage_mount,avb_keys=/avb/q-gsi.avbpubkey:/avb/r-gsi.avbpubkey:/avb/s-gsi.avbpubkey<br />
system /system ext4 ro wait,slotselect,avb=vbmeta_system,logical,first_stage_mount,avb_keys=/avb/q-gsi.avbpubkey:/avb/r-gsi.avbpubkey:/avb/s-gsi.avbpubkey<br />
vendor /vendor erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
vendor /vendor ext4 ro wait,slotselect,avb,logical,first_stage_mount<br />
product /product erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
product /product ext4 ro wait,slotselect,avb,logical,first_stage_mount<br />
mi_ext /mi_ext erofs ro wait,slotselect,avb=vbmeta,logical,first_stage_mount,nofail<br />
mi_ext /mi_ext ext4 ro wait,slotselect,avb=vbmeta,logical,first_stage_mount,nofail<br />
overlay /product/overlay overlay ro,lowerdir=/mi_ext/product/overlay/:/product/overlay check,nofail<br />
overlay /product/app overlay ro,lowerdir=/mi_ext/product/app/:/product/app check,nofail<br />
overlay /product/priv-app overlay ro,lowerdir=/mi_ext/product/priv-app/:/product/priv-app check,nofail<br />
overlay /product/lib overlay ro,lowerdir=/mi_ext/product/lib/:/product/lib check,nofail<br />
overlay /product/lib64 overlay ro,lowerdir=/mi_ext/product/lib64/:/product/lib64 check,nofail<br />
overlay /product/bin overlay ro,lowerdir=/mi_ext/product/bin/:/product/bin check,nofail<br />
overlay /product/framework overlay ro,lowerdir=/mi_ext/product/framework/:/product/framework check,nofail<br />
overlay /product/media overlay ro,lowerdir=/mi_ext/product/media/:/product/media check,nofail<br />
overlay /product/opcust overlay ro,lowerdir=/mi_ext/product/opcust/:/product/opcust check,nofail<br />
overlay /product/data-app overlay ro,lowerdir=/mi_ext/product/data-app/:/product/data-app check,nofail<br />
overlay /product/etc/sysconfig overlay ro,lowerdir=/mi_ext/product/etc/sysconfig/:/product/etc/sysconfig check,nofail<br />
overlay /product/etc/permissions overlay ro,lowerdir=/mi_ext/product/etc/permissions/:/product/etc/permissions check,nofail<br />
overlay /system/app overlay ro,lowerdir=/mi_ext/system/app/:/product/pangu/system/app/:/system/app check,nofail<br />
overlay /system/priv-app overlay ro,lowerdir=/mi_ext/system/priv-app/:/product/pangu/system/priv-app/:/system/priv-app check,nofail<br />
overlay /system/framework overlay ro,lowerdir=/product/pangu/system/framework/:/system/framework check,nofail<br />
overlay /system/etc/sysconfig overlay ro,lowerdir=/mi_ext/system/etc/sysconfig/:/system/etc/sysconfig check,nofail<br />
overlay /system/etc/permissions overlay ro,lowerdir=/mi_ext/system/etc/permissions/:/product/pangu/system/etc/permissions/:/system/etc/permissions check,nofail<br />
system_ext /system_ext erofs ro wait,slotselect,avb=vbmeta_system,logical,first_stage_mount,avb_keys=/avb/q-gsi.avbpubkey:/avb/r-gsi.avbpubkey:/avb/s-gsi.avbpubkey<br />
system_ext /system_ext ext4 ro wait,slotselect,avb=vbmeta_system,logical,first_stage_mount,avb_keys=/avb/q-gsi.avbpubkey:/avb/r-gsi.avbpubkey:/avb/s-gsi.avbpubkey<br />
odm /odm erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
odm /odm ext4 ro wait,slotselect,avb,logical,first_stage_mount<br />
vendor_dlkm /vendor_dlkm erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
odm_dlkm /odm_dlkm erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
/dev/block/by-name/metadata /metadata ext4 noatime,nosuid,nodev,discard wait,check,formattable,first_stage_mount<br />
/dev/block/by-name/userdata /data f2fs noatime,nosuid,nodev,discard,noflush_merge,fsync_mode=nobarrier,reserve_root=134217,resgid=1065,checkpoint_merge,gc_merge,inlinecrypt wait,check,formattable,quota,latemount,resize,reservedsize=128m,checkpoint=fs,fileencryption=aes-256-xts:aes-256-cts:v2+inlinecrypt_optimized,keydirectory=/metadata/vold/metadata_encryption,fsverity<br />
/dev/block/by-name/rescue /cache ext4 noatime,nosuid,nodev,noauto_da_alloc,discard wait,check,formattable<br />
/dev/block/by-name/protect1 /protect_f ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/dev/block/by-name/protect2 /protect_s ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/dev/block/by-name/nvdata /nvdata ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/dev/block/by-name/nvcfg /nvcfg ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/dev/block/by-name/persist /persist ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/devices/platform/soc/11240000.mmc* auto auto defaults voldmanaged=sdcard1:auto,encryptable=userdata<br />
/devices/platform/usb_xhci* auto vfat defaults voldmanaged=usbotg:auto<br />
/devices/platform/soc/11201000.usb0/11200000.xhci* auto vfat defaults voldmanaged=usbotg:auto<br />
/dev/block/by-name/frp /persistent emmc defaults defaults<br />
/dev/block/by-name/nvram /nvram emmc defaults defaults<br />
/dev/block/by-name/proinfo /proinfo emmc defaults defaults<br />
/dev/block/by-name/lk /bootloader emmc defaults defaults<br />
/dev/block/by-name/lk2 /bootloader2 emmc defaults defaults<br />
/dev/block/by-name/para /para emmc defaults defaults<br />
/dev/block/by-name/misc /misc emmc defaults defaults<br />
/dev/block/by-name/boot /boot emmc defaults first_stage_mount,nofail,slotselect<br />
/dev/block/by-name/vbmeta_vendor /vbmeta_vendor emmc defaults first_stage_mount,nofail,slotselect<br />
/dev/block/by-name/vbmeta_system /vbmeta_system emmc defaults first_stage_mount,nofail,slotselect,avb=vbmeta<br />
/dev/block/by-name/logo /logo emmc defaults defaults<br />
/dev/block/by-name/expdb /expdb emmc defaults defaults<br />
/dev/block/by-name/seccfg /seccfg emmc defaults defaults<br />
/dev/block/by-name/tee1 /tee1 emmc defaults defaults<br />
/dev/block/by-name/tee2 /tee2 emmc defaults defaults<br />
/dev/block/by-name/scp1 /scp1 emmc defaults defaults<br />
/dev/block/by-name/scp2 /scp2 emmc defaults defaults<br />
/dev/block/by-name/sspm_1 /sspm_1 emmc defaults defaults<br />
/dev/block/by-name/sspm_2 /sspm_2 emmc defaults defaults<br />
/dev/block/by-name/dpm_1 /dpm_1 emmc defaults defaults<br />
/dev/block/by-name/dpm_2 /dpm_2 emmc defaults defaults<br />
/dev/block/by-name/mcupm_1 /mcupm_1 emmc defaults defaults<br />
/dev/block/by-name/mcupm_2 /mcupm_2 emmc defaults defaults<br />
/dev/block/by-name/md1img /md1img emmc defaults defaults<br />
/dev/block/by-name/md1dsp /md1dsp emmc defaults defaults<br />
/dev/block/by-name/md1arm7 /md1arm7 emmc defaults defaults<br />
/dev/block/by-name/md3img /md3img emmc defaults defaults<br />
/dev/block/by-name/gz1 /gz1 emmc defaults defaults<br />
/dev/block/by-name/gz2 /gz2 emmc defaults defaults<br />
/dev/block/by-name/spmfw /spmfw emmc defaults defaults<br />
/dev/block/by-name/audio_dsp /audio_dsp emmc defaults defaults<br />
/dev/block/by-name/pi_img /pi_img emmc defaults defaults<br />
/dev/block/by-name/boot_para /boot_para emmc defaults defaults<br />
/dev/block/by-name/odmdtbo /odmdtbo emmc defaults defaults<br />
/dev/block/by-name/dtbo /dtbo emmc defaults defaults<br />
/dev/block/by-name/otp /otp emmc defaults defaults<br />
/dev/block/by-name/vbmeta /vbmeta emmc defaults defaults<br />
让我们编译试一下，值得注意的是，twrp 每次更改最好删除 out 重新编译，不要使用如make installclean等命令，可能会开机黑屏或更改不生效。<br />
<br />
经过一分钟，编译好了，刷入，开机，启动！可以看见挂载成功被修好。<br />
<br />
===== 修复屏幕显示 =====<br />
可以看到我们现在屏幕的顶部的时间被摄像头挖孔挡住了。我们使用两个偏移 Flag 来修复它。<br />
<br />
在 BoardConfig.mk 中，加入以下 flag<br />
TW_Y_OFFSET := 106 #导航栏向上<br />
TW_H_OFFSET := -106 #界面整体向下<br />
<br />
===== 修复振动 =====<br />
<blockquote>仅供参考，研究半天发现只有解密功能正常才能修振动，不然会冻屏！！！<br />
<br />
不一定正确，也不一定普遍，仅供指路</blockquote>老设备一般都是正常的，不需要额外处理，新设备使用 aidl hal 需要我们自己处理一下让 service 正常工作。<br />
<br />
挂载 vendor，使用 twrp 的文件管理，在 vendor/etc/vintf/manifest 找到含有 vibrator 字样的文件。打开之后检查是否类似这样的文段<br />
<manifest version="1.0" type="device"><br />
<hal format="aidl" override="true"><br />
<name>android.hardware.vibrator</name><br />
<fqname>IVibrator/vibratorfeature</fqname><br />
</hal><br />
</manifest><br />
那恭喜你，找对了，我的文件名是<br />
<br />
vendor.xiaomi.hardware.vibratorfeature.service.xml<br />
<br />
将它使用adb pull放到电脑上自己方便的位置备用。<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/$/mjw adb pull /vendor/etc/vintf/manifest/vendor.xiaomi.hardware.vibratorfeature.service.xml .<br />
/vendor/etc/vintf/manifest/vendor.xiao...ipped. 0.2 MB/s (1718 bytes in 0.009s)<br />
不看扩展名，到 vendor/bin/hw/找到同名的 service 同样利用adb pull放电脑备用。比如我的叫<br />
<br />
vendor.xiaomi.hardware.vibratorfeature.service<br />
<br />
然后到 vendor/etc/init/找到同名.rc 文件，拉到电脑上，在里面加一条。并在定义 service 的最下面加上seclabel u:r:recovery:s0可以被 recovery 使用。<br />
on boot<br />
start service被定义的名字<br />
例如<br />
on post-fs-data<br />
chown system system /sys/bus/i2c/drivers/aw8697_haptic/2-005a/f0_save<br />
chown system system /sys/bus/i2c/drivers/aw8697_haptic/2-005a/osc_save<br />
chown system system /sys/bus/i2c/drivers/aw8697_haptic/3-005a/osc_save<br />
# 省略一万字<br />
<br />
on boot<br />
start vibratorfeature-hal-service<br />
<br />
service vibratorfeature-hal-service /vendor/bin/hw/vendor.xiaomi.hardware.vibratorfeature.service<br />
class hal<br />
user system<br />
group system input<br />
onrestart restart vibratorfeature<br />
seclabel u:r:recovery:s0<br />
此外这种新设备在内核里还有振动模块需要加载，请到/vendor/modules/1.1/中寻找，例如我这台设备是haptic.ko，用 adb pull 拉取到电脑上，然后<br />
<br />
* haptic.ko --> recovery/root/vendor/modules/1.1<br />
<br />
至此所有必要的资料就准备好了。可能开机后仍然不工作，需要抓取 log 补缺失的 library，当然这是后话了。<br />
<br />
开干！<br />
<br />
在 BoardConfig.mk 中加入以下 flag<br />
TW_SUPPORT_INPUT_AIDL_HAPTICS := true<br />
将备用文件按照以下操作复制<br />
<br />
* vendor.xiaomi.hardware.vibratorfeature.service.xml --> recovery/root/vendor/etc/vintf/manifest<br />
* vendor.xiaomi.hardware.vibratorfeature.service --> recovery/root/vendor/bin/hw<br />
* vendor.xiaomi.hardware.vibratorfeature.service.rc --> recovery/root/vendor/etc/init<br />
<br />
之后编译，刷入，开机，喜提冻屏......<br />
<br />
问题不大，使用adb logcat抓取日志<br />
adb logcat > log.log<br />
打开 log，搜索F linker、linker、library、beginning of crash这几个关键词，我搜索第一个就出来了。<br />
F linker : CANNOT LINK EXECUTABLE "/vendor/bin/hw/vendor.xiaomi.hardware.vibratorfeature.service": library "android.hardware.vibrator-V1-ndk_platform.so" not found: needed by main executable<br />
这段报错的意思就是vendor.xiaomi.hardware.vibratorfeature.service找不到android.hardware.vibrator-V1-ndk_platform.so这个库，所以无法正常工作。<br />
<br />
打开 BoardConfig.mk 加入以下 flag<br />
# Library<br />
TARGET_RECOVERY_DEVICE_MODULES += \<br />
android.hardware.vibrator-V1-ndk_platform.vendor<br />
<br />
TW_RECOVERY_ADDITIONAL_RELINK_LIBRARY_FILES += \<br />
$(TARGET_OUT_SHARED_LIBRARIES)/android.hardware.vibrator-V1-ndk_platform.so<br />
再次编译尝试<br />
<br />
开机之后依然冻屏，继续抓 log，查找<br />
F linker : CANNOT LINK EXECUTABLE "/vendor/bin/hw/vendor.xiaomi.hardware.vibratorfeature.service": library "vendor.hardware.vibratorfeature.IVibratorExt-V1-ndk_platform.so" not found: needed by main executable<br />
vendor.hardware.vibratorfeature字样和我们之前导入的文件长得差不多，一般都是供应商专有文件，所以去设备提取，路径在 vendor/lib64 里，虽然设备冻屏了，但我们可以用adb pull直接拉取到电脑。就像这样。<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/$/mjw adb shell mount /vendor<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/$/mjw adb pull /vendor/lib64/vendor.hardware.vibratorfeature.IVibratorExt-V1-ndk_platform.so .<br />
/vendor/lib64/vendor.hardware.vibratorfeature.IVi...led, 0 skipped. 14.7 MB/s (33552 bytes in 0.002s<br />
将这个文件按照以下提示操作<br />
<br />
* vendor.hardware.vibratorfeature.IVibratorExt-V1-ndk_platform.so --> recovery/root/vendor/lib64<br />
<br />
继续编译测试<br />
<br />
还是冻屏，继续抓 log<br />
F linker : CANNOT LINK EXECUTABLE "/vendor/bin/hw/vendor.xiaomi.hardware.vibratorfeature.service": library "libtinyalsa.so" not found: needed by main executable<br />
这个 library twrp 的源码中应该没有，去设备拿一个 prebuilt 吧<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/$/mjw adb shell mount /system_root<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/$/mjw adb pull /system_root/system/lib64/libtinyalsa.so .<br />
/system_root/system/lib64/libtinyalsa.so: 1 file ...led, 0 skipped. 13.6 MB/s (45032 bytes in 0.003s<br />
将这个文件按照以下提示操作<br />
<br />
* libtinyalsa.so --> recovery/root/system/lib64<br />
<br />
编译测试<br />
<br />
我艹了，还是冻屏，这次搜那几个关键词都搜不到了，搜vibrator看看这鬼东西报什么<br />
E vendor.xiaomi.hardware.vibratorfeature.service: fail to load lib : /vendor/lib64/libaachaptics.so<br />
这次都直接给路径了，直接拿。<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/$/mjw adb shell mount /vendor<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/$/mjw adb pull /vendor/lib64/libaachaptics.so .<br />
/vendor/lib64/libaachaptics.so: 1 file pulled, 0 skipped. 15.8 MB/s (56232 bytes in 0.003s)<br />
将这个文件按照以下提示操作<br />
<br />
* libaachaptics.so --> recovery/root/vendor/lib64<br />
<br />
至此应该没什么问题了，但是有个 flag 貌似要操作 data 内的东西，未解密会导致冻屏，所以等修完解密后再来修振动。<br />
<br />
==== 修复 CPU 温度 ====<br />
使用adb shell + grep命令在手机节点里搜索 type 关键词。<br />
xiaolegun@xiaoleGundeMac-Pro ~ adb shell 'grep "cp_master" /sys/class/thermal/*/type'<br />
/sys/class/thermal/thermal_zone54/type:cp_master<br />
xiaolegun@xiaoleGundeMac-Pro ~ adb shell 'grep "cpu" /sys/class/thermal/*/type'<br />
/sys/class/thermal/thermal_zone1/type:cpu_little1<br />
/sys/class/thermal/thermal_zone10/type:cpu_bigbig1<br />
/sys/class/thermal/thermal_zone11/type:cpu_big6<br />
/sys/class/thermal/thermal_zone12/type:cpu_bigbig2<br />
/sys/class/thermal/thermal_zone2/type:cpu_little2<br />
/sys/class/thermal/thermal_zone3/type:cpu_little3<br />
/sys/class/thermal/thermal_zone4/type:cpu_little4<br />
/sys/class/thermal/thermal_zone5/type:cpu_big1<br />
/sys/class/thermal/thermal_zone6/type:cpu_big2<br />
/sys/class/thermal/thermal_zone7/type:cpu_big3<br />
/sys/class/thermal/thermal_zone8/type:cpu_big4<br />
/sys/class/thermal/thermal_zone9/type:cpu_big5<br />
我这里选用cp_master节点来读取温度。我的节点路径为/sys/class/thermal/thermal_zone54在后面添加 temp 来读取温度，你可以使用cat来检测节点是否可以正常读取温度<br />
adb shell 'cat /sys/class/thermal/thermal_zone54/temp'<br />
如果返回如<br />
28000<br />
这种类似的数值，那多半是没有问题的。<br />
<br />
我们在 BoardConfig.mk 中加入<br />
TW_CUSTOM_CPU_TEMP_PATH := "/sys/class/thermal/thermal_zone54/temp"<br />
至此 cpu 温度就修复好了。<br />
<br />
== 后序 ==<br />
这是我玩 Android 两年内第一次写关于 Android 的文章，内容和措辞可能不是很准确，再加上开学焦虑，租房因租金和房源不顺利，写的很乱，请各位指正。<br />
<br />
此外有什么不懂得，多翻github，善用github搜索，多看看大佬们是怎么解决的。<br />
<br />
解密等有空补，先补作业。<br />
<br />
== 参考资料 ==<br />
[https://source.android.com/docs/setup/create/new-device?hl=zh-cn Google - 添加新设备]<br />
<br />
[https://source.android.com/docs/core/ota/ab?hl=zh-cn Google - A/B（无缝）系统更新]<br />
<br />
[https://blog.lynnrin.moe/posts/ROM-bringup-guide-prebuilt/#boardconfigmk Lynnrin - 快速上手 Android Custom ROM 适配 - Prebuilt Vendor]<br />
<br />
[https://source.android.com/docs/core/architecture/vintf?hl=zh-cn Google - 供应商接口对象]</div>
XiaoleGun
https://wiki.uotan.cn/index.php?title=%E4%B8%BA%E6%96%B0%E8%AE%BE%E5%A4%87%E7%BC%96%E5%86%99Recovery_device_tree&diff=555
为新设备编写Recovery device tree
2024-02-20T06:11:03Z
<p>XiaoleGun：fixup</p>
<hr />
<div><br />
= 为新设备编写 Recovery 的设备树 =<br />
作者: Dark(xiaoleGun)<br />
<br />
时间: 2024.2.20<br />
<br />
协作者:<br />
<br />
== 一些自序 ==<br />
这篇教程中可能有些不对的地方，请各位指正，我也刚接触 Android 设备测开发两年，而且只有在节假日的时候有空一个人瞎捣鼓，为了<s>薅 mjw 羊毛</s>，故写这篇教程，而且我个人更推荐 Aosp Recovery 刷写第三方 ROM，TWRP 可能多多少少有些问题。Root 之类的不需要 TWRP 也可以，可以找到原机 boot 使用 Magisk 进行修补，也可以使用 KernelSU。另外我的语文功底不是很好，写不出辞藻，只能是北方地道的大白话，见谅哈 🤣///<br />
<br />
== 准备工作 ==<br />
1.一颗勇敢的、不怕困难的强大心脏。<br />
<br />
'''<s>两颗心好勇敢 -- Falling in love</s>'''<br />
<br />
2.电脑配置:<br />
{| class="wikitable"<br />
!硬件<br />
!需求<br />
|-<br />
|CPU<br />
|四核或更多<br />
|-<br />
|内存<br />
|8G 或更多<br />
|-<br />
|硬盘<br />
|至少 80G 空余空间<br />
|-<br />
|系统<br />
|WSL 或实体 Linux，建议 Debian 系<br />
|}<br />
3.足够的空闲时间。<br />
<br />
4.Vscode 和 🤏Linux 知识储备<br />
<br />
5.一台完好无损的新设备。<br />
<br />
6.设备原厂的 boot/recovery/vendor_boot 镜像。(推荐 recovery 分区，因为里面包含一些启动必须的.rc(run command)，如果没有该分区，寻找包含官方 recovery 内容的分区。值得注意的是部分设备 recovery 合并到了 boot 中，或是存在于 vendor_boot）<br />
<br />
7.查看自己的设备出厂 Android 版本并确定用途，是用于官方 ROM 还是第三方类原生。出厂版本为 9 及以上的可以使用 twrp-11 及以上分支，9 以下使用 twrp-9 分支。<br />
<br />
== 配置环境 ==<br />
<br />
=== 安装依赖 ===<br />
sudo apt update<br />
sudo apt-get install bc bison build-essential ccache curl flex g++-multilib gcc-multilib git gnupg gperf imagemagick lib32ncurses5-dev lib32readline-dev lib32z1-dev liblz4-tool libncurses5 libncurses5-dev libsdl1.2-dev libssl-dev libxml2 libxml2-utils lzop pngcrush rsync schedtool squashfs-tools xsltproc zip zlib1g-dev xattr openjdk-11-jdk jq android-sdk-libsparse-utils python3 python2 repo<br />
<br />
必要时可以阅读[https://source.android.com/source/using-repo?hl=zh-cn Git 和 Repo]<br />
<br />
=== 配置 Git 和 Repo ===<br />
安装完依赖后，在终端执行。<br />
git config --global user.name "your username"<br />
git config --global user.email "your email"<br />
<br />
=== 同步 TWRP 源码 ===<br />
在自己方便的地方，建立一个目录。<br />
mkdir twrp<br />
cd twrp<br />
根据自己在准备工作中确定的分支同步相应的源码。<br />
<br />
==== TWRP-9 ====<br />
repo init --depth=1 -u <nowiki>https://github.com/minimal-manifest-twrp/platform_manifest_twrp_omni.git</nowiki> -b twrp-9.0<br />
repo sync<br />
<br />
==== TWRP-11 ====<br />
repo init --depth=1 -u <nowiki>https://github.com/minimal-manifest-twrp/platform_manifest_twrp_aosp.git</nowiki> -b twrp-11<br />
repo sync<br />
<br />
==== TWRP-12.1 ====<br />
repo init --depth=1 -u <nowiki>https://github.com/minimal-manifest-twrp/platform_manifest_twrp_aosp.git</nowiki> -b twrp-12.1<br />
repo sync<br />
<br />
== 编写设备树 ==<br />
<blockquote>最基本的开机部分我通过 Redmi K50 做示例，并选取 TWRP-12.1 分支。<br />
<br />
解密部分会单独成一个章节并分为高通和联发科。</blockquote><br />
<br />
=== 获取资料 ===<br />
小米设备一般可以在[https://xiaomirom.com Xiaomirom]中的线刷包获取 boot/recovery/vendor_boot 镜像，其它设备请自行寻找。<br />
<br />
==== 安装工具和依赖 ====<br />
将准备工作中准备的 boot/recovery/vendor_boot 镜像解包，可以用任何工具，我这里使用[https://github.com/cfig/Android_boot_image_editor Android_boot_image_editor]按照自述文件进行依赖安装操作：<br />
<br />
===== Mac(Intel) =====<br />
brew install lz4 xz dtc openjdk@17<br />
echo 'export PATH="/usr/local/opt/openjdk@17/bin:$PATH"' >> ~/.zshrc<br />
source ~/.zshrc<br />
<br />
===== Linux: =====<br />
sudo apt update<br />
sudo apt install git device-tree-compiler lz4 xz-utils zlib1g-dev openjdk-17-jdk gcc g++ python3 python-is-python3 p7zip-full android-sdk-libsparse-utils erofs-utils<br />
<br />
===== Common: =====<br />
git clone <nowiki>https://github.com/cfig/Android_boot_image_editor</nowiki><br />
cd Android_boot_image_editor<br />
<br />
==== 解包 ====<br />
<blockquote>请注意"/"表示或的意思，请不要误以为是一个东西。<br />
<br />
如果不确定分区寻找的是否正确，请尝试将可以的分区进行解包，并查看其ramdisk内是否包含recovery字样的文件</blockquote>将你准备好的boot/recovery/vendor_boot复制到该目录，你可以使用 GUI 或者 CLI。如:<br />
cp <出厂boot/recovery/vendor_boot的绝对路径> boot/recovery/vendor_boot.img<br />
./gradlew unpack<br />
我这里以 Redmi K50 为例<br />
10:12:13.188 [main] INFO cfig.bootimg.v3.VendorBoot -<br />
Unpack Summary of vendor_boot.img<br />
┌───────────────────────────────────────┬──────────────────────────────────────┐<br />
│What │Where │<br />
└───────────────────────────────────────┴──────────────────────────────────────┘<br />
┌───────────────────────────────────────┬──────────────────────────────────────┐<br />
│image info │build/unzip_boot/vendor_boot.json │<br />
├───────────────────────────────────────┼──────────────────────────────────────┤<br />
│ramdisk │build/unzip_boot/ramdisk.img.lz4 │<br />
│-- PLATFORM ramdisk[1/1] │build/unzip_boot/ramdisk.1.lz4 │<br />
│------- extracted rootfs │build/unzip_boot/root.1 │<br />
├───────────────────────────────────────┼──────────────────────────────────────┤<br />
│dtb │build/unzip_boot/dtb │<br />
├───────────────────────────────────────┼──────────────────────────────────────┤<br />
│AVB info │build/unzip_boot/vendor_boot.avb.json │<br />
│\-- signing key │NONE │<br />
└───────────────────────────────────────┴──────────────────────────────────────┘<br />
10:12:13.213 [main] WARN cfig.packable.PackableLauncher - 'unpack' sequence completed<br />
<br />
BUILD SUCCESSFUL in 2s<br />
解包成功后终端会打印出以上信息，其中包含vendor_boot目录结构，我们只需要ramdisk里的部分内容就好了。<br />
ls build/unzip_boot/root.1 # 请根据自己的分区和设备判断ramdisk的命名，一般都直接是ramdisk<br />
不出意外的话会输出以下内容<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/dump/bootedit master ? ls build/unzip_boot/root.1<br />
acct oem<br />
apex plat_file_contexts<br />
bin plat_property_contexts<br />
bugreports postinstall<br />
config proc<br />
d product<br />
data product_file_contexts<br />
data_mirror product_property_contexts<br />
debug_ramdisk prop.default<br />
default.prop res<br />
dev sdcard<br />
etc second_stage_resources<br />
first_stage_ramdisk sepolicy<br />
init storage<br />
init.recovery.hardware.rc sys<br />
init.recovery.mt6895.rc system<br />
lib system_ext<br />
linkerconfig system_ext_file_contexts<br />
miui.factoryreset.fstab system_ext_property_contexts<br />
miui.factoryreset.rc tmp<br />
mnt vendor<br />
odm vendor_dlkm<br />
odm_dlkm vendor_file_contexts<br />
odm_file_contexts vendor_property_contexts<br />
odm_property_contexts<br />
如果包含 init.recovery*的字样，恭喜你成功找到了正确的分区。将这个目录复制到一个自己方便的地方。<br />
<br />
至此资料已经大致齐全了，解密的资料会在解密章节来讲解如何获取。<br />
<br />
=== 初始化目录结构 ===<br />
在 twrp 源码根目录输入<br />
mkdir -p device/vendor/codename<br />
mkdir -p device/vendor/codename/recovery/root<br />
cd device/vendor/codename<br />
vendor指的是供应商，如 xiaomi、oneplus、huawei、vivo、realme。<br />
<br />
codename指的是设备代号，小米设备可以在[https://xiaomirom.com Xiaomirom]查询，其它设备自行查询亦或是在开发者选项勾选 USB 调试通过 adb 尝试获取。<br />
adb shell getprop ro.product.manufacturer # 供应商<br />
adb shell getprop ro.product.device # 设备代号<br />
我的 Redmi K50 会打印以下信息<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/dump/bootedit master ? adb shell getprop ro.product.manufacturer<br />
Xiaomi # 无论打印出来的内容是大写还是小写，在目录结构中我们都采用小写<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/dump/bootedit master ? adb shell getprop ro.product.device<br />
rubens<br />
我的 IQOO NEO5 Lite 会打印以下信息<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/tmp/device/xiaomi/rubens adb shell getprop ro.product.manufacturer<br />
vivo<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/tmp/device/xiaomi/rubens adb shell getprop ro.product.device<br />
PD2118<br />
一般只要不是山寨机，小作坊出来的机子，用这两条命令应该是可以正确获取的。<br />
<br />
=== 初始化构建时必要的文件 ===<br />
无论是 AOSP device tree 亦或是 TWRP device tree 都基本类似于以下结构。<br />
/<br />
├── prebuilt (存放kernel、dtb等预编译文件) # AOSP device tree若使用build kernel则没有该目录<br />
├── recovery/root (存放一些.rc和解密blobs) # 一般用于Recovery device tree<br />
├── Android.mk (Android构建系统首先会检查每个目录的Android.mk，里面包含一些判断，由它包括其所在目录中所有Makefile)<br />
├── AndroidProducts.mk (声明产品的Makefile和lunch时可用的构建类型)<br />
├── BoardConfig.mk (板载配置文件，定义了主板必要的Flag)<br />
├── device.mk (声明设备所需的文件和模块)<br />
└── <ROM>_codename.mk (声明产品特定信息，例如名称、品牌和型号，引用device.mk等) # ROM就比如lineage、arrow等，编译twrp就直接写twrp，twrp-9分支要写onmi<br />
我们把这样的结构称为骨架树(skeleton tree)。<br />
<br />
接下来我们按照以上结构为自己的设备写一份 Recovery device tree。<br />
<br />
在终端使用touch命令创建必要的文件。<br />
touch Android.mk AndroidProducts.mk BoardConfig.mk device.mk twrp_rubens.mk<br />
ls .<br />
不出意外的话会打印出以下信息<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/tmp/device/xiaomi/rubens touch Android.mk AndroidProducts.mk BoardConfig.mk device.mk twrp_rubens.mk<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/tmp/device/xiaomi/rubens ls .<br />
Android.mk BoardConfig.mk prebuilt twrp_rubens.mk<br />
AndroidProducts.mk device.mk recovery<br />
可以下一步了~<br />
<br />
==== 初始 Android.mk 文件 ====<br />
打开 Vscode 并打开设备树目录，你足够强也可以使用 nano、vim 编辑。<br />
<br />
选中 Android.mk 并按照自己的资料复制并更改以下内容<br />
LOCAL_PATH := $(call my-dir)<br />
<br />
ifeq ($(TARGET_DEVICE),codename)<br />
include $(call all-subdir-makefiles,$(LOCAL_PATH))<br />
endif<br />
<br />
* codename是需要你修改的部分<br />
<br />
我修改后是这样的<br />
LOCAL_PATH := $(call my-dir)<br />
<br />
ifeq ($(TARGET_DEVICE),rubens)<br />
include $(call all-subdir-makefiles,$(LOCAL_PATH))<br />
endif<br />
<br />
==== 初始 AndroidProducts.mk 文件 ====<br />
选中 AndroidProducts.mk 并按照自己的资料复制并更改以下内容<br />
PRODUCT_MAKEFILES := \<br />
$(LOCAL_DIR)/<ROM>_<codename>.mk<br />
<br />
COMMON_LUNCH_CHOICES := \<br />
<ROM>_<codename>-eng<br />
我修改后是这样的<br />
PRODUCT_MAKEFILES := \<br />
$(LOCAL_DIR)/twrp_rubens.mk<br />
<br />
COMMON_LUNCH_CHOICES := \<br />
twrp_rubens-eng<br />
<br />
==== 初始 BoardConfig.mk 文件 ====<br />
<blockquote>将之前准备的ramdisk文件夹用新窗口打开 1.找到目录下的 prop.default 或含 prop 字样的文件。以下注释类似 ro.*.*的就是从 prop 中获取的 2.解包 boot/recovery/vendor_boot 的 json<br />
<br />
例如 build/unzip_boot/boot.json</blockquote>选中 BoardConfig.mk 并按照自己的资料复制并更改以下内容<br />
DEVICE_PATH := device/vendor/codename<br />
<br />
# Architecture<br />
TARGET_ARCH := arm64 # ro.bionic.arch<br />
TARGET_ARCH_VARIANT := armv8-a # 64位默认变体<br />
TARGET_CPU_ABI := arm64-v8a # ro.vendor.product.cpu.abilist64 (至少在小米设备上没有找到ro.product.cpu.abilist)<br />
TARGET_CPU_ABI2 := # 64位留空<br />
TARGET_CPU_VARIANT := generic # 默认一般都是通用<br />
TARGET_CPU_VARIANT_RUNTIME := cortex-a55 # ro.bionic.cpu_variant<br />
<br />
TARGET_2ND_ARCH := arm # ro.bionic.2nd_arch<br />
TARGET_2ND_ARCH_VARIANT := $(TARGET_ARCH_VARIANT)<br />
TARGET_2ND_CPU_ABI := armeabi-v7a # ro.vendor.product.cpu.abilist32第一个<br />
TARGET_2ND_CPU_ABI2 := armeabi # ro.vendor.product.cpu.abilist32第二个<br />
TARGET_2ND_CPU_VARIANT := $(TARGET_CPU_VARIANT)<br />
TARGET_2ND_CPU_VARIANT_RUNTIME := $(TARGET_CPU_VARIANT)<br />
<br />
# Assertation<br />
TARGET_OTA_ASSERT_DEVICE := rubens # codename<br />
<br />
# Bootloader<br />
TARGET_BOOTLOADER_BOARD_NAME := rubens # ro.product.board<br />
TARGET_NO_BOOTLOADER := true<br />
TARGET_USES_UEFI := true<br />
<br />
# Build Rule<br />
ALLOW_MISSING_DEPENDENCIES := true # 为了recovery不健全的依赖<br />
<br />
# Kernel - 注释会说明在boot/recovery/vendor_boot.json中对应的变量<br />
BOARD_BOOT_HEADER_VERSION := 4 # headerVersion<br />
BOARD_KERNEL_BASE := 0x3fff8000 # (kernelLoadAddr - 32KB) qcom设备base为0，且没有偏移(offset)<br />
BOARD_KERNEL_CMDLINE := bootopt=64S3,32N2,64N2 # cmdline<br />
BOARD_KERNEL_PAGESIZE := 4096 # pageSize<br />
BOARD_RAMDISK_OFFSET := 0x26f08000 # (ramdisk,loadAddr - BOARD_KERNEL_BASE)<br />
BOARD_KERNEL_TAGS_OFFSET := 0x07c88000 # (tagsLoadAddr - BOARD_KERNEL_BASE)<br />
BOARD_MKBOOTIMG_ARGS += --header_version $(BOARD_BOOT_HEADER_VERSION)<br />
BOARD_MKBOOTIMG_ARGS += --ramdisk_offset $(BOARD_RAMDISK_OFFSET)<br />
BOARD_MKBOOTIMG_ARGS += --tags_offset $(BOARD_KERNEL_TAGS_OFFSET)<br />
<br />
# Kernel - prebuilt<br />
TARGET_PREBUILT_KERNEL := $(DEVICE_PATH)/prebuilt/kernel # 预编译内核相对于android源码根目录的相对路径，vendor_boot机型不需要<br />
TARGET_PREBUILT_DTB := $(DEVICE_PATH)/prebuilt/dtb.img # 同上<br />
BOARD_MKBOOTIMG_ARGS += --dtb $(TARGET_PREBUILT_DTB)<br />
<br />
# Partitions<br />
BOARD_FLASH_BLOCK_SIZE := 262144 # (BOARD_KERNEL_PAGESIZE * 64)<br />
BOARD_BOOTIMAGE_PARTITION_SIZE := 67108864 # boot/recovery/vendor_boot镜像的字节大小需原厂或手机完整提取出来的，不定义会报错<br />
BOARD_RECOVERYIMAGE_PARTITION_SIZE := 67108864 # 同上<br />
BOARD_VENDOR_ROOTIMAGE_PARTITION_SIZE := 67108864 # 同上<br />
BOARD_SYSTEMIMAGE_PARTITION_TYPE := ext4 # 分区类型，查看ramdisk中fstab定义的类型<br />
BOARD_USERDATAIMAGE_FILE_SYSTEM_TYPE := ext4<br />
BOARD_VENDORIMAGE_FILE_SYSTEM_TYPE := ext4<br />
TARGET_COPY_OUT_VENDOR := vendor # 定义vendor目录，例如copy专有blobs要用<br />
BOARD_SUPER_PARTITION_SIZE := 9126805504 # 可以通过blockdev --getsize64 /dev/block/bootdevice/by-name/super获取，需root，如果无法root可以直接使用这个值，不影响twrp启动，可以后续修正<br />
BOARD_SUPER_PARTITION_GROUPS := xiaomi_dynamic_partitions # xiaomi根据你获取资料的vendor替换，是一个动态分区组<br />
BOARD_XIAOMI_DYNAMIC_PARTITIONS_PARTITION_LIST := system vendor product system_ext odm vendor_dlkm odm_dlkm # 根据fstab内的定义，一般flag包含logical都属于动态分区组的一部分<br />
BOARD_XIAOMI_DYNAMIC_PARTITIONS_SIZE := 9122611200 # (BOARD_SUPER_PARTITION_SIZE - 4MB)<br />
<br />
# Platform<br />
TARGET_BOARD_PLATFORM := mt6895 # ro.board.platform<br />
<br />
# Recovery - 基本通用的不影响启动<br />
BOARD_HAS_LARGE_FILESYSTEM := true<br />
TARGET_RECOVERY_PIXEL_FORMAT := RGBX_8888<br />
TARGET_USERIMAGES_USE_EXT4 := true<br />
TARGET_USERIMAGES_USE_F2FS := true<br />
<br />
# Treble<br />
BOARD_VNDK_VERSION := current # 声明VNDK版本<br />
<br />
# Vendor_boot recovery ramdisk<br />
BOARD_MOVE_RECOVERY_RESOURCES_TO_VENDOR_BOOT := true # 将recovery文件复制到vendor_boot<br />
<br />
# Boot recovery ramdisk<br />
#BOARD_USES_RECOVERY_AS_BOOT := true recovery ramdisk合并在boot中启用<br />
<br />
# Verified Boot<br />
BOARD_AVB_ENABLE := true<br />
BOARD_AVB_MAKE_VBMETA_IMAGE_ARGS += --flags 3<br />
<br />
# TWRP Configurations<br />
TW_DEFAULT_LANGUAGE := zh_CN # 默认为中文<br />
TW_EXTRA_LANGUAGES := true # 额外的语言<br />
TW_THEME := portrait_hdpi # 主题<br />
TW_INCLUDE_FASTBOOTD := true # 包括fastbootd，为动态分区<br />
<br />
# 其它flag还有很多，可以在https://xdaforums.com/t/twrp-flags-for-boardconfig-mk.3333970 查找，<br />
# 这篇文章也很老了，但我并不推荐twrp，所以flag我也不是很了解，多翻翻github:)<br />
<br />
# Debug<br />
TARGET_USES_LOGD := true # 调试flag<br />
TWRP_INCLUDE_LOGCAT := true<br />
无注释版<br />
DEVICE_PATH := device/vendor/codename<br />
<br />
# Architecture<br />
TARGET_ARCH := arm64<br />
TARGET_ARCH_VARIANT := armv8-a<br />
TARGET_CPU_ABI := arm64-v8a<br />
TARGET_CPU_ABI2 :=<br />
TARGET_CPU_VARIANT := generic<br />
TARGET_CPU_VARIANT_RUNTIME := cortex-a55<br />
<br />
TARGET_2ND_ARCH := arm<br />
TARGET_2ND_ARCH_VARIANT := $(TARGET_ARCH_VARIANT)<br />
TARGET_2ND_CPU_ABI := armeabi-v7a<br />
TARGET_2ND_CPU_ABI2 := armeabi<br />
TARGET_2ND_CPU_VARIANT := $(TARGET_CPU_VARIANT)<br />
TARGET_2ND_CPU_VARIANT_RUNTIME := $(TARGET_CPU_VARIANT)<br />
<br />
# Assertation<br />
TARGET_OTA_ASSERT_DEVICE := rubens<br />
<br />
# Bootloader<br />
TARGET_BOOTLOADER_BOARD_NAME := rubens<br />
TARGET_NO_BOOTLOADER := true<br />
TARGET_USES_UEFI := true<br />
<br />
# Build Rule<br />
ALLOW_MISSING_DEPENDENCIES := true<br />
<br />
# Kernel<br />
BOARD_BOOT_HEADER_VERSION := 4<br />
BOARD_KERNEL_BASE := 0x3fff8000<br />
BOARD_KERNEL_CMDLINE := bootopt=64S3,32N2,64N2<br />
BOARD_KERNEL_PAGESIZE := 4096<br />
BOARD_RAMDISK_OFFSET := 0x26f08000<br />
BOARD_KERNEL_TAGS_OFFSET := 0x07c88000<br />
BOARD_MKBOOTIMG_ARGS += --header_version $(BOARD_BOOT_HEADER_VERSION)<br />
BOARD_MKBOOTIMG_ARGS += --ramdisk_offset $(BOARD_RAMDISK_OFFSET)<br />
BOARD_MKBOOTIMG_ARGS += --tags_offset $(BOARD_KERNEL_TAGS_OFFSET)<br />
BOARD_KERNEL_IMAGE_NAME := Image<br />
<br />
# Kernel - prebuilt<br />
TARGET_PREBUILT_DTB := $(DEVICE_PATH)/prebuilt/dtb.img<br />
BOARD_MKBOOTIMG_ARGS += --dtb $(TARGET_PREBUILT_DTB)<br />
<br />
# Partitions<br />
BOARD_FLASH_BLOCK_SIZE := 262144<br />
BOARD_BOOTIMAGE_PARTITION_SIZE := 67108864<br />
BOARD_RECOVERYIMAGE_PARTITION_SIZE := 67108864<br />
BOARD_VENDOR_ROOTIMAGE_PARTITION_SIZE := 67108864<br />
BOARD_SYSTEMIMAGE_PARTITION_TYPE := ext4<br />
BOARD_USERDATAIMAGE_FILE_SYSTEM_TYPE := ext4<br />
BOARD_VENDORIMAGE_FILE_SYSTEM_TYPE := ext4<br />
TARGET_COPY_OUT_VENDOR := vendor<br />
BOARD_SUPER_PARTITION_SIZE := 9126805504<br />
BOARD_SUPER_PARTITION_GROUPS := xiaomi_dynamic_partitions<br />
BOARD_XIAOMI_DYNAMIC_PARTITIONS_PARTITION_LIST := system vendor product system_ext odm vendor_dlkm odm_dlkm<br />
BOARD_XIAOMI_DYNAMIC_PARTITIONS_SIZE := 9122611200<br />
<br />
# Platform<br />
TARGET_BOARD_PLATFORM := mt6895<br />
<br />
# Recovery<br />
BOARD_HAS_LARGE_FILESYSTEM := true<br />
TARGET_RECOVERY_PIXEL_FORMAT := RGBX_8888<br />
TARGET_USERIMAGES_USE_EXT4 := true<br />
TARGET_USERIMAGES_USE_F2FS := true<br />
<br />
# Treble<br />
BOARD_VNDK_VERSION := current<br />
<br />
# Vendor_boot recovery ramdisk<br />
BOARD_MOVE_RECOVERY_RESOURCES_TO_VENDOR_BOOT := true<br />
<br />
# Boot recovery ramdisk<br />
#BOARD_USES_RECOVERY_AS_BOOT := true<br />
<br />
# Verified Boot<br />
BOARD_AVB_ENABLE := true<br />
BOARD_AVB_MAKE_VBMETA_IMAGE_ARGS += --flags 3<br />
<br />
# TWRP Configurations<br />
TW_DEFAULT_LANGUAGE := zh_CN<br />
TW_EXTRA_LANGUAGES := true<br />
TW_THEME := portrait_hdpi<br />
TW_INCLUDE_FASTBOOTD := true<br />
<br />
# Debug<br />
TARGET_USES_LOGD := true<br />
TWRP_INCLUDE_LOGCAT := true<br />
这块写了好久我也不确定对不对，请各位指正，尤其是 Kernel 部分。<br />
<br />
==== 初始 device.mk 文件 ====<br />
<br />
* 准备好 prop.default<br />
<br />
选中 AndroidProducts.mk 并按照自己的资料复制并更改以下内容<br />
DEVICE_PATH := device/xiaomi/rubens<br />
<br />
# API<br />
PRODUCT_SHIPPING_API_LEVEL := 31 # ro.board.first_api_level<br />
<br />
# A/B<br />
AB_OTA_UPDATER := true # 启用A/B无缝更新<br />
AB_OTA_PARTITIONS += \ # 定义A/B分区，参考fstab<br />
boot \<br />
dtbo \<br />
system \<br />
product \<br />
vendor \<br />
odm \<br />
odm_dlkm \<br />
vbmeta \<br />
vendor_boot \<br />
vendor_dlkm \<br />
vbmeta_system \<br />
vbmeta_vendor<br />
<br />
PRODUCT_PACKAGES += \<br />
update_engine \<br />
update_engine_sideload \<br />
update_verifier \<br />
checkpoint_gc<br />
<br />
AB_OTA_POSTINSTALL_CONFIG += \<br />
RUN_POSTINSTALL_system=true \<br />
POSTINSTALL_PATH_system=system/bin/mtk_plpath_utils \<br />
FILESYSTEM_TYPE_system=ext4 \<br />
POSTINSTALL_OPTIONAL_system=true<br />
<br />
AB_OTA_POSTINSTALL_CONFIG += \<br />
RUN_POSTINSTALL_vendor=true \<br />
POSTINSTALL_PATH_vendor=bin/checkpoint_gc \<br />
FILESYSTEM_TYPE_vendor=ext4 \<br />
POSTINSTALL_OPTIONAL_vendor=true<br />
<br />
# Dynamic<br />
PRODUCT_USE_DYNAMIC_PARTITIONS := true # 动态分区<br />
<br />
# Soong namespaces<br />
PRODUCT_SOONG_NAMESPACES += $(DEVICE_PATH) # 命名空间<br />
<br />
* A/B 无缝更新部分高通和联发科不一样，联发科设备可以照抄，注意 system/bin/mtk_plpath_utils 就好。高通参考[https://github.com/sekaiacg/android_device_xiaomi_venus_TWRP/tree/android-13 venus twrp tree]，并且高通的[https://git.codelinaro.org/clo/la/platform/hardware/qcom/bootctrl bootctrl]和[https://git.codelinaro.org/clo/la/platform/vendor/qcom-opensource/recovery-ext gpt-utils]可以从 [[CLO]] 拿。<br />
<br />
无注释版<br />
PRODUCT_SHIPPING_API_LEVEL := 31<br />
<br />
# A/B<br />
AB_OTA_UPDATER := true<br />
AB_OTA_PARTITIONS += \<br />
boot \<br />
dtbo \<br />
system \<br />
product \<br />
vendor \<br />
odm \<br />
odm_dlkm \<br />
vbmeta \<br />
vendor_boot \<br />
vendor_dlkm \<br />
vbmeta_system \<br />
vbmeta_vendor<br />
<br />
PRODUCT_PACKAGES += \<br />
update_engine \<br />
update_engine_sideload \<br />
update_verifier \<br />
checkpoint_gc<br />
<br />
AB_OTA_POSTINSTALL_CONFIG += \<br />
RUN_POSTINSTALL_system=true \<br />
POSTINSTALL_PATH_system=system/bin/mtk_plpath_utils \<br />
FILESYSTEM_TYPE_system=ext4 \<br />
POSTINSTALL_OPTIONAL_system=true<br />
<br />
AB_OTA_POSTINSTALL_CONFIG += \<br />
RUN_POSTINSTALL_vendor=true \<br />
POSTINSTALL_PATH_vendor=bin/checkpoint_gc \<br />
FILESYSTEM_TYPE_vendor=ext4 \<br />
POSTINSTALL_OPTIONAL_vendor=true<br />
<br />
# Dynamic<br />
PRODUCT_USE_DYNAMIC_PARTITIONS := true<br />
<br />
# Soong namespaces<br />
PRODUCT_SOONG_NAMESPACES += $(DEVICE_PATH)<br />
<br />
==== 初始 twrp_rubens.mk 文件 ====<br />
选中 AndroidProducts.mk 并按照自己的资料复制并更改以下内容<br />
# Inherit from common AOSP config<br />
$(call inherit-product, $(SRC_TARGET_DIR)/product/base.mk)<br />
$(call inherit-product, $(SRC_TARGET_DIR)/product/core_64_bit_only.mk)<br />
$(call inherit-product, $(SRC_TARGET_DIR)/product/virtual_ab_ota/launch_with_vendor_ramdisk.mk) # vab加载到vendor boot里使用<br />
<br />
# Inherit from TWRP product configuration<br />
$(call inherit-product, vendor/twrp/config/common.mk) # twrp-9分支改为onmi<br />
<br />
# Device specific configs<br />
$(call inherit-product, device/xiaomi/rubens/device.mk)<br />
<br />
# Device identifier<br />
PRODUCT_DEVICE := rubens # 设备型号<br />
PRODUCT_NAME := twrp_rubens # 设备名称<br />
PRODUCT_BRAND := Redmi # 自定义品牌，如果有<br />
PRODUCT_MODEL := 22041211AC # 产品最终用户可见名称<br />
PRODUCT_MANUFACTURER := Xiaomi # 制造商<br />
<br />
PRODUCT_PROPERTY_OVERRIDES += ro.twrp.vendor_boot=true # 对twrp启动vendor_boot支持<br />
无注释版<br />
# Inherit from common AOSP config<br />
$(call inherit-product, $(SRC_TARGET_DIR)/product/base.mk)<br />
$(call inherit-product, $(SRC_TARGET_DIR)/product/core_64_bit_only.mk)<br />
$(call inherit-product, $(SRC_TARGET_DIR)/product/virtual_ab_ota/launch_with_vendor_ramdisk.mk) # vab加载到vendor boot里使用<br />
<br />
# Inherit from TWRP product configuration<br />
$(call inherit-product, vendor/twrp/config/common.mk)<br />
<br />
# Device specific configs<br />
$(call inherit-product, device/xiaomi/rubens/device.mk)<br />
<br />
# Device identifier<br />
PRODUCT_DEVICE := rubens<br />
PRODUCT_NAME := twrp_rubens<br />
PRODUCT_BRAND := Redmi<br />
PRODUCT_MODEL := 22041211AC<br />
PRODUCT_MANUFACTURER := Xiaomi<br />
<br />
PRODUCT_PROPERTY_OVERRIDES += ro.twrp.vendor_boot=true<br />
<br />
==== 初始 recovery 目录 ====<br />
<blockquote>拿出我们好久之前准备的 ramdisk 叭</blockquote>通过tree命令我们可以查看 ramdisk 的树状图，可以很清晰的查看包含的文件<br />
├── acct<br />
├── apex<br />
├── bin -> /system/bin<br />
├── bugreports -> /data/user_de/0/com.android.shell/files/bugreports<br />
├── config<br />
├── d -> /sys/kernel/debug<br />
├── data<br />
├── data_mirror<br />
├── debug_ramdisk<br />
├── default.prop -> prop.default<br />
├── dev<br />
├── etc -> /system/etc<br />
├── first_stage_ramdisk<br />
│ ├── fstab.emmc<br />
│ ├── fstab.mt6895<br />
│ └── system<br />
│ ├── bin<br />
│ │ ├── e2fsck<br />
│ │ ├── linker64<br />
│ │ ├── linker_asan64 -> linker64<br />
│ │ └── snapuserd<br />
│ └── lib64<br />
│ ├── ld-android.so<br />
│ ├── libbase.so<br />
│ ├── libc++.so<br />
│ ├── libc.so<br />
│ ├── libdl.so<br />
│ ├── libext2_blkid.so<br />
│ ├── libext2_com_err.so<br />
│ ├── libext2_e2p.so<br />
│ ├── libext2_quota.so<br />
│ ├── libext2_uuid.so<br />
│ ├── libext2fs.so<br />
│ ├── liblog.so<br />
│ ├── libm.so<br />
│ ├── libsparse.so<br />
│ └── libz.so<br />
├── init -> /system/bin/init<br />
├── init.recovery.hardware.rc<br />
├── init.recovery.mt6895.rc<br />
└── 等等等等...省略大概1000个文件吧<br />
<blockquote>因为避免教程时效性，我们尽可能选取 prebuilt 的办法，如 boot 和 mtk_plpath_utils 都采用预编译。</blockquote>里面有很多文件是没用的，整理一下，对我们有用的只有这些<br />
.<br />
├── first_stage_ramdisk<br />
│ ├── fstab.emmc<br />
│ └── fstab.mt6895<br />
├── init.recovery.mt6895.rc<br />
├── lib<br />
│ └── modules<br />
│ ├── 8250_mtk.ko<br />
│ ├── adapter_class.ko<br />
│ ├── adsp.ko<br />
│ ├── aee_aed.ko<br />
│ ├── aee_hangdet.ko<br />
│ ├── aee_rs.ko<br />
│ ├── blocktag.ko<br />
│ ├── bootprof.ko<br />
│ ├── bq28z610.ko<br />
│ ├── cache-parity.ko<br />
│ ├── cfg80211.ko<br />
│ ├── charger_class.ko<br />
│ └── 省略一百多个模块，这个目录里的东西全要<br />
└── system<br />
├── bin<br />
│ └── mtk_plpath_utils<br />
├── etc<br />
│ ├── init<br />
│ │ │── mtk-plpath-utils.rc<br />
│ │ └──hw<br />
│ │ └──init.rc<br />
│ ├── recovery.fstab<br />
│ ├── security<br />
│ │ └── otacerts.zip<br />
│ └── ueventd.rc<br />
└── lib64<br />
└── hw<br />
└── android.hardware.boot@1.0-impl-1.2-mtkimpl.so<br />
将它们按照以下操作复制<br />
<br />
* first_stage_ramdisk --> recovery/root/first_stage_ramdisk<br />
* init.recovery.mt6895.rc --> recovery/root/init.recovery.mt6895.rc<br />
* lib --> recovery/root/lib<br />
* system --> recovery/root/system (security 和 hw 文件夹里的内容作为备用，不要复制进去) 得到以下目录结构<br />
<br />
.<br />
├── Android.mk<br />
├── AndroidProducts.mk<br />
├── BoardConfig.mk<br />
├── device.mk<br />
├── prebuilt<br />
├── recovery<br />
│ └── root<br />
│ ├── first_stage_ramdisk<br />
│ │ ├── fstab.emmc<br />
│ │ └── fstab.mt6895<br />
│ ├── init.recovery.mt6895.rc<br />
│ ├── lib<br />
│ │ └── modules<br />
│ │ ├── 8250_mtk.ko<br />
│ │ ├── adapter_class.ko<br />
│ │ ├── adsp.ko<br />
│ │ ├── aee_aed.ko<br />
│ │ ├── aee_hangdet.ko<br />
│ │ ├── aee_rs.ko<br />
│ │ ├── blocktag.ko<br />
│ │ └── 省略....<br />
│ └── system<br />
│ ├── bin<br />
│ │ └── mtk_plpath_utils<br />
│ ├── etc<br />
│ │ ├── recovery.fstab<br />
│ │ └── ueventd.rc<br />
│ └── lib64<br />
│ └── hw<br />
│ └── android.hardware.boot@1.0-impl-1.2-mtkimpl.so<br />
└── twrp_rubens.mk<br />
打开 init.recovery.mt6895.rc 添加<br />
on boot<br />
start health-hal-2-1<br />
<br />
on post-fs<br />
start boot-hal-1-2<br />
例如<br />
on post-fs<br />
start boot-hal-1-2<br />
<br />
on init<br />
setprop sys.usb.configfs 1<br />
setprop sys.usb.controller "11201000.usb0"<br />
setprop sys.usb.ffs.aio_compat 1<br />
<br />
on fs && property:ro.debuggable=0<br />
# distinguish USB shoulde connect or not, i.e. CDP vs SDP<br />
# set charging free due to it wait for USB activation<br />
<br />
on boot<br />
start health-hal-2-1<br />
exec u:r:update_engine:s0 root root -- /system/bin/mtk_plpath_utils<br />
<br />
接下来可以开始编译咯~~<br />
<br />
==== 编译 ====<br />
<blockquote>编译前请检查注释是否全部删除</blockquote>twrp 源码根目录执行<br />
. build/envsetup.sh<br />
lunch twrp_codename-eng # twrp-9为onmi<br />
mka vendorbootimg/bootimage/recoveryimage<br />
不出意外的话一路绿灯，如果有报错的话请发邮箱至 1592501605@qq.com 咨询我<br />
<br />
产物在 out/target/product/codename/vendor_boot.img\boot.img\recovery.img<br />
<br />
手机重启到 fastboot 模式，使用 fastboot flash 刷写，例如<br />
fastboot flash vendor_boot /Users/xiaolegun/Downloads/vendor_boot.img<br />
则输出<br />
ERROR: could not clear input pipe; result e0005000, ignoring...<br />
ERROR: could not clear output pipe; result e0005000, ignoring....<br />
Sending 'vendor_boot_a' (65536 KB) OKAY [ 1.396s]<br />
Writing 'vendor_boot_a' OKAY [ 0.167s]<br />
Finished. Total time: 1.625s<br />
就可以重启按电源加音量上尝试了，我自己是一次点亮，但有 bug。<br />
<br />
==== 修 BUG ====<br />
<br />
===== 修复 USB =====<br />
我看到 twrp 控制台有很多报错，第一步肯定是先获取日志，使用logcat命令获取，在此之前先使用adb devices检测一下设备 usb 是否工作正常。<br />
xiaolegun@xiaoleGundeMac-Pro ~ adb devices ✔ 10208 10:05:31<br />
* daemon not running; starting now at tcp:5037<br />
* daemon started successfully<br />
List of devices attached<br />
可以看到adb没有检测到设备，原因一般是 usb 的配置不对，但 usb 是好的。这时可以尝试关闭 mtp，再开启，如果电脑有反应，那么就可以继续下一步了。<br />
<br />
在设备树中的 recovery/root，创建 init.recovery.usb.rc 的文件<br />
touch recovery/root/init.recovery.usb.rc<br />
并导入以下内容<br />
on property:sys.usb.config=mtp,adb<br />
start adbd<br />
<br />
on property:sys.usb.ffs.ready=1 && property:sys.usb.config=mtp,adb<br />
write /config/usb_gadget/g1/configs/b.1/strings/0x409/configuration "mtp_adb"<br />
rm /config/usb_gadget/g1/configs/b.1/f1<br />
rm /config/usb_gadget/g1/configs/b.1/f2<br />
rm /config/usb_gadget/g1/configs/b.1/f3<br />
rm /config/usb_gadget/g1/configs/b.1/f4<br />
rm /config/usb_gadget/g1/configs/b.1/f5<br />
write /config/usb_gadget/g1/idVendor 0x18d1<br />
write /config/usb_gadget/g1/idProduct 0x2d08<br />
symlink /config/usb_gadget/g1/functions/mtp.gs0 /config/usb_gadget/g1/configs/b.1/f1<br />
symlink /config/usb_gadget/g1/functions/ffs.adb /config/usb_gadget/g1/configs/b.1/f2<br />
write /config/usb_gadget/g1/UDC ${sys.usb.controller}<br />
setprop sys.usb.state ${sys.usb.config}<br />
这是我从我维护的 MI 6X 的 device tree 拿过来的，可以在联发科设备上正常工作。这段 shell 的大致意思就是在 usb 配置节点写入 mtp 和 adb 同时工作的字符串，这样 adb 就能顺利工作了。<br />
<br />
此外打开原厂 init.rc 修正一下 usb 设备的 id<br />
# MIUI ADD: START<br />
import /init.recovery.hardware.rc<br />
import /miui.factoryreset.rc<br />
# END<br />
import /init.recovery.${ro.hardware}.rc<br />
<br />
########### 省略一万字<br />
<br />
# MIUI ADD: START<br />
on property:sys.usb.config=mtp,adb && property:sys.usb.configfs=0<br />
write /sys/class/android_usb/android0/enable 0<br />
write /sys/class/android_usb/android0/idVendor 2717<br />
write /sys/class/android_usb/android0/idProduct 904D<br />
write /sys/class/android_usb/android0/functions mtp,adb<br />
write /sys/class/android_usb/android0/enable 1<br />
setprop sys.usb.state ${sys.usb.config}<br />
# END<br />
将/sys/class/android_usb/android0/idVendor和write /sys/class/android_usb/android0/idProduct后面的 id 分别替换到/config/usb_gadget/g1/idVendor和/config/usb_gadget/g1/idProduct处理完就是这样的。<br />
on property:sys.usb.config=mtp,adb<br />
start adbd<br />
<br />
on property:sys.usb.ffs.ready=1 && property:sys.usb.config=mtp,adb<br />
write /config/usb_gadget/g1/configs/b.1/strings/0x409/configuration "mtp_adb"<br />
rm /config/usb_gadget/g1/configs/b.1/f1<br />
rm /config/usb_gadget/g1/configs/b.1/f2<br />
rm /config/usb_gadget/g1/configs/b.1/f3<br />
rm /config/usb_gadget/g1/configs/b.1/f4<br />
rm /config/usb_gadget/g1/configs/b.1/f5<br />
write /config/usb_gadget/g1/idVendor 0x2717<br />
write /config/usb_gadget/g1/idProduct 0x904D<br />
symlink /config/usb_gadget/g1/functions/mtp.gs0 /config/usb_gadget/g1/configs/b.1/f1<br />
symlink /config/usb_gadget/g1/functions/ffs.adb /config/usb_gadget/g1/configs/b.1/f2<br />
write /config/usb_gadget/g1/UDC ${sys.usb.controller}<br />
setprop sys.usb.state ${sys.usb.config}<br />
接下来开机之后 adb 和 mtp 就能同时工作了。<br />
<br />
===== 修复 Resetprop =====<br />
接下来就可以修复其它 bug 了，我看到控制台有一堆红色的报错:<br />
E:Unknown File System:'/mi_ext'<br />
E:Unable to override 'external_storage.projid.enabled' due to missing libresetprop<br />
挂载“/data”失败(Invalid argument)<br />
这三个报错中第二个最好修，第一个次之，第三个与解密有关，放在另一个大章节讲。<br />
<br />
第二个报错只需要在 BoardConfig.mk 中添加<br />
# Tool<br />
TW_INCLUDE_RESETPROP := true<br />
TW_INCLUDE_LIBRESETPROP := true<br />
不用编译测试直接秒杀<br />
<br />
===== 修复挂载 =====<br />
E:Unknown File System:'/mi_ext'<br />
我们打开 recovery/root/system/etc 中的 recovery.fstab，发现里面有很多空格，我们先将它格式化一下，有实力的可以把后面的 flag 也对齐整理好。<br />
<br />
我比较没实力，简单格式化了一下，是这样的<br />
# 1 "vendor/mediatek/proprietary/hardware/fstab/mt6895/fstab.in.mt6895"<br />
# 1 "<built-in>" 1<br />
# 1 "<built-in>" 3<br />
# 341 "<built-in>" 3<br />
# 1 "<command line>" 1<br />
# 1 "<built-in>" 2<br />
# 1 "vendor/mediatek/proprietary/hardware/fstab/mt6895/fstab.in.mt6895" 2<br />
# 173 "vendor/mediatek/proprietary/hardware/fstab/mt6895/fstab.in.mt6895"<br />
system /system erofs ro wait,slotselect,avb=vbmeta_system,logical,first_stage_mount,avb_keys=/avb/q-gsi.avbpubkey:/avb/r-gsi.avbpubkey:/avb/s-gsi.avbpubkey<br />
system /system ext4 ro wait,slotselect,avb=vbmeta_system,logical,first_stage_mount,avb_keys=/avb/q-gsi.avbpubkey:/avb/r-gsi.avbpubkey:/avb/s-gsi.avbpubkey<br />
vendor /vendor erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
vendor /vendor ext4 ro wait,slotselect,avb,logical,first_stage_mount<br />
product /product erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
product /product ext4 ro wait,slotselect,avb,logical,first_stage_mount<br />
mi_ext /mnt/vendor/mi_ext erofs ro wait,slotselect,avb=vbmeta,logical,first_stage_mount,nofail<br />
mi_ext /mnt/vendor/mi_ext ext4 ro wait,slotselect,avb=vbmeta,logical,first_stage_mount,nofail<br />
/mnt/vendor/mi_ext /mi_ext none ro,bind wait,nofail<br />
overlay /product/overlay overlay ro,lowerdir=/mnt/vendor/mi_ext/product/overlay/:/product/overlay check,nofail<br />
overlay /product/app overlay ro,lowerdir=/mnt/vendor/mi_ext/product/app/:/product/app check,nofail<br />
overlay /product/priv-app overlay ro,lowerdir=/mnt/vendor/mi_ext/product/priv-app/:/product/priv-app check,nofail<br />
overlay /product/lib overlay ro,lowerdir=/mnt/vendor/mi_ext/product/lib/:/product/lib check,nofail<br />
overlay /product/lib64 overlay ro,lowerdir=/mnt/vendor/mi_ext/product/lib64/:/product/lib64 check,nofail<br />
overlay /product/bin overlay ro,lowerdir=/mnt/vendor/mi_ext/product/bin/:/product/bin check,nofail<br />
overlay /product/framework overlay ro,lowerdir=/mnt/vendor/mi_ext/product/framework/:/product/framework check,nofail<br />
overlay /product/media overlay ro,lowerdir=/mnt/vendor/mi_ext/product/media/:/product/media check,nofail<br />
overlay /product/opcust overlay ro,lowerdir=/mnt/vendor/mi_ext/product/opcust/:/product/opcust check,nofail<br />
overlay /product/data-app overlay ro,lowerdir=/mnt/vendor/mi_ext/product/data-app/:/product/data-app check,nofail<br />
overlay /product/etc/sysconfig overlay ro,lowerdir=/mnt/vendor/mi_ext/product/etc/sysconfig/:/product/etc/sysconfig check,nofail<br />
overlay /product/etc/permissions overlay ro,lowerdir=/mnt/vendor/mi_ext/product/etc/permissions/:/product/etc/permissions check,nofail<br />
overlay /system/app overlay ro,lowerdir=/mnt/vendor/mi_ext/system/app/:/product/pangu/system/app/:/system/app check,nofail<br />
overlay /system/priv-app overlay ro,lowerdir=/mnt/vendor/mi_ext/system/priv-app/:/product/pangu/system/priv-app/:/system/priv-app check,nofail<br />
overlay /system/framework overlay ro,lowerdir=/product/pangu/system/framework/:/system/framework check,nofail<br />
overlay /system/etc/sysconfig overlay ro,lowerdir=/mnt/vendor/mi_ext/system/etc/sysconfig/:/system/etc/sysconfig check,nofail<br />
overlay /system/etc/permissions overlay ro,lowerdir=/mnt/vendor/mi_ext/system/etc/permissions/:/product/pangu/system/etc/permissions/:/system/etc/permissions check,nofail<br />
system_ext /system_ext erofs ro wait,slotselect,avb=vbmeta_system,logical,first_stage_mount,avb_keys=/avb/q-gsi.avbpubkey:/avb/r-gsi.avbpubkey:/avb/s-gsi.avbpubkey<br />
system_ext /system_ext ext4 ro wait,slotselect,avb=vbmeta_system,logical,first_stage_mount,avb_keys=/avb/q-gsi.avbpubkey:/avb/r-gsi.avbpubkey:/avb/s-gsi.avbpubkey<br />
odm /odm erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
odm /odm ext4 ro wait,slotselect,avb,logical,first_stage_mount<br />
vendor_dlkm /vendor_dlkm erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
odm_dlkm /odm_dlkm erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
/dev/block/by-name/metadata /metadata ext4 noatime,nosuid,nodev,discard wait,check,formattable,first_stage_mount<br />
/dev/block/by-name/userdata /data f2fs noatime,nosuid,nodev,discard,noflush_merge,fsync_mode=nobarrier,reserve_root=134217,resgid=1065,checkpoint_merge,gc_merge,inlinecrypt wait,check,formattable,quota,latemount,resize,reservedsize=128m,checkpoint=fs,fileencryption=aes-256-xts:aes-256-cts:v2+inlinecrypt_optimized,keydirectory=/metadata/vold/metadata_encryption,fsverity<br />
/dev/block/by-name/rescue /cache ext4 noatime,nosuid,nodev,noauto_da_alloc,discard wait,check,formattable<br />
/dev/block/by-name/protect1 /mnt/vendor/protect_f ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/dev/block/by-name/protect2 /mnt/vendor/protect_s ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/dev/block/by-name/nvdata /mnt/vendor/nvdata ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/dev/block/by-name/nvcfg /mnt/vendor/nvcfg ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/dev/block/by-name/persist /mnt/vendor/persist ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/devices/platform/soc/11240000.mmc* auto auto defaults voldmanaged=sdcard1:auto,encryptable=userdata<br />
/devices/platform/usb_xhci* auto vfat defaults voldmanaged=usbotg:auto<br />
/devices/platform/soc/11201000.usb0/11200000.xhci* auto vfat defaults voldmanaged=usbotg:auto<br />
/dev/block/by-name/frp /persistent emmc defaults defaults<br />
/dev/block/by-name/nvram /nvram emmc defaults defaults<br />
/dev/block/by-name/proinfo /proinfo emmc defaults defaults<br />
/dev/block/by-name/lk /bootloader emmc defaults defaults<br />
/dev/block/by-name/lk2 /bootloader2 emmc defaults defaults<br />
/dev/block/by-name/para /para emmc defaults defaults<br />
/dev/block/by-name/misc /misc emmc defaults defaults<br />
/dev/block/by-name/boot /boot emmc defaults first_stage_mount,nofail,slotselect<br />
/dev/block/by-name/vbmeta_vendor /vbmeta_vendor emmc defaults first_stage_mount,nofail,slotselect<br />
/dev/block/by-name/vbmeta_system /vbmeta_system emmc defaults first_stage_mount,nofail,slotselect,avb=vbmeta<br />
/dev/block/by-name/logo /logo emmc defaults defaults<br />
/dev/block/by-name/expdb /expdb emmc defaults defaults<br />
/dev/block/by-name/seccfg /seccfg emmc defaults defaults<br />
/dev/block/by-name/tee1 /tee1 emmc defaults defaults<br />
/dev/block/by-name/tee2 /tee2 emmc defaults defaults<br />
/dev/block/by-name/scp1 /scp1 emmc defaults defaults<br />
/dev/block/by-name/scp2 /scp2 emmc defaults defaults<br />
/dev/block/by-name/sspm_1 /sspm_1 emmc defaults defaults<br />
/dev/block/by-name/sspm_2 /sspm_2 emmc defaults defaults<br />
/dev/block/by-name/dpm_1 /dpm_1 emmc defaults defaults<br />
/dev/block/by-name/dpm_2 /dpm_2 emmc defaults defaults<br />
/dev/block/by-name/mcupm_1 /mcupm_1 emmc defaults defaults<br />
/dev/block/by-name/mcupm_2 /mcupm_2 emmc defaults defaults<br />
/dev/block/by-name/md1img /md1img emmc defaults defaults<br />
/dev/block/by-name/md1dsp /md1dsp emmc defaults defaults<br />
/dev/block/by-name/md1arm7 /md1arm7 emmc defaults defaults<br />
/dev/block/by-name/md3img /md3img emmc defaults defaults<br />
/dev/block/by-name/gz1 /gz1 emmc defaults defaults<br />
/dev/block/by-name/gz2 /gz2 emmc defaults defaults<br />
/dev/block/by-name/spmfw /spmfw emmc defaults defaults<br />
/dev/block/by-name/audio_dsp /audio_dsp emmc defaults defaults<br />
/dev/block/by-name/pi_img /pi_img emmc defaults defaults<br />
/dev/block/by-name/boot_para /boot_para emmc defaults defaults<br />
/dev/block/by-name/odmdtbo /odmdtbo emmc defaults defaults<br />
/dev/block/by-name/dtbo /dtbo emmc defaults defaults<br />
/dev/block/by-name/otp /otp emmc defaults defaults<br />
/dev/block/by-name/vbmeta /vbmeta emmc defaults defaults<br />
这里面有很多无用分区，我们在 twrp 中操作不到，但是我也是第一次适配 MTK 设备，所以不“瞎说”误人子弟了，先把 bug 修好。<br />
<br />
像 xiaomi 这样常见的挂载错误，我自己一般都是尝试把/mnt/vendor 使用 vscode 全部删除，让我们尝试一下。并且要把这一行删除，这行在我看来是重复定义（？而且也没指定分区格式。<br />
/mnt/vendor/mi_ext /mi_ext none ro,bind wait,nofail<br />
整理完之后是这样的<br />
# 1 "vendor/mediatek/proprietary/hardware/fstab/mt6895/fstab.in.mt6895"<br />
# 1 "<built-in>" 1<br />
# 1 "<built-in>" 3<br />
# 341 "<built-in>" 3<br />
# 1 "<command line>" 1<br />
# 1 "<built-in>" 2<br />
# 1 "vendor/mediatek/proprietary/hardware/fstab/mt6895/fstab.in.mt6895" 2<br />
# 173 "vendor/mediatek/proprietary/hardware/fstab/mt6895/fstab.in.mt6895"<br />
system /system erofs ro wait,slotselect,avb=vbmeta_system,logical,first_stage_mount,avb_keys=/avb/q-gsi.avbpubkey:/avb/r-gsi.avbpubkey:/avb/s-gsi.avbpubkey<br />
system /system ext4 ro wait,slotselect,avb=vbmeta_system,logical,first_stage_mount,avb_keys=/avb/q-gsi.avbpubkey:/avb/r-gsi.avbpubkey:/avb/s-gsi.avbpubkey<br />
vendor /vendor erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
vendor /vendor ext4 ro wait,slotselect,avb,logical,first_stage_mount<br />
product /product erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
product /product ext4 ro wait,slotselect,avb,logical,first_stage_mount<br />
mi_ext /mi_ext erofs ro wait,slotselect,avb=vbmeta,logical,first_stage_mount,nofail<br />
mi_ext /mi_ext ext4 ro wait,slotselect,avb=vbmeta,logical,first_stage_mount,nofail<br />
overlay /product/overlay overlay ro,lowerdir=/mi_ext/product/overlay/:/product/overlay check,nofail<br />
overlay /product/app overlay ro,lowerdir=/mi_ext/product/app/:/product/app check,nofail<br />
overlay /product/priv-app overlay ro,lowerdir=/mi_ext/product/priv-app/:/product/priv-app check,nofail<br />
overlay /product/lib overlay ro,lowerdir=/mi_ext/product/lib/:/product/lib check,nofail<br />
overlay /product/lib64 overlay ro,lowerdir=/mi_ext/product/lib64/:/product/lib64 check,nofail<br />
overlay /product/bin overlay ro,lowerdir=/mi_ext/product/bin/:/product/bin check,nofail<br />
overlay /product/framework overlay ro,lowerdir=/mi_ext/product/framework/:/product/framework check,nofail<br />
overlay /product/media overlay ro,lowerdir=/mi_ext/product/media/:/product/media check,nofail<br />
overlay /product/opcust overlay ro,lowerdir=/mi_ext/product/opcust/:/product/opcust check,nofail<br />
overlay /product/data-app overlay ro,lowerdir=/mi_ext/product/data-app/:/product/data-app check,nofail<br />
overlay /product/etc/sysconfig overlay ro,lowerdir=/mi_ext/product/etc/sysconfig/:/product/etc/sysconfig check,nofail<br />
overlay /product/etc/permissions overlay ro,lowerdir=/mi_ext/product/etc/permissions/:/product/etc/permissions check,nofail<br />
overlay /system/app overlay ro,lowerdir=/mi_ext/system/app/:/product/pangu/system/app/:/system/app check,nofail<br />
overlay /system/priv-app overlay ro,lowerdir=/mi_ext/system/priv-app/:/product/pangu/system/priv-app/:/system/priv-app check,nofail<br />
overlay /system/framework overlay ro,lowerdir=/product/pangu/system/framework/:/system/framework check,nofail<br />
overlay /system/etc/sysconfig overlay ro,lowerdir=/mi_ext/system/etc/sysconfig/:/system/etc/sysconfig check,nofail<br />
overlay /system/etc/permissions overlay ro,lowerdir=/mi_ext/system/etc/permissions/:/product/pangu/system/etc/permissions/:/system/etc/permissions check,nofail<br />
system_ext /system_ext erofs ro wait,slotselect,avb=vbmeta_system,logical,first_stage_mount,avb_keys=/avb/q-gsi.avbpubkey:/avb/r-gsi.avbpubkey:/avb/s-gsi.avbpubkey<br />
system_ext /system_ext ext4 ro wait,slotselect,avb=vbmeta_system,logical,first_stage_mount,avb_keys=/avb/q-gsi.avbpubkey:/avb/r-gsi.avbpubkey:/avb/s-gsi.avbpubkey<br />
odm /odm erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
odm /odm ext4 ro wait,slotselect,avb,logical,first_stage_mount<br />
vendor_dlkm /vendor_dlkm erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
odm_dlkm /odm_dlkm erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
/dev/block/by-name/metadata /metadata ext4 noatime,nosuid,nodev,discard wait,check,formattable,first_stage_mount<br />
/dev/block/by-name/userdata /data f2fs noatime,nosuid,nodev,discard,noflush_merge,fsync_mode=nobarrier,reserve_root=134217,resgid=1065,checkpoint_merge,gc_merge,inlinecrypt wait,check,formattable,quota,latemount,resize,reservedsize=128m,checkpoint=fs,fileencryption=aes-256-xts:aes-256-cts:v2+inlinecrypt_optimized,keydirectory=/metadata/vold/metadata_encryption,fsverity<br />
/dev/block/by-name/rescue /cache ext4 noatime,nosuid,nodev,noauto_da_alloc,discard wait,check,formattable<br />
/dev/block/by-name/protect1 /protect_f ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/dev/block/by-name/protect2 /protect_s ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/dev/block/by-name/nvdata /nvdata ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/dev/block/by-name/nvcfg /nvcfg ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/dev/block/by-name/persist /persist ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/devices/platform/soc/11240000.mmc* auto auto defaults voldmanaged=sdcard1:auto,encryptable=userdata<br />
/devices/platform/usb_xhci* auto vfat defaults voldmanaged=usbotg:auto<br />
/devices/platform/soc/11201000.usb0/11200000.xhci* auto vfat defaults voldmanaged=usbotg:auto<br />
/dev/block/by-name/frp /persistent emmc defaults defaults<br />
/dev/block/by-name/nvram /nvram emmc defaults defaults<br />
/dev/block/by-name/proinfo /proinfo emmc defaults defaults<br />
/dev/block/by-name/lk /bootloader emmc defaults defaults<br />
/dev/block/by-name/lk2 /bootloader2 emmc defaults defaults<br />
/dev/block/by-name/para /para emmc defaults defaults<br />
/dev/block/by-name/misc /misc emmc defaults defaults<br />
/dev/block/by-name/boot /boot emmc defaults first_stage_mount,nofail,slotselect<br />
/dev/block/by-name/vbmeta_vendor /vbmeta_vendor emmc defaults first_stage_mount,nofail,slotselect<br />
/dev/block/by-name/vbmeta_system /vbmeta_system emmc defaults first_stage_mount,nofail,slotselect,avb=vbmeta<br />
/dev/block/by-name/logo /logo emmc defaults defaults<br />
/dev/block/by-name/expdb /expdb emmc defaults defaults<br />
/dev/block/by-name/seccfg /seccfg emmc defaults defaults<br />
/dev/block/by-name/tee1 /tee1 emmc defaults defaults<br />
/dev/block/by-name/tee2 /tee2 emmc defaults defaults<br />
/dev/block/by-name/scp1 /scp1 emmc defaults defaults<br />
/dev/block/by-name/scp2 /scp2 emmc defaults defaults<br />
/dev/block/by-name/sspm_1 /sspm_1 emmc defaults defaults<br />
/dev/block/by-name/sspm_2 /sspm_2 emmc defaults defaults<br />
/dev/block/by-name/dpm_1 /dpm_1 emmc defaults defaults<br />
/dev/block/by-name/dpm_2 /dpm_2 emmc defaults defaults<br />
/dev/block/by-name/mcupm_1 /mcupm_1 emmc defaults defaults<br />
/dev/block/by-name/mcupm_2 /mcupm_2 emmc defaults defaults<br />
/dev/block/by-name/md1img /md1img emmc defaults defaults<br />
/dev/block/by-name/md1dsp /md1dsp emmc defaults defaults<br />
/dev/block/by-name/md1arm7 /md1arm7 emmc defaults defaults<br />
/dev/block/by-name/md3img /md3img emmc defaults defaults<br />
/dev/block/by-name/gz1 /gz1 emmc defaults defaults<br />
/dev/block/by-name/gz2 /gz2 emmc defaults defaults<br />
/dev/block/by-name/spmfw /spmfw emmc defaults defaults<br />
/dev/block/by-name/audio_dsp /audio_dsp emmc defaults defaults<br />
/dev/block/by-name/pi_img /pi_img emmc defaults defaults<br />
/dev/block/by-name/boot_para /boot_para emmc defaults defaults<br />
/dev/block/by-name/odmdtbo /odmdtbo emmc defaults defaults<br />
/dev/block/by-name/dtbo /dtbo emmc defaults defaults<br />
/dev/block/by-name/otp /otp emmc defaults defaults<br />
/dev/block/by-name/vbmeta /vbmeta emmc defaults defaults<br />
让我们编译试一下，值得注意的是，twrp 每次更改最好删除 out 重新编译，不要使用如make installclean等命令，可能会开机黑屏或更改不生效。<br />
<br />
经过一分钟，编译好了，刷入，开机，启动！可以看见挂载成功被修好。<br />
<br />
===== 修复屏幕显示 =====<br />
可以看到我们现在屏幕的顶部的时间被摄像头挖孔挡住了。我们使用两个偏移 Flag 来修复它。<br />
<br />
在 BoardConfig.mk 中，加入以下 flag<br />
TW_Y_OFFSET := 106 #导航栏向上<br />
TW_H_OFFSET := -106 #界面整体向下<br />
<br />
===== 修复振动 =====<br />
<blockquote>仅供参考，研究半天发现只有解密功能正常才能修振动，不然会冻屏！！！<br />
<br />
不一定正确，也不一定普遍，仅供指路</blockquote>老设备一般都是正常的，不需要额外处理，新设备使用 aidl hal 需要我们自己处理一下让 service 正常工作。<br />
<br />
挂载 vendor，使用 twrp 的文件管理，在 vendor/etc/vintf/manifest 找到含有 vibrator 字样的文件。打开之后检查是否类似这样的文段<br />
<manifest version="1.0" type="device"><br />
<hal format="aidl" override="true"><br />
<name>android.hardware.vibrator</name><br />
<fqname>IVibrator/vibratorfeature</fqname><br />
</hal><br />
</manifest><br />
那恭喜你，找对了，我的文件名是<br />
<br />
vendor.xiaomi.hardware.vibratorfeature.service.xml<br />
<br />
将它使用adb pull放到电脑上自己方便的位置备用。<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/$/mjw adb pull /vendor/etc/vintf/manifest/vendor.xiaomi.hardware.vibratorfeature.service.xml .<br />
/vendor/etc/vintf/manifest/vendor.xiao...ipped. 0.2 MB/s (1718 bytes in 0.009s)<br />
不看扩展名，到 vendor/bin/hw/找到同名的 service 同样利用adb pull放电脑备用。比如我的叫<br />
<br />
vendor.xiaomi.hardware.vibratorfeature.service<br />
<br />
然后到 vendor/etc/init/找到同名.rc 文件，拉到电脑上，在里面加一条。并在定义 service 的最下面加上seclabel u:r:recovery:s0可以被 recovery 使用。<br />
on boot<br />
start service被定义的名字<br />
例如<br />
on post-fs-data<br />
chown system system /sys/bus/i2c/drivers/aw8697_haptic/2-005a/f0_save<br />
chown system system /sys/bus/i2c/drivers/aw8697_haptic/2-005a/osc_save<br />
chown system system /sys/bus/i2c/drivers/aw8697_haptic/3-005a/osc_save<br />
# 省略一万字<br />
<br />
on boot<br />
start vibratorfeature-hal-service<br />
<br />
service vibratorfeature-hal-service /vendor/bin/hw/vendor.xiaomi.hardware.vibratorfeature.service<br />
class hal<br />
user system<br />
group system input<br />
onrestart restart vibratorfeature<br />
seclabel u:r:recovery:s0<br />
此外这种新设备在内核里还有振动模块需要加载，请到/vendor/modules/1.1/中寻找，例如我这台设备是haptic.ko，用 adb pull 拉取到电脑上，然后<br />
<br />
* haptic.ko --> recovery/root/vendor/modules/1.1<br />
<br />
至此所有必要的资料就准备好了。可能开机后仍然不工作，需要抓取 log 补缺失的 library，当然这是后话了。<br />
<br />
开干！<br />
<br />
在 BoardConfig.mk 中加入以下 flag<br />
TW_SUPPORT_INPUT_AIDL_HAPTICS := true<br />
将备用文件按照以下操作复制<br />
<br />
* vendor.xiaomi.hardware.vibratorfeature.service.xml --> recovery/root/vendor/etc/vintf/manifest<br />
* vendor.xiaomi.hardware.vibratorfeature.service --> recovery/root/vendor/bin/hw<br />
* vendor.xiaomi.hardware.vibratorfeature.service.rc --> recovery/root/vendor/etc/init<br />
<br />
之后编译，刷入，开机，喜提冻屏......<br />
<br />
问题不大，使用adb logcat抓取日志<br />
adb logcat > log.log<br />
打开 log，搜索F linker、linker、library、beginning of crash这几个关键词，我搜索第一个就出来了。<br />
F linker : CANNOT LINK EXECUTABLE "/vendor/bin/hw/vendor.xiaomi.hardware.vibratorfeature.service": library "android.hardware.vibrator-V1-ndk_platform.so" not found: needed by main executable<br />
这段报错的意思就是vendor.xiaomi.hardware.vibratorfeature.service找不到android.hardware.vibrator-V1-ndk_platform.so这个库，所以无法正常工作。<br />
<br />
打开 BoardConfig.mk 加入以下 flag<br />
# Library<br />
TARGET_RECOVERY_DEVICE_MODULES += \<br />
android.hardware.vibrator-V1-ndk_platform.vendor<br />
<br />
TW_RECOVERY_ADDITIONAL_RELINK_LIBRARY_FILES += \<br />
$(TARGET_OUT_SHARED_LIBRARIES)/android.hardware.vibrator-V1-ndk_platform.so<br />
再次编译尝试<br />
<br />
开机之后依然冻屏，继续抓 log，查找<br />
F linker : CANNOT LINK EXECUTABLE "/vendor/bin/hw/vendor.xiaomi.hardware.vibratorfeature.service": library "vendor.hardware.vibratorfeature.IVibratorExt-V1-ndk_platform.so" not found: needed by main executable<br />
vendor.hardware.vibratorfeature字样和我们之前导入的文件长得差不多，一般都是供应商专有文件，所以去设备提取，路径在 vendor/lib64 里，虽然设备冻屏了，但我们可以用adb pull直接拉取到电脑。就像这样。<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/$/mjw adb shell mount /vendor<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/$/mjw adb pull /vendor/lib64/vendor.hardware.vibratorfeature.IVibratorExt-V1-ndk_platform.so .<br />
/vendor/lib64/vendor.hardware.vibratorfeature.IVi...led, 0 skipped. 14.7 MB/s (33552 bytes in 0.002s<br />
将这个文件按照以下提示操作<br />
<br />
* vendor.hardware.vibratorfeature.IVibratorExt-V1-ndk_platform.so --> recovery/root/vendor/lib64<br />
<br />
继续编译测试<br />
<br />
还是冻屏，继续抓 log<br />
F linker : CANNOT LINK EXECUTABLE "/vendor/bin/hw/vendor.xiaomi.hardware.vibratorfeature.service": library "libtinyalsa.so" not found: needed by main executable<br />
这个 library twrp 的源码中应该没有，去设备拿一个 prebuilt 吧<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/$/mjw adb shell mount /system_root<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/$/mjw adb pull /system_root/system/lib64/libtinyalsa.so .<br />
/system_root/system/lib64/libtinyalsa.so: 1 file ...led, 0 skipped. 13.6 MB/s (45032 bytes in 0.003s<br />
将这个文件按照以下提示操作<br />
<br />
* libtinyalsa.so --> recovery/root/system/lib64<br />
<br />
编译测试<br />
<br />
我艹了，还是冻屏，这次搜那几个关键词都搜不到了，搜vibrator看看这鬼东西报什么<br />
E vendor.xiaomi.hardware.vibratorfeature.service: fail to load lib : /vendor/lib64/libaachaptics.so<br />
这次都直接给路径了，直接拿。<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/$/mjw adb shell mount /vendor<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/$/mjw adb pull /vendor/lib64/libaachaptics.so .<br />
/vendor/lib64/libaachaptics.so: 1 file pulled, 0 skipped. 15.8 MB/s (56232 bytes in 0.003s)<br />
将这个文件按照以下提示操作<br />
<br />
* libaachaptics.so --> recovery/root/vendor/lib64<br />
<br />
至此应该没什么问题了，但是有个 flag 貌似要操作 data 内的东西，未解密会导致冻屏，所以等修完解密后再来修振动。<br />
<br />
==== 修复 CPU 温度 ====<br />
使用adb shell + grep命令在手机节点里搜索 type 关键词。<br />
xiaolegun@xiaoleGundeMac-Pro ~ adb shell 'grep "cp_master" /sys/class/thermal/*/type'<br />
/sys/class/thermal/thermal_zone54/type:cp_master<br />
xiaolegun@xiaoleGundeMac-Pro ~ adb shell 'grep "cpu" /sys/class/thermal/*/type'<br />
/sys/class/thermal/thermal_zone1/type:cpu_little1<br />
/sys/class/thermal/thermal_zone10/type:cpu_bigbig1<br />
/sys/class/thermal/thermal_zone11/type:cpu_big6<br />
/sys/class/thermal/thermal_zone12/type:cpu_bigbig2<br />
/sys/class/thermal/thermal_zone2/type:cpu_little2<br />
/sys/class/thermal/thermal_zone3/type:cpu_little3<br />
/sys/class/thermal/thermal_zone4/type:cpu_little4<br />
/sys/class/thermal/thermal_zone5/type:cpu_big1<br />
/sys/class/thermal/thermal_zone6/type:cpu_big2<br />
/sys/class/thermal/thermal_zone7/type:cpu_big3<br />
/sys/class/thermal/thermal_zone8/type:cpu_big4<br />
/sys/class/thermal/thermal_zone9/type:cpu_big5<br />
我这里选用cp_master节点来读取温度。我的节点路径为/sys/class/thermal/thermal_zone54在后面添加 temp 来读取温度，你可以使用cat来检测节点是否可以正常读取温度<br />
adb shell 'cat /sys/class/thermal/thermal_zone54/temp'<br />
如果返回如<br />
28000<br />
这种类似的数值，那多半是没有问题的。<br />
<br />
我们在 BoardConfig.mk 中加入<br />
TW_CUSTOM_CPU_TEMP_PATH := "/sys/class/thermal/thermal_zone54/temp"<br />
至此 cpu 温度就修复好了。<br />
<br />
== 后序 ==<br />
这是我玩 Android 两年内第一次写关于 Android 的文章，内容和措辞可能不是很准确，再加上开学焦虑，租房因租金和房源不顺利，写的很乱，请各位指正。<br />
<br />
此外有什么不懂得，多翻github，善用github搜索，多看看大佬们是怎么解决的。<br />
<br />
解密等有空补，先补作业。<br />
<br />
== 参考资料 ==<br />
[https://source.android.com/docs/setup/create/new-device?hl=zh-cn Google - 添加新设备]<br />
<br />
[https://source.android.com/docs/core/ota/ab?hl=zh-cn Google - A/B（无缝）系统更新]<br />
<br />
[https://blog.lynnrin.moe/posts/ROM-bringup-guide-prebuilt/#boardconfigmk Lynnrin - 快速上手 Android Custom ROM 适配 - Prebuilt Vendor]<br />
<br />
[https://source.android.com/docs/core/architecture/vintf?hl=zh-cn Google - 供应商接口对象]</div>
XiaoleGun
https://wiki.uotan.cn/index.php?title=Super_Empty&diff=554
Super Empty
2024-02-20T04:09:49Z
<p>XiaoleGun：修正</p>
<hr />
<div>= Super empty =<br />
<br />
== 简介 ==<br />
它是任何动态分区设备在系统构建时可选的产物。它一个定义了动态分区信息的空镜像。它的主要作用是为设备提供一个初始的分区表。<br />
<br />
对原生动态分区来说<br />
<br />
它自身包含了对逻辑分区的映射信息及逻辑分区大小。可以用于清除或更新super分区，比如后期重新分区逻辑分区大小。<br />
<br />
对改造动态分区来说<br />
<br />
它定义了维护者定义的设备自身分区和分区大小，将它们合并成一个大的“super”供刷入第三方ROM使用，甚至可以让老旧设备运行DSU。并且针对这类设备它的意义远不止类原生，对PT(Project Treble)也有帮助，有经验的维护者可以通过改造动态分区的方式让用户无需扩容即可体验深度定制UI。<br />
<br />
== 使用方法 ==<br />
=== 原生动态分区 ===<br />
fastboot wipe-super super_empty.img的绝对路径<br />
<br />
=== 改造动态分区 ===<br />
==== 类原生 ====<br />
以我个人维护的小米6X(wayne)为例<br />
<br />
1.设备重启至fastboot<br />
<br />
2.连接电脑<br />
<br />
3.准备最新版本的adb工具包和维护者提供的super_empty.img和ROM包<br />
<br />
4.打开命令行进入工具包目录，输入fastboot wipe-super super_empty.img的绝对路径<br />
<br />
5.刷写完毕后继续刷入维护者提供的Recovery，fastboot flash recovery recovery.img的绝对路径<br />
<br />
6.重启设备至recovery<br />
<br />
7.选择格式化data(format data)<br />
<br />
8.连接电脑，使用adb sideload刷入ROM，adb sideload ROM包绝对路径<br />
<br />
==== GSI ====<br />
改造动态分区之后，使用Aosp recovery或TWRP的fastbootd，刷入system分区，即可不需扩容也能使用上超过system物理空间大小的镜像。<br />
<br />
== 对开发者的一些帮助 ==<br />
[https://github.com/jjpprrrr/device%20xiaomi%20sdm845-common/commits/thirteen 改造动态分区的commit(2022年9月22日)]<br />
<br />
对于在Mac上正常刷写super_empty在win或linux下不能正常刷写的情况，请检查device tree内定义的数值是否百分之一百匹配。</div>
XiaoleGun
https://wiki.uotan.cn/index.php?title=%E4%B8%BA%E6%96%B0%E8%AE%BE%E5%A4%87%E7%BC%96%E5%86%99Recovery_device_tree&diff=550
为新设备编写Recovery device tree
2024-02-20T02:53:49Z
<p>XiaoleGun：更正代码高亮格式</p>
<hr />
<div><br />
= 为新设备编写 Recovery 的设备树 =<br />
作者: Dark(xiaoleGun)<br />
<br />
时间: 2024.2.20<br />
<br />
协作者:<br />
<br />
== 一些自序 ==<br />
这篇教程中可能有些不对的地方，请各位指正，我也刚接触 Android 设备测开发两年，而且只有在节假日的时候有空一个人瞎捣鼓，为了<s>薅 mjw 羊毛</s>，故写这篇教程，而且我个人更推荐 Aosp Recovery 刷写第三方 ROM，TWRP 可能多多少少有些问题。Root 之类的不需要 TWRP 也可以，可以找到原机 boot 使用 Magisk 进行修补，也可以使用 KernelSU。另外我的语文功底不是很好，写不出辞藻，只能是北方地道的大白话，见谅哈 🤣///<br />
<br />
== 准备工作 ==<br />
1.一颗勇敢的、不怕困难的强大心脏。<br />
<br />
'''<s>两颗心好勇敢 -- Falling in love</s>'''<br />
<br />
2.电脑配置:<br />
{| class="wikitable"<br />
!硬件<br />
!需求<br />
|-<br />
|CPU<br />
|四核或更多<br />
|-<br />
|内存<br />
|8G 或更多<br />
|-<br />
|硬盘<br />
|至少 80G 空余空间<br />
|-<br />
|系统<br />
|WSL 或实体 Linux，建议 Debian 系<br />
|}<br />
3.足够的空闲时间。<br />
<br />
4.Vscode 和 🤏Linux 知识储备<br />
<br />
5.一台完好无损的新设备。<br />
<br />
6.设备原厂的 boot/recovery/vendor_boot 镜像。(推荐 recovery 分区，因为里面包含一些启动必须的.rc(run command)，如果没有该分区，寻找包含官方 recovery 内容的分区。值得注意的是部分设备 recovery 合并到了 boot 中，或是存在于 vendor_boot）<br />
<br />
7.查看自己的设备出厂 Android 版本并确定用途，是用于官方 ROM 还是第三方类原生。出厂版本为 9 及以上的可以使用 twrp-11 及以上分支，9 以下使用 twrp-9 分支。<br />
<br />
== 配置环境 ==<br />
<br />
=== 安装依赖 ===<br />
sudo apt update<br />
sudo apt-get install bc bison build-essential ccache curl flex g++-multilib gcc-multilib git gnupg gperf imagemagick lib32ncurses5-dev lib32readline-dev lib32z1-dev liblz4-tool libncurses5 libncurses5-dev libsdl1.2-dev libssl-dev libxml2 libxml2-utils lzop pngcrush rsync schedtool squashfs-tools xsltproc zip zlib1g-dev xattr openjdk-11-jdk jq android-sdk-libsparse-utils python3 python2 repo<br />
<br />
必要时可以阅读[https://source.android.com/source/using-repo?hl=zh-cn Git 和 Repo]<br />
<br />
=== 配置 Git 和 Repo ===<br />
安装完依赖后，在终端执行。<br />
git config --global user.name "your username"<br />
git config --global user.email "your email"<br />
<br />
=== 同步 TWRP 源码 ===<br />
在自己方便的地方，建立一个目录。<br />
mkdir twrp<br />
cd twrp<br />
根据自己在准备工作中确定的分支同步相应的源码。<br />
<br />
==== TWRP-9 ====<br />
repo init --depth=1 -u <nowiki>https://github.com/minimal-manifest-twrp/platform_manifest_twrp_omni.git</nowiki> -b twrp-9.0<br />
repo sync<br />
<br />
==== TWRP-11 ====<br />
repo init --depth=1 -u <nowiki>https://github.com/minimal-manifest-twrp/platform_manifest_twrp_aosp.git</nowiki> -b twrp-11<br />
repo sync<br />
<br />
==== TWRP-12.1 ====<br />
repo init --depth=1 -u <nowiki>https://github.com/minimal-manifest-twrp/platform_manifest_twrp_aosp.git</nowiki> -b twrp-12.1<br />
repo sync<br />
<br />
== 编写设备树 ==<br />
<blockquote>最基本的开机部分我通过 Redmi K50 做示例，并选取 TWRP-12.1 分支。<br />
<br />
解密部分会单独成一个章节并分为高通和联发科。</blockquote><br />
<br />
=== 获取资料 ===<br />
小米设备一般可以在[https://xiaomirom.com Xiaomirom]中的线刷包获取 boot/recovery/vendor_boot 镜像，其它设备请自行寻找。<br />
<br />
==== 安装工具和依赖 ====<br />
将准备工作中准备的 boot/recovery/vendor_boot 镜像解包，可以用任何工具，我这里使用[https://github.com/cfig/Android_boot_image_editor Android_boot_image_editor]按照自述文件进行依赖安装操作：<br />
<br />
===== Mac(Intel) =====<br />
brew install lz4 xz dtc openjdk@17<br />
echo 'export PATH="/usr/local/opt/openjdk@17/bin:$PATH"' >> ~/.zshrc<br />
source ~/.zshrc<br />
<br />
===== Linux: =====<br />
sudo apt update<br />
sudo apt install git device-tree-compiler lz4 xz-utils zlib1g-dev openjdk-17-jdk gcc g++ python3 python-is-python3 p7zip-full android-sdk-libsparse-utils erofs-utils<br />
<br />
===== Common: =====<br />
git clone <nowiki>https://github.com/cfig/Android_boot_image_editor</nowiki><br />
cd Android_boot_image_editor<br />
<br />
==== 解包 ====<br />
<blockquote>请注意"/"表示或的意思，请不要误以为是一个东西。<br />
<br />
如果不确定分区寻找的是否正确，请尝试将可以的分区进行解包，并查看其ramdisk内是否包含recovery字样的文件</blockquote>将你准备好的boot/recovery/vendor_boot复制到该目录，你可以使用 GUI 或者 CLI。如:<br />
cp <出厂boot/recovery/vendor_boot的绝对路径> boot/recovery/vendor_boot.img<br />
./gradlew unpack<br />
我这里以 Redmi K50 为例<br />
10:12:13.188 [main] INFO cfig.bootimg.v3.VendorBoot -<br />
Unpack Summary of vendor_boot.img<br />
┌───────────────────────────────────────┬──────────────────────────────────────┐<br />
│What │Where │<br />
└───────────────────────────────────────┴──────────────────────────────────────┘<br />
┌───────────────────────────────────────┬──────────────────────────────────────┐<br />
│image info │build/unzip_boot/vendor_boot.json │<br />
├───────────────────────────────────────┼──────────────────────────────────────┤<br />
│ramdisk │build/unzip_boot/ramdisk.img.lz4 │<br />
│-- PLATFORM ramdisk[1/1] │build/unzip_boot/ramdisk.1.lz4 │<br />
│------- extracted rootfs │build/unzip_boot/root.1 │<br />
├───────────────────────────────────────┼──────────────────────────────────────┤<br />
│dtb │build/unzip_boot/dtb │<br />
├───────────────────────────────────────┼──────────────────────────────────────┤<br />
│AVB info │build/unzip_boot/vendor_boot.avb.json │<br />
│\-- signing key │NONE │<br />
└───────────────────────────────────────┴──────────────────────────────────────┘<br />
10:12:13.213 [main] WARN cfig.packable.PackableLauncher - 'unpack' sequence completed<br />
<br />
BUILD SUCCESSFUL in 2s<br />
解包成功后终端会打印出以上信息，其中包含vendor_boot目录结构，我们只需要ramdisk里的部分内容就好了。<br />
ls build/unzip_boot/root.1 # 请根据自己的分区和设备判断ramdisk的命名，一般都直接是ramdisk<br />
不出意外的话会输出以下内容<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/dump/bootedit master ? ls build/unzip_boot/root.1<br />
acct oem<br />
apex plat_file_contexts<br />
bin plat_property_contexts<br />
bugreports postinstall<br />
config proc<br />
d product<br />
data product_file_contexts<br />
data_mirror product_property_contexts<br />
debug_ramdisk prop.default<br />
default.prop res<br />
dev sdcard<br />
etc second_stage_resources<br />
first_stage_ramdisk sepolicy<br />
init storage<br />
init.recovery.hardware.rc sys<br />
init.recovery.mt6895.rc system<br />
lib system_ext<br />
linkerconfig system_ext_file_contexts<br />
miui.factoryreset.fstab system_ext_property_contexts<br />
miui.factoryreset.rc tmp<br />
mnt vendor<br />
odm vendor_dlkm<br />
odm_dlkm vendor_file_contexts<br />
odm_file_contexts vendor_property_contexts<br />
odm_property_contexts<br />
如果包含 init.recovery*的字样，恭喜你成功找到了正确的分区。将这个目录复制到一个自己方便的地方。<br />
<br />
至此资料已经大致齐全了，解密的资料会在解密章节来讲解如何获取。<br />
<br />
=== 初始化目录结构 ===<br />
在 twrp 源码根目录输入<br />
mkdir -p device/vendor/codename<br />
mkdir -p device/vendor/codename/recovery/root<br />
cd device/vendor/codename<br />
vendor指的是供应商，如 xiaomi、oneplus、huawei、vivo、realme。<br />
<br />
codename指的是设备代号，小米设备可以在[https://xiaomirom.com Xiaomirom]查询，其它设备自行查询亦或是在开发者选项勾选 USB 调试通过 adb 尝试获取。<br />
adb shell getprop ro.product.manufacturer # 供应商<br />
adb shell getprop ro.product.device # 设备代号<br />
我的 Redmi K50 会打印以下信息<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/dump/bootedit master ? adb shell getprop ro.product.manufacturer<br />
Xiaomi # 无论打印出来的内容是大写还是小写，在目录结构中我们都采用小写<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/dump/bootedit master ? adb shell getprop ro.product.device<br />
rubens<br />
我的 IQOO NEO5 Lite 会打印以下信息<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/tmp/device/xiaomi/rubens adb shell getprop ro.product.manufacturer<br />
vivo<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/tmp/device/xiaomi/rubens adb shell getprop ro.product.device<br />
PD2118<br />
一般只要不是山寨机，小作坊出来的机子，用这两条命令应该是可以正确获取的。<br />
<br />
=== 初始化构建时必要的文件 ===<br />
无论是 AOSP device tree 亦或是 TWRP device tree 都基本类似于以下结构。<br />
/<br />
├── prebuilt (存放kernel、dtb等预编译文件) # AOSP device tree若使用build kernel则没有该目录<br />
├── recovery/root (存放一些.rc和解密blobs) # 一般用于Recovery device tree<br />
├── Android.mk (Android构建系统首先会检查每个目录的Android.mk，里面包含一些判断，由它包括其所在目录中所有Makefile)<br />
├── AndroidProducts.mk (声明产品的Makefile和lunch时可用的构建类型)<br />
├── BoardConfig.mk (板载配置文件，定义了主板必要的Flag)<br />
├── device.mk (声明设备所需的文件和模块)<br />
└── <ROM>_codename.mk (声明产品特定信息，例如名称、品牌和型号，引用device.mk等) # ROM就比如lineage、arrow等，编译twrp就直接写twrp，twrp-9分支要写onmi<br />
我们把这样的结构称为骨架树(skeleton tree)。<br />
<br />
接下来我们按照以上结构为自己的设备写一份 Recovery device tree。<br />
<br />
在终端使用touch命令创建必要的文件。<br />
touch Android.mk AndroidProducts.mk BoardConfig.mk device.mk twrp_rubens.mk<br />
ls .<br />
不出意外的话会打印出以下信息<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/tmp/device/xiaomi/rubens touch Android.mk AndroidProducts.mk BoardConfig.mk device.mk twrp_rubens.mk<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/tmp/device/xiaomi/rubens ls .<br />
Android.mk BoardConfig.mk prebuilt twrp_rubens.mk<br />
AndroidProducts.mk device.mk recovery<br />
可以下一步了~<br />
<br />
==== 初始 Android.mk 文件 ====<br />
打开 Vscode 并打开设备树目录，你足够强也可以使用 nano、vim 编辑。<br />
<br />
选中 Android.mk 并按照自己的资料复制并更改以下内容<br />
LOCAL_PATH := $(call my-dir)<br />
<br />
ifeq ($(TARGET_DEVICE),codename)<br />
include $(call all-subdir-makefiles,$(LOCAL_PATH))<br />
endif<br />
<br />
* codename是需要你修改的部分<br />
<br />
我修改后是这样的<br />
LOCAL_PATH := $(call my-dir)<br />
<br />
ifeq ($(TARGET_DEVICE),rubens)<br />
include $(call all-subdir-makefiles,$(LOCAL_PATH))<br />
endif<br />
<br />
==== 初始 AndroidProducts.mk 文件 ====<br />
选中 AndroidProducts.mk 并按照自己的资料复制并更改以下内容<br />
PRODUCT_MAKEFILES := \<br />
$(LOCAL_DIR)/<ROM>_<codename>.mk<br />
<br />
COMMON_LUNCH_CHOICES := \<br />
<ROM>_<codename>-eng<br />
我修改后是这样的<br />
PRODUCT_MAKEFILES := \<br />
$(LOCAL_DIR)/twrp_rubens.mk<br />
<br />
COMMON_LUNCH_CHOICES := \<br />
twrp_rubens-eng<br />
<br />
==== 初始 BoardConfig.mk 文件 ====<br />
<blockquote>将之前准备的ramdisk文件夹用新窗口打开 1.找到目录下的 prop.default 或含 prop 字样的文件。以下注释类似 ro.*.*的就是从 prop 中获取的 2.解包 boot/recovery/vendor_boot 的 json<br />
<br />
例如 build/unzip_boot/boot.json</blockquote>选中 BoardConfig.mk 并按照自己的资料复制并更改以下内容<br />
DEVICE_PATH := device/vendor/codename<br />
<br />
# Architecture<br />
TARGET_ARCH := arm64 # ro.bionic.arch<br />
TARGET_ARCH_VARIANT := armv8-a # 64位默认变体<br />
TARGET_CPU_ABI := arm64-v8a # ro.vendor.product.cpu.abilist64 (至少在小米设备上没有找到ro.product.cpu.abilist)<br />
TARGET_CPU_ABI2 := # 64位留空<br />
TARGET_CPU_VARIANT := generic # 默认一般都是通用<br />
TARGET_CPU_VARIANT_RUNTIME := cortex-a55 # ro.bionic.cpu_variant<br />
<br />
TARGET_2ND_ARCH := arm # ro.bionic.2nd_arch<br />
TARGET_2ND_ARCH_VARIANT := $(TARGET_ARCH_VARIANT)<br />
TARGET_2ND_CPU_ABI := armeabi-v7a # ro.vendor.product.cpu.abilist32第一个<br />
TARGET_2ND_CPU_ABI2 := armeabi # ro.vendor.product.cpu.abilist32第二个<br />
TARGET_2ND_CPU_VARIANT := $(TARGET_CPU_VARIANT)<br />
TARGET_2ND_CPU_VARIANT_RUNTIME := $(TARGET_CPU_VARIANT)<br />
<br />
# Assertation<br />
TARGET_OTA_ASSERT_DEVICE := rubens # codename<br />
<br />
# Bootloader<br />
TARGET_BOOTLOADER_BOARD_NAME := rubens # ro.product.board<br />
TARGET_NO_BOOTLOADER := true<br />
TARGET_USES_UEFI := true<br />
<br />
# Build Rule<br />
ALLOW_MISSING_DEPENDENCIES := true # 为了recovery不健全的依赖<br />
<br />
# Kernel - 注释会说明在boot/recovery/vendor_boot.json中对应的变量<br />
BOARD_BOOTIMG_HEADER_VERSION := 4 # headerVersion<br />
BOARD_KERNEL_BASE := 0x3fff8000 # (kernelLoadAddr - 32KB) qcom设备base为0，且没有偏移(offset)<br />
BOARD_KERNEL_CMDLINE := bootopt=64S3,32N2,64N2 # cmdline<br />
BOARD_KERNEL_PAGESIZE := 4096 # pageSize<br />
BOARD_RAMDISK_OFFSET := 0x26f08000 # (ramdisk,loadAddr - BOARD_KERNEL_BASE)<br />
BOARD_KERNEL_TAGS_OFFSET := 0x07c88000 # (tagsLoadAddr - BOARD_KERNEL_BASE)<br />
BOARD_MKBOOTIMG_ARGS += --header_version $(BOARD_BOOTIMG_HEADER_VERSION)<br />
BOARD_MKBOOTIMG_ARGS += --ramdisk_offset $(BOARD_RAMDISK_OFFSET)<br />
BOARD_MKBOOTIMG_ARGS += --tags_offset $(BOARD_KERNEL_TAGS_OFFSET)<br />
<br />
# Kernel - prebuilt<br />
TARGET_PREBUILT_KERNEL := $(DEVICE_PATH)/prebuilt/kernel # 预编译内核相对于android源码根目录的相对路径，vendor_boot机型不需要<br />
TARGET_PREBUILT_DTB := $(DEVICE_PATH)/prebuilt/dtb.img # 同上<br />
BOARD_MKBOOTIMG_ARGS += --dtb $(TARGET_PREBUILT_DTB)<br />
<br />
# Partitions<br />
BOARD_FLASH_BLOCK_SIZE := 262144 # (BOARD_KERNEL_PAGESIZE * 64)<br />
BOARD_BOOTIMAGE_PARTITION_SIZE := 67108864 # boot/recovery/vendor_boot镜像的字节大小需原厂或手机完整提取出来的，不定义会报错<br />
BOARD_RECOVERYIMAGE_PARTITION_SIZE := 67108864 # 同上<br />
BOARD_VENDOR_ROOTIMAGE_PARTITION_SIZE := 67108864 # 同上<br />
BOARD_SYSTEMIMAGE_PARTITION_TYPE := ext4 # 分区类型，查看ramdisk中fstab定义的类型<br />
BOARD_USERDATAIMAGE_FILE_SYSTEM_TYPE := ext4<br />
BOARD_VENDORIMAGE_FILE_SYSTEM_TYPE := ext4<br />
TARGET_COPY_OUT_VENDOR := vendor # 定义vendor目录，例如copy专有blobs要用<br />
BOARD_SUPER_PARTITION_SIZE := 9126805504 # 可以通过blockdev --getsize64 /dev/block/bootdevice/by-name/super获取，需root，如果无法root可以直接使用这个值，不影响twrp启动，可以后续修正<br />
BOARD_SUPER_PARTITION_GROUPS := xiaomi_dynamic_partitions # xiaomi根据你获取资料的vendor替换，是一个动态分区组<br />
BOARD_XIAOMI_DYNAMIC_PARTITIONS_PARTITION_LIST := system vendor product system_ext odm vendor_dlkm odm_dlkm # 根据fstab内的定义，一般flag包含logical都属于动态分区组的一部分<br />
BOARD_XIAOMI_DYNAMIC_PARTITIONS_SIZE := 9122611200 # (BOARD_SUPER_PARTITION_SIZE - 4MB)<br />
<br />
# Platform<br />
TARGET_BOARD_PLATFORM := mt6895 # ro.board.platform<br />
<br />
# Recovery - 基本通用的不影响启动<br />
BOARD_HAS_LARGE_FILESYSTEM := true<br />
TARGET_RECOVERY_PIXEL_FORMAT := RGBX_8888<br />
TARGET_USERIMAGES_USE_EXT4 := true<br />
TARGET_USERIMAGES_USE_F2FS := true<br />
<br />
# Treble<br />
BOARD_VNDK_VERSION := current # 声明VNDK版本<br />
<br />
# Vendor_boot recovery ramdisk<br />
BOARD_MOVE_RECOVERY_RESOURCES_TO_VENDOR_BOOT := true # 将recovery文件复制到vendor_boot<br />
<br />
# Boot recovery ramdisk<br />
#BOARD_USES_RECOVERY_AS_BOOT := true recovery ramdisk合并在boot中启用<br />
<br />
# Verified Boot<br />
BOARD_AVB_ENABLE := true<br />
BOARD_AVB_MAKE_VBMETA_IMAGE_ARGS += --flags 3<br />
<br />
# TWRP Configurations<br />
TW_DEFAULT_LANGUAGE := zh_CN # 默认为中文<br />
TW_EXTRA_LANGUAGES := true # 额外的语言<br />
TW_THEME := portrait_hdpi # 主题<br />
TW_INCLUDE_FASTBOOTD := true # 包括fastbootd，为动态分区<br />
<br />
# 其它flag还有很多，可以在https://xdaforums.com/t/twrp-flags-for-boardconfig-mk.3333970 查找，<br />
# 这篇文章也很老了，但我并不推荐twrp，所以flag我也不是很了解，多翻翻github:)<br />
<br />
# Debug<br />
TARGET_USES_LOGD := true # 调试flag<br />
TWRP_INCLUDE_LOGCAT := true<br />
无注释版<br />
DEVICE_PATH := device/vendor/codename<br />
<br />
# Architecture<br />
TARGET_ARCH := arm64<br />
TARGET_ARCH_VARIANT := armv8-a<br />
TARGET_CPU_ABI := arm64-v8a<br />
TARGET_CPU_ABI2 :=<br />
TARGET_CPU_VARIANT := generic<br />
TARGET_CPU_VARIANT_RUNTIME := cortex-a55<br />
<br />
TARGET_2ND_ARCH := arm<br />
TARGET_2ND_ARCH_VARIANT := $(TARGET_ARCH_VARIANT)<br />
TARGET_2ND_CPU_ABI := armeabi-v7a<br />
TARGET_2ND_CPU_ABI2 := armeabi<br />
TARGET_2ND_CPU_VARIANT := $(TARGET_CPU_VARIANT)<br />
TARGET_2ND_CPU_VARIANT_RUNTIME := $(TARGET_CPU_VARIANT)<br />
<br />
# Assertation<br />
TARGET_OTA_ASSERT_DEVICE := rubens<br />
<br />
# Bootloader<br />
TARGET_BOOTLOADER_BOARD_NAME := rubens<br />
TARGET_NO_BOOTLOADER := true<br />
TARGET_USES_UEFI := true<br />
<br />
# Build Rule<br />
ALLOW_MISSING_DEPENDENCIES := true<br />
<br />
# Kernel<br />
BOARD_BOOT_HEADER_VERSION := 4<br />
BOARD_KERNEL_BASE := 0x3fff8000<br />
BOARD_KERNEL_CMDLINE := bootopt=64S3,32N2,64N2<br />
BOARD_KERNEL_PAGESIZE := 4096<br />
BOARD_RAMDISK_OFFSET := 0x26f08000<br />
BOARD_KERNEL_TAGS_OFFSET := 0x07c88000<br />
BOARD_MKBOOTIMG_ARGS += --header_version $(BOARD_BOOT_HEADER_VERSION)<br />
BOARD_MKBOOTIMG_ARGS += --ramdisk_offset $(BOARD_RAMDISK_OFFSET)<br />
BOARD_MKBOOTIMG_ARGS += --tags_offset $(BOARD_KERNEL_TAGS_OFFSET)<br />
BOARD_KERNEL_IMAGE_NAME := Image<br />
<br />
# Kernel - prebuilt<br />
TARGET_PREBUILT_DTB := $(DEVICE_PATH)/prebuilt/dtb.img<br />
BOARD_MKBOOTIMG_ARGS += --dtb $(TARGET_PREBUILT_DTB)<br />
<br />
# Partitions<br />
BOARD_FLASH_BLOCK_SIZE := 262144<br />
BOARD_BOOTIMAGE_PARTITION_SIZE := 67108864<br />
BOARD_RECOVERYIMAGE_PARTITION_SIZE := 67108864<br />
BOARD_VENDOR_ROOTIMAGE_PARTITION_SIZE := 67108864<br />
BOARD_SYSTEMIMAGE_PARTITION_TYPE := ext4<br />
BOARD_USERDATAIMAGE_FILE_SYSTEM_TYPE := ext4<br />
BOARD_VENDORIMAGE_FILE_SYSTEM_TYPE := ext4<br />
TARGET_COPY_OUT_VENDOR := vendor<br />
BOARD_SUPER_PARTITION_SIZE := 9126805504<br />
BOARD_SUPER_PARTITION_GROUPS := xiaomi_dynamic_partitions<br />
BOARD_XIAOMI_DYNAMIC_PARTITIONS_PARTITION_LIST := system vendor product system_ext odm vendor_dlkm odm_dlkm<br />
BOARD_XIAOMI_DYNAMIC_PARTITIONS_SIZE := 9122611200<br />
<br />
# Platform<br />
TARGET_BOARD_PLATFORM := mt6895<br />
<br />
# Recovery<br />
BOARD_HAS_LARGE_FILESYSTEM := true<br />
TARGET_RECOVERY_PIXEL_FORMAT := RGBX_8888<br />
TARGET_USERIMAGES_USE_EXT4 := true<br />
TARGET_USERIMAGES_USE_F2FS := true<br />
<br />
# Treble<br />
BOARD_VNDK_VERSION := current<br />
<br />
# Vendor_boot recovery ramdisk<br />
BOARD_MOVE_RECOVERY_RESOURCES_TO_VENDOR_BOOT := true<br />
<br />
# Boot recovery ramdisk<br />
#BOARD_USES_RECOVERY_AS_BOOT := true<br />
<br />
# Verified Boot<br />
BOARD_AVB_ENABLE := true<br />
BOARD_AVB_MAKE_VBMETA_IMAGE_ARGS += --flags 3<br />
<br />
# TWRP Configurations<br />
TW_DEFAULT_LANGUAGE := zh_CN<br />
TW_EXTRA_LANGUAGES := true<br />
TW_THEME := portrait_hdpi<br />
TW_INCLUDE_FASTBOOTD := true<br />
<br />
# Debug<br />
TARGET_USES_LOGD := true<br />
TWRP_INCLUDE_LOGCAT := true<br />
这块写了好久我也不确定对不对，请各位指正，尤其是 Kernel 部分。<br />
<br />
==== 初始 device.mk 文件 ====<br />
<br />
* 准备好 prop.default<br />
<br />
选中 AndroidProducts.mk 并按照自己的资料复制并更改以下内容<br />
DEVICE_PATH := device/xiaomi/rubens<br />
<br />
# API<br />
PRODUCT_SHIPPING_API_LEVEL := 31 # ro.board.first_api_level<br />
<br />
# A/B<br />
AB_OTA_UPDATER := true # 启用A/B无缝更新<br />
AB_OTA_PARTITIONS += \ # 定义A/B分区，参考fstab<br />
boot \<br />
dtbo \<br />
system \<br />
product \<br />
vendor \<br />
odm \<br />
odm_dlkm \<br />
vbmeta \<br />
vendor_boot \<br />
vendor_dlkm \<br />
vbmeta_system \<br />
vbmeta_vendor<br />
<br />
PRODUCT_PACKAGES += \<br />
update_engine \<br />
update_engine_sideload \<br />
update_verifier \<br />
checkpoint_gc<br />
<br />
AB_OTA_POSTINSTALL_CONFIG += \<br />
RUN_POSTINSTALL_system=true \<br />
POSTINSTALL_PATH_system=system/bin/mtk_plpath_utils \<br />
FILESYSTEM_TYPE_system=ext4 \<br />
POSTINSTALL_OPTIONAL_system=true<br />
<br />
AB_OTA_POSTINSTALL_CONFIG += \<br />
RUN_POSTINSTALL_vendor=true \<br />
POSTINSTALL_PATH_vendor=bin/checkpoint_gc \<br />
FILESYSTEM_TYPE_vendor=ext4 \<br />
POSTINSTALL_OPTIONAL_vendor=true<br />
<br />
# Dynamic<br />
PRODUCT_USE_DYNAMIC_PARTITIONS := true # 动态分区<br />
<br />
# Soong namespaces<br />
PRODUCT_SOONG_NAMESPACES += $(DEVICE_PATH) # 命名空间<br />
<br />
* A/B 无缝更新部分高通和联发科不一样，联发科设备可以照抄，注意 system/bin/mtk_plpath_utils 就好。高通参考[https://github.com/sekaiacg/android_device_xiaomi_venus_TWRP/tree/android-13 venus twrp tree]，并且高通的[https://git.codelinaro.org/clo/la/platform/hardware/qcom/bootctrl bootctrl]和[https://git.codelinaro.org/clo/la/platform/vendor/qcom-opensource/recovery-ext gpt-utils]可以从 CLO 拿。<br />
<br />
无注释版<br />
PRODUCT_SHIPPING_API_LEVEL := 31<br />
<br />
# A/B<br />
AB_OTA_UPDATER := true<br />
AB_OTA_PARTITIONS += \<br />
boot \<br />
dtbo \<br />
system \<br />
product \<br />
vendor \<br />
odm \<br />
odm_dlkm \<br />
vbmeta \<br />
vendor_boot \<br />
vendor_dlkm \<br />
vbmeta_system \<br />
vbmeta_vendor<br />
<br />
PRODUCT_PACKAGES += \<br />
update_engine \<br />
update_engine_sideload \<br />
update_verifier \<br />
checkpoint_gc<br />
<br />
AB_OTA_POSTINSTALL_CONFIG += \<br />
RUN_POSTINSTALL_system=true \<br />
POSTINSTALL_PATH_system=system/bin/mtk_plpath_utils \<br />
FILESYSTEM_TYPE_system=ext4 \<br />
POSTINSTALL_OPTIONAL_system=true<br />
<br />
AB_OTA_POSTINSTALL_CONFIG += \<br />
RUN_POSTINSTALL_vendor=true \<br />
POSTINSTALL_PATH_vendor=bin/checkpoint_gc \<br />
FILESYSTEM_TYPE_vendor=ext4 \<br />
POSTINSTALL_OPTIONAL_vendor=true<br />
<br />
# Dynamic<br />
PRODUCT_USE_DYNAMIC_PARTITIONS := true<br />
<br />
# Soong namespaces<br />
PRODUCT_SOONG_NAMESPACES += $(DEVICE_PATH)<br />
<br />
==== 初始 twrp_rubens.mk 文件 ====<br />
选中 AndroidProducts.mk 并按照自己的资料复制并更改以下内容<br />
# Inherit from common AOSP config<br />
$(call inherit-product, $(SRC_TARGET_DIR)/product/base.mk)<br />
$(call inherit-product, $(SRC_TARGET_DIR)/product/core_64_bit_only.mk)<br />
$(call inherit-product, $(SRC_TARGET_DIR)/product/virtual_ab_ota/launch_with_vendor_ramdisk.mk) # vab加载到vendor boot里使用<br />
<br />
# Inherit from TWRP product configuration<br />
$(call inherit-product, vendor/twrp/config/common.mk) # twrp-9分支改为onmi<br />
<br />
# Device specific configs<br />
$(call inherit-product, device/xiaomi/rubens/device.mk)<br />
<br />
# Device identifier<br />
PRODUCT_DEVICE := rubens # 设备型号<br />
PRODUCT_NAME := twrp_rubens # 设备名称<br />
PRODUCT_BRAND := Redmi # 自定义品牌，如果有<br />
PRODUCT_MODEL := 22041211AC # 产品最终用户可见名称<br />
PRODUCT_MANUFACTURER := Xiaomi # 制造商<br />
<br />
PRODUCT_PROPERTY_OVERRIDES += ro.twrp.vendor_boot=true # 对twrp启动vendor_boot支持<br />
无注释版<br />
# Inherit from common AOSP config<br />
$(call inherit-product, $(SRC_TARGET_DIR)/product/base.mk)<br />
$(call inherit-product, $(SRC_TARGET_DIR)/product/core_64_bit_only.mk)<br />
$(call inherit-product, $(SRC_TARGET_DIR)/product/virtual_ab_ota/launch_with_vendor_ramdisk.mk) # vab加载到vendor boot里使用<br />
<br />
# Inherit from TWRP product configuration<br />
$(call inherit-product, vendor/twrp/config/common.mk)<br />
<br />
# Device specific configs<br />
$(call inherit-product, device/xiaomi/rubens/device.mk)<br />
<br />
# Device identifier<br />
PRODUCT_DEVICE := rubens<br />
PRODUCT_NAME := twrp_rubens<br />
PRODUCT_BRAND := Redmi<br />
PRODUCT_MODEL := 22041211AC<br />
PRODUCT_MANUFACTURER := Xiaomi<br />
<br />
PRODUCT_PROPERTY_OVERRIDES += ro.twrp.vendor_boot=true<br />
<br />
==== 初始 recovery 目录 ====<br />
<blockquote>拿出我们好久之前准备的 ramdisk 叭</blockquote>通过tree命令我们可以查看 ramdisk 的树状图，可以很清晰的查看包含的文件<br />
├── acct<br />
├── apex<br />
├── bin -> /system/bin<br />
├── bugreports -> /data/user_de/0/com.android.shell/files/bugreports<br />
├── config<br />
├── d -> /sys/kernel/debug<br />
├── data<br />
├── data_mirror<br />
├── debug_ramdisk<br />
├── default.prop -> prop.default<br />
├── dev<br />
├── etc -> /system/etc<br />
├── first_stage_ramdisk<br />
│ ├── fstab.emmc<br />
│ ├── fstab.mt6895<br />
│ └── system<br />
│ ├── bin<br />
│ │ ├── e2fsck<br />
│ │ ├── linker64<br />
│ │ ├── linker_asan64 -> linker64<br />
│ │ └── snapuserd<br />
│ └── lib64<br />
│ ├── ld-android.so<br />
│ ├── libbase.so<br />
│ ├── libc++.so<br />
│ ├── libc.so<br />
│ ├── libdl.so<br />
│ ├── libext2_blkid.so<br />
│ ├── libext2_com_err.so<br />
│ ├── libext2_e2p.so<br />
│ ├── libext2_quota.so<br />
│ ├── libext2_uuid.so<br />
│ ├── libext2fs.so<br />
│ ├── liblog.so<br />
│ ├── libm.so<br />
│ ├── libsparse.so<br />
│ └── libz.so<br />
├── init -> /system/bin/init<br />
├── init.recovery.hardware.rc<br />
├── init.recovery.mt6895.rc<br />
└── 等等等等...省略大概1000个文件吧<br />
<blockquote>因为避免教程时效性，我们尽可能选取 prebuilt 的办法，如 boot 和 mtk_plpath_utils 都采用预编译。</blockquote>里面有很多文件是没用的，整理一下，对我们有用的只有这些<br />
.<br />
├── first_stage_ramdisk<br />
│ ├── fstab.emmc<br />
│ └── fstab.mt6895<br />
├── init.recovery.mt6895.rc<br />
├── lib<br />
│ └── modules<br />
│ ├── 8250_mtk.ko<br />
│ ├── adapter_class.ko<br />
│ ├── adsp.ko<br />
│ ├── aee_aed.ko<br />
│ ├── aee_hangdet.ko<br />
│ ├── aee_rs.ko<br />
│ ├── blocktag.ko<br />
│ ├── bootprof.ko<br />
│ ├── bq28z610.ko<br />
│ ├── cache-parity.ko<br />
│ ├── cfg80211.ko<br />
│ ├── charger_class.ko<br />
│ └── 省略一百多个模块，这个目录里的东西全要<br />
└── system<br />
├── bin<br />
│ └── mtk_plpath_utils<br />
├── etc<br />
│ ├── init<br />
│ │ │── mtk-plpath-utils.rc<br />
│ │ └──hw<br />
│ │ └──init.rc<br />
│ ├── recovery.fstab<br />
│ ├── security<br />
│ │ └── otacerts.zip<br />
│ └── ueventd.rc<br />
└── lib64<br />
└── hw<br />
└── android.hardware.boot@1.0-impl-1.2-mtkimpl.so<br />
将它们按照以下操作复制<br />
<br />
* first_stage_ramdisk --> recovery/root/first_stage_ramdisk<br />
* init.recovery.mt6895.rc --> recovery/root/init.recovery.mt6895.rc<br />
* lib --> recovery/root/lib<br />
* system --> recovery/root/system (security 和 hw 文件夹里的内容作为备用，不要复制进去) 得到以下目录结构<br />
<br />
.<br />
├── Android.mk<br />
├── AndroidProducts.mk<br />
├── BoardConfig.mk<br />
├── device.mk<br />
├── prebuilt<br />
├── recovery<br />
│ └── root<br />
│ ├── first_stage_ramdisk<br />
│ │ ├── fstab.emmc<br />
│ │ └── fstab.mt6895<br />
│ ├── init.recovery.mt6895.rc<br />
│ ├── lib<br />
│ │ └── modules<br />
│ │ ├── 8250_mtk.ko<br />
│ │ ├── adapter_class.ko<br />
│ │ ├── adsp.ko<br />
│ │ ├── aee_aed.ko<br />
│ │ ├── aee_hangdet.ko<br />
│ │ ├── aee_rs.ko<br />
│ │ ├── blocktag.ko<br />
│ │ └── 省略....<br />
│ └── system<br />
│ ├── bin<br />
│ │ └── mtk_plpath_utils<br />
│ ├── etc<br />
│ │ ├── recovery.fstab<br />
│ │ └── ueventd.rc<br />
│ └── lib64<br />
│ └── hw<br />
│ └── android.hardware.boot@1.0-impl-1.2-mtkimpl.so<br />
└── twrp_rubens.mk<br />
打开 init.recovery.mt6895.rc 添加<br />
on boot<br />
start health-hal-2-1<br />
<br />
on post-fs<br />
start boot-hal-1-2<br />
例如<br />
on post-fs<br />
start boot-hal-1-2<br />
<br />
on init<br />
setprop sys.usb.configfs 1<br />
setprop sys.usb.controller "11201000.usb0"<br />
setprop sys.usb.ffs.aio_compat 1<br />
<br />
on fs && property:ro.debuggable=0<br />
# distinguish USB shoulde connect or not, i.e. CDP vs SDP<br />
# set charging free due to it wait for USB activation<br />
<br />
on boot<br />
start health-hal-2-1<br />
exec u:r:update_engine:s0 root root -- /system/bin/mtk_plpath_utils<br />
<br />
接下来可以开始编译咯~~<br />
<br />
==== 编译 ====<br />
<blockquote>编译前请检查注释是否全部删除</blockquote>twrp 源码根目录执行<br />
. build/envsetup.sh<br />
lunch twrp_codename-eng # twrp-9为onmi<br />
mka vendorbootimg/bootimage/recoveryimage<br />
不出意外的话一路绿灯，如果有报错的话请发邮箱至 1592501605@qq.com 咨询我<br />
<br />
产物在 out/target/product/codename/vendor_boot.img\boot.img\recovery.img<br />
<br />
手机重启到 fastboot 模式，使用 fastboot flash 刷写，例如<br />
fastboot flash vendor_boot /Users/xiaolegun/Downloads/vendor_boot.img<br />
则输出<br />
ERROR: could not clear input pipe; result e0005000, ignoring...<br />
ERROR: could not clear output pipe; result e0005000, ignoring....<br />
Sending 'vendor_boot_a' (65536 KB) OKAY [ 1.396s]<br />
Writing 'vendor_boot_a' OKAY [ 0.167s]<br />
Finished. Total time: 1.625s<br />
就可以重启按电源加音量上尝试了，我自己是一次点亮，但有 bug。<br />
<br />
==== 修 BUG ====<br />
<br />
===== 修复 USB =====<br />
我看到 twrp 控制台有很多报错，第一步肯定是先获取日志，使用logcat命令获取，在此之前先使用adb devices检测一下设备 usb 是否工作正常。<br />
xiaolegun@xiaoleGundeMac-Pro ~ adb devices ✔ 10208 10:05:31<br />
* daemon not running; starting now at tcp:5037<br />
* daemon started successfully<br />
List of devices attached<br />
可以看到adb没有检测到设备，原因一般是 usb 的配置不对，但 usb 是好的。这时可以尝试关闭 mtp，再开启，如果电脑有反应，那么就可以继续下一步了。<br />
<br />
在设备树中的 recovery/root，创建 init.recovery.usb.rc 的文件<br />
touch recovery/root/init.recovery.usb.rc<br />
并导入以下内容<br />
on property:sys.usb.config=mtp,adb<br />
start adbd<br />
<br />
on property:sys.usb.ffs.ready=1 && property:sys.usb.config=mtp,adb<br />
write /config/usb_gadget/g1/configs/b.1/strings/0x409/configuration "mtp_adb"<br />
rm /config/usb_gadget/g1/configs/b.1/f1<br />
rm /config/usb_gadget/g1/configs/b.1/f2<br />
rm /config/usb_gadget/g1/configs/b.1/f3<br />
rm /config/usb_gadget/g1/configs/b.1/f4<br />
rm /config/usb_gadget/g1/configs/b.1/f5<br />
write /config/usb_gadget/g1/idVendor 0x18d1<br />
write /config/usb_gadget/g1/idProduct 0x2d08<br />
symlink /config/usb_gadget/g1/functions/mtp.gs0 /config/usb_gadget/g1/configs/b.1/f1<br />
symlink /config/usb_gadget/g1/functions/ffs.adb /config/usb_gadget/g1/configs/b.1/f2<br />
write /config/usb_gadget/g1/UDC ${sys.usb.controller}<br />
setprop sys.usb.state ${sys.usb.config}<br />
这是我从我维护的 MI 6X 的 device tree 拿过来的，可以在联发科设备上正常工作。这段 shell 的大致意思就是在 usb 配置节点写入 mtp 和 adb 同时工作的字符串，这样 adb 就能顺利工作了。<br />
<br />
此外打开原厂 init.rc 修正一下 usb 设备的 id<br />
# MIUI ADD: START<br />
import /init.recovery.hardware.rc<br />
import /miui.factoryreset.rc<br />
# END<br />
import /init.recovery.${ro.hardware}.rc<br />
<br />
########### 省略一万字<br />
<br />
# MIUI ADD: START<br />
on property:sys.usb.config=mtp,adb && property:sys.usb.configfs=0<br />
write /sys/class/android_usb/android0/enable 0<br />
write /sys/class/android_usb/android0/idVendor 2717<br />
write /sys/class/android_usb/android0/idProduct 904D<br />
write /sys/class/android_usb/android0/functions mtp,adb<br />
write /sys/class/android_usb/android0/enable 1<br />
setprop sys.usb.state ${sys.usb.config}<br />
# END<br />
将/sys/class/android_usb/android0/idVendor和write /sys/class/android_usb/android0/idProduct后面的 id 分别替换到/config/usb_gadget/g1/idVendor和/config/usb_gadget/g1/idProduct处理完就是这样的。<br />
on property:sys.usb.config=mtp,adb<br />
start adbd<br />
<br />
on property:sys.usb.ffs.ready=1 && property:sys.usb.config=mtp,adb<br />
write /config/usb_gadget/g1/configs/b.1/strings/0x409/configuration "mtp_adb"<br />
rm /config/usb_gadget/g1/configs/b.1/f1<br />
rm /config/usb_gadget/g1/configs/b.1/f2<br />
rm /config/usb_gadget/g1/configs/b.1/f3<br />
rm /config/usb_gadget/g1/configs/b.1/f4<br />
rm /config/usb_gadget/g1/configs/b.1/f5<br />
write /config/usb_gadget/g1/idVendor 0x2717<br />
write /config/usb_gadget/g1/idProduct 0x904D<br />
symlink /config/usb_gadget/g1/functions/mtp.gs0 /config/usb_gadget/g1/configs/b.1/f1<br />
symlink /config/usb_gadget/g1/functions/ffs.adb /config/usb_gadget/g1/configs/b.1/f2<br />
write /config/usb_gadget/g1/UDC ${sys.usb.controller}<br />
setprop sys.usb.state ${sys.usb.config}<br />
接下来开机之后 adb 和 mtp 就能同时工作了。<br />
<br />
===== 修复 Resetprop =====<br />
接下来就可以修复其它 bug 了，我看到控制台有一堆红色的报错:<br />
E:Unknown File System:'/mi_ext'<br />
E:Unable to override 'external_storage.projid.enabled' due to missing libresetprop<br />
挂载“/data”失败(Invalid argument)<br />
这三个报错中第二个最好修，第一个次之，第三个与解密有关，放在另一个大章节讲。<br />
<br />
第二个报错只需要在 BoardConfig.mk 中添加<br />
# Tool<br />
TW_INCLUDE_RESETPROP := true<br />
TW_INCLUDE_LIBRESETPROP := true<br />
不用编译测试直接秒杀<br />
<br />
===== 修复挂载 =====<br />
E:Unknown File System:'/mi_ext'<br />
我们打开 recovery/root/system/etc 中的 recovery.fstab，发现里面有很多空格，我们先将它格式化一下，有实力的可以把后面的 flag 也对齐整理好。<br />
<br />
我比较没实力，简单格式化了一下，是这样的<br />
# 1 "vendor/mediatek/proprietary/hardware/fstab/mt6895/fstab.in.mt6895"<br />
# 1 "<built-in>" 1<br />
# 1 "<built-in>" 3<br />
# 341 "<built-in>" 3<br />
# 1 "<command line>" 1<br />
# 1 "<built-in>" 2<br />
# 1 "vendor/mediatek/proprietary/hardware/fstab/mt6895/fstab.in.mt6895" 2<br />
# 173 "vendor/mediatek/proprietary/hardware/fstab/mt6895/fstab.in.mt6895"<br />
system /system erofs ro wait,slotselect,avb=vbmeta_system,logical,first_stage_mount,avb_keys=/avb/q-gsi.avbpubkey:/avb/r-gsi.avbpubkey:/avb/s-gsi.avbpubkey<br />
system /system ext4 ro wait,slotselect,avb=vbmeta_system,logical,first_stage_mount,avb_keys=/avb/q-gsi.avbpubkey:/avb/r-gsi.avbpubkey:/avb/s-gsi.avbpubkey<br />
vendor /vendor erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
vendor /vendor ext4 ro wait,slotselect,avb,logical,first_stage_mount<br />
product /product erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
product /product ext4 ro wait,slotselect,avb,logical,first_stage_mount<br />
mi_ext /mnt/vendor/mi_ext erofs ro wait,slotselect,avb=vbmeta,logical,first_stage_mount,nofail<br />
mi_ext /mnt/vendor/mi_ext ext4 ro wait,slotselect,avb=vbmeta,logical,first_stage_mount,nofail<br />
/mnt/vendor/mi_ext /mi_ext none ro,bind wait,nofail<br />
overlay /product/overlay overlay ro,lowerdir=/mnt/vendor/mi_ext/product/overlay/:/product/overlay check,nofail<br />
overlay /product/app overlay ro,lowerdir=/mnt/vendor/mi_ext/product/app/:/product/app check,nofail<br />
overlay /product/priv-app overlay ro,lowerdir=/mnt/vendor/mi_ext/product/priv-app/:/product/priv-app check,nofail<br />
overlay /product/lib overlay ro,lowerdir=/mnt/vendor/mi_ext/product/lib/:/product/lib check,nofail<br />
overlay /product/lib64 overlay ro,lowerdir=/mnt/vendor/mi_ext/product/lib64/:/product/lib64 check,nofail<br />
overlay /product/bin overlay ro,lowerdir=/mnt/vendor/mi_ext/product/bin/:/product/bin check,nofail<br />
overlay /product/framework overlay ro,lowerdir=/mnt/vendor/mi_ext/product/framework/:/product/framework check,nofail<br />
overlay /product/media overlay ro,lowerdir=/mnt/vendor/mi_ext/product/media/:/product/media check,nofail<br />
overlay /product/opcust overlay ro,lowerdir=/mnt/vendor/mi_ext/product/opcust/:/product/opcust check,nofail<br />
overlay /product/data-app overlay ro,lowerdir=/mnt/vendor/mi_ext/product/data-app/:/product/data-app check,nofail<br />
overlay /product/etc/sysconfig overlay ro,lowerdir=/mnt/vendor/mi_ext/product/etc/sysconfig/:/product/etc/sysconfig check,nofail<br />
overlay /product/etc/permissions overlay ro,lowerdir=/mnt/vendor/mi_ext/product/etc/permissions/:/product/etc/permissions check,nofail<br />
overlay /system/app overlay ro,lowerdir=/mnt/vendor/mi_ext/system/app/:/product/pangu/system/app/:/system/app check,nofail<br />
overlay /system/priv-app overlay ro,lowerdir=/mnt/vendor/mi_ext/system/priv-app/:/product/pangu/system/priv-app/:/system/priv-app check,nofail<br />
overlay /system/framework overlay ro,lowerdir=/product/pangu/system/framework/:/system/framework check,nofail<br />
overlay /system/etc/sysconfig overlay ro,lowerdir=/mnt/vendor/mi_ext/system/etc/sysconfig/:/system/etc/sysconfig check,nofail<br />
overlay /system/etc/permissions overlay ro,lowerdir=/mnt/vendor/mi_ext/system/etc/permissions/:/product/pangu/system/etc/permissions/:/system/etc/permissions check,nofail<br />
system_ext /system_ext erofs ro wait,slotselect,avb=vbmeta_system,logical,first_stage_mount,avb_keys=/avb/q-gsi.avbpubkey:/avb/r-gsi.avbpubkey:/avb/s-gsi.avbpubkey<br />
system_ext /system_ext ext4 ro wait,slotselect,avb=vbmeta_system,logical,first_stage_mount,avb_keys=/avb/q-gsi.avbpubkey:/avb/r-gsi.avbpubkey:/avb/s-gsi.avbpubkey<br />
odm /odm erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
odm /odm ext4 ro wait,slotselect,avb,logical,first_stage_mount<br />
vendor_dlkm /vendor_dlkm erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
odm_dlkm /odm_dlkm erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
/dev/block/by-name/metadata /metadata ext4 noatime,nosuid,nodev,discard wait,check,formattable,first_stage_mount<br />
/dev/block/by-name/userdata /data f2fs noatime,nosuid,nodev,discard,noflush_merge,fsync_mode=nobarrier,reserve_root=134217,resgid=1065,checkpoint_merge,gc_merge,inlinecrypt wait,check,formattable,quota,latemount,resize,reservedsize=128m,checkpoint=fs,fileencryption=aes-256-xts:aes-256-cts:v2+inlinecrypt_optimized,keydirectory=/metadata/vold/metadata_encryption,fsverity<br />
/dev/block/by-name/rescue /cache ext4 noatime,nosuid,nodev,noauto_da_alloc,discard wait,check,formattable<br />
/dev/block/by-name/protect1 /mnt/vendor/protect_f ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/dev/block/by-name/protect2 /mnt/vendor/protect_s ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/dev/block/by-name/nvdata /mnt/vendor/nvdata ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/dev/block/by-name/nvcfg /mnt/vendor/nvcfg ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/dev/block/by-name/persist /mnt/vendor/persist ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/devices/platform/soc/11240000.mmc* auto auto defaults voldmanaged=sdcard1:auto,encryptable=userdata<br />
/devices/platform/usb_xhci* auto vfat defaults voldmanaged=usbotg:auto<br />
/devices/platform/soc/11201000.usb0/11200000.xhci* auto vfat defaults voldmanaged=usbotg:auto<br />
/dev/block/by-name/frp /persistent emmc defaults defaults<br />
/dev/block/by-name/nvram /nvram emmc defaults defaults<br />
/dev/block/by-name/proinfo /proinfo emmc defaults defaults<br />
/dev/block/by-name/lk /bootloader emmc defaults defaults<br />
/dev/block/by-name/lk2 /bootloader2 emmc defaults defaults<br />
/dev/block/by-name/para /para emmc defaults defaults<br />
/dev/block/by-name/misc /misc emmc defaults defaults<br />
/dev/block/by-name/boot /boot emmc defaults first_stage_mount,nofail,slotselect<br />
/dev/block/by-name/vbmeta_vendor /vbmeta_vendor emmc defaults first_stage_mount,nofail,slotselect<br />
/dev/block/by-name/vbmeta_system /vbmeta_system emmc defaults first_stage_mount,nofail,slotselect,avb=vbmeta<br />
/dev/block/by-name/logo /logo emmc defaults defaults<br />
/dev/block/by-name/expdb /expdb emmc defaults defaults<br />
/dev/block/by-name/seccfg /seccfg emmc defaults defaults<br />
/dev/block/by-name/tee1 /tee1 emmc defaults defaults<br />
/dev/block/by-name/tee2 /tee2 emmc defaults defaults<br />
/dev/block/by-name/scp1 /scp1 emmc defaults defaults<br />
/dev/block/by-name/scp2 /scp2 emmc defaults defaults<br />
/dev/block/by-name/sspm_1 /sspm_1 emmc defaults defaults<br />
/dev/block/by-name/sspm_2 /sspm_2 emmc defaults defaults<br />
/dev/block/by-name/dpm_1 /dpm_1 emmc defaults defaults<br />
/dev/block/by-name/dpm_2 /dpm_2 emmc defaults defaults<br />
/dev/block/by-name/mcupm_1 /mcupm_1 emmc defaults defaults<br />
/dev/block/by-name/mcupm_2 /mcupm_2 emmc defaults defaults<br />
/dev/block/by-name/md1img /md1img emmc defaults defaults<br />
/dev/block/by-name/md1dsp /md1dsp emmc defaults defaults<br />
/dev/block/by-name/md1arm7 /md1arm7 emmc defaults defaults<br />
/dev/block/by-name/md3img /md3img emmc defaults defaults<br />
/dev/block/by-name/gz1 /gz1 emmc defaults defaults<br />
/dev/block/by-name/gz2 /gz2 emmc defaults defaults<br />
/dev/block/by-name/spmfw /spmfw emmc defaults defaults<br />
/dev/block/by-name/audio_dsp /audio_dsp emmc defaults defaults<br />
/dev/block/by-name/pi_img /pi_img emmc defaults defaults<br />
/dev/block/by-name/boot_para /boot_para emmc defaults defaults<br />
/dev/block/by-name/odmdtbo /odmdtbo emmc defaults defaults<br />
/dev/block/by-name/dtbo /dtbo emmc defaults defaults<br />
/dev/block/by-name/otp /otp emmc defaults defaults<br />
/dev/block/by-name/vbmeta /vbmeta emmc defaults defaults<br />
这里面有很多无用分区，我们在 twrp 中操作不到，但是我也是第一次适配 MTK 设备，所以不“瞎说”误人子弟了，先把 bug 修好。<br />
<br />
像 xiaomi 这样常见的挂载错误，我自己一般都是尝试把/mnt/vendor 使用 vscode 全部删除，让我们尝试一下。并且要把这一行删除，这行在我看来是重复定义（？而且也没指定分区格式。<br />
/mnt/vendor/mi_ext /mi_ext none ro,bind wait,nofail<br />
整理完之后是这样的<br />
# 1 "vendor/mediatek/proprietary/hardware/fstab/mt6895/fstab.in.mt6895"<br />
# 1 "<built-in>" 1<br />
# 1 "<built-in>" 3<br />
# 341 "<built-in>" 3<br />
# 1 "<command line>" 1<br />
# 1 "<built-in>" 2<br />
# 1 "vendor/mediatek/proprietary/hardware/fstab/mt6895/fstab.in.mt6895" 2<br />
# 173 "vendor/mediatek/proprietary/hardware/fstab/mt6895/fstab.in.mt6895"<br />
system /system erofs ro wait,slotselect,avb=vbmeta_system,logical,first_stage_mount,avb_keys=/avb/q-gsi.avbpubkey:/avb/r-gsi.avbpubkey:/avb/s-gsi.avbpubkey<br />
system /system ext4 ro wait,slotselect,avb=vbmeta_system,logical,first_stage_mount,avb_keys=/avb/q-gsi.avbpubkey:/avb/r-gsi.avbpubkey:/avb/s-gsi.avbpubkey<br />
vendor /vendor erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
vendor /vendor ext4 ro wait,slotselect,avb,logical,first_stage_mount<br />
product /product erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
product /product ext4 ro wait,slotselect,avb,logical,first_stage_mount<br />
mi_ext /mi_ext erofs ro wait,slotselect,avb=vbmeta,logical,first_stage_mount,nofail<br />
mi_ext /mi_ext ext4 ro wait,slotselect,avb=vbmeta,logical,first_stage_mount,nofail<br />
overlay /product/overlay overlay ro,lowerdir=/mi_ext/product/overlay/:/product/overlay check,nofail<br />
overlay /product/app overlay ro,lowerdir=/mi_ext/product/app/:/product/app check,nofail<br />
overlay /product/priv-app overlay ro,lowerdir=/mi_ext/product/priv-app/:/product/priv-app check,nofail<br />
overlay /product/lib overlay ro,lowerdir=/mi_ext/product/lib/:/product/lib check,nofail<br />
overlay /product/lib64 overlay ro,lowerdir=/mi_ext/product/lib64/:/product/lib64 check,nofail<br />
overlay /product/bin overlay ro,lowerdir=/mi_ext/product/bin/:/product/bin check,nofail<br />
overlay /product/framework overlay ro,lowerdir=/mi_ext/product/framework/:/product/framework check,nofail<br />
overlay /product/media overlay ro,lowerdir=/mi_ext/product/media/:/product/media check,nofail<br />
overlay /product/opcust overlay ro,lowerdir=/mi_ext/product/opcust/:/product/opcust check,nofail<br />
overlay /product/data-app overlay ro,lowerdir=/mi_ext/product/data-app/:/product/data-app check,nofail<br />
overlay /product/etc/sysconfig overlay ro,lowerdir=/mi_ext/product/etc/sysconfig/:/product/etc/sysconfig check,nofail<br />
overlay /product/etc/permissions overlay ro,lowerdir=/mi_ext/product/etc/permissions/:/product/etc/permissions check,nofail<br />
overlay /system/app overlay ro,lowerdir=/mi_ext/system/app/:/product/pangu/system/app/:/system/app check,nofail<br />
overlay /system/priv-app overlay ro,lowerdir=/mi_ext/system/priv-app/:/product/pangu/system/priv-app/:/system/priv-app check,nofail<br />
overlay /system/framework overlay ro,lowerdir=/product/pangu/system/framework/:/system/framework check,nofail<br />
overlay /system/etc/sysconfig overlay ro,lowerdir=/mi_ext/system/etc/sysconfig/:/system/etc/sysconfig check,nofail<br />
overlay /system/etc/permissions overlay ro,lowerdir=/mi_ext/system/etc/permissions/:/product/pangu/system/etc/permissions/:/system/etc/permissions check,nofail<br />
system_ext /system_ext erofs ro wait,slotselect,avb=vbmeta_system,logical,first_stage_mount,avb_keys=/avb/q-gsi.avbpubkey:/avb/r-gsi.avbpubkey:/avb/s-gsi.avbpubkey<br />
system_ext /system_ext ext4 ro wait,slotselect,avb=vbmeta_system,logical,first_stage_mount,avb_keys=/avb/q-gsi.avbpubkey:/avb/r-gsi.avbpubkey:/avb/s-gsi.avbpubkey<br />
odm /odm erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
odm /odm ext4 ro wait,slotselect,avb,logical,first_stage_mount<br />
vendor_dlkm /vendor_dlkm erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
odm_dlkm /odm_dlkm erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
/dev/block/by-name/metadata /metadata ext4 noatime,nosuid,nodev,discard wait,check,formattable,first_stage_mount<br />
/dev/block/by-name/userdata /data f2fs noatime,nosuid,nodev,discard,noflush_merge,fsync_mode=nobarrier,reserve_root=134217,resgid=1065,checkpoint_merge,gc_merge,inlinecrypt wait,check,formattable,quota,latemount,resize,reservedsize=128m,checkpoint=fs,fileencryption=aes-256-xts:aes-256-cts:v2+inlinecrypt_optimized,keydirectory=/metadata/vold/metadata_encryption,fsverity<br />
/dev/block/by-name/rescue /cache ext4 noatime,nosuid,nodev,noauto_da_alloc,discard wait,check,formattable<br />
/dev/block/by-name/protect1 /protect_f ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/dev/block/by-name/protect2 /protect_s ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/dev/block/by-name/nvdata /nvdata ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/dev/block/by-name/nvcfg /nvcfg ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/dev/block/by-name/persist /persist ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/devices/platform/soc/11240000.mmc* auto auto defaults voldmanaged=sdcard1:auto,encryptable=userdata<br />
/devices/platform/usb_xhci* auto vfat defaults voldmanaged=usbotg:auto<br />
/devices/platform/soc/11201000.usb0/11200000.xhci* auto vfat defaults voldmanaged=usbotg:auto<br />
/dev/block/by-name/frp /persistent emmc defaults defaults<br />
/dev/block/by-name/nvram /nvram emmc defaults defaults<br />
/dev/block/by-name/proinfo /proinfo emmc defaults defaults<br />
/dev/block/by-name/lk /bootloader emmc defaults defaults<br />
/dev/block/by-name/lk2 /bootloader2 emmc defaults defaults<br />
/dev/block/by-name/para /para emmc defaults defaults<br />
/dev/block/by-name/misc /misc emmc defaults defaults<br />
/dev/block/by-name/boot /boot emmc defaults first_stage_mount,nofail,slotselect<br />
/dev/block/by-name/vbmeta_vendor /vbmeta_vendor emmc defaults first_stage_mount,nofail,slotselect<br />
/dev/block/by-name/vbmeta_system /vbmeta_system emmc defaults first_stage_mount,nofail,slotselect,avb=vbmeta<br />
/dev/block/by-name/logo /logo emmc defaults defaults<br />
/dev/block/by-name/expdb /expdb emmc defaults defaults<br />
/dev/block/by-name/seccfg /seccfg emmc defaults defaults<br />
/dev/block/by-name/tee1 /tee1 emmc defaults defaults<br />
/dev/block/by-name/tee2 /tee2 emmc defaults defaults<br />
/dev/block/by-name/scp1 /scp1 emmc defaults defaults<br />
/dev/block/by-name/scp2 /scp2 emmc defaults defaults<br />
/dev/block/by-name/sspm_1 /sspm_1 emmc defaults defaults<br />
/dev/block/by-name/sspm_2 /sspm_2 emmc defaults defaults<br />
/dev/block/by-name/dpm_1 /dpm_1 emmc defaults defaults<br />
/dev/block/by-name/dpm_2 /dpm_2 emmc defaults defaults<br />
/dev/block/by-name/mcupm_1 /mcupm_1 emmc defaults defaults<br />
/dev/block/by-name/mcupm_2 /mcupm_2 emmc defaults defaults<br />
/dev/block/by-name/md1img /md1img emmc defaults defaults<br />
/dev/block/by-name/md1dsp /md1dsp emmc defaults defaults<br />
/dev/block/by-name/md1arm7 /md1arm7 emmc defaults defaults<br />
/dev/block/by-name/md3img /md3img emmc defaults defaults<br />
/dev/block/by-name/gz1 /gz1 emmc defaults defaults<br />
/dev/block/by-name/gz2 /gz2 emmc defaults defaults<br />
/dev/block/by-name/spmfw /spmfw emmc defaults defaults<br />
/dev/block/by-name/audio_dsp /audio_dsp emmc defaults defaults<br />
/dev/block/by-name/pi_img /pi_img emmc defaults defaults<br />
/dev/block/by-name/boot_para /boot_para emmc defaults defaults<br />
/dev/block/by-name/odmdtbo /odmdtbo emmc defaults defaults<br />
/dev/block/by-name/dtbo /dtbo emmc defaults defaults<br />
/dev/block/by-name/otp /otp emmc defaults defaults<br />
/dev/block/by-name/vbmeta /vbmeta emmc defaults defaults<br />
让我们编译试一下，值得注意的是，twrp 每次更改最好删除 out 重新编译，不要使用如make installclean等命令，可能会开机黑屏或更改不生效。<br />
<br />
经过一分钟，编译好了，刷入，开机，启动！可以看见挂载成功被修好。<br />
<br />
===== 修复屏幕显示 =====<br />
可以看到我们现在屏幕的顶部的时间被摄像头挖孔挡住了。我们使用两个偏移 Flag 来修复它。<br />
<br />
在 BoardConfig.mk 中，加入以下 flag<br />
TW_Y_OFFSET := 106 #导航栏向上<br />
TW_H_OFFSET := -106 #界面整体向下<br />
<br />
===== 修复振动 =====<br />
<blockquote>仅供参考，研究半天发现只有解密功能正常才能修振动，不然会冻屏！！！<br />
<br />
不一定正确，也不一定普遍，仅供指路</blockquote>老设备一般都是正常的，不需要额外处理，新设备使用 aidl hal 需要我们自己处理一下让 service 正常工作。<br />
<br />
挂载 vendor，使用 twrp 的文件管理，在 vendor/etc/vintf/manifest 找到含有 vibrator 字样的文件。打开之后检查是否类似这样的文段<br />
<manifest version="1.0" type="device"><br />
<hal format="aidl" override="true"><br />
<name>android.hardware.vibrator</name><br />
<fqname>IVibrator/vibratorfeature</fqname><br />
</hal><br />
</manifest><br />
那恭喜你，找对了，我的文件名是<br />
<br />
vendor.xiaomi.hardware.vibratorfeature.service.xml<br />
<br />
将它使用adb pull放到电脑上自己方便的位置备用。<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/$/mjw adb pull /vendor/etc/vintf/manifest/vendor.xiaomi.hardware.vibratorfeature.service.xml .<br />
/vendor/etc/vintf/manifest/vendor.xiao...ipped. 0.2 MB/s (1718 bytes in 0.009s)<br />
不看扩展名，到 vendor/bin/hw/找到同名的 service 同样利用adb pull放电脑备用。比如我的叫<br />
<br />
vendor.xiaomi.hardware.vibratorfeature.service<br />
<br />
然后到 vendor/etc/init/找到同名.rc 文件，拉到电脑上，在里面加一条。并在定义 service 的最下面加上seclabel u:r:recovery:s0可以被 recovery 使用。<br />
on boot<br />
start service被定义的名字<br />
例如<br />
on post-fs-data<br />
chown system system /sys/bus/i2c/drivers/aw8697_haptic/2-005a/f0_save<br />
chown system system /sys/bus/i2c/drivers/aw8697_haptic/2-005a/osc_save<br />
chown system system /sys/bus/i2c/drivers/aw8697_haptic/3-005a/osc_save<br />
# 省略一万字<br />
<br />
on boot<br />
start vibratorfeature-hal-service<br />
<br />
service vibratorfeature-hal-service /vendor/bin/hw/vendor.xiaomi.hardware.vibratorfeature.service<br />
class hal<br />
user system<br />
group system input<br />
onrestart restart vibratorfeature<br />
seclabel u:r:recovery:s0<br />
此外这种新设备在内核里还有振动模块需要加载，请到/vendor/modules/1.1/中寻找，例如我这台设备是haptic.ko，用 adb pull 拉取到电脑上，然后<br />
<br />
* haptic.ko --> recovery/root/vendor/modules/1.1<br />
<br />
至此所有必要的资料就准备好了。可能开机后仍然不工作，需要抓取 log 补缺失的 library，当然这是后话了。<br />
<br />
开干！<br />
<br />
在 BoardConfig.mk 中加入以下 flag<br />
TW_SUPPORT_INPUT_AIDL_HAPTICS := true<br />
将备用文件按照以下操作复制<br />
<br />
* vendor.xiaomi.hardware.vibratorfeature.service.xml --> recovery/root/vendor/etc/vintf/manifest<br />
* vendor.xiaomi.hardware.vibratorfeature.service --> recovery/root/vendor/bin/hw<br />
* vendor.xiaomi.hardware.vibratorfeature.service.rc --> recovery/root/vendor/etc/init<br />
<br />
之后编译，刷入，开机，喜提冻屏......<br />
<br />
问题不大，使用adb logcat抓取日志<br />
adb logcat > log.log<br />
打开 log，搜索F linker、linker、library、beginning of crash这几个关键词，我搜索第一个就出来了。<br />
F linker : CANNOT LINK EXECUTABLE "/vendor/bin/hw/vendor.xiaomi.hardware.vibratorfeature.service": library "android.hardware.vibrator-V1-ndk_platform.so" not found: needed by main executable<br />
这段报错的意思就是vendor.xiaomi.hardware.vibratorfeature.service找不到android.hardware.vibrator-V1-ndk_platform.so这个库，所以无法正常工作。<br />
<br />
打开 BoardConfig.mk 加入以下 flag<br />
# Library<br />
TARGET_RECOVERY_DEVICE_MODULES += \<br />
android.hardware.vibrator-V1-ndk_platform.vendor<br />
<br />
TW_RECOVERY_ADDITIONAL_RELINK_LIBRARY_FILES += \<br />
$(TARGET_OUT_SHARED_LIBRARIES)/android.hardware.vibrator-V1-ndk_platform.so<br />
再次编译尝试<br />
<br />
开机之后依然冻屏，继续抓 log，查找<br />
F linker : CANNOT LINK EXECUTABLE "/vendor/bin/hw/vendor.xiaomi.hardware.vibratorfeature.service": library "vendor.hardware.vibratorfeature.IVibratorExt-V1-ndk_platform.so" not found: needed by main executable<br />
vendor.hardware.vibratorfeature字样和我们之前导入的文件长得差不多，一般都是供应商专有文件，所以去设备提取，路径在 vendor/lib64 里，虽然设备冻屏了，但我们可以用adb pull直接拉取到电脑。就像这样。<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/$/mjw adb shell mount /vendor<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/$/mjw adb pull /vendor/lib64/vendor.hardware.vibratorfeature.IVibratorExt-V1-ndk_platform.so .<br />
/vendor/lib64/vendor.hardware.vibratorfeature.IVi...led, 0 skipped. 14.7 MB/s (33552 bytes in 0.002s<br />
将这个文件按照以下提示操作<br />
<br />
* vendor.hardware.vibratorfeature.IVibratorExt-V1-ndk_platform.so --> recovery/root/vendor/lib64<br />
<br />
继续编译测试<br />
<br />
还是冻屏，继续抓 log<br />
F linker : CANNOT LINK EXECUTABLE "/vendor/bin/hw/vendor.xiaomi.hardware.vibratorfeature.service": library "libtinyalsa.so" not found: needed by main executable<br />
这个 library twrp 的源码中应该没有，去设备拿一个 prebuilt 吧<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/$/mjw adb shell mount /system_root<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/$/mjw adb pull /system_root/system/lib64/libtinyalsa.so .<br />
/system_root/system/lib64/libtinyalsa.so: 1 file ...led, 0 skipped. 13.6 MB/s (45032 bytes in 0.003s<br />
将这个文件按照以下提示操作<br />
<br />
* libtinyalsa.so --> recovery/root/system/lib64<br />
<br />
编译测试<br />
<br />
我艹了，还是冻屏，这次搜那几个关键词都搜不到了，搜vibrator看看这鬼东西报什么<br />
E vendor.xiaomi.hardware.vibratorfeature.service: fail to load lib : /vendor/lib64/libaachaptics.so<br />
这次都直接给路径了，直接拿。<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/$/mjw adb shell mount /vendor<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/$/mjw adb pull /vendor/lib64/libaachaptics.so .<br />
/vendor/lib64/libaachaptics.so: 1 file pulled, 0 skipped. 15.8 MB/s (56232 bytes in 0.003s)<br />
将这个文件按照以下提示操作<br />
<br />
* libaachaptics.so --> recovery/root/vendor/lib64<br />
<br />
至此应该没什么问题了，但是有个 flag 貌似要操作 data 内的东西，未解密会导致冻屏，所以等修完解密后再来修振动。<br />
<br />
==== 修复 CPU 温度 ====<br />
使用adb shell + grep命令在手机节点里搜索 type 关键词。<br />
xiaolegun@xiaoleGundeMac-Pro ~ adb shell 'grep "cp_master" /sys/class/thermal/*/type'<br />
/sys/class/thermal/thermal_zone54/type:cp_master<br />
xiaolegun@xiaoleGundeMac-Pro ~ adb shell 'grep "cpu" /sys/class/thermal/*/type'<br />
/sys/class/thermal/thermal_zone1/type:cpu_little1<br />
/sys/class/thermal/thermal_zone10/type:cpu_bigbig1<br />
/sys/class/thermal/thermal_zone11/type:cpu_big6<br />
/sys/class/thermal/thermal_zone12/type:cpu_bigbig2<br />
/sys/class/thermal/thermal_zone2/type:cpu_little2<br />
/sys/class/thermal/thermal_zone3/type:cpu_little3<br />
/sys/class/thermal/thermal_zone4/type:cpu_little4<br />
/sys/class/thermal/thermal_zone5/type:cpu_big1<br />
/sys/class/thermal/thermal_zone6/type:cpu_big2<br />
/sys/class/thermal/thermal_zone7/type:cpu_big3<br />
/sys/class/thermal/thermal_zone8/type:cpu_big4<br />
/sys/class/thermal/thermal_zone9/type:cpu_big5<br />
我这里选用cp_master节点来读取温度。我的节点路径为/sys/class/thermal/thermal_zone54在后面添加 temp 来读取温度，你可以使用cat来检测节点是否可以正常读取温度<br />
adb shell 'cat /sys/class/thermal/thermal_zone54/temp'<br />
如果返回如<br />
28000<br />
这种类似的数值，那多半是没有问题的。<br />
<br />
我们在 BoardConfig.mk 中加入<br />
TW_CUSTOM_CPU_TEMP_PATH := "/sys/class/thermal/thermal_zone54/temp"<br />
至此 cpu 温度就修复好了。<br />
<br />
== 后序 ==<br />
这是我玩 Android 两年内第一次写关于 Android 的文章，内容和措辞可能不是很准确，再加上开学焦虑，租房因租金和房源不顺利，写的很乱，请各位指正。<br />
<br />
此外有什么不懂得，多翻github，善用github搜索，多看看大佬们是怎么解决的。<br />
<br />
解密等有空补，先补作业。<br />
<br />
== 参考资料 ==<br />
[https://source.android.com/docs/setup/create/new-device?hl=zh-cn Google - 添加新设备]<br />
<br />
[https://source.android.com/docs/core/ota/ab?hl=zh-cn Google - A/B（无缝）系统更新]<br />
<br />
[https://blog.lynnrin.moe/posts/ROM-bringup-guide-prebuilt/#boardconfigmk Lynnrin - 快速上手 Android Custom ROM 适配 - Prebuilt Vendor]<br />
<br />
[https://source.android.com/docs/core/architecture/vintf?hl=zh-cn Google - 供应商接口对象]</div>
XiaoleGun
https://wiki.uotan.cn/index.php?title=%E4%B8%BA%E6%96%B0%E8%AE%BE%E5%A4%87%E7%BC%96%E5%86%99Recovery_device_tree&diff=549
为新设备编写Recovery device tree
2024-02-20T02:46:05Z
<p>XiaoleGun：初始页面</p>
<hr />
<div><br />
= 为新设备编写 Recovery 的设备树 =<br />
作者: Dark(xiaoleGun)<br />
<br />
时间: 2024.2.20<br />
<br />
协作者:<br />
<br />
== 一些自序 ==<br />
这篇教程中可能有些不对的地方，请各位指正，我也刚接触 Android 设备测开发两年，而且只有在节假日的时候有空一个人瞎捣鼓，为了<s>薅 mjw 羊毛</s>，故写这篇教程，而且我个人更推荐 Aosp Recovery 刷写第三方 ROM，TWRP 可能多多少少有些问题。Root 之类的不需要 TWRP 也可以，可以找到原机 boot 使用 Magisk 进行修补，也可以使用 KernelSU。另外我的语文功底不是很好，写不出辞藻，只能是北方地道的大白话，见谅哈 🤣///<br />
<br />
== 准备工作 ==<br />
1.一颗勇敢的、不怕困难的强大心脏。<br />
<br />
'''<s>两颗心好勇敢 -- Falling in love</s>'''<br />
<br />
2.电脑配置:<br />
{| class="wikitable"<br />
!硬件<br />
!需求<br />
|-<br />
|CPU<br />
|四核或更多<br />
|-<br />
|内存<br />
|8G 或更多<br />
|-<br />
|硬盘<br />
|至少 80G 空余空间<br />
|-<br />
|系统<br />
|WSL 或实体 Linux，建议 Debian 系<br />
|}<br />
3.足够的空闲时间。<br />
<br />
4.Vscode 和 🤏Linux 知识储备<br />
<br />
5.一台完好无损的新设备。<br />
<br />
6.设备原厂的 boot/recovery/vendor_boot 镜像。(推荐 recovery 分区，因为里面包含一些启动必须的.rc(run command)，如果没有该分区，寻找包含官方 recovery 内容的分区。值得注意的是部分设备 recovery 合并到了 boot 中，或是存在于 vendor_boot）<br />
<br />
7.查看自己的设备出厂 Android 版本并确定用途，是用于官方 ROM 还是第三方类原生。出厂版本为 9 及以上的可以使用 twrp-11 及以上分支，9 以下使用 twrp-9 分支。<br />
<br />
== 配置环境 ==<br />
<br />
=== 安装依赖 ===<br />
<code>sudo apt update<br />
sudo apt-get install bc bison build-essential ccache curl flex g++-multilib gcc-multilib git gnupg gperf imagemagick lib32ncurses5-dev lib32readline-dev lib32z1-dev liblz4-tool libncurses5 libncurses5-dev libsdl1.2-dev libssl-dev libxml2 libxml2-utils lzop pngcrush rsync schedtool squashfs-tools xsltproc zip zlib1g-dev xattr openjdk-11-jdk jq android-sdk-libsparse-utils python3 python2 repo</code><br />
必要时可以阅读[https://source.android.com/source/using-repo?hl=zh-cn Git 和 Repo]<br />
<br />
=== 配置 Git 和 Repo ===<br />
安装完依赖后，在终端执行。<br />
<code>git config --global user.name "your username"<br />
git config --global user.email "your email"</code><br />
<br />
=== 同步 TWRP 源码 ===<br />
在自己方便的地方，建立一个目录。<br />
<code>mkdir twrp<br />
cd twrp</code><br />
根据自己在准备工作中确定的分支同步相应的源码。<br />
<br />
==== TWRP-9 ====<br />
<code>repo init --depth=1 -u <nowiki>https://github.com/minimal-manifest-twrp/platform_manifest_twrp_omni.git</nowiki> -b twrp-9.0<br />
repo sync</code><br />
<br />
==== TWRP-11 ====<br />
<code>repo init --depth=1 -u <nowiki>https://github.com/minimal-manifest-twrp/platform_manifest_twrp_aosp.git</nowiki> -b twrp-11<br />
repo sync</code><br />
<br />
==== TWRP-12.1 ====<br />
<code>repo init --depth=1 -u <nowiki>https://github.com/minimal-manifest-twrp/platform_manifest_twrp_aosp.git</nowiki> -b twrp-12.1<br />
repo sync</code><br />
<br />
== 编写设备树 ==<br />
<blockquote>最基本的开机部分我通过 Redmi K50 做示例，并选取 TWRP-12.1 分支。<br />
<br />
解密部分会单独成一个章节并分为高通和联发科。</blockquote><br />
<br />
=== 获取资料 ===<br />
小米设备一般可以在[https://xiaomirom.com Xiaomirom]中的线刷包获取 boot/recovery/vendor_boot 镜像，其它设备请自行寻找。<br />
<br />
==== 安装工具和依赖 ====<br />
将准备工作中准备的 boot/recovery/vendor_boot 镜像解包，可以用任何工具，我这里使用[https://github.com/cfig/Android_boot_image_editor Android_boot_image_editor]按照自述文件进行依赖安装操作：<br />
<br />
===== Mac(Intel) =====<br />
<code>brew install lz4 xz dtc openjdk@17<br />
echo 'export PATH="/usr/local/opt/openjdk@17/bin:$PATH"' >> ~/.zshrc<br />
source ~/.zshrc</code><br />
<br />
===== Linux: =====<br />
<code>sudo apt update<br />
sudo apt install git device-tree-compiler lz4 xz-utils zlib1g-dev openjdk-17-jdk gcc g++ python3 python-is-python3 p7zip-full android-sdk-libsparse-utils erofs-utils</code><br />
<br />
===== Common: =====<br />
<code>git clone <nowiki>https://github.com/cfig/Android_boot_image_editor</nowiki><br />
cd Android_boot_image_editor</code><br />
<br />
==== 解包 ====<br />
<blockquote>请注意"/"表示或的意思，请不要误以为是一个东西。<br />
<br />
如果不确定分区寻找的是否正确，请尝试将可以的分区进行解包，并查看其<code>ramdisk</code>内是否包含<code>recovery</code>字样的文件</blockquote>将你准备好的<code>boot</code>/<code>recovery</code>/<code>vendor_boot</code>复制到该目录，你可以使用 GUI 或者 CLI。如:<br />
<code>cp <出厂boot/recovery/vendor_boot的绝对路径> boot/recovery/vendor_boot.img<br />
./gradlew unpack</code><br />
我这里以 Redmi K50 为例<br />
<code>10:12:13.188 [main] INFO cfig.bootimg.v3.VendorBoot -<br />
Unpack Summary of vendor_boot.img<br />
┌───────────────────────────────────────┬──────────────────────────────────────┐<br />
│What │Where │<br />
└───────────────────────────────────────┴──────────────────────────────────────┘<br />
┌───────────────────────────────────────┬──────────────────────────────────────┐<br />
│image info │build/unzip_boot/vendor_boot.json │<br />
├───────────────────────────────────────┼──────────────────────────────────────┤<br />
│ramdisk │build/unzip_boot/ramdisk.img.lz4 │<br />
│-- PLATFORM ramdisk[1/1] │build/unzip_boot/ramdisk.1.lz4 │<br />
│------- extracted rootfs │build/unzip_boot/root.1 │<br />
├───────────────────────────────────────┼──────────────────────────────────────┤<br />
│dtb │build/unzip_boot/dtb │<br />
├───────────────────────────────────────┼──────────────────────────────────────┤<br />
│AVB info │build/unzip_boot/vendor_boot.avb.json │<br />
│\-- signing key │NONE │<br />
└───────────────────────────────────────┴──────────────────────────────────────┘<br />
10:12:13.213 [main] WARN cfig.packable.PackableLauncher - 'unpack' sequence completed<br />
<br />
BUILD SUCCESSFUL in 2s</code><br />
解包成功后终端会打印出以上信息，其中包含<code>vendor_boot</code>目录结构，我们只需要<code>ramdisk</code>里的部分内容就好了。<br />
<code>ls build/unzip_boot/root.1 # 请根据自己的分区和设备判断ramdisk的命名，一般都直接是ramdisk</code><br />
不出意外的话会输出以下内容<br />
<code>xiaolegun@xiaoleGundeMac-Pro ~/github/dump/bootedit master ? ls build/unzip_boot/root.1<br />
acct oem<br />
apex plat_file_contexts<br />
bin plat_property_contexts<br />
bugreports postinstall<br />
config proc<br />
d product<br />
data product_file_contexts<br />
data_mirror product_property_contexts<br />
debug_ramdisk prop.default<br />
default.prop res<br />
dev sdcard<br />
etc second_stage_resources<br />
first_stage_ramdisk sepolicy<br />
init storage<br />
init.recovery.hardware.rc sys<br />
init.recovery.mt6895.rc system<br />
lib system_ext<br />
linkerconfig system_ext_file_contexts<br />
miui.factoryreset.fstab system_ext_property_contexts<br />
miui.factoryreset.rc tmp<br />
mnt vendor<br />
odm vendor_dlkm<br />
odm_dlkm vendor_file_contexts<br />
odm_file_contexts vendor_property_contexts<br />
odm_property_contexts</code><br />
如果包含 init.recovery*的字样，恭喜你成功找到了正确的分区。将这个目录复制到一个自己方便的地方。<br />
<br />
至此资料已经大致齐全了，解密的资料会在解密章节来讲解如何获取。<br />
<br />
=== 初始化目录结构 ===<br />
在 twrp 源码根目录输入<br />
<code>mkdir -p device/vendor/codename<br />
mkdir -p device/vendor/codename/recovery/root<br />
cd device/vendor/codename</code><br />
<code>vendor</code>指的是供应商，如 xiaomi、oneplus、huawei、vivo、realme。<br />
<br />
<code>codename</code>指的是设备代号，小米设备可以在[https://xiaomirom.com Xiaomirom]查询，其它设备自行查询亦或是在开发者选项勾选 USB 调试通过 adb 尝试获取。<br />
<code>adb shell getprop ro.product.manufacturer # 供应商<br />
adb shell getprop ro.product.device # 设备代号</code><br />
我的 Redmi K50 会打印以下信息<br />
<code>xiaolegun@xiaoleGundeMac-Pro ~/github/dump/bootedit master ? adb shell getprop ro.product.manufacturer<br />
Xiaomi # 无论打印出来的内容是大写还是小写，在目录结构中我们都采用小写<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/dump/bootedit master ? adb shell getprop ro.product.device<br />
rubens</code><br />
我的 IQOO NEO5 Lite 会打印以下信息<br />
<code>xiaolegun@xiaoleGundeMac-Pro ~/github/tmp/device/xiaomi/rubens adb shell getprop ro.product.manufacturer<br />
vivo<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/tmp/device/xiaomi/rubens adb shell getprop ro.product.device<br />
PD2118</code><br />
一般只要不是山寨机，小作坊出来的机子，用这两条命令应该是可以正确获取的。<br />
<br />
=== 初始化构建时必要的文件 ===<br />
无论是 AOSP device tree 亦或是 TWRP device tree 都基本类似于以下结构。<br />
<code>/<br />
├── prebuilt (存放kernel、dtb等预编译文件) # AOSP device tree若使用build kernel则没有该目录<br />
├── recovery/root (存放一些.rc和解密blobs) # 一般用于Recovery device tree<br />
├── Android.mk (Android构建系统首先会检查每个目录的Android.mk，里面包含一些判断，由它包括其所在目录中所有Makefile)<br />
├── AndroidProducts.mk (声明产品的Makefile和lunch时可用的构建类型)<br />
├── BoardConfig.mk (板载配置文件，定义了主板必要的Flag)<br />
├── device.mk (声明设备所需的文件和模块)<br />
└── <ROM>_codename.mk (声明产品特定信息，例如名称、品牌和型号，引用device.mk等) # ROM就比如lineage、arrow等，编译twrp就直接写twrp，twrp-9分支要写onmi</code><br />
我们把这样的结构称为骨架树(skeleton tree)。<br />
<br />
接下来我们按照以上结构为自己的设备写一份 Recovery device tree。<br />
<br />
在终端使用<code>touch</code>命令创建必要的文件。<br />
<code>touch Android.mk AndroidProducts.mk BoardConfig.mk device.mk twrp_rubens.mk<br />
ls .</code><br />
不出意外的话会打印出以下信息<br />
<code>xiaolegun@xiaoleGundeMac-Pro ~/github/tmp/device/xiaomi/rubens touch Android.mk AndroidProducts.mk BoardConfig.mk device.mk twrp_rubens.mk<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/tmp/device/xiaomi/rubens ls .<br />
Android.mk BoardConfig.mk prebuilt twrp_rubens.mk<br />
AndroidProducts.mk device.mk recovery</code><br />
可以下一步了~<br />
<br />
==== 初始 Android.mk 文件 ====<br />
打开 Vscode 并打开设备树目录，你足够强也可以使用 nano、vim 编辑。<br />
<br />
选中 Android.mk 并按照自己的资料复制并更改以下内容<br />
<code>LOCAL_PATH := $(call my-dir)<br />
<br />
ifeq ($(TARGET_DEVICE),codename)<br />
include $(call all-subdir-makefiles,$(LOCAL_PATH))<br />
endif</code><br />
<br />
* <code>codename</code>是需要你修改的部分<br />
<br />
我修改后是这样的<br />
<code>LOCAL_PATH := $(call my-dir)<br />
<br />
ifeq ($(TARGET_DEVICE),rubens)<br />
include $(call all-subdir-makefiles,$(LOCAL_PATH))<br />
endif</code><br />
<br />
==== 初始 AndroidProducts.mk 文件 ====<br />
选中 AndroidProducts.mk 并按照自己的资料复制并更改以下内容<br />
<code>PRODUCT_MAKEFILES := \<br />
$(LOCAL_DIR)/<ROM>_<codename>.mk<br />
<br />
COMMON_LUNCH_CHOICES := \<br />
<ROM>_<codename>-eng</code><br />
我修改后是这样的<br />
<code>PRODUCT_MAKEFILES := \<br />
$(LOCAL_DIR)/twrp_rubens.mk<br />
<br />
COMMON_LUNCH_CHOICES := \<br />
twrp_rubens-eng</code><br />
<br />
==== 初始 BoardConfig.mk 文件 ====<br />
<blockquote>将之前准备的<code>ramdisk</code>文件夹用新窗口打开 1.找到目录下的 prop.default 或含 prop 字样的文件。以下注释类似 ro.*.*的就是从 prop 中获取的 2.解包 boot/recovery/vendor_boot 的 json<br />
<br />
例如 build/unzip_boot/boot.json</blockquote>选中 BoardConfig.mk 并按照自己的资料复制并更改以下内容<br />
<code>DEVICE_PATH := device/vendor/codename<br />
<br />
# Architecture<br />
TARGET_ARCH := arm64 # ro.bionic.arch<br />
TARGET_ARCH_VARIANT := armv8-a # 64位默认变体<br />
TARGET_CPU_ABI := arm64-v8a # ro.vendor.product.cpu.abilist64 (至少在小米设备上没有找到ro.product.cpu.abilist)<br />
TARGET_CPU_ABI2 := # 64位留空<br />
TARGET_CPU_VARIANT := generic # 默认一般都是通用<br />
TARGET_CPU_VARIANT_RUNTIME := cortex-a55 # ro.bionic.cpu_variant<br />
<br />
TARGET_2ND_ARCH := arm # ro.bionic.2nd_arch<br />
TARGET_2ND_ARCH_VARIANT := $(TARGET_ARCH_VARIANT)<br />
TARGET_2ND_CPU_ABI := armeabi-v7a # ro.vendor.product.cpu.abilist32第一个<br />
TARGET_2ND_CPU_ABI2 := armeabi # ro.vendor.product.cpu.abilist32第二个<br />
TARGET_2ND_CPU_VARIANT := $(TARGET_CPU_VARIANT)<br />
TARGET_2ND_CPU_VARIANT_RUNTIME := $(TARGET_CPU_VARIANT)<br />
<br />
# Assertation<br />
TARGET_OTA_ASSERT_DEVICE := rubens # codename<br />
<br />
# Bootloader<br />
TARGET_BOOTLOADER_BOARD_NAME := rubens # ro.product.board<br />
TARGET_NO_BOOTLOADER := true<br />
TARGET_USES_UEFI := true<br />
<br />
# Build Rule<br />
ALLOW_MISSING_DEPENDENCIES := true # 为了recovery不健全的依赖<br />
<br />
# Kernel - 注释会说明在boot/recovery/vendor_boot.json中对应的变量<br />
BOARD_BOOTIMG_HEADER_VERSION := 4 # headerVersion<br />
BOARD_KERNEL_BASE := 0x3fff8000 # (kernelLoadAddr - 32KB) qcom设备base为0，且没有偏移(offset)<br />
BOARD_KERNEL_CMDLINE := bootopt=64S3,32N2,64N2 # cmdline<br />
BOARD_KERNEL_PAGESIZE := 4096 # pageSize<br />
BOARD_RAMDISK_OFFSET := 0x26f08000 # (ramdisk,loadAddr - BOARD_KERNEL_BASE)<br />
BOARD_KERNEL_TAGS_OFFSET := 0x07c88000 # (tagsLoadAddr - BOARD_KERNEL_BASE)<br />
BOARD_MKBOOTIMG_ARGS += --header_version $(BOARD_BOOTIMG_HEADER_VERSION)<br />
BOARD_MKBOOTIMG_ARGS += --ramdisk_offset $(BOARD_RAMDISK_OFFSET)<br />
BOARD_MKBOOTIMG_ARGS += --tags_offset $(BOARD_KERNEL_TAGS_OFFSET)<br />
<br />
# Kernel - prebuilt<br />
TARGET_PREBUILT_KERNEL := $(DEVICE_PATH)/prebuilt/kernel # 预编译内核相对于android源码根目录的相对路径，vendor_boot机型不需要<br />
TARGET_PREBUILT_DTB := $(DEVICE_PATH)/prebuilt/dtb.img # 同上<br />
BOARD_MKBOOTIMG_ARGS += --dtb $(TARGET_PREBUILT_DTB)<br />
<br />
# Partitions<br />
BOARD_FLASH_BLOCK_SIZE := 262144 # (BOARD_KERNEL_PAGESIZE * 64)<br />
BOARD_BOOTIMAGE_PARTITION_SIZE := 67108864 # boot/recovery/vendor_boot镜像的字节大小需原厂或手机完整提取出来的，不定义会报错<br />
BOARD_RECOVERYIMAGE_PARTITION_SIZE := 67108864 # 同上<br />
BOARD_VENDOR_ROOTIMAGE_PARTITION_SIZE := 67108864 # 同上<br />
BOARD_SYSTEMIMAGE_PARTITION_TYPE := ext4 # 分区类型，查看ramdisk中fstab定义的类型<br />
BOARD_USERDATAIMAGE_FILE_SYSTEM_TYPE := ext4<br />
BOARD_VENDORIMAGE_FILE_SYSTEM_TYPE := ext4<br />
TARGET_COPY_OUT_VENDOR := vendor # 定义vendor目录，例如copy专有blobs要用<br />
BOARD_SUPER_PARTITION_SIZE := 9126805504 # 可以通过blockdev --getsize64 /dev/block/bootdevice/by-name/super获取，需root，如果无法root可以直接使用这个值，不影响twrp启动，可以后续修正<br />
BOARD_SUPER_PARTITION_GROUPS := xiaomi_dynamic_partitions # xiaomi根据你获取资料的vendor替换，是一个动态分区组<br />
BOARD_XIAOMI_DYNAMIC_PARTITIONS_PARTITION_LIST := system vendor product system_ext odm vendor_dlkm odm_dlkm # 根据fstab内的定义，一般flag包含logical都属于动态分区组的一部分<br />
BOARD_XIAOMI_DYNAMIC_PARTITIONS_SIZE := 9122611200 # (BOARD_SUPER_PARTITION_SIZE - 4MB)<br />
<br />
# Platform<br />
TARGET_BOARD_PLATFORM := mt6895 # ro.board.platform<br />
<br />
# Recovery - 基本通用的不影响启动<br />
BOARD_HAS_LARGE_FILESYSTEM := true<br />
TARGET_RECOVERY_PIXEL_FORMAT := RGBX_8888<br />
TARGET_USERIMAGES_USE_EXT4 := true<br />
TARGET_USERIMAGES_USE_F2FS := true<br />
<br />
# Treble<br />
BOARD_VNDK_VERSION := current # 声明VNDK版本<br />
<br />
# Vendor_boot recovery ramdisk<br />
BOARD_MOVE_RECOVERY_RESOURCES_TO_VENDOR_BOOT := true # 将recovery文件复制到vendor_boot<br />
<br />
# Boot recovery ramdisk<br />
#BOARD_USES_RECOVERY_AS_BOOT := true recovery ramdisk合并在boot中启用<br />
<br />
# Verified Boot<br />
BOARD_AVB_ENABLE := true<br />
BOARD_AVB_MAKE_VBMETA_IMAGE_ARGS += --flags 3<br />
<br />
# TWRP Configurations<br />
TW_DEFAULT_LANGUAGE := zh_CN # 默认为中文<br />
TW_EXTRA_LANGUAGES := true # 额外的语言<br />
TW_THEME := portrait_hdpi # 主题<br />
TW_INCLUDE_FASTBOOTD := true # 包括fastbootd，为动态分区<br />
<br />
# 其它flag还有很多，可以在https://xdaforums.com/t/twrp-flags-for-boardconfig-mk.3333970 查找，<br />
# 这篇文章也很老了，但我并不推荐twrp，所以flag我也不是很了解，多翻翻github:)<br />
<br />
# Debug<br />
TARGET_USES_LOGD := true # 调试flag<br />
TWRP_INCLUDE_LOGCAT := true</code><br />
无注释版<br />
<code>DEVICE_PATH := device/vendor/codename<br />
<br />
# Architecture<br />
TARGET_ARCH := arm64<br />
TARGET_ARCH_VARIANT := armv8-a<br />
TARGET_CPU_ABI := arm64-v8a<br />
TARGET_CPU_ABI2 :=<br />
TARGET_CPU_VARIANT := generic<br />
TARGET_CPU_VARIANT_RUNTIME := cortex-a55<br />
<br />
TARGET_2ND_ARCH := arm<br />
TARGET_2ND_ARCH_VARIANT := $(TARGET_ARCH_VARIANT)<br />
TARGET_2ND_CPU_ABI := armeabi-v7a<br />
TARGET_2ND_CPU_ABI2 := armeabi<br />
TARGET_2ND_CPU_VARIANT := $(TARGET_CPU_VARIANT)<br />
TARGET_2ND_CPU_VARIANT_RUNTIME := $(TARGET_CPU_VARIANT)<br />
<br />
# Assertation<br />
TARGET_OTA_ASSERT_DEVICE := rubens<br />
<br />
# Bootloader<br />
TARGET_BOOTLOADER_BOARD_NAME := rubens<br />
TARGET_NO_BOOTLOADER := true<br />
TARGET_USES_UEFI := true<br />
<br />
# Build Rule<br />
ALLOW_MISSING_DEPENDENCIES := true<br />
<br />
# Kernel<br />
BOARD_BOOT_HEADER_VERSION := 4<br />
BOARD_KERNEL_BASE := 0x3fff8000<br />
BOARD_KERNEL_CMDLINE := bootopt=64S3,32N2,64N2<br />
BOARD_KERNEL_PAGESIZE := 4096<br />
BOARD_RAMDISK_OFFSET := 0x26f08000<br />
BOARD_KERNEL_TAGS_OFFSET := 0x07c88000<br />
BOARD_MKBOOTIMG_ARGS += --header_version $(BOARD_BOOT_HEADER_VERSION)<br />
BOARD_MKBOOTIMG_ARGS += --ramdisk_offset $(BOARD_RAMDISK_OFFSET)<br />
BOARD_MKBOOTIMG_ARGS += --tags_offset $(BOARD_KERNEL_TAGS_OFFSET)<br />
BOARD_KERNEL_IMAGE_NAME := Image<br />
<br />
# Kernel - prebuilt<br />
TARGET_PREBUILT_DTB := $(DEVICE_PATH)/prebuilt/dtb.img<br />
BOARD_MKBOOTIMG_ARGS += --dtb $(TARGET_PREBUILT_DTB)<br />
<br />
# Partitions<br />
BOARD_FLASH_BLOCK_SIZE := 262144<br />
BOARD_BOOTIMAGE_PARTITION_SIZE := 67108864<br />
BOARD_RECOVERYIMAGE_PARTITION_SIZE := 67108864<br />
BOARD_VENDOR_ROOTIMAGE_PARTITION_SIZE := 67108864<br />
BOARD_SYSTEMIMAGE_PARTITION_TYPE := ext4<br />
BOARD_USERDATAIMAGE_FILE_SYSTEM_TYPE := ext4<br />
BOARD_VENDORIMAGE_FILE_SYSTEM_TYPE := ext4<br />
TARGET_COPY_OUT_VENDOR := vendor<br />
BOARD_SUPER_PARTITION_SIZE := 9126805504<br />
BOARD_SUPER_PARTITION_GROUPS := xiaomi_dynamic_partitions<br />
BOARD_XIAOMI_DYNAMIC_PARTITIONS_PARTITION_LIST := system vendor product system_ext odm vendor_dlkm odm_dlkm<br />
BOARD_XIAOMI_DYNAMIC_PARTITIONS_SIZE := 9122611200<br />
<br />
# Platform<br />
TARGET_BOARD_PLATFORM := mt6895<br />
<br />
# Recovery<br />
BOARD_HAS_LARGE_FILESYSTEM := true<br />
TARGET_RECOVERY_PIXEL_FORMAT := RGBX_8888<br />
TARGET_USERIMAGES_USE_EXT4 := true<br />
TARGET_USERIMAGES_USE_F2FS := true<br />
<br />
# Treble<br />
BOARD_VNDK_VERSION := current<br />
<br />
# Vendor_boot recovery ramdisk<br />
BOARD_MOVE_RECOVERY_RESOURCES_TO_VENDOR_BOOT := true<br />
<br />
# Boot recovery ramdisk<br />
#BOARD_USES_RECOVERY_AS_BOOT := true<br />
<br />
# Verified Boot<br />
BOARD_AVB_ENABLE := true<br />
BOARD_AVB_MAKE_VBMETA_IMAGE_ARGS += --flags 3<br />
<br />
# TWRP Configurations<br />
TW_DEFAULT_LANGUAGE := zh_CN<br />
TW_EXTRA_LANGUAGES := true<br />
TW_THEME := portrait_hdpi<br />
TW_INCLUDE_FASTBOOTD := true<br />
<br />
# Debug<br />
TARGET_USES_LOGD := true<br />
TWRP_INCLUDE_LOGCAT := true</code><br />
这块写了好久我也不确定对不对，请各位指正，尤其是 Kernel 部分。<br />
<br />
==== 初始 device.mk 文件 ====<br />
<br />
* 准备好 prop.default<br />
<br />
选中 AndroidProducts.mk 并按照自己的资料复制并更改以下内容<br />
<code>DEVICE_PATH := device/xiaomi/rubens<br />
<br />
# API<br />
PRODUCT_SHIPPING_API_LEVEL := 31 # ro.board.first_api_level<br />
<br />
# A/B<br />
AB_OTA_UPDATER := true # 启用A/B无缝更新<br />
AB_OTA_PARTITIONS += \ # 定义A/B分区，参考fstab<br />
boot \<br />
dtbo \<br />
system \<br />
product \<br />
vendor \<br />
odm \<br />
odm_dlkm \<br />
vbmeta \<br />
vendor_boot \<br />
vendor_dlkm \<br />
vbmeta_system \<br />
vbmeta_vendor<br />
<br />
PRODUCT_PACKAGES += \<br />
update_engine \<br />
update_engine_sideload \<br />
update_verifier \<br />
checkpoint_gc<br />
<br />
AB_OTA_POSTINSTALL_CONFIG += \<br />
RUN_POSTINSTALL_system=true \<br />
POSTINSTALL_PATH_system=system/bin/mtk_plpath_utils \<br />
FILESYSTEM_TYPE_system=ext4 \<br />
POSTINSTALL_OPTIONAL_system=true<br />
<br />
AB_OTA_POSTINSTALL_CONFIG += \<br />
RUN_POSTINSTALL_vendor=true \<br />
POSTINSTALL_PATH_vendor=bin/checkpoint_gc \<br />
FILESYSTEM_TYPE_vendor=ext4 \<br />
POSTINSTALL_OPTIONAL_vendor=true<br />
<br />
# Dynamic<br />
PRODUCT_USE_DYNAMIC_PARTITIONS := true # 动态分区<br />
<br />
# Soong namespaces<br />
PRODUCT_SOONG_NAMESPACES += $(DEVICE_PATH) # 命名空间</code><br />
<br />
* A/B 无缝更新部分高通和联发科不一样，联发科设备可以照抄，注意 system/bin/mtk_plpath_utils 就好。高通参考[https://github.com/sekaiacg/android_device_xiaomi_venus_TWRP/tree/android-13 venus twrp tree]，并且高通的[https://git.codelinaro.org/clo/la/platform/hardware/qcom/bootctrl bootctrl]和[https://git.codelinaro.org/clo/la/platform/vendor/qcom-opensource/recovery-ext gpt-utils]可以从 CLO 拿。<br />
<br />
无注释版<br />
<code>PRODUCT_SHIPPING_API_LEVEL := 31<br />
<br />
# A/B<br />
AB_OTA_UPDATER := true<br />
AB_OTA_PARTITIONS += \<br />
boot \<br />
dtbo \<br />
system \<br />
product \<br />
vendor \<br />
odm \<br />
odm_dlkm \<br />
vbmeta \<br />
vendor_boot \<br />
vendor_dlkm \<br />
vbmeta_system \<br />
vbmeta_vendor<br />
<br />
PRODUCT_PACKAGES += \<br />
update_engine \<br />
update_engine_sideload \<br />
update_verifier \<br />
checkpoint_gc<br />
<br />
AB_OTA_POSTINSTALL_CONFIG += \<br />
RUN_POSTINSTALL_system=true \<br />
POSTINSTALL_PATH_system=system/bin/mtk_plpath_utils \<br />
FILESYSTEM_TYPE_system=ext4 \<br />
POSTINSTALL_OPTIONAL_system=true<br />
<br />
AB_OTA_POSTINSTALL_CONFIG += \<br />
RUN_POSTINSTALL_vendor=true \<br />
POSTINSTALL_PATH_vendor=bin/checkpoint_gc \<br />
FILESYSTEM_TYPE_vendor=ext4 \<br />
POSTINSTALL_OPTIONAL_vendor=true<br />
<br />
# Dynamic<br />
PRODUCT_USE_DYNAMIC_PARTITIONS := true<br />
<br />
# Soong namespaces<br />
PRODUCT_SOONG_NAMESPACES += $(DEVICE_PATH)</code><br />
<br />
==== 初始 twrp_rubens.mk 文件 ====<br />
选中 AndroidProducts.mk 并按照自己的资料复制并更改以下内容<br />
<code># Inherit from common AOSP config<br />
$(call inherit-product, $(SRC_TARGET_DIR)/product/base.mk)<br />
$(call inherit-product, $(SRC_TARGET_DIR)/product/core_64_bit_only.mk)<br />
$(call inherit-product, $(SRC_TARGET_DIR)/product/virtual_ab_ota/launch_with_vendor_ramdisk.mk) # vab加载到vendor boot里使用<br />
<br />
# Inherit from TWRP product configuration<br />
$(call inherit-product, vendor/twrp/config/common.mk) # twrp-9分支改为onmi<br />
<br />
# Device specific configs<br />
$(call inherit-product, device/xiaomi/rubens/device.mk)<br />
<br />
# Device identifier<br />
PRODUCT_DEVICE := rubens # 设备型号<br />
PRODUCT_NAME := twrp_rubens # 设备名称<br />
PRODUCT_BRAND := Redmi # 自定义品牌，如果有<br />
PRODUCT_MODEL := 22041211AC # 产品最终用户可见名称<br />
PRODUCT_MANUFACTURER := Xiaomi # 制造商<br />
<br />
PRODUCT_PROPERTY_OVERRIDES += ro.twrp.vendor_boot=true # 对twrp启动vendor_boot支持</code><br />
无注释版<br />
<code># Inherit from common AOSP config<br />
$(call inherit-product, $(SRC_TARGET_DIR)/product/base.mk)<br />
$(call inherit-product, $(SRC_TARGET_DIR)/product/core_64_bit_only.mk)<br />
$(call inherit-product, $(SRC_TARGET_DIR)/product/virtual_ab_ota/launch_with_vendor_ramdisk.mk) # vab加载到vendor boot里使用<br />
<br />
# Inherit from TWRP product configuration<br />
$(call inherit-product, vendor/twrp/config/common.mk)<br />
<br />
# Device specific configs<br />
$(call inherit-product, device/xiaomi/rubens/device.mk)<br />
<br />
# Device identifier<br />
PRODUCT_DEVICE := rubens<br />
PRODUCT_NAME := twrp_rubens<br />
PRODUCT_BRAND := Redmi<br />
PRODUCT_MODEL := 22041211AC<br />
PRODUCT_MANUFACTURER := Xiaomi<br />
<br />
PRODUCT_PROPERTY_OVERRIDES += ro.twrp.vendor_boot=true</code><br />
<br />
==== 初始 recovery 目录 ====<br />
<blockquote>拿出我们好久之前准备的 ramdisk 叭</blockquote>通过<code>tree</code>命令我们可以查看 ramdisk 的树状图，可以很清晰的查看包含的文件<br />
<code>├── acct<br />
├── apex<br />
├── bin -> /system/bin<br />
├── bugreports -> /data/user_de/0/com.android.shell/files/bugreports<br />
├── config<br />
├── d -> /sys/kernel/debug<br />
├── data<br />
├── data_mirror<br />
├── debug_ramdisk<br />
├── default.prop -> prop.default<br />
├── dev<br />
├── etc -> /system/etc<br />
├── first_stage_ramdisk<br />
│ ├── fstab.emmc<br />
│ ├── fstab.mt6895<br />
│ └── system<br />
│ ├── bin<br />
│ │ ├── e2fsck<br />
│ │ ├── linker64<br />
│ │ ├── linker_asan64 -> linker64<br />
│ │ └── snapuserd<br />
│ └── lib64<br />
│ ├── ld-android.so<br />
│ ├── libbase.so<br />
│ ├── libc++.so<br />
│ ├── libc.so<br />
│ ├── libdl.so<br />
│ ├── libext2_blkid.so<br />
│ ├── libext2_com_err.so<br />
│ ├── libext2_e2p.so<br />
│ ├── libext2_quota.so<br />
│ ├── libext2_uuid.so<br />
│ ├── libext2fs.so<br />
│ ├── liblog.so<br />
│ ├── libm.so<br />
│ ├── libsparse.so<br />
│ └── libz.so<br />
├── init -> /system/bin/init<br />
├── init.recovery.hardware.rc<br />
├── init.recovery.mt6895.rc<br />
└── 等等等等...省略大概1000个文件吧</code><br />
<blockquote>因为避免教程时效性，我们尽可能选取 prebuilt 的办法，如 boot 和 mtk_plpath_utils 都采用预编译。</blockquote>里面有很多文件是没用的，整理一下，对我们有用的只有这些<br />
<code>.<br />
├── first_stage_ramdisk<br />
│ ├── fstab.emmc<br />
│ └── fstab.mt6895<br />
├── init.recovery.mt6895.rc<br />
├── lib<br />
│ └── modules<br />
│ ├── 8250_mtk.ko<br />
│ ├── adapter_class.ko<br />
│ ├── adsp.ko<br />
│ ├── aee_aed.ko<br />
│ ├── aee_hangdet.ko<br />
│ ├── aee_rs.ko<br />
│ ├── blocktag.ko<br />
│ ├── bootprof.ko<br />
│ ├── bq28z610.ko<br />
│ ├── cache-parity.ko<br />
│ ├── cfg80211.ko<br />
│ ├── charger_class.ko<br />
│ └── 省略一百多个模块，这个目录里的东西全要<br />
└── system<br />
├── bin<br />
│ └── mtk_plpath_utils<br />
├── etc<br />
│ ├── init<br />
│ │ │── mtk-plpath-utils.rc<br />
│ │ └──hw<br />
│ │ └──init.rc<br />
│ ├── recovery.fstab<br />
│ ├── security<br />
│ │ └── otacerts.zip<br />
│ └── ueventd.rc<br />
└── lib64<br />
└── hw<br />
└── android.hardware.boot@1.0-impl-1.2-mtkimpl.so</code><br />
将它们按照以下操作复制<br />
<br />
* first_stage_ramdisk --> recovery/root/first_stage_ramdisk<br />
* init.recovery.mt6895.rc --> recovery/root/init.recovery.mt6895.rc<br />
* lib --> recovery/root/lib<br />
* system --> recovery/root/system (security 和 hw 文件夹里的内容作为备用，不要复制进去) 得到以下目录结构<br />
<br />
<code>.<br />
├── Android.mk<br />
├── AndroidProducts.mk<br />
├── BoardConfig.mk<br />
├── device.mk<br />
├── prebuilt<br />
├── recovery<br />
│ └── root<br />
│ ├── first_stage_ramdisk<br />
│ │ ├── fstab.emmc<br />
│ │ └── fstab.mt6895<br />
│ ├── init.recovery.mt6895.rc<br />
│ ├── lib<br />
│ │ └── modules<br />
│ │ ├── 8250_mtk.ko<br />
│ │ ├── adapter_class.ko<br />
│ │ ├── adsp.ko<br />
│ │ ├── aee_aed.ko<br />
│ │ ├── aee_hangdet.ko<br />
│ │ ├── aee_rs.ko<br />
│ │ ├── blocktag.ko<br />
│ │ └── 省略....<br />
│ └── system<br />
│ ├── bin<br />
│ │ └── mtk_plpath_utils<br />
│ ├── etc<br />
│ │ ├── recovery.fstab<br />
│ │ └── ueventd.rc<br />
│ └── lib64<br />
│ └── hw<br />
│ └── android.hardware.boot@1.0-impl-1.2-mtkimpl.so<br />
└── twrp_rubens.mk</code><br />
打开 init.recovery.mt6895.rc 添加<br />
<code>on boot<br />
start health-hal-2-1<br />
<br />
on post-fs<br />
start boot-hal-1-2</code><br />
例如<br />
<code>on post-fs<br />
start boot-hal-1-2<br />
<br />
on init<br />
setprop sys.usb.configfs 1<br />
setprop sys.usb.controller "11201000.usb0"<br />
setprop sys.usb.ffs.aio_compat 1<br />
<br />
on fs && property:ro.debuggable=0<br />
# distinguish USB shoulde connect or not, i.e. CDP vs SDP<br />
# set charging free due to it wait for USB activation<br />
<br />
on boot<br />
start health-hal-2-1<br />
exec u:r:update_engine:s0 root root -- /system/bin/mtk_plpath_utils</code><br />
<br />
接下来可以开始编译咯~~<br />
<br />
==== 编译 ====<br />
<blockquote>编译前请检查注释是否全部删除</blockquote>twrp 源码根目录执行<br />
<code>. build/envsetup.sh<br />
lunch twrp_codename-eng # twrp-9为onmi<br />
mka vendorbootimg/bootimage/recoveryimage</code><br />
不出意外的话一路绿灯，如果有报错的话请发邮箱至 1592501605@qq.com 咨询我<br />
<br />
产物在 <code>out/target/product/codename/vendor_boot.img\boot.img\recovery.img</code><br />
<br />
手机重启到 fastboot 模式，使用 fastboot flash 刷写，例如<br />
<code>fastboot flash vendor_boot /Users/xiaolegun/Downloads/vendor_boot.img</code><br />
则输出<br />
<code>ERROR: could not clear input pipe; result e0005000, ignoring...<br />
ERROR: could not clear output pipe; result e0005000, ignoring....<br />
Sending 'vendor_boot_a' (65536 KB) OKAY [ 1.396s]<br />
Writing 'vendor_boot_a' OKAY [ 0.167s]<br />
Finished. Total time: 1.625s</code><br />
就可以重启按电源加音量上尝试了，我自己是一次点亮，但有 bug。<br />
<br />
==== 修 BUG ====<br />
<br />
===== 修复 USB =====<br />
我看到 twrp 控制台有很多报错，第一步肯定是先获取日志，使用<code>logcat</code>命令获取，在此之前先使用<code>adb devices</code>检测一下设备 usb 是否工作正常。<br />
<code>xiaolegun@xiaoleGundeMac-Pro ~ adb devices ✔ 10208 10:05:31<br />
* daemon not running; starting now at tcp:5037<br />
* daemon started successfully<br />
List of devices attached</code><br />
可以看到<code>adb</code>没有检测到设备，原因一般是 usb 的配置不对，但 usb 是好的。这时可以尝试关闭 mtp，再开启，如果电脑有反应，那么就可以继续下一步了。<br />
<br />
在设备树中的 recovery/root，创建 init.recovery.usb.rc 的文件<br />
<code>touch recovery/root/init.recovery.usb.rc</code><br />
并导入以下内容<br />
<code>on property:sys.usb.config=mtp,adb<br />
start adbd<br />
<br />
on property:sys.usb.ffs.ready=1 && property:sys.usb.config=mtp,adb<br />
write /config/usb_gadget/g1/configs/b.1/strings/0x409/configuration "mtp_adb"<br />
rm /config/usb_gadget/g1/configs/b.1/f1<br />
rm /config/usb_gadget/g1/configs/b.1/f2<br />
rm /config/usb_gadget/g1/configs/b.1/f3<br />
rm /config/usb_gadget/g1/configs/b.1/f4<br />
rm /config/usb_gadget/g1/configs/b.1/f5<br />
write /config/usb_gadget/g1/idVendor 0x18d1<br />
write /config/usb_gadget/g1/idProduct 0x2d08<br />
symlink /config/usb_gadget/g1/functions/mtp.gs0 /config/usb_gadget/g1/configs/b.1/f1<br />
symlink /config/usb_gadget/g1/functions/ffs.adb /config/usb_gadget/g1/configs/b.1/f2<br />
write /config/usb_gadget/g1/UDC ${sys.usb.controller}<br />
setprop sys.usb.state ${sys.usb.config}</code><br />
这是我从我维护的 MI 6X 的 device tree 拿过来的，可以在联发科设备上正常工作。这段 shell 的大致意思就是在 usb 配置节点写入 mtp 和 adb 同时工作的字符串，这样 adb 就能顺利工作了。<br />
<br />
此外打开原厂 init.rc 修正一下 usb 设备的 id<br />
<code># MIUI ADD: START<br />
import /init.recovery.hardware.rc<br />
import /miui.factoryreset.rc<br />
# END<br />
import /init.recovery.${ro.hardware}.rc<br />
<br />
########### 省略一万字<br />
<br />
# MIUI ADD: START<br />
on property:sys.usb.config=mtp,adb && property:sys.usb.configfs=0<br />
write /sys/class/android_usb/android0/enable 0<br />
write /sys/class/android_usb/android0/idVendor 2717<br />
write /sys/class/android_usb/android0/idProduct 904D<br />
write /sys/class/android_usb/android0/functions mtp,adb<br />
write /sys/class/android_usb/android0/enable 1<br />
setprop sys.usb.state ${sys.usb.config}<br />
# END</code><br />
将<code>/sys/class/android_usb/android0/idVendor</code>和<code>write /sys/class/android_usb/android0/idProduct</code>后面的 id 分别替换到<code>/config/usb_gadget/g1/idVendor</code>和<code>/config/usb_gadget/g1/idProduct</code>处理完就是这样的。<br />
<code>on property:sys.usb.config=mtp,adb<br />
start adbd<br />
<br />
on property:sys.usb.ffs.ready=1 && property:sys.usb.config=mtp,adb<br />
write /config/usb_gadget/g1/configs/b.1/strings/0x409/configuration "mtp_adb"<br />
rm /config/usb_gadget/g1/configs/b.1/f1<br />
rm /config/usb_gadget/g1/configs/b.1/f2<br />
rm /config/usb_gadget/g1/configs/b.1/f3<br />
rm /config/usb_gadget/g1/configs/b.1/f4<br />
rm /config/usb_gadget/g1/configs/b.1/f5<br />
write /config/usb_gadget/g1/idVendor 0x2717<br />
write /config/usb_gadget/g1/idProduct 0x904D<br />
symlink /config/usb_gadget/g1/functions/mtp.gs0 /config/usb_gadget/g1/configs/b.1/f1<br />
symlink /config/usb_gadget/g1/functions/ffs.adb /config/usb_gadget/g1/configs/b.1/f2<br />
write /config/usb_gadget/g1/UDC ${sys.usb.controller}<br />
setprop sys.usb.state ${sys.usb.config}</code><br />
接下来开机之后 adb 和 mtp 就能同时工作了。<br />
<br />
===== 修复 Resetprop =====<br />
接下来就可以修复其它 bug 了，我看到控制台有一堆红色的报错:<br />
<code>E:Unknown File System:'/mi_ext'<br />
E:Unable to override 'external_storage.projid.enabled' due to missing libresetprop<br />
挂载“/data”失败(Invalid argument)</code><br />
这三个报错中第二个最好修，第一个次之，第三个与解密有关，放在另一个大章节讲。<br />
<br />
第二个报错只需要在 BoardConfig.mk 中添加<br />
<code># Tool<br />
TW_INCLUDE_RESETPROP := true<br />
TW_INCLUDE_LIBRESETPROP := true</code><br />
不用编译测试直接秒杀<br />
<br />
===== 修复挂载 =====<br />
<code>E:Unknown File System:'/mi_ext'</code><br />
我们打开 recovery/root/system/etc 中的 recovery.fstab，发现里面有很多空格，我们先将它格式化一下，有实力的可以把后面的 flag 也对齐整理好。<br />
<br />
我比较没实力，简单格式化了一下，是这样的<br />
<code># 1 "vendor/mediatek/proprietary/hardware/fstab/mt6895/fstab.in.mt6895"<br />
# 1 "<built-in>" 1<br />
# 1 "<built-in>" 3<br />
# 341 "<built-in>" 3<br />
# 1 "<command line>" 1<br />
# 1 "<built-in>" 2<br />
# 1 "vendor/mediatek/proprietary/hardware/fstab/mt6895/fstab.in.mt6895" 2<br />
# 173 "vendor/mediatek/proprietary/hardware/fstab/mt6895/fstab.in.mt6895"<br />
system /system erofs ro wait,slotselect,avb=vbmeta_system,logical,first_stage_mount,avb_keys=/avb/q-gsi.avbpubkey:/avb/r-gsi.avbpubkey:/avb/s-gsi.avbpubkey<br />
system /system ext4 ro wait,slotselect,avb=vbmeta_system,logical,first_stage_mount,avb_keys=/avb/q-gsi.avbpubkey:/avb/r-gsi.avbpubkey:/avb/s-gsi.avbpubkey<br />
vendor /vendor erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
vendor /vendor ext4 ro wait,slotselect,avb,logical,first_stage_mount<br />
product /product erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
product /product ext4 ro wait,slotselect,avb,logical,first_stage_mount<br />
mi_ext /mnt/vendor/mi_ext erofs ro wait,slotselect,avb=vbmeta,logical,first_stage_mount,nofail<br />
mi_ext /mnt/vendor/mi_ext ext4 ro wait,slotselect,avb=vbmeta,logical,first_stage_mount,nofail<br />
/mnt/vendor/mi_ext /mi_ext none ro,bind wait,nofail<br />
overlay /product/overlay overlay ro,lowerdir=/mnt/vendor/mi_ext/product/overlay/:/product/overlay check,nofail<br />
overlay /product/app overlay ro,lowerdir=/mnt/vendor/mi_ext/product/app/:/product/app check,nofail<br />
overlay /product/priv-app overlay ro,lowerdir=/mnt/vendor/mi_ext/product/priv-app/:/product/priv-app check,nofail<br />
overlay /product/lib overlay ro,lowerdir=/mnt/vendor/mi_ext/product/lib/:/product/lib check,nofail<br />
overlay /product/lib64 overlay ro,lowerdir=/mnt/vendor/mi_ext/product/lib64/:/product/lib64 check,nofail<br />
overlay /product/bin overlay ro,lowerdir=/mnt/vendor/mi_ext/product/bin/:/product/bin check,nofail<br />
overlay /product/framework overlay ro,lowerdir=/mnt/vendor/mi_ext/product/framework/:/product/framework check,nofail<br />
overlay /product/media overlay ro,lowerdir=/mnt/vendor/mi_ext/product/media/:/product/media check,nofail<br />
overlay /product/opcust overlay ro,lowerdir=/mnt/vendor/mi_ext/product/opcust/:/product/opcust check,nofail<br />
overlay /product/data-app overlay ro,lowerdir=/mnt/vendor/mi_ext/product/data-app/:/product/data-app check,nofail<br />
overlay /product/etc/sysconfig overlay ro,lowerdir=/mnt/vendor/mi_ext/product/etc/sysconfig/:/product/etc/sysconfig check,nofail<br />
overlay /product/etc/permissions overlay ro,lowerdir=/mnt/vendor/mi_ext/product/etc/permissions/:/product/etc/permissions check,nofail<br />
overlay /system/app overlay ro,lowerdir=/mnt/vendor/mi_ext/system/app/:/product/pangu/system/app/:/system/app check,nofail<br />
overlay /system/priv-app overlay ro,lowerdir=/mnt/vendor/mi_ext/system/priv-app/:/product/pangu/system/priv-app/:/system/priv-app check,nofail<br />
overlay /system/framework overlay ro,lowerdir=/product/pangu/system/framework/:/system/framework check,nofail<br />
overlay /system/etc/sysconfig overlay ro,lowerdir=/mnt/vendor/mi_ext/system/etc/sysconfig/:/system/etc/sysconfig check,nofail<br />
overlay /system/etc/permissions overlay ro,lowerdir=/mnt/vendor/mi_ext/system/etc/permissions/:/product/pangu/system/etc/permissions/:/system/etc/permissions check,nofail<br />
system_ext /system_ext erofs ro wait,slotselect,avb=vbmeta_system,logical,first_stage_mount,avb_keys=/avb/q-gsi.avbpubkey:/avb/r-gsi.avbpubkey:/avb/s-gsi.avbpubkey<br />
system_ext /system_ext ext4 ro wait,slotselect,avb=vbmeta_system,logical,first_stage_mount,avb_keys=/avb/q-gsi.avbpubkey:/avb/r-gsi.avbpubkey:/avb/s-gsi.avbpubkey<br />
odm /odm erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
odm /odm ext4 ro wait,slotselect,avb,logical,first_stage_mount<br />
vendor_dlkm /vendor_dlkm erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
odm_dlkm /odm_dlkm erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
/dev/block/by-name/metadata /metadata ext4 noatime,nosuid,nodev,discard wait,check,formattable,first_stage_mount<br />
/dev/block/by-name/userdata /data f2fs noatime,nosuid,nodev,discard,noflush_merge,fsync_mode=nobarrier,reserve_root=134217,resgid=1065,checkpoint_merge,gc_merge,inlinecrypt wait,check,formattable,quota,latemount,resize,reservedsize=128m,checkpoint=fs,fileencryption=aes-256-xts:aes-256-cts:v2+inlinecrypt_optimized,keydirectory=/metadata/vold/metadata_encryption,fsverity<br />
/dev/block/by-name/rescue /cache ext4 noatime,nosuid,nodev,noauto_da_alloc,discard wait,check,formattable<br />
/dev/block/by-name/protect1 /mnt/vendor/protect_f ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/dev/block/by-name/protect2 /mnt/vendor/protect_s ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/dev/block/by-name/nvdata /mnt/vendor/nvdata ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/dev/block/by-name/nvcfg /mnt/vendor/nvcfg ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/dev/block/by-name/persist /mnt/vendor/persist ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/devices/platform/soc/11240000.mmc* auto auto defaults voldmanaged=sdcard1:auto,encryptable=userdata<br />
/devices/platform/usb_xhci* auto vfat defaults voldmanaged=usbotg:auto<br />
/devices/platform/soc/11201000.usb0/11200000.xhci* auto vfat defaults voldmanaged=usbotg:auto<br />
/dev/block/by-name/frp /persistent emmc defaults defaults<br />
/dev/block/by-name/nvram /nvram emmc defaults defaults<br />
/dev/block/by-name/proinfo /proinfo emmc defaults defaults<br />
/dev/block/by-name/lk /bootloader emmc defaults defaults<br />
/dev/block/by-name/lk2 /bootloader2 emmc defaults defaults<br />
/dev/block/by-name/para /para emmc defaults defaults<br />
/dev/block/by-name/misc /misc emmc defaults defaults<br />
/dev/block/by-name/boot /boot emmc defaults first_stage_mount,nofail,slotselect<br />
/dev/block/by-name/vbmeta_vendor /vbmeta_vendor emmc defaults first_stage_mount,nofail,slotselect<br />
/dev/block/by-name/vbmeta_system /vbmeta_system emmc defaults first_stage_mount,nofail,slotselect,avb=vbmeta<br />
/dev/block/by-name/logo /logo emmc defaults defaults<br />
/dev/block/by-name/expdb /expdb emmc defaults defaults<br />
/dev/block/by-name/seccfg /seccfg emmc defaults defaults<br />
/dev/block/by-name/tee1 /tee1 emmc defaults defaults<br />
/dev/block/by-name/tee2 /tee2 emmc defaults defaults<br />
/dev/block/by-name/scp1 /scp1 emmc defaults defaults<br />
/dev/block/by-name/scp2 /scp2 emmc defaults defaults<br />
/dev/block/by-name/sspm_1 /sspm_1 emmc defaults defaults<br />
/dev/block/by-name/sspm_2 /sspm_2 emmc defaults defaults<br />
/dev/block/by-name/dpm_1 /dpm_1 emmc defaults defaults<br />
/dev/block/by-name/dpm_2 /dpm_2 emmc defaults defaults<br />
/dev/block/by-name/mcupm_1 /mcupm_1 emmc defaults defaults<br />
/dev/block/by-name/mcupm_2 /mcupm_2 emmc defaults defaults<br />
/dev/block/by-name/md1img /md1img emmc defaults defaults<br />
/dev/block/by-name/md1dsp /md1dsp emmc defaults defaults<br />
/dev/block/by-name/md1arm7 /md1arm7 emmc defaults defaults<br />
/dev/block/by-name/md3img /md3img emmc defaults defaults<br />
/dev/block/by-name/gz1 /gz1 emmc defaults defaults<br />
/dev/block/by-name/gz2 /gz2 emmc defaults defaults<br />
/dev/block/by-name/spmfw /spmfw emmc defaults defaults<br />
/dev/block/by-name/audio_dsp /audio_dsp emmc defaults defaults<br />
/dev/block/by-name/pi_img /pi_img emmc defaults defaults<br />
/dev/block/by-name/boot_para /boot_para emmc defaults defaults<br />
/dev/block/by-name/odmdtbo /odmdtbo emmc defaults defaults<br />
/dev/block/by-name/dtbo /dtbo emmc defaults defaults<br />
/dev/block/by-name/otp /otp emmc defaults defaults<br />
/dev/block/by-name/vbmeta /vbmeta emmc defaults defaults</code><br />
这里面有很多无用分区，我们在 twrp 中操作不到，但是我也是第一次适配 MTK 设备，所以不“瞎说”误人子弟了，先把 bug 修好。<br />
<br />
像 xiaomi 这样常见的挂载错误，我自己一般都是尝试把/mnt/vendor 使用 vscode 全部删除，让我们尝试一下。并且要把这一行删除，这行在我看来是重复定义（？而且也没指定分区格式。<br />
<code>/mnt/vendor/mi_ext /mi_ext none ro,bind wait,nofail</code><br />
整理完之后是这样的<br />
<code># 1 "vendor/mediatek/proprietary/hardware/fstab/mt6895/fstab.in.mt6895"<br />
# 1 "<built-in>" 1<br />
# 1 "<built-in>" 3<br />
# 341 "<built-in>" 3<br />
# 1 "<command line>" 1<br />
# 1 "<built-in>" 2<br />
# 1 "vendor/mediatek/proprietary/hardware/fstab/mt6895/fstab.in.mt6895" 2<br />
# 173 "vendor/mediatek/proprietary/hardware/fstab/mt6895/fstab.in.mt6895"<br />
system /system erofs ro wait,slotselect,avb=vbmeta_system,logical,first_stage_mount,avb_keys=/avb/q-gsi.avbpubkey:/avb/r-gsi.avbpubkey:/avb/s-gsi.avbpubkey<br />
system /system ext4 ro wait,slotselect,avb=vbmeta_system,logical,first_stage_mount,avb_keys=/avb/q-gsi.avbpubkey:/avb/r-gsi.avbpubkey:/avb/s-gsi.avbpubkey<br />
vendor /vendor erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
vendor /vendor ext4 ro wait,slotselect,avb,logical,first_stage_mount<br />
product /product erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
product /product ext4 ro wait,slotselect,avb,logical,first_stage_mount<br />
mi_ext /mi_ext erofs ro wait,slotselect,avb=vbmeta,logical,first_stage_mount,nofail<br />
mi_ext /mi_ext ext4 ro wait,slotselect,avb=vbmeta,logical,first_stage_mount,nofail<br />
overlay /product/overlay overlay ro,lowerdir=/mi_ext/product/overlay/:/product/overlay check,nofail<br />
overlay /product/app overlay ro,lowerdir=/mi_ext/product/app/:/product/app check,nofail<br />
overlay /product/priv-app overlay ro,lowerdir=/mi_ext/product/priv-app/:/product/priv-app check,nofail<br />
overlay /product/lib overlay ro,lowerdir=/mi_ext/product/lib/:/product/lib check,nofail<br />
overlay /product/lib64 overlay ro,lowerdir=/mi_ext/product/lib64/:/product/lib64 check,nofail<br />
overlay /product/bin overlay ro,lowerdir=/mi_ext/product/bin/:/product/bin check,nofail<br />
overlay /product/framework overlay ro,lowerdir=/mi_ext/product/framework/:/product/framework check,nofail<br />
overlay /product/media overlay ro,lowerdir=/mi_ext/product/media/:/product/media check,nofail<br />
overlay /product/opcust overlay ro,lowerdir=/mi_ext/product/opcust/:/product/opcust check,nofail<br />
overlay /product/data-app overlay ro,lowerdir=/mi_ext/product/data-app/:/product/data-app check,nofail<br />
overlay /product/etc/sysconfig overlay ro,lowerdir=/mi_ext/product/etc/sysconfig/:/product/etc/sysconfig check,nofail<br />
overlay /product/etc/permissions overlay ro,lowerdir=/mi_ext/product/etc/permissions/:/product/etc/permissions check,nofail<br />
overlay /system/app overlay ro,lowerdir=/mi_ext/system/app/:/product/pangu/system/app/:/system/app check,nofail<br />
overlay /system/priv-app overlay ro,lowerdir=/mi_ext/system/priv-app/:/product/pangu/system/priv-app/:/system/priv-app check,nofail<br />
overlay /system/framework overlay ro,lowerdir=/product/pangu/system/framework/:/system/framework check,nofail<br />
overlay /system/etc/sysconfig overlay ro,lowerdir=/mi_ext/system/etc/sysconfig/:/system/etc/sysconfig check,nofail<br />
overlay /system/etc/permissions overlay ro,lowerdir=/mi_ext/system/etc/permissions/:/product/pangu/system/etc/permissions/:/system/etc/permissions check,nofail<br />
system_ext /system_ext erofs ro wait,slotselect,avb=vbmeta_system,logical,first_stage_mount,avb_keys=/avb/q-gsi.avbpubkey:/avb/r-gsi.avbpubkey:/avb/s-gsi.avbpubkey<br />
system_ext /system_ext ext4 ro wait,slotselect,avb=vbmeta_system,logical,first_stage_mount,avb_keys=/avb/q-gsi.avbpubkey:/avb/r-gsi.avbpubkey:/avb/s-gsi.avbpubkey<br />
odm /odm erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
odm /odm ext4 ro wait,slotselect,avb,logical,first_stage_mount<br />
vendor_dlkm /vendor_dlkm erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
odm_dlkm /odm_dlkm erofs ro wait,slotselect,avb,logical,first_stage_mount<br />
/dev/block/by-name/metadata /metadata ext4 noatime,nosuid,nodev,discard wait,check,formattable,first_stage_mount<br />
/dev/block/by-name/userdata /data f2fs noatime,nosuid,nodev,discard,noflush_merge,fsync_mode=nobarrier,reserve_root=134217,resgid=1065,checkpoint_merge,gc_merge,inlinecrypt wait,check,formattable,quota,latemount,resize,reservedsize=128m,checkpoint=fs,fileencryption=aes-256-xts:aes-256-cts:v2+inlinecrypt_optimized,keydirectory=/metadata/vold/metadata_encryption,fsverity<br />
/dev/block/by-name/rescue /cache ext4 noatime,nosuid,nodev,noauto_da_alloc,discard wait,check,formattable<br />
/dev/block/by-name/protect1 /protect_f ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/dev/block/by-name/protect2 /protect_s ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/dev/block/by-name/nvdata /nvdata ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/dev/block/by-name/nvcfg /nvcfg ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/dev/block/by-name/persist /persist ext4 noatime,nosuid,nodev,noauto_da_alloc,commit=1,nodelalloc wait,check,formattable<br />
/devices/platform/soc/11240000.mmc* auto auto defaults voldmanaged=sdcard1:auto,encryptable=userdata<br />
/devices/platform/usb_xhci* auto vfat defaults voldmanaged=usbotg:auto<br />
/devices/platform/soc/11201000.usb0/11200000.xhci* auto vfat defaults voldmanaged=usbotg:auto<br />
/dev/block/by-name/frp /persistent emmc defaults defaults<br />
/dev/block/by-name/nvram /nvram emmc defaults defaults<br />
/dev/block/by-name/proinfo /proinfo emmc defaults defaults<br />
/dev/block/by-name/lk /bootloader emmc defaults defaults<br />
/dev/block/by-name/lk2 /bootloader2 emmc defaults defaults<br />
/dev/block/by-name/para /para emmc defaults defaults<br />
/dev/block/by-name/misc /misc emmc defaults defaults<br />
/dev/block/by-name/boot /boot emmc defaults first_stage_mount,nofail,slotselect<br />
/dev/block/by-name/vbmeta_vendor /vbmeta_vendor emmc defaults first_stage_mount,nofail,slotselect<br />
/dev/block/by-name/vbmeta_system /vbmeta_system emmc defaults first_stage_mount,nofail,slotselect,avb=vbmeta<br />
/dev/block/by-name/logo /logo emmc defaults defaults<br />
/dev/block/by-name/expdb /expdb emmc defaults defaults<br />
/dev/block/by-name/seccfg /seccfg emmc defaults defaults<br />
/dev/block/by-name/tee1 /tee1 emmc defaults defaults<br />
/dev/block/by-name/tee2 /tee2 emmc defaults defaults<br />
/dev/block/by-name/scp1 /scp1 emmc defaults defaults<br />
/dev/block/by-name/scp2 /scp2 emmc defaults defaults<br />
/dev/block/by-name/sspm_1 /sspm_1 emmc defaults defaults<br />
/dev/block/by-name/sspm_2 /sspm_2 emmc defaults defaults<br />
/dev/block/by-name/dpm_1 /dpm_1 emmc defaults defaults<br />
/dev/block/by-name/dpm_2 /dpm_2 emmc defaults defaults<br />
/dev/block/by-name/mcupm_1 /mcupm_1 emmc defaults defaults<br />
/dev/block/by-name/mcupm_2 /mcupm_2 emmc defaults defaults<br />
/dev/block/by-name/md1img /md1img emmc defaults defaults<br />
/dev/block/by-name/md1dsp /md1dsp emmc defaults defaults<br />
/dev/block/by-name/md1arm7 /md1arm7 emmc defaults defaults<br />
/dev/block/by-name/md3img /md3img emmc defaults defaults<br />
/dev/block/by-name/gz1 /gz1 emmc defaults defaults<br />
/dev/block/by-name/gz2 /gz2 emmc defaults defaults<br />
/dev/block/by-name/spmfw /spmfw emmc defaults defaults<br />
/dev/block/by-name/audio_dsp /audio_dsp emmc defaults defaults<br />
/dev/block/by-name/pi_img /pi_img emmc defaults defaults<br />
/dev/block/by-name/boot_para /boot_para emmc defaults defaults<br />
/dev/block/by-name/odmdtbo /odmdtbo emmc defaults defaults<br />
/dev/block/by-name/dtbo /dtbo emmc defaults defaults<br />
/dev/block/by-name/otp /otp emmc defaults defaults<br />
/dev/block/by-name/vbmeta /vbmeta emmc defaults defaults</code><br />
让我们编译试一下，值得注意的是，twrp 每次更改最好删除 out 重新编译，不要使用如<code>make installclean</code>等命令，可能会开机黑屏或更改不生效。<br />
<br />
经过一分钟，编译好了，刷入，开机，启动！可以看见挂载成功被修好。<br />
<br />
===== 修复屏幕显示 =====<br />
可以看到我们现在屏幕的顶部的时间被摄像头挖孔挡住了。我们使用两个偏移 Flag 来修复它。<br />
<br />
在 BoardConfig.mk 中，加入以下 flag<br />
<code>TW_Y_OFFSET := 106 #导航栏向上<br />
TW_H_OFFSET := -106 #界面整体向下</code><br />
<br />
===== 修复振动 =====<br />
<blockquote>仅供参考，研究半天发现只有解密功能正常才能修振动，不然会冻屏！！！<br />
<br />
不一定正确，也不一定普遍，仅供指路</blockquote>老设备一般都是正常的，不需要额外处理，新设备使用 aidl hal 需要我们自己处理一下让 service 正常工作。<br />
<br />
挂载 vendor，使用 twrp 的文件管理，在 vendor/etc/vintf/manifest 找到含有 vibrator 字样的文件。打开之后检查是否类似这样的文段<br />
<code><manifest version="1.0" type="device"><br />
<hal format="aidl" override="true"><br />
<name>android.hardware.vibrator</name><br />
<fqname>IVibrator/vibratorfeature</fqname><br />
</hal><br />
</manifest></code><br />
那恭喜你，找对了，我的文件名是<br />
<br />
<code>vendor.xiaomi.hardware.vibratorfeature.service.xml</code><br />
<br />
将它使用<code>adb pull</code>放到电脑上自己方便的位置备用。<br />
<code>xiaolegun@xiaoleGundeMac-Pro ~/github/$/mjw adb pull /vendor/etc/vintf/manifest/vendor.xiaomi.hardware.vibratorfeature.service.xml .<br />
/vendor/etc/vintf/manifest/vendor.xiao...ipped. 0.2 MB/s (1718 bytes in 0.009s)</code><br />
不看扩展名，到 vendor/bin/hw/找到同名的 service 同样利用<code>adb pull</code>放电脑备用。比如我的叫<br />
<br />
<code>vendor.xiaomi.hardware.vibratorfeature.service</code><br />
<br />
然后到 vendor/etc/init/找到同名.rc 文件，拉到电脑上，在里面加一条。并在定义 service 的最下面加上<code>seclabel u:r:recovery:s0</code>可以被 recovery 使用。<br />
<code>on boot<br />
start service被定义的名字</code><br />
例如<br />
<code>on post-fs-data<br />
chown system system /sys/bus/i2c/drivers/aw8697_haptic/2-005a/f0_save<br />
chown system system /sys/bus/i2c/drivers/aw8697_haptic/2-005a/osc_save<br />
chown system system /sys/bus/i2c/drivers/aw8697_haptic/3-005a/osc_save<br />
# 省略一万字<br />
<br />
on boot<br />
start vibratorfeature-hal-service<br />
<br />
service vibratorfeature-hal-service /vendor/bin/hw/vendor.xiaomi.hardware.vibratorfeature.service<br />
class hal<br />
user system<br />
group system input<br />
onrestart restart vibratorfeature<br />
seclabel u:r:recovery:s0</code><br />
此外这种新设备在内核里还有振动模块需要加载，请到/vendor/modules/1.1/中寻找，例如我这台设备是<code>haptic.ko</code>，用 adb pull 拉取到电脑上，然后<br />
<br />
* haptic.ko --> recovery/root/vendor/modules/1.1<br />
<br />
至此所有必要的资料就准备好了。可能开机后仍然不工作，需要抓取 log 补缺失的 library，当然这是后话了。<br />
<br />
开干！<br />
<br />
在 BoardConfig.mk 中加入以下 flag<br />
<code>TW_SUPPORT_INPUT_AIDL_HAPTICS := true</code><br />
将备用文件按照以下操作复制<br />
<br />
* vendor.xiaomi.hardware.vibratorfeature.service.xml --> recovery/root/vendor/etc/vintf/manifest<br />
* vendor.xiaomi.hardware.vibratorfeature.service --> recovery/root/vendor/bin/hw<br />
* vendor.xiaomi.hardware.vibratorfeature.service.rc --> recovery/root/vendor/etc/init<br />
<br />
之后编译，刷入，开机，喜提冻屏......<br />
<br />
问题不大，使用<code>adb logcat</code>抓取日志<br />
<code>adb logcat > log.log</code><br />
打开 log，搜索<code>F linker</code>、<code>linker</code>、<code>library</code>、<code>beginning of crash</code>这几个关键词，我搜索第一个就出来了。<br />
<code>F linker : CANNOT LINK EXECUTABLE "/vendor/bin/hw/vendor.xiaomi.hardware.vibratorfeature.service": library "android.hardware.vibrator-V1-ndk_platform.so" not found: needed by main executable</code><br />
这段报错的意思就是<code>vendor.xiaomi.hardware.vibratorfeature.service</code>找不到<code>android.hardware.vibrator-V1-ndk_platform.so</code>这个库，所以无法正常工作。<br />
<br />
打开 BoardConfig.mk 加入以下 flag<br />
<code># Library<br />
TARGET_RECOVERY_DEVICE_MODULES += \<br />
android.hardware.vibrator-V1-ndk_platform.vendor<br />
<br />
TW_RECOVERY_ADDITIONAL_RELINK_LIBRARY_FILES += \<br />
$(TARGET_OUT_SHARED_LIBRARIES)/android.hardware.vibrator-V1-ndk_platform.so</code><br />
再次编译尝试<br />
<br />
开机之后依然冻屏，继续抓 log，查找<br />
<code>F linker : CANNOT LINK EXECUTABLE "/vendor/bin/hw/vendor.xiaomi.hardware.vibratorfeature.service": library "vendor.hardware.vibratorfeature.IVibratorExt-V1-ndk_platform.so" not found: needed by main executable</code><br />
<code>vendor.hardware.vibratorfeature</code>字样和我们之前导入的文件长得差不多，一般都是供应商专有文件，所以去设备提取，路径在 vendor/lib64 里，虽然设备冻屏了，但我们可以用<code>adb pull</code>直接拉取到电脑。就像这样。<br />
<code>xiaolegun@xiaoleGundeMac-Pro ~/github/$/mjw adb shell mount /vendor<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/$/mjw adb pull /vendor/lib64/vendor.hardware.vibratorfeature.IVibratorExt-V1-ndk_platform.so .<br />
/vendor/lib64/vendor.hardware.vibratorfeature.IVi...led, 0 skipped. 14.7 MB/s (33552 bytes in 0.002s</code><br />
将这个文件按照以下提示操作<br />
<br />
* vendor.hardware.vibratorfeature.IVibratorExt-V1-ndk_platform.so --> recovery/root/vendor/lib64<br />
<br />
继续编译测试<br />
<br />
还是冻屏，继续抓 log<br />
<code>F linker : CANNOT LINK EXECUTABLE "/vendor/bin/hw/vendor.xiaomi.hardware.vibratorfeature.service": library "libtinyalsa.so" not found: needed by main executable</code><br />
这个 library twrp 的源码中应该没有，去设备拿一个 prebuilt 吧<br />
<code>xiaolegun@xiaoleGundeMac-Pro ~/github/$/mjw adb shell mount /system_root<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/$/mjw adb pull /system_root/system/lib64/libtinyalsa.so .<br />
/system_root/system/lib64/libtinyalsa.so: 1 file ...led, 0 skipped. 13.6 MB/s (45032 bytes in 0.003s</code><br />
将这个文件按照以下提示操作<br />
<br />
* libtinyalsa.so --> recovery/root/system/lib64<br />
<br />
编译测试<br />
<br />
我艹了，还是冻屏，这次搜那几个关键词都搜不到了，搜<code>vibrator</code>看看这鬼东西报什么<br />
<code>E vendor.xiaomi.hardware.vibratorfeature.service: fail to load lib : /vendor/lib64/libaachaptics.so</code><br />
这次都直接给路径了，直接拿。<br />
<code>xiaolegun@xiaoleGundeMac-Pro ~/github/$/mjw adb shell mount /vendor<br />
xiaolegun@xiaoleGundeMac-Pro ~/github/$/mjw adb pull /vendor/lib64/libaachaptics.so .<br />
/vendor/lib64/libaachaptics.so: 1 file pulled, 0 skipped. 15.8 MB/s (56232 bytes in 0.003s)</code><br />
将这个文件按照以下提示操作<br />
<br />
* libaachaptics.so --> recovery/root/vendor/lib64<br />
<br />
至此应该没什么问题了，但是有个 flag 貌似要操作 data 内的东西，未解密会导致冻屏，所以等修完解密后再来修振动。<br />
<br />
==== 修复 CPU 温度 ====<br />
使用<code>adb shell</code> + <code>grep</code>命令在手机节点里搜索 type 关键词。<br />
<code>xiaolegun@xiaoleGundeMac-Pro ~ adb shell 'grep "cp_master" /sys/class/thermal/*/type'<br />
/sys/class/thermal/thermal_zone54/type:cp_master<br />
xiaolegun@xiaoleGundeMac-Pro ~ adb shell 'grep "cpu" /sys/class/thermal/*/type'<br />
/sys/class/thermal/thermal_zone1/type:cpu_little1<br />
/sys/class/thermal/thermal_zone10/type:cpu_bigbig1<br />
/sys/class/thermal/thermal_zone11/type:cpu_big6<br />
/sys/class/thermal/thermal_zone12/type:cpu_bigbig2<br />
/sys/class/thermal/thermal_zone2/type:cpu_little2<br />
/sys/class/thermal/thermal_zone3/type:cpu_little3<br />
/sys/class/thermal/thermal_zone4/type:cpu_little4<br />
/sys/class/thermal/thermal_zone5/type:cpu_big1<br />
/sys/class/thermal/thermal_zone6/type:cpu_big2<br />
/sys/class/thermal/thermal_zone7/type:cpu_big3<br />
/sys/class/thermal/thermal_zone8/type:cpu_big4<br />
/sys/class/thermal/thermal_zone9/type:cpu_big5</code><br />
我这里选用<code>cp_master</code>节点来读取温度。我的节点路径为<code>/sys/class/thermal/thermal_zone54</code>在后面添加 temp 来读取温度，你可以使用<code>cat</code>来检测节点是否可以正常读取温度<br />
<code>adb shell 'cat /sys/class/thermal/thermal_zone54/temp'</code><br />
如果返回如<br />
<code>28000</code><br />
这种类似的数值，那多半是没有问题的。<br />
<br />
我们在 BoardConfig.mk 中加入<br />
<code>TW_CUSTOM_CPU_TEMP_PATH := "/sys/class/thermal/thermal_zone54/temp"</code><br />
至此 cpu 温度就修复好了。<br />
<br />
== 后序 ==<br />
这是我玩 Android 两年内第一次写关于 Android 的文章，内容和措辞可能不是很准确，再加上开学焦虑，租房因租金和房源不顺利，写的很乱，请各位指正。<br />
<br />
此外有什么不懂得，多翻github，善用github搜索，多看看大佬们是怎么解决的。<br />
<br />
解密等有空补，先补作业。<br />
<br />
== 参考资料 ==<br />
[https://source.android.com/docs/setup/create/new-device?hl=zh-cn Google - 添加新设备]<br />
<br />
[https://source.android.com/docs/core/ota/ab?hl=zh-cn Google - A/B（无缝）系统更新]<br />
<br />
[https://blog.lynnrin.moe/posts/ROM-bringup-guide-prebuilt/#boardconfigmk Lynnrin - 快速上手 Android Custom ROM 适配 - Prebuilt Vendor]<br />
<br />
[https://source.android.com/docs/core/architecture/vintf?hl=zh-cn Google - 供应商接口对象]</div>
XiaoleGun
https://wiki.uotan.cn/index.php?title=%E9%A6%96%E9%A1%B5&diff=532
首页
2024-02-17T13:53:42Z
<p>XiaoleGun：fixup super empty</p>
<hr />
<div><br />
= 欢迎来到 <span style="display: inline-block; vertical-align: middle; padding-bottom: 11px;">[[文件:Uotan Wiki.png|120px]]</span> · 刷机百科 =<br />
<br />
'''我们致力于打造一个更适合国人使用、更贴近刷机本身的玩机知识站点'''<br />
<br />
'''本站现有{{NUMBEROFUSERS}}名用户，{{NUMBEROFEDITS}}次编辑，{{NUMBEROFARTICLES}}篇条目，{{NUMBEROFACTIVEUSERS}}位活跃编辑者。'''<br />
== 刷机入门 ==<br />
# [[ADB与Fastboot|ADB 与 Fastboot]]<br />
# [[解锁Bootloader|解锁 Bootloader]]<br />
# [[刷入第三方Recovery|刷入第三方 Recovery]]<br />
# [[获取Root权限|获取 Root 权限]]<br />
# [[Miflash线刷|MiFlash 线刷]]<br />
<br />
== 进阶内容 ==<br />
# [[使用柚坛工具箱进行线刷]]<br />
# [[ADB SideLoad]]<br />
# [[Fastboot Update]]<br />
# [[Fastboot 命令]]<br />
# [[刷入任意单独镜像]]<br />
# [[9008深度刷机|9008 深度刷机]]<br />
# [[MTK Flashtool深度刷机|MTK Flashtool 深度刷机]]<br />
# [[提取分区]]<br />
# [[修改分区]]<br />
# [[QCN]]<br />
# [[Super_Empty|Super empty]]<br />
<br />
== 系统修改 ==<br />
# [[ADB命令|ADB 命令]]<br />
# [[Magisk模块|Magisk 模块]]<br />
# [[LsPosed 模块|LSPosed 模块]]<br />
# [[KSU 模块]]<br />
# [[修改教程|修改方案]]<br />
<br />
== Mindows工具箱 ==<br />
# [[为手机刷入Windows|为手机刷入 Windows]]<br />
# [[更新驱动程序]]<br />
# [[重新安装Windows|重新安装 Windows]]<br />
# [[一些常见问题及其解决方案]]<br />
<br />
== 高级内容 ==<br />
# [[Android 分区详解]]<br />
# [[GKI 内核]]<br />
# [[如何解包 Android ROM]]<br />
# [[如何打包 Android ROM]]<br />
# [[如何从源码构建 TWRP Recovery]]<br />
# [[如何从源码构建 Android ROM]]<br />
# [[使用edl.py|使用 edl.py]]<br />
# [[为手机安装Linux|为手机安装 Linux]]<br />
# [[Git使用教程]]<br />
# [[Android内核编译入门]]<br />
# [[为新设备编写Recovery device tree]]<br />
# [[为新设备编写类原生device tree]]<br />
<br />
== 知名玩机博主 ==<br />
# [[极客湾Geekerwan]]<br />
# [[小白测评]]<br />
# [[微积分WekiHome]]<br />
# [[晨钟酱Official]]<br />
# [[江灵夏草]]<br />
# [[柚坛UOTAN]]<br />
# [[派大宝UI]]<br />
# [[我可以等你十年]]<br />
# [[某贼]]<br />
# [[凡生TalkING]]<br />
<br />
== 知名良心开发者 ==<br />
# [[暮间雾]]<br />
# [[某贼]]<br />
# [[Amktiao]]<br />
# [[小太阳ACA]]<br />
# [[hellobbn]]<br />
<br />
== 更多词条 ==<br />
# [[设备代号收录集合]]<br />
# [[通用系统镜像]]<br />
# [[AOSP]]<br />
# [[Linux mainlining]]<br />
# [[Windows on arm|WOA (Windows on arm)]]</div>
XiaoleGun
https://wiki.uotan.cn/index.php?title=%E9%A6%96%E9%A1%B5&diff=531
首页
2024-02-17T13:52:17Z
<p>XiaoleGun：添加制作recovery dt</p>
<hr />
<div><br />
= 欢迎来到 <span style="display: inline-block; vertical-align: middle; padding-bottom: 11px;">[[文件:Uotan Wiki.png|120px]]</span> · 刷机百科 =<br />
<br />
'''我们致力于打造一个更适合国人使用、更贴近刷机本身的玩机知识站点'''<br />
<br />
'''本站现有{{NUMBEROFUSERS}}名用户，{{NUMBEROFEDITS}}次编辑，{{NUMBEROFARTICLES}}篇条目，{{NUMBEROFACTIVEUSERS}}位活跃编辑者。'''<br />
== 刷机入门 ==<br />
# [[ADB与Fastboot|ADB 与 Fastboot]]<br />
# [[解锁Bootloader|解锁 Bootloader]]<br />
# [[刷入第三方Recovery|刷入第三方 Recovery]]<br />
# [[获取Root权限|获取 Root 权限]]<br />
# [[Miflash线刷|MiFlash 线刷]]<br />
<br />
== 进阶内容 ==<br />
# [[使用柚坛工具箱进行线刷]]<br />
# [[ADB SideLoad]]<br />
# [[Fastboot Update]]<br />
# [[Fastboot 命令]]<br />
# [[刷入任意单独镜像]]<br />
# [[9008深度刷机|9008 深度刷机]]<br />
# [[MTK Flashtool深度刷机|MTK Flashtool 深度刷机]]<br />
# [[提取分区]]<br />
# [[修改分区]]<br />
# [[QCN]]<br />
# [[Super empty]]<br />
<br />
== 系统修改 ==<br />
# [[ADB命令|ADB 命令]]<br />
# [[Magisk模块|Magisk 模块]]<br />
# [[LsPosed 模块|LSPosed 模块]]<br />
# [[KSU 模块]]<br />
# [[修改教程|修改方案]]<br />
<br />
== Mindows工具箱 ==<br />
# [[为手机刷入Windows|为手机刷入 Windows]]<br />
# [[更新驱动程序]]<br />
# [[重新安装Windows|重新安装 Windows]]<br />
# [[一些常见问题及其解决方案]]<br />
<br />
== 高级内容 ==<br />
# [[Android 分区详解]]<br />
# [[GKI 内核]]<br />
# [[如何解包 Android ROM]]<br />
# [[如何打包 Android ROM]]<br />
# [[如何从源码构建 TWRP Recovery]]<br />
# [[如何从源码构建 Android ROM]]<br />
# [[使用edl.py|使用 edl.py]]<br />
# [[为手机安装Linux|为手机安装 Linux]]<br />
# [[Git使用教程]]<br />
# [[Android内核编译入门]]<br />
# [[为新设备编写Recovery device tree]]<br />
# [[为新设备编写类原生device tree]]<br />
<br />
== 知名玩机博主 ==<br />
# [[极客湾Geekerwan]]<br />
# [[小白测评]]<br />
# [[微积分WekiHome]]<br />
# [[晨钟酱Official]]<br />
# [[江灵夏草]]<br />
# [[柚坛UOTAN]]<br />
# [[派大宝UI]]<br />
# [[我可以等你十年]]<br />
# [[某贼]]<br />
# [[凡生TalkING]]<br />
<br />
== 知名良心开发者 ==<br />
# [[暮间雾]]<br />
# [[某贼]]<br />
# [[Amktiao]]<br />
# [[小太阳ACA]]<br />
# [[hellobbn]]<br />
<br />
== 更多词条 ==<br />
# [[设备代号收录集合]]<br />
# [[通用系统镜像]]<br />
# [[AOSP]]<br />
# [[Linux mainlining]]<br />
# [[Windows on arm|WOA (Windows on arm)]]</div>
XiaoleGun
https://wiki.uotan.cn/index.php?title=%E8%AE%BE%E5%A4%87%E4%BB%A3%E5%8F%B7%E6%94%B6%E5%BD%95%E9%9B%86%E5%90%88&diff=524
设备代号收录集合
2024-02-17T11:09:58Z
<p>XiaoleGun：添加Nothing Phone</p>
<hr />
<div>目前设备代号收录表格<br />
----<br />
<br />
=== 小米/红米：（按发布时间排序） ===<br />
{| class="wikitable"<br />
|机型设备<br />
|代号名称<br />
|发布时间<br />
|-<br />
|红米Note13 4G NFC<br />
|sapphiren<br />
|2024/1/15<br />
|-<br />
|红米Note13 4G<br />
|sapphire<br />
|2024/1/15<br />
|-<br />
|红米13R 5G / 红米13C 5G<br />
|air<br />
|2023/12/8<br />
|-<br />
|红米K70E / POCO X6 Pro 5G<br />
|duchamp<br />
|2023/11/29<br />
|-<br />
|红米K70 Pro<br />
|manet<br />
|2023/11/29<br />
|-<br />
|红米K70<br />
|vermeer<br />
|2023/11/29<br />
|-<br />
|红米13C / POCO C65<br />
|gale<br />
|2023/11/10<br />
|-<br />
|小米14 Pro<br />
|shennong<br />
|2023/10/26<br />
|-<br />
|小米14<br />
|houji<br />
|2023/10/26<br />
|-<br />
|小米13T<br />
|aristotle<br />
|2023/9/26<br />
|-<br />
|红米Note13 Pro 4G / POCO X6<br />
|garnet<br />
|2023/9/21<br />
|-<br />
|红米Note13 5G / 13R Pro<br />
|gold<br />
|2023/9/21<br />
|-<br />
|红米Note13 Pro 5G / Pro+ 5G<br />
|zircon<br />
|2023/9/21<br />
|-<br />
|红米平板SE<br />
|xun<br />
|2023/8/15<br />
|-<br />
|小米MIX Fold 3<br />
|babylon<br />
|2023/8/14<br />
|-<br />
|红米K60 至尊版 / 小米13T Pro<br />
|corot<br />
|2023/8/14<br />
|-<br />
|小米平板6 Max<br />
|yudi<br />
|2023/8/14<br />
|-<br />
|POCO M6 Pro 4G<br />
|emerald<br />
|2023/8/5<br />
|-<br />
|红米Note12R / POCO M6 Pro 5G / 红米12 5G<br />
|sky<br />
|2023/6/23<br />
|-<br />
|红米12<br />
|fire<br />
|2023/6/3<br />
|-<br />
|红米Note12T Pro<br />
|pearl<br />
|2023/5/29<br />
|-<br />
|小米CIVI3<br />
|yuechu<br />
|2023/5/25<br />
|-<br />
|红米Note12S<br />
|sea<br />
|2023/4/26<br />
|-<br />
|小米13 Ultra<br />
|ishtar<br />
|2023/4/18<br />
|-<br />
|小米平板6 Pro<br />
|liuqin<br />
|2023/4/18<br />
|-<br />
|小米平板6<br />
|pipa<br />
|2023/4/18<br />
|-<br />
|红米Note12 Pro 4G<br />
|sweet_k6a<br />
|2023/4/11<br />
|-<br />
|红米Note12 4G NFC<br />
|topaz<br />
|2023/3/30<br />
|-<br />
|红米Note12 4G<br />
|tapas<br />
|2023/3/30<br />
|-<br />
|红米Note12 Turbo / POCO F5 5G<br />
|marble<br />
|2023/3/28<br />
|-<br />
|POCO C51 / 红米A2 / A2+<br />
|water<br />
|2023/3/24<br />
|-<br />
|红米12C / POCO C55<br />
|earth<br />
|2022/12/31<br />
|-<br />
|红米Note12 Pro 极速版 / POCO X5 Pro 5G<br />
|redwood<br />
|2022/12/27<br />
|-<br />
|红米K60E<br />
|rembrandt<br />
|2022/12/27<br />
|-<br />
|红米K60 Pro<br />
|socrates<br />
|2022/12/27<br />
|-<br />
|红米K60 / POCO F5 Pro<br />
|mondrian<br />
|2022/12/27<br />
|-<br />
|小米13 Pro<br />
|nuwa<br />
|2022/12/12<br />
|-<br />
|小米13<br />
|fuxi<br />
|2022/12/12<br />
|-<br />
|POCO X5 5G<br />
|moonstone<br />
|2022/11/20<br />
|-<br />
|红米Note12 5G / 红米Note12R Pro<br />
|sunstone<br />
|2022/10/27<br />
|-<br />
|红米Note12 Pro<br />
|ruby<br />
|2022/10/27<br />
|-<br />
|小米12T<br />
|plato<br />
|2022/10/4<br />
|-<br />
|红米平板<br />
|yunluo<br />
|2022/10/4<br />
|-<br />
|小米CIVI 2 / 小米13 Lite<br />
|ziyi<br />
|2022/9/27<br />
|-<br />
|POCO C50 / 红米A1<br />
|ice<br />
|2022/9/15<br />
|-<br />
|POCO M5S<br />
|rosemary_p<br />
|2022/9/5<br />
|-<br />
|POCO M5 / 红米11 Prime 4G<br />
|rock<br />
|2022/9/5<br />
|-<br />
|小米平板5 Pro 12.4<br />
|dagu<br />
|2022/8/11<br />
|-<br />
|红米K50 至尊版 / 小米12T Pro<br />
|diting<br />
|2022/8/11<br />
|-<br />
|小米MIX Fold 2<br />
|zizhan<br />
|2022/8/11<br />
|-<br />
|小米12S<br />
|mayfly<br />
|2022/7/4<br />
|-<br />
|小米12S Ultra<br />
|thor<br />
|2022/7/4<br />
|-<br />
|小米12S Pro<br />
|unicorn<br />
|2022/7/4<br />
|-<br />
|小米12 Pro 天玑版<br />
|daumier<br />
|2022/7/4<br />
|-<br />
|小米12 Lite<br />
|taoyao<br />
|2022/7/4<br />
|-<br />
|POCO C40<br />
|frost<br />
|2022/6/17<br />
|-<br />
|红米Note11T Pro / Pro+ / POCO X4 GT / Pro / 红米K50i / Pro<br />
|xaga<br />
|2022/5/24<br />
|-<br />
|小米CIVI 1S<br />
|zijin<br />
|2022/4/21<br />
|-<br />
|红米Note 10T<br />
|lilac<br />
|2022/4/14<br />
|-<br />
|红米10A<br />
|dandelion<br />
|2022/3/29<br />
|-<br />
|红米10C<br />
|fog<br />
|2022/3/17<br />
|-<br />
|红米K50<br />
|rubens<br />
|2022/3/17<br />
|-<br />
|红米K50 Pro<br />
|matisse<br />
|2022/3/17<br />
|-<br />
|红米K40S / POCO F4<br />
|munch<br />
|2022/3/17<br />
|-<br />
|红米Note11 Pro<br />
|viva<br />
|2022/3/7<br />
|-<br />
|红米Note11R<br />
|lightcm<br />
|2022/3/7<br />
|-<br />
|红米Note11E / POCO M4 5G / 红米10 Prime+ 5G<br />
|light<br />
|2022/3/7<br />
|-<br />
|红米K50 电竞版 / POCO F4 GT<br />
|ingres<br />
|2022/2/16<br />
|-<br />
|红米Note11 NFC<br />
|spesn<br />
|2022/2/7<br />
|-<br />
|红米Note11<br />
|spes<br />
|2022/2/7<br />
|-<br />
|红米Note11E Pro / 红米Note11 Pro 5G<br />
|veux<br />
|2022/1/26<br />
|-<br />
|红米Note 11S 5G<br />
|opal<br />
|2022/1/26<br />
|-<br />
|红米Note 11S / POCO M4 Pro 4G<br />
|fleur<br />
|2022/1/26<br />
|-<br />
|小米12 Pro<br />
|zeus<br />
|2021/12/28<br />
|-<br />
|小米12X<br />
|psyche<br />
|2021/12/28<br />
|-<br />
|小米12<br />
|cupid<br />
|2021/12/28<br />
|-<br />
|POCO M4 Pro 5G<br />
|evergreen<br />
|2021/11/9<br />
|-<br />
|红米Note11 Pro / Pro+<br />
|pissarro<br />
|2021/10/28<br />
|-<br />
|红米Note11 5G<br />
|evergo<br />
|2021/10/28<br />
|-<br />
|红米Note11 4G<br />
|selenes<br />
|2021/10/28<br />
|-<br />
|小米CIVI<br />
|mona<br />
|2021/9/27<br />
|-<br />
|小米11青春活力版<br />
|lisa<br />
|2021/9/15<br />
|-<br />
|小米11T<br />
|agate<br />
|2021/9/15<br />
|-<br />
|小米11T Pro<br />
|vili<br />
|2021/9/15<br />
|-<br />
|红米10<br />
|selene<br />
|2021/8/19<br />
|-<br />
|小米MIX4<br />
|odin<br />
|2021/8/10<br />
|-<br />
|小米平板5 Pro (WiFi)<br />
|elish<br />
|2021/8/10<br />
|-<br />
|小米平板5 Pro (5G)<br />
|enuma<br />
|2021/8/10<br />
|-<br />
|小米平板5<br />
|nabu<br />
|2021/8/10<br />
|-<br />
|红米Note 10 Pro (China) / POCO X3 GT<br />
|chopin<br />
|2021/5/26<br />
|-<br />
|红米Note 10 (China) / POCO M3 Pro / 红米Note 11 SE<br />
|camellia<br />
|2021/5/26<br />
|-<br />
|红米Note 8 (21年款)<br />
|biloba<br />
|2021/5/24<br />
|-<br />
|红米K40 游戏增强版 / POCO F3 GT<br />
|ares<br />
|2021/4/27<br />
|-<br />
|小米MIX Fold<br />
|cetus<br />
|2021/3/29<br />
|-<br />
|小米11 青春版<br />
|renoir<br />
|2021/3/29<br />
|-<br />
|小米11 Pro / Ultra<br />
|star<br />
|2021/3/29<br />
|-<br />
|小米11 Lite<br />
|courbet<br />
|2021/3/29<br />
|-<br />
|POCO X3 Pro<br />
|vayu<br />
|2021/3/22<br />
|-<br />
|小米10S<br />
|thyme<br />
|2021/3/10<br />
|-<br />
|红米Note 10 Pro<br />
|sweet<br />
|2021/3/4<br />
|-<br />
|红米Note 10 5G<br />
|camellian<br />
|2021/3/4<br />
|-<br />
|红米Note 10S<br />
|rosemary<br />
|2021/3/4<br />
|-<br />
|红米Note 10<br />
|mojito<br />
|2021/3/4<br />
|-<br />
|红米K40 Pro / Pro+ / 小米11i / 小米11X Pro<br />
|haydn<br />
|2021/2/25<br />
|-<br />
|红米K40 / POCO F3<br />
|alioth<br />
|2021/2/25<br />
|-<br />
|小米11<br />
|venus<br />
|2020/12/28<br />
|-<br />
|红米Note 9T 5G<br />
|cannong<br />
|2020/12/1<br />
|-<br />
|红米Note 9 Pro 5G / 小米10T Lite<br />
|gauguin<br />
|2020/11/26<br />
|-<br />
|红米Note 9 5G<br />
|cannon<br />
|2020/11/26<br />
|-<br />
|红米Note 9 4G / 红米9T<br />
|lime<br />
|2020/11/26<br />
|-<br />
|POCO M3<br />
|citrus<br />
|2020/11/24<br />
|-<br />
|红米K30S 至尊纪念版 / 小米10T / 10T Pro<br />
|apollo<br />
|2020/10/27<br />
|-<br />
|POCO C3<br />
|angelicain<br />
|2020/10/6<br />
|-<br />
|POCO M2<br />
|shiva<br />
|2020/9/8<br />
|-<br />
|POCO X3 NFC<br />
|surya<br />
|2020/9/7<br />
|-<br />
|红米9C NFC<br />
|angelican<br />
|2020/8/31<br />
|-<br />
|红米9 (India)<br />
|cattail<br />
|2020/8/27<br />
|-<br />
|小米10 至尊纪念版<br />
|cas<br />
|2020/8/11<br />
|-<br />
|红米K30 至尊纪念版<br />
|cezanne<br />
|2020/8/11<br />
|-<br />
|POCO M2 Pro<br />
|gram<br />
|2020/7/7<br />
|-<br />
|红米9A / 9AT<br />
|dandelion<br />
|2020/6/30<br />
|-<br />
|红米9C<br />
|angelica<br />
|2020/6/30<br />
|-<br />
|红米9<br />
|lancelot<br />
|2020/6/15<br />
|-<br />
|小米Note10 Lite<br />
|toco<br />
|2020/5/30<br />
|-<br />
|红米10X Pro<br />
|bomb<br />
|2020/5/26<br />
|-<br />
|红米10X 5G<br />
|atom<br />
|2020/5/26<br />
|-<br />
|红米K30i 5G<br />
|picasso_48m<br />
|2020/5/26<br />
|-<br />
|红米10X 4G / 红米Note 9<br />
|merlin<br />
|2020/4/30<br />
|-<br />
|小米10 青春版<br />
|vangogh<br />
|2020/4/27<br />
|-<br />
|小米10 Lite<br />
|monet<br />
|2020/3/27<br />
|-<br />
|红米K30 Pro / 变焦版 / POCO F2 Pro<br />
|lmi<br />
|2020/3/24<br />
|-<br />
|红米Note 9 Pro Max<br />
|excalibur<br />
|2020/3/12<br />
|-<br />
|红米Note 9S / Pro (India)<br />
|curtana<br />
|2020/3/12<br />
|-<br />
|红米Note9 Pro<br />
|joyeuse<br />
|2020/3/12<br />
|-<br />
|小米10 Pro<br />
|cmi<br />
|2020/2/13<br />
|-<br />
|小米10<br />
|umi<br />
|2020/2/13<br />
|-<br />
|红米8A Pro / 红米8A Dual<br />
|olivewood<br />
|2020/2/11<br />
|-<br />
|POCO X2 印度版<br />
|phoenixin<br />
|2020/2/4<br />
|-<br />
|红米K30 5G<br />
|picasso<br />
|2019/12/10<br />
|-<br />
|红米K30 4G / POCO X2<br />
|phoenix<br />
|2019/12/10<br />
|-<br />
|红米Note 8T<br />
|willow<br />
|2019/11/6<br />
|-<br />
|小米CC9 Pro / 小米Note 10<br />
|tucana<br />
|2019/11/6<br />
|-<br />
|红米Note 8 Pro 印度版<br />
|begoniain<br />
|2019/10/21<br />
|-<br />
|红米8<br />
|olive<br />
|2019/10/9<br />
|-<br />
|红米8A<br />
|olivelite<br />
|2019/9/25<br />
|-<br />
|小米9 Pro 5G<br />
|crux<br />
|2019/9/24<br />
|-<br />
|红米K20 Pro 尊享版<br />
|raphaels<br />
|2019/9/19<br />
|-<br />
|红米Note 8 Pro<br />
|begonia<br />
|2019/8/29<br />
|-<br />
|红米Note 8<br />
|ginkgo<br />
|2019/8/29<br />
|-<br />
|小米A3<br />
|laurel<br />
|2019/7/17<br />
|-<br />
|小米CC9e<br />
|laurus<br />
|2019/7/2<br />
|-<br />
|小米CC9 / 小米9 Lite<br />
|pyxis<br />
|2019/7/2<br />
|-<br />
|小米CC9 美图定制版<br />
|vela<br />
|2019/7/2<br />
|-<br />
|红米K20 / 小米9T 印度版<br />
|davinciin<br />
|2019/6/12<br />
|-<br />
|红米K20 / 小米9T<br />
|davinci<br />
|2019/5/28<br />
|-<br />
|红米K20 Pro / 小米9T Pro<br />
|raphael<br />
|2019/5/28<br />
|-<br />
|红米K20 Pro 印度版<br />
|raphaelin<br />
|2019/5/28<br />
|-<br />
|红米7A<br />
|pine<br />
|2019/5/22<br />
|-<br />
|红米Y3<br />
|onc<br />
|2019/4/24<br />
|-<br />
|红米7<br />
|onclite<br />
|2019/3/18<br />
|-<br />
|小米MIX 3 5G<br />
|andromeda<br />
|2019/2/24<br />
|-<br />
|小米9<br />
|cepheus<br />
|2019/2/20<br />
|-<br />
|小米9 SE<br />
|grus<br />
|2019/2/20<br />
|-<br />
|红米Go<br />
|tiare<br />
|2019/1/29<br />
|-<br />
|红米Note 7<br />
|lavender<br />
|2019/1/10<br />
|-<br />
|红米Note 7 Pro<br />
|violet<br />
|2019/1/10<br />
|-<br />
|小米Play<br />
|lotus<br />
|2018/12/24<br />
|-<br />
|红米Note 6 Pro<br />
|tulip<br />
|2018/11/22<br />
|-<br />
|小米MIX 3<br />
|perseus<br />
|2018/10/25<br />
|-<br />
|小米8 Lite<br />
|platina<br />
|2018/9/19<br />
|-<br />
|红米6 Pro<br />
|sakura<br />
|2018/9/5<br />
|-<br />
|POCO F1<br />
|beryllium<br />
|2018/8/22<br />
|-<br />
|小米平板4/Plus<br />
|clover<br />
|2018/8/14<br />
|-<br />
|小米A2 Lite<br />
|daisy<br />
|2018/7/24<br />
|-<br />
|小米A2<br />
|jasmine<br />
|2018/7/24<br />
|-<br />
|小米Max 3<br />
|nitrogen<br />
|2018/7/19<br />
|-<br />
|红米6A<br />
|cactus<br />
|2018/6/12<br />
|-<br />
|红米6<br />
|cereus<br />
|2018/6/12<br />
|-<br />
|小米8<br />
|dipper<br />
|2018/5/31<br />
|-<br />
|小米8 Pro 屏幕指纹版<br />
|equuleus<br />
|2018/5/31<br />
|-<br />
|小米8 SE<br />
|sirius<br />
|2018/5/31<br />
|-<br />
|小米8 透明探索版<br />
|ursa<br />
|2018/5/31<br />
|-<br />
|红米S2 / 红米Y2<br />
|ysl<br />
|2018/5/10<br />
|-<br />
|小米6X<br />
|wayne<br />
|2018/4/25<br />
|-<br />
|小米MIX 2S<br />
|polaris<br />
|2018/3/27<br />
|-<br />
|红米Note 5 / Pro<br />
|whyred<br />
|2018/2/14<br />
|-<br />
|红米5<br />
|rosy<br />
|2017/12/7<br />
|-<br />
|红米5 Plus<br />
|vince<br />
|2017/12/7<br />
|-<br />
|红米5A<br />
|riva<br />
|2017/10/20<br />
|-<br />
|小米MIX 2<br />
|chiron<br />
|2017/9/11<br />
|-<br />
|小米Note 3<br />
|jason<br />
|2017/9/11<br />
|-<br />
|小米A1<br />
|tissot<br />
|2017/9/5<br />
|-<br />
|红米Note 5A 高配版<br />
|ugg<br />
|2017/8/21<br />
|-<br />
|红米Note 5A 标准版<br />
|ugglite<br />
|2017/8/21<br />
|-<br />
|小米5X<br />
|tiffany<br />
|2017/7/26<br />
|-<br />
|小米Max 2<br />
|oxygen<br />
|2017/5/25<br />
|-<br />
|小米6<br />
|sagit<br />
|2017/4/19<br />
|-<br />
|小米平板3<br />
|cappu<br />
|2017/4/6<br />
|-<br />
|小米5C<br />
|meri<br />
|2017/2/28<br />
|-<br />
|红米4X<br />
|santoni<br />
|2017/2/28<br />
|-<br />
|红米Note 4X 高通版<br />
|mido<br />
|2017/1/19<br />
|-<br />
|红米Note 4 联发科版<br />
|nikel<br />
|2017/1/19<br />
|-<br />
|红米4 高配版<br />
|markw<br />
|2016/11/4<br />
|-<br />
|红米4 标准版<br />
|prada<br />
|2016/11/4<br />
|-<br />
|红米4A<br />
|rolex<br />
|2016/11/4<br />
|-<br />
|小米MIX<br />
|lithium<br />
|2016/10/25<br />
|-<br />
|小米Note 2<br />
|scorpio<br />
|2016/10/25<br />
|-<br />
|小米5S<br />
|capricorn<br />
|2016/9/27<br />
|-<br />
|小米5S Plus<br />
|natrium<br />
|2016/9/27<br />
|-<br />
|红米Pro<br />
|omega<br />
|2016/7/27<br />
|-<br />
|红米3S<br />
|land<br />
|2016/6/15<br />
|-<br />
|小米Max 高配版<br />
|helium<br />
|2016/6/1<br />
|-<br />
|小米Max 标准版<br />
|hydrogen<br />
|2016/5/10<br />
|-<br />
|小米4S<br />
|aqua<br />
|2016/2/24<br />
|-<br />
|小米5<br />
|gemini<br />
|2016/2/24<br />
|-<br />
|红米3 / Pro<br />
|ido<br />
|2016/1/10<br />
|-<br />
|红米Note 3 台湾特别版<br />
|kate<br />
|2015/11/25<br />
|-<br />
|红米Note 3 全网通版<br />
|kenzo<br />
|2015/11/25<br />
|-<br />
|红米Note 3 双网通版<br />
|hennessy<br />
|2015/11/24<br />
|-<br />
|小米平板2<br />
|latte<br />
|2015/11/24<br />
|-<br />
|小米4C<br />
|libra<br />
|2015/9/22<br />
|-<br />
|红米Note 2<br />
|hermes<br />
|2015/8/13<br />
|-<br />
|小米4i<br />
|ferrari<br />
|2015/4/23<br />
|-<br />
|红米2A 标准版<br />
|lte26007<br />
|2015/3/1<br />
|-<br />
|小米Note 顶配版<br />
|leo<br />
|2015/1/15<br />
|-<br />
|小米Note 双网通 / 全网通<br />
|virgo<br />
|2015/1/15<br />
|-<br />
|红米手机2 增强版<br />
|wt86047<br />
|2015/1/4<br />
|-<br />
|红米手机2<br />
|wt88047<br />
|2015/1/4<br />
|-<br />
|红米Note 4G单卡版<br />
|dior<br />
|2014/8/12<br />
|-<br />
|红米Note 4G双卡版<br />
|gucci<br />
|2014/8/12<br />
|-<br />
|小米3 / 小米4<br />
|cancro<br />
|2014/7/22<br />
|-<br />
|红米手机1S<br />
|armani<br />
|2014/7/16<br />
|-<br />
|红米手机1S 移动3G版<br />
|HM2014011<br />
|2014/7/16<br />
|-<br />
|红米手机1S 移动4G版<br />
|HM2014501<br />
|2014/7/16<br />
|-<br />
|小米平板1<br />
|mocha<br />
|2014/5/15<br />
|-<br />
|红米Note<br />
|lcsh92<br />
|2014/3/20<br />
|-<br />
|小米2A<br />
|taurus<br />
|2013/10/24<br />
|-<br />
|小米3 移动版<br />
|pisces<br />
|2013/9/5<br />
|-<br />
|红米手机<br />
|HM2013023<br />
|2013/7/12<br />
|-<br />
|小米2S<br />
|aries<br />
|2013/6/17<br />
|-<br />
|小米1S<br />
|mione<br />
|2012/8/23<br />
|}<br />
<br />
=== Nothing Phone ===<br />
{| class="wikitable"<br />
|+<br />
!机型设备<br />
!机型型号<br />
!机型代号<br />
!发布时间<br />
|-<br />
|Nothing Phone (2) <br />
|A065/AIN065(India)<br />
|Pong<br />
|2023/07/12<br />
|-<br />
|Nothing Phone (1)<br />
|A603<br />
|Spacewar<br />
|2022/7/12<br />
|}</div>
XiaoleGun
https://wiki.uotan.cn/index.php?title=Git%E4%BD%BF%E7%94%A8%E6%95%99%E7%A8%8B&diff=523
Git使用教程
2024-02-17T10:46:31Z
<p>XiaoleGun：补充参考资料</p>
<hr />
<div>=== Git的由来： ===<br />
Git是一个开源的分布式版本控制系统，可以有效、高速地处理从很小到非常大的项目版本管理，也是Linus Torvalds为了帮助管理Linux内核开发而开发的一个开放源码的版本控制软件。Torvalds 开始着手开发 Git 是为了作为一种过渡方案来替代 BitKeeper。<br />
<br />
=== 常见的代码托管平台： ===<br />
[https://github.com Github]<br />
<br />
[https://gitlab.com Gitlab]<br />
<br />
[https://gitee.com Gitee]<br />
<br />
=== Git 常见命令: ===<br />
<br />
==== git init ====<br />
在本地目录中初始化一个新的Git仓库<br />
<br />
==== git config ====<br />
用于配置用户的信息以及其他设置,在使用git之前您必须完成以下步骤。<br />
<br />
<code>git config --global user.name "your username"</code><br />
<br />
<code>git config --global user.email "your email"</code><br />
<br />
<br />
更改默认编辑器<br />
<br />
<code>git config --global core.editor nano</code><br />
<br />
==== git clone ====<br />
用于将远程仓库的代码克隆到本地，以下是命令中各个参数的含义：<br />
<br />
<code><url></code><br />
<br />
克隆某个地址(url)的仓库，远程仓库的地址可以是本地的目录，也可以是例如github,giteee,gitlab一类的代码托管平台<br />
<br />
<code>--depth=<number></code><br />
<br />
克隆仓库并且保留number条提交历史，number在此处即表达我们克隆的深度。<br />
<br />
<code>-b <branch></code><br />
<br />
克隆指定分支下的仓库内容<br />
<br />
例如我们要克隆<code>LineageOS</code>的内核源码，指定<code>lineage-21</code>分支，且仅保留最近一个提交，则需要输入:<br />
<br />
<code>git clone -b lineage-21 <nowiki>https://github.com/LineageOS/android_kernel_xiaomi_sdm845</nowiki> --depth=1</code><br />
<br />
==== git add ====<br />
添加某个文件，或者目录到暂存区，用于告诉git你需要将哪些文件的更改包含在下一次的提交(commit)之中添加一个或者多个文件到暂存区之中<br />
<br />
<code>git add [file1] [file2]</code><br />
<br />
添加指定目录(文件)到暂存区，包括子目录：<br />
<br />
<code>git add [dir]</code><br />
<br />
添加当前目录下的所有文件到暂存区：<br />
<br />
<code>git add .</code><br />
<br />
==== git status ====<br />
查看当前仓库的状态，此时git会在你的终端输出以下内容<br />
<p><em style="color: gray;">此处演示为英文，如果您的git终端输出为中文也是同理的</em></p><br />
<pre><br />
On branch master<br />
No commits yet<br />
Changes to be committed: <br />
<br />
(use “git rm --cached <file>...” to unstage) <br />
new file: makefile<br />
</pre><br />
<br />
输出内容分别为<br />
<pre><br />
您目前所在的分支<br />
目前的提交<br />
需要更改的内容<br />
新增的文件<br />
修改的文件<br />
删除的文件<br />
</pre><br />
<br />
==== git commit ====<br />
用于将暂存区我们保存的更改文件添加到本地仓库，并且会生成一条提交（commit）<br />
<br />
提交暂存区的更改到本地仓库<br />
<br />
<code>git commit -m "message"</code><br />
<br />
[注] message 可以是你的备注信息<br />
<br />
提交暂存区中的指定文件到本地仓库<br />
<br />
如果你没有使用上述<code>git add</code>命令暂存你的修改文件，可以使用<br />
<br />
<code>git commit -a</code><br />
<br />
进行直接提交<br />
<br />
==== git checkout ====<br />
<br />
* 用于分支切换<br />
<br />
切换分支：<br />
<br />
<code>git checkout <branch-name></code><br />
<br />
<code>git checkout <branch-name></code><br />
<br />
例如在您的仓库中有这几个分支：<br />
<pre><br />
-> master (Default)<br />
backup<br />
test<br />
</pre><br />
您当前处于 master 分支，如果想要切换到test分支，我们可以使用<br />
<br />
<code>git checkout test</code><br />
<br />
* 用于检出文件<br />
将指定的文件恢复到最新的提交状态，撤销你对其的更改<br />
<br />
<code>git checkout -- <file></code><br />
<br />
==== git push ====<br />
用于将本地的分支版本上传到远程仓库并进行合并<br />
<br />
<code>git push <remote-host-name> <local-branch-name>:<remote-branch-name></code><br />
<br />
remote-host-name:远程主机名<br />
<br />
local-branch-name:本地分支名<br />
<br />
例如，当你的远程主机名为origin ，本地分支名为master，远程分支名为master时：<br />
<br />
<code>git push origin master:master</code><br />
<br />
例如，当你的rhost名为origin 本地分支名为master远程分支名为master时：<br />
<br />
本地和远程分支名相同，上述命令可以简写为：<br />
<br />
<code>git push origin master</code><br />
<br />
当你的远程版本与本地版本有差异，无法直接push时，你可以使用--force 参数来进行强制推送<br />
<br />
<code>git push --force origin master</code><br />
<br />
--force 此处可以直接简单化为 -f <br />
<br />
如果你想要删除主机内的某个分支，你可以使用--delete参数<br />
<br />
<code>git push origin --delete <branch-name></code><br />
<br />
==== git diff ====<br />
用于比较当前工作区与上一个版本之间的差异<br />
<br />
例如：（此处仅做不恰当举例，Makefile不是这样乱写的）<br />
<pre><br />
diff --git a/makefile b/makefile<br />
<br />
index fbb8c85..d65c7eb 100644<br />
<br />
--- a/makefile<br />
<br />
+++ b/makefile<br />
<br />
@@ -1 +1,2 @@<br />
<br />
114514<br />
<br />
+1919180<br />
</pre><br />
<br />
==== git log ====<br />
用于查看提交的历史<br />
<br />
例如当你进行一次提交之后，执行 <code>git log</code>终端会输出<br />
<br />
<pre><br />
commit 3a5b0d12f471418b13f2baf5e9e4c112a5e804a8 (HEAD -> master)<br />
<br />
Author: luluzzy <1054438588@qq.com><br />
<br />
Date: Thu Feb 15 21:28:47 2024 +0800<br />
<br />
initial commit: add makefile<br />
</pre><br />
<br />
这些输出分别为<br />
<pre><br />
commit sha1 hash: 针对你这个提交的 commit id<br />
Author: commit 作者名称 <you@example.com><br />
Date: commit 日期<br />
commit: 名称<br />
</pre><br />
<br />
关于sha1_hash的介绍请看这里<ref>生成这个hash值，它是对那个commit是Git仓库中内容和头信息Header的一个校验和checksum。Linux kernel开创者和Git的开发者——Linus说，Git使用了sha1并非是为了安全性，而是为了数据的完整性；它可以保证，在很多年后，你重新checkout某个commit时，一定是它多年前的当时的状态，完全一摸一样，完全值得信任。在Git中，根据commit的sha1值40个十六进制数字进行了简单的划分目录，以前2位数字作为目录名，其下面是剩余38位数字组成的一个文件名</ref><br />
<br />
当有多次提交之后，如果我们想要翻之前的提交历史，难免会因为终端输出的内容过多而难以查看翻阅<br />
<br />
此时我们可以使用<code>--online</code>参数来简化输出，此时仅会输出: sha1哈希值 + commit的名称<br />
<br />
例如<br />
<pre><br />
347595d (HEAD -> master) modify makefile<br />
<br />
3a5b0d1 initial commit: add makefile<br />
</pre><br />
<br />
==== git cherry-pick ====<br />
<br />
<br />
cherry-pick (遴选) 和它的名称一样，挑选一个我们需要的 commit 进行操作。它可以用于将在其他分支上的 commit 修改，移植到当前的分支。<br />
<br />
如果我们想在我们正在开发的版本上，添加一个其他版本中的功能代码。就可以使用 cherry-pick ，将这个功能相关的 commit 提取出来，合入该版本。<br />
<br />
<code>git cherry-pick <commit-id></code><br />
<br />
<br />
当我们执行完 <code>cherry-pick</code>操作之后，会自动生成一个<code>commit</code>以及对应新的<code>commit-id</code><br />
<br />
在顺利的情况下我们可以直接通过，但如果遇到代码等因为变量名，写法等不同的情况，<code>cherry-pick</code>大概率会报错，此时我们需要进行报错处理。<br />
<br />
第一种方案是手动修改<br />
<br />
我们可以先使用<code>git status</code>检查当前遴选时冲突的文件<br />
<br />
然后 <code>git checkout --ours filename</code><br />
<br />
然后按照提交的修改内容进行手动修改<br />
<br />
随后使用<code>git add</code>命令将文件重新加入暂存区<br />
<br />
再使用<br />
<br />
<code>git cherry-pick --continue</code><br />
<br />
命令让 cherrypick 操作继续执行。<br />
<br />
第二种方案是直接退出<code>cherry-pick</code>进程，一般适用于冲突文件实在太多了难以按照方案一处理的情况。<br />
<br />
需要注意的是，如果您当前正在遴选的提交在该分支已经存在也会冲突，在这种情况下，您需要解决冲突并手动解决问题。<br />
<br />
<code>git cherry-pick --abort</code><br />
<br />
==== git fetch ====<br />
git fetch 命令用于从远程获取仓库。<br />
<br />
==== git merge ====<br />
<code>git merge</code>是用来把分叉的提交历史放回到一起(合并)的方式。<br />
<br />
git merge命令用来将你之前使用git branch命令创建的分支以及在此分支上独立开发的内容整合为一个分支。<br />
<br />
本<br />
<br />
==== git pull ====<br />
用于从远程获取代码并合并本地的版本。<br />
<br />
<code>git pull</code>其实就是<code>git fetch</code>和<code>git merge FETCH_HEAD</code> 的简写。<br />
<br />
格式如下：<br />
<br />
<code>git pull <remote-host-name> <remote-branch-name>:<local-branch-name></code><br />
<br />
==== git rebase ====<br />
用于需要修改历史上某一项commit<br />
<br />
<code>git rebase -i HEAD~<commit number></code><br />
<br />
commit number就是从头部往前数的commit数量。执行后会弹出你在git config内配置的编辑器，若未配置则是默认，vim居多。然后就可以看见一堆commit前面有pick字样。可以将pick替换为你想要的操作。<br />
有以下操作：<br />
<br />
1.edit，顾名思义编辑此commit，替换完保存后请修改内容，使用<code>git add</code>或vscode，github desktop将修改文件添加到暂存区，之后命令行执行<code>git commit --amend</code>这样commit就修改成了<br />
<br />
2.squash，合并几个提交，确认一个父提交，将要合并的commit，从下向上替换字符串，会从下向上合并(方位指的是<code>git rebase</code>后弹出的编辑器)<br />
<br />
3.drop，需要移除的commit<br />
<br />
==== git subtree ====<br />
子树，在Android开发中多用于Kernel侧更改，如跟踪audio模块等<br />
<br />
<code>git subtree add --prefix=<目录> <仓库地址> <远程分支></code><br />
<br />
如果需要更新远程库时<br />
<br />
<code>git subtree pull --prefix=<目录> <仓库地址> <远程分支></code><br />
<br />
==== git submodule ====<br />
<br />
===== 子模块功能的概述 =====<br />
<code>git submodule</code>允许在自己的Github仓库里加入别人的github仓库，作为自己仓库的子仓库(即submodule)。<br />
<br />
为什么我们会需要使用子模块？当我们维护一个项目时有可能遇到以下情况，例如维护某款机型的KernelSU内核，我们需要将KernelSU导入至我们的内核源码中，如果我们直接clone进去容易带来一个问题，如果KernelSU更新了怎么办？此时我们便可以使用子模块来解决这个问题<br />
<br />
<code>git submodule</code>允许在git仓库里存放别人仓库的url，作为自己的子模块，其核心内容是在Git仓库里面加入一个<code>.gitmodules</code>文件，里面会记录各个submodule的名字，路径，以及对应链接。<br />
<br />
===== 加入子模块 =====<br />
<code>git submodule add <url> <path></code><br />
<br />
此时 <code>.gitmodules</code>内会自动生成以下内容<br />
<br />
[submodule "xxx"]<br />
<br />
path = xxx<br />
<br />
url = xxx<br />
<br />
===== 初始化子模块 =====<br />
<code>git submodule init</code><br />
<br />
===== 更新子模块 =====<br />
<code>git submodule update</code><br />
<br />
=== Git进阶 ===<br />
<br />
==== GPG key ====<br />
<br />
===== 简介 =====<br />
平时在Github上摸鱼的时候，是不是经常能看见如下图所示，有一个绿色的"Verified"字样，看着很酷，实际上这是为了确保commit为开发者本人所写的进行的GPG签名。<br />
[[文件:Github GPG sign.png|居中]]<br />
因为Git的默认机制，任何人都可以通过你的邮箱和用户名创建虚假的commit，甚至你名气很大的话可以“栽赃陷害”你。如果你是某高校计算机专业的同学亦或是对计算机抱有很大的兴趣，乐意为开源社区提供“资源”，那么我建议你设置GPG sign。未来是不可预知的，人人都可能成为巨佬。<br />
<br />
===== 使用 =====<br />
因为我只在Mac环境下配置过GPG，Windows只是打游戏用，所以用的少，Linux/类Unix可以参考一下。其它系统等待他人补充......<br />
<br />
====== Mac ======<br />
Mac默认是不带GPG的，需要通过第三方软件包安装器Homebrew进行安装，首先先安装Homebrew，如已安装可以跳过。<br />
<br />
编辑器限制原因不能使用默认标题进行分步了，故使用1、2、3等小数字代替。<br />
<br />
安装Homebrew<br />
<br />
在安装之前需要从系统信息中查看芯片为Intel/M系列<br />
<br />
Intel使用<br />
<br />
<code>/bin/zsh -c "$(curl -fsSL <nowiki>https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh</nowiki>)"</code><br />
<br />
Intel按照脚本提示，选源，输密码，回车一路绿灯就好了，如果这都不会......可能你不是很适合开发，因为该脚本是国内开发者编写的，中文和一键化安装都集齐了。<br />
<br />
M系列使用<br />
<br />
<code>/bin/zsh -c "$(curl -fsSL https://gitee.com/huwei1024/HomebrewCN/raw/master/Homebrew.sh)"</code><br />
<br />
并且因为M系列系统结构发生改变，包安装位置不在是以前的/usr/local/，而是在/opt/homebrew，所以要将配置文件里的环境变量改过来。<br />
<br />
1.首先进入根目录<br />
<br />
<code>cd ~</code><br />
<br />
2.创建.zshrc文件<br />
<br />
<code>touch .zshrc</code><br />
<br />
3.打开文件进行编辑<br />
<br />
<code>open -e .zshrc</code><br />
<br />
4.如果有旧的环境就修改，没有就新增<br />
<br />
<code>export PATH="/opt/homebrew/bin:$PATH"<br />
<br />
export PATH="/opt/homebrew/sbin:$PATH"</code><br />
<br />
5.保存<br />
<br />
使用command + s<br />
<br />
6.生效环境变量<br />
<br />
<code>source .zshrc</code><br />
<br />
7、测试<br />
<br />
<code>brew -v</code><br />
<br />
若终端顺利打印出brew的版本，那么就安装成功了！<br />
<br />
注：本人没有使用过M系列设备，该教程在知乎上找到的<br />
<br />
使用Homebrew安装GPG<br />
<br />
<code>brew install gnupg pinentry-mac</code><br />
<br />
[[文件:截屏2024-02-17 17.34.48.png|居中]]<br />
<br />
为GPG添加环境变量，否则在签名的时候会发生报错（使用bash请自行替换配置文件）<br />
<br />
<code>echo "export GPG_TTY=$(tty)" >> ~/.zshrc<br />
source ~/.zshrc<br />
</code><br />
<br />
生成一个GPG keys<br />
<br />
<code>gpg --full-generate-key</code><br />
<br />
[[文件:截屏2024-02-17 17.45.51.png|居中]]<br />
<br />
默认使用的是ECC，我使用的是RSA，按照自己喜好，或从百度搜索非对称和对称加密算法之间的区别，这里只做使用方法的介绍，不做赘述。<br />
<br />
然后添写密钥长度和使用有效期，这里建议选择长期，并做备份，一辈子用一个就够了。<br />
<br />
[[文件:截屏2024-02-17 17.46.06.png|居中]]<br />
[[文件:截屏2024-02-17 17.46.35.png|居中]]<br />
<br />
个人信息按照Github信息填写，真实姓名对应Username。填写完毕按回车输入O即可生成密钥。不出意外的话会弹出Gui窗口让你设置密钥密码，强烈建设设置一个较为复杂的密码，并牢记，当然也可以不设置。<br />
<br />
使用GPG对Git的commit和tag进行签名<br />
<br />
先为Git定义GPG二进制所在地<br />
<br />
<code>git config --global gpg.program $(which gpg)</code><br />
<br />
查看GPG keys ID<br />
<br />
<code>gpg --list-secret-keys --keyid-format=long</code><br />
<br />
如图所示RSA/后面紧跟的一串就是GPG keys ID<br />
[[文件:截屏2024-02-17 17.57.01.png|居中]]<br />
<code>git config --global user.signingkey "GPG key ID"</code><br />
<br />
为Git设置全局commit和tag签名<br />
<br />
<code>git config --global commit.gpgsign true<br />
<br />
git config --global tag.gpgSign true</code><br />
<br />
参见本文“在Github配置GPG keys”部分开启下一步操作<br />
<br />
接下来就可以愉快的编写程序了~<br />
<br />
======在Github配置GPG keys======<br />
在终端输入<br />
<br />
<code>gpg --armor --export "GPG key ID"</code><br />
<br />
将输出的内容从-----BEGIN PGP PUBLIC KEY BLOCK-----到-----END PGP PUBLIC KEY BLOCK-----，包含它们都复制下来。<br />
<br />
打开Github网页，并登录自己的账号。按照下述操作依次执行。<br />
<br />
头像-->Setting-->SSH and GPG keys-->New GPG key<br />
<br />
标题自己怎么舒服怎么来，将第一步复制的内容全部粘贴然后保存起来，这样Github就能识别到你commit中包含的GPG sign的信息了，你就可以在commit history或release等页面看到绿色的签名后的标志了。<br />
<br />
==== SSH key ====<br />
可以通过生成SSH key，并保存在Github等托管平台上实现免密Push，这也是官方推荐的方法，过去输入用户名/密码的方式早已被抛弃。<br />
<br />
===== 生成Key =====<br />
1.打开终端并输入 <br />
<br />
<code>ls ~/.ssh</code><br />
<br />
检查是否已经存在了SSH密钥。如果你看到包含id_rsa等文件，说明你已经有了SSH key，可以跳过第 2 步和第 3 步。<br />
<br />
2.输入，生成新的SSH密钥。你可以直接按回车键使用默认的文件路径和空密码，也可以自己设置。<br />
<br />
<code>ssh-keygen -t rsa -b 4096 -C "your_email@example.com"</code><br />
<br />
4.在终端输入或使用文本编辑器打开，并复制所有内容<br />
<br />
<code>vim ~/.ssh/id_rsa.pub</code><br />
<br />
5.打开Github网页，并登录自己的账号。按照下述操作依次执行。<br />
<br />
头像-->Setting-->SSH and GPG keys-->New SSH key<br />
<br />
自己起个标题名并粘贴4步中所有内容，保存，接下来你可以免密对Github上的repo进行操作了。<br />
<br />
==== 参考资料： ====<br />
[1] 百度百科 -- Git：<nowiki>https://baike.baidu.com/item/GIT/12647237?fr=ge_ala</nowiki><br />
<br />
[2] 菜鸟教程 -- Git基本操作：<nowiki>https://www.runoob.com/git/git-basic-operations.html</nowiki><br />
<br />
[3] CSDN -- git merge 使用简介: <nowiki>https://blog.csdn.net/All_In_gzx_cc/article/details/125482617</nowiki><br />
<br />
[4] 知乎 -- MAC 安装 homebrew 国内镜像: <nowiki>https://zhuanlan.zhihu.com/p/547898033</nowiki><br />
<br />
[5] Github -- Generating a new GPG key: <nowiki>https://docs.github.com/en/authentication/managing-commit-signature-verification/generating-a-new-gpg-key</nowiki><br />
<br />
[6] Github -- Adding a GPG key to your GitHub account: <nowiki>https://docs.github.com/en/authentication/managing-commit-signature-verification/adding-a-gpg-key-to-your-github-account</nowiki><br />
<br />
[7] Github -- Generating a new SSH key and adding it to the ssh-agent: <nowiki>https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent</nowiki><br />
<br />
[8] Github -- Adding a new SSH key to your GitHub account: <nowiki>https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account</nowiki></div>
XiaoleGun
https://wiki.uotan.cn/index.php?title=Git%E4%BD%BF%E7%94%A8%E6%95%99%E7%A8%8B&diff=522
Git使用教程
2024-02-17T10:42:20Z
<p>XiaoleGun：添加SSH key</p>
<hr />
<div>=== Git的由来： ===<br />
Git是一个开源的分布式版本控制系统，可以有效、高速地处理从很小到非常大的项目版本管理，也是Linus Torvalds为了帮助管理Linux内核开发而开发的一个开放源码的版本控制软件。Torvalds 开始着手开发 Git 是为了作为一种过渡方案来替代 BitKeeper。<br />
<br />
=== 常见的代码托管平台： ===<br />
[https://github.com Github]<br />
<br />
[https://gitlab.com Gitlab]<br />
<br />
[https://gitee.com Gitee]<br />
<br />
=== Git 常见命令: ===<br />
<br />
==== git init ====<br />
在本地目录中初始化一个新的Git仓库<br />
<br />
==== git config ====<br />
用于配置用户的信息以及其他设置,在使用git之前您必须完成以下步骤。<br />
<br />
<code>git config --global user.name "your username"</code><br />
<br />
<code>git config --global user.email "your email"</code><br />
<br />
<br />
更改默认编辑器<br />
<br />
<code>git config --global core.editor nano</code><br />
<br />
==== git clone ====<br />
用于将远程仓库的代码克隆到本地，以下是命令中各个参数的含义：<br />
<br />
<code><url></code><br />
<br />
克隆某个地址(url)的仓库，远程仓库的地址可以是本地的目录，也可以是例如github,giteee,gitlab一类的代码托管平台<br />
<br />
<code>--depth=<number></code><br />
<br />
克隆仓库并且保留number条提交历史，number在此处即表达我们克隆的深度。<br />
<br />
<code>-b <branch></code><br />
<br />
克隆指定分支下的仓库内容<br />
<br />
例如我们要克隆<code>LineageOS</code>的内核源码，指定<code>lineage-21</code>分支，且仅保留最近一个提交，则需要输入:<br />
<br />
<code>git clone -b lineage-21 <nowiki>https://github.com/LineageOS/android_kernel_xiaomi_sdm845</nowiki> --depth=1</code><br />
<br />
==== git add ====<br />
添加某个文件，或者目录到暂存区，用于告诉git你需要将哪些文件的更改包含在下一次的提交(commit)之中添加一个或者多个文件到暂存区之中<br />
<br />
<code>git add [file1] [file2]</code><br />
<br />
添加指定目录(文件)到暂存区，包括子目录：<br />
<br />
<code>git add [dir]</code><br />
<br />
添加当前目录下的所有文件到暂存区：<br />
<br />
<code>git add .</code><br />
<br />
==== git status ====<br />
查看当前仓库的状态，此时git会在你的终端输出以下内容<br />
<p><em style="color: gray;">此处演示为英文，如果您的git终端输出为中文也是同理的</em></p><br />
<pre><br />
On branch master<br />
No commits yet<br />
Changes to be committed: <br />
<br />
(use “git rm --cached <file>...” to unstage) <br />
new file: makefile<br />
</pre><br />
<br />
输出内容分别为<br />
<pre><br />
您目前所在的分支<br />
目前的提交<br />
需要更改的内容<br />
新增的文件<br />
修改的文件<br />
删除的文件<br />
</pre><br />
<br />
==== git commit ====<br />
用于将暂存区我们保存的更改文件添加到本地仓库，并且会生成一条提交（commit）<br />
<br />
提交暂存区的更改到本地仓库<br />
<br />
<code>git commit -m "message"</code><br />
<br />
[注] message 可以是你的备注信息<br />
<br />
提交暂存区中的指定文件到本地仓库<br />
<br />
如果你没有使用上述<code>git add</code>命令暂存你的修改文件，可以使用<br />
<br />
<code>git commit -a</code><br />
<br />
进行直接提交<br />
<br />
==== git checkout ====<br />
<br />
* 用于分支切换<br />
<br />
切换分支：<br />
<br />
<code>git checkout <branch-name></code><br />
<br />
<code>git checkout <branch-name></code><br />
<br />
例如在您的仓库中有这几个分支：<br />
<pre><br />
-> master (Default)<br />
backup<br />
test<br />
</pre><br />
您当前处于 master 分支，如果想要切换到test分支，我们可以使用<br />
<br />
<code>git checkout test</code><br />
<br />
* 用于检出文件<br />
将指定的文件恢复到最新的提交状态，撤销你对其的更改<br />
<br />
<code>git checkout -- <file></code><br />
<br />
==== git push ====<br />
用于将本地的分支版本上传到远程仓库并进行合并<br />
<br />
<code>git push <remote-host-name> <local-branch-name>:<remote-branch-name></code><br />
<br />
remote-host-name:远程主机名<br />
<br />
local-branch-name:本地分支名<br />
<br />
例如，当你的远程主机名为origin ，本地分支名为master，远程分支名为master时：<br />
<br />
<code>git push origin master:master</code><br />
<br />
例如，当你的rhost名为origin 本地分支名为master远程分支名为master时：<br />
<br />
本地和远程分支名相同，上述命令可以简写为：<br />
<br />
<code>git push origin master</code><br />
<br />
当你的远程版本与本地版本有差异，无法直接push时，你可以使用--force 参数来进行强制推送<br />
<br />
<code>git push --force origin master</code><br />
<br />
--force 此处可以直接简单化为 -f <br />
<br />
如果你想要删除主机内的某个分支，你可以使用--delete参数<br />
<br />
<code>git push origin --delete <branch-name></code><br />
<br />
==== git diff ====<br />
用于比较当前工作区与上一个版本之间的差异<br />
<br />
例如：（此处仅做不恰当举例，Makefile不是这样乱写的）<br />
<pre><br />
diff --git a/makefile b/makefile<br />
<br />
index fbb8c85..d65c7eb 100644<br />
<br />
--- a/makefile<br />
<br />
+++ b/makefile<br />
<br />
@@ -1 +1,2 @@<br />
<br />
114514<br />
<br />
+1919180<br />
</pre><br />
<br />
==== git log ====<br />
用于查看提交的历史<br />
<br />
例如当你进行一次提交之后，执行 <code>git log</code>终端会输出<br />
<br />
<pre><br />
commit 3a5b0d12f471418b13f2baf5e9e4c112a5e804a8 (HEAD -> master)<br />
<br />
Author: luluzzy <1054438588@qq.com><br />
<br />
Date: Thu Feb 15 21:28:47 2024 +0800<br />
<br />
initial commit: add makefile<br />
</pre><br />
<br />
这些输出分别为<br />
<pre><br />
commit sha1 hash: 针对你这个提交的 commit id<br />
Author: commit 作者名称 <you@example.com><br />
Date: commit 日期<br />
commit: 名称<br />
</pre><br />
<br />
关于sha1_hash的介绍请看这里<ref>生成这个hash值，它是对那个commit是Git仓库中内容和头信息Header的一个校验和checksum。Linux kernel开创者和Git的开发者——Linus说，Git使用了sha1并非是为了安全性，而是为了数据的完整性；它可以保证，在很多年后，你重新checkout某个commit时，一定是它多年前的当时的状态，完全一摸一样，完全值得信任。在Git中，根据commit的sha1值40个十六进制数字进行了简单的划分目录，以前2位数字作为目录名，其下面是剩余38位数字组成的一个文件名</ref><br />
<br />
当有多次提交之后，如果我们想要翻之前的提交历史，难免会因为终端输出的内容过多而难以查看翻阅<br />
<br />
此时我们可以使用<code>--online</code>参数来简化输出，此时仅会输出: sha1哈希值 + commit的名称<br />
<br />
例如<br />
<pre><br />
347595d (HEAD -> master) modify makefile<br />
<br />
3a5b0d1 initial commit: add makefile<br />
</pre><br />
<br />
==== git cherry-pick ====<br />
<br />
<br />
cherry-pick (遴选) 和它的名称一样，挑选一个我们需要的 commit 进行操作。它可以用于将在其他分支上的 commit 修改，移植到当前的分支。<br />
<br />
如果我们想在我们正在开发的版本上，添加一个其他版本中的功能代码。就可以使用 cherry-pick ，将这个功能相关的 commit 提取出来，合入该版本。<br />
<br />
<code>git cherry-pick <commit-id></code><br />
<br />
<br />
当我们执行完 <code>cherry-pick</code>操作之后，会自动生成一个<code>commit</code>以及对应新的<code>commit-id</code><br />
<br />
在顺利的情况下我们可以直接通过，但如果遇到代码等因为变量名，写法等不同的情况，<code>cherry-pick</code>大概率会报错，此时我们需要进行报错处理。<br />
<br />
第一种方案是手动修改<br />
<br />
我们可以先使用<code>git status</code>检查当前遴选时冲突的文件<br />
<br />
然后 <code>git checkout --ours filename</code><br />
<br />
然后按照提交的修改内容进行手动修改<br />
<br />
随后使用<code>git add</code>命令将文件重新加入暂存区<br />
<br />
再使用<br />
<br />
<code>git cherry-pick --continue</code><br />
<br />
命令让 cherrypick 操作继续执行。<br />
<br />
第二种方案是直接退出<code>cherry-pick</code>进程，一般适用于冲突文件实在太多了难以按照方案一处理的情况。<br />
<br />
需要注意的是，如果您当前正在遴选的提交在该分支已经存在也会冲突，在这种情况下，您需要解决冲突并手动解决问题。<br />
<br />
<code>git cherry-pick --abort</code><br />
<br />
==== git fetch ====<br />
git fetch 命令用于从远程获取仓库。<br />
<br />
==== git merge ====<br />
<code>git merge</code>是用来把分叉的提交历史放回到一起(合并)的方式。<br />
<br />
git merge命令用来将你之前使用git branch命令创建的分支以及在此分支上独立开发的内容整合为一个分支。<br />
<br />
本<br />
<br />
==== git pull ====<br />
用于从远程获取代码并合并本地的版本。<br />
<br />
<code>git pull</code>其实就是<code>git fetch</code>和<code>git merge FETCH_HEAD</code> 的简写。<br />
<br />
格式如下：<br />
<br />
<code>git pull <remote-host-name> <remote-branch-name>:<local-branch-name></code><br />
<br />
==== git rebase ====<br />
用于需要修改历史上某一项commit<br />
<br />
<code>git rebase -i HEAD~<commit number></code><br />
<br />
commit number就是从头部往前数的commit数量。执行后会弹出你在git config内配置的编辑器，若未配置则是默认，vim居多。然后就可以看见一堆commit前面有pick字样。可以将pick替换为你想要的操作。<br />
有以下操作：<br />
<br />
1.edit，顾名思义编辑此commit，替换完保存后请修改内容，使用<code>git add</code>或vscode，github desktop将修改文件添加到暂存区，之后命令行执行<code>git commit --amend</code>这样commit就修改成了<br />
<br />
2.squash，合并几个提交，确认一个父提交，将要合并的commit，从下向上替换字符串，会从下向上合并(方位指的是<code>git rebase</code>后弹出的编辑器)<br />
<br />
3.drop，需要移除的commit<br />
<br />
==== git subtree ====<br />
子树，在Android开发中多用于Kernel侧更改，如跟踪audio模块等<br />
<br />
<code>git subtree add --prefix=<目录> <仓库地址> <远程分支></code><br />
<br />
如果需要更新远程库时<br />
<br />
<code>git subtree pull --prefix=<目录> <仓库地址> <远程分支></code><br />
<br />
==== git submodule ====<br />
<br />
===== 子模块功能的概述 =====<br />
<code>git submodule</code>允许在自己的Github仓库里加入别人的github仓库，作为自己仓库的子仓库(即submodule)。<br />
<br />
为什么我们会需要使用子模块？当我们维护一个项目时有可能遇到以下情况，例如维护某款机型的KernelSU内核，我们需要将KernelSU导入至我们的内核源码中，如果我们直接clone进去容易带来一个问题，如果KernelSU更新了怎么办？此时我们便可以使用子模块来解决这个问题<br />
<br />
<code>git submodule</code>允许在git仓库里存放别人仓库的url，作为自己的子模块，其核心内容是在Git仓库里面加入一个<code>.gitmodules</code>文件，里面会记录各个submodule的名字，路径，以及对应链接。<br />
<br />
===== 加入子模块 =====<br />
<code>git submodule add <url> <path></code><br />
<br />
此时 <code>.gitmodules</code>内会自动生成以下内容<br />
<br />
[submodule "xxx"]<br />
<br />
path = xxx<br />
<br />
url = xxx<br />
<br />
===== 初始化子模块 =====<br />
<code>git submodule init</code><br />
<br />
===== 更新子模块 =====<br />
<code>git submodule update</code><br />
<br />
=== Git进阶 ===<br />
<br />
==== GPG key ====<br />
<br />
===== 简介 =====<br />
平时在Github上摸鱼的时候，是不是经常能看见如下图所示，有一个绿色的"Verified"字样，看着很酷，实际上这是为了确保commit为开发者本人所写的进行的GPG签名。<br />
[[文件:Github GPG sign.png|居中]]<br />
因为Git的默认机制，任何人都可以通过你的邮箱和用户名创建虚假的commit，甚至你名气很大的话可以“栽赃陷害”你。如果你是某高校计算机专业的同学亦或是对计算机抱有很大的兴趣，乐意为开源社区提供“资源”，那么我建议你设置GPG sign。未来是不可预知的，人人都可能成为巨佬。<br />
<br />
===== 使用 =====<br />
因为我只在Mac环境下配置过GPG，Windows只是打游戏用，所以用的少，Linux/类Unix可以参考一下。其它系统等待他人补充......<br />
<br />
====== Mac ======<br />
Mac默认是不带GPG的，需要通过第三方软件包安装器Homebrew进行安装，首先先安装Homebrew，如已安装可以跳过。<br />
<br />
编辑器限制原因不能使用默认标题进行分步了，故使用1、2、3等小数字代替。<br />
<br />
安装Homebrew<br />
<br />
在安装之前需要从系统信息中查看芯片为Intel/M系列<br />
<br />
Intel使用<br />
<br />
<code>/bin/zsh -c "$(curl -fsSL <nowiki>https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh</nowiki>)"</code><br />
<br />
Intel按照脚本提示，选源，输密码，回车一路绿灯就好了，如果这都不会......可能你不是很适合开发，因为该脚本是国内开发者编写的，中文和一键化安装都集齐了。<br />
<br />
M系列使用<br />
<br />
<code>/bin/zsh -c "$(curl -fsSL https://gitee.com/huwei1024/HomebrewCN/raw/master/Homebrew.sh)"</code><br />
<br />
并且因为M系列系统结构发生改变，包安装位置不在是以前的/usr/local/，而是在/opt/homebrew，所以要将配置文件里的环境变量改过来。<br />
<br />
1.首先进入根目录<br />
<br />
<code>cd ~</code><br />
<br />
2.创建.zshrc文件<br />
<br />
<code>touch .zshrc</code><br />
<br />
3.打开文件进行编辑<br />
<br />
<code>open -e .zshrc</code><br />
<br />
4.如果有旧的环境就修改，没有就新增<br />
<br />
<code>export PATH="/opt/homebrew/bin:$PATH"<br />
<br />
export PATH="/opt/homebrew/sbin:$PATH"</code><br />
<br />
5.保存<br />
<br />
使用command + s<br />
<br />
6.生效环境变量<br />
<br />
<code>source .zshrc</code><br />
<br />
7、测试<br />
<br />
<code>brew -v</code><br />
<br />
若终端顺利打印出brew的版本，那么就安装成功了！<br />
<br />
注：本人没有使用过M系列设备，该教程在知乎上找到的<br />
<br />
使用Homebrew安装GPG<br />
<br />
<code>brew install gnupg pinentry-mac</code><br />
<br />
[[文件:截屏2024-02-17 17.34.48.png|居中]]<br />
<br />
为GPG添加环境变量，否则在签名的时候会发生报错（使用bash请自行替换配置文件）<br />
<br />
<code>echo "export GPG_TTY=$(tty)" >> ~/.zshrc<br />
source ~/.zshrc<br />
</code><br />
<br />
生成一个GPG keys<br />
<br />
<code>gpg --full-generate-key</code><br />
<br />
[[文件:截屏2024-02-17 17.45.51.png|居中]]<br />
<br />
默认使用的是ECC，我使用的是RSA，按照自己喜好，或从百度搜索非对称和对称加密算法之间的区别，这里只做使用方法的介绍，不做赘述。<br />
<br />
然后添写密钥长度和使用有效期，这里建议选择长期，并做备份，一辈子用一个就够了。<br />
<br />
[[文件:截屏2024-02-17 17.46.06.png|居中]]<br />
[[文件:截屏2024-02-17 17.46.35.png|居中]]<br />
<br />
个人信息按照Github信息填写，真实姓名对应Username。填写完毕按回车输入O即可生成密钥。不出意外的话会弹出Gui窗口让你设置密钥密码，强烈建设设置一个较为复杂的密码，并牢记，当然也可以不设置。<br />
<br />
使用GPG对Git的commit和tag进行签名<br />
<br />
先为Git定义GPG二进制所在地<br />
<br />
<code>git config --global gpg.program $(which gpg)</code><br />
<br />
查看GPG keys ID<br />
<br />
<code>gpg --list-secret-keys --keyid-format=long</code><br />
<br />
如图所示RSA/后面紧跟的一串就是GPG keys ID<br />
[[文件:截屏2024-02-17 17.57.01.png|居中]]<br />
<code>git config --global user.signingkey "GPG key ID"</code><br />
<br />
为Git设置全局commit和tag签名<br />
<br />
<code>git config --global commit.gpgsign true<br />
<br />
git config --global tag.gpgSign true</code><br />
<br />
参见本文“在Github配置GPG keys”部分开启下一步操作<br />
<br />
接下来就可以愉快的编写程序了~<br />
<br />
======在Github配置GPG keys======<br />
在终端输入<br />
<br />
<code>gpg --armor --export "GPG key ID"</code><br />
<br />
将输出的内容从-----BEGIN PGP PUBLIC KEY BLOCK-----到-----END PGP PUBLIC KEY BLOCK-----，包含它们都复制下来。<br />
<br />
打开Github网页，并登录自己的账号。按照下述操作依次执行。<br />
<br />
头像-->Setting-->SSH and GPG keys-->New GPG key<br />
<br />
标题自己怎么舒服怎么来，将第一步复制的内容全部粘贴然后保存起来，这样Github就能识别到你commit中包含的GPG sign的信息了，你就可以在commit history或release等页面看到绿色的签名后的标志了。<br />
<br />
==== SSH key ====<br />
可以通过生成SSH key，并保存在Github等托管平台上实现免密Push，这也是官方推荐的方法，过去输入用户名/密码的方式早已被抛弃。<br />
<br />
===== 生成Key =====<br />
1.打开终端并输入 <br />
<br />
<code>ls ~/.ssh</code><br />
<br />
检查是否已经存在了SSH密钥。如果你看到包含id_rsa等文件，说明你已经有了SSH key，可以跳过第 2 步和第 3 步。<br />
<br />
2.输入，生成新的SSH密钥。你可以直接按回车键使用默认的文件路径和空密码，也可以自己设置。<br />
<br />
<code>ssh-keygen -t rsa -b 4096 -C "your_email@example.com"</code><br />
<br />
4.在终端输入或使用文本编辑器打开，并复制所有内容<br />
<br />
<code>vim ~/.ssh/id_rsa.pub</code><br />
<br />
5.打开Github网页，并登录自己的账号。按照下述操作依次执行。<br />
<br />
头像-->Setting-->SSH and GPG keys-->New SSH key<br />
<br />
自己起个标题名并粘贴4步中所有内容，保存，接下来你可以免密对Github上的repo进行操作了。<br />
<br />
==== 参考资料： ====<br />
[1] 百度百科 -- Git：<nowiki>https://baike.baidu.com/item/GIT/12647237?fr=ge_ala</nowiki><br />
<br />
[2] 菜鸟教程 -- Git基本操作：<nowiki>https://www.runoob.com/git/git-basic-operations.html</nowiki><br />
<br />
[3] CSDN -- git merge 使用简介: <nowiki>https://blog.csdn.net/All_In_gzx_cc/article/details/125482617</nowiki><br />
<br />
[4] 知乎 -- MAC 安装 homebrew 国内镜像: <nowiki>https://zhuanlan.zhihu.com/p/547898033</nowiki><br />
<br />
[5] Github -- Generating a new GPG key : <nowiki>https://docs.github.com/en/authentication/managing-commit-signature-verification/generating-a-new-gpg-key</nowiki></div>
XiaoleGun
https://wiki.uotan.cn/index.php?title=Git%E4%BD%BF%E7%94%A8%E6%95%99%E7%A8%8B&diff=521
Git使用教程
2024-02-17T10:29:57Z
<p>XiaoleGun：/* 添加参考资料 */</p>
<hr />
<div>=== Git的由来： ===<br />
Git是一个开源的分布式版本控制系统，可以有效、高速地处理从很小到非常大的项目版本管理，也是Linus Torvalds为了帮助管理Linux内核开发而开发的一个开放源码的版本控制软件。Torvalds 开始着手开发 Git 是为了作为一种过渡方案来替代 BitKeeper。<br />
<br />
=== 常见的代码托管平台： ===<br />
[https://github.com Github]<br />
<br />
[https://gitlab.com Gitlab]<br />
<br />
[https://gitee.com Gitee]<br />
<br />
=== Git 常见命令: ===<br />
<br />
==== git init ====<br />
在本地目录中初始化一个新的Git仓库<br />
<br />
==== git config ====<br />
用于配置用户的信息以及其他设置,在使用git之前您必须完成以下步骤。<br />
<br />
<code>git config --global user.name "your username"</code><br />
<br />
<code>git config --global user.email "your email"</code><br />
<br />
<br />
更改默认编辑器<br />
<br />
<code>git config --global core.editor nano</code><br />
<br />
==== git clone ====<br />
用于将远程仓库的代码克隆到本地，以下是命令中各个参数的含义：<br />
<br />
<code><url></code><br />
<br />
克隆某个地址(url)的仓库，远程仓库的地址可以是本地的目录，也可以是例如github,giteee,gitlab一类的代码托管平台<br />
<br />
<code>--depth=<number></code><br />
<br />
克隆仓库并且保留number条提交历史，number在此处即表达我们克隆的深度。<br />
<br />
<code>-b <branch></code><br />
<br />
克隆指定分支下的仓库内容<br />
<br />
例如我们要克隆<code>LineageOS</code>的内核源码，指定<code>lineage-21</code>分支，且仅保留最近一个提交，则需要输入:<br />
<br />
<code>git clone -b lineage-21 <nowiki>https://github.com/LineageOS/android_kernel_xiaomi_sdm845</nowiki> --depth=1</code><br />
<br />
==== git add ====<br />
添加某个文件，或者目录到暂存区，用于告诉git你需要将哪些文件的更改包含在下一次的提交(commit)之中添加一个或者多个文件到暂存区之中<br />
<br />
<code>git add [file1] [file2]</code><br />
<br />
添加指定目录(文件)到暂存区，包括子目录：<br />
<br />
<code>git add [dir]</code><br />
<br />
添加当前目录下的所有文件到暂存区：<br />
<br />
<code>git add .</code><br />
<br />
==== git status ====<br />
查看当前仓库的状态，此时git会在你的终端输出以下内容<br />
<p><em style="color: gray;">此处演示为英文，如果您的git终端输出为中文也是同理的</em></p><br />
<pre><br />
On branch master<br />
No commits yet<br />
Changes to be committed: <br />
<br />
(use “git rm --cached <file>...” to unstage) <br />
new file: makefile<br />
</pre><br />
<br />
输出内容分别为<br />
<pre><br />
您目前所在的分支<br />
目前的提交<br />
需要更改的内容<br />
新增的文件<br />
修改的文件<br />
删除的文件<br />
</pre><br />
<br />
==== git commit ====<br />
用于将暂存区我们保存的更改文件添加到本地仓库，并且会生成一条提交（commit）<br />
<br />
提交暂存区的更改到本地仓库<br />
<br />
<code>git commit -m "message"</code><br />
<br />
[注] message 可以是你的备注信息<br />
<br />
提交暂存区中的指定文件到本地仓库<br />
<br />
如果你没有使用上述<code>git add</code>命令暂存你的修改文件，可以使用<br />
<br />
<code>git commit -a</code><br />
<br />
进行直接提交<br />
<br />
==== git checkout ====<br />
<br />
* 用于分支切换<br />
<br />
切换分支：<br />
<br />
<code>git checkout <branch-name></code><br />
<br />
<code>git checkout <branch-name></code><br />
<br />
例如在您的仓库中有这几个分支：<br />
<pre><br />
-> master (Default)<br />
backup<br />
test<br />
</pre><br />
您当前处于 master 分支，如果想要切换到test分支，我们可以使用<br />
<br />
<code>git checkout test</code><br />
<br />
* 用于检出文件<br />
将指定的文件恢复到最新的提交状态，撤销你对其的更改<br />
<br />
<code>git checkout -- <file></code><br />
<br />
==== git push ====<br />
用于将本地的分支版本上传到远程仓库并进行合并<br />
<br />
<code>git push <remote-host-name> <local-branch-name>:<remote-branch-name></code><br />
<br />
remote-host-name:远程主机名<br />
<br />
local-branch-name:本地分支名<br />
<br />
例如，当你的远程主机名为origin ，本地分支名为master，远程分支名为master时：<br />
<br />
<code>git push origin master:master</code><br />
<br />
例如，当你的rhost名为origin 本地分支名为master远程分支名为master时：<br />
<br />
本地和远程分支名相同，上述命令可以简写为：<br />
<br />
<code>git push origin master</code><br />
<br />
当你的远程版本与本地版本有差异，无法直接push时，你可以使用--force 参数来进行强制推送<br />
<br />
<code>git push --force origin master</code><br />
<br />
--force 此处可以直接简单化为 -f <br />
<br />
如果你想要删除主机内的某个分支，你可以使用--delete参数<br />
<br />
<code>git push origin --delete <branch-name></code><br />
<br />
==== git diff ====<br />
用于比较当前工作区与上一个版本之间的差异<br />
<br />
例如：（此处仅做不恰当举例，Makefile不是这样乱写的）<br />
<pre><br />
diff --git a/makefile b/makefile<br />
<br />
index fbb8c85..d65c7eb 100644<br />
<br />
--- a/makefile<br />
<br />
+++ b/makefile<br />
<br />
@@ -1 +1,2 @@<br />
<br />
114514<br />
<br />
+1919180<br />
</pre><br />
<br />
==== git log ====<br />
用于查看提交的历史<br />
<br />
例如当你进行一次提交之后，执行 <code>git log</code>终端会输出<br />
<br />
<pre><br />
commit 3a5b0d12f471418b13f2baf5e9e4c112a5e804a8 (HEAD -> master)<br />
<br />
Author: luluzzy <1054438588@qq.com><br />
<br />
Date: Thu Feb 15 21:28:47 2024 +0800<br />
<br />
initial commit: add makefile<br />
</pre><br />
<br />
这些输出分别为<br />
<pre><br />
commit sha1 hash: 针对你这个提交的 commit id<br />
Author: commit 作者名称 <you@example.com><br />
Date: commit 日期<br />
commit: 名称<br />
</pre><br />
<br />
关于sha1_hash的介绍请看这里<ref>生成这个hash值，它是对那个commit是Git仓库中内容和头信息Header的一个校验和checksum。Linux kernel开创者和Git的开发者——Linus说，Git使用了sha1并非是为了安全性，而是为了数据的完整性；它可以保证，在很多年后，你重新checkout某个commit时，一定是它多年前的当时的状态，完全一摸一样，完全值得信任。在Git中，根据commit的sha1值40个十六进制数字进行了简单的划分目录，以前2位数字作为目录名，其下面是剩余38位数字组成的一个文件名</ref><br />
<br />
当有多次提交之后，如果我们想要翻之前的提交历史，难免会因为终端输出的内容过多而难以查看翻阅<br />
<br />
此时我们可以使用<code>--online</code>参数来简化输出，此时仅会输出: sha1哈希值 + commit的名称<br />
<br />
例如<br />
<pre><br />
347595d (HEAD -> master) modify makefile<br />
<br />
3a5b0d1 initial commit: add makefile<br />
</pre><br />
<br />
==== git cherry-pick ====<br />
<br />
<br />
cherry-pick (遴选) 和它的名称一样，挑选一个我们需要的 commit 进行操作。它可以用于将在其他分支上的 commit 修改，移植到当前的分支。<br />
<br />
如果我们想在我们正在开发的版本上，添加一个其他版本中的功能代码。就可以使用 cherry-pick ，将这个功能相关的 commit 提取出来，合入该版本。<br />
<br />
<code>git cherry-pick <commit-id></code><br />
<br />
<br />
当我们执行完 <code>cherry-pick</code>操作之后，会自动生成一个<code>commit</code>以及对应新的<code>commit-id</code><br />
<br />
在顺利的情况下我们可以直接通过，但如果遇到代码等因为变量名，写法等不同的情况，<code>cherry-pick</code>大概率会报错，此时我们需要进行报错处理。<br />
<br />
第一种方案是手动修改<br />
<br />
我们可以先使用<code>git status</code>检查当前遴选时冲突的文件<br />
<br />
然后 <code>git checkout --ours filename</code><br />
<br />
然后按照提交的修改内容进行手动修改<br />
<br />
随后使用<code>git add</code>命令将文件重新加入暂存区<br />
<br />
再使用<br />
<br />
<code>git cherry-pick --continue</code><br />
<br />
命令让 cherrypick 操作继续执行。<br />
<br />
第二种方案是直接退出<code>cherry-pick</code>进程，一般适用于冲突文件实在太多了难以按照方案一处理的情况。<br />
<br />
需要注意的是，如果您当前正在遴选的提交在该分支已经存在也会冲突，在这种情况下，您需要解决冲突并手动解决问题。<br />
<br />
<code>git cherry-pick --abort</code><br />
<br />
==== git fetch ====<br />
git fetch 命令用于从远程获取仓库。<br />
<br />
==== git merge ====<br />
<code>git merge</code>是用来把分叉的提交历史放回到一起(合并)的方式。<br />
<br />
git merge命令用来将你之前使用git branch命令创建的分支以及在此分支上独立开发的内容整合为一个分支。<br />
<br />
本<br />
<br />
==== git pull ====<br />
用于从远程获取代码并合并本地的版本。<br />
<br />
<code>git pull</code>其实就是<code>git fetch</code>和<code>git merge FETCH_HEAD</code> 的简写。<br />
<br />
格式如下：<br />
<br />
<code>git pull <remote-host-name> <remote-branch-name>:<local-branch-name></code><br />
<br />
==== git rebase ====<br />
用于需要修改历史上某一项commit<br />
<br />
<code>git rebase -i HEAD~<commit number></code><br />
<br />
commit number就是从头部往前数的commit数量。执行后会弹出你在git config内配置的编辑器，若未配置则是默认，vim居多。然后就可以看见一堆commit前面有pick字样。可以将pick替换为你想要的操作。<br />
有以下操作：<br />
<br />
1.edit，顾名思义编辑此commit，替换完保存后请修改内容，使用<code>git add</code>或vscode，github desktop将修改文件添加到暂存区，之后命令行执行<code>git commit --amend</code>这样commit就修改成了<br />
<br />
2.squash，合并几个提交，确认一个父提交，将要合并的commit，从下向上替换字符串，会从下向上合并(方位指的是<code>git rebase</code>后弹出的编辑器)<br />
<br />
3.drop，需要移除的commit<br />
<br />
==== git subtree ====<br />
子树，在Android开发中多用于Kernel侧更改，如跟踪audio模块等<br />
<br />
<code>git subtree add --prefix=<目录> <仓库地址> <远程分支></code><br />
<br />
如果需要更新远程库时<br />
<br />
<code>git subtree pull --prefix=<目录> <仓库地址> <远程分支></code><br />
<br />
==== git submodule ====<br />
<br />
===== 子模块功能的概述 =====<br />
<code>git submodule</code>允许在自己的Github仓库里加入别人的github仓库，作为自己仓库的子仓库(即submodule)。<br />
<br />
为什么我们会需要使用子模块？当我们维护一个项目时有可能遇到以下情况，例如维护某款机型的KernelSU内核，我们需要将KernelSU导入至我们的内核源码中，如果我们直接clone进去容易带来一个问题，如果KernelSU更新了怎么办？此时我们便可以使用子模块来解决这个问题<br />
<br />
<code>git submodule</code>允许在git仓库里存放别人仓库的url，作为自己的子模块，其核心内容是在Git仓库里面加入一个<code>.gitmodules</code>文件，里面会记录各个submodule的名字，路径，以及对应链接。<br />
<br />
===== 加入子模块 =====<br />
<code>git submodule add <url> <path></code><br />
<br />
此时 <code>.gitmodules</code>内会自动生成以下内容<br />
<br />
[submodule "xxx"]<br />
<br />
path = xxx<br />
<br />
url = xxx<br />
<br />
===== 初始化子模块 =====<br />
<code>git submodule init</code><br />
<br />
===== 更新子模块 =====<br />
<code>git submodule update</code><br />
<br />
=== Git进阶 ===<br />
<br />
==== GPG key ====<br />
<br />
===== 简介 =====<br />
平时在Github上摸鱼的时候，是不是经常能看见如下图所示，有一个绿色的"Verified"字样，看着很酷，实际上这是为了确保commit为开发者本人所写的进行的GPG签名。<br />
[[文件:Github GPG sign.png|居中]]<br />
因为Git的默认机制，任何人都可以通过你的邮箱和用户名创建虚假的commit，甚至你名气很大的话可以“栽赃陷害”你。如果你是某高校计算机专业的同学亦或是对计算机抱有很大的兴趣，乐意为开源社区提供“资源”，那么我建议你设置GPG sign。未来是不可预知的，人人都可能成为巨佬。<br />
<br />
===== 使用 =====<br />
因为我只在Mac环境下配置过GPG，Windows只是打游戏用，所以用的少，Linux/类Unix可以参考一下。其它系统等待他人补充......<br />
<br />
====== Mac ======<br />
Mac默认是不带GPG的，需要通过第三方软件包安装器Homebrew进行安装，首先先安装Homebrew，如已安装可以跳过。<br />
<br />
编辑器限制原因不能使用默认标题进行分步了，故使用1、2、3等小数字代替。<br />
<br />
安装Homebrew<br />
<br />
在安装之前需要从系统信息中查看芯片为Intel/M系列<br />
<br />
Intel使用<br />
<br />
<code>/bin/zsh -c "$(curl -fsSL <nowiki>https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh</nowiki>)"</code><br />
<br />
Intel按照脚本提示，选源，输密码，回车一路绿灯就好了，如果这都不会......可能你不是很适合开发，因为该脚本是国内开发者编写的，中文和一键化安装都集齐了。<br />
<br />
M系列使用<br />
<br />
<code>/bin/zsh -c "$(curl -fsSL https://gitee.com/huwei1024/HomebrewCN/raw/master/Homebrew.sh)"</code><br />
<br />
并且因为M系列系统结构发生改变，包安装位置不在是以前的/usr/local/，而是在/opt/homebrew，所以要将配置文件里的环境变量改过来。<br />
<br />
1.首先进入根目录<br />
<br />
<code>cd ~</code><br />
<br />
2.创建.zshrc文件<br />
<br />
<code>touch .zshrc</code><br />
<br />
3.打开文件进行编辑<br />
<br />
<code>open -e .zshrc</code><br />
<br />
4.如果有旧的环境就修改，没有就新增<br />
<br />
<code>export PATH="/opt/homebrew/bin:$PATH"<br />
<br />
export PATH="/opt/homebrew/sbin:$PATH"</code><br />
<br />
5.保存<br />
<br />
使用command + s<br />
<br />
6.生效环境变量<br />
<br />
<code>source .zshrc</code><br />
<br />
7、测试<br />
<br />
<code>brew -v</code><br />
<br />
若终端顺利打印出brew的版本，那么就安装成功了！<br />
<br />
注：本人没有使用过M系列设备，该教程在知乎上找到的<br />
<br />
使用Homebrew安装GPG<br />
<br />
<code>brew install gnupg pinentry-mac</code><br />
<br />
[[文件:截屏2024-02-17 17.34.48.png|居中]]<br />
<br />
为GPG添加环境变量，否则在签名的时候会发生报错（使用bash请自行替换配置文件）<br />
<br />
<code>echo "export GPG_TTY=$(tty)" >> ~/.zshrc<br />
source ~/.zshrc<br />
</code><br />
<br />
生成一个GPG keys<br />
<br />
<code>gpg --full-generate-key</code><br />
<br />
[[文件:截屏2024-02-17 17.45.51.png|居中]]<br />
<br />
默认使用的是ECC，我使用的是RSA，按照自己喜好，或从百度搜索非对称和对称加密算法之间的区别，这里只做使用方法的介绍，不做赘述。<br />
<br />
然后添写密钥长度和使用有效期，这里建议选择长期，并做备份，一辈子用一个就够了。<br />
<br />
[[文件:截屏2024-02-17 17.46.06.png|居中]]<br />
[[文件:截屏2024-02-17 17.46.35.png|居中]]<br />
<br />
个人信息按照Github信息填写，真实姓名对应Username。填写完毕按回车输入O即可生成密钥。不出意外的话会弹出Gui窗口让你设置密钥密码，强烈建设设置一个较为复杂的密码，并牢记，当然也可以不设置。<br />
<br />
使用GPG对Git的commit和tag进行签名<br />
<br />
先为Git定义GPG二进制所在地<br />
<br />
<code>git config --global gpg.program $(which gpg)</code><br />
<br />
查看GPG keys ID<br />
<br />
<code>gpg --list-secret-keys --keyid-format=long</code><br />
<br />
如图所示RSA/后面紧跟的一串就是GPG keys ID<br />
[[文件:截屏2024-02-17 17.57.01.png|居中]]<br />
<code>git config --global user.signingkey "GPG key ID"</code><br />
<br />
为Git设置全局commit和tag签名<br />
<br />
<code>git config --global commit.gpgsign true<br />
<br />
git config --global tag.gpgSign true</code><br />
<br />
参见本文“在Github配置GPG keys”部分开启下一步操作<br />
<br />
接下来就可以愉快的编写程序了~<br />
<br />
======在Github配置GPG keys======<br />
在终端输入<br />
<br />
gpg --armor --export "GPG key ID"<br />
<br />
将输出的内容从-----BEGIN PGP PUBLIC KEY BLOCK-----到-----END PGP PUBLIC KEY BLOCK-----，包含它们都复制下来。<br />
<br />
打开Github网页，并登录自己的账号。按照下述操作依次执行。<br />
头像-->Setting-->SSH and GPG keys-->New GPG key，标题自己怎么舒服怎么来，将第一步复制的内容全部粘贴然后保存起来，这样Github就能识别到你commit中包含的GPG sign的信息了，你就可以在commit history或release等页面看到绿色的签名后的标志了。<br />
<br />
==== 参考资料： ====<br />
[1] 百度百科 -- Git：<nowiki>https://baike.baidu.com/item/GIT/12647237?fr=ge_ala</nowiki><br />
<br />
[2] 菜鸟教程 -- Git基本操作：<nowiki>https://www.runoob.com/git/git-basic-operations.html</nowiki><br />
<br />
[3] CSDN -- git merge 使用简介: <nowiki>https://blog.csdn.net/All_In_gzx_cc/article/details/125482617</nowiki><br />
<br />
[4] 知乎 -- MAC 安装 homebrew 国内镜像: <nowiki>https://zhuanlan.zhihu.com/p/547898033</nowiki><br />
<br />
[5] Github -- Generating a new GPG key : <nowiki>https://docs.github.com/en/authentication/managing-commit-signature-verification/generating-a-new-gpg-key</nowiki></div>
XiaoleGun
https://wiki.uotan.cn/index.php?title=Git%E4%BD%BF%E7%94%A8%E6%95%99%E7%A8%8B&diff=520
Git使用教程
2024-02-17T10:27:58Z
<p>XiaoleGun：/* Mac */</p>
<hr />
<div>=== Git的由来： ===<br />
Git是一个开源的分布式版本控制系统，可以有效、高速地处理从很小到非常大的项目版本管理，也是Linus Torvalds为了帮助管理Linux内核开发而开发的一个开放源码的版本控制软件。Torvalds 开始着手开发 Git 是为了作为一种过渡方案来替代 BitKeeper。<br />
<br />
=== 常见的代码托管平台： ===<br />
[https://github.com Github]<br />
<br />
[https://gitlab.com Gitlab]<br />
<br />
[https://gitee.com Gitee]<br />
<br />
=== Git 常见命令: ===<br />
<br />
==== git init ====<br />
在本地目录中初始化一个新的Git仓库<br />
<br />
==== git config ====<br />
用于配置用户的信息以及其他设置,在使用git之前您必须完成以下步骤。<br />
<br />
<code>git config --global user.name "your username"</code><br />
<br />
<code>git config --global user.email "your email"</code><br />
<br />
<br />
更改默认编辑器<br />
<br />
<code>git config --global core.editor nano</code><br />
<br />
==== git clone ====<br />
用于将远程仓库的代码克隆到本地，以下是命令中各个参数的含义：<br />
<br />
<code><url></code><br />
<br />
克隆某个地址(url)的仓库，远程仓库的地址可以是本地的目录，也可以是例如github,giteee,gitlab一类的代码托管平台<br />
<br />
<code>--depth=<number></code><br />
<br />
克隆仓库并且保留number条提交历史，number在此处即表达我们克隆的深度。<br />
<br />
<code>-b <branch></code><br />
<br />
克隆指定分支下的仓库内容<br />
<br />
例如我们要克隆<code>LineageOS</code>的内核源码，指定<code>lineage-21</code>分支，且仅保留最近一个提交，则需要输入:<br />
<br />
<code>git clone -b lineage-21 <nowiki>https://github.com/LineageOS/android_kernel_xiaomi_sdm845</nowiki> --depth=1</code><br />
<br />
==== git add ====<br />
添加某个文件，或者目录到暂存区，用于告诉git你需要将哪些文件的更改包含在下一次的提交(commit)之中添加一个或者多个文件到暂存区之中<br />
<br />
<code>git add [file1] [file2]</code><br />
<br />
添加指定目录(文件)到暂存区，包括子目录：<br />
<br />
<code>git add [dir]</code><br />
<br />
添加当前目录下的所有文件到暂存区：<br />
<br />
<code>git add .</code><br />
<br />
==== git status ====<br />
查看当前仓库的状态，此时git会在你的终端输出以下内容<br />
<p><em style="color: gray;">此处演示为英文，如果您的git终端输出为中文也是同理的</em></p><br />
<pre><br />
On branch master<br />
No commits yet<br />
Changes to be committed: <br />
<br />
(use “git rm --cached <file>...” to unstage) <br />
new file: makefile<br />
</pre><br />
<br />
输出内容分别为<br />
<pre><br />
您目前所在的分支<br />
目前的提交<br />
需要更改的内容<br />
新增的文件<br />
修改的文件<br />
删除的文件<br />
</pre><br />
<br />
==== git commit ====<br />
用于将暂存区我们保存的更改文件添加到本地仓库，并且会生成一条提交（commit）<br />
<br />
提交暂存区的更改到本地仓库<br />
<br />
<code>git commit -m "message"</code><br />
<br />
[注] message 可以是你的备注信息<br />
<br />
提交暂存区中的指定文件到本地仓库<br />
<br />
如果你没有使用上述<code>git add</code>命令暂存你的修改文件，可以使用<br />
<br />
<code>git commit -a</code><br />
<br />
进行直接提交<br />
<br />
==== git checkout ====<br />
<br />
* 用于分支切换<br />
<br />
切换分支：<br />
<br />
<code>git checkout <branch-name></code><br />
<br />
<code>git checkout <branch-name></code><br />
<br />
例如在您的仓库中有这几个分支：<br />
<pre><br />
-> master (Default)<br />
backup<br />
test<br />
</pre><br />
您当前处于 master 分支，如果想要切换到test分支，我们可以使用<br />
<br />
<code>git checkout test</code><br />
<br />
* 用于检出文件<br />
将指定的文件恢复到最新的提交状态，撤销你对其的更改<br />
<br />
<code>git checkout -- <file></code><br />
<br />
==== git push ====<br />
用于将本地的分支版本上传到远程仓库并进行合并<br />
<br />
<code>git push <remote-host-name> <local-branch-name>:<remote-branch-name></code><br />
<br />
remote-host-name:远程主机名<br />
<br />
local-branch-name:本地分支名<br />
<br />
例如，当你的远程主机名为origin ，本地分支名为master，远程分支名为master时：<br />
<br />
<code>git push origin master:master</code><br />
<br />
例如，当你的rhost名为origin 本地分支名为master远程分支名为master时：<br />
<br />
本地和远程分支名相同，上述命令可以简写为：<br />
<br />
<code>git push origin master</code><br />
<br />
当你的远程版本与本地版本有差异，无法直接push时，你可以使用--force 参数来进行强制推送<br />
<br />
<code>git push --force origin master</code><br />
<br />
--force 此处可以直接简单化为 -f <br />
<br />
如果你想要删除主机内的某个分支，你可以使用--delete参数<br />
<br />
<code>git push origin --delete <branch-name></code><br />
<br />
==== git diff ====<br />
用于比较当前工作区与上一个版本之间的差异<br />
<br />
例如：（此处仅做不恰当举例，Makefile不是这样乱写的）<br />
<pre><br />
diff --git a/makefile b/makefile<br />
<br />
index fbb8c85..d65c7eb 100644<br />
<br />
--- a/makefile<br />
<br />
+++ b/makefile<br />
<br />
@@ -1 +1,2 @@<br />
<br />
114514<br />
<br />
+1919180<br />
</pre><br />
<br />
==== git log ====<br />
用于查看提交的历史<br />
<br />
例如当你进行一次提交之后，执行 <code>git log</code>终端会输出<br />
<br />
<pre><br />
commit 3a5b0d12f471418b13f2baf5e9e4c112a5e804a8 (HEAD -> master)<br />
<br />
Author: luluzzy <1054438588@qq.com><br />
<br />
Date: Thu Feb 15 21:28:47 2024 +0800<br />
<br />
initial commit: add makefile<br />
</pre><br />
<br />
这些输出分别为<br />
<pre><br />
commit sha1 hash: 针对你这个提交的 commit id<br />
Author: commit 作者名称 <you@example.com><br />
Date: commit 日期<br />
commit: 名称<br />
</pre><br />
<br />
关于sha1_hash的介绍请看这里<ref>生成这个hash值，它是对那个commit是Git仓库中内容和头信息Header的一个校验和checksum。Linux kernel开创者和Git的开发者——Linus说，Git使用了sha1并非是为了安全性，而是为了数据的完整性；它可以保证，在很多年后，你重新checkout某个commit时，一定是它多年前的当时的状态，完全一摸一样，完全值得信任。在Git中，根据commit的sha1值40个十六进制数字进行了简单的划分目录，以前2位数字作为目录名，其下面是剩余38位数字组成的一个文件名</ref><br />
<br />
当有多次提交之后，如果我们想要翻之前的提交历史，难免会因为终端输出的内容过多而难以查看翻阅<br />
<br />
此时我们可以使用<code>--online</code>参数来简化输出，此时仅会输出: sha1哈希值 + commit的名称<br />
<br />
例如<br />
<pre><br />
347595d (HEAD -> master) modify makefile<br />
<br />
3a5b0d1 initial commit: add makefile<br />
</pre><br />
<br />
==== git cherry-pick ====<br />
<br />
<br />
cherry-pick (遴选) 和它的名称一样，挑选一个我们需要的 commit 进行操作。它可以用于将在其他分支上的 commit 修改，移植到当前的分支。<br />
<br />
如果我们想在我们正在开发的版本上，添加一个其他版本中的功能代码。就可以使用 cherry-pick ，将这个功能相关的 commit 提取出来，合入该版本。<br />
<br />
<code>git cherry-pick <commit-id></code><br />
<br />
<br />
当我们执行完 <code>cherry-pick</code>操作之后，会自动生成一个<code>commit</code>以及对应新的<code>commit-id</code><br />
<br />
在顺利的情况下我们可以直接通过，但如果遇到代码等因为变量名，写法等不同的情况，<code>cherry-pick</code>大概率会报错，此时我们需要进行报错处理。<br />
<br />
第一种方案是手动修改<br />
<br />
我们可以先使用<code>git status</code>检查当前遴选时冲突的文件<br />
<br />
然后 <code>git checkout --ours filename</code><br />
<br />
然后按照提交的修改内容进行手动修改<br />
<br />
随后使用<code>git add</code>命令将文件重新加入暂存区<br />
<br />
再使用<br />
<br />
<code>git cherry-pick --continue</code><br />
<br />
命令让 cherrypick 操作继续执行。<br />
<br />
第二种方案是直接退出<code>cherry-pick</code>进程，一般适用于冲突文件实在太多了难以按照方案一处理的情况。<br />
<br />
需要注意的是，如果您当前正在遴选的提交在该分支已经存在也会冲突，在这种情况下，您需要解决冲突并手动解决问题。<br />
<br />
<code>git cherry-pick --abort</code><br />
<br />
==== git fetch ====<br />
git fetch 命令用于从远程获取仓库。<br />
<br />
==== git merge ====<br />
<code>git merge</code>是用来把分叉的提交历史放回到一起(合并)的方式。<br />
<br />
git merge命令用来将你之前使用git branch命令创建的分支以及在此分支上独立开发的内容整合为一个分支。<br />
<br />
本<br />
<br />
==== git pull ====<br />
用于从远程获取代码并合并本地的版本。<br />
<br />
<code>git pull</code>其实就是<code>git fetch</code>和<code>git merge FETCH_HEAD</code> 的简写。<br />
<br />
格式如下：<br />
<br />
<code>git pull <remote-host-name> <remote-branch-name>:<local-branch-name></code><br />
<br />
==== git rebase ====<br />
用于需要修改历史上某一项commit<br />
<br />
<code>git rebase -i HEAD~<commit number></code><br />
<br />
commit number就是从头部往前数的commit数量。执行后会弹出你在git config内配置的编辑器，若未配置则是默认，vim居多。然后就可以看见一堆commit前面有pick字样。可以将pick替换为你想要的操作。<br />
有以下操作：<br />
<br />
1.edit，顾名思义编辑此commit，替换完保存后请修改内容，使用<code>git add</code>或vscode，github desktop将修改文件添加到暂存区，之后命令行执行<code>git commit --amend</code>这样commit就修改成了<br />
<br />
2.squash，合并几个提交，确认一个父提交，将要合并的commit，从下向上替换字符串，会从下向上合并(方位指的是<code>git rebase</code>后弹出的编辑器)<br />
<br />
3.drop，需要移除的commit<br />
<br />
==== git subtree ====<br />
子树，在Android开发中多用于Kernel侧更改，如跟踪audio模块等<br />
<br />
<code>git subtree add --prefix=<目录> <仓库地址> <远程分支></code><br />
<br />
如果需要更新远程库时<br />
<br />
<code>git subtree pull --prefix=<目录> <仓库地址> <远程分支></code><br />
<br />
==== git submodule ====<br />
<br />
===== 子模块功能的概述 =====<br />
<code>git submodule</code>允许在自己的Github仓库里加入别人的github仓库，作为自己仓库的子仓库(即submodule)。<br />
<br />
为什么我们会需要使用子模块？当我们维护一个项目时有可能遇到以下情况，例如维护某款机型的KernelSU内核，我们需要将KernelSU导入至我们的内核源码中，如果我们直接clone进去容易带来一个问题，如果KernelSU更新了怎么办？此时我们便可以使用子模块来解决这个问题<br />
<br />
<code>git submodule</code>允许在git仓库里存放别人仓库的url，作为自己的子模块，其核心内容是在Git仓库里面加入一个<code>.gitmodules</code>文件，里面会记录各个submodule的名字，路径，以及对应链接。<br />
<br />
===== 加入子模块 =====<br />
<code>git submodule add <url> <path></code><br />
<br />
此时 <code>.gitmodules</code>内会自动生成以下内容<br />
<br />
[submodule "xxx"]<br />
<br />
path = xxx<br />
<br />
url = xxx<br />
<br />
===== 初始化子模块 =====<br />
<code>git submodule init</code><br />
<br />
===== 更新子模块 =====<br />
<code>git submodule update</code><br />
<br />
=== Git进阶 ===<br />
<br />
==== GPG key ====<br />
<br />
===== 简介 =====<br />
平时在Github上摸鱼的时候，是不是经常能看见如下图所示，有一个绿色的"Verified"字样，看着很酷，实际上这是为了确保commit为开发者本人所写的进行的GPG签名。<br />
[[文件:Github GPG sign.png|居中]]<br />
因为Git的默认机制，任何人都可以通过你的邮箱和用户名创建虚假的commit，甚至你名气很大的话可以“栽赃陷害”你。如果你是某高校计算机专业的同学亦或是对计算机抱有很大的兴趣，乐意为开源社区提供“资源”，那么我建议你设置GPG sign。未来是不可预知的，人人都可能成为巨佬。<br />
<br />
===== 使用 =====<br />
因为我只在Mac环境下配置过GPG，Windows只是打游戏用，所以用的少，Linux/类Unix可以参考一下。其它系统等待他人补充......<br />
<br />
====== Mac ======<br />
Mac默认是不带GPG的，需要通过第三方软件包安装器Homebrew进行安装，首先先安装Homebrew，如已安装可以跳过。<br />
<br />
编辑器限制原因不能使用默认标题进行分步了，故使用1、2、3等小数字代替。<br />
<br />
安装Homebrew<br />
<br />
在安装之前需要从系统信息中查看芯片为Intel/M系列<br />
<br />
Intel使用<br />
<br />
<code>/bin/zsh -c "$(curl -fsSL <nowiki>https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh</nowiki>)"</code><br />
<br />
Intel按照脚本提示，选源，输密码，回车一路绿灯就好了，如果这都不会......可能你不是很适合开发，因为该脚本是国内开发者编写的，中文和一键化安装都集齐了。<br />
<br />
M系列使用<br />
<br />
<code>/bin/zsh -c "$(curl -fsSL https://gitee.com/huwei1024/HomebrewCN/raw/master/Homebrew.sh)"</code><br />
<br />
并且因为M系列系统结构发生改变，包安装位置不在是以前的/usr/local/，而是在/opt/homebrew，所以要将配置文件里的环境变量改过来。<br />
<br />
1.首先进入根目录<br />
<br />
<code>cd ~</code><br />
<br />
2.创建.zshrc文件<br />
<br />
<code>touch .zshrc</code><br />
<br />
3.打开文件进行编辑<br />
<br />
<code>open -e .zshrc</code><br />
<br />
4.如果有旧的环境就修改，没有就新增<br />
<br />
<code>export PATH="/opt/homebrew/bin:$PATH"<br />
<br />
export PATH="/opt/homebrew/sbin:$PATH"</code><br />
<br />
5.保存<br />
<br />
使用command + s<br />
<br />
6.生效环境变量<br />
<br />
<code>source .zshrc</code><br />
<br />
7、测试<br />
<br />
<code>brew -v</code><br />
<br />
若终端顺利打印出brew的版本，那么就安装成功了！<br />
<br />
注：本人没有使用过M系列设备，该教程在知乎上找到的<br />
<br />
使用Homebrew安装GPG<br />
<br />
<code>brew install gnupg pinentry-mac</code><br />
<br />
[[文件:截屏2024-02-17 17.34.48.png|居中]]<br />
<br />
为GPG添加环境变量，否则在签名的时候会发生报错（使用bash请自行替换配置文件）<br />
<br />
<code>echo "export GPG_TTY=$(tty)" >> ~/.zshrc<br />
source ~/.zshrc<br />
</code><br />
<br />
生成一个GPG keys<br />
<br />
<code>gpg --full-generate-key</code><br />
<br />
[[文件:截屏2024-02-17 17.45.51.png|居中]]<br />
<br />
默认使用的是ECC，我使用的是RSA，按照自己喜好，或从百度搜索非对称和对称加密算法之间的区别，这里只做使用方法的介绍，不做赘述。<br />
<br />
然后添写密钥长度和使用有效期，这里建议选择长期，并做备份，一辈子用一个就够了。<br />
<br />
[[文件:截屏2024-02-17 17.46.06.png|居中]]<br />
[[文件:截屏2024-02-17 17.46.35.png|居中]]<br />
<br />
个人信息按照Github信息填写，真实姓名对应Username。填写完毕按回车输入O即可生成密钥。不出意外的话会弹出Gui窗口让你设置密钥密码，强烈建设设置一个较为复杂的密码，并牢记，当然也可以不设置。<br />
<br />
使用GPG对Git的commit和tag进行签名<br />
<br />
先为Git定义GPG二进制所在地<br />
<br />
<code>git config --global gpg.program $(which gpg)</code><br />
<br />
查看GPG keys ID<br />
<br />
<code>gpg --list-secret-keys --keyid-format=long</code><br />
<br />
如图所示RSA/后面紧跟的一串就是GPG keys ID<br />
[[文件:截屏2024-02-17 17.57.01.png|居中]]<br />
<code>git config --global user.signingkey "GPG key ID"</code><br />
<br />
为Git设置全局commit和tag签名<br />
<br />
<code>git config --global commit.gpgsign true<br />
<br />
git config --global tag.gpgSign true</code><br />
<br />
参见本文“在Github配置GPG keys”部分开启下一步操作<br />
<br />
接下来就可以愉快的编写程序了~<br />
<br />
======在Github配置GPG keys======<br />
在终端输入<br />
<br />
gpg --armor --export "GPG key ID"<br />
<br />
将输出的内容从-----BEGIN PGP PUBLIC KEY BLOCK-----到-----END PGP PUBLIC KEY BLOCK-----，包含它们都复制下来。<br />
<br />
打开Github网页，并登录自己的账号。按照下述操作依次执行。<br />
头像-->Setting-->SSH and GPG keys-->New GPG key，标题自己怎么舒服怎么来，将第一步复制的内容全部粘贴然后保存起来，这样Github就能识别到你commit中包含的GPG sign的信息了，你就可以在commit history或release等页面看到绿色的签名后的标志了。<br />
<br />
==== 参考资料： ====<br />
[1] 百度百科 -- Git：<nowiki>https://baike.baidu.com/item/GIT/12647237?fr=ge_ala</nowiki><br />
<br />
[2] 菜鸟教程 -- Git基本操作：<nowiki>https://www.runoob.com/git/git-basic-operations.html</nowiki><br />
<br />
[3] CSDN -- git merge 使用简介: <nowiki>https://blog.csdn.net/All_In_gzx_cc/article/details/125482617</nowiki><br />
<br />
[3] 知乎 -- MAC 安装 homebrew 国内镜像: <nowiki>https://zhuanlan.zhihu.com/p/547898033</nowiki></div>
XiaoleGun
https://wiki.uotan.cn/index.php?title=Git%E4%BD%BF%E7%94%A8%E6%95%99%E7%A8%8B&diff=519
Git使用教程
2024-02-17T10:25:01Z
<p>XiaoleGun：补充GPG key</p>
<hr />
<div>=== Git的由来： ===<br />
Git是一个开源的分布式版本控制系统，可以有效、高速地处理从很小到非常大的项目版本管理，也是Linus Torvalds为了帮助管理Linux内核开发而开发的一个开放源码的版本控制软件。Torvalds 开始着手开发 Git 是为了作为一种过渡方案来替代 BitKeeper。<br />
<br />
=== 常见的代码托管平台： ===<br />
[https://github.com Github]<br />
<br />
[https://gitlab.com Gitlab]<br />
<br />
[https://gitee.com Gitee]<br />
<br />
=== Git 常见命令: ===<br />
<br />
==== git init ====<br />
在本地目录中初始化一个新的Git仓库<br />
<br />
==== git config ====<br />
用于配置用户的信息以及其他设置,在使用git之前您必须完成以下步骤。<br />
<br />
<code>git config --global user.name "your username"</code><br />
<br />
<code>git config --global user.email "your email"</code><br />
<br />
<br />
更改默认编辑器<br />
<br />
<code>git config --global core.editor nano</code><br />
<br />
==== git clone ====<br />
用于将远程仓库的代码克隆到本地，以下是命令中各个参数的含义：<br />
<br />
<code><url></code><br />
<br />
克隆某个地址(url)的仓库，远程仓库的地址可以是本地的目录，也可以是例如github,giteee,gitlab一类的代码托管平台<br />
<br />
<code>--depth=<number></code><br />
<br />
克隆仓库并且保留number条提交历史，number在此处即表达我们克隆的深度。<br />
<br />
<code>-b <branch></code><br />
<br />
克隆指定分支下的仓库内容<br />
<br />
例如我们要克隆<code>LineageOS</code>的内核源码，指定<code>lineage-21</code>分支，且仅保留最近一个提交，则需要输入:<br />
<br />
<code>git clone -b lineage-21 <nowiki>https://github.com/LineageOS/android_kernel_xiaomi_sdm845</nowiki> --depth=1</code><br />
<br />
==== git add ====<br />
添加某个文件，或者目录到暂存区，用于告诉git你需要将哪些文件的更改包含在下一次的提交(commit)之中添加一个或者多个文件到暂存区之中<br />
<br />
<code>git add [file1] [file2]</code><br />
<br />
添加指定目录(文件)到暂存区，包括子目录：<br />
<br />
<code>git add [dir]</code><br />
<br />
添加当前目录下的所有文件到暂存区：<br />
<br />
<code>git add .</code><br />
<br />
==== git status ====<br />
查看当前仓库的状态，此时git会在你的终端输出以下内容<br />
<p><em style="color: gray;">此处演示为英文，如果您的git终端输出为中文也是同理的</em></p><br />
<pre><br />
On branch master<br />
No commits yet<br />
Changes to be committed: <br />
<br />
(use “git rm --cached <file>...” to unstage) <br />
new file: makefile<br />
</pre><br />
<br />
输出内容分别为<br />
<pre><br />
您目前所在的分支<br />
目前的提交<br />
需要更改的内容<br />
新增的文件<br />
修改的文件<br />
删除的文件<br />
</pre><br />
<br />
==== git commit ====<br />
用于将暂存区我们保存的更改文件添加到本地仓库，并且会生成一条提交（commit）<br />
<br />
提交暂存区的更改到本地仓库<br />
<br />
<code>git commit -m "message"</code><br />
<br />
[注] message 可以是你的备注信息<br />
<br />
提交暂存区中的指定文件到本地仓库<br />
<br />
如果你没有使用上述<code>git add</code>命令暂存你的修改文件，可以使用<br />
<br />
<code>git commit -a</code><br />
<br />
进行直接提交<br />
<br />
==== git checkout ====<br />
<br />
* 用于分支切换<br />
<br />
切换分支：<br />
<br />
<code>git checkout <branch-name></code><br />
<br />
<code>git checkout <branch-name></code><br />
<br />
例如在您的仓库中有这几个分支：<br />
<pre><br />
-> master (Default)<br />
backup<br />
test<br />
</pre><br />
您当前处于 master 分支，如果想要切换到test分支，我们可以使用<br />
<br />
<code>git checkout test</code><br />
<br />
* 用于检出文件<br />
将指定的文件恢复到最新的提交状态，撤销你对其的更改<br />
<br />
<code>git checkout -- <file></code><br />
<br />
==== git push ====<br />
用于将本地的分支版本上传到远程仓库并进行合并<br />
<br />
<code>git push <remote-host-name> <local-branch-name>:<remote-branch-name></code><br />
<br />
remote-host-name:远程主机名<br />
<br />
local-branch-name:本地分支名<br />
<br />
例如，当你的远程主机名为origin ，本地分支名为master，远程分支名为master时：<br />
<br />
<code>git push origin master:master</code><br />
<br />
例如，当你的rhost名为origin 本地分支名为master远程分支名为master时：<br />
<br />
本地和远程分支名相同，上述命令可以简写为：<br />
<br />
<code>git push origin master</code><br />
<br />
当你的远程版本与本地版本有差异，无法直接push时，你可以使用--force 参数来进行强制推送<br />
<br />
<code>git push --force origin master</code><br />
<br />
--force 此处可以直接简单化为 -f <br />
<br />
如果你想要删除主机内的某个分支，你可以使用--delete参数<br />
<br />
<code>git push origin --delete <branch-name></code><br />
<br />
==== git diff ====<br />
用于比较当前工作区与上一个版本之间的差异<br />
<br />
例如：（此处仅做不恰当举例，Makefile不是这样乱写的）<br />
<pre><br />
diff --git a/makefile b/makefile<br />
<br />
index fbb8c85..d65c7eb 100644<br />
<br />
--- a/makefile<br />
<br />
+++ b/makefile<br />
<br />
@@ -1 +1,2 @@<br />
<br />
114514<br />
<br />
+1919180<br />
</pre><br />
<br />
==== git log ====<br />
用于查看提交的历史<br />
<br />
例如当你进行一次提交之后，执行 <code>git log</code>终端会输出<br />
<br />
<pre><br />
commit 3a5b0d12f471418b13f2baf5e9e4c112a5e804a8 (HEAD -> master)<br />
<br />
Author: luluzzy <1054438588@qq.com><br />
<br />
Date: Thu Feb 15 21:28:47 2024 +0800<br />
<br />
initial commit: add makefile<br />
</pre><br />
<br />
这些输出分别为<br />
<pre><br />
commit sha1 hash: 针对你这个提交的 commit id<br />
Author: commit 作者名称 <you@example.com><br />
Date: commit 日期<br />
commit: 名称<br />
</pre><br />
<br />
关于sha1_hash的介绍请看这里<ref>生成这个hash值，它是对那个commit是Git仓库中内容和头信息Header的一个校验和checksum。Linux kernel开创者和Git的开发者——Linus说，Git使用了sha1并非是为了安全性，而是为了数据的完整性；它可以保证，在很多年后，你重新checkout某个commit时，一定是它多年前的当时的状态，完全一摸一样，完全值得信任。在Git中，根据commit的sha1值40个十六进制数字进行了简单的划分目录，以前2位数字作为目录名，其下面是剩余38位数字组成的一个文件名</ref><br />
<br />
当有多次提交之后，如果我们想要翻之前的提交历史，难免会因为终端输出的内容过多而难以查看翻阅<br />
<br />
此时我们可以使用<code>--online</code>参数来简化输出，此时仅会输出: sha1哈希值 + commit的名称<br />
<br />
例如<br />
<pre><br />
347595d (HEAD -> master) modify makefile<br />
<br />
3a5b0d1 initial commit: add makefile<br />
</pre><br />
<br />
==== git cherry-pick ====<br />
<br />
<br />
cherry-pick (遴选) 和它的名称一样，挑选一个我们需要的 commit 进行操作。它可以用于将在其他分支上的 commit 修改，移植到当前的分支。<br />
<br />
如果我们想在我们正在开发的版本上，添加一个其他版本中的功能代码。就可以使用 cherry-pick ，将这个功能相关的 commit 提取出来，合入该版本。<br />
<br />
<code>git cherry-pick <commit-id></code><br />
<br />
<br />
当我们执行完 <code>cherry-pick</code>操作之后，会自动生成一个<code>commit</code>以及对应新的<code>commit-id</code><br />
<br />
在顺利的情况下我们可以直接通过，但如果遇到代码等因为变量名，写法等不同的情况，<code>cherry-pick</code>大概率会报错，此时我们需要进行报错处理。<br />
<br />
第一种方案是手动修改<br />
<br />
我们可以先使用<code>git status</code>检查当前遴选时冲突的文件<br />
<br />
然后 <code>git checkout --ours filename</code><br />
<br />
然后按照提交的修改内容进行手动修改<br />
<br />
随后使用<code>git add</code>命令将文件重新加入暂存区<br />
<br />
再使用<br />
<br />
<code>git cherry-pick --continue</code><br />
<br />
命令让 cherrypick 操作继续执行。<br />
<br />
第二种方案是直接退出<code>cherry-pick</code>进程，一般适用于冲突文件实在太多了难以按照方案一处理的情况。<br />
<br />
需要注意的是，如果您当前正在遴选的提交在该分支已经存在也会冲突，在这种情况下，您需要解决冲突并手动解决问题。<br />
<br />
<code>git cherry-pick --abort</code><br />
<br />
==== git fetch ====<br />
git fetch 命令用于从远程获取仓库。<br />
<br />
==== git merge ====<br />
<code>git merge</code>是用来把分叉的提交历史放回到一起(合并)的方式。<br />
<br />
git merge命令用来将你之前使用git branch命令创建的分支以及在此分支上独立开发的内容整合为一个分支。<br />
<br />
本<br />
<br />
==== git pull ====<br />
用于从远程获取代码并合并本地的版本。<br />
<br />
<code>git pull</code>其实就是<code>git fetch</code>和<code>git merge FETCH_HEAD</code> 的简写。<br />
<br />
格式如下：<br />
<br />
<code>git pull <remote-host-name> <remote-branch-name>:<local-branch-name></code><br />
<br />
==== git rebase ====<br />
用于需要修改历史上某一项commit<br />
<br />
<code>git rebase -i HEAD~<commit number></code><br />
<br />
commit number就是从头部往前数的commit数量。执行后会弹出你在git config内配置的编辑器，若未配置则是默认，vim居多。然后就可以看见一堆commit前面有pick字样。可以将pick替换为你想要的操作。<br />
有以下操作：<br />
<br />
1.edit，顾名思义编辑此commit，替换完保存后请修改内容，使用<code>git add</code>或vscode，github desktop将修改文件添加到暂存区，之后命令行执行<code>git commit --amend</code>这样commit就修改成了<br />
<br />
2.squash，合并几个提交，确认一个父提交，将要合并的commit，从下向上替换字符串，会从下向上合并(方位指的是<code>git rebase</code>后弹出的编辑器)<br />
<br />
3.drop，需要移除的commit<br />
<br />
==== git subtree ====<br />
子树，在Android开发中多用于Kernel侧更改，如跟踪audio模块等<br />
<br />
<code>git subtree add --prefix=<目录> <仓库地址> <远程分支></code><br />
<br />
如果需要更新远程库时<br />
<br />
<code>git subtree pull --prefix=<目录> <仓库地址> <远程分支></code><br />
<br />
==== git submodule ====<br />
<br />
===== 子模块功能的概述 =====<br />
<code>git submodule</code>允许在自己的Github仓库里加入别人的github仓库，作为自己仓库的子仓库(即submodule)。<br />
<br />
为什么我们会需要使用子模块？当我们维护一个项目时有可能遇到以下情况，例如维护某款机型的KernelSU内核，我们需要将KernelSU导入至我们的内核源码中，如果我们直接clone进去容易带来一个问题，如果KernelSU更新了怎么办？此时我们便可以使用子模块来解决这个问题<br />
<br />
<code>git submodule</code>允许在git仓库里存放别人仓库的url，作为自己的子模块，其核心内容是在Git仓库里面加入一个<code>.gitmodules</code>文件，里面会记录各个submodule的名字，路径，以及对应链接。<br />
<br />
===== 加入子模块 =====<br />
<code>git submodule add <url> <path></code><br />
<br />
此时 <code>.gitmodules</code>内会自动生成以下内容<br />
<br />
[submodule "xxx"]<br />
<br />
path = xxx<br />
<br />
url = xxx<br />
<br />
===== 初始化子模块 =====<br />
<code>git submodule init</code><br />
<br />
===== 更新子模块 =====<br />
<code>git submodule update</code><br />
<br />
=== Git进阶 ===<br />
<br />
==== GPG key ====<br />
<br />
===== 简介 =====<br />
平时在Github上摸鱼的时候，是不是经常能看见如下图所示，有一个绿色的"Verified"字样，看着很酷，实际上这是为了确保commit为开发者本人所写的进行的GPG签名。<br />
[[文件:Github GPG sign.png|居中]]<br />
因为Git的默认机制，任何人都可以通过你的邮箱和用户名创建虚假的commit，甚至你名气很大的话可以“栽赃陷害”你。如果你是某高校计算机专业的同学亦或是对计算机抱有很大的兴趣，乐意为开源社区提供“资源”，那么我建议你设置GPG sign。未来是不可预知的，人人都可能成为巨佬。<br />
<br />
===== 使用 =====<br />
因为我只在Mac环境下配置过GPG，Windows只是打游戏用，所以用的少，Linux/类Unix可以参考一下。其它系统等待他人补充......<br />
<br />
====== Mac ======<br />
Mac默认是不带GPG的，需要通过第三方软件包安装器Homebrew进行安装，首先先安装Homebrew，如已安装可以跳过。<br />
<br />
编辑器限制原因不能使用默认标题进行分步了，故使用1、2、3等小数字代替。<br />
<br />
安装Homebrew<br />
<br />
在安装之前需要从系统信息中查看芯片为Intel/M系列<br />
<br />
Intel使用<br />
<br />
<code>/bin/zsh -c "$(curl -fsSL <nowiki>https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh</nowiki>)"</code><br />
<br />
Intel按照脚本提示，选源，输密码，回车一路绿灯就好了，如果这都不会......可能你不是很适合开发，因为该脚本是国内开发者编写的，中文和一键化安装都集齐了。<br />
<br />
M系列使用<br />
<br />
<code>/bin/zsh -c "$(curl -fsSL https://gitee.com/huwei1024/HomebrewCN/raw/master/Homebrew.sh)"</code><br />
<br />
并且因为M系列系统结构发生改变，包安装位置不在是以前的/usr/local/，而是在/opt/homebrew，所以要将配置文件里的环境变量改过来。<br />
<br />
1.首先进入根目录<br />
<br />
<code>cd ~</code><br />
<br />
2.创建.zshrc文件<br />
<br />
<code>touch .zshrc</code><br />
<br />
3.打开文件进行编辑<br />
<br />
<code>open -e .zshrc</code><br />
<br />
4.如果有旧的环境就修改，没有就新增<br />
<br />
<code>export PATH="/opt/homebrew/bin:$PATH"<br />
<br />
export PATH="/opt/homebrew/sbin:$PATH"</code><br />
<br />
5.保存<br />
<br />
使用command + s<br />
<br />
6.生效环境变量<br />
<br />
<code>source .zshrc</code><br />
<br />
7、测试<br />
<br />
<code>brew -v</code><br />
<br />
若终端顺利打印出brew的版本，那么就安装成功了！<br />
<br />
注：本人没有使用过M系列设备，该教程在知乎上找到的<br />
<br />
使用Homebrew安装GPG<br />
<br />
<code>brew install gnupg pinentry-mac</code><br />
<br />
[[文件:截屏2024-02-17 17.34.48.png|居中]]<br />
<br />
为GPG添加环境变量，否则在签名的时候会发生报错（使用bash请自行替换配置文件）<br />
<br />
<code>echo "export GPG_TTY=$(tty)" >> ~/.zshrc<br />
source ~/.zshrc<br />
</code><br />
<br />
生成一个GPG keys<br />
<br />
<code>gpg --full-generate-key</code><br />
<br />
[[文件:截屏2024-02-17 17.45.51.png|居中]]<br />
<br />
默认使用的是ECC，我使用的是RSA，按照自己喜好，或从百度搜索非对称和对称加密算法之间的区别，这里只做使用方法的介绍，不做赘述。<br />
<br />
然后添写密钥长度和使用有效期，这里建议选择长期，并做备份，一辈子用一个就够了。<br />
<br />
[[文件:截屏2024-02-17 17.46.06.png|居中]]<br />
[[文件:截屏2024-02-17 17.46.35.png|居中]]<br />
<br />
个人信息按照Github信息填写，真实姓名对应Username。填写完毕按回车输入O即可生成密钥。不出意外的话会弹出Gui窗口让你设置密钥密码，强烈建设设置一个较为复杂的密码，并牢记，当然也可以不设置。<br />
<br />
使用GPG对Git的commit和tag进行签名<br />
<br />
先为Git定义GPG二进制所在地<br />
<br />
<code>git config --global gpg.program $(which gpg)</code><br />
<br />
查看GPG keys ID<br />
<br />
<code>gpg --list-secret-keys --keyid-format=long</code><br />
<br />
如图所示RSA/后面紧跟的一串就是GPG keys ID<br />
[[文件:截屏2024-02-17 17.57.01.png|居中]]<br />
<code>git config --global user.signingkey "GPG key ID"</code><br />
<br />
为Git设置全局commit和tag签名<br />
<br />
<code>git config --global commit.gpgsign true<br />
<br />
git config --global tag.gpgSign true</code><br />
<br />
参见<br />
<br />
接下来就可以愉快的编写程序了~<br />
<br />
======在Github配置GPG keys======<br />
在终端输入<br />
<br />
gpg --armor --export "GPG key ID"<br />
<br />
将输出的内容从-----BEGIN PGP PUBLIC KEY BLOCK-----到-----END PGP PUBLIC KEY BLOCK-----，包含它们都复制下来。<br />
<br />
打开Github网页，并登录自己的账号。按照下述操作依次执行。<br />
头像-->Setting-->SSH and GPG keys-->New GPG key，标题自己怎么舒服怎么来，将第一步复制的内容全部粘贴然后保存起来，这样Github就能识别到你commit中包含的GPG sign的信息了，你就可以在commit history或release等页面看到绿色的签名后的标志了。<br />
<br />
==== 参考资料： ====<br />
[1] 百度百科 -- Git：<nowiki>https://baike.baidu.com/item/GIT/12647237?fr=ge_ala</nowiki><br />
<br />
[2] 菜鸟教程 -- Git基本操作：<nowiki>https://www.runoob.com/git/git-basic-operations.html</nowiki><br />
<br />
[3] CSDN -- git merge 使用简介: <nowiki>https://blog.csdn.net/All_In_gzx_cc/article/details/125482617</nowiki><br />
<br />
[3] 知乎 -- MAC 安装 homebrew 国内镜像: <nowiki>https://zhuanlan.zhihu.com/p/547898033</nowiki></div>
XiaoleGun
https://wiki.uotan.cn/index.php?title=Git%E4%BD%BF%E7%94%A8%E6%95%99%E7%A8%8B&diff=518
Git使用教程
2024-02-17T10:00:14Z
<p>XiaoleGun：添加GPG key</p>
<hr />
<div>=== Git的由来： ===<br />
Git是一个开源的分布式版本控制系统，可以有效、高速地处理从很小到非常大的项目版本管理，也是Linus Torvalds为了帮助管理Linux内核开发而开发的一个开放源码的版本控制软件。Torvalds 开始着手开发 Git 是为了作为一种过渡方案来替代 BitKeeper。<br />
<br />
=== 常见的代码托管平台： ===<br />
[https://github.com Github]<br />
<br />
[https://gitlab.com Gitlab]<br />
<br />
[https://gitee.com Gitee]<br />
<br />
=== Git 常见命令: ===<br />
<br />
==== git init ====<br />
在本地目录中初始化一个新的Git仓库<br />
<br />
==== git config ====<br />
用于配置用户的信息以及其他设置,在使用git之前您必须完成以下步骤。<br />
<br />
<code>git config --global user.name "your username"</code><br />
<br />
<code>git config --global user.email "your email"</code><br />
<br />
<br />
更改默认编辑器<br />
<br />
<code>git config --global core.editor nano</code><br />
<br />
==== git clone ====<br />
用于将远程仓库的代码克隆到本地，以下是命令中各个参数的含义：<br />
<br />
<code><url></code><br />
<br />
克隆某个地址(url)的仓库，远程仓库的地址可以是本地的目录，也可以是例如github,giteee,gitlab一类的代码托管平台<br />
<br />
<code>--depth=<number></code><br />
<br />
克隆仓库并且保留number条提交历史，number在此处即表达我们克隆的深度。<br />
<br />
<code>-b <branch></code><br />
<br />
克隆指定分支下的仓库内容<br />
<br />
例如我们要克隆<code>LineageOS</code>的内核源码，指定<code>lineage-21</code>分支，且仅保留最近一个提交，则需要输入:<br />
<br />
<code>git clone -b lineage-21 <nowiki>https://github.com/LineageOS/android_kernel_xiaomi_sdm845</nowiki> --depth=1</code><br />
<br />
==== git add ====<br />
添加某个文件，或者目录到暂存区，用于告诉git你需要将哪些文件的更改包含在下一次的提交(commit)之中添加一个或者多个文件到暂存区之中<br />
<br />
<code>git add [file1] [file2]</code><br />
<br />
添加指定目录(文件)到暂存区，包括子目录：<br />
<br />
<code>git add [dir]</code><br />
<br />
添加当前目录下的所有文件到暂存区：<br />
<br />
<code>git add .</code><br />
<br />
==== git status ====<br />
查看当前仓库的状态，此时git会在你的终端输出以下内容<br />
<p><em style="color: gray;">此处演示为英文，如果您的git终端输出为中文也是同理的</em></p><br />
<pre><br />
On branch master<br />
No commits yet<br />
Changes to be committed: <br />
<br />
(use “git rm --cached <file>...” to unstage) <br />
new file: makefile<br />
</pre><br />
<br />
输出内容分别为<br />
<pre><br />
您目前所在的分支<br />
目前的提交<br />
需要更改的内容<br />
新增的文件<br />
修改的文件<br />
删除的文件<br />
</pre><br />
<br />
==== git commit ====<br />
用于将暂存区我们保存的更改文件添加到本地仓库，并且会生成一条提交（commit）<br />
<br />
提交暂存区的更改到本地仓库<br />
<br />
<code>git commit -m "message"</code><br />
<br />
[注] message 可以是你的备注信息<br />
<br />
提交暂存区中的指定文件到本地仓库<br />
<br />
如果你没有使用上述<code>git add</code>命令暂存你的修改文件，可以使用<br />
<br />
<code>git commit -a</code><br />
<br />
进行直接提交<br />
<br />
==== git checkout ====<br />
<br />
* 用于分支切换<br />
<br />
切换分支：<br />
<br />
<code>git checkout <branch-name></code><br />
<br />
<code>git checkout <branch-name></code><br />
<br />
例如在您的仓库中有这几个分支：<br />
<pre><br />
-> master (Default)<br />
backup<br />
test<br />
</pre><br />
您当前处于 master 分支，如果想要切换到test分支，我们可以使用<br />
<br />
<code>git checkout test</code><br />
<br />
* 用于检出文件<br />
将指定的文件恢复到最新的提交状态，撤销你对其的更改<br />
<br />
<code>git checkout -- <file></code><br />
<br />
==== git push ====<br />
用于将本地的分支版本上传到远程仓库并进行合并<br />
<br />
<code>git push <remote-host-name> <local-branch-name>:<remote-branch-name></code><br />
<br />
remote-host-name:远程主机名<br />
<br />
local-branch-name:本地分支名<br />
<br />
例如，当你的远程主机名为origin ，本地分支名为master，远程分支名为master时：<br />
<br />
<code>git push origin master:master</code><br />
<br />
例如，当你的rhost名为origin 本地分支名为master远程分支名为master时：<br />
<br />
本地和远程分支名相同，上述命令可以简写为：<br />
<br />
<code>git push origin master</code><br />
<br />
当你的远程版本与本地版本有差异，无法直接push时，你可以使用--force 参数来进行强制推送<br />
<br />
<code>git push --force origin master</code><br />
<br />
--force 此处可以直接简单化为 -f <br />
<br />
如果你想要删除主机内的某个分支，你可以使用--delete参数<br />
<br />
<code>git push origin --delete <branch-name></code><br />
<br />
==== git diff ====<br />
用于比较当前工作区与上一个版本之间的差异<br />
<br />
例如：（此处仅做不恰当举例，Makefile不是这样乱写的）<br />
<pre><br />
diff --git a/makefile b/makefile<br />
<br />
index fbb8c85..d65c7eb 100644<br />
<br />
--- a/makefile<br />
<br />
+++ b/makefile<br />
<br />
@@ -1 +1,2 @@<br />
<br />
114514<br />
<br />
+1919180<br />
</pre><br />
<br />
==== git log ====<br />
用于查看提交的历史<br />
<br />
例如当你进行一次提交之后，执行 <code>git log</code>终端会输出<br />
<br />
<pre><br />
commit 3a5b0d12f471418b13f2baf5e9e4c112a5e804a8 (HEAD -> master)<br />
<br />
Author: luluzzy <1054438588@qq.com><br />
<br />
Date: Thu Feb 15 21:28:47 2024 +0800<br />
<br />
initial commit: add makefile<br />
</pre><br />
<br />
这些输出分别为<br />
<pre><br />
commit sha1 hash: 针对你这个提交的 commit id<br />
Author: commit 作者名称 <you@example.com><br />
Date: commit 日期<br />
commit: 名称<br />
</pre><br />
<br />
关于sha1_hash的介绍请看这里<ref>生成这个hash值，它是对那个commit是Git仓库中内容和头信息Header的一个校验和checksum。Linux kernel开创者和Git的开发者——Linus说，Git使用了sha1并非是为了安全性，而是为了数据的完整性；它可以保证，在很多年后，你重新checkout某个commit时，一定是它多年前的当时的状态，完全一摸一样，完全值得信任。在Git中，根据commit的sha1值40个十六进制数字进行了简单的划分目录，以前2位数字作为目录名，其下面是剩余38位数字组成的一个文件名</ref><br />
<br />
当有多次提交之后，如果我们想要翻之前的提交历史，难免会因为终端输出的内容过多而难以查看翻阅<br />
<br />
此时我们可以使用<code>--online</code>参数来简化输出，此时仅会输出: sha1哈希值 + commit的名称<br />
<br />
例如<br />
<pre><br />
347595d (HEAD -> master) modify makefile<br />
<br />
3a5b0d1 initial commit: add makefile<br />
</pre><br />
<br />
==== git cherry-pick ====<br />
<br />
<br />
cherry-pick (遴选) 和它的名称一样，挑选一个我们需要的 commit 进行操作。它可以用于将在其他分支上的 commit 修改，移植到当前的分支。<br />
<br />
如果我们想在我们正在开发的版本上，添加一个其他版本中的功能代码。就可以使用 cherry-pick ，将这个功能相关的 commit 提取出来，合入该版本。<br />
<br />
<code>git cherry-pick <commit-id></code><br />
<br />
<br />
当我们执行完 <code>cherry-pick</code>操作之后，会自动生成一个<code>commit</code>以及对应新的<code>commit-id</code><br />
<br />
在顺利的情况下我们可以直接通过，但如果遇到代码等因为变量名，写法等不同的情况，<code>cherry-pick</code>大概率会报错，此时我们需要进行报错处理。<br />
<br />
第一种方案是手动修改<br />
<br />
我们可以先使用<code>git status</code>检查当前遴选时冲突的文件<br />
<br />
然后 <code>git checkout --ours filename</code><br />
<br />
然后按照提交的修改内容进行手动修改<br />
<br />
随后使用<code>git add</code>命令将文件重新加入暂存区<br />
<br />
再使用<br />
<br />
<code>git cherry-pick --continue</code><br />
<br />
命令让 cherrypick 操作继续执行。<br />
<br />
第二种方案是直接退出<code>cherry-pick</code>进程，一般适用于冲突文件实在太多了难以按照方案一处理的情况。<br />
<br />
需要注意的是，如果您当前正在遴选的提交在该分支已经存在也会冲突，在这种情况下，您需要解决冲突并手动解决问题。<br />
<br />
<code>git cherry-pick --abort</code><br />
<br />
==== git fetch ====<br />
git fetch 命令用于从远程获取仓库。<br />
<br />
==== git merge ====<br />
<code>git merge</code>是用来把分叉的提交历史放回到一起(合并)的方式。<br />
<br />
git merge命令用来将你之前使用git branch命令创建的分支以及在此分支上独立开发的内容整合为一个分支。<br />
<br />
本<br />
<br />
==== git pull ====<br />
用于从远程获取代码并合并本地的版本。<br />
<br />
<code>git pull</code>其实就是<code>git fetch</code>和<code>git merge FETCH_HEAD</code> 的简写。<br />
<br />
格式如下：<br />
<br />
<code>git pull <remote-host-name> <remote-branch-name>:<local-branch-name></code><br />
<br />
==== git rebase ====<br />
用于需要修改历史上某一项commit<br />
<br />
<code>git rebase -i HEAD~<commit number></code><br />
<br />
commit number就是从头部往前数的commit数量。执行后会弹出你在git config内配置的编辑器，若未配置则是默认，vim居多。然后就可以看见一堆commit前面有pick字样。可以将pick替换为你想要的操作。<br />
有以下操作：<br />
<br />
1.edit，顾名思义编辑此commit，替换完保存后请修改内容，使用<code>git add</code>或vscode，github desktop将修改文件添加到暂存区，之后命令行执行<code>git commit --amend</code>这样commit就修改成了<br />
<br />
2.squash，合并几个提交，确认一个父提交，将要合并的commit，从下向上替换字符串，会从下向上合并(方位指的是<code>git rebase</code>后弹出的编辑器)<br />
<br />
3.drop，需要移除的commit<br />
<br />
==== git subtree ====<br />
子树，在Android开发中多用于Kernel侧更改，如跟踪audio模块等<br />
<br />
<code>git subtree add --prefix=<目录> <仓库地址> <远程分支></code><br />
<br />
如果需要更新远程库时<br />
<br />
<code>git subtree pull --prefix=<目录> <仓库地址> <远程分支></code><br />
<br />
==== git submodule ====<br />
<br />
===== 子模块功能的概述 =====<br />
<code>git submodule</code>允许在自己的Github仓库里加入别人的github仓库，作为自己仓库的子仓库(即submodule)。<br />
<br />
为什么我们会需要使用子模块？当我们维护一个项目时有可能遇到以下情况，例如维护某款机型的KernelSU内核，我们需要将KernelSU导入至我们的内核源码中，如果我们直接clone进去容易带来一个问题，如果KernelSU更新了怎么办？此时我们便可以使用子模块来解决这个问题<br />
<br />
<code>git submodule</code>允许在git仓库里存放别人仓库的url，作为自己的子模块，其核心内容是在Git仓库里面加入一个<code>.gitmodules</code>文件，里面会记录各个submodule的名字，路径，以及对应链接。<br />
<br />
===== 加入子模块 =====<br />
<code>git submodule add <url> <path></code><br />
<br />
此时 <code>.gitmodules</code>内会自动生成以下内容<br />
<br />
[submodule "xxx"]<br />
<br />
path = xxx<br />
<br />
url = xxx<br />
<br />
===== 初始化子模块 =====<br />
<code>git submodule init</code><br />
<br />
===== 更新子模块 =====<br />
<code>git submodule update</code><br />
<br />
=== Git进阶 ===<br />
<br />
==== GPG key ====<br />
<br />
===== 简介 =====<br />
平时在Github上摸鱼的时候，是不是经常能看见如下图所示，有一个绿色的"Verified"字样，看着很酷，实际上这是为了确保commit为开发者本人所写的进行的GPG签名。<br />
[[文件:Github GPG sign.png|居中]]<br />
因为Git的默认机制，任何人都可以通过你的邮箱和用户名创建虚假的commit，甚至你名气很大的话可以“栽赃陷害”你。如果你是某高校计算机专业的同学亦或是对计算机抱有很大的兴趣，乐意为开源社区提供“资源”，那么我建议你设置GPG sign。未来是不可预知的，人人都可能成为巨佬。<br />
<br />
===== 使用 =====<br />
因为我只在Mac环境下配置过GPG，Windows只是打游戏用，所以用的少，Linux/类Unix可以参考一下。其它系统等待他人补充......<br />
<br />
====== Mac ======<br />
Mac默认是不带GPG的，需要通过第三方软件包安装器Homebrew进行安装，首先先安装Homebrew，如已安装可以跳过。<br />
<br />
编辑器限制原因不能使用默认标题进行分步了，故使用1、2、3等小数字代替。<br />
<br />
安装Homebrew<br />
<br />
在安装之前需要从系统信息中查看芯片为Intel/M系列<br />
<br />
Intel使用<br />
<br />
<code>/bin/zsh -c "$(curl -fsSL <nowiki>https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh</nowiki>)"</code><br />
<br />
Intel按照脚本提示，选源，输密码，回车一路绿灯就好了，如果这都不会......可能你不是很适合开发，因为该脚本是国内开发者编写的，中文和一键化安装都集齐了。<br />
<br />
M系列使用<br />
<br />
<code>/bin/zsh -c "$(curl -fsSL https://gitee.com/huwei1024/HomebrewCN/raw/master/Homebrew.sh)"</code><br />
<br />
并且因为M系列系统结构发生改变，包安装位置不在是以前的/usr/local/，而是在/opt/homebrew，所以要将配置文件里的环境变量改过来。<br />
<br />
1.首先进入根目录<br />
<br />
<code>cd ~</code><br />
<br />
2.创建.zshrc文件<br />
<br />
<code>touch .zshrc</code><br />
<br />
3.打开文件进行编辑<br />
<br />
<code>open -e .zshrc</code><br />
<br />
4.如果有旧的环境就修改，没有就新增<br />
<br />
<code>export PATH="/opt/homebrew/bin:$PATH"<br />
<br />
export PATH="/opt/homebrew/sbin:$PATH"</code><br />
<br />
5.保存<br />
<br />
使用command + s<br />
<br />
6.生效环境变量<br />
<br />
<code>source .zshrc</code><br />
<br />
7、测试<br />
<br />
<code>brew -v</code><br />
<br />
若终端顺利打印出brew的版本，那么就安装成功了！<br />
<br />
注：本人没有使用过M系列设备，该教程在知乎上找到的<br />
<br />
使用Homebrew安装GPG<br />
<br />
<code>brew install gnupg pinentry-mac</code><br />
<br />
[[文件:截屏2024-02-17 17.34.48.png|居中]]<br />
<br />
生成一个GPG keys<br />
<br />
<code>gpg --full-generate-key</code><br />
<br />
[[文件:截屏2024-02-17 17.45.51.png|居中]]<br />
<br />
默认使用的是ECC，我使用的是RSA，按照自己喜好，或从百度搜索非对称和对称加密算法之间的区别，这里只做使用方法的介绍，不做赘述。<br />
<br />
然后添写密钥长度和使用有效期，这里建议选择长期，并做备份，一辈子用一个就够了。<br />
<br />
[[文件:截屏2024-02-17 17.46.06.png|居中]]<br />
[[文件:截屏2024-02-17 17.46.35.png|居中]]<br />
<br />
个人信息按照Github信息填写，真实姓名对应Username。填写完毕按回车输入O即可生成密钥。不出意外的话会弹出Gui窗口让你设置密钥密码，强烈建设设置一个较为复杂的密码，并牢记，当然也可以不设置。<br />
<br />
使用GPG对Git的commit和tag进行签名<br />
<br />
先为Git定义GPG二进制所在地<br />
<br />
<code>git config --global gpg.program $(which gpg)</code><br />
<br />
查看GPG keys ID<br />
<br />
<code>gpg --list-secret-keys --keyid-format=long</code><br />
<br />
如图所示RSA/后面紧跟的一串就是GPG keys ID<br />
<br />
<code>git config --global user.signingkey "GPG key ID"</code><br />
<br />
==== 参考资料： ====<br />
[1] 百度百科 -- Git：<nowiki>https://baike.baidu.com/item/GIT/12647237?fr=ge_ala</nowiki><br />
<br />
[2] 菜鸟教程 -- Git基本操作：<nowiki>https://www.runoob.com/git/git-basic-operations.html</nowiki><br />
<br />
[3] CSDN -- git merge 使用简介: <nowiki>https://blog.csdn.net/All_In_gzx_cc/article/details/125482617</nowiki><br />
<br />
[3] 知乎 -- MAC 安装 homebrew 国内镜像: <nowiki>https://zhuanlan.zhihu.com/p/547898033</nowiki></div>
XiaoleGun
https://wiki.uotan.cn/index.php?title=%E6%96%87%E4%BB%B6:%E6%88%AA%E5%B1%8F2024-02-17_17.57.01.png&diff=517
文件:截屏2024-02-17 17.57.01.png
2024-02-17T09:57:26Z
<p>XiaoleGun：</p>
<hr />
<div>截屏2024-02-17 17.57.01</div>
XiaoleGun
https://wiki.uotan.cn/index.php?title=%E6%96%87%E4%BB%B6:%E6%88%AA%E5%B1%8F2024-02-17_17.46.35.png&diff=516
文件:截屏2024-02-17 17.46.35.png
2024-02-17T09:49:24Z
<p>XiaoleGun：</p>
<hr />
<div>截屏2024-02-17 17.46.35</div>
XiaoleGun
https://wiki.uotan.cn/index.php?title=%E6%96%87%E4%BB%B6:%E6%88%AA%E5%B1%8F2024-02-17_17.46.06.png&diff=515
文件:截屏2024-02-17 17.46.06.png
2024-02-17T09:48:57Z
<p>XiaoleGun：</p>
<hr />
<div>截屏2024-02-17 17.46.06</div>
XiaoleGun
https://wiki.uotan.cn/index.php?title=%E6%96%87%E4%BB%B6:%E6%88%AA%E5%B1%8F2024-02-17_17.45.51.png&diff=514
文件:截屏2024-02-17 17.45.51.png
2024-02-17T09:47:35Z
<p>XiaoleGun：</p>
<hr />
<div>截屏2024-02-17 17.45.51</div>
XiaoleGun
https://wiki.uotan.cn/index.php?title=%E6%96%87%E4%BB%B6:%E6%88%AA%E5%B1%8F2024-02-17_17.34.48.png&diff=513
文件:截屏2024-02-17 17.34.48.png
2024-02-17T09:35:10Z
<p>XiaoleGun：</p>
<hr />
<div>截屏2024-02-17 17.34.48</div>
XiaoleGun
https://wiki.uotan.cn/index.php?title=%E6%96%87%E4%BB%B6:Github_GPG_sign.png&diff=512
文件:Github GPG sign.png
2024-02-17T09:10:17Z
<p>XiaoleGun：</p>
<hr />
<div>Github GPG sign</div>
XiaoleGun
https://wiki.uotan.cn/index.php?title=Git%E4%BD%BF%E7%94%A8%E6%95%99%E7%A8%8B&diff=511
Git使用教程
2024-02-17T08:59:32Z
<p>XiaoleGun：fixup: 添加修改默认编辑器命令</p>
<hr />
<div>=== Git的由来： ===<br />
Git是一个开源的分布式版本控制系统，可以有效、高速地处理从很小到非常大的项目版本管理，也是Linus Torvalds为了帮助管理Linux内核开发而开发的一个开放源码的版本控制软件。Torvalds 开始着手开发 Git 是为了作为一种过渡方案来替代 BitKeeper。<br />
<br />
=== 常见的代码托管平台： ===<br />
[https://github.com Github]<br />
<br />
[https://gitlab.com Gitlab]<br />
<br />
[https://gitee.com Gitee]<br />
<br />
=== Git 常见命令: ===<br />
<br />
==== git init ====<br />
在本地目录中初始化一个新的Git仓库<br />
<br />
==== git config ====<br />
用于配置用户的信息以及其他设置,在使用git之前您必须完成以下步骤。<br />
<br />
<code>git config --global user.name "your username"</code><br />
<br />
<code>git config --global user.email "your email"</code><br />
<br />
<br />
更改默认编辑器<br />
<br />
<code>git config --global core.editor nano</code><br />
<br />
==== git clone ====<br />
用于将远程仓库的代码克隆到本地，以下是命令中各个参数的含义：<br />
<br />
<code><url></code><br />
<br />
克隆某个地址(url)的仓库，远程仓库的地址可以是本地的目录，也可以是例如github,giteee,gitlab一类的代码托管平台<br />
<br />
<code>--depth=<number></code><br />
<br />
克隆仓库并且保留number条提交历史，number在此处即表达我们克隆的深度。<br />
<br />
<code>-b <branch></code><br />
<br />
克隆指定分支下的仓库内容<br />
<br />
例如我们要克隆<code>LineageOS</code>的内核源码，指定<code>lineage-21</code>分支，且仅保留最近一个提交，则需要输入:<br />
<br />
<code>git clone -b lineage-21 <nowiki>https://github.com/LineageOS/android_kernel_xiaomi_sdm845</nowiki> --depth=1</code><br />
<br />
==== git add ====<br />
添加某个文件，或者目录到暂存区，用于告诉git你需要将哪些文件的更改包含在下一次的提交(commit)之中添加一个或者多个文件到暂存区之中<br />
<br />
<code>git add [file1] [file2]</code><br />
<br />
添加指定目录(文件)到暂存区，包括子目录：<br />
<br />
<code>git add [dir]</code><br />
<br />
添加当前目录下的所有文件到暂存区：<br />
<br />
<code>git add .</code><br />
<br />
==== git status ====<br />
查看当前仓库的状态，此时git会在你的终端输出以下内容<br />
<p><em style="color: gray;">此处演示为英文，如果您的git终端输出为中文也是同理的</em></p><br />
<pre><br />
On branch master<br />
No commits yet<br />
Changes to be committed: <br />
<br />
(use “git rm --cached <file>...” to unstage) <br />
new file: makefile<br />
</pre><br />
<br />
输出内容分别为<br />
<pre><br />
您目前所在的分支<br />
目前的提交<br />
需要更改的内容<br />
新增的文件<br />
修改的文件<br />
删除的文件<br />
</pre><br />
<br />
==== git commit ====<br />
用于将暂存区我们保存的更改文件添加到本地仓库，并且会生成一条提交（commit）<br />
<br />
提交暂存区的更改到本地仓库<br />
<br />
<code>git commit -m "message"</code><br />
<br />
[注] message 可以是你的备注信息<br />
<br />
提交暂存区中的指定文件到本地仓库<br />
<br />
如果你没有使用上述<code>git add</code>命令暂存你的修改文件，可以使用<br />
<br />
<code>git commit -a</code><br />
<br />
进行直接提交<br />
<br />
==== git checkout ====<br />
<br />
* 用于分支切换<br />
<br />
切换分支：<br />
<br />
<code>git checkout <branch-name></code><br />
<br />
<code>git checkout <branch-name></code><br />
<br />
例如在您的仓库中有这几个分支：<br />
<pre><br />
-> master (Default)<br />
backup<br />
test<br />
</pre><br />
您当前处于 master 分支，如果想要切换到test分支，我们可以使用<br />
<br />
<code>git checkout test</code><br />
<br />
* 用于检出文件<br />
将指定的文件恢复到最新的提交状态，撤销你对其的更改<br />
<br />
<code>git checkout -- <file></code><br />
<br />
==== git push ====<br />
用于将本地的分支版本上传到远程仓库并进行合并<br />
<br />
<code>git push <remote-host-name> <local-branch-name>:<remote-branch-name></code><br />
<br />
remote-host-name:远程主机名<br />
<br />
local-branch-name:本地分支名<br />
<br />
例如，当你的远程主机名为origin ，本地分支名为master，远程分支名为master时：<br />
<br />
<code>git push origin master:master</code><br />
<br />
例如，当你的rhost名为origin 本地分支名为master远程分支名为master时：<br />
<br />
本地和远程分支名相同，上述命令可以简写为：<br />
<br />
<code>git push origin master</code><br />
<br />
当你的远程版本与本地版本有差异，无法直接push时，你可以使用--force 参数来进行强制推送<br />
<br />
<code>git push --force origin master</code><br />
<br />
--force 此处可以直接简单化为 -f <br />
<br />
如果你想要删除主机内的某个分支，你可以使用--delete参数<br />
<br />
<code>git push origin --delete <branch-name></code><br />
<br />
==== git diff ====<br />
用于比较当前工作区与上一个版本之间的差异<br />
<br />
例如：（此处仅做不恰当举例，Makefile不是这样乱写的）<br />
<pre><br />
diff --git a/makefile b/makefile<br />
<br />
index fbb8c85..d65c7eb 100644<br />
<br />
--- a/makefile<br />
<br />
+++ b/makefile<br />
<br />
@@ -1 +1,2 @@<br />
<br />
114514<br />
<br />
+1919180<br />
</pre><br />
<br />
==== git log ====<br />
用于查看提交的历史<br />
<br />
例如当你进行一次提交之后，执行 <code>git log</code>终端会输出<br />
<br />
<pre><br />
commit 3a5b0d12f471418b13f2baf5e9e4c112a5e804a8 (HEAD -> master)<br />
<br />
Author: luluzzy <1054438588@qq.com><br />
<br />
Date: Thu Feb 15 21:28:47 2024 +0800<br />
<br />
initial commit: add makefile<br />
</pre><br />
<br />
这些输出分别为<br />
<pre><br />
commit sha1 hash: 针对你这个提交的 commit id<br />
Author: commit 作者名称 <you@example.com><br />
Date: commit 日期<br />
commit: 名称<br />
</pre><br />
<br />
关于sha1_hash的介绍请看这里<ref>生成这个hash值，它是对那个commit是Git仓库中内容和头信息Header的一个校验和checksum。Linux kernel开创者和Git的开发者——Linus说，Git使用了sha1并非是为了安全性，而是为了数据的完整性；它可以保证，在很多年后，你重新checkout某个commit时，一定是它多年前的当时的状态，完全一摸一样，完全值得信任。在Git中，根据commit的sha1值40个十六进制数字进行了简单的划分目录，以前2位数字作为目录名，其下面是剩余38位数字组成的一个文件名</ref><br />
<br />
当有多次提交之后，如果我们想要翻之前的提交历史，难免会因为终端输出的内容过多而难以查看翻阅<br />
<br />
此时我们可以使用<code>--online</code>参数来简化输出，此时仅会输出: sha1哈希值 + commit的名称<br />
<br />
例如<br />
<pre><br />
347595d (HEAD -> master) modify makefile<br />
<br />
3a5b0d1 initial commit: add makefile<br />
</pre><br />
<br />
==== git cherry-pick ====<br />
<br />
<br />
cherry-pick (遴选) 和它的名称一样，挑选一个我们需要的 commit 进行操作。它可以用于将在其他分支上的 commit 修改，移植到当前的分支。<br />
<br />
如果我们想在我们正在开发的版本上，添加一个其他版本中的功能代码。就可以使用 cherry-pick ，将这个功能相关的 commit 提取出来，合入该版本。<br />
<br />
<code>git cherry-pick <commit-id></code><br />
<br />
<br />
当我们执行完 <code>cherry-pick</code>操作之后，会自动生成一个<code>commit</code>以及对应新的<code>commit-id</code><br />
<br />
在顺利的情况下我们可以直接通过，但如果遇到代码等因为变量名，写法等不同的情况，<code>cherry-pick</code>大概率会报错，此时我们需要进行报错处理。<br />
<br />
第一种方案是手动修改<br />
<br />
我们可以先使用<code>git status</code>检查当前遴选时冲突的文件<br />
<br />
然后 <code>git checkout --ours filename</code><br />
<br />
然后按照提交的修改内容进行手动修改<br />
<br />
随后使用<code>git add</code>命令将文件重新加入暂存区<br />
<br />
再使用<br />
<br />
<code>git cherry-pick --continue</code><br />
<br />
命令让 cherrypick 操作继续执行。<br />
<br />
第二种方案是直接退出<code>cherry-pick</code>进程，一般适用于冲突文件实在太多了难以按照方案一处理的情况。<br />
<br />
需要注意的是，如果您当前正在遴选的提交在该分支已经存在也会冲突，在这种情况下，您需要解决冲突并手动解决问题。<br />
<br />
<code>git cherry-pick --abort</code><br />
<br />
==== git fetch ====<br />
git fetch 命令用于从远程获取仓库。<br />
<br />
==== git merge ====<br />
<code>git merge</code>是用来把分叉的提交历史放回到一起(合并)的方式。<br />
<br />
git merge命令用来将你之前使用git branch命令创建的分支以及在此分支上独立开发的内容整合为一个分支。<br />
<br />
本<br />
<br />
==== git pull ====<br />
用于从远程获取代码并合并本地的版本。<br />
<br />
<code>git pull</code>其实就是<code>git fetch</code>和<code>git merge FETCH_HEAD</code> 的简写。<br />
<br />
格式如下：<br />
<br />
<code>git pull <remote-host-name> <remote-branch-name>:<local-branch-name></code><br />
<br />
==== git rebase ====<br />
用于需要修改历史上某一项commit<br />
<br />
<code>git rebase -i HEAD~<commit number></code><br />
<br />
commit number就是从头部往前数的commit数量。执行后会弹出你在git config内配置的编辑器，若未配置则是默认，vim居多。然后就可以看见一堆commit前面有pick字样。可以将pick替换为你想要的操作。<br />
有以下操作：<br />
<br />
1.edit，顾名思义编辑此commit，替换完保存后请修改内容，使用<code>git add</code>或vscode，github desktop将修改文件添加到暂存区，之后命令行执行<code>git commit --amend</code>这样commit就修改成了<br />
<br />
2.squash，合并几个提交，确认一个父提交，将要合并的commit，从下向上替换字符串，会从下向上合并(方位指的是<code>git rebase</code>后弹出的编辑器)<br />
<br />
3.drop，需要移除的commit<br />
<br />
==== git subtree ====<br />
子树，在Android开发中多用于Kernel侧更改，如跟踪audio模块等<br />
<br />
<code>git subtree add --prefix=<目录> <仓库地址> <远程分支></code><br />
<br />
如果需要更新远程库时<br />
<br />
<code>git subtree pull --prefix=<目录> <仓库地址> <远程分支></code><br />
<br />
==== git submodule ====<br />
<br />
===== 子模块功能的概述 =====<br />
<br />
<br />
<br />
<br />
<br />
<code>git submodule</code>允许在自己的Github仓库里加入别人的github仓库，作为自己仓库的子仓库(即submodule)。<br />
<br />
为什么我们会需要使用子模块？当我们维护一个项目时有可能遇到以下情况，例如维护某款机型的KernelSU内核，我们需要将KernelSU导入至我们的内核源码中，如果我们直接clone进去容易带来一个问题，如果KernelSU更新了怎么办？此时我们便可以使用子模块来解决这个问题<br />
<br />
<code>git submodule</code>允许在git仓库里存放别人仓库的url，作为自己的子模块，其核心内容是在Git仓库里面加入一个<code>.gitmodules</code>文件，里面会记录各个submodule的名字，路径，以及对应链接。<br />
<br />
===== 加入子模块 =====<br />
<code>git submodule add <url> <path></code><br />
<br />
此时 <code>.gitmodules</code>内会自动生成以下内容<br />
<br />
[submodule "xxx"]<br />
<br />
path = xxx<br />
<br />
url = xxx<br />
<br />
===== 初始化子模块 =====<br />
<code>git submodule init</code><br />
<br />
===== 更新子模块 =====<br />
<code>git submodule update</code><br />
<br />
==== 参考资料： ====<br />
[1] 百度百科 -- Git：<nowiki>https://baike.baidu.com/item/GIT/12647237?fr=ge_ala</nowiki><br />
<br />
[2] 菜鸟教程 -- Git基本操作：<nowiki>https://www.runoob.com/git/git-basic-operations.html</nowiki><br />
<br />
[3] CSDN -- git merge 使用简介: <nowiki>https://blog.csdn.net/All_In_gzx_cc/article/details/125482617</nowiki></div>
XiaoleGun
https://wiki.uotan.cn/index.php?title=Git%E4%BD%BF%E7%94%A8%E6%95%99%E7%A8%8B&diff=510
Git使用教程
2024-02-17T08:58:53Z
<p>XiaoleGun：添加更改默认编辑器的命令</p>
<hr />
<div>=== Git的由来： ===<br />
Git是一个开源的分布式版本控制系统，可以有效、高速地处理从很小到非常大的项目版本管理，也是Linus Torvalds为了帮助管理Linux内核开发而开发的一个开放源码的版本控制软件。Torvalds 开始着手开发 Git 是为了作为一种过渡方案来替代 BitKeeper。<br />
<br />
=== 常见的代码托管平台： ===<br />
[https://github.com Github]<br />
<br />
[https://gitlab.com Gitlab]<br />
<br />
[https://gitee.com Gitee]<br />
<br />
=== Git 常见命令: ===<br />
<br />
==== git init ====<br />
在本地目录中初始化一个新的Git仓库<br />
<br />
==== git config ====<br />
用于配置用户的信息以及其他设置,在使用git之前您必须完成以下步骤。<br />
<br />
<code>git config --global user.name "your username"</code><br />
<br />
<code>git config --global user.email "your email"</code><br />
<br />
<br />
更改默认编辑器<br />
<code>git config --global core.editor nano</code><br />
<br />
==== git clone ====<br />
用于将远程仓库的代码克隆到本地，以下是命令中各个参数的含义：<br />
<br />
<code><url></code><br />
<br />
克隆某个地址(url)的仓库，远程仓库的地址可以是本地的目录，也可以是例如github,giteee,gitlab一类的代码托管平台<br />
<br />
<code>--depth=<number></code><br />
<br />
克隆仓库并且保留number条提交历史，number在此处即表达我们克隆的深度。<br />
<br />
<code>-b <branch></code><br />
<br />
克隆指定分支下的仓库内容<br />
<br />
例如我们要克隆<code>LineageOS</code>的内核源码，指定<code>lineage-21</code>分支，且仅保留最近一个提交，则需要输入:<br />
<br />
<code>git clone -b lineage-21 <nowiki>https://github.com/LineageOS/android_kernel_xiaomi_sdm845</nowiki> --depth=1</code><br />
<br />
==== git add ====<br />
添加某个文件，或者目录到暂存区，用于告诉git你需要将哪些文件的更改包含在下一次的提交(commit)之中添加一个或者多个文件到暂存区之中<br />
<br />
<code>git add [file1] [file2]</code><br />
<br />
添加指定目录(文件)到暂存区，包括子目录：<br />
<br />
<code>git add [dir]</code><br />
<br />
添加当前目录下的所有文件到暂存区：<br />
<br />
<code>git add .</code><br />
<br />
==== git status ====<br />
查看当前仓库的状态，此时git会在你的终端输出以下内容<br />
<p><em style="color: gray;">此处演示为英文，如果您的git终端输出为中文也是同理的</em></p><br />
<pre><br />
On branch master<br />
No commits yet<br />
Changes to be committed: <br />
<br />
(use “git rm --cached <file>...” to unstage) <br />
new file: makefile<br />
</pre><br />
<br />
输出内容分别为<br />
<pre><br />
您目前所在的分支<br />
目前的提交<br />
需要更改的内容<br />
新增的文件<br />
修改的文件<br />
删除的文件<br />
</pre><br />
<br />
==== git commit ====<br />
用于将暂存区我们保存的更改文件添加到本地仓库，并且会生成一条提交（commit）<br />
<br />
提交暂存区的更改到本地仓库<br />
<br />
<code>git commit -m "message"</code><br />
<br />
[注] message 可以是你的备注信息<br />
<br />
提交暂存区中的指定文件到本地仓库<br />
<br />
如果你没有使用上述<code>git add</code>命令暂存你的修改文件，可以使用<br />
<br />
<code>git commit -a</code><br />
<br />
进行直接提交<br />
<br />
==== git checkout ====<br />
<br />
* 用于分支切换<br />
<br />
切换分支：<br />
<br />
<code>git checkout <branch-name></code><br />
<br />
<code>git checkout <branch-name></code><br />
<br />
例如在您的仓库中有这几个分支：<br />
<pre><br />
-> master (Default)<br />
backup<br />
test<br />
</pre><br />
您当前处于 master 分支，如果想要切换到test分支，我们可以使用<br />
<br />
<code>git checkout test</code><br />
<br />
* 用于检出文件<br />
将指定的文件恢复到最新的提交状态，撤销你对其的更改<br />
<br />
<code>git checkout -- <file></code><br />
<br />
==== git push ====<br />
用于将本地的分支版本上传到远程仓库并进行合并<br />
<br />
<code>git push <remote-host-name> <local-branch-name>:<remote-branch-name></code><br />
<br />
remote-host-name:远程主机名<br />
<br />
local-branch-name:本地分支名<br />
<br />
例如，当你的远程主机名为origin ，本地分支名为master，远程分支名为master时：<br />
<br />
<code>git push origin master:master</code><br />
<br />
例如，当你的rhost名为origin 本地分支名为master远程分支名为master时：<br />
<br />
本地和远程分支名相同，上述命令可以简写为：<br />
<br />
<code>git push origin master</code><br />
<br />
当你的远程版本与本地版本有差异，无法直接push时，你可以使用--force 参数来进行强制推送<br />
<br />
<code>git push --force origin master</code><br />
<br />
--force 此处可以直接简单化为 -f <br />
<br />
如果你想要删除主机内的某个分支，你可以使用--delete参数<br />
<br />
<code>git push origin --delete <branch-name></code><br />
<br />
==== git diff ====<br />
用于比较当前工作区与上一个版本之间的差异<br />
<br />
例如：（此处仅做不恰当举例，Makefile不是这样乱写的）<br />
<pre><br />
diff --git a/makefile b/makefile<br />
<br />
index fbb8c85..d65c7eb 100644<br />
<br />
--- a/makefile<br />
<br />
+++ b/makefile<br />
<br />
@@ -1 +1,2 @@<br />
<br />
114514<br />
<br />
+1919180<br />
</pre><br />
<br />
==== git log ====<br />
用于查看提交的历史<br />
<br />
例如当你进行一次提交之后，执行 <code>git log</code>终端会输出<br />
<br />
<pre><br />
commit 3a5b0d12f471418b13f2baf5e9e4c112a5e804a8 (HEAD -> master)<br />
<br />
Author: luluzzy <1054438588@qq.com><br />
<br />
Date: Thu Feb 15 21:28:47 2024 +0800<br />
<br />
initial commit: add makefile<br />
</pre><br />
<br />
这些输出分别为<br />
<pre><br />
commit sha1 hash: 针对你这个提交的 commit id<br />
Author: commit 作者名称 <you@example.com><br />
Date: commit 日期<br />
commit: 名称<br />
</pre><br />
<br />
关于sha1_hash的介绍请看这里<ref>生成这个hash值，它是对那个commit是Git仓库中内容和头信息Header的一个校验和checksum。Linux kernel开创者和Git的开发者——Linus说，Git使用了sha1并非是为了安全性，而是为了数据的完整性；它可以保证，在很多年后，你重新checkout某个commit时，一定是它多年前的当时的状态，完全一摸一样，完全值得信任。在Git中，根据commit的sha1值40个十六进制数字进行了简单的划分目录，以前2位数字作为目录名，其下面是剩余38位数字组成的一个文件名</ref><br />
<br />
当有多次提交之后，如果我们想要翻之前的提交历史，难免会因为终端输出的内容过多而难以查看翻阅<br />
<br />
此时我们可以使用<code>--online</code>参数来简化输出，此时仅会输出: sha1哈希值 + commit的名称<br />
<br />
例如<br />
<pre><br />
347595d (HEAD -> master) modify makefile<br />
<br />
3a5b0d1 initial commit: add makefile<br />
</pre><br />
<br />
==== git cherry-pick ====<br />
<br />
<br />
cherry-pick (遴选) 和它的名称一样，挑选一个我们需要的 commit 进行操作。它可以用于将在其他分支上的 commit 修改，移植到当前的分支。<br />
<br />
如果我们想在我们正在开发的版本上，添加一个其他版本中的功能代码。就可以使用 cherry-pick ，将这个功能相关的 commit 提取出来，合入该版本。<br />
<br />
<code>git cherry-pick <commit-id></code><br />
<br />
<br />
当我们执行完 <code>cherry-pick</code>操作之后，会自动生成一个<code>commit</code>以及对应新的<code>commit-id</code><br />
<br />
在顺利的情况下我们可以直接通过，但如果遇到代码等因为变量名，写法等不同的情况，<code>cherry-pick</code>大概率会报错，此时我们需要进行报错处理。<br />
<br />
第一种方案是手动修改<br />
<br />
我们可以先使用<code>git status</code>检查当前遴选时冲突的文件<br />
<br />
然后 <code>git checkout --ours filename</code><br />
<br />
然后按照提交的修改内容进行手动修改<br />
<br />
随后使用<code>git add</code>命令将文件重新加入暂存区<br />
<br />
再使用<br />
<br />
<code>git cherry-pick --continue</code><br />
<br />
命令让 cherrypick 操作继续执行。<br />
<br />
第二种方案是直接退出<code>cherry-pick</code>进程，一般适用于冲突文件实在太多了难以按照方案一处理的情况。<br />
<br />
需要注意的是，如果您当前正在遴选的提交在该分支已经存在也会冲突，在这种情况下，您需要解决冲突并手动解决问题。<br />
<br />
<code>git cherry-pick --abort</code><br />
<br />
==== git fetch ====<br />
git fetch 命令用于从远程获取仓库。<br />
<br />
==== git merge ====<br />
<code>git merge</code>是用来把分叉的提交历史放回到一起(合并)的方式。<br />
<br />
git merge命令用来将你之前使用git branch命令创建的分支以及在此分支上独立开发的内容整合为一个分支。<br />
<br />
本<br />
<br />
==== git pull ====<br />
用于从远程获取代码并合并本地的版本。<br />
<br />
<code>git pull</code>其实就是<code>git fetch</code>和<code>git merge FETCH_HEAD</code> 的简写。<br />
<br />
格式如下：<br />
<br />
<code>git pull <remote-host-name> <remote-branch-name>:<local-branch-name></code><br />
<br />
==== git rebase ====<br />
用于需要修改历史上某一项commit<br />
<br />
<code>git rebase -i HEAD~<commit number></code><br />
<br />
commit number就是从头部往前数的commit数量。执行后会弹出你在git config内配置的编辑器，若未配置则是默认，vim居多。然后就可以看见一堆commit前面有pick字样。可以将pick替换为你想要的操作。<br />
有以下操作：<br />
<br />
1.edit，顾名思义编辑此commit，替换完保存后请修改内容，使用<code>git add</code>或vscode，github desktop将修改文件添加到暂存区，之后命令行执行<code>git commit --amend</code>这样commit就修改成了<br />
<br />
2.squash，合并几个提交，确认一个父提交，将要合并的commit，从下向上替换字符串，会从下向上合并(方位指的是<code>git rebase</code>后弹出的编辑器)<br />
<br />
3.drop，需要移除的commit<br />
<br />
==== git subtree ====<br />
子树，在Android开发中多用于Kernel侧更改，如跟踪audio模块等<br />
<br />
<code>git subtree add --prefix=<目录> <仓库地址> <远程分支></code><br />
<br />
如果需要更新远程库时<br />
<br />
<code>git subtree pull --prefix=<目录> <仓库地址> <远程分支></code><br />
<br />
==== git submodule ====<br />
<br />
===== 子模块功能的概述 =====<br />
<br />
<br />
<br />
<br />
<br />
<code>git submodule</code>允许在自己的Github仓库里加入别人的github仓库，作为自己仓库的子仓库(即submodule)。<br />
<br />
为什么我们会需要使用子模块？当我们维护一个项目时有可能遇到以下情况，例如维护某款机型的KernelSU内核，我们需要将KernelSU导入至我们的内核源码中，如果我们直接clone进去容易带来一个问题，如果KernelSU更新了怎么办？此时我们便可以使用子模块来解决这个问题<br />
<br />
<code>git submodule</code>允许在git仓库里存放别人仓库的url，作为自己的子模块，其核心内容是在Git仓库里面加入一个<code>.gitmodules</code>文件，里面会记录各个submodule的名字，路径，以及对应链接。<br />
<br />
===== 加入子模块 =====<br />
<code>git submodule add <url> <path></code><br />
<br />
此时 <code>.gitmodules</code>内会自动生成以下内容<br />
<br />
[submodule "xxx"]<br />
<br />
path = xxx<br />
<br />
url = xxx<br />
<br />
===== 初始化子模块 =====<br />
<code>git submodule init</code><br />
<br />
===== 更新子模块 =====<br />
<code>git submodule update</code><br />
<br />
==== 参考资料： ====<br />
[1] 百度百科 -- Git：<nowiki>https://baike.baidu.com/item/GIT/12647237?fr=ge_ala</nowiki><br />
<br />
[2] 菜鸟教程 -- Git基本操作：<nowiki>https://www.runoob.com/git/git-basic-operations.html</nowiki><br />
<br />
[3] CSDN -- git merge 使用简介: <nowiki>https://blog.csdn.net/All_In_gzx_cc/article/details/125482617</nowiki></div>
XiaoleGun
https://wiki.uotan.cn/index.php?title=Git%E4%BD%BF%E7%94%A8%E6%95%99%E7%A8%8B&diff=485
Git使用教程
2024-02-16T11:46:52Z
<p>XiaoleGun：添加subtree</p>
<hr />
<div>=== Git的由来： ===<br />
Git是一个开源的分布式版本控制系统，可以有效、高速地处理从很小到非常大的项目版本管理，也是Linus Torvalds为了帮助管理Linux内核开发而开发的一个开放源码的版本控制软件。Torvalds 开始着手开发 Git 是为了作为一种过渡方案来替代 BitKeeper。<br />
<br />
=== 常见的代码托管平台： ===<br />
[https://github.com Github]<br />
<br />
[https://gitlab.com Gitlab]<br />
<br />
[https://gitee.com Gitee]<br />
<br />
=== Git 常见命令: ===<br />
<br />
==== git init ====<br />
在本地目录中初始化一个新的Git仓库<br />
<br />
==== git config ====<br />
用于配置用户的信息以及其他设置,在使用git之前您必须完成以下步骤。<br />
<br />
<code>git config --global user.name "your username"</code><br />
<br />
<code>git config --global user.email "your email"</code><br />
<br />
==== git clone ====<br />
用于将远程仓库的代码克隆到本地，以下是命令中各个参数的含义：<br />
<br />
<code><url></code><br />
<br />
克隆某个地址(url)的仓库，远程仓库的地址可以是本地的目录，也可以是例如github,giteee,gitlab一类的代码托管平台<br />
<br />
<code>--depth=<number></code><br />
<br />
克隆仓库并且保留number条提交历史，number在此处即表达我们克隆的深度。<br />
<br />
<code>-b <branch></code><br />
<br />
克隆指定分支下的仓库内容<br />
<br />
例如我们要克隆<code>LineageOS</code>的内核源码，指定<code>lineage-21</code>分支，且仅保留最近一个提交，则需要输入:<br />
<br />
<code>git clone -b lineage-21 <nowiki>https://github.com/LineageOS/android_kernel_xiaomi_sdm845</nowiki> --depth=1</code><br />
<br />
==== git add ====<br />
添加某个文件，或者目录到暂存区，用于告诉git你需要将哪些文件的更改包含在下一次的提交(commit)之中添加一个或者多个文件到暂存区之中<br />
<br />
<code>git add [file1] [file2]</code><br />
<br />
添加指定目录(文件)到暂存区，包括子目录：<br />
<br />
<code>git add [dir]</code><br />
<br />
添加当前目录下的所有文件到暂存区：<br />
<br />
<code>git add .</code><br />
<br />
==== git status ====<br />
查看当前仓库的状态，此时git会在你的终端输出以下内容<br />
<p><em style="color: gray;">此处演示为英文，如果您的git终端输出为中文也是同理的</em></p><br />
<pre><br />
On branch master<br />
No commits yet<br />
Changes to be committed: <br />
<br />
(use “git rm --cached <file>...” to unstage) <br />
new file: makefile<br />
</pre><br />
<br />
输出内容分别为<br />
<pre><br />
您目前所在的分支<br />
目前的提交<br />
需要更改的内容<br />
新增的文件<br />
修改的文件<br />
删除的文件<br />
</pre><br />
<br />
==== git commit ====<br />
用于将暂存区我们保存的更改文件添加到本地仓库，并且会生成一条提交（commit）<br />
<br />
提交暂存区的更改到本地仓库<br />
<br />
<code>git commit -m "message"</code><br />
<br />
[注] message 可以是你的备注信息<br />
<br />
提交暂存区中的指定文件到本地仓库<br />
<br />
如果你没有使用上述<code>git add</code>命令暂存你的修改文件，可以使用<br />
<br />
<code>git commit -a</code><br />
<br />
进行直接提交<br />
<br />
==== git checkout ====<br />
<br />
* 用于分支切换<br />
<br />
切换分支：<br />
<br />
<code>git checkout <branch-name></code><br />
<br />
<code>git checkout <branch-name></code><br />
<br />
例如在您的仓库中有这几个分支：<br />
<pre><br />
-> master (Default)<br />
backup<br />
test<br />
</pre><br />
您当前处于 master 分支，如果想要切换到test分支，我们可以使用<br />
<br />
<code>git checkout test</code><br />
<br />
* 用于检出文件<br />
将指定的文件恢复到最新的提交状态，撤销你对其的更改<br />
<br />
<code>git checkout -- <file></code><br />
<br />
==== git push ====<br />
用于将本地的分支版本上传到远程仓库并进行合并<br />
<br />
<code>git push <remote-host-name> <local-branch-name>:<remote-branch-name></code><br />
<br />
remote-host-name:远程主机名<br />
<br />
local-branch-name:本地分支名<br />
<br />
例如，当你的远程主机名为origin ，本地分支名为master，远程分支名为master时：<br />
<br />
<code>git push origin master:master</code><br />
<br />
例如，当你的rhost名为origin 本地分支名为master远程分支名为master时：<br />
<br />
本地和远程分支名相同，上述命令可以简写为：<br />
<br />
<code>git push origin master</code><br />
<br />
当你的远程版本与本地版本有差异，无法直接push时，你可以使用--force 参数来进行强制推送<br />
<br />
<code>git push --force origin master</code><br />
<br />
--force 此处可以直接简单化为 -f <br />
<br />
如果你想要删除主机内的某个分支，你可以使用--delete参数<br />
<br />
<code>git push origin --delete <branch-name></code><br />
<br />
==== git diff ====<br />
用于比较当前工作区与上一个版本之间的差异<br />
<br />
例如：（此处仅做不恰当举例，Makefile不是这样乱写的）<br />
<pre><br />
diff --git a/makefile b/makefile<br />
<br />
index fbb8c85..d65c7eb 100644<br />
<br />
--- a/makefile<br />
<br />
+++ b/makefile<br />
<br />
@@ -1 +1,2 @@<br />
<br />
114514<br />
<br />
+1919180<br />
</pre><br />
<br />
==== git log ====<br />
用于查看提交的历史<br />
<br />
例如当你进行一次提交之后，执行 <code>git log</code>终端会输出<br />
<br />
<pre><br />
commit 3a5b0d12f471418b13f2baf5e9e4c112a5e804a8 (HEAD -> master)<br />
<br />
Author: luluzzy <1054438588@qq.com><br />
<br />
Date: Thu Feb 15 21:28:47 2024 +0800<br />
<br />
initial commit: add makefile<br />
</pre><br />
<br />
这些输出分别为<br />
<pre><br />
commit sha1 hash: 针对你这个提交的 commit id<br />
Author: commit 作者名称 <you@example.com><br />
Date: commit 日期<br />
commit: 名称<br />
</pre><br />
<br />
关于sha1_hash的介绍请看这里<ref>生成这个hash值，它是对那个commit是Git仓库中内容和头信息Header的一个校验和checksum。Linux kernel开创者和Git的开发者——Linus说，Git使用了sha1并非是为了安全性，而是为了数据的完整性；它可以保证，在很多年后，你重新checkout某个commit时，一定是它多年前的当时的状态，完全一摸一样，完全值得信任。在Git中，根据commit的sha1值40个十六进制数字进行了简单的划分目录，以前2位数字作为目录名，其下面是剩余38位数字组成的一个文件名</ref><br />
<br />
当有多次提交之后，如果我们想要翻之前的提交历史，难免会因为终端输出的内容过多而难以查看翻阅<br />
<br />
此时我们可以使用<code>--online</code>参数来简化输出，此时仅会输出: sha1哈希值 + commit的名称<br />
<br />
例如<br />
<pre><br />
347595d (HEAD -> master) modify makefile<br />
<br />
3a5b0d1 initial commit: add makefile<br />
</pre><br />
<br />
==== git cherry-pick ====<br />
<br />
<br />
cherry-pick (遴选) 和它的名称一样，挑选一个我们需要的 commit 进行操作。它可以用于将在其他分支上的 commit 修改，移植到当前的分支。<br />
<br />
如果我们想在我们正在开发的版本上，添加一个其他版本中的功能代码。就可以使用 cherry-pick ，将这个功能相关的 commit 提取出来，合入该版本。<br />
<br />
<code>git cherry-pick <commit-id></code><br />
<br />
<br />
当我们执行完 <code>cherry-pick</code>操作之后，会自动生成一个<code>commit</code>以及对应新的<code>commit-id</code><br />
<br />
在顺利的情况下我们可以直接通过，但如果遇到代码等因为变量名，写法等不同的情况，<code>cherry-pick</code>大概率会报错，此时我们需要进行报错处理。<br />
<br />
第一种方案是手动修改<br />
<br />
我们可以先使用<code>git status</code>检查当前遴选时冲突的文件<br />
<br />
然后 <code>git checkout --ours filename</code><br />
<br />
然后按照提交的修改内容进行手动修改<br />
<br />
随后使用<code>git add</code>命令将文件重新加入暂存区<br />
<br />
再使用<br />
<br />
<code>git cherry-pick --continue</code><br />
<br />
命令让 cherrypick 操作继续执行。<br />
<br />
第二种方案是直接退出<code>cherry-pick</code>进程，一般适用于冲突文件实在太多了难以按照方案一处理的情况。<br />
<br />
需要注意的是，如果您当前正在遴选的提交在该分支已经存在也会冲突，在这种情况下，您需要解决冲突并手动解决问题。<br />
<br />
<code>git cherry-pick --abort</code><br />
<br />
==== git fetch ====<br />
git fetch 命令用于从远程获取仓库。<br />
<br />
==== git merge ====<br />
<code>git merge</code>是用来把分叉的提交历史放回到一起(合并)的方式。<br />
<br />
git merge命令用来将你之前使用git branch命令创建的分支以及在此分支上独立开发的内容整合为一个分支。<br />
<br />
本<br />
<br />
==== git pull ====<br />
用于从远程获取代码并合并本地的版本。<br />
<br />
<code>git pull</code>其实就是<code>git fetch</code>和<code>git merge FETCH_HEAD</code> 的简写。<br />
<br />
格式如下：<br />
<br />
<code>git pull <remote-host-name> <remote-branch-name>:<local-branch-name></code><br />
<br />
==== git rebase ====<br />
用于需要修改历史上某一项commit<br />
<br />
<code>git rebase -i HEAD~<commit number></code><br />
<br />
commit number就是从头部往前数的commit数量。执行后会弹出你在git config内配置的编辑器，若未配置则是默认，vim居多。然后就可以看见一堆commit前面有pick字样。可以将pick替换为你想要的操作。<br />
有以下操作：<br />
<br />
1.edit，顾名思义编辑此commit，替换完保存后请修改内容，使用<code>git add</code>或vscode，github desktop将修改文件添加到暂存区，之后命令行执行<code>git commit --amend</code>这样commit就修改成了<br />
<br />
2.squash，合并几个提交，确认一个父提交，将要合并的commit，从下向上替换字符串，会从下向上合并(方位指的是<code>git rebase</code>后弹出的编辑器)<br />
<br />
3.drop，需要移除的commit<br />
<br />
=== git subtree ===<br />
子树，在Android开发中多用于Kernel侧更改，如跟踪audio模块等<br />
<br />
<code>git subtree add --prefix=<目录> <仓库地址> <远程分支></code><br />
<br />
如果需要更新远程库时<br />
<br />
<code>git subtree pull --prefix=<目录> <仓库地址> <远程分支></code><br />
<br />
==== 参考资料： ====<br />
[1] 百度百科 -- Git：<nowiki>https://baike.baidu.com/item/GIT/12647237?fr=ge_ala</nowiki><br />
<br />
[2] 菜鸟教程 -- Git基本操作：<nowiki>https://www.runoob.com/git/git-basic-operations.html</nowiki><br />
<br />
[3] CSDN -- git merge 使用简介: <nowiki>https://blog.csdn.net/All_In_gzx_cc/article/details/125482617</nowiki></div>
XiaoleGun
https://wiki.uotan.cn/index.php?title=Git%E4%BD%BF%E7%94%A8%E6%95%99%E7%A8%8B&diff=484
Git使用教程
2024-02-16T11:42:39Z
<p>XiaoleGun：添加换行</p>
<hr />
<div>=== Git的由来： ===<br />
Git是一个开源的分布式版本控制系统，可以有效、高速地处理从很小到非常大的项目版本管理，也是Linus Torvalds为了帮助管理Linux内核开发而开发的一个开放源码的版本控制软件。Torvalds 开始着手开发 Git 是为了作为一种过渡方案来替代 BitKeeper。<br />
<br />
=== 常见的代码托管平台： ===<br />
[https://github.com Github]<br />
<br />
[https://gitlab.com Gitlab]<br />
<br />
[https://gitee.com Gitee]<br />
<br />
=== Git 常见命令: ===<br />
<br />
==== git init ====<br />
在本地目录中初始化一个新的Git仓库<br />
<br />
==== git config ====<br />
用于配置用户的信息以及其他设置,在使用git之前您必须完成以下步骤。<br />
<br />
<code>git config --global user.name "your username"</code><br />
<br />
<code>git config --global user.email "your email"</code><br />
<br />
==== git clone ====<br />
用于将远程仓库的代码克隆到本地，以下是命令中各个参数的含义：<br />
<br />
<code><url></code><br />
<br />
克隆某个地址(url)的仓库，远程仓库的地址可以是本地的目录，也可以是例如github,giteee,gitlab一类的代码托管平台<br />
<br />
<code>--depth=<number></code><br />
<br />
克隆仓库并且保留number条提交历史，number在此处即表达我们克隆的深度。<br />
<br />
<code>-b <branch></code><br />
<br />
克隆指定分支下的仓库内容<br />
<br />
例如我们要克隆<code>LineageOS</code>的内核源码，指定<code>lineage-21</code>分支，且仅保留最近一个提交，则需要输入:<br />
<br />
<code>git clone -b lineage-21 <nowiki>https://github.com/LineageOS/android_kernel_xiaomi_sdm845</nowiki> --depth=1</code><br />
<br />
==== git add ====<br />
添加某个文件，或者目录到暂存区，用于告诉git你需要将哪些文件的更改包含在下一次的提交(commit)之中添加一个或者多个文件到暂存区之中<br />
<br />
<code>git add [file1] [file2]</code><br />
<br />
添加指定目录(文件)到暂存区，包括子目录：<br />
<br />
<code>git add [dir]</code><br />
<br />
添加当前目录下的所有文件到暂存区：<br />
<br />
<code>git add .</code><br />
<br />
==== git status ====<br />
查看当前仓库的状态，此时git会在你的终端输出以下内容<br />
<p><em style="color: gray;">此处演示为英文，如果您的git终端输出为中文也是同理的</em></p><br />
<pre><br />
On branch master<br />
No commits yet<br />
Changes to be committed: <br />
<br />
(use “git rm --cached <file>...” to unstage) <br />
new file: makefile<br />
</pre><br />
<br />
输出内容分别为<br />
<pre><br />
您目前所在的分支<br />
目前的提交<br />
需要更改的内容<br />
新增的文件<br />
修改的文件<br />
删除的文件<br />
</pre><br />
<br />
==== git commit ====<br />
用于将暂存区我们保存的更改文件添加到本地仓库，并且会生成一条提交（commit）<br />
<br />
提交暂存区的更改到本地仓库<br />
<br />
<code>git commit -m "message"</code><br />
<br />
[注] message 可以是你的备注信息<br />
<br />
提交暂存区中的指定文件到本地仓库<br />
<br />
如果你没有使用上述<code>git add</code>命令暂存你的修改文件，可以使用<br />
<br />
<code>git commit -a</code><br />
<br />
进行直接提交<br />
<br />
==== git checkout ====<br />
<br />
* 用于分支切换<br />
<br />
切换分支：<br />
<br />
<code>git checkout <branch-name></code><br />
<br />
<code>git checkout <branch-name></code><br />
<br />
例如在您的仓库中有这几个分支：<br />
<pre><br />
-> master (Default)<br />
backup<br />
test<br />
</pre><br />
您当前处于 master 分支，如果想要切换到test分支，我们可以使用<br />
<br />
<code>git checkout test</code><br />
<br />
* 用于检出文件<br />
将指定的文件恢复到最新的提交状态，撤销你对其的更改<br />
<br />
<code>git checkout -- <file></code><br />
<br />
==== git push ====<br />
用于将本地的分支版本上传到远程仓库并进行合并<br />
<br />
<code>git push <remote-host-name> <local-branch-name>:<remote-branch-name></code><br />
<br />
remote-host-name:远程主机名<br />
<br />
local-branch-name:本地分支名<br />
<br />
例如，当你的远程主机名为origin ，本地分支名为master，远程分支名为master时：<br />
<br />
<code>git push origin master:master</code><br />
<br />
例如，当你的rhost名为origin 本地分支名为master远程分支名为master时：<br />
<br />
本地和远程分支名相同，上述命令可以简写为：<br />
<br />
<code>git push origin master</code><br />
<br />
当你的远程版本与本地版本有差异，无法直接push时，你可以使用--force 参数来进行强制推送<br />
<br />
<code>git push --force origin master</code><br />
<br />
--force 此处可以直接简单化为 -f <br />
<br />
如果你想要删除主机内的某个分支，你可以使用--delete参数<br />
<br />
<code>git push origin --delete <branch-name></code><br />
<br />
==== git diff ====<br />
用于比较当前工作区与上一个版本之间的差异<br />
<br />
例如：（此处仅做不恰当举例，Makefile不是这样乱写的）<br />
<pre><br />
diff --git a/makefile b/makefile<br />
<br />
index fbb8c85..d65c7eb 100644<br />
<br />
--- a/makefile<br />
<br />
+++ b/makefile<br />
<br />
@@ -1 +1,2 @@<br />
<br />
114514<br />
<br />
+1919180<br />
</pre><br />
<br />
==== git log ====<br />
用于查看提交的历史<br />
<br />
例如当你进行一次提交之后，执行 <code>git log</code>终端会输出<br />
<br />
<pre><br />
commit 3a5b0d12f471418b13f2baf5e9e4c112a5e804a8 (HEAD -> master)<br />
<br />
Author: luluzzy <1054438588@qq.com><br />
<br />
Date: Thu Feb 15 21:28:47 2024 +0800<br />
<br />
initial commit: add makefile<br />
</pre><br />
<br />
这些输出分别为<br />
<pre><br />
commit sha1 hash: 针对你这个提交的 commit id<br />
Author: commit 作者名称 <you@example.com><br />
Date: commit 日期<br />
commit: 名称<br />
</pre><br />
<br />
关于sha1_hash的介绍请看这里<ref>生成这个hash值，它是对那个commit是Git仓库中内容和头信息Header的一个校验和checksum。Linux kernel开创者和Git的开发者——Linus说，Git使用了sha1并非是为了安全性，而是为了数据的完整性；它可以保证，在很多年后，你重新checkout某个commit时，一定是它多年前的当时的状态，完全一摸一样，完全值得信任。在Git中，根据commit的sha1值40个十六进制数字进行了简单的划分目录，以前2位数字作为目录名，其下面是剩余38位数字组成的一个文件名</ref><br />
<br />
当有多次提交之后，如果我们想要翻之前的提交历史，难免会因为终端输出的内容过多而难以查看翻阅<br />
<br />
此时我们可以使用<code>--online</code>参数来简化输出，此时仅会输出: sha1哈希值 + commit的名称<br />
<br />
例如<br />
<pre><br />
347595d (HEAD -> master) modify makefile<br />
<br />
3a5b0d1 initial commit: add makefile<br />
</pre><br />
<br />
==== git cherry-pick ====<br />
<br />
<br />
cherry-pick (遴选) 和它的名称一样，挑选一个我们需要的 commit 进行操作。它可以用于将在其他分支上的 commit 修改，移植到当前的分支。<br />
<br />
如果我们想在我们正在开发的版本上，添加一个其他版本中的功能代码。就可以使用 cherry-pick ，将这个功能相关的 commit 提取出来，合入该版本。<br />
<br />
<code>git cherry-pick <commit-id></code><br />
<br />
<br />
当我们执行完 <code>cherry-pick</code>操作之后，会自动生成一个<code>commit</code>以及对应新的<code>commit-id</code><br />
<br />
在顺利的情况下我们可以直接通过，但如果遇到代码等因为变量名，写法等不同的情况，<code>cherry-pick</code>大概率会报错，此时我们需要进行报错处理。<br />
<br />
第一种方案是手动修改<br />
<br />
我们可以先使用<code>git status</code>检查当前遴选时冲突的文件<br />
<br />
然后 <code>git checkout --ours filename</code><br />
<br />
然后按照提交的修改内容进行手动修改<br />
<br />
随后使用<code>git add</code>命令将文件重新加入暂存区<br />
<br />
再使用<br />
<br />
<code>git cherry-pick --continue</code><br />
<br />
命令让 cherrypick 操作继续执行。<br />
<br />
第二种方案是直接退出<code>cherry-pick</code>进程，一般适用于冲突文件实在太多了难以按照方案一处理的情况。<br />
<br />
需要注意的是，如果您当前正在遴选的提交在该分支已经存在也会冲突，在这种情况下，您需要解决冲突并手动解决问题。<br />
<br />
<code>git cherry-pick --abort</code><br />
<br />
==== git fetch ====<br />
git fetch 命令用于从远程获取仓库。<br />
<br />
==== git merge ====<br />
<code>git merge</code>是用来把分叉的提交历史放回到一起(合并)的方式。<br />
<br />
git merge命令用来将你之前使用git branch命令创建的分支以及在此分支上独立开发的内容整合为一个分支。<br />
<br />
本<br />
<br />
==== git pull ====<br />
用于从远程获取代码并合并本地的版本。<br />
<br />
<code>git pull</code>其实就是<code>git fetch</code>和<code>git merge FETCH_HEAD</code> 的简写。<br />
<br />
格式如下：<br />
<br />
<code>git pull <remote-host-name> <remote-branch-name>:<local-branch-name></code><br />
<br />
==== git rebase ====<br />
用于需要修改历史上某一项commit<br />
<br />
<code>git rebase -i HEAD~<commit number></code><br />
<br />
commit number就是从头部往前数的commit数量。执行后会弹出你在git config内配置的编辑器，若未配置则是默认，vim居多。然后就可以看见一堆commit前面有pick字样。可以将pick替换为你想要的操作。<br />
有以下操作：<br />
<br />
1.edit，顾名思义编辑此commit，替换完保存后请修改内容，使用<code>git add</code>或vscode，github desktop将修改文件添加到暂存区，之后命令行执行<code>git commit --amend</code>这样commit就修改成了<br />
<br />
2.squash，合并几个提交，确认一个父提交，将要合并的commit，从下向上替换字符串，会从下向上合并(方位指的是<code>git rebase</code>后弹出的编辑器)<br />
<br />
3.drop，需要移除的commit<br />
<br />
==== 参考资料： ====<br />
[1] 百度百科 -- Git：<nowiki>https://baike.baidu.com/item/GIT/12647237?fr=ge_ala</nowiki><br />
<br />
[2] 菜鸟教程 -- Git基本操作：<nowiki>https://www.runoob.com/git/git-basic-operations.html</nowiki><br />
<br />
[3] CSDN -- git merge 使用简介: <nowiki>https://blog.csdn.net/All_In_gzx_cc/article/details/125482617</nowiki></div>
XiaoleGun
https://wiki.uotan.cn/index.php?title=Git%E4%BD%BF%E7%94%A8%E6%95%99%E7%A8%8B&diff=483
Git使用教程
2024-02-16T11:42:10Z
<p>XiaoleGun：添加git rebase</p>
<hr />
<div>=== Git的由来： ===<br />
Git是一个开源的分布式版本控制系统，可以有效、高速地处理从很小到非常大的项目版本管理，也是Linus Torvalds为了帮助管理Linux内核开发而开发的一个开放源码的版本控制软件。Torvalds 开始着手开发 Git 是为了作为一种过渡方案来替代 BitKeeper。<br />
<br />
=== 常见的代码托管平台： ===<br />
[https://github.com Github]<br />
<br />
[https://gitlab.com Gitlab]<br />
<br />
[https://gitee.com Gitee]<br />
<br />
=== Git 常见命令: ===<br />
<br />
==== git init ====<br />
在本地目录中初始化一个新的Git仓库<br />
<br />
==== git config ====<br />
用于配置用户的信息以及其他设置,在使用git之前您必须完成以下步骤。<br />
<br />
<code>git config --global user.name "your username"</code><br />
<br />
<code>git config --global user.email "your email"</code><br />
<br />
==== git clone ====<br />
用于将远程仓库的代码克隆到本地，以下是命令中各个参数的含义：<br />
<br />
<code><url></code><br />
<br />
克隆某个地址(url)的仓库，远程仓库的地址可以是本地的目录，也可以是例如github,giteee,gitlab一类的代码托管平台<br />
<br />
<code>--depth=<number></code><br />
<br />
克隆仓库并且保留number条提交历史，number在此处即表达我们克隆的深度。<br />
<br />
<code>-b <branch></code><br />
<br />
克隆指定分支下的仓库内容<br />
<br />
例如我们要克隆<code>LineageOS</code>的内核源码，指定<code>lineage-21</code>分支，且仅保留最近一个提交，则需要输入:<br />
<br />
<code>git clone -b lineage-21 <nowiki>https://github.com/LineageOS/android_kernel_xiaomi_sdm845</nowiki> --depth=1</code><br />
<br />
==== git add ====<br />
添加某个文件，或者目录到暂存区，用于告诉git你需要将哪些文件的更改包含在下一次的提交(commit)之中添加一个或者多个文件到暂存区之中<br />
<br />
<code>git add [file1] [file2]</code><br />
<br />
添加指定目录(文件)到暂存区，包括子目录：<br />
<br />
<code>git add [dir]</code><br />
<br />
添加当前目录下的所有文件到暂存区：<br />
<br />
<code>git add .</code><br />
<br />
==== git status ====<br />
查看当前仓库的状态，此时git会在你的终端输出以下内容<br />
<p><em style="color: gray;">此处演示为英文，如果您的git终端输出为中文也是同理的</em></p><br />
<pre><br />
On branch master<br />
No commits yet<br />
Changes to be committed: <br />
<br />
(use “git rm --cached <file>...” to unstage) <br />
new file: makefile<br />
</pre><br />
<br />
输出内容分别为<br />
<pre><br />
您目前所在的分支<br />
目前的提交<br />
需要更改的内容<br />
新增的文件<br />
修改的文件<br />
删除的文件<br />
</pre><br />
<br />
==== git commit ====<br />
用于将暂存区我们保存的更改文件添加到本地仓库，并且会生成一条提交（commit）<br />
<br />
提交暂存区的更改到本地仓库<br />
<br />
<code>git commit -m "message"</code><br />
<br />
[注] message 可以是你的备注信息<br />
<br />
提交暂存区中的指定文件到本地仓库<br />
<br />
如果你没有使用上述<code>git add</code>命令暂存你的修改文件，可以使用<br />
<br />
<code>git commit -a</code><br />
<br />
进行直接提交<br />
<br />
==== git checkout ====<br />
<br />
* 用于分支切换<br />
<br />
切换分支：<br />
<br />
<code>git checkout <branch-name></code><br />
<br />
<code>git checkout <branch-name></code><br />
<br />
例如在您的仓库中有这几个分支：<br />
<pre><br />
-> master (Default)<br />
backup<br />
test<br />
</pre><br />
您当前处于 master 分支，如果想要切换到test分支，我们可以使用<br />
<br />
<code>git checkout test</code><br />
<br />
* 用于检出文件<br />
将指定的文件恢复到最新的提交状态，撤销你对其的更改<br />
<br />
<code>git checkout -- <file></code><br />
<br />
==== git push ====<br />
用于将本地的分支版本上传到远程仓库并进行合并<br />
<br />
<code>git push <remote-host-name> <local-branch-name>:<remote-branch-name></code><br />
<br />
remote-host-name:远程主机名<br />
<br />
local-branch-name:本地分支名<br />
<br />
例如，当你的远程主机名为origin ，本地分支名为master，远程分支名为master时：<br />
<br />
<code>git push origin master:master</code><br />
<br />
例如，当你的rhost名为origin 本地分支名为master远程分支名为master时：<br />
<br />
本地和远程分支名相同，上述命令可以简写为：<br />
<br />
<code>git push origin master</code><br />
<br />
当你的远程版本与本地版本有差异，无法直接push时，你可以使用--force 参数来进行强制推送<br />
<br />
<code>git push --force origin master</code><br />
<br />
--force 此处可以直接简单化为 -f <br />
<br />
如果你想要删除主机内的某个分支，你可以使用--delete参数<br />
<br />
<code>git push origin --delete <branch-name></code><br />
<br />
==== git diff ====<br />
用于比较当前工作区与上一个版本之间的差异<br />
<br />
例如：（此处仅做不恰当举例，Makefile不是这样乱写的）<br />
<pre><br />
diff --git a/makefile b/makefile<br />
<br />
index fbb8c85..d65c7eb 100644<br />
<br />
--- a/makefile<br />
<br />
+++ b/makefile<br />
<br />
@@ -1 +1,2 @@<br />
<br />
114514<br />
<br />
+1919180<br />
</pre><br />
<br />
==== git log ====<br />
用于查看提交的历史<br />
<br />
例如当你进行一次提交之后，执行 <code>git log</code>终端会输出<br />
<br />
<pre><br />
commit 3a5b0d12f471418b13f2baf5e9e4c112a5e804a8 (HEAD -> master)<br />
<br />
Author: luluzzy <1054438588@qq.com><br />
<br />
Date: Thu Feb 15 21:28:47 2024 +0800<br />
<br />
initial commit: add makefile<br />
</pre><br />
<br />
这些输出分别为<br />
<pre><br />
commit sha1 hash: 针对你这个提交的 commit id<br />
Author: commit 作者名称 <you@example.com><br />
Date: commit 日期<br />
commit: 名称<br />
</pre><br />
<br />
关于sha1_hash的介绍请看这里<ref>生成这个hash值，它是对那个commit是Git仓库中内容和头信息Header的一个校验和checksum。Linux kernel开创者和Git的开发者——Linus说，Git使用了sha1并非是为了安全性，而是为了数据的完整性；它可以保证，在很多年后，你重新checkout某个commit时，一定是它多年前的当时的状态，完全一摸一样，完全值得信任。在Git中，根据commit的sha1值40个十六进制数字进行了简单的划分目录，以前2位数字作为目录名，其下面是剩余38位数字组成的一个文件名</ref><br />
<br />
当有多次提交之后，如果我们想要翻之前的提交历史，难免会因为终端输出的内容过多而难以查看翻阅<br />
<br />
此时我们可以使用<code>--online</code>参数来简化输出，此时仅会输出: sha1哈希值 + commit的名称<br />
<br />
例如<br />
<pre><br />
347595d (HEAD -> master) modify makefile<br />
<br />
3a5b0d1 initial commit: add makefile<br />
</pre><br />
<br />
==== git cherry-pick ====<br />
<br />
<br />
cherry-pick (遴选) 和它的名称一样，挑选一个我们需要的 commit 进行操作。它可以用于将在其他分支上的 commit 修改，移植到当前的分支。<br />
<br />
如果我们想在我们正在开发的版本上，添加一个其他版本中的功能代码。就可以使用 cherry-pick ，将这个功能相关的 commit 提取出来，合入该版本。<br />
<br />
<code>git cherry-pick <commit-id></code><br />
<br />
<br />
当我们执行完 <code>cherry-pick</code>操作之后，会自动生成一个<code>commit</code>以及对应新的<code>commit-id</code><br />
<br />
在顺利的情况下我们可以直接通过，但如果遇到代码等因为变量名，写法等不同的情况，<code>cherry-pick</code>大概率会报错，此时我们需要进行报错处理。<br />
<br />
第一种方案是手动修改<br />
<br />
我们可以先使用<code>git status</code>检查当前遴选时冲突的文件<br />
<br />
然后 <code>git checkout --ours filename</code><br />
<br />
然后按照提交的修改内容进行手动修改<br />
<br />
随后使用<code>git add</code>命令将文件重新加入暂存区<br />
<br />
再使用<br />
<br />
<code>git cherry-pick --continue</code><br />
<br />
命令让 cherrypick 操作继续执行。<br />
<br />
第二种方案是直接退出<code>cherry-pick</code>进程，一般适用于冲突文件实在太多了难以按照方案一处理的情况。<br />
<br />
需要注意的是，如果您当前正在遴选的提交在该分支已经存在也会冲突，在这种情况下，您需要解决冲突并手动解决问题。<br />
<br />
<code>git cherry-pick --abort</code><br />
<br />
==== git fetch ====<br />
git fetch 命令用于从远程获取仓库。<br />
<br />
==== git merge ====<br />
<code>git merge</code>是用来把分叉的提交历史放回到一起(合并)的方式。<br />
<br />
git merge命令用来将你之前使用git branch命令创建的分支以及在此分支上独立开发的内容整合为一个分支。<br />
<br />
本<br />
<br />
==== git pull ====<br />
用于从远程获取代码并合并本地的版本。<br />
<br />
<code>git pull</code>其实就是<code>git fetch</code>和<code>git merge FETCH_HEAD</code> 的简写。<br />
<br />
格式如下：<br />
<br />
<code>git pull <remote-host-name> <remote-branch-name>:<local-branch-name></code><br />
<br />
==== git rebase ====<br />
用于需要修改历史上某一项commit<br />
<br />
<code>git rebase -i HEAD~<commit number></code><br />
<br />
commit number就是从头部往前数的commit数量。执行后会弹出你在git config内配置的编辑器，若未配置则是默认，vim居多。然后就可以看见一堆commit前面有pick字样。可以将pick替换为你想要的操作。<br />
有以下操作：<br />
<br />
1.edit，顾名思义编辑此commit，替换完保存后请修改内容，使用<code>git add</code>或vscode，github desktop将修改文件添加到暂存区，之后命令行执行<code>git commit --amend</code>这样commit就修改成了<br />
2.squash，合并几个提交，确认一个父提交，将要合并的commit，从下向上替换字符串，会从下向上合并(方位指的是<code>git rebase</code>后弹出的编辑器)<br />
3.drop，需要移除的commit<br />
<br />
==== 参考资料： ====<br />
[1] 百度百科 -- Git：<nowiki>https://baike.baidu.com/item/GIT/12647237?fr=ge_ala</nowiki><br />
<br />
[2] 菜鸟教程 -- Git基本操作：<nowiki>https://www.runoob.com/git/git-basic-operations.html</nowiki><br />
<br />
[3] CSDN -- git merge 使用简介: <nowiki>https://blog.csdn.net/All_In_gzx_cc/article/details/125482617</nowiki></div>
XiaoleGun
https://wiki.uotan.cn/index.php?title=Super_Empty&diff=480
Super Empty
2024-02-16T11:27:22Z
<p>XiaoleGun：</p>
<hr />
<div>= Super empty =<br />
<br />
== 简介 ==<br />
它是某个老设备改造动态分区后的产物，是一个定义了改造动态分区信息的空镜像，由设备维护者提供刷入。<br />
其中定义了维护者定义的设备自身分区和分区大小，将它们合并成一个大的“super”供刷入第三方ROM使用，甚至可以让老旧设备运行DSU。<br />
它的意义远不止类原生，对PT(Project Treble)也有帮助，有经验的维护者可以通过改造动态分区的方式让用户无需扩容即可体验深度定制UI<br />
<br />
== 为什么会有它？ ==<br />
因为部分老旧的机型空间分配不均匀，vendor甚至和system一样大。随着Android版本的迭代，增加的新功能越来越多，对系统空间占用也越来越高，所以部分设备需要通过这种方式改造成动态分区。<br />
<br />
== 使用方法 ==<br />
以我个人维护的小米6X(wayne)为例<br />
1.设备重启至fastboot<br />
<br />
2.连接电脑<br />
<br />
3.准备最新版本的adb工具包和维护者提供的super_empty.img和ROM包<br />
<br />
4.打开命令行进入工具包目录，输入fastboot wipe-super super_empty.img的绝对路径<br />
<br />
5.刷写完毕后继续刷入维护者提供的Recovery，fastboot flash recovery recovery.img的绝对路径<br />
<br />
6.重启设备至recovery<br />
<br />
7.选择格式化data(format data)<br />
<br />
8.连接电脑，使用adb sideload刷入ROM，adb sideload ROM包绝对路径<br />
<br />
== 对开发者的一些帮助 ==<br />
[https://github.com/jjpprrrr/device%20xiaomi%20sdm845-common/commits/thirteen 改造动态分区的commit(2022年9月22日)]<br />
<br />
对于在Mac上正常刷写super_empty在win或linux下不能正常刷写的情况，请检查device tree内定义的数值是否百分之一百匹配。</div>
XiaoleGun
https://wiki.uotan.cn/index.php?title=Super_Empty&diff=479
Super Empty
2024-02-16T11:26:02Z
<p>XiaoleGun：创建页面，内容为“# Super empty ## 简介 它是某个老设备改造动态分区后的产物，是一个定义了改造动态分区信息的空镜像，由设备维护者提供刷入。 其中定义了维护者定义的设备自身分区和分区大小，将它们合并成一个大的“super”供刷入第三方ROM使用，甚至可以让老旧设备运行DSU。 它的意义远不止类原生，对PT(Project Treble)也有帮助，有经验的维护者可以通过改造动态…”</p>
<hr />
<div># Super empty<br />
<br />
## 简介<br />
它是某个老设备改造动态分区后的产物，是一个定义了改造动态分区信息的空镜像，由设备维护者提供刷入。<br />
其中定义了维护者定义的设备自身分区和分区大小，将它们合并成一个大的“super”供刷入第三方ROM使用，甚至可以让老旧设备运行DSU。<br />
它的意义远不止类原生，对PT(Project Treble)也有帮助，有经验的维护者可以通过改造动态分区的方式让用户无需扩容即可体验深度定制UI<br />
<br />
## 为什么会有它？<br />
因为部分老旧的机型空间分配不均匀，vendor甚至和system一样大。随着Android版本的迭代，增加的新功能越来越多，对系统空间占用也越来越高，所以部分设备需要通过这种方式改造成动态分区。<br />
<br />
## 使用方法<br />
以我个人维护的小米6X(wayne)为例<br />
1.设备重启至fastboot<br />
<br />
2.连接电脑<br />
<br />
3.准备最新版本的adb工具包和维护者提供的super_empty.img和ROM包<br />
<br />
4.打开命令行进入工具包目录，输入fastboot wipe-super super_empty.img的绝对路径<br />
<br />
5.刷写完毕后继续刷入维护者提供的Recovery，fastboot flash recovery recovery.img的绝对路径<br />
<br />
6.重启设备至recovery<br />
<br />
7.选择格式化data(format data)<br />
<br />
8.连接电脑，使用adb sideload刷入ROM，adb sideload ROM包绝对路径<br />
<br />
## 对开发者的一些帮助<br />
[https://github.com/jjpprrrr/device%20xiaomi%20sdm845-common/commits/thirteen 改造动态分区的commit(2022年9月22日)]<br />
<br />
对于在Mac上正常刷写super_empty在win或linux下不能正常刷写的情况，请检查device tree内定义的数值是否百分之一百匹配。</div>
XiaoleGun