Tạo nhân Pixel

Hướng dẫn này cung cấp hướng dẫn từng bước về cách tải xuống, biên dịch và nạp một nhân Pixel tuỳ chỉnh để phát triển. Nhờ GKI, giờ đây, bạn có thể cập nhật nhân một cách độc lập với bản dựng nền tảng Android. Các bước này chỉ áp dụng cho thiết bị Pixel 6 trở lên. Lý do là Pixel 5 và các thiết bị cũ hơn cần cập nhật các mô-đun nhân trên phân vùng vendor. Phân vùng này phụ thuộc vào bản dựng nền tảng Android cho các thiết bị đó. Bảng Các nhánh kernel Pixel được GKI hỗ trợ bao gồm nhánh tệp kê khai kho lưu trữ kernel cho từng thiết bị Pixel được GKI hỗ trợ. Hãy xem Legacy Pixel Kernels (Nhân Pixel cũ) để biết các nhánh kê khai nhân của Pixel 5 trở xuống.

Pixel 6 và Pixel 6 Pro cũng được hỗ trợ trong nhân Linux nguồn trên và có thể khởi động đến dấu nhắc của trình bao thiết bị chỉ bằng các trình điều khiển nguồn trên. Hãy tham khảo phần Tạo và flash nhân Pixel nguồn mở để biết thêm thông tin chi tiết.

Lưu ý: Nếu bạn chỉ muốn tạo nhân cốt lõi, hãy tham khảo phần Tạo nhân để biết các bước tạo nhân GKI. Bạn có thể sử dụng bảng được cung cấp để xác định phiên bản nhân GKI cần dùng. Các nhánh kho lưu trữ là các kho lưu trữ hạt nhân Pixel do nhà máy hỗ trợ, bao gồm cả hạt nhân GKI và trình điều khiển Pixel.

Tạo và flash các nhân GKI Pixel

Phần này cung cấp các bước để đồng bộ hoá, tạo và flash các nhánh kernel được GKI hỗ trợ. Bảng sau đây cung cấp thông tin liên kết giữa các thiết bị Pixel được hỗ trợ và các nhánh kho lưu trữ hạt nhân sản xuất tương ứng.

Các nhánh hạt nhân Pixel được GKI hỗ trợ

Thiết bị	Nhánh kho lưu trữ	Kernel GKI
Pixel 9a (tegu)	android-gs-tegu-6.1-android16	android14-6.1
Pixel 9 Pro Fold (comet)	android-gs-comet-6.1-android16	android14-6.1
Pixel 9 (tokay) Pixel 9 Pro (caiman) Pixel 9 Pro XL (komodo)	android-gs-caimito-6.1-android16	android14-6.1
Pixel 8a (akita)	android-gs-akita-6.1-android16	android14-6.1
Pixel 8 (shiba) Pixel 8 Pro (husky)	android-gs-shusky-6.1-android16	android14-6.1
Pixel Fold (felix)	android-gs-felix-6.1-android16	android14-6.1
Pixel Tablet (tangorpro)	android-gs-tangorpro-6.1-android16	android14-6.1
Pixel 7a (lynx)	android-gs-lynx-6.1-android16	android14-6.1
Pixel 7 (panther) Pixel 7 Pro (cheetah)	android-gs-pantah-6.1-android16	android14-6.1
Pixel 6a (bluejay)	android-gs-bluejay-6.1-android16	android14-6.1
Pixel 6 (oriole) Pixel 6 Pro (raven)	android-gs-raviole-6.1-android16	android14-6.1

Ngoài các nhân được nhà máy hỗ trợ, các thiết bị Pixel 6 và 6 Pro chỉ được hỗ trợ cho mục đích phát triển GKI trên các nhánh nhân Android Common có trong bảng Các tổ hợp nền tảng và nhân Android được hỗ trợ trên Pixel 6 và Pixel 6 Pro. Do sự khác biệt về UAPI của nhà cung cấp giữa HAL nền tảng Android và trình điều khiển nhân Pixel, bảng này cung cấp các tổ hợp bản dựng được hỗ trợ.

Cảnh báo: Các nhân phát triển này có thể không ổn định và khiến thiết bị của bạn gặp trục trặc. Hãy thận trọng và nhớ sao lưu dữ liệu trước khi cài đặt một nhân tuỳ chỉnh.

Các tổ hợp nền tảng và nhân Android được hỗ trợ trên Pixel 6 và Pixel 6 Pro

Nhánh tệp kê khai nhân Pixel	Nhánh GKI	Bản dựng nền tảng Android
gs-android-gs-raviole-mainline	android-mainline	android-latest-release
gs-android16-6.12-gs101	android16-6.12	android-latest-release
gs-android13-gs-raviole-5.15	android13-5.15	TQ1A.230205.002 (9471150)

Chuẩn bị thiết bị Pixel

Biểu đồ quy trình sau đây mô tả quy trình cập nhật nhân trên thiết bị Pixel 6 trở lên:

Cài đặt ROM cho thiết bị bằng flash.android.com

Lưu ý: Bạn cần phải mở khoá trình tải khởi động thì mới có thể chạy flash cho thiết bị. Tham khảo phần Khoá và mở khoá trình tải khởi động.

1. Truy cập vào flash.android.com.
2. Chọn bản dựng Android dựa trên các tổ hợp Nền tảng và Nhân Android được hỗ trợ.
   • Đối với android-latest-release, hãy chọn "Quay lại phiên bản công khai", Canary hoặc Beta.
3. Chọn các mục sau:
   • Xóa dữ liệu thiết bị
   • Buộc Flash tất cả các phân vùng
   • Tắt quy trình xác minh
4. Nhấn vào nút Install build (Cài đặt bản dựng) để truyền nhanh thiết bị.

Đồng bộ hoá kho lưu trữ nhân

Chạy các lệnh sau để tải mã nguồn nhân xuống. Tham khảo bảng Các tổ hợp Nền tảng và Nhân Android được hỗ trợ trên Pixel 6 và Pixel 6 Pro cho Pixel KERNEL_MANIFEST_BRANCH.

repo init -u https://android.googlesource.com/kernel/manifest -b KERNEL_MANIFEST_BRANCH

repo sync -c --no-tags

Cập nhật ramdisk của nhà cung cấp

Lưu ý quan trọng: Bỏ qua phần này đối với các thiết bị Pixel 7 trở lên. Chỉ các thiết bị Pixel 6, Pixel 6 Pro và Pixel 6a mới cần cập nhật ramdisk của nhà cung cấp. Các thiết bị Pixel 7 trở lên chia phân vùng vendor_boot thành hai phân vùng – vendor_boot và vendor_kernel_boot, trong đó các cấu phần phần mềm của nhân hoàn toàn nằm trong hình ảnh vendor_kernel_boot.

Lưu ý quan trọng: Kho lưu trữ nhân của Pixel 6, Pixel 6 Pro và Pixel 6a có một ramdisk nhà cung cấp Android được tạo sẵn có thể không khớp với bản dựng Android trên thiết bị của bạn. Sự không khớp này thường dẫn đến lỗi SELinux khiến thiết bị không khởi động được.

Cập nhật tệp vendor_ramdisk-DEVICE.img trong kho lưu trữ nhân để khớp với bản dựng nền tảng Android được flash trên thiết bị. Có một số cách để cập nhật tệp vendor_ramdisk-DEVICE.img. Hãy sử dụng lựa chọn (1) nếu bạn đang dùng Android 15 QPR2 (BP11.241025.006) trở lên. Nếu không, hãy sử dụng lựa chọn (2).

• Lựa chọn 1) Chỉ cập nhật các bit DTB và DLKM của phân vùng vendor_boot

  Kể từ phiên bản fastboot 35.0.2-12583183, bạn có thể trực tiếp flash DTB và DLKM ramdisk trên phân vùng vendor_boot. Nâng cấp platform-tools Android lên phiên bản 36.0.0 trở lên để sử dụng lựa chọn này. Để thực hiện việc này, hãy chạy lệnh sau:

  $ANDROID_HOME/cmdline-tools/latest/bin/sdkmanager "platform-tools"
  

  Làm theo hướng dẫn để flash DTB và vendor_boot:dlkm trong Flash the kernel images (Flash hình ảnh nhân).

• Cách 2) Trích xuất hình ảnh ramdisk của nhà cung cấp từ hình ảnh gốc của Pixel.

  1. Tải hình ảnh gốc được hỗ trợ cho thiết bị của bạn xuống từ https://developers.google.com/android/images.

     Lưu ý: Đối với các thiết bị Pixel 6, Pixel 6 Pro và Pixel 6a, hãy chọn bản dựng được cài đặt trên thiết bị để ramdisk của nhà cung cấp khớp với bản dựng nền tảng. Bạn có thể sử dụng flash.android.com nếu muốn thay đổi bản dựng Android trên thiết bị.

  2. Trích xuất vendor_boot.img:

     Các lệnh sau đây sử dụng AP1A.240505.004 của Pixel 6 Pro làm ví dụ. Thay thế tên tệp zip bằng tên tệp của hình ảnh gốc mà bạn đã tải xuống.

       unzip raven-ap1a.240505.004-factory-9d783215.zip
     

       cd raven-ap1a.240505.004
     

       unzip image-raven-ap1a.240505.004.zip vendor_boot.img
     

  3. Giải nén vendor_boot.img để lấy ramdisk của nhà cung cấp.

       KERNEL_REPO_ROOT/tools/mkbootimg/unpack_bootimg.py --boot_img vendor_boot.img \
           --out vendor_boot_out
     

  4. Sao chép tệp vendor-ramdisk-by-name/ramdisk_ đã trích xuất vào kho lưu trữ nhân Pixel.

     Thiết bị	DEVICE_RAMDISK_PATH
     Pixel 6 (oriole) Pixel 6 Pro (raven)	prebuilts/boot-artifacts/ramdisks/vendor_ramdisk-oriole.img
     Pixel 6a (bluejay)	private/devices/google/bluejay/vendor_ramdisk-bluejay.img

       cp vendor_boot_out/vendor-ramdisk-by-name/ramdisk_ \
           KERNEL_REPO_ROOT/DEVICE_RAMDISK_PATH
     

Biên dịch nhân

Trong Android 13, tập lệnh build.sh được thay thế bằng một hệ thống tạo kernel mới có tên là Kleaf. Đối với các thiết bị sử dụng android13-5.15 trở lên, bạn nên tạo nhân bằng Kleaf.

Để thuận tiện, bạn có thể chạy tập lệnh build_DEVICE.sh có trong KERNEL_REPO_ROOT. Trong hầu hết các trường hợp, DEVICE phải là tên mã. Tên mã này có thể là tên mã của một thiết bị, chẳng hạn như "akita" (Pixel 8a) hoặc tên mã đại diện cho một nhóm thiết bị có liên quan dùng chung một nhân, chẳng hạn như "caimito" có nghĩa là Pixel 9 (tokay), Pixel 9 Pro (caiman) và Pixel 9 Pro XL (komodo). Đối với phiên bản android14 trở xuống, hãy dùng build_slider.sh cho Pixel 6 và Pixel 6 Pro, còn build_cloudripper.sh cho Pixel 7 và Pixel 7 Pro.

Ví dụ: để tạo kernel cho Pixel 6 trên nhánh android-gs-raviole-5.10-android14, bạn sẽ chạy lệnh:

build_slider.sh

Theo mặc định trên các nhánh hạt nhân sản xuất, tập lệnh build_DEVICE.sh sẽ sử dụng hạt nhân GKI được tạo sẵn để tăng tốc quá trình xây dựng. Nếu bạn muốn sửa đổi nhân hệ điều hành, hãy đặt biến môi trường BUILD_AOSP_KERNEL=1 để tạo nhân từ các nguồn cục bộ. Theo mặc định, các nhánh kernel phát triển sẽ trực tiếp tạo nguồn kernel.

Để biết thêm thông tin chi tiết về hệ thống xây dựng nhân và cách tuỳ chỉnh bản dựng, hãy tham khảo bài viết Kleaf – Xây dựng nhân Android bằng Bazel.

Nạp các hình ảnh nhân

Lưu ý: Nếu chưa tắt quy trình xác minh, bạn cần phải tắt trước khi cài đặt kernel tuỳ chỉnh. Sau đây là lệnh để thực hiện việc này:

fastboot oem disable-verification

CẢNH BÁO: Nếu đang cài đặt một nhân tuỳ chỉnh lên trên bản dựng nền tảng, thì bạn có thể cần xoá dữ liệu trên thiết bị nếu có bản hạ cấp mức bản vá bảo mật (SPL) liên kết với nhân mới. Quá trình này sẽ xoá toàn bộ dữ liệu cá nhân của bạn. Hãy nhớ sao lưu dữ liệu trước khi xoá.

fastboot -w

Để cài đặt ROM hình ảnh nhân, hãy chạy lệnh fastboot flash cho từng phân vùng nhân được liệt kê cho thiết bị của bạn. Đối với các phân vùng động, bạn cần khởi động lại ở chế độ fastbootd trước khi nhấp nháy.

Thiết bị	Phân vùng kernel
Pixel 6 (oriole) Pixel 6 Pro (raven) Pixel 6a (bluejay)	boot dtbo vendor_boot hoặc vendor_boot:dlkm vendor_dlkm (phân vùng động)
Pixel 9 (tegu) Pixel 9 Pro Fold (comet) Pixel 9 (tokay) Pixel 9 Pro (caiman) Pixel 9 Pro XL (komodo) Pixel 8 (shiba) Pixel 8 Pro (husky) Pixel Fold (felix) Pixel Tablet (tangorpro) Pixel 7a (lynx) Pixel 7 (panther) Pixel 7 Pro (cheetah)	boot dtbo vendor_kernel_boot vendor_dlkm (phân vùng động) system_dlkm (phân vùng động)

Sau đây là các lệnh nhấp nháy cho Pixel 6 trên android-mainline:

fastboot flash boot        out/slider/dist/boot.img
fastboot flash dtbo        out/slider/dist/dtbo.img
fastboot flash  --dtb out/slider/dist/dtb.img vendor_boot:dlkm out/slider/dist/initramfs.img
fastboot reboot fastboot
fastboot flash vendor_dlkm out/slider/dist/vendor_dlkm.img

Đối với Pixel 6, Pixel 6 Pro và Pixel 6a, nếu bạn đã cập nhật vendor_ramdisk trong phần Cập nhật ramdisk của nhà cung cấp, thì thay vào đó, hãy dùng lệnh sau để cập nhật phân vùng vendor_boot:

fastboot flash vendor_boot out/slider/dist/vendor_boot.img

Bạn có thể tìm thấy hình ảnh của nhân trong DIST_DIR.

Nhánh kernel	DIST_DIR
v5.10	out/mixed/dist
v5.15 trở lên	out/DEVICE/dist

Lưu ý: Nếu bạn có một khoá nối tiếp và muốn bật nhật ký nối tiếp, thì lệnh là:

fastboot oem uart enable
fastboot oem uart config 3000000

Ví dụ về lệnh kết nối từ máy chủ:

screen -fn /dev/ttyUSB* 3000000

Khôi phục hình ảnh gốc

Để khôi phục thiết bị về hình ảnh gốc, bạn có thể sử dụng flash.android.com.

Tạo và flash nhân Pixel nguồn

Vì Pixel 6 và Pixel 6 Pro được hỗ trợ trong nhân Linux nguồn trên, nên bạn có thể sử dụng android-mainline chỉ với các trình điều khiển nguồn trên để khởi động đến một lời nhắc của shell thiết bị cho quá trình phát triển nhân. Phần này cung cấp các bước để đồng bộ hoá, tạo và chạy một nhân Pixel 6 và Pixel 6 Pro từ android-mainline.

Hãy làm theo các bước tiếp theo để bắt đầu.

1. Chuẩn bị thiết bị bằng cách làm theo các bước trong phần Chuẩn bị thiết bị Pixel
2. Đồng bộ hoá nhánh tệp kê khai nhân common-android-mainline bằng cách làm theo các bước trong phần Đồng bộ hoá kho lưu trữ nhân.

3. Cấu hình mục tiêu bản dựng Kleaf được xác định trong đường dẫn KERNEL_REPO_ROOT/devices/google/raviole. Để biên dịch mục tiêu bản dựng raviole_upstream, hãy chạy lệnh Kleaf:

   tools/bazel run //devices/google/raviole:raviole_upstream_dist
   

4. Tương tự như các nhân sản xuất, hãy tắt quy trình xác minh và xoá dữ liệu trên thiết bị khi cài đặt ROM một nhân tuỳ chỉnh lên trên các hình ảnh gốc của Android. Hãy tham khảo các ghi chú trong phần Nạp các hình ảnh kernel để biết thêm thông tin chi tiết.

5. Ở chế độ fastboot, hãy chạy các lệnh sau để flash hình ảnh kernel:

   fastboot flash boot        out/raviole_upstream/dist/boot.img
   fastboot flash dtbo        out/raviole_upstream/dist/dtbo.img
   fastboot flash  --dtb out/raviole_upstream/dist/dtb.img \
       vendor_boot:dlkm out/raviole_upstream/dist/initramfs.img
   

   Lưu ý: Mục tiêu bản dựng nguồn không thể khởi động vào màn hình chính của Android. Nếu bạn thử, thiết bị sẽ không phản hồi và chờ SurfaceFlinger trong vài phút. Bạn có thể nhấn và giữ đồng thời nút Nguồn và nút Giảm âm lượng trong 1 phút để buộc thiết bị khởi động lại vào chế độ khởi động nhanh.

6. Để truy cập vào dấu nhắc shell của thiết bị, bạn có thể khởi động lại ở chế độ khôi phục bằng cách chạy lệnh:

   fastboot reboot recovery
   

   Mở shell thiết bị bằng cách chạy lệnh adb shell. Bạn cũng có thể sử dụng quyền truy cập gốc bằng cách chạy lệnh adb root.

Nhân Pixel cũ

Để tham khảo, bảng Các nhánh kernel Pixel cũ cung cấp các nhánh kho lưu trữ kernel cho thiết bị Pixel 5 trở xuống. Đây là những thiết bị không được GKI hỗ trợ.

Các nhánh kernel Pixel cũ

Thiết bị	Đường dẫn nhị phân trong cây AOSP	Nhánh kho lưu trữ
Pixel 5a (barbet) Pixel 4a (5G) (bramble) Pixel 5 (redfin)	device/google/redbull-kernel	android-msm-redbull-4.19-android14-qpr3
Pixel 4a (sunfish)	device/google/sunfish-kernel	android-msm-sunfish-4.14-android13-qpr3
Pixel 4 (đỏ cam) Pixel 4 XL (cam san hô)	device/google/coral-kernel	android-msm-coral-4.14-android13
Pixel 3a (sargo) Pixel 3a XL (bonito)	device/google/bonito-kernel	android-msm-bonito-4.9-android12L
Pixel 3 (blueline) Pixel 3 XL (crosshatch)	device/google/crosshatch-kernel	android-msm-crosshatch-4.9-android12
Pixel 2 (walleye) Pixel 2 XL (taimen)	device/google/wahoo-kernel	android-msm-wahoo-4.4-android10-qpr3
Pixel (sailfish) Pixel XL (marlin)	device/google/marlin-kernel	android-msm-marlin-3.18-pie-qpr2