Uotan Wiki · 刷机百科 - 用户贡献 [zh-cn]

Android 版本合集

2025-06-08T06:11:03Z

MoeGLuwu：Androidversion: A16 will release in 2025/06

说明：Android 10开始，Google不再使用甜品代号来公开命名Android版本。本wiki如有记录则为其内部代号。

{| class="wikitable"
|+
!版本
!API版本
!代号
!发布时间
|-
|Android 1.0
|1
|无
|2008/09
|-
|Android 1.1
|2
|Base
|2009/02
|-
|Android 1.5
|3, NDK 1
|Cupcake
|2009/04
|-
|Android 1.6
|4, NDK 2
|Donut
|2009/09
|-
|Android 2.0
|5
|Eclair
|2009/10
|-
|Android 2.0.1
|6
|Eclair
|2009/12
|-
|Android 2.1
|7, NDK 3
|Eclair
|2010/01
|-
|Android 2.2.x
|8, NDK 4
|Froyo
|2010/05
|-
|Android 2.3-2.3.2
|9, NDK 5
|Gingerbread
|2011/01
|-
|Android 2.3.3-2.3.7
|10
|Gingerbread
|2011/09
|-
|Android 3.0
|11
|Honeycomb
|2011/02
|-
|Android 3.1
|12, NDK 6
|Honeycomb
|2011/05
|-
|Android 3.2.x
|13
|Honeycomb
|2011/07
|-
|Android 4.0.1-4.0.2
|14, NDK 7
|IceCreamSandwich
|2011/10
|-
|Android 4.0.3-4.0.4
|15, NDK 8
|IceCreamSandwich
|2012/02
|-
|Android 4.1(.1)
|16
|JellyBean
|2012/06
|-
|Android 4.2-4.2.2
|17
|JellyBean
|2012/11
|-
|Android 4.3
|18
|JellyBean
|2013/07
|-
|Android 4.4
|19-20
|KitKat
|2013/10
|-
|Android 5.0-5.1
|21-22
|Lollipop
|2014/11
|-
|Android 6.0
|23
|Marshmallow
|2015/10
|-
|Android 7.0-7.1
|24-25
|Nougat
|2016/08
|-
|Android 8.0-8.1
|26-27
|Oreo
|2017/08
|-
|Android 9.0
|28
|Pie
|2018/08
|-
|Android 10
|29
|QuinceTart
|2019/09
|-
|Android 11
|30
|RedVelvetCake
|2020/09
|-
|Android 12(L)
|31-32
|SnowCone
|2021/10
|-
|Android 13
|33
|Tiramisu
|2022/08
|-
|Android 14
|34
|UpsideDownCake
|2023/08
|-
|Android 15
|35
|VanillaIceCream
|2024/10
|-
|Android 16
|36
|Baklava
|2025/06
|}

AOSPA

2025-06-08T06:07:31Z

MoeGLuwu：

<gallery>
文件:AOSPA.png|Logo
</gallery>AOSPA(Paranoid Android)是一个基于Qualcomm codelinaro的Android类原生项目，比较接近高通的系统，自定义选项并不多

目前有Android13和Android14两个Android版本，持续更新

官网: [https://paranoidandroid.co/ AOSPA]

Github: [https://github.com/AOSPA Github]

RisingOS

2025-02-01T03:38:51Z

MoeGLuwu：Custom rom: Bye RisingOS

[[文件:Rising os banner1.png|缩略图]]
risingOS 是一款开源的类原生 Android 操作系统，旨在带来独特而新鲜的用户体验。

risingOS有Android 13-15的构建。
于2025年2月1日宣布EOL，并删除了GitHub仓库，仅保留了设备树。

risingOS提供了极其丰富的自定义功能（多到容易产生bug），具有Vanilla和GMS build两种选择。

GitHub：https://github.com/RisingTechOSS/

官网：https://risingos-staging.github.io/

附一些界面截图。
[[文件:Screenshot Image3.png|左|来自官方的截图]]
[[文件:Screenshot1.png|缩略图|来自官方的截图之一]]

Git使用教程

2024-08-25T03:09:48Z

MoeGLuwu：/* git push */

=== Git的由来： ===
Git是一个开源的分布式版本控制系统，可以有效、高速地处理从很小到非常大的项目版本管理，也是Linus Torvalds为了帮助管理Linux内核开发而开发的一个开放源码的版本控制软件。Torvalds 开始着手开发 Git 是为了作为一种过渡方案来替代 BitKeeper。

=== 常见的代码托管平台： ===
[https://github.com Github]

[https://gitlab.com Gitlab]

[https://gitee.com Gitee]

=== Git 常见命令: ===

==== git init ====
在本地目录中初始化一个新的Git仓库

==== git config ====
用于配置用户的信息以及其他设置,在使用git之前您必须完成以下步骤。

<code>git config --global user.name "your username"</code>

<code>git config --global user.email "your email"</code>

更改默认编辑器

<code>git config --global core.editor nano</code>

==== git clone ====
用于将远程仓库的代码克隆到本地，以下是命令中各个参数的含义：

<code><url></code>

克隆某个地址(url)的仓库，远程仓库的地址可以是本地的目录，也可以是例如github,giteee,gitlab一类的代码托管平台

<code>--depth=<number></code>

克隆仓库并且保留number条提交历史，number在此处即表达我们克隆的深度。

<code>-b <branch></code>

克隆指定分支下的仓库内容

例如我们要克隆<code>LineageOS</code>的内核源码，指定<code>lineage-21</code>分支，且仅保留最近一个提交，则需要输入:

<code>git clone -b lineage-21 <nowiki>https://github.com/LineageOS/android_kernel_xiaomi_sdm845</nowiki> --depth=1</code>

==== git add ====
添加某个文件，或者目录到暂存区，用于告诉git你需要将哪些文件的更改包含在下一次的提交(commit)之中添加一个或者多个文件到暂存区之中

<code>git add [file1] [file2]</code>

添加指定目录(文件)到暂存区，包括子目录：

<code>git add [dir]</code>

添加当前目录下的所有文件到暂存区：

<code>git add .</code>

==== git status ====
查看当前仓库的状态，此时git会在你的终端输出以下内容
此处演示为英文，如果您的git终端输出为中文也是同理的
<pre>
On branch master
No commits yet
Changes to be committed:

(use “git rm --cached <file>...” to unstage)
new file: makefile
</pre>

输出内容分别为
<pre>
您目前所在的分支
目前的提交
需要更改的内容
新增的文件
修改的文件
删除的文件
</pre>

==== git commit ====
用于将暂存区我们保存的更改文件添加到本地仓库，并且会生成一条提交（commit）

提交暂存区的更改到本地仓库

git commit

这一操作将会打开 git 的默认的文本编辑器，你应该在这里写明 commit message. 第一行是标题，下面的都是解释说明，前面带有#的行不会被列入文本中.

好的 commit message 是方便所有人的举措. 对初学者来说，不要求做的多么规范，但是建议做到以下几点：

- 简短说明本次 commit 做了什么，至少你自己看一眼能知道自己在干什么

- 尽力做到一个 commit 一个修改，尽量不要大杂烩或者一个修改拖好几个 commit

- 如果是比较大的项目（例如 Android Kernel），尽量写明你所修改的模块，令人一目了然. 例如:

<code>ARM64: configs: enchilada: Disable virtual terminal</code>

您必须注意：

- 如果这个提交是别人的，必须用<code>--author="ExampleName <example@example.com>"</code>参数说明这是哪位作者的提交. 这是对他人思考和试验成果的尊重.

- Commit message 里不得谩骂他人，不要带有其他人或者你自己的无关私人信息.

如果想要直接提交而不添加暂存区（偷懒），可以指定<code>-a</code>参数.

您也可以使用<code>-m "example commit message"</code>来直接 commit.

==== git checkout ====

* 用于分支切换

切换分支：

<code>git checkout <branch-name></code>

<code>git checkout <branch-name></code>

例如在您的仓库中有这几个分支：
<pre>
-> master (Default)
backup
test
</pre>
您当前处于 master 分支，如果想要切换到test分支，我们可以使用

<code>git checkout test</code>

* 用于检出文件
将指定的文件恢复到最新的提交状态，撤销你对其的更改

<code>git checkout -- <file></code>

==== git push ====
用于将本地的分支版本上传到远程仓库并进行合并

<code>git push <remote-host-name> <local-branch-name>:<remote-branch-name></code>

remote-host-name:远程主机名

local-branch-name:本地分支名

例如，当你的远程主机名为origin ，本地分支名为master，远程分支名为master时：

<code>git push origin master:master</code>

例如，当你的rhost名为origin 本地分支名为master远程分支名为master时：

本地和远程分支名相同，上述命令可以简写为：

<code>git push origin master</code>

当你的远程版本与本地版本有差异，无法直接push时，你可以使用--force 参数来进行强制推送

<code>git push --force origin master</code>

--force 此处可以直接简单化为 -f . 强烈建议使用 --force-with-lease参数，更为安全.

如果你想要删除主机内的某个分支，你可以使用--delete参数

<code>git push origin --delete <branch-name></code>

==== git diff ====
用于比较当前工作区与上一个版本之间的差异<pre>
diff --git a/example b/example

index fbb8c85..d65c7eb 100644

--- a/example

+++ b/example

@@ -1 +1,2 @@

114514

+1919180
</pre>

==== git log ====
用于查看提交的历史

例如当你进行一次提交之后，执行 <code>git log</code>终端会输出

<pre>
commit 3a5b0d12f471418b13f2baf5e9e4c112a5e804a8 (HEAD -> master)

Author: luluzzy <1054438588@qq.com>

Date: Thu Feb 15 21:28:47 2024 +0800

initial commit: add makefile
</pre>

这些输出分别为
<pre>
commit sha1 hash: 针对你这个提交的 commit id
Author: commit 作者名称 <you@example.com>
Date: commit 日期
commit: 名称
</pre>

关于sha1_hash的介绍请看这里<ref>生成这个hash值，它是对那个commit是Git仓库中内容和头信息Header的一个校验和checksum。Linux kernel开创者和Git的开发者——Linus说，Git使用了sha1并非是为了安全性，而是为了数据的完整性；它可以保证，在很多年后，你重新checkout某个commit时，一定是它多年前的当时的状态，完全一摸一样，完全值得信任。在Git中，根据commit的sha1值40个十六进制数字进行了简单的划分目录，以前2位数字作为目录名，其下面是剩余38位数字组成的一个文件名</ref>

当有多次提交之后，如果我们想要翻之前的提交历史，难免会因为终端输出的内容过多而难以查看翻阅

此时我们可以使用<code>--online</code>参数来简化输出，此时仅会输出: sha1哈希值 + commit的名称

例如
<pre>
347595d (HEAD -> master) modify makefile

3a5b0d1 initial commit: add makefile
</pre>

==== git cherry-pick ====

cherry-pick (遴选) 和它的名称一样，挑选一个我们需要的 commit 进行操作。它可以用于将在其他分支上的 commit 修改，移植到当前的分支。

如果我们想在我们正在开发的版本上，添加一个其他版本中的功能代码。就可以使用 cherry-pick ，将这个功能相关的 commit 提取出来，合入该版本。

<code>git cherry-pick <commit-id></code>

当我们执行完 <code>cherry-pick</code>操作之后，会自动生成一个<code>commit</code>以及对应新的<code>commit-id</code>

在顺利的情况下我们可以直接通过，但如果遇到代码等因为变量名，写法等不同的情况，<code>cherry-pick</code>大概率会报错，此时我们需要进行报错处理。

第一种方案是手动修改

我们可以先使用<code>git status</code>检查当前遴选时冲突的文件

然后 <code>git checkout --ours filename</code>

然后按照提交的修改内容进行手动修改

随后使用<code>git add</code>命令将文件重新加入暂存区

再使用

<code>git cherry-pick --continue</code>

命令让 cherrypick 操作继续执行。

第二种方案是直接退出<code>cherry-pick</code>进程，一般适用于冲突文件实在太多了难以按照方案一处理的情况。

需要注意的是，如果您当前正在遴选的提交在该分支已经存在也会冲突，在这种情况下，您需要解决冲突并手动解决问题。

<code>git cherry-pick --abort</code>

==== git fetch ====
git fetch 命令用于从远程获取仓库。

==== git merge ====
<code>git merge</code>是用来把分叉的提交历史放回到一起(合并)的方式。

git merge命令用来将你之前使用git branch命令创建的分支以及在此分支上独立开发的内容整合为一个分支。

本

==== git pull ====
用于从远程获取代码并合并本地的版本。

<code>git pull</code>其实就是<code>git fetch</code>和<code>git merge FETCH_HEAD</code> 的简写。

格式如下：

<code>git pull <remote-host-name> <remote-branch-name>:<local-branch-name></code>

==== git rebase ====
用于需要修改历史上某一项commit

<code>git rebase -i HEAD~<commit number></code>

commit number就是从头部往前数的commit数量。执行后会弹出你在git config内配置的编辑器，若未配置则是默认，vim居多。然后就可以看见一堆commit前面有pick字样。可以将pick替换为你想要的操作。
有以下操作：

1.edit，顾名思义编辑此commit，替换完保存后请修改内容，使用<code>git add</code>或vscode，github desktop将修改文件添加到暂存区，之后命令行执行<code>git commit --amend</code>这样commit就修改成了

2.squash，合并几个提交，确认一个父提交，将要合并的commit，从下向上替换字符串，会从下向上合并(方位指的是<code>git rebase</code>后弹出的编辑器)

3.drop，需要移除的commit

4.reword，修改commit信息

另外，还可以使用首字母来说明命令。

==== git subtree ====
子树，在Android开发中多用于Kernel侧更改，如跟踪audio模块等

<code>git subtree add --prefix=<目录> <仓库地址> <远程分支></code>

如果需要更新远程库时

<code>git subtree pull --prefix=<目录> <仓库地址> <远程分支></code>

==== git submodule ====

===== 子模块功能的概述 =====
<code>git submodule</code>允许在自己的Github仓库里加入别人的github仓库，作为自己仓库的子仓库(即submodule)。

为什么我们会需要使用子模块？当我们维护一个项目时有可能遇到以下情况，例如维护某款机型的KernelSU内核，我们需要将KernelSU导入至我们的内核源码中，如果我们直接clone进去容易带来一个问题，如果KernelSU更新了怎么办？此时我们便可以使用子模块来解决这个问题

<code>git submodule</code>允许在git仓库里存放别人仓库的url，作为自己的子模块，其核心内容是在Git仓库里面加入一个<code>.gitmodules</code>文件，里面会记录各个submodule的名字，路径，以及对应链接。

===== 加入子模块 =====
<code>git submodule add <url> <path></code>

此时 <code>.gitmodules</code>内会自动生成以下内容

[submodule "xxx"]

path = xxx

url = xxx

===== 初始化子模块 =====
<code>git submodule init</code>

===== 更新子模块 =====
<code>git submodule update</code>

=== Git进阶 ===

==== GPG key ====

===== 简介 =====
平时在Github上摸鱼的时候，是不是经常能看见如下图所示，有一个绿色的"Verified"字样，看着很酷，实际上这是为了确保commit为开发者本人所写的进行的GPG签名。
[[文件:Github GPG sign.png|居中]]
因为Git的默认机制，任何人都可以通过你的邮箱和用户名创建虚假的commit，甚至你名气很大的话可以“栽赃陷害”你。如果你是某高校计算机专业的同学亦或是对计算机抱有很大的兴趣，乐意为开源社区提供“资源”，那么我建议你设置GPG sign。未来是不可预知的，人人都可能成为巨佬。

===== 使用 =====
因为我只在Mac环境下配置过GPG，Windows只是打游戏用，所以用的少，Linux/类Unix可以参考一下。其它系统等待他人补充......

====== Mac ======
Mac默认是不带GPG的，需要通过第三方软件包安装器Homebrew进行安装，首先先安装Homebrew，如已安装可以跳过。

编辑器限制原因不能使用默认标题进行分步了，故使用1、2、3等小数字代替。

安装Homebrew

在安装之前需要从系统信息中查看芯片为Intel/M系列

Intel使用

<code>/bin/zsh -c "$(curl -fsSL <nowiki>https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh</nowiki>)"</code>

Intel按照脚本提示，选源，输密码，回车一路绿灯就好了，如果这都不会......可能你不是很适合开发，因为该脚本是国内开发者编写的，中文和一键化安装都集齐了。

M系列使用

<code>/bin/zsh -c "$(curl -fsSL https://gitee.com/huwei1024/HomebrewCN/raw/master/Homebrew.sh)"</code>

并且因为M系列系统结构发生改变，包安装位置不在是以前的/usr/local/，而是在/opt/homebrew，所以要将配置文件里的环境变量改过来。

1.首先进入根目录

<code>cd ~</code>

2.创建.zshrc文件

<code>touch .zshrc</code>

3.打开文件进行编辑

<code>open -e .zshrc</code>

4.如果有旧的环境就修改，没有就新增

<code>export PATH="/opt/homebrew/bin:$PATH"

export PATH="/opt/homebrew/sbin:$PATH"</code>

5.保存

使用command + s

6.生效环境变量

<code>source .zshrc</code>

7、测试

<code>brew -v</code>

若终端顺利打印出brew的版本，那么就安装成功了！

注：本人没有使用过M系列设备，该教程在知乎上找到的

使用Homebrew安装GPG

<code>brew install gnupg pinentry-mac</code>

[[文件:截屏2024-02-17 17.34.48.png|居中]]

为GPG添加环境变量，否则在签名的时候会发生报错（使用bash请自行替换配置文件）

<code>echo "export GPG_TTY=$(tty)" >> ~/.zshrc
source ~/.zshrc
</code>

生成一个GPG keys

<code>gpg --full-generate-key</code>

[[文件:截屏2024-02-17 17.45.51.png|居中]]

默认使用的是ECC，我使用的是RSA，按照自己喜好，或从百度搜索非对称和对称加密算法之间的区别，这里只做使用方法的介绍，不做赘述。

然后添写密钥长度和使用有效期，这里建议选择长期，并做备份，一辈子用一个就够了。

[[文件:截屏2024-02-17 17.46.06.png|居中]]
[[文件:截屏2024-02-17 17.46.35.png|居中]]

个人信息按照Github信息填写，真实姓名对应Username。填写完毕按回车输入O即可生成密钥。不出意外的话会弹出Gui窗口让你设置密钥密码，强烈建设设置一个较为复杂的密码，并牢记，当然也可以不设置。

使用GPG对Git的commit和tag进行签名

先为Git定义GPG二进制所在地

<code>git config --global gpg.program $(which gpg)</code>

查看GPG keys ID

<code>gpg --list-secret-keys --keyid-format=long</code>

如图所示RSA/后面紧跟的一串就是GPG keys ID
[[文件:截屏2024-02-17 17.57.01.png|居中]]
<code>git config --global user.signingkey "GPG key ID"</code>

为Git设置全局commit和tag签名

<code>git config --global commit.gpgsign true

git config --global tag.gpgSign true</code>

参见本文“在Github配置GPG keys”部分开启下一步操作

接下来就可以愉快的编写程序了~

======在Github配置GPG keys======
在终端输入

<code>gpg --armor --export "GPG key ID"</code>

将输出的内容从-----BEGIN PGP PUBLIC KEY BLOCK-----到-----END PGP PUBLIC KEY BLOCK-----，包含它们都复制下来。

打开Github网页，并登录自己的账号。按照下述操作依次执行。

头像-->Setting-->SSH and GPG keys-->New GPG key

标题自己怎么舒服怎么来，将第一步复制的内容全部粘贴然后保存起来，这样Github就能识别到你commit中包含的GPG sign的信息了，你就可以在commit history或release等页面看到绿色的签名后的标志了。

==== SSH key ====
可以通过生成SSH key，并保存在Github等托管平台上实现免密Push，这也是官方推荐的方法，过去输入用户名/密码的方式早已被抛弃。

===== 生成Key =====
1.打开终端并输入

<code>ls ~/.ssh</code>

检查是否已经存在了SSH密钥。如果你看到包含id_rsa等文件，说明你已经有了SSH key，可以跳过第 2 步和第 3 步。

2.输入，生成新的SSH密钥。你可以直接按回车键使用默认的文件路径和空密码，也可以自己设置。

<code>ssh-keygen -t rsa -b 4096 -C "your_email@example.com"</code>

4.在终端输入或使用文本编辑器打开，并复制所有内容

<code>vim ~/.ssh/id_rsa.pub</code>

5.打开Github网页，并登录自己的账号。按照下述操作依次执行。

头像-->Setting-->SSH and GPG keys-->New SSH key

自己起个标题名并粘贴4步中所有内容，保存，接下来你可以免密对Github上的repo进行操作了。

==== 参考资料： ====
[1] 百度百科 -- Git：<nowiki>https://baike.baidu.com/item/GIT/12647237?fr=ge_ala</nowiki>

[2] 菜鸟教程 -- Git基本操作：<nowiki>https://www.runoob.com/git/git-basic-operations.html</nowiki>

[3] CSDN -- git merge 使用简介: <nowiki>https://blog.csdn.net/All_In_gzx_cc/article/details/125482617</nowiki>

[4] 知乎 -- MAC 安装 homebrew 国内镜像: <nowiki>https://zhuanlan.zhihu.com/p/547898033</nowiki>

[5] Github -- Generating a new GPG key: <nowiki>https://docs.github.com/en/authentication/managing-commit-signature-verification/generating-a-new-gpg-key</nowiki>

[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>

[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>

[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>

Android内核编译入门

2024-08-25T03:07:19Z

MoeGLuwu：/* 设置环境变量并开始编译 */

=== Android 内核简介 ===
安卓内核用的也是linux（LTS），google把LTS内核和Android的一些补丁、模块结合形成自己的Android通用内核（Android common kernel，ACK）。也就是GKI, Generic Kernel Image。如果你的手机是量产机（Google除外），还会被cpu厂商例如高通，联发科再次开发，下放到手机厂商还会有部分修改。

相当于现在变成了一个Image，镜像了。

GKI 内核会与包含系统芯片 (SoC) 和板级代码的硬件专用供应商模块进行交互。GKI 内核与供应商模块之间的交互通过内核模块接口 (KMI) 来实现，该接口由标识供应商模块所需的函数和全局数据的符号列表组成。

=== 配置使用环境 ===

===== 推荐的编译环境 =====
Ubuntu 20.04 / 22.04

Arch Linux

(因为主播使用的就是这个喵）

考虑到编译环境的稳定性不是很推荐装一些其他的系统

你可以使用 VMware virtual machine 或者 WSL2 （Windows Subsystem on Linux）

目前我更推荐使用 WSL 因为其安装较为方便，并且可以与 Microsoft VScode 协同工作方便你对Git的使用以及对内核源码的修改

（当然 Vmware 也可以，只不过我印象不太好，这货 bug 稍微有点多）

关于这两者方案优劣对比详见百度，此处不赘述。

===== 安装WSL2教程 =====
需要先启用适用于 Linux 的 Windows 子系统以及虚拟化：

按下键盘<code>win+R</code>，并输入<code>powershell</code>回车

在<code>poershell</code>终端内输入以下内容:

<code>dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart</code>

<code>dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart</code>

<code>wsl --set --default-version 2</code>

随后打开你的微软应用商店 Microsoft Store

搜索 Ubuntu，选择一个你喜欢的版本安装即可

在安装完WSL后，我们可以注意到其默认安装目录为：<code>C：Program Files\WindowsApps</code>

如果你需要拉内核源码的话后续会占用你大量C盘的空间，因此下一步我们对WSL进行迁移。

我们首先打开 <code>powershell</code>

随后输入 <code>wsl -l -v</code>之后powershell会输出一段：

NAME STATE VERSION

<nowiki>*</nowiki> Ubuntu-20.04 Stopped 2

确认目前状态为 Stopped 之后，我们输入：

<code>wsl --export Ubunut-20.04 D:\WSL\ubuntu-20.04.tar</code>

将WSL的系统镜像导出到其他盘，随后注销目前系统的WSL

<code>wsl --unregister Ubuntu-20.04</code>

随后我们导入刚才导出的tar文件<code>wsl --import <导入名称> <导入盘的路径> <刚才导出的tar的路径> --version 2</code>

例如根据上面的：

<code>wsl --import Ubuntu-20.04 D:\WSL D:\WSL\ubuntu-20.04.tar --version 2</code>

随后再次打开即可

===== 安装一些必要的工具依赖 =====
<code>apt-get update</code>

<code>apt-get install -y build-essential bc bison python curl git zip ftp gcc-aarch64-linux-gnu gcc-arm-linux-gnueabi libssl-dev lftp wget libfl-dev gcc bc zip make</code>

这些依赖可以通过百度查到对应的作用，此处不赘述。

如若你在编译时遇见提示缺依赖的情况，你也可以百度依赖的名字来查询解决方式。

* 安装/下载交叉编译工具链

'''Clang'''

此处推荐两个

一个是Google官方提供的Clang编译器：[https://android.googlesource.com/platform/prebuilts/clang/host/linux-x86/ Google Clang]

一个是由知名大佬kdrag0n 提供的预编译Clang：[https://github.com/kdrag0n/proton-clang Proton Clang]

==== 拉取内核源码 ====
关于如何找到你的内核源码这件事，大部分内核源码在开源时都会参照以下命名规则命名

<code>android_kernel_厂商_平台</code> 例如 <code>android_kernel_xiaomi_sm8250</code>

在针对特定机型进行优化或者重构后的源码也会有开发者将其命名为

<code>android_kernel_厂商_设备代号（或者机型名称）</code>

设备代号请参照这里：[[设备代号收录集合]]

我们一般可以在<code>Github</code>找到这些源码

如果您需要拉取ACK（Android Common Kernel）请前往Google OpenSource

==== 设置环境变量并开始编译 ====

本文将以较新的内核为示例，使用clang编译。部分设备内核可能需要纯gcc编译，此处暂时不做介绍。

首先你需要进入你内核源码的目录，你也可以将下列的指令写在脚本里面<pre>
export CC='放clang的路径/bin/clang'
export CLANG_TRIPLE=aarch64-linux-gnu-
export CROSS_COMPILE='aarch64-linux-gnu编译器的路径/bin/aarch64-linux-gnu-'
export CROSS_COMPILE_ARM32='arm-linux-gnueabi编译器的路径/bin/arm-linux-gnueabi-'
export ARCH=arm64
export SUBARCH=arm64
export KBUILD_BUILD_HOST = "hostname"
export KBUILD_BUILD_USER = "username"
make O=out ''device''_defconfig
</pre>
这里需要注意的是，最后的<code>device</code>

取决于你编译的设备的代号，查看你设备的代号请见：[[设备代号收录集合]]

如果是直接从apt等软件包仓库安装的GNU编译套件，那么<code>CROSS_COMPILE</code>可以直接设定为<code>aarch64-linux-gnu</code>. ...ARM32同理
而<code>defconfig</code>则是你设备在内核中的配置文件，一套内核源码可能被多个设备共有。在编译的时候，make通过不同的配置文件来区分这些设备，这些配置文件在arch/[架构]/config下，在make的时候无需指定路径，直接输入配置文件名字即可。<ref>此处引用了 grislux55 在gitbook上的内核编译教程中针对配置文件的介绍，文末贴上了引用资料链接</ref>

举个简单的例子，内核源码就是一个大超市，<code>defconfig</code>（'''购物清单'''）则负责告诉<code>make</code>，'''你需要购买什么东西（对其进行编译），从而达成对设备驱动的区分'''

=== 获取编译结果并刷入测试 ===
内核文件在[你的项目/输出路径/arch/目标内核架构/boot]下

例如我们编译了xiaomi_sdm8250的内核，则在android_kernel_xiaomi_sm8250/out/arch/arm64/boot/里面

其名为Image或者Image.gz或者Image.gz-dtb

他们的区别在于

随后你需要刷入测试，以前有一种方法是使用 Android Image Kitchen 来解开boot.img 并将你编译好的dtb替换进去，现在看来这种方法未免太不优雅，因此我们可以使用由osm0sis大佬开发的Anykernel3打包卡刷包文件，并可以在 TWRP REC 或者 Horizen Kernel Flasher内进行刷入附链接：

[https://github.com/osm0sis/AnyKernel3 ①Anykernel3] ②Horizen Kernel Flasher ③[https://twrp.me/ TWRP rec]

=== 资料参考： ===
[1] Gtibook 安卓内核编译教程：https://jebchou.gitbook.io/android-kernel-magic/02begin_compile

[2] CSDN 安卓架构-内核：https://blog.csdn.net/weixin_40557160/article/details/128388849

Git使用教程

2024-08-24T14:35:15Z

MoeGLuwu：git: git commit 重写

=== Git的由来： ===
Git是一个开源的分布式版本控制系统，可以有效、高速地处理从很小到非常大的项目版本管理，也是Linus Torvalds为了帮助管理Linux内核开发而开发的一个开放源码的版本控制软件。Torvalds 开始着手开发 Git 是为了作为一种过渡方案来替代 BitKeeper。

=== 常见的代码托管平台： ===
[https://github.com Github]

[https://gitlab.com Gitlab]

[https://gitee.com Gitee]

=== Git 常见命令: ===

==== git init ====
在本地目录中初始化一个新的Git仓库

==== git config ====
用于配置用户的信息以及其他设置,在使用git之前您必须完成以下步骤。

<code>git config --global user.name "your username"</code>

<code>git config --global user.email "your email"</code>

更改默认编辑器

<code>git config --global core.editor nano</code>

==== git clone ====
用于将远程仓库的代码克隆到本地，以下是命令中各个参数的含义：

<code><url></code>

克隆某个地址(url)的仓库，远程仓库的地址可以是本地的目录，也可以是例如github,giteee,gitlab一类的代码托管平台

<code>--depth=<number></code>

克隆仓库并且保留number条提交历史，number在此处即表达我们克隆的深度。

<code>-b <branch></code>

克隆指定分支下的仓库内容

例如我们要克隆<code>LineageOS</code>的内核源码，指定<code>lineage-21</code>分支，且仅保留最近一个提交，则需要输入:

<code>git clone -b lineage-21 <nowiki>https://github.com/LineageOS/android_kernel_xiaomi_sdm845</nowiki> --depth=1</code>

==== git add ====
添加某个文件，或者目录到暂存区，用于告诉git你需要将哪些文件的更改包含在下一次的提交(commit)之中添加一个或者多个文件到暂存区之中

<code>git add [file1] [file2]</code>

添加指定目录(文件)到暂存区，包括子目录：

<code>git add [dir]</code>

添加当前目录下的所有文件到暂存区：

<code>git add .</code>

==== git status ====
查看当前仓库的状态，此时git会在你的终端输出以下内容
此处演示为英文，如果您的git终端输出为中文也是同理的
<pre>
On branch master
No commits yet
Changes to be committed:

(use “git rm --cached <file>...” to unstage)
new file: makefile
</pre>

输出内容分别为
<pre>
您目前所在的分支
目前的提交
需要更改的内容
新增的文件
修改的文件
删除的文件
</pre>

==== git commit ====
用于将暂存区我们保存的更改文件添加到本地仓库，并且会生成一条提交（commit）

提交暂存区的更改到本地仓库

git commit

这一操作将会打开 git 的默认的文本编辑器，你应该在这里写明 commit message. 第一行是标题，下面的都是解释说明，前面带有#的行不会被列入文本中.

好的 commit message 是方便所有人的举措. 对初学者来说，不要求做的多么规范，但是建议做到以下几点：

- 简短说明本次 commit 做了什么，至少你自己看一眼能知道自己在干什么

- 尽力做到一个 commit 一个修改，尽量不要大杂烩或者一个修改拖好几个 commit

- 如果是比较大的项目（例如 Android Kernel），尽量写明你所修改的模块，令人一目了然. 例如:

<code>ARM64: configs: enchilada: Disable virtual terminal</code>

您必须注意：

- 如果这个提交是别人的，必须用<code>--author="ExampleName <example@example.com>"</code>参数说明这是哪位作者的提交. 这是对他人思考和试验成果的尊重.

- Commit message 里不得谩骂他人，不要带有其他人或者你自己的无关私人信息.

如果想要直接提交而不添加暂存区（偷懒），可以指定<code>-a</code>参数.

您也可以使用<code>-m "example commit message"</code>来直接 commit.

==== git checkout ====

* 用于分支切换

切换分支：

<code>git checkout <branch-name></code>

<code>git checkout <branch-name></code>

例如在您的仓库中有这几个分支：
<pre>
-> master (Default)
backup
test
</pre>
您当前处于 master 分支，如果想要切换到test分支，我们可以使用

<code>git checkout test</code>

* 用于检出文件
将指定的文件恢复到最新的提交状态，撤销你对其的更改

<code>git checkout -- <file></code>

==== git push ====
用于将本地的分支版本上传到远程仓库并进行合并

<code>git push <remote-host-name> <local-branch-name>:<remote-branch-name></code>

remote-host-name:远程主机名

local-branch-name:本地分支名

例如，当你的远程主机名为origin ，本地分支名为master，远程分支名为master时：

<code>git push origin master:master</code>

例如，当你的rhost名为origin 本地分支名为master远程分支名为master时：

本地和远程分支名相同，上述命令可以简写为：

<code>git push origin master</code>

当你的远程版本与本地版本有差异，无法直接push时，你可以使用--force 参数来进行强制推送

<code>git push --force origin master</code>

--force 此处可以直接简单化为 -f

如果你想要删除主机内的某个分支，你可以使用--delete参数

<code>git push origin --delete <branch-name></code>

==== git diff ====
用于比较当前工作区与上一个版本之间的差异<pre>
diff --git a/example b/example

index fbb8c85..d65c7eb 100644

--- a/example

+++ b/example

@@ -1 +1,2 @@

114514

+1919180
</pre>

==== git log ====
用于查看提交的历史

例如当你进行一次提交之后，执行 <code>git log</code>终端会输出

<pre>
commit 3a5b0d12f471418b13f2baf5e9e4c112a5e804a8 (HEAD -> master)

Author: luluzzy <1054438588@qq.com>

Date: Thu Feb 15 21:28:47 2024 +0800

initial commit: add makefile
</pre>

这些输出分别为
<pre>
commit sha1 hash: 针对你这个提交的 commit id
Author: commit 作者名称 <you@example.com>
Date: commit 日期
commit: 名称
</pre>

关于sha1_hash的介绍请看这里<ref>生成这个hash值，它是对那个commit是Git仓库中内容和头信息Header的一个校验和checksum。Linux kernel开创者和Git的开发者——Linus说，Git使用了sha1并非是为了安全性，而是为了数据的完整性；它可以保证，在很多年后，你重新checkout某个commit时，一定是它多年前的当时的状态，完全一摸一样，完全值得信任。在Git中，根据commit的sha1值40个十六进制数字进行了简单的划分目录，以前2位数字作为目录名，其下面是剩余38位数字组成的一个文件名</ref>

当有多次提交之后，如果我们想要翻之前的提交历史，难免会因为终端输出的内容过多而难以查看翻阅

此时我们可以使用<code>--online</code>参数来简化输出，此时仅会输出: sha1哈希值 + commit的名称

例如
<pre>
347595d (HEAD -> master) modify makefile

3a5b0d1 initial commit: add makefile
</pre>

==== git cherry-pick ====

cherry-pick (遴选) 和它的名称一样，挑选一个我们需要的 commit 进行操作。它可以用于将在其他分支上的 commit 修改，移植到当前的分支。

如果我们想在我们正在开发的版本上，添加一个其他版本中的功能代码。就可以使用 cherry-pick ，将这个功能相关的 commit 提取出来，合入该版本。

<code>git cherry-pick <commit-id></code>

当我们执行完 <code>cherry-pick</code>操作之后，会自动生成一个<code>commit</code>以及对应新的<code>commit-id</code>

在顺利的情况下我们可以直接通过，但如果遇到代码等因为变量名，写法等不同的情况，<code>cherry-pick</code>大概率会报错，此时我们需要进行报错处理。

第一种方案是手动修改

我们可以先使用<code>git status</code>检查当前遴选时冲突的文件

然后 <code>git checkout --ours filename</code>

然后按照提交的修改内容进行手动修改

随后使用<code>git add</code>命令将文件重新加入暂存区

再使用

<code>git cherry-pick --continue</code>

命令让 cherrypick 操作继续执行。

第二种方案是直接退出<code>cherry-pick</code>进程，一般适用于冲突文件实在太多了难以按照方案一处理的情况。

需要注意的是，如果您当前正在遴选的提交在该分支已经存在也会冲突，在这种情况下，您需要解决冲突并手动解决问题。

<code>git cherry-pick --abort</code>

==== git fetch ====
git fetch 命令用于从远程获取仓库。

==== git merge ====
<code>git merge</code>是用来把分叉的提交历史放回到一起(合并)的方式。

git merge命令用来将你之前使用git branch命令创建的分支以及在此分支上独立开发的内容整合为一个分支。

本

==== git pull ====
用于从远程获取代码并合并本地的版本。

<code>git pull</code>其实就是<code>git fetch</code>和<code>git merge FETCH_HEAD</code> 的简写。

格式如下：

<code>git pull <remote-host-name> <remote-branch-name>:<local-branch-name></code>

==== git rebase ====
用于需要修改历史上某一项commit

<code>git rebase -i HEAD~<commit number></code>

commit number就是从头部往前数的commit数量。执行后会弹出你在git config内配置的编辑器，若未配置则是默认，vim居多。然后就可以看见一堆commit前面有pick字样。可以将pick替换为你想要的操作。
有以下操作：

1.edit，顾名思义编辑此commit，替换完保存后请修改内容，使用<code>git add</code>或vscode，github desktop将修改文件添加到暂存区，之后命令行执行<code>git commit --amend</code>这样commit就修改成了

2.squash，合并几个提交，确认一个父提交，将要合并的commit，从下向上替换字符串，会从下向上合并(方位指的是<code>git rebase</code>后弹出的编辑器)

3.drop，需要移除的commit

4.reword，修改commit信息

另外，还可以使用首字母来说明命令。

==== git subtree ====
子树，在Android开发中多用于Kernel侧更改，如跟踪audio模块等

<code>git subtree add --prefix=<目录> <仓库地址> <远程分支></code>

如果需要更新远程库时

<code>git subtree pull --prefix=<目录> <仓库地址> <远程分支></code>

==== git submodule ====

===== 子模块功能的概述 =====
<code>git submodule</code>允许在自己的Github仓库里加入别人的github仓库，作为自己仓库的子仓库(即submodule)。

为什么我们会需要使用子模块？当我们维护一个项目时有可能遇到以下情况，例如维护某款机型的KernelSU内核，我们需要将KernelSU导入至我们的内核源码中，如果我们直接clone进去容易带来一个问题，如果KernelSU更新了怎么办？此时我们便可以使用子模块来解决这个问题

<code>git submodule</code>允许在git仓库里存放别人仓库的url，作为自己的子模块，其核心内容是在Git仓库里面加入一个<code>.gitmodules</code>文件，里面会记录各个submodule的名字，路径，以及对应链接。

===== 加入子模块 =====
<code>git submodule add <url> <path></code>

此时 <code>.gitmodules</code>内会自动生成以下内容

[submodule "xxx"]

path = xxx

url = xxx

===== 初始化子模块 =====
<code>git submodule init</code>

===== 更新子模块 =====
<code>git submodule update</code>

=== Git进阶 ===

==== GPG key ====

===== 简介 =====
平时在Github上摸鱼的时候，是不是经常能看见如下图所示，有一个绿色的"Verified"字样，看着很酷，实际上这是为了确保commit为开发者本人所写的进行的GPG签名。
[[文件:Github GPG sign.png|居中]]
因为Git的默认机制，任何人都可以通过你的邮箱和用户名创建虚假的commit，甚至你名气很大的话可以“栽赃陷害”你。如果你是某高校计算机专业的同学亦或是对计算机抱有很大的兴趣，乐意为开源社区提供“资源”，那么我建议你设置GPG sign。未来是不可预知的，人人都可能成为巨佬。

===== 使用 =====
因为我只在Mac环境下配置过GPG，Windows只是打游戏用，所以用的少，Linux/类Unix可以参考一下。其它系统等待他人补充......

====== Mac ======
Mac默认是不带GPG的，需要通过第三方软件包安装器Homebrew进行安装，首先先安装Homebrew，如已安装可以跳过。

编辑器限制原因不能使用默认标题进行分步了，故使用1、2、3等小数字代替。

安装Homebrew

在安装之前需要从系统信息中查看芯片为Intel/M系列

Intel使用

<code>/bin/zsh -c "$(curl -fsSL <nowiki>https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh</nowiki>)"</code>

Intel按照脚本提示，选源，输密码，回车一路绿灯就好了，如果这都不会......可能你不是很适合开发，因为该脚本是国内开发者编写的，中文和一键化安装都集齐了。

M系列使用

<code>/bin/zsh -c "$(curl -fsSL https://gitee.com/huwei1024/HomebrewCN/raw/master/Homebrew.sh)"</code>

并且因为M系列系统结构发生改变，包安装位置不在是以前的/usr/local/，而是在/opt/homebrew，所以要将配置文件里的环境变量改过来。

1.首先进入根目录

<code>cd ~</code>

2.创建.zshrc文件

<code>touch .zshrc</code>

3.打开文件进行编辑

<code>open -e .zshrc</code>

4.如果有旧的环境就修改，没有就新增

<code>export PATH="/opt/homebrew/bin:$PATH"

export PATH="/opt/homebrew/sbin:$PATH"</code>

5.保存

使用command + s

6.生效环境变量

<code>source .zshrc</code>

7、测试

<code>brew -v</code>

若终端顺利打印出brew的版本，那么就安装成功了！

注：本人没有使用过M系列设备，该教程在知乎上找到的

使用Homebrew安装GPG

<code>brew install gnupg pinentry-mac</code>

[[文件:截屏2024-02-17 17.34.48.png|居中]]

为GPG添加环境变量，否则在签名的时候会发生报错（使用bash请自行替换配置文件）

<code>echo "export GPG_TTY=$(tty)" >> ~/.zshrc
source ~/.zshrc
</code>

生成一个GPG keys

<code>gpg --full-generate-key</code>

[[文件:截屏2024-02-17 17.45.51.png|居中]]

默认使用的是ECC，我使用的是RSA，按照自己喜好，或从百度搜索非对称和对称加密算法之间的区别，这里只做使用方法的介绍，不做赘述。

然后添写密钥长度和使用有效期，这里建议选择长期，并做备份，一辈子用一个就够了。

[[文件:截屏2024-02-17 17.46.06.png|居中]]
[[文件:截屏2024-02-17 17.46.35.png|居中]]

个人信息按照Github信息填写，真实姓名对应Username。填写完毕按回车输入O即可生成密钥。不出意外的话会弹出Gui窗口让你设置密钥密码，强烈建设设置一个较为复杂的密码，并牢记，当然也可以不设置。

使用GPG对Git的commit和tag进行签名

先为Git定义GPG二进制所在地

<code>git config --global gpg.program $(which gpg)</code>

查看GPG keys ID

<code>gpg --list-secret-keys --keyid-format=long</code>

如图所示RSA/后面紧跟的一串就是GPG keys ID
[[文件:截屏2024-02-17 17.57.01.png|居中]]
<code>git config --global user.signingkey "GPG key ID"</code>

为Git设置全局commit和tag签名

<code>git config --global commit.gpgsign true

git config --global tag.gpgSign true</code>

参见本文“在Github配置GPG keys”部分开启下一步操作

接下来就可以愉快的编写程序了~

======在Github配置GPG keys======
在终端输入

<code>gpg --armor --export "GPG key ID"</code>

将输出的内容从-----BEGIN PGP PUBLIC KEY BLOCK-----到-----END PGP PUBLIC KEY BLOCK-----，包含它们都复制下来。

打开Github网页，并登录自己的账号。按照下述操作依次执行。

头像-->Setting-->SSH and GPG keys-->New GPG key

标题自己怎么舒服怎么来，将第一步复制的内容全部粘贴然后保存起来，这样Github就能识别到你commit中包含的GPG sign的信息了，你就可以在commit history或release等页面看到绿色的签名后的标志了。

==== SSH key ====
可以通过生成SSH key，并保存在Github等托管平台上实现免密Push，这也是官方推荐的方法，过去输入用户名/密码的方式早已被抛弃。

===== 生成Key =====
1.打开终端并输入

<code>ls ~/.ssh</code>

检查是否已经存在了SSH密钥。如果你看到包含id_rsa等文件，说明你已经有了SSH key，可以跳过第 2 步和第 3 步。

2.输入，生成新的SSH密钥。你可以直接按回车键使用默认的文件路径和空密码，也可以自己设置。

<code>ssh-keygen -t rsa -b 4096 -C "your_email@example.com"</code>

4.在终端输入或使用文本编辑器打开，并复制所有内容

<code>vim ~/.ssh/id_rsa.pub</code>

5.打开Github网页，并登录自己的账号。按照下述操作依次执行。

头像-->Setting-->SSH and GPG keys-->New SSH key

自己起个标题名并粘贴4步中所有内容，保存，接下来你可以免密对Github上的repo进行操作了。

==== 参考资料： ====
[1] 百度百科 -- Git：<nowiki>https://baike.baidu.com/item/GIT/12647237?fr=ge_ala</nowiki>

[2] 菜鸟教程 -- Git基本操作：<nowiki>https://www.runoob.com/git/git-basic-operations.html</nowiki>

[3] CSDN -- git merge 使用简介: <nowiki>https://blog.csdn.net/All_In_gzx_cc/article/details/125482617</nowiki>

[4] 知乎 -- MAC 安装 homebrew 国内镜像: <nowiki>https://zhuanlan.zhihu.com/p/547898033</nowiki>

[5] Github -- Generating a new GPG key: <nowiki>https://docs.github.com/en/authentication/managing-commit-signature-verification/generating-a-new-gpg-key</nowiki>

[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>

[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>

[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>

解锁Bootloader

2024-08-17T15:47:41Z

MoeGLuwu：unlockbootloader: oneplus: 添加旧机型解锁方式

== Bootloader锁是啥？？ ==
Bootloader锁，也称为BL锁，Bootloader是'''在操作系统内核运行之前运行的一段小程序'''。在嵌入式操作系统中，Bootloader的主要作用是在操作系统内核运行之前初始化硬件设备、建立内存空间映射图，从而将系统的软硬件环境带到一个合适状态，以便为最终调用操作系统内核准备好正确的环境。

Bootloader锁主要是在引导过程中对系统签名、内核签名及Recovery签名''''进行检验，如果签名不一致，即终止引导。这是厂商为了普通用户的安全考虑而设下的一个门槛，它会在Bootloader引导启动时检测即将被启动的东西（如recovery.img / boot.img）的签名是否是厂商的，如果不是的话就拒绝启动。因此，如果不解开BL锁，用户无法进行刷机操作。

'''所以解锁bootloader，是我们玩机的第一步！'''

== 我该怎么解锁Bootloader呢? ==
不同品牌的设备有不同的解锁方式。

'''以下是不同品牌的解锁权限开放情况：'''

'''小米（红米）'''：支持解锁，但需要通过地狱级难度的答题测试。解锁 ROOT 保修。

'''OPPO（真我 realme）'''：部分机型支持解锁，需要申请，名额有限。要求机型上市时间必须超过3个月，同时需要 OPPO 官方开放该机型的深度测试。支持解锁 ROOT 保修，前提是设备可以正常回锁。

'''一加'''：支持解锁，不需答题申请，方式简单。解锁 ROOT 保修。

'''vivo（含 iQOO）'''：不支持解锁。

'''华为'''：不支持解锁。

'''荣耀'''：不支持解锁。

'''魅族'''：官方不支持解锁，但官方开放不完整 ROOT ，可以替换为 Magisk。

'''中兴（努比亚、红魔）'''：不支持解锁。

'''三星'''：支持解锁，方式简单。但是有 KNOX 物理熔断机制，解锁之后无法恢复。

'''索尼'''：大部分支持解锁，但是需要申请获取解锁码。

'''联想'''：支持解锁，方式简单，但是zui15解锁会报错，所以仅限zui15以下。
[[文件:Jiesuoweizhi.jpg|缩略图|绑定账号位置]]

=== 小米/红米机型（出厂搭载HyperOS的设备） ===
此部分适用于出厂搭载HyperOS的设备，如小米14系列、Redmi K70系列

但是门槛较高，需要小米社区账号5级+答题通过+申请审核通过，截至24年2月14日，答题为68分客观题+32分主观题，本人多次答题均没有主观成绩，推测并没有人工阅卷，并且答题通过后申请资格审核也不一定通过

本教程建立在小米社区5级的基础上

==== 1、将账号与手机绑定 ====
打开设置——我的设备——全部参数与信息——连续点击6次OS版本开启开发者选项

返回设置主页——最底部更多设置——底部开发者选项——设备解锁状态

关闭手机WiFi，打开数据网络，点击页面底部绑定，解锁需要等待72小时

之后不需要再次点击绑定，否则需要重新计算72小时

==== 2、小米社区 ====
底部官方——上方内测申请——BL解锁申请——页面底部“去答题”

对照题库完成比较简单，[https://github.com/MlgmXyysd/Xiaomi-BootLoader-Questionnaire/discussions/4#discussioncomment-8443406 题库链接（可能需要科学上网）]

如果答题分数足以通过，可以回到BL解锁申请页，点击“立即报名”，等待通过

==== 3、电脑下载解锁工具并解锁 ====
[http://www.miui.com/unlock/index.html 官方网站下载]

下载后解压，双击miflash_unlock.exe，可能需要更新

需要登录与手机绑定账号相同的小米账号，注意扫码登陆会卡住，尽量使用账号密码登录

登录完成后，将手机关机，长按音量减+电源键进入fastboot模式，用数据线将手机连接至电脑

电脑显示已连接小米手机后，单击解锁，并等待解锁进度完成

如果一切正常的话，就可以解锁成功了

=== 小米/红米机型（出厂搭载MIUI的设备） ===
出厂搭载MIUI且升级了HyperOS的设备，可以尝试漏洞解锁，通过漏洞可以实现跳过答题，恢复原来绑定168小时解锁，可以参考[https://www.coolapk.com/feed/51431664?shareKey=ZTg5YmI4MzczNWU2NjVjY2E5M2Y~&shareUid=6601587&shareFrom=com.coolapk.market_14.0.0 此文章]

以下为运行MIUI设备的解锁方法

==== 1、绑定账号 ====
步骤同HyperOS

==== 2、等待168小时（7天 ====

==== 3、电脑下载解锁工具并解锁 ====
步骤同HyperOS

=== 索尼解锁 ===
解锁会清除全部数据
[[文件:无法打开oem解锁.jpg|缩略图|国行系统无法打开oem解锁]]

==== 番外：如何查看自己的手机支不支持官方解锁？ ====
打开拨号界面，输入*#*#7378423#*#*，在弹出的界面中选择“Service Info”——“Configuration”，弹出的页面中有一个“Rooting status”，下方的Bootloader unlock allowed后方如果为Yes，即代表可以通过官方解锁码解锁，如果为No，那么即便获取解锁码也是无法解锁的，需要用到qUnlock（花钱强制解锁）

==== 1、打开OEM解锁 ====
国行由于精简掉了GMS组件，即便使用科学上网也无法打开该选项，强刷港版固件+科学上网即可解决

这里以XZ1的系统为例，其他机型类似

首先我们需要科学上网，大概挂一会就可以，操作过程尽量不要断开

设置底部“系统”——“关于手机”——连续点击最下方“版本号”直到显示“您现在处于开发者模式”，返回上一级在底部找到开发者选项，如果上网很科学的话OEM解锁就可以打开了

==== 2、用IMEI获取解锁码 ====
设置底部“系统”——“关于手机”——IMEI，如果你是双卡的话随便一个IMEI就可以

[https://developer.sony.com/open-source/aosp-on-xperia-open-devices/get-started/unlock-bootloader/ 点击此处跳转索尼官网解锁链接]，网页使用谷歌'''reCAPTCHA，所以需要科学上网'''

在网页的底部“Select your device”中选择你的设备型号，在下方的文本框中输入你的IMEI，点击“submit”提交，下方会出现“Your unlock code for 你的IMEI号”，此文字下面的一串代码即为你的解锁码

==== 3、使用Fastboot命令解锁 ====
将设备关机，先将数据线连接到电脑，在按住音量加的同时插入数据线，呼吸灯变蓝即为Fastboot模式

随后打开命令行，输入“<code>fastboot oem unlock 0x你的解锁码</code>”，即可成功解锁

或者也可以使用柚坛工具箱
[[文件:柚坛工具箱基本刷入页面.png|居中|无框|531x531像素]]
在基本刷入页面的普通设备解锁中的解锁码解锁中填写“<code>0x你的解锁码</code>”，随后点击立即解锁即可完成解锁。

=== 一加手机 ===

==== 1、打开OEM解锁 ====
在开发者选项中打开允许OEM解锁选项

==== 2.进入Fastboot，开始解锁 ====
手机进入fastboot后，在命令行中输入<code>fastboot flashing unlock</code>，然后按下回车确认
如果不行，您的设备相对较旧，请执行<code>fastboot oem unlock</code>

或使用柚坛工具箱，在基本刷入页面的基本命令解锁中选择<code>flashing unlock</code>，然后点击执行解锁命令
[[文件:柚坛工具箱基本刷入页面.png|居中|无框|531x531像素]]
手机将进入新的英文界面，在此界面中选择<code>UNLOCK THE BOOTLOADER</code>(音量键选择，电源键确认)

等待设备自动重启

EvolutionX

2024-08-17T14:37:53Z

MoeGLuwu：EvolutionX: They are now based on los

[[文件:Evox.png|居中|无框]]

Evolution X 是一款基于LineageOS的Android类原生项目，旨在为用户提供乍一看类似 Pixel 的感觉，并提供许多附加功能。

正在持续更新，有Vanilla和Gapps两个版本的包供选择。

GitHub：https://github.com/Evolution-X

使用edl.py

2024-08-15T15:05:18Z

MoeGLuwu：/* 安装 */

本章将指导使用由[https://github.com/bkerler bkerler]所创建的非官方高通Sahara / Firehose Attack Client / Diag Tools
* 源代码：https://github.com/bkerler/edl
=== 在Linux发行版安装 ===
==== 配置依赖 ====
* Debian系列(Debian/Ubuntu/Mint/etc)

sudo apt install adb fastboot python3-dev python3-pip liblzma-dev git
sudo systemctl stop ModemManager
sudo systemctl disable ModemManager
sudo apt purge ModemManager

* Arch系列
sudo pacman -S android-tools python python-pip git xz
sudo pacman -R modemmanager

==== 安装 ====
git clone https://github.com/bkerler/edl.git --recursive
cd edl
sudo cp Drivers/51-edl.rules /etc/udev/rules.d
sudo cp Drivers/50-android.rules /etc/udev/rules.d
python3 setup.py build
sudo python3 setup.py install

==== 使用EDL ====
请先利用edl工程线或其它任意方式进入0x9008 mode

GitHub上详细教程：https://github.com/bkerler/edl?tab=readme-ov-file#run-edl-examples

9008深度刷机

2024-08-15T15:00:35Z

MoeGLuwu：9008 flash tool: 添加一加设备

== 什么是9008深度刷机 ==
9008深度刷机是通过进入9008模式进行底层刷写固件的救砖模式

不是专业刷机用户，切勿进行9008深度刷机，否则重要分区丢失

或者基带丢失，导致设备无法正常使用硬件，设备损坏等等

=== 9008深刷工具 ===
'''Qualcomm Product Support Tools (QPST)'''

是著名的高通骁龙的深刷平台，支持部分手机或者Pad设备使用

* 支持部分小米设备
* 支持联想手机和Pad设备
* 支持部分魅族手机
* 支持全系LG手机
* 支持部分努比亚设备
* 支持全部一加设备

==== 备注 ====
还有部分机型厂商进行9008限制，需要到售后，或者专业人员提供帮助

不到万不得已不要使用9008进行深度操作和刷写固件！！！

不到万不得已不要使用9008进行深度操作和刷写固件！！！

不到万不得已不要使用9008进行深度操作和刷写固件！！！

用户:MoeGLuwu

2024-08-15T14:45:58Z

MoeGLuwu：gl Initial page!

gl是一只又菜又爱玩的屑学生w

==== Github：https://github.com/uwu-gl ====

==== 酷安：http://www.coolapk.com/u/25623611 ====

Fastbootd

2024-08-15T14:42:17Z

MoeGLuwu：fastbootd: 增加super empty链接

==== 提示：本教程不是指引导加载程序。 ====

== 关于fastbootd ==

==== （1）简介 ====

==== Fastbootd，即用户空间fastboot，是在Android 10开始使用的功能更为强大的刷机模式。 ====
您可以简单理解为fastbootd就是fastboot的升级版。

一般来说fastbootd会整合进recovery。在类原生上，从recovery进入fastbootd方法一般是Advanced -> Enter fastboot。

fastbootd支持对动态分区进行调整和刷写。具体请看下文。

本文不会重复介绍 Fastboot 命令一章里的命令。如有必要请前往 [[Fastboot 命令]] 页面。

（2）示例

AOSP recovery: 如第一张图
[[文件:AOSP RECOVERY FIRST SCREEN EXAMPLE.jpg|缩略图|aosp rec]]
Twrp的进入：如第二张图
[[文件:Screenshot 20240815-213505.png|缩略图|这是twrp的重启界面。点击fastbootd的那一项即可进入fastbootd]]
部分小米设备：如第三张图
[[文件:Screenshot 20240815-213658.png|缩略图|小米设备的fastbootd。没有兔兔修机器人也行]]

==== 注意：fastbootd要求最新adb-fastboot工具包，请自行去Google官网下载最新版！ ====

== 命令及详细介绍 ==

===== 通用： =====

* 进入fastbootd
adb reboot fastboot # 开机状态
fastboot reboot fastboot # 引导加载器状态
* 检查当前状态是否为fastbootd
fastboot getvar is-userspace # 如果是，则返回yes；如果不是，则返回no
同理，您可以把<code>is-userspace</code>替换为您需要的变量名进行获取。

===== 动态分区专属： =====
* 清空/重新改造动态分区
fastboot wipe-super path-to-super_empty.img # 使用<code>path-to-super_empty.img</code>来清空动态分区内容并重新改造。在引导加载器也可以执行但是可能会出现玄学问题。
更多详情请阅读[[Super Empty|super_empty]]教程中的内容。
* 逻辑分区相关
fastboot getvar is-logical:partition_name # 检查名为<code>partition_name</code>的分区是否是逻辑分区.
fastboot delete-logical-partition partition_name # 删除名为<code>partition_name</code>的逻辑分区。
fastboot create-logical-partition partition_name 1145141919810 # 新建一个名称为<code>partition_name</code>，大小为<code>1145141919810 Byte</code>的逻辑分区。
fastboot resize-logical-partition partition_name 1145141919810 # 将名为<code>partition_name</code>的大小修改为<code>1145141919810 Byte</code>. 现有可用空间必须大于等于你所修改的分区大小.
* （危险！）在引导加载器模式下刷写动态分区内的分区
fastboot --force flash partition_name path-to-image.img # 强制刷写分区。

== 在设备rom里添加fastbootd（如果不存在） ==
请参考此处提交：https://github.com/PixelExperience-Devices/device_xiaomi_sdm845-common/commit/dcc9496eb18af9522fedf6ce0a8031d1fa2880e0

ADB SideLoad

2024-08-15T14:40:24Z

MoeGLuwu：adb sideload: 优化刷入刷机包的使用命令刷入

=== '''什么是ADB Sideload？''' ===
'''ADB Sideload'''是一种卡刷的方式，使用'''ADB Sideload'''刷机能够解决很多刷机过程中碰到的一些问题，'''ADB Sideload'''刷机原理是使用数据线连接电脑，然后将卡刷包推送到手机里，使用第三方recovery进行刷机，归根结底'''ADB Sideload'''刷机还是属于“卡刷”方式，手机刷机失败无法开机又不支持外置sd卡（特别是新出的机型，是没有sd卡槽的）的情况下使用'''ADB Sideload'''刷机是最简单可行的方法。
----

=== '''ADB Sideload刷机教程''' ===
----

==== '''前期准备''' ====
1、电脑安装好了相应的ADB驱动（安装请参考“[[ADB与Fastboot驱动]]”）

2、相应机型的卡刷包（格式为zip）

3、确保手机已经解锁了bl（解锁请参考“[[解锁Bootloader]] ”），并且手机已经刷入了支持ADB Sideload功能的第三方recovery（例如TWRP、OrangeFox等，详细请参考“[[刷入第三方Recovery]]”）

4、一条可以正常使用的数据线

5、灵巧的双手、灵活的脑子

'''注：因使用米系手机进行教程编写，所以以下操作均为米系手机操作，其他机型请自行类比'''
----

==== '''开始刷机：''' ====

==== '''第一步：进入recovery''' ====

===== （1）twrp进入方式 =====

====== 方法一：手动进入 ======
手机关机，同时按下'''电源键和音量+键'''进入recovery模式（以TWRP为例）

然后点击'''高级'''

点击'''ADB Sideload'''

滑动下方'''滑块'''开始ADB Sideload

====== 方法二：使用工具箱进入 ======
将设备开启USB后连接电脑，在工具箱首页中点击重启到Sideload模式即可。
[[文件:工具箱首页.png|居中|缩略图|597x597像素]][[文件:AOSP RECOVERY MODE FIRST SCREEN EXAMPLE.jpg|缩略图|Recovery界面]]
===== （2）AOSP Recovery进入方式 =====
首先，请进入recovery模式。recovery界面一般如右图，颜色可能不一样但是首页选项基本一致：

现在，点击Apply update, 再点击Apply from adb，你便进入了sideload模式。

==== '''第二步：刷入刷机包''' ====

====== 方法一：使用命令刷入 ======
然后转到电脑在adb中执行命令，<code>sideload</code>后面是你的要刷入的ROM文件

adb sideload G:\fastboot\e-0.7-o-2019111430687-dev-polaris.zip # 刷入路径为G:\fastboot\e-0.7-o-2019111430687-dev-polaris.zip的包

请注意辨别刷入成功标志。adb sideload输出的百分比并不准确。以下给出了几个刷入成功的示例（多数时候还是要凭感觉）：

* 手机上出现Step 1/2和Step 2/2,并没有任何报错
* 电脑上百分比到47停止不动，手机几分钟后给出上面一条的输出
* 重启可以开机 

====== 方法二：使用柚坛工具箱刷入 ======
在柚坛工具箱的线刷页面，更多线刷中的ADB Sideload选择需要刷入的ROM，随后点击开始刷入即可。
[[文件:线刷.png|居中|缩略图|613x613像素]]

Super Empty

2024-08-15T14:31:30Z

MoeGLuwu：

= Super empty =

== 简介 ==
它是任何动态分区设备在系统构建时可选的产物。它一个定义了动态分区信息的空镜像。它的主要作用是为设备提供一个初始的分区表。

对原生动态分区来说

它自身包含了对逻辑分区的映射信息及逻辑分区大小。可以用于清除或更新super分区，比如后期重新分区逻辑分区大小。

对改造动态分区来说

它定义了维护者定义的设备自身分区和分区大小，将它们合并成一个大的“super”供刷入第三方ROM使用，甚至可以让老旧设备运行DSU。并且针对这类设备它的意义远不止类原生，对PT(Project Treble)也有帮助，有经验的维护者可以通过改造动态分区的方式让用户无需扩容即可体验深度定制UI。

== 使用方法 ==
=== 原生动态分区 ===
fastboot wipe-super super_empty.img的路径

=== 改造动态分区 ===
==== 类原生 ====
1.刷入维护者提供的recovery.img，在rec和boot合并的机器上也可以是boot.img

2.使用命令进入fastbootd：
fastboot reboot fastboot
3.准备最新版本的adb-fastboot工具包和维护者提供的super_empty.img

4.打开命令行进入工具包目录，使用上一节原生动态分区的方法执行命令。如果设备是ab分区，则您应该切换到另外一个槽位再执行一次。

5.重新进入recovery，格式化data分区。

6.连接电脑，使用[[ADB SideLoad|adb sideload]]刷入。

==== GSI ====
改造动态分区之后，使用Aosp recovery或TWRP的fastbootd，刷入system分区，即可不需扩容也能使用上超过system物理空间大小的镜像。

== 对开发者的一些帮助 ==
[https://github.com/uwu-gl/device_oneplus_sdm845-common/commit/2e2b515df62421024695c08240074df678dbb4c9 改造动态分区的示例commit]

如果分区大小还是不够，您可以考虑切换到erofs或squashfs等等压缩文件系统。必须在内核中有文件系统相关支持且fstab中正确指定挂载参数。

对于在Mac上正常刷写super_empty在win或linux下不能正常刷写的情况，请检查device tree内定义的数值是否100%匹配。

Super Empty

2024-08-15T14:31:12Z

MoeGLuwu：super_empty: 重写使用方法

= Super empty =

== 简介 ==
它是任何动态分区设备在系统构建时可选的产物。它一个定义了动态分区信息的空镜像。它的主要作用是为设备提供一个初始的分区表。

对原生动态分区来说

它自身包含了对逻辑分区的映射信息及逻辑分区大小。可以用于清除或更新super分区，比如后期重新分区逻辑分区大小。

对改造动态分区来说

它定义了维护者定义的设备自身分区和分区大小，将它们合并成一个大的“super”供刷入第三方ROM使用，甚至可以让老旧设备运行DSU。并且针对这类设备它的意义远不止类原生，对PT(Project Treble)也有帮助，有经验的维护者可以通过改造动态分区的方式让用户无需扩容即可体验深度定制UI。

== 使用方法 ==
=== 原生动态分区 ===
fastboot wipe-super super_empty.img的路径

=== 改造动态分区 ===
==== 类原生 ====
1.刷入维护者提供的recovery.img，在rec和boot合并的机器上也可以是boot.img

2.使用命令进入fastbootd：
fastboot reboot fastboot
3.准备最新版本的adb-fastboot工具包和维护者提供的super_empty.img

4.打开命令行进入工具包目录，使用上一节原生动态分区的方法执行命令。如果设备是ab分区，则您应该切换到另外一个槽位再执行一次。

7.重新进入recovery，格式化data分区。

8.连接电脑，使用[[ADB SideLoad|adb sideload]]刷入。

==== GSI ====
改造动态分区之后，使用Aosp recovery或TWRP的fastbootd，刷入system分区，即可不需扩容也能使用上超过system物理空间大小的镜像。

== 对开发者的一些帮助 ==
[https://github.com/uwu-gl/device_oneplus_sdm845-common/commit/2e2b515df62421024695c08240074df678dbb4c9 改造动态分区的示例commit]

如果分区大小还是不够，您可以考虑切换到erofs或squashfs等等压缩文件系统。必须在内核中有文件系统相关支持且fstab中正确指定挂载参数。

对于在Mac上正常刷写super_empty在win或linux下不能正常刷写的情况，请检查device tree内定义的数值是否100%匹配。

Fastbootd

2024-08-15T14:13:05Z

MoeGLuwu：fastbootd: 添加示例截图 2/2

==== 提示：本教程不是指引导加载程序。 ====

== 关于fastbootd ==

==== （1）简介 ====

==== Fastbootd，即用户空间fastboot，是在Android 10开始使用的功能更为强大的刷机模式。 ====
您可以简单理解为fastbootd就是fastboot的升级版。

一般来说fastbootd会整合进recovery。在类原生上，从recovery进入fastbootd方法一般是Advanced -> Enter fastboot。

fastbootd支持对动态分区进行调整和刷写。具体请看下文。

本文不会重复介绍 Fastboot 命令一章里的命令。如有必要请前往 [[Fastboot 命令]] 页面。

（2）示例

AOSP recovery: 如第一张图
[[文件:AOSP RECOVERY FIRST SCREEN EXAMPLE.jpg|缩略图|aosp rec]]
Twrp的进入：如第二张图
[[文件:Screenshot 20240815-213505.png|缩略图|这是twrp的重启界面。点击fastbootd的那一项即可进入fastbootd]]
部分小米设备：如第三张图
[[文件:Screenshot 20240815-213658.png|缩略图|小米设备的fastbootd。没有兔兔修机器人也行]]

==== 注意：fastbootd要求最新adb-fastboot工具包，请自行去Google官网下载最新版！ ====

== 命令及详细介绍 ==

===== 通用： =====

* 进入fastbootd
adb reboot fastboot # 开机状态
fastboot reboot fastboot # 引导加载器状态
* 检查当前状态是否为fastbootd
fastboot getvar is-userspace # 如果是，则返回yes；如果不是，则返回no
同理，您可以把<code>is-userspace</code>替换为您需要的变量名进行获取。

===== 动态分区专属： =====
* 清空/重新改造动态分区
fastboot wipe-super path-to-super_empty.img # 使用<code>path-to-super_empty.img</code>来清空动态分区内容并重新改造。在引导加载器也可以执行但是可能会出现玄学问题。
* 逻辑分区相关
fastboot getvar is-logical:partition_name # 检查名为<code>partition_name</code>的分区是否是逻辑分区.
fastboot delete-logical-partition partition_name # 删除名为<code>partition_name</code>的逻辑分区。
fastboot create-logical-partition partition_name 1145141919810 # 新建一个名称为<code>partition_name</code>，大小为<code>1145141919810 Byte</code>的逻辑分区。
fastboot resize-logical-partition partition_name 1145141919810 # 将名为<code>partition_name</code>的大小修改为<code>1145141919810 Byte</code>. 现有可用空间必须大于等于你所修改的分区大小.
* （危险！）在引导加载器模式下刷写动态分区内的分区
fastboot --force flash partition_name path-to-image.img # 强制刷写分区。

== 在设备rom里添加fastbootd（如果不存在） ==
请参考此处提交：https://github.com/PixelExperience-Devices/device_xiaomi_sdm845-common/commit/dcc9496eb18af9522fedf6ce0a8031d1fa2880e0

Super Empty

2024-08-15T13:49:55Z

MoeGLuwu：super_empty: 略微修改改造动态分区

= Super empty =

== 简介 ==
它是任何动态分区设备在系统构建时可选的产物。它一个定义了动态分区信息的空镜像。它的主要作用是为设备提供一个初始的分区表。

对原生动态分区来说

它自身包含了对逻辑分区的映射信息及逻辑分区大小。可以用于清除或更新super分区，比如后期重新分区逻辑分区大小。

对改造动态分区来说

它定义了维护者定义的设备自身分区和分区大小，将它们合并成一个大的“super”供刷入第三方ROM使用，甚至可以让老旧设备运行DSU。并且针对这类设备它的意义远不止类原生，对PT(Project Treble)也有帮助，有经验的维护者可以通过改造动态分区的方式让用户无需扩容即可体验深度定制UI。

== 使用方法 ==
=== 原生动态分区 ===
fastboot wipe-super super_empty.img的绝对路径

=== 改造动态分区 ===
==== 类原生 ====
以我个人维护的小米6X(wayne)为例

1.设备重启至fastboot

2.连接电脑

3.准备最新版本的adb工具包和维护者提供的super_empty.img和ROM包

4.打开命令行进入工具包目录，输入fastboot wipe-super super_empty.img的绝对路径

5.刷写完毕后继续刷入维护者提供的Recovery
fastboot flash recovery recovery.img的绝对路径

6.重启设备至recovery

7.选择格式化data(format data)

8.连接电脑，使用adb sideload刷入ROM，adb sideload ROM包绝对路径或相对路径

==== GSI ====
改造动态分区之后，使用Aosp recovery或TWRP的fastbootd，刷入system分区，即可不需扩容也能使用上超过system物理空间大小的镜像。

== 对开发者的一些帮助 ==
[https://github.com/uwu-gl/device_oneplus_sdm845-common/commit/2e2b515df62421024695c08240074df678dbb4c9 改造动态分区的示例commit]

如果分区大小还是不够，您可以考虑切换到erofs或squashfs等等压缩文件系统。必须在内核中有文件系统相关支持且fstab中正确指定挂载参数。

对于在Mac上正常刷写super_empty在win或linux下不能正常刷写的情况，请检查device tree内定义的数值是否100%匹配。

Super Empty

2024-08-15T13:48:27Z

MoeGLuwu：super_empty: 略微对上一次的修改进行排版

= Super empty =

== 简介 ==
它是任何动态分区设备在系统构建时可选的产物。它一个定义了动态分区信息的空镜像。它的主要作用是为设备提供一个初始的分区表。

对原生动态分区来说

它自身包含了对逻辑分区的映射信息及逻辑分区大小。可以用于清除或更新super分区，比如后期重新分区逻辑分区大小。

对改造动态分区来说

它定义了维护者定义的设备自身分区和分区大小，将它们合并成一个大的“super”供刷入第三方ROM使用，甚至可以让老旧设备运行DSU。并且针对这类设备它的意义远不止类原生，对PT(Project Treble)也有帮助，有经验的维护者可以通过改造动态分区的方式让用户无需扩容即可体验深度定制UI。

== 使用方法 ==
=== 原生动态分区 ===
fastboot wipe-super super_empty.img的绝对路径

=== 改造动态分区 ===
==== 类原生 ====
以我个人维护的小米6X(wayne)为例

1.设备重启至fastboot

2.连接电脑

3.准备最新版本的adb工具包和维护者提供的super_empty.img和ROM包

4.打开命令行进入工具包目录，输入fastboot wipe-super super_empty.img的绝对路径

5.刷写完毕后继续刷入维护者提供的Recovery，fastboot flash recovery recovery.img的绝对路径

6.重启设备至recovery

7.选择格式化data(format data)

8.连接电脑，使用adb sideload刷入ROM，adb sideload ROM包绝对路径

==== GSI ====
改造动态分区之后，使用Aosp recovery或TWRP的fastbootd，刷入system分区，即可不需扩容也能使用上超过system物理空间大小的镜像。

== 对开发者的一些帮助 ==
[https://github.com/uwu-gl/device_oneplus_sdm845-common/commit/2e2b515df62421024695c08240074df678dbb4c9 改造动态分区的示例commit]

如果分区大小还是不够，您可以考虑切换到erofs或squashfs等等压缩文件系统。必须在内核中有文件系统相关支持且fstab中正确指定挂载参数。

对于在Mac上正常刷写super_empty在win或linux下不能正常刷写的情况，请检查device tree内定义的数值是否100%匹配。

Super Empty

2024-08-15T13:47:50Z

MoeGLuwu：super_empty: 提示erofs等压缩文件分区系统

= Super empty =

== 简介 ==
它是任何动态分区设备在系统构建时可选的产物。它一个定义了动态分区信息的空镜像。它的主要作用是为设备提供一个初始的分区表。

对原生动态分区来说

它自身包含了对逻辑分区的映射信息及逻辑分区大小。可以用于清除或更新super分区，比如后期重新分区逻辑分区大小。

对改造动态分区来说

它定义了维护者定义的设备自身分区和分区大小，将它们合并成一个大的“super”供刷入第三方ROM使用，甚至可以让老旧设备运行DSU。并且针对这类设备它的意义远不止类原生，对PT(Project Treble)也有帮助，有经验的维护者可以通过改造动态分区的方式让用户无需扩容即可体验深度定制UI。

== 使用方法 ==
=== 原生动态分区 ===
fastboot wipe-super super_empty.img的绝对路径

=== 改造动态分区 ===
==== 类原生 ====
以我个人维护的小米6X(wayne)为例

1.设备重启至fastboot

2.连接电脑

3.准备最新版本的adb工具包和维护者提供的super_empty.img和ROM包

4.打开命令行进入工具包目录，输入fastboot wipe-super super_empty.img的绝对路径

5.刷写完毕后继续刷入维护者提供的Recovery，fastboot flash recovery recovery.img的绝对路径

6.重启设备至recovery

7.选择格式化data(format data)

8.连接电脑，使用adb sideload刷入ROM，adb sideload ROM包绝对路径

==== GSI ====
改造动态分区之后，使用Aosp recovery或TWRP的fastbootd，刷入system分区，即可不需扩容也能使用上超过system物理空间大小的镜像。

== 对开发者的一些帮助 ==
[https://github.com/uwu-gl/device_oneplus_sdm845-common/commit/2e2b515df62421024695c08240074df678dbb4c9 改造动态分区的示例commit]
如果分区大小还是不够，您可以考虑切换到erofs或squashfs等等压缩文件系统。必须在内核中有文件系统相关支持且fstab中正确指定挂载参数。

对于在Mac上正常刷写super_empty在win或linux下不能正常刷写的情况，请检查device tree内定义的数值是否100%匹配。

Super Empty

2024-08-15T13:45:30Z

MoeGLuwu：super_empty: QwQ

= Super empty =

== 简介 ==
它是任何动态分区设备在系统构建时可选的产物。它一个定义了动态分区信息的空镜像。它的主要作用是为设备提供一个初始的分区表。

对原生动态分区来说

它自身包含了对逻辑分区的映射信息及逻辑分区大小。可以用于清除或更新super分区，比如后期重新分区逻辑分区大小。

对改造动态分区来说

它定义了维护者定义的设备自身分区和分区大小，将它们合并成一个大的“super”供刷入第三方ROM使用，甚至可以让老旧设备运行DSU。并且针对这类设备它的意义远不止类原生，对PT(Project Treble)也有帮助，有经验的维护者可以通过改造动态分区的方式让用户无需扩容即可体验深度定制UI。

== 使用方法 ==
=== 原生动态分区 ===
fastboot wipe-super super_empty.img的绝对路径

=== 改造动态分区 ===
==== 类原生 ====
以我个人维护的小米6X(wayne)为例

1.设备重启至fastboot

2.连接电脑

3.准备最新版本的adb工具包和维护者提供的super_empty.img和ROM包

4.打开命令行进入工具包目录，输入fastboot wipe-super super_empty.img的绝对路径

5.刷写完毕后继续刷入维护者提供的Recovery，fastboot flash recovery recovery.img的绝对路径

6.重启设备至recovery

7.选择格式化data(format data)

8.连接电脑，使用adb sideload刷入ROM，adb sideload ROM包绝对路径

==== GSI ====
改造动态分区之后，使用Aosp recovery或TWRP的fastbootd，刷入system分区，即可不需扩容也能使用上超过system物理空间大小的镜像。

== 对开发者的一些帮助 ==
[https://github.com/uwu-gl/device_oneplus_sdm845-common/commit/2e2b515df62421024695c08240074df678dbb4c9 改造动态分区的示例commit]

对于在Mac上正常刷写super_empty在win或linux下不能正常刷写的情况，请检查device tree内定义的数值是否100%匹配。

Fastbootd

2024-08-15T13:38:31Z

MoeGLuwu：fastbootd: 添加示例截图

==== 提示：本教程不是指引导加载程序。 ====

== 关于fastbootd ==

==== （1）简介 ====

==== Fastbootd，即用户空间fastboot，是在Android 10开始使用的功能更为强大的刷机模式。 ====
您可以简单理解为fastbootd就是fastboot的升级版。

一般来说fastbootd会整合进recovery。在类原生上，从recovery进入fastbootd方法一般是Advanced -> Enter fastboot。

fastbootd支持对动态分区进行调整和刷写。具体请看下文。

本文不会重复介绍 Fastboot 命令一章里的命令。如有必要请前往 [[Fastboot 命令]] 页面。

（2）示例

AOSP recovery:
[[文件:AOSP RECOVERY FIRST SCREEN EXAMPLE.jpg|缩略图|aosp rec]]
Twrp的进入：
[[文件:Screenshot 20240815-213505.png|缩略图|这是twrp的重启界面。点击fastbootd的那一项即可进入fastbootd]]
部分小米设备：
[[文件:Screenshot 20240815-213658.png|缩略图|小米设备的fastbootd。没有兔兔修机器人也行]]

==== 注意：fastbootd要求最新adb-fastboot工具包，请自行去Google官网下载最新版！ ====

== 命令及详细介绍 ==

===== 通用： =====

* 进入fastbootd
adb reboot fastboot # 开机状态
fastboot reboot fastboot # 引导加载器状态
* 检查当前状态是否为fastbootd
fastboot getvar is-userspace # 如果是，则返回yes；如果不是，则返回no
同理，您可以把<code>is-userspace</code>替换为您需要的变量名进行获取。

===== 动态分区专属： =====
* 清空/重新改造动态分区
fastboot wipe-super path-to-super_empty.img # 使用<code>path-to-super_empty.img</code>来清空动态分区内容并重新改造。在引导加载器也可以执行但是可能会出现玄学问题。
* 逻辑分区相关
fastboot getvar is-logical:partition_name # 检查名为<code>partition_name</code>的分区是否是逻辑分区.
fastboot delete-logical-partition partition_name # 删除名为<code>partition_name</code>的逻辑分区。
fastboot create-logical-partition partition_name 1145141919810 # 新建一个名称为<code>partition_name</code>，大小为<code>1145141919810 Byte</code>的逻辑分区。
fastboot resize-logical-partition partition_name 1145141919810 # 将名为<code>partition_name</code>的大小修改为<code>1145141919810 Byte</code>. 现有可用空间必须大于等于你所修改的分区大小.
* （危险！）在引导加载器模式下刷写动态分区内的分区
fastboot --force flash partition_name path-to-image.img # 强制刷写分区。

== 在设备rom里添加fastbootd（如果不存在） ==
请参考此处提交：https://github.com/PixelExperience-Devices/device_xiaomi_sdm845-common/commit/dcc9496eb18af9522fedf6ce0a8031d1fa2880e0

文件:Screenshot 20240815-213658.png

2024-08-15T13:37:40Z

MoeGLuwu：

Xiaomi device fastbootd screen

文件:Screenshot 20240815-213505.png

2024-08-15T13:36:01Z

MoeGLuwu：

Enter fastbootd in twrp reboot splash

ADB SideLoad

2024-08-15T13:21:19Z

MoeGLuwu：Sideload mode: Add aosp recovery

=== '''什么是ADB Sideload？''' ===
'''ADB Sideload'''是一种卡刷的方式，使用'''ADB Sideload'''刷机能够解决很多刷机过程中碰到的一些问题，'''ADB Sideload'''刷机原理是使用数据线连接电脑，然后将卡刷包推送到手机里，使用第三方recovery进行刷机，归根结底'''ADB Sideload'''刷机还是属于“卡刷”方式，手机刷机失败无法开机又不支持外置sd卡（特别是新出的机型，是没有sd卡槽的）的情况下使用'''ADB Sideload'''刷机是最简单可行的方法。
----

=== '''ADB Sideload刷机教程''' ===
----

==== '''前期准备''' ====
1、电脑安装好了相应的ADB驱动（安装请参考“[[ADB与Fastboot驱动]]”）

2、相应机型的卡刷包（格式为zip）

3、确保手机已经解锁了bl（解锁请参考“[[解锁Bootloader]] ”），并且手机已经刷入了支持ADB Sideload功能的第三方recovery（例如TWRP、OrangeFox等，详细请参考“[[刷入第三方Recovery]]”）

4、一条可以正常使用的数据线

5、灵巧的双手、灵活的脑子

'''注：因使用米系手机进行教程编写，所以以下操作均为米系手机操作，其他机型请自行类比'''
----

==== '''开始刷机：''' ====

==== '''第一步：进入recovery''' ====

===== （1）twrp进入方式 =====

====== 方法一：手动进入 ======
手机关机，同时按下'''电源键和音量+键'''进入recovery模式（以TWRP为例）

然后点击'''高级'''

点击'''ADB Sideload'''

滑动下方'''滑块'''开始ADB Sideload

====== 方法二：使用工具箱进入 ======
将设备开启USB后连接电脑，在工具箱首页中点击重启到Sideload模式即可。
[[文件:工具箱首页.png|居中|缩略图|597x597像素]]

===== （2）AOSP Recovery进入方式 =====
首先，请进入recovery模式。recovery界面一般长这样，颜色可能不一样但是首页选项基本一致：
[[文件:AOSP RECOVERY MODE FIRST SCREEN EXAMPLE.jpg|缩略图|Recovery界面]]
现在，点击Apply update, 再点击Apply from adb，你便进入了sideload模式。

==== '''第二步：刷入刷机包''' ====

====== 方法一：使用命令刷入 ======
然后转到电脑在adb中执行命令，<code>sideload</code>后面是你的要刷入的ROM文件

adb sideload G:\fastboot\e-0.7-o-2019111430687-dev-polaris.zip # 刷入路径为G:\fastboot\e-0.7-o-2019111430687-dev-polaris.zip的包

当出现Total 即刷入成功然后拔掉数据线操作手机按提示重启即可进入。只要ROM没问题一般情况都可以正常进入系统。不同手机可能有不同的提示，例如有些包会卡在40%就显示成功了，但确确实实是刷进去了，所以要看情况。

====== 方法二：使用柚坛工具箱刷入 ======
在柚坛工具箱的线刷页面，更多线刷中的ADB Sideload选择需要刷入的ROM，随后点击开始刷入即可。
[[文件:线刷.png|居中|缩略图|613x613像素]]

文件:AOSP RECOVERY MODE FIRST SCREEN EXAMPLE.jpg

2024-08-15T13:19:11Z

MoeGLuwu：

The other one is fastbootd. Sorry! Meow..

文件:AOSP RECOVERY FIRST SCREEN EXAMPLE.jpg

2024-08-15T13:17:53Z

MoeGLuwu：

KSU 模块

2024-08-15T07:14:30Z

MoeGLuwu：KernelSU module: 初始化更改

====== KernelSU作为一种全新的Root方式，不仅有magisk的大部分旧特性，同时也有一些新特性，例如： ======

* WebUI
* 使用<code>OverlayFS</code>来达到systemless修改<code>/system</code>
* KernelSU 新增了一种脚本 <code>boot-completed.sh</code>，以便在 Android 系统启动后运行某些任务。
* KernelSU 新增了一种脚本 <code>post-mount.sh</code>，以便在 Overlayfs 挂载后运行某些任务。

====== 另外也请注意：KernelSU不支持以下Magisk特性： ======

* 模块不支持在Recovery模式下刷入。
* 不自带Zygisk（但是可以通过ZygiskNext来实现）

Android内核编译入门

2024-08-14T15:37:23Z

MoeGLuwu：/* Android 内核简介 */

=== Android 内核简介 ===
安卓内核用的也是linux（LTS），google把LTS内核和Android的一些补丁、模块结合形成自己的Android通用内核（Android common kernel，ACK）。也就是GKI, Generic Kernel Image。如果你的手机是量产机（Google除外），还会被cpu厂商例如高通，联发科再次开发，下放到手机厂商还会有部分修改。

相当于现在变成了一个Image，镜像了。

GKI 内核会与包含系统芯片 (SoC) 和板级代码的硬件专用供应商模块进行交互。GKI 内核与供应商模块之间的交互通过内核模块接口 (KMI) 来实现，该接口由标识供应商模块所需的函数和全局数据的符号列表组成。

=== 配置使用环境 ===

===== 推荐的编译环境 =====
Ubuntu 20.04 / 22.04

Arch Linux

(因为主播使用的就是这个喵）

考虑到编译环境的稳定性不是很推荐装一些其他的系统

你可以使用 VMware virtual machine 或者 WSL2 （Windows Subsystem on Linux）

目前我更推荐使用 WSL 因为其安装较为方便，并且可以与 Microsoft VScode 协同工作方便你对Git的使用以及对内核源码的修改

（当然 Vmware 也可以，只不过我印象不太好，这货 bug 稍微有点多）

关于这两者方案优劣对比详见百度，此处不赘述。

===== 安装WSL2教程 =====
需要先启用适用于 Linux 的 Windows 子系统以及虚拟化：

按下键盘<code>win+R</code>，并输入<code>powershell</code>回车

在<code>poershell</code>终端内输入以下内容:

<code>dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart</code>

<code>dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart</code>

<code>wsl --set --default-version 2</code>

随后打开你的微软应用商店 Microsoft Store

搜索 Ubuntu，选择一个你喜欢的版本安装即可

===== 安装一些必要的工具依赖 =====
<code>apt-get update</code>

<code>apt-get install -y build-essential bc bison python curl git zip ftp gcc-aarch64-linux-gnu gcc-arm-linux-gnueabi libssl-dev lftp wget libfl-dev gcc bc zip make</code>

这些依赖可以通过百度查到对应的作用，此处不赘述。

如若你在编译时遇见提示缺依赖的情况，你也可以百度依赖的名字来查询解决方式。

* 安装/下载交叉编译工具链

'''Clang'''

此处推荐两个

一个是Google官方提供的Clang编译器：[https://android.googlesource.com/platform/prebuilts/clang/host/linux-x86/ Google Clang]

一个是由知名大佬kdrag0n 提供的预编译Clang：[https://github.com/kdrag0n/proton-clang Proton Clang]

==== 拉取内核源码 ====
关于如何找到你的内核源码这件事，大部分内核源码在开源时都会参照以下命名规则命名

<code>android_kernel_厂商_平台</code> 例如 <code>android_kernel_xiaomi_sm8250</code>

在针对特定机型进行优化或者重构后的源码也会有开发者将其命名为

<code>android_kernel_厂商_设备代号（或者机型名称）</code>

设备代号请参照这里：[[设备代号收录集合]]

我们一般可以在<code>Github</code>找到这些源码

如果您需要拉取ACK（Android Common Kernel）请前往Google OpenSource

==== 设置环境变量并开始编译 ====
首先你需要进入你内核源码的目录，你也可以将下列的指令写在脚本里面<pre>
export CC='放clang的路径/bin/clang'
export CLANG_TRIPLE=aarch64-linux-gnu-
export CROSS_COMPILE='aarch64-linux-gnu编译器的路径/bin/aarch64-linux-gnu-'
export CROSS_COMPILE_ARM32='arm-linux-gnueabi编译器的路径/bin/arm-linux-gnueabi-'
export ARCH=arm64
export SUBARCH=arm64
export KBUILD_BUILD_HOST = "hostname"
export KBUILD_BUILD_USER = "username"
make O=out ''device''_defconfig
</pre>
这里需要注意的是，最后的<code>device</code>

取决于你编译的设备的代号，查看你设备的代号请见：[[设备代号收录集合]]

而<code>defconfig</code>则是你设备在内核中的配置文件，一套内核源码可能被多个设备共有。在编译的时候，make通过不同的配置文件来区分这些设备，这些配置文件在arch/[架构]/config下，在make的时候无需指定路径，直接输入配置文件名字即可。<ref>此处引用了 grislux55 在gitbook上的内核编译教程中针对配置文件的介绍，文末贴上了引用资料链接</ref>

举个简单的例子，内核源码就是一个大超市，<code>defconfig</code>（'''购物清单'''）则负责告诉<code>make</code>，'''你需要购买什么东西（对其进行编译），从而达成对设备驱动的区分'''

=== 获取编译结果并刷入测试 ===
内核文件在[你的项目/输出路径/arch/目标内核架构/boot]下

例如我们编译了xiaomi_sdm8250的内核，则在android_kernel_xiaomi_sm8250/out/arch/arm64/boot/里面

其名为Image或者Image.gz或者Image.gz-dtb

他们的区别在于

随后你需要刷入测试，以前有一种方法是使用 Android Image Kitchen 来解开boot.img 并将你编译好的dtb替换进去，现在看来这种方法未免太不优雅，因此我们可以使用由osm0sis大佬开发的Anykernel3打包卡刷包文件，并可以在 TWRP REC 或者 Horizen Kernel Flasher内进行刷入附链接：

[https://github.com/osm0sis/AnyKernel3 ①Anykernel3] ②Horizen Kernel Flasher ③[https://twrp.me/ TWRP rec]

=== 资料参考： ===
[1] Gtibook 安卓内核编译教程：https://jebchou.gitbook.io/android-kernel-magic/02begin_compile

[2] CSDN 安卓架构-内核：https://blog.csdn.net/weixin_40557160/article/details/128388849

Git使用教程

2024-08-14T15:34:31Z

MoeGLuwu：git: git rebase小修改

=== Git的由来： ===
Git是一个开源的分布式版本控制系统，可以有效、高速地处理从很小到非常大的项目版本管理，也是Linus Torvalds为了帮助管理Linux内核开发而开发的一个开放源码的版本控制软件。Torvalds 开始着手开发 Git 是为了作为一种过渡方案来替代 BitKeeper。

=== 常见的代码托管平台： ===
[https://github.com Github]

[https://gitlab.com Gitlab]

[https://gitee.com Gitee]

=== Git 常见命令: ===

==== git init ====
在本地目录中初始化一个新的Git仓库

==== git config ====
用于配置用户的信息以及其他设置,在使用git之前您必须完成以下步骤。

<code>git config --global user.name "your username"</code>

<code>git config --global user.email "your email"</code>

更改默认编辑器

<code>git config --global core.editor nano</code>

==== git clone ====
用于将远程仓库的代码克隆到本地，以下是命令中各个参数的含义：

<code><url></code>

克隆某个地址(url)的仓库，远程仓库的地址可以是本地的目录，也可以是例如github,giteee,gitlab一类的代码托管平台

<code>--depth=<number></code>

克隆仓库并且保留number条提交历史，number在此处即表达我们克隆的深度。

<code>-b <branch></code>

克隆指定分支下的仓库内容

例如我们要克隆<code>LineageOS</code>的内核源码，指定<code>lineage-21</code>分支，且仅保留最近一个提交，则需要输入:

<code>git clone -b lineage-21 <nowiki>https://github.com/LineageOS/android_kernel_xiaomi_sdm845</nowiki> --depth=1</code>

==== git add ====
添加某个文件，或者目录到暂存区，用于告诉git你需要将哪些文件的更改包含在下一次的提交(commit)之中添加一个或者多个文件到暂存区之中

<code>git add [file1] [file2]</code>

添加指定目录(文件)到暂存区，包括子目录：

<code>git add [dir]</code>

添加当前目录下的所有文件到暂存区：

<code>git add .</code>

==== git status ====
查看当前仓库的状态，此时git会在你的终端输出以下内容
此处演示为英文，如果您的git终端输出为中文也是同理的
<pre>
On branch master
No commits yet
Changes to be committed:

(use “git rm --cached <file>...” to unstage)
new file: makefile
</pre>

输出内容分别为
<pre>
您目前所在的分支
目前的提交
需要更改的内容
新增的文件
修改的文件
删除的文件
</pre>

==== git commit ====
用于将暂存区我们保存的更改文件添加到本地仓库，并且会生成一条提交（commit）

提交暂存区的更改到本地仓库

<code>git commit -m "message"</code>

[注] message 可以是你的备注信息

提交暂存区中的指定文件到本地仓库

如果你没有使用上述<code>git add</code>命令暂存你的修改文件，可以使用

<code>git commit -a</code>

进行直接提交

==== git checkout ====

* 用于分支切换

切换分支：

<code>git checkout <branch-name></code>

<code>git checkout <branch-name></code>

例如在您的仓库中有这几个分支：
<pre>
-> master (Default)
backup
test
</pre>
您当前处于 master 分支，如果想要切换到test分支，我们可以使用

<code>git checkout test</code>

* 用于检出文件
将指定的文件恢复到最新的提交状态，撤销你对其的更改

<code>git checkout -- <file></code>

==== git push ====
用于将本地的分支版本上传到远程仓库并进行合并

<code>git push <remote-host-name> <local-branch-name>:<remote-branch-name></code>

remote-host-name:远程主机名

local-branch-name:本地分支名

例如，当你的远程主机名为origin ，本地分支名为master，远程分支名为master时：

<code>git push origin master:master</code>

例如，当你的rhost名为origin 本地分支名为master远程分支名为master时：

本地和远程分支名相同，上述命令可以简写为：

<code>git push origin master</code>

当你的远程版本与本地版本有差异，无法直接push时，你可以使用--force 参数来进行强制推送

<code>git push --force origin master</code>

--force 此处可以直接简单化为 -f

如果你想要删除主机内的某个分支，你可以使用--delete参数

<code>git push origin --delete <branch-name></code>

==== git diff ====
用于比较当前工作区与上一个版本之间的差异<pre>
diff --git a/example b/example

index fbb8c85..d65c7eb 100644

--- a/example

+++ b/example

@@ -1 +1,2 @@

114514

+1919180
</pre>

==== git log ====
用于查看提交的历史

例如当你进行一次提交之后，执行 <code>git log</code>终端会输出

<pre>
commit 3a5b0d12f471418b13f2baf5e9e4c112a5e804a8 (HEAD -> master)

Author: luluzzy <1054438588@qq.com>

Date: Thu Feb 15 21:28:47 2024 +0800

initial commit: add makefile
</pre>

这些输出分别为
<pre>
commit sha1 hash: 针对你这个提交的 commit id
Author: commit 作者名称 <you@example.com>
Date: commit 日期
commit: 名称
</pre>

关于sha1_hash的介绍请看这里<ref>生成这个hash值，它是对那个commit是Git仓库中内容和头信息Header的一个校验和checksum。Linux kernel开创者和Git的开发者——Linus说，Git使用了sha1并非是为了安全性，而是为了数据的完整性；它可以保证，在很多年后，你重新checkout某个commit时，一定是它多年前的当时的状态，完全一摸一样，完全值得信任。在Git中，根据commit的sha1值40个十六进制数字进行了简单的划分目录，以前2位数字作为目录名，其下面是剩余38位数字组成的一个文件名</ref>

当有多次提交之后，如果我们想要翻之前的提交历史，难免会因为终端输出的内容过多而难以查看翻阅

此时我们可以使用<code>--online</code>参数来简化输出，此时仅会输出: sha1哈希值 + commit的名称

例如
<pre>
347595d (HEAD -> master) modify makefile

3a5b0d1 initial commit: add makefile
</pre>

==== git cherry-pick ====

cherry-pick (遴选) 和它的名称一样，挑选一个我们需要的 commit 进行操作。它可以用于将在其他分支上的 commit 修改，移植到当前的分支。

如果我们想在我们正在开发的版本上，添加一个其他版本中的功能代码。就可以使用 cherry-pick ，将这个功能相关的 commit 提取出来，合入该版本。

<code>git cherry-pick <commit-id></code>

当我们执行完 <code>cherry-pick</code>操作之后，会自动生成一个<code>commit</code>以及对应新的<code>commit-id</code>

在顺利的情况下我们可以直接通过，但如果遇到代码等因为变量名，写法等不同的情况，<code>cherry-pick</code>大概率会报错，此时我们需要进行报错处理。

第一种方案是手动修改

我们可以先使用<code>git status</code>检查当前遴选时冲突的文件

然后 <code>git checkout --ours filename</code>

然后按照提交的修改内容进行手动修改

随后使用<code>git add</code>命令将文件重新加入暂存区

再使用

<code>git cherry-pick --continue</code>

命令让 cherrypick 操作继续执行。

第二种方案是直接退出<code>cherry-pick</code>进程，一般适用于冲突文件实在太多了难以按照方案一处理的情况。

需要注意的是，如果您当前正在遴选的提交在该分支已经存在也会冲突，在这种情况下，您需要解决冲突并手动解决问题。

<code>git cherry-pick --abort</code>

==== git fetch ====
git fetch 命令用于从远程获取仓库。

==== git merge ====
<code>git merge</code>是用来把分叉的提交历史放回到一起(合并)的方式。

git merge命令用来将你之前使用git branch命令创建的分支以及在此分支上独立开发的内容整合为一个分支。

本

==== git pull ====
用于从远程获取代码并合并本地的版本。

<code>git pull</code>其实就是<code>git fetch</code>和<code>git merge FETCH_HEAD</code> 的简写。

格式如下：

<code>git pull <remote-host-name> <remote-branch-name>:<local-branch-name></code>

==== git rebase ====
用于需要修改历史上某一项commit

<code>git rebase -i HEAD~<commit number></code>

commit number就是从头部往前数的commit数量。执行后会弹出你在git config内配置的编辑器，若未配置则是默认，vim居多。然后就可以看见一堆commit前面有pick字样。可以将pick替换为你想要的操作。
有以下操作：

1.edit，顾名思义编辑此commit，替换完保存后请修改内容，使用<code>git add</code>或vscode，github desktop将修改文件添加到暂存区，之后命令行执行<code>git commit --amend</code>这样commit就修改成了

2.squash，合并几个提交，确认一个父提交，将要合并的commit，从下向上替换字符串，会从下向上合并(方位指的是<code>git rebase</code>后弹出的编辑器)

3.drop，需要移除的commit

4.reword，修改commit信息

另外，还可以使用首字母来说明命令。

==== git subtree ====
子树，在Android开发中多用于Kernel侧更改，如跟踪audio模块等

<code>git subtree add --prefix=<目录> <仓库地址> <远程分支></code>

如果需要更新远程库时

<code>git subtree pull --prefix=<目录> <仓库地址> <远程分支></code>

==== git submodule ====

===== 子模块功能的概述 =====
<code>git submodule</code>允许在自己的Github仓库里加入别人的github仓库，作为自己仓库的子仓库(即submodule)。

为什么我们会需要使用子模块？当我们维护一个项目时有可能遇到以下情况，例如维护某款机型的KernelSU内核，我们需要将KernelSU导入至我们的内核源码中，如果我们直接clone进去容易带来一个问题，如果KernelSU更新了怎么办？此时我们便可以使用子模块来解决这个问题

<code>git submodule</code>允许在git仓库里存放别人仓库的url，作为自己的子模块，其核心内容是在Git仓库里面加入一个<code>.gitmodules</code>文件，里面会记录各个submodule的名字，路径，以及对应链接。

===== 加入子模块 =====
<code>git submodule add <url> <path></code>

此时 <code>.gitmodules</code>内会自动生成以下内容

[submodule "xxx"]

path = xxx

url = xxx

===== 初始化子模块 =====
<code>git submodule init</code>

===== 更新子模块 =====
<code>git submodule update</code>

=== Git进阶 ===

==== GPG key ====

===== 简介 =====
平时在Github上摸鱼的时候，是不是经常能看见如下图所示，有一个绿色的"Verified"字样，看着很酷，实际上这是为了确保commit为开发者本人所写的进行的GPG签名。
[[文件:Github GPG sign.png|居中]]
因为Git的默认机制，任何人都可以通过你的邮箱和用户名创建虚假的commit，甚至你名气很大的话可以“栽赃陷害”你。如果你是某高校计算机专业的同学亦或是对计算机抱有很大的兴趣，乐意为开源社区提供“资源”，那么我建议你设置GPG sign。未来是不可预知的，人人都可能成为巨佬。

===== 使用 =====
因为我只在Mac环境下配置过GPG，Windows只是打游戏用，所以用的少，Linux/类Unix可以参考一下。其它系统等待他人补充......

====== Mac ======
Mac默认是不带GPG的，需要通过第三方软件包安装器Homebrew进行安装，首先先安装Homebrew，如已安装可以跳过。

编辑器限制原因不能使用默认标题进行分步了，故使用1、2、3等小数字代替。

安装Homebrew

在安装之前需要从系统信息中查看芯片为Intel/M系列

Intel使用

<code>/bin/zsh -c "$(curl -fsSL <nowiki>https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh</nowiki>)"</code>

Intel按照脚本提示，选源，输密码，回车一路绿灯就好了，如果这都不会......可能你不是很适合开发，因为该脚本是国内开发者编写的，中文和一键化安装都集齐了。

M系列使用

<code>/bin/zsh -c "$(curl -fsSL https://gitee.com/huwei1024/HomebrewCN/raw/master/Homebrew.sh)"</code>

并且因为M系列系统结构发生改变，包安装位置不在是以前的/usr/local/，而是在/opt/homebrew，所以要将配置文件里的环境变量改过来。

1.首先进入根目录

<code>cd ~</code>

2.创建.zshrc文件

<code>touch .zshrc</code>

3.打开文件进行编辑

<code>open -e .zshrc</code>

4.如果有旧的环境就修改，没有就新增

<code>export PATH="/opt/homebrew/bin:$PATH"

export PATH="/opt/homebrew/sbin:$PATH"</code>

5.保存

使用command + s

6.生效环境变量

<code>source .zshrc</code>

7、测试

<code>brew -v</code>

若终端顺利打印出brew的版本，那么就安装成功了！

注：本人没有使用过M系列设备，该教程在知乎上找到的

使用Homebrew安装GPG

<code>brew install gnupg pinentry-mac</code>

[[文件:截屏2024-02-17 17.34.48.png|居中]]

为GPG添加环境变量，否则在签名的时候会发生报错（使用bash请自行替换配置文件）

<code>echo "export GPG_TTY=$(tty)" >> ~/.zshrc
source ~/.zshrc
</code>

生成一个GPG keys

<code>gpg --full-generate-key</code>

[[文件:截屏2024-02-17 17.45.51.png|居中]]

默认使用的是ECC，我使用的是RSA，按照自己喜好，或从百度搜索非对称和对称加密算法之间的区别，这里只做使用方法的介绍，不做赘述。

然后添写密钥长度和使用有效期，这里建议选择长期，并做备份，一辈子用一个就够了。

[[文件:截屏2024-02-17 17.46.06.png|居中]]
[[文件:截屏2024-02-17 17.46.35.png|居中]]

个人信息按照Github信息填写，真实姓名对应Username。填写完毕按回车输入O即可生成密钥。不出意外的话会弹出Gui窗口让你设置密钥密码，强烈建设设置一个较为复杂的密码，并牢记，当然也可以不设置。

使用GPG对Git的commit和tag进行签名

先为Git定义GPG二进制所在地

<code>git config --global gpg.program $(which gpg)</code>

查看GPG keys ID

<code>gpg --list-secret-keys --keyid-format=long</code>

如图所示RSA/后面紧跟的一串就是GPG keys ID
[[文件:截屏2024-02-17 17.57.01.png|居中]]
<code>git config --global user.signingkey "GPG key ID"</code>

为Git设置全局commit和tag签名

<code>git config --global commit.gpgsign true

git config --global tag.gpgSign true</code>

参见本文“在Github配置GPG keys”部分开启下一步操作

接下来就可以愉快的编写程序了~

======在Github配置GPG keys======
在终端输入

<code>gpg --armor --export "GPG key ID"</code>

将输出的内容从-----BEGIN PGP PUBLIC KEY BLOCK-----到-----END PGP PUBLIC KEY BLOCK-----，包含它们都复制下来。

打开Github网页，并登录自己的账号。按照下述操作依次执行。

头像-->Setting-->SSH and GPG keys-->New GPG key

标题自己怎么舒服怎么来，将第一步复制的内容全部粘贴然后保存起来，这样Github就能识别到你commit中包含的GPG sign的信息了，你就可以在commit history或release等页面看到绿色的签名后的标志了。

==== SSH key ====
可以通过生成SSH key，并保存在Github等托管平台上实现免密Push，这也是官方推荐的方法，过去输入用户名/密码的方式早已被抛弃。

===== 生成Key =====
1.打开终端并输入

<code>ls ~/.ssh</code>

检查是否已经存在了SSH密钥。如果你看到包含id_rsa等文件，说明你已经有了SSH key，可以跳过第 2 步和第 3 步。

2.输入，生成新的SSH密钥。你可以直接按回车键使用默认的文件路径和空密码，也可以自己设置。

<code>ssh-keygen -t rsa -b 4096 -C "your_email@example.com"</code>

4.在终端输入或使用文本编辑器打开，并复制所有内容

<code>vim ~/.ssh/id_rsa.pub</code>

5.打开Github网页，并登录自己的账号。按照下述操作依次执行。

头像-->Setting-->SSH and GPG keys-->New SSH key

自己起个标题名并粘贴4步中所有内容，保存，接下来你可以免密对Github上的repo进行操作了。

==== 参考资料： ====
[1] 百度百科 -- Git：<nowiki>https://baike.baidu.com/item/GIT/12647237?fr=ge_ala</nowiki>

[2] 菜鸟教程 -- Git基本操作：<nowiki>https://www.runoob.com/git/git-basic-operations.html</nowiki>

[3] CSDN -- git merge 使用简介: <nowiki>https://blog.csdn.net/All_In_gzx_cc/article/details/125482617</nowiki>

[4] 知乎 -- MAC 安装 homebrew 国内镜像: <nowiki>https://zhuanlan.zhihu.com/p/547898033</nowiki>

[5] Github -- Generating a new GPG key: <nowiki>https://docs.github.com/en/authentication/managing-commit-signature-verification/generating-a-new-gpg-key</nowiki>

[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>

[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>

[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>

Git使用教程

2024-08-14T15:31:40Z

MoeGLuwu：git: git diff小修改

=== Git的由来： ===
Git是一个开源的分布式版本控制系统，可以有效、高速地处理从很小到非常大的项目版本管理，也是Linus Torvalds为了帮助管理Linux内核开发而开发的一个开放源码的版本控制软件。Torvalds 开始着手开发 Git 是为了作为一种过渡方案来替代 BitKeeper。

=== 常见的代码托管平台： ===
[https://github.com Github]

[https://gitlab.com Gitlab]

[https://gitee.com Gitee]

=== Git 常见命令: ===

==== git init ====
在本地目录中初始化一个新的Git仓库

==== git config ====
用于配置用户的信息以及其他设置,在使用git之前您必须完成以下步骤。

<code>git config --global user.name "your username"</code>

<code>git config --global user.email "your email"</code>

更改默认编辑器

<code>git config --global core.editor nano</code>

==== git clone ====
用于将远程仓库的代码克隆到本地，以下是命令中各个参数的含义：

<code><url></code>

克隆某个地址(url)的仓库，远程仓库的地址可以是本地的目录，也可以是例如github,giteee,gitlab一类的代码托管平台

<code>--depth=<number></code>

克隆仓库并且保留number条提交历史，number在此处即表达我们克隆的深度。

<code>-b <branch></code>

克隆指定分支下的仓库内容

例如我们要克隆<code>LineageOS</code>的内核源码，指定<code>lineage-21</code>分支，且仅保留最近一个提交，则需要输入:

<code>git clone -b lineage-21 <nowiki>https://github.com/LineageOS/android_kernel_xiaomi_sdm845</nowiki> --depth=1</code>

==== git add ====
添加某个文件，或者目录到暂存区，用于告诉git你需要将哪些文件的更改包含在下一次的提交(commit)之中添加一个或者多个文件到暂存区之中

<code>git add [file1] [file2]</code>

添加指定目录(文件)到暂存区，包括子目录：

<code>git add [dir]</code>

添加当前目录下的所有文件到暂存区：

<code>git add .</code>

==== git status ====
查看当前仓库的状态，此时git会在你的终端输出以下内容
此处演示为英文，如果您的git终端输出为中文也是同理的
<pre>
On branch master
No commits yet
Changes to be committed:

(use “git rm --cached <file>...” to unstage)
new file: makefile
</pre>

输出内容分别为
<pre>
您目前所在的分支
目前的提交
需要更改的内容
新增的文件
修改的文件
删除的文件
</pre>

==== git commit ====
用于将暂存区我们保存的更改文件添加到本地仓库，并且会生成一条提交（commit）

提交暂存区的更改到本地仓库

<code>git commit -m "message"</code>

[注] message 可以是你的备注信息

提交暂存区中的指定文件到本地仓库

如果你没有使用上述<code>git add</code>命令暂存你的修改文件，可以使用

<code>git commit -a</code>

进行直接提交

==== git checkout ====

* 用于分支切换

切换分支：

<code>git checkout <branch-name></code>

<code>git checkout <branch-name></code>

例如在您的仓库中有这几个分支：
<pre>
-> master (Default)
backup
test
</pre>
您当前处于 master 分支，如果想要切换到test分支，我们可以使用

<code>git checkout test</code>

* 用于检出文件
将指定的文件恢复到最新的提交状态，撤销你对其的更改

<code>git checkout -- <file></code>

==== git push ====
用于将本地的分支版本上传到远程仓库并进行合并

<code>git push <remote-host-name> <local-branch-name>:<remote-branch-name></code>

remote-host-name:远程主机名

local-branch-name:本地分支名

例如，当你的远程主机名为origin ，本地分支名为master，远程分支名为master时：

<code>git push origin master:master</code>

例如，当你的rhost名为origin 本地分支名为master远程分支名为master时：

本地和远程分支名相同，上述命令可以简写为：

<code>git push origin master</code>

当你的远程版本与本地版本有差异，无法直接push时，你可以使用--force 参数来进行强制推送

<code>git push --force origin master</code>

--force 此处可以直接简单化为 -f

如果你想要删除主机内的某个分支，你可以使用--delete参数

<code>git push origin --delete <branch-name></code>

==== git diff ====
用于比较当前工作区与上一个版本之间的差异<pre>
diff --git a/example b/example

index fbb8c85..d65c7eb 100644

--- a/example

+++ b/example

@@ -1 +1,2 @@

114514

+1919180
</pre>

==== git log ====
用于查看提交的历史

例如当你进行一次提交之后，执行 <code>git log</code>终端会输出

<pre>
commit 3a5b0d12f471418b13f2baf5e9e4c112a5e804a8 (HEAD -> master)

Author: luluzzy <1054438588@qq.com>

Date: Thu Feb 15 21:28:47 2024 +0800

initial commit: add makefile
</pre>

这些输出分别为
<pre>
commit sha1 hash: 针对你这个提交的 commit id
Author: commit 作者名称 <you@example.com>
Date: commit 日期
commit: 名称
</pre>

关于sha1_hash的介绍请看这里<ref>生成这个hash值，它是对那个commit是Git仓库中内容和头信息Header的一个校验和checksum。Linux kernel开创者和Git的开发者——Linus说，Git使用了sha1并非是为了安全性，而是为了数据的完整性；它可以保证，在很多年后，你重新checkout某个commit时，一定是它多年前的当时的状态，完全一摸一样，完全值得信任。在Git中，根据commit的sha1值40个十六进制数字进行了简单的划分目录，以前2位数字作为目录名，其下面是剩余38位数字组成的一个文件名</ref>

当有多次提交之后，如果我们想要翻之前的提交历史，难免会因为终端输出的内容过多而难以查看翻阅

此时我们可以使用<code>--online</code>参数来简化输出，此时仅会输出: sha1哈希值 + commit的名称

例如
<pre>
347595d (HEAD -> master) modify makefile

3a5b0d1 initial commit: add makefile
</pre>

==== git cherry-pick ====

cherry-pick (遴选) 和它的名称一样，挑选一个我们需要的 commit 进行操作。它可以用于将在其他分支上的 commit 修改，移植到当前的分支。

如果我们想在我们正在开发的版本上，添加一个其他版本中的功能代码。就可以使用 cherry-pick ，将这个功能相关的 commit 提取出来，合入该版本。

<code>git cherry-pick <commit-id></code>

当我们执行完 <code>cherry-pick</code>操作之后，会自动生成一个<code>commit</code>以及对应新的<code>commit-id</code>

在顺利的情况下我们可以直接通过，但如果遇到代码等因为变量名，写法等不同的情况，<code>cherry-pick</code>大概率会报错，此时我们需要进行报错处理。

第一种方案是手动修改

我们可以先使用<code>git status</code>检查当前遴选时冲突的文件

然后 <code>git checkout --ours filename</code>

然后按照提交的修改内容进行手动修改

随后使用<code>git add</code>命令将文件重新加入暂存区

再使用

<code>git cherry-pick --continue</code>

命令让 cherrypick 操作继续执行。

第二种方案是直接退出<code>cherry-pick</code>进程，一般适用于冲突文件实在太多了难以按照方案一处理的情况。

需要注意的是，如果您当前正在遴选的提交在该分支已经存在也会冲突，在这种情况下，您需要解决冲突并手动解决问题。

<code>git cherry-pick --abort</code>

==== git fetch ====
git fetch 命令用于从远程获取仓库。

==== git merge ====
<code>git merge</code>是用来把分叉的提交历史放回到一起(合并)的方式。

git merge命令用来将你之前使用git branch命令创建的分支以及在此分支上独立开发的内容整合为一个分支。

本

==== git pull ====
用于从远程获取代码并合并本地的版本。

<code>git pull</code>其实就是<code>git fetch</code>和<code>git merge FETCH_HEAD</code> 的简写。

格式如下：

<code>git pull <remote-host-name> <remote-branch-name>:<local-branch-name></code>

==== git rebase ====
用于需要修改历史上某一项commit

<code>git rebase -i HEAD~<commit number></code>

commit number就是从头部往前数的commit数量。执行后会弹出你在git config内配置的编辑器，若未配置则是默认，vim居多。然后就可以看见一堆commit前面有pick字样。可以将pick替换为你想要的操作。
有以下操作：

1.edit，顾名思义编辑此commit，替换完保存后请修改内容，使用<code>git add</code>或vscode，github desktop将修改文件添加到暂存区，之后命令行执行<code>git commit --amend</code>这样commit就修改成了

2.squash，合并几个提交，确认一个父提交，将要合并的commit，从下向上替换字符串，会从下向上合并(方位指的是<code>git rebase</code>后弹出的编辑器)

3.drop，需要移除的commit

==== git subtree ====
子树，在Android开发中多用于Kernel侧更改，如跟踪audio模块等

<code>git subtree add --prefix=<目录> <仓库地址> <远程分支></code>

如果需要更新远程库时

<code>git subtree pull --prefix=<目录> <仓库地址> <远程分支></code>

==== git submodule ====

===== 子模块功能的概述 =====
<code>git submodule</code>允许在自己的Github仓库里加入别人的github仓库，作为自己仓库的子仓库(即submodule)。

为什么我们会需要使用子模块？当我们维护一个项目时有可能遇到以下情况，例如维护某款机型的KernelSU内核，我们需要将KernelSU导入至我们的内核源码中，如果我们直接clone进去容易带来一个问题，如果KernelSU更新了怎么办？此时我们便可以使用子模块来解决这个问题

<code>git submodule</code>允许在git仓库里存放别人仓库的url，作为自己的子模块，其核心内容是在Git仓库里面加入一个<code>.gitmodules</code>文件，里面会记录各个submodule的名字，路径，以及对应链接。

===== 加入子模块 =====
<code>git submodule add <url> <path></code>

此时 <code>.gitmodules</code>内会自动生成以下内容

[submodule "xxx"]

path = xxx

url = xxx

===== 初始化子模块 =====
<code>git submodule init</code>

===== 更新子模块 =====
<code>git submodule update</code>

=== Git进阶 ===

==== GPG key ====

===== 简介 =====
平时在Github上摸鱼的时候，是不是经常能看见如下图所示，有一个绿色的"Verified"字样，看着很酷，实际上这是为了确保commit为开发者本人所写的进行的GPG签名。
[[文件:Github GPG sign.png|居中]]
因为Git的默认机制，任何人都可以通过你的邮箱和用户名创建虚假的commit，甚至你名气很大的话可以“栽赃陷害”你。如果你是某高校计算机专业的同学亦或是对计算机抱有很大的兴趣，乐意为开源社区提供“资源”，那么我建议你设置GPG sign。未来是不可预知的，人人都可能成为巨佬。

===== 使用 =====
因为我只在Mac环境下配置过GPG，Windows只是打游戏用，所以用的少，Linux/类Unix可以参考一下。其它系统等待他人补充......

====== Mac ======
Mac默认是不带GPG的，需要通过第三方软件包安装器Homebrew进行安装，首先先安装Homebrew，如已安装可以跳过。

编辑器限制原因不能使用默认标题进行分步了，故使用1、2、3等小数字代替。

安装Homebrew

在安装之前需要从系统信息中查看芯片为Intel/M系列

Intel使用

<code>/bin/zsh -c "$(curl -fsSL <nowiki>https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh</nowiki>)"</code>

Intel按照脚本提示，选源，输密码，回车一路绿灯就好了，如果这都不会......可能你不是很适合开发，因为该脚本是国内开发者编写的，中文和一键化安装都集齐了。

M系列使用

<code>/bin/zsh -c "$(curl -fsSL https://gitee.com/huwei1024/HomebrewCN/raw/master/Homebrew.sh)"</code>

并且因为M系列系统结构发生改变，包安装位置不在是以前的/usr/local/，而是在/opt/homebrew，所以要将配置文件里的环境变量改过来。

1.首先进入根目录

<code>cd ~</code>

2.创建.zshrc文件

<code>touch .zshrc</code>

3.打开文件进行编辑

<code>open -e .zshrc</code>

4.如果有旧的环境就修改，没有就新增

<code>export PATH="/opt/homebrew/bin:$PATH"

export PATH="/opt/homebrew/sbin:$PATH"</code>

5.保存

使用command + s

6.生效环境变量

<code>source .zshrc</code>

7、测试

<code>brew -v</code>

若终端顺利打印出brew的版本，那么就安装成功了！

注：本人没有使用过M系列设备，该教程在知乎上找到的

使用Homebrew安装GPG

<code>brew install gnupg pinentry-mac</code>

[[文件:截屏2024-02-17 17.34.48.png|居中]]

为GPG添加环境变量，否则在签名的时候会发生报错（使用bash请自行替换配置文件）

<code>echo "export GPG_TTY=$(tty)" >> ~/.zshrc
source ~/.zshrc
</code>

生成一个GPG keys

<code>gpg --full-generate-key</code>

[[文件:截屏2024-02-17 17.45.51.png|居中]]

默认使用的是ECC，我使用的是RSA，按照自己喜好，或从百度搜索非对称和对称加密算法之间的区别，这里只做使用方法的介绍，不做赘述。

然后添写密钥长度和使用有效期，这里建议选择长期，并做备份，一辈子用一个就够了。

[[文件:截屏2024-02-17 17.46.06.png|居中]]
[[文件:截屏2024-02-17 17.46.35.png|居中]]

个人信息按照Github信息填写，真实姓名对应Username。填写完毕按回车输入O即可生成密钥。不出意外的话会弹出Gui窗口让你设置密钥密码，强烈建设设置一个较为复杂的密码，并牢记，当然也可以不设置。

使用GPG对Git的commit和tag进行签名

先为Git定义GPG二进制所在地

<code>git config --global gpg.program $(which gpg)</code>

查看GPG keys ID

<code>gpg --list-secret-keys --keyid-format=long</code>

如图所示RSA/后面紧跟的一串就是GPG keys ID
[[文件:截屏2024-02-17 17.57.01.png|居中]]
<code>git config --global user.signingkey "GPG key ID"</code>

为Git设置全局commit和tag签名

<code>git config --global commit.gpgsign true

git config --global tag.gpgSign true</code>

参见本文“在Github配置GPG keys”部分开启下一步操作

接下来就可以愉快的编写程序了~

======在Github配置GPG keys======
在终端输入

<code>gpg --armor --export "GPG key ID"</code>

将输出的内容从-----BEGIN PGP PUBLIC KEY BLOCK-----到-----END PGP PUBLIC KEY BLOCK-----，包含它们都复制下来。

打开Github网页，并登录自己的账号。按照下述操作依次执行。

头像-->Setting-->SSH and GPG keys-->New GPG key

标题自己怎么舒服怎么来，将第一步复制的内容全部粘贴然后保存起来，这样Github就能识别到你commit中包含的GPG sign的信息了，你就可以在commit history或release等页面看到绿色的签名后的标志了。

==== SSH key ====
可以通过生成SSH key，并保存在Github等托管平台上实现免密Push，这也是官方推荐的方法，过去输入用户名/密码的方式早已被抛弃。

===== 生成Key =====
1.打开终端并输入

<code>ls ~/.ssh</code>

检查是否已经存在了SSH密钥。如果你看到包含id_rsa等文件，说明你已经有了SSH key，可以跳过第 2 步和第 3 步。

2.输入，生成新的SSH密钥。你可以直接按回车键使用默认的文件路径和空密码，也可以自己设置。

<code>ssh-keygen -t rsa -b 4096 -C "your_email@example.com"</code>

4.在终端输入或使用文本编辑器打开，并复制所有内容

<code>vim ~/.ssh/id_rsa.pub</code>

5.打开Github网页，并登录自己的账号。按照下述操作依次执行。

头像-->Setting-->SSH and GPG keys-->New SSH key

自己起个标题名并粘贴4步中所有内容，保存，接下来你可以免密对Github上的repo进行操作了。

==== 参考资料： ====
[1] 百度百科 -- Git：<nowiki>https://baike.baidu.com/item/GIT/12647237?fr=ge_ala</nowiki>

[2] 菜鸟教程 -- Git基本操作：<nowiki>https://www.runoob.com/git/git-basic-operations.html</nowiki>

[3] CSDN -- git merge 使用简介: <nowiki>https://blog.csdn.net/All_In_gzx_cc/article/details/125482617</nowiki>

[4] 知乎 -- MAC 安装 homebrew 国内镜像: <nowiki>https://zhuanlan.zhihu.com/p/547898033</nowiki>

[5] Github -- Generating a new GPG key: <nowiki>https://docs.github.com/en/authentication/managing-commit-signature-verification/generating-a-new-gpg-key</nowiki>

[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>

[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>

[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>

KernelSU

2024-08-14T15:27:06Z

MoeGLuwu：KernelSU: 初始化修改

KernelSU 是 Android GKI 设备的 root 解决方案，它工作在内核模式，并直接在内核空间中为用户空间应用程序授予 root 权限。

KernelSU 的主要特点是它是基于内核的。 KernelSU 运行在内核空间，所以它可以提供我们以前从未有过的内核接口。例如，我们可以在内核模式下为任何进程添加硬件断点；我们可以在任何进程的物理内存中访问，而无人知晓；我们可以在内核空间拦截任何系统调用; 等等。

KernelSU 还提供了一个基于 overlayfs 的模块系统，允许您加载自定义插件到系统中。它还提供了一种修改 /system 分区中文件的机制。

更多信息，请阅读KernelSU官方wiki，本文不再详细赘述。
https://kernelsu.org

首页

2024-08-14T15:25:15Z

MoeGLuwu：general: Add kernelsu

== 欢迎来到 [[文件:UotanWiki.png|120px]] · 刷机百科 ==
'''我们致力于打造一个更适合国人使用、更贴近刷机本身的玩机知识站点'''

'''本站现有{{NUMBEROFUSERS}}名用户，{{NUMBEROFEDITS}}次编辑，{{NUMBEROFARTICLES}}篇条目，{{NUMBEROFACTIVEUSERS}}位活跃编辑者。'''
== 刷机入门 ==
# [[ADB与Fastboot|ADB 与 Fastboot]]
# [[解锁Bootloader|解锁 Bootloader]]
# [[刷入第三方Recovery|刷入第三方 Recovery]]
# [[获取Root权限|获取 Root 权限]]
# [[Miflash线刷|MiFlash 线刷]]
# [[使用柚坛工具箱进行线刷]]
# [[ADB SideLoad]]
# [[Fastboot Update]]

== 进阶内容 ==
# [[Fastboot 命令]]
# [[刷入任意单独镜像]]
# [[Fastbootd|用户空间Fastboot]]
# [[Project Treble|Project Treble（PT）]]
# [[通用系统镜像|通用系统镜像（GSI）]]
# [[GKI|GKI（通用内核映像）]]
# [[Dynamic System Updates|DSU（Dynamic System Updates）]]
# [[Android Verified Boot|AVB（Android Verified Boot）]]
# [[Super Empty|Super empty]]
# [[9008深度刷机|9008 深度刷机]]
# [[MTK Flashtool深度刷机|MTK Flashtool 深度刷机]]
# [[提取分区]]
# [[修改分区]]
# [[QCN]]

== 系统修改 ==
# [[ADB命令|ADB 命令]]
# [[Magisk模块|Magisk 模块]]
# [[LsPosed 模块|LSPosed 模块]]
# [[KSU 模块]]
# [[KernelSU]]
# [[修改方案合集]]

== Mindows工具箱 ==
# [[为手机刷入Windows|为手机刷入 Windows]]
# [[更新驱动程序]]
# [[重新安装Windows|重新安装 Windows]]
# [[一些常见问题及其解决方案]]

== 高级内容 ==
# [[AOSP]]
# [[Android 分区详解]]
# [[如何解包 Android ROM]]
# [[如何打包 Android ROM]]
# [[如何从源码构建 TWRP Recovery]]
# [[如何从源码构建 Android ROM]]
# [[使用edl.py|使用 edl.py]]
# [[高通端口合集]]
# [[为手机安装Linux|为手机安装 Linux]]
# [[Git使用教程]]
# [[Android内核编译入门]]
# [[为新设备编写Recovery device tree]]
# [[为新设备编写类原生device tree]]

== 知名类原生ROM ==
# [[AfterLife]]
# [[AlphaDroid]]
# [[AOSPA]]
# [[ArrowOS]]
# [[AwakenOS]]
# [[Cipher]]
# [[crDroid]]
# [[dotOS]]
# [[DroidX]]
# [[EvolutionX]]
# [[exTHmUI]]
# [[GrapheneOS]]
# [[LineageOS]]
# [[Miku|Miku UI]]
# [[Mokee]]
# [[PixelExperience]]
# [[RisingTech]]
# [[SuperiorOS]]
# [[SyberiaOS]]
注：以上排名不分先后

== 知名玩机博主 ==
# [[极客湾Geekerwan]]
# [[晨钟酱Official]]
# [[江灵夏草]]
# [[柚坛UOTAN]]
注：以上排名不分先后

== 知名玩机开发者 ==
# [[暮间雾]]
# [[某贼]]
# [[Amktiao]]
# [[小太阳ACA]]
# [[hellobbn]]
注：以上排名不分先后

== 更多词条 ==
# [[设备代号收录集合]]
# [[Android 版本合集]]
# [[Linux mainlining]]
# [[Windows on arm|WOA (Windows on arm)]]

Magisk模块

2024-08-14T14:45:15Z

MoeGLuwu：magisk: 提示用户小心rm，dd，echo

=== '''<big>什么是Magisk模块？</big>''' ===
[[Magisk]]模块是一种可以让用户方便快捷的更改系统的方式，用户可以通过刷入一个模块，来达到修改系统，修改应用的目的，都是得益于Magisk本身的性质，提供了这种快捷方便的方式

=== '''<big>Magisk模块的获取</big>''' ===
可以通过'''用户分享'''，'''Magisk的官方仓库'''，'''酷安'''等途径来获取，在这提醒，不要随意刷模块，因为有人利用模块格机来达到盈利的目的，所以在刷入模块前注意仔细甄别，不要刷来路不明的模块！
请记得解包magisk模块，查看你能看到的每个地方，如果有rm -rf, echo, dd等命令，一定多留个心眼！

Android 版本合集

2024-08-14T14:37:00Z

MoeGLuwu：androidversion: 添加API Level

Android 版本合集

2024-08-14T14:11:59Z

MoeGLuwu：

说明：Android 10开始，Google不再使用甜品代号来公开命名Android版本。本wiki如有记录则为其内部代号。

{| class="wikitable"
|+
!版本
!代号
!发布时间
|-
|Android 1.0
|无
|2008/09
|-
|Android 1.1
|Base
|2009/02
|-
|Android 1.5
|Cupcake
|2009/04
|-
|Android 1.6
|Donut
|2009/09
|-
|Android 2.0
|Eclair
|2009/10
|-
|Android 2.2
|Froyo
|2010/05
|-
|Android 2.3
|Gingerbread
|2010/12
|-
|Android 3.0
|Honeycomb
|2011/02
|-
|Android 4.0
|IceCreamSandwich
|2011/10
|-
|Android 4.1-4.3
|JellyBean
|2012/07
|-
|Android 4.4
|KitKat
|2013/10
|-
|Android 5.0-5.1
|Lollipop
|2014/11
|-
|Android 6.0
|Marshmallow
|2015/10
|-
|Android 7.0-7.1
|Nougat
|2016/08
|-
|Android 8.0-8.1
|Oreo
|2017/08
|-
|Android 9.0
|Pie
|2018/08
|-
|Android 10
|QuinceTart
|2019/09
|-
|Android 11
|RedVelvetCake
|2020/09
|-
|Android 12(L)
|SnowCone
|2021/10
|-
|Android 13
|Tiramisu
|2022/08
|-
|Android 14
|UpsideDownCake
|2023/08
|-
|Android 15
|VanillaIceCream
|暂未发布正式版
|}

Android 版本合集

2024-08-14T14:10:14Z

MoeGLuwu：

说明：Android 10开始，Google不再使用公开甜品代号。本wiki如有记录则为其内部代号。

{| class="wikitable"
|+
!版本
!代号
!发布时间
|-
|Android 1.0
|无
|2008/09
|-
|Android 1.1
|Base
|2009/02
|-
|Android 1.5
|Cupcake
|2009/04
|-
|Android 1.6
|Donut
|2009/09
|-
|Android 2.0
|Eclair
|2009/10
|-
|Android 2.2
|Froyo
|2010/05
|-
|Android 2.3
|Gingerbread
|2010/12
|-
|Android 3.0
|Honeycomb
|2011/02
|-
|Android 4.0
|IceCreamSandwich
|2011/10
|-
|Android 4.1-4.3
|JellyBean
|2012/07
|-
|Android 4.4
|KitKat
|2013/10
|-
|Android 5.0-5.1
|Lollipop
|2014/11
|-
|Android 6.0
|Marshmallow
|2015/10
|-
|Android 7.0-7.1
|Nougat
|2016/08
|-
|Android 8.0-8.1
|Oreo
|2017/08
|-
|Android 9.0
|Pie
|2018/08
|-
|Android 10
|QuinceTart
|2019/09
|-
|Android 11
|RedVelvetCake
|2020/09
|-
|Android 12(L)
|SnowCone
|2021/10
|-
|Android 13
|Tiramisu
|2022/08
|-
|Android 14
|UpsideDownCake
|2023/08
|-
|Android 15
|VanillaIceCream
|暂未发布正式版
|}

Android 版本合集

2024-08-14T14:09:47Z

MoeGLuwu：

说明：Android 10开始，Google不再使用公开甜品代号。本wiki如有记录则为其内部代号。

{| class="wikitable"
|+
!版本
!代号
!发布时间
|-
|Android 1.0
|无
|2008/09
|-
|Android 1.1
|无
|2009/02
|-
|Android 1.5
|Cupcake
|2009/04
|-
|Android 1.6
|Donut
|2009/09
|-
|Android 2.0
|Eclair
|2009/10
|-
|Android 2.2
|Froyo
|2010/05
|-
|Android 2.3
|Gingerbread
|2010/12
|-
|Android 3.0
|Honeycomb
|2011/02
|-
|Android 4.0
|IceCreamSandwich
|2011/10
|-
|Android 4.1-4.3
|JellyBean
|2012/07
|-
|Android 4.4
|KitKat
|2013/10
|-
|Android 5.0-5.1
|Lollipop
|2014/11
|-
|Android 6.0
|Marshmallow
|2015/10
|-
|Android 7.0-7.1
|Nougat
|2016/08
|-
|Android 8.0-8.1
|Oreo
|2017/08
|-
|Android 9.0
|Pie
|2018/08
|-
|Android 10
|QuinceTart
|2019/09
|-
|Android 11
|RedVelvetCake
|2020/09
|-
|Android 12(L)
|SnowCone
|2021/10
|-
|Android 13
|Tiramisu
|2022/08
|-
|Android 14
|UpsideDownCake
|2023/08
|-
|Android 15
|VanillaIceCream
|暂未发布正式版
|}

Android 版本合集

2024-08-14T14:09:10Z

MoeGLuwu：androidversion: 初始化更改

说明：Android 10开始，Google不再使用公开甜品代号。本wiki如有记录则为其内部代号。

{| class="wikitable"
|+
!版本
!代号
!发布时间
|-
|Android 1.0
|无
|2008/09
|-
|Android 1.1
|无
|2009/02
|-
|Android 1.5
|Cupcake
|2009/04
|-
|Android 1.6
|Donut
|2009/09
|-
|Android 2.0
|Eclair
|2009/10
|-
|Android 2.2
|Froyo
|2010/05
|-
|Android 2.3
|Gingerbread
|2010/12
|-
|Android 3.0
|Honeycomb
|2011/02
|-
|Android 4.0
|IceCreamSandwich
|2011/10
|-
|Android 4.1-4.3
|Jelly Bean
|2012/07
|-
|Android 4.4
|KitKat
|2013/10
|-
|Android 5.0-5.1
|Lollipop
|2014/11
|-
|Android 6.0
|Marshmallow
|2015/10
|-
|Android 7.0-7.1
|Nougat
|2016/08
|-
|Android 8.0-8.1
|Oreo
|2017/08
|-
|Android 9.0
|Pie
|2018/08
|-
|Android 10
|QuinceTart
|2019/09
|-
|Android 11
|RedVelvetCake
|2020/09
|-
|Android 12(L)
|SnowCone
|2021/10
|-
|Android 13
|Tiramisu
|2022/08
|-
|Android 14
|UpsideDownCake
|2023/08
|-
|Android 15
|VanillaIceCream
|暂未发布正式版
|}

设备代号收录集合

2024-08-14T09:43:36Z

MoeGLuwu：oneplus: 添加6/6t

目前设备代号收录表格
----

=== 小米/红米：（按发布时间排序） ===
{| class="wikitable"
|机型设备
|代号名称
|发布时间
|-
|红米Note13 4G NFC
|sapphiren
|2024/1/15
|-
|红米Note13 4G
|sapphire
|2024/1/15
|-
|红米13R 5G / 红米13C 5G
|air
|2023/12/8
|-
|红米K70E / POCO X6 Pro 5G
|duchamp
|2023/11/29
|-
|红米K70 Pro
|manet
|2023/11/29
|-
|红米K70
|vermeer
|2023/11/29
|-
|红米13C / POCO C65
|gale
|2023/11/10
|-
|小米14 Pro
|shennong
|2023/10/26
|-
|小米14
|houji
|2023/10/26
|-
|小米13T
|aristotle
|2023/9/26
|-
|红米Note13 Pro 4G / POCO X6
|garnet
|2023/9/21
|-
|红米Note13 5G / 13R Pro
|gold
|2023/9/21
|-
|红米Note13 Pro 5G / Pro+ 5G
|zircon
|2023/9/21
|-
|红米平板SE
|xun
|2023/8/15
|-
|小米MIX Fold 3
|babylon
|2023/8/14
|-
|红米K60 至尊版 / 小米13T Pro
|corot
|2023/8/14
|-
|小米平板6 Max
|yudi
|2023/8/14
|-
|POCO M6 Pro 4G
|emerald
|2023/8/5
|-
|红米Note12R / POCO M6 Pro 5G / 红米12 5G
|sky
|2023/6/23
|-
|红米12
|fire
|2023/6/3
|-
|红米Note12T Pro
|pearl
|2023/5/29
|-
|小米CIVI3
|yuechu
|2023/5/25
|-
|红米Note12S
|sea
|2023/4/26
|-
|小米13 Ultra
|ishtar
|2023/4/18
|-
|小米平板6 Pro
|liuqin
|2023/4/18
|-
|小米平板6
|pipa
|2023/4/18
|-
|红米Note12 Pro 4G
|sweet_k6a
|2023/4/11
|-
|红米Note12 4G NFC
|topaz
|2023/3/30
|-
|红米Note12 4G
|tapas
|2023/3/30
|-
|红米Note12 Turbo / POCO F5 5G
|marble
|2023/3/28
|-
|POCO C51 / 红米A2 / A2+
|water
|2023/3/24
|-
|红米12C / POCO C55
|earth
|2022/12/31
|-
|红米Note12 Pro 极速版 / POCO X5 Pro 5G
|redwood
|2022/12/27
|-
|红米K60E
|rembrandt
|2022/12/27
|-
|红米K60 Pro
|socrates
|2022/12/27
|-
|红米K60 / POCO F5 Pro
|mondrian
|2022/12/27
|-
|小米13 Pro
|nuwa
|2022/12/12
|-
|小米13
|fuxi
|2022/12/12
|-
|POCO X5 5G
|moonstone
|2022/11/20
|-
|红米Note12 5G / 红米Note12R Pro
|sunstone
|2022/10/27
|-
|红米Note12 Pro
|ruby
|2022/10/27
|-
|小米12T
|plato
|2022/10/4
|-
|红米平板
|yunluo
|2022/10/4
|-
|小米CIVI 2 / 小米13 Lite
|ziyi
|2022/9/27
|-
|POCO C50 / 红米A1
|ice
|2022/9/15
|-
|POCO M5S
|rosemary_p
|2022/9/5
|-
|POCO M5 / 红米11 Prime 4G
|rock
|2022/9/5
|-
|小米平板5 Pro 12.4
|dagu
|2022/8/11
|-
|红米K50 至尊版 / 小米12T Pro
|diting
|2022/8/11
|-
|小米MIX Fold 2
|zizhan
|2022/8/11
|-
|小米12S
|mayfly
|2022/7/4
|-
|小米12S Ultra
|thor
|2022/7/4
|-
|小米12S Pro
|unicorn
|2022/7/4
|-
|小米12 Pro 天玑版
|daumier
|2022/7/4
|-
|小米12 Lite
|taoyao
|2022/7/4
|-
|POCO C40
|frost
|2022/6/17
|-
|红米Note11T Pro / Pro+ / POCO X4 GT / Pro / 红米K50i / Pro
|xaga
|2022/5/24
|-
|小米CIVI 1S
|zijin
|2022/4/21
|-
|红米Note 10T
|lilac
|2022/4/14
|-
|红米10A
|dandelion
|2022/3/29
|-
|红米10C
|fog
|2022/3/17
|-
|红米K50
|rubens
|2022/3/17
|-
|红米K50 Pro
|matisse
|2022/3/17
|-
|红米K40S / POCO F4
|munch
|2022/3/17
|-
|红米Note11 Pro
|viva
|2022/3/7
|-
|红米Note11R
|lightcm
|2022/3/7
|-
|红米Note11E / POCO M4 5G / 红米10 Prime+ 5G
|light
|2022/3/7
|-
|红米K50 电竞版 / POCO F4 GT
|ingres
|2022/2/16
|-
|红米Note11 NFC
|spesn
|2022/2/7
|-
|红米Note11
|spes
|2022/2/7
|-
|红米Note11E Pro / 红米Note11 Pro 5G
|veux
|2022/1/26
|-
|红米Note 11S 5G
|opal
|2022/1/26
|-
|红米Note 11S / POCO M4 Pro 4G
|fleur
|2022/1/26
|-
|小米12 Pro
|zeus
|2021/12/28
|-
|小米12X
|psyche
|2021/12/28
|-
|小米12
|cupid
|2021/12/28
|-
|POCO M4 Pro 5G
|evergreen
|2021/11/9
|-
|红米Note11 Pro / Pro+
|pissarro
|2021/10/28
|-
|红米Note11 5G
|evergo
|2021/10/28
|-
|红米Note11 4G
|selenes
|2021/10/28
|-
|小米CIVI
|mona
|2021/9/27
|-
|小米11青春活力版
|lisa
|2021/9/15
|-
|小米11T
|agate
|2021/9/15
|-
|小米11T Pro
|vili
|2021/9/15
|-
|红米10
|selene
|2021/8/19
|-
|小米MIX4
|odin
|2021/8/10
|-
|小米平板5 Pro (WiFi)
|elish
|2021/8/10
|-
|小米平板5 Pro (5G)
|enuma
|2021/8/10
|-
|小米平板5
|nabu
|2021/8/10
|-
|红米Note 10 Pro (China) / POCO X3 GT
|chopin
|2021/5/26
|-
|红米Note 10 (China) / POCO M3 Pro / 红米Note 11 SE
|camellia
|2021/5/26
|-
|红米Note 8 (21年款)
|biloba
|2021/5/24
|-
|红米K40 游戏增强版 / POCO F3 GT
|ares
|2021/4/27
|-
|小米MIX Fold
|cetus
|2021/3/29
|-
|小米11 青春版
|renoir
|2021/3/29
|-
|小米11 Pro / Ultra
|star
|2021/3/29
|-
|小米11 Lite
|courbet
|2021/3/29
|-
|POCO X3 Pro
|vayu
|2021/3/22
|-
|小米10S
|thyme
|2021/3/10
|-
|红米Note 10 Pro
|sweet
|2021/3/4
|-
|红米Note 10 5G
|camellian
|2021/3/4
|-
|红米Note 10S
|rosemary
|2021/3/4
|-
|红米Note 10
|mojito
|2021/3/4
|-
|红米K40 Pro / Pro+ / 小米11i / 小米11X Pro
|haydn
|2021/2/25
|-
|红米K40 / POCO F3
|alioth
|2021/2/25
|-
|小米11
|venus
|2020/12/28
|-
|红米Note 9T 5G
|cannong
|2020/12/1
|-
|红米Note 9 Pro 5G / 小米10T Lite
|gauguin
|2020/11/26
|-
|红米Note 9 5G
|cannon
|2020/11/26
|-
|红米Note 9 4G / 红米9T
|lime
|2020/11/26
|-
|POCO M3
|citrus
|2020/11/24
|-
|红米K30S 至尊纪念版 / 小米10T / 10T Pro
|apollo
|2020/10/27
|-
|POCO C3
|angelicain
|2020/10/6
|-
|POCO M2
|shiva
|2020/9/8
|-
|POCO X3 NFC
|surya
|2020/9/7
|-
|红米9C NFC
|angelican
|2020/8/31
|-
|红米9 (India)
|cattail
|2020/8/27
|-
|小米10 至尊纪念版
|cas
|2020/8/11
|-
|红米K30 至尊纪念版
|cezanne
|2020/8/11
|-
|POCO M2 Pro
|gram
|2020/7/7
|-
|红米9A / 9AT
|dandelion
|2020/6/30
|-
|红米9C
|angelica
|2020/6/30
|-
|红米9
|lancelot
|2020/6/15
|-
|小米Note10 Lite
|toco
|2020/5/30
|-
|红米10X Pro
|bomb
|2020/5/26
|-
|红米10X 5G
|atom
|2020/5/26
|-
|红米K30i 5G
|picasso_48m
|2020/5/26
|-
|红米10X 4G / 红米Note 9
|merlin
|2020/4/30
|-
|小米10 青春版
|vangogh
|2020/4/27
|-
|小米10 Lite
|monet
|2020/3/27
|-
|红米K30 Pro / 变焦版 / POCO F2 Pro
|lmi
|2020/3/24
|-
|红米Note 9 Pro Max
|excalibur
|2020/3/12
|-
|红米Note 9S / Pro (India)
|curtana
|2020/3/12
|-
|红米Note9 Pro
|joyeuse
|2020/3/12
|-
|小米10 Pro
|cmi
|2020/2/13
|-
|小米10
|umi
|2020/2/13
|-
|红米8A Pro / 红米8A Dual
|olivewood
|2020/2/11
|-
|POCO X2 印度版
|phoenixin
|2020/2/4
|-
|红米K30 5G
|picasso
|2019/12/10
|-
|红米K30 4G / POCO X2
|phoenix
|2019/12/10
|-
|红米Note 8T
|willow
|2019/11/6
|-
|小米CC9 Pro / 小米Note 10
|tucana
|2019/11/6
|-
|红米Note 8 Pro 印度版
|begoniain
|2019/10/21
|-
|红米8
|olive
|2019/10/9
|-
|红米8A
|olivelite
|2019/9/25
|-
|小米9 Pro 5G
|crux
|2019/9/24
|-
|红米K20 Pro 尊享版
|raphaels
|2019/9/19
|-
|红米Note 8 Pro
|begonia
|2019/8/29
|-
|红米Note 8
|ginkgo
|2019/8/29
|-
|小米A3
|laurel
|2019/7/17
|-
|小米CC9e
|laurus
|2019/7/2
|-
|小米CC9 / 小米9 Lite
|pyxis
|2019/7/2
|-
|小米CC9 美图定制版
|vela
|2019/7/2
|-
|红米K20 / 小米9T 印度版
|davinciin
|2019/6/12
|-
|红米K20 / 小米9T
|davinci
|2019/5/28
|-
|红米K20 Pro / 小米9T Pro
|raphael
|2019/5/28
|-
|红米K20 Pro 印度版
|raphaelin
|2019/5/28
|-
|红米7A
|pine
|2019/5/22
|-
|红米Y3
|onc
|2019/4/24
|-
|红米7
|onclite
|2019/3/18
|-
|小米MIX 3 5G
|andromeda
|2019/2/24
|-
|小米9
|cepheus
|2019/2/20
|-
|小米9 SE
|grus
|2019/2/20
|-
|红米Go
|tiare
|2019/1/29
|-
|红米Note 7
|lavender
|2019/1/10
|-
|红米Note 7 Pro
|violet
|2019/1/10
|-
|小米Play
|lotus
|2018/12/24
|-
|红米Note 6 Pro
|tulip
|2018/11/22
|-
|小米MIX 3
|perseus
|2018/10/25
|-
|小米8 Lite
|platina
|2018/9/19
|-
|红米6 Pro
|sakura
|2018/9/5
|-
|POCO F1
|beryllium
|2018/8/22
|-
|小米平板4/Plus
|clover
|2018/8/14
|-
|小米A2 Lite
|daisy
|2018/7/24
|-
|小米A2
|jasmine
|2018/7/24
|-
|小米Max 3
|nitrogen
|2018/7/19
|-
|红米6A
|cactus
|2018/6/12
|-
|红米6
|cereus
|2018/6/12
|-
|小米8
|dipper
|2018/5/31
|-
|小米8 Pro 屏幕指纹版
|equuleus
|2018/5/31
|-
|小米8 SE
|sirius
|2018/5/31
|-
|小米8 透明探索版
|ursa
|2018/5/31
|-
|红米S2 / 红米Y2
|ysl
|2018/5/10
|-
|小米6X
|wayne
|2018/4/25
|-
|小米MIX 2S
|polaris
|2018/3/27
|-
|红米Note 5 / Pro
|whyred
|2018/2/14
|-
|红米5
|rosy
|2017/12/7
|-
|红米5 Plus
|vince
|2017/12/7
|-
|红米5A
|riva
|2017/10/20
|-
|小米MIX 2
|chiron
|2017/9/11
|-
|小米Note 3
|jason
|2017/9/11
|-
|小米A1
|tissot
|2017/9/5
|-
|红米Note 5A 高配版
|ugg
|2017/8/21
|-
|红米Note 5A 标准版
|ugglite
|2017/8/21
|-
|小米5X
|tiffany
|2017/7/26
|-
|小米Max 2
|oxygen
|2017/5/25
|-
|小米6
|sagit
|2017/4/19
|-
|小米平板3
|cappu
|2017/4/6
|-
|小米5C
|meri
|2017/2/28
|-
|红米4X
|santoni
|2017/2/28
|-
|红米Note 4X 高通版
|mido
|2017/1/19
|-
|红米Note 4 联发科版
|nikel
|2017/1/19
|-
|红米4 高配版
|markw
|2016/11/4
|-
|红米4 标准版
|prada
|2016/11/4
|-
|红米4A
|rolex
|2016/11/4
|-
|小米MIX
|lithium
|2016/10/25
|-
|小米Note 2
|scorpio
|2016/10/25
|-
|小米5S
|capricorn
|2016/9/27
|-
|小米5S Plus
|natrium
|2016/9/27
|-
|红米Pro
|omega
|2016/7/27
|-
|红米3S
|land
|2016/6/15
|-
|小米Max 高配版
|helium
|2016/6/1
|-
|小米Max 标准版
|hydrogen
|2016/5/10
|-
|小米4S
|aqua
|2016/2/24
|-
|小米5
|gemini
|2016/2/24
|-
|红米3 / Pro
|ido
|2016/1/10
|-
|红米Note 3 台湾特别版
|kate
|2015/11/25
|-
|红米Note 3 全网通版
|kenzo
|2015/11/25
|-
|红米Note 3 双网通版
|hennessy
|2015/11/24
|-
|小米平板2
|latte
|2015/11/24
|-
|小米4C
|libra
|2015/9/22
|-
|红米Note 2
|hermes
|2015/8/13
|-
|小米4i
|ferrari
|2015/4/23
|-
|红米2A 标准版
|lte26007
|2015/3/1
|-
|小米Note 顶配版
|leo
|2015/1/15
|-
|小米Note 双网通 / 全网通
|virgo
|2015/1/15
|-
|红米手机2 增强版
|wt86047
|2015/1/4
|-
|红米手机2
|wt88047
|2015/1/4
|-
|红米Note 4G单卡版
|dior
|2014/8/12
|-
|红米Note 4G双卡版
|gucci
|2014/8/12
|-
|小米3 / 小米4
|cancro
|2014/7/22
|-
|红米手机1S
|armani
|2014/7/16
|-
|红米手机1S 移动3G版
|HM2014011
|2014/7/16
|-
|红米手机1S 移动4G版
|HM2014501
|2014/7/16
|-
|小米平板1
|mocha
|2014/5/15
|-
|红米Note
|lcsh92
|2014/3/20
|-
|小米2A
|taurus
|2013/10/24
|-
|小米3 移动版
|pisces
|2013/9/5
|-
|红米手机
|HM2013023
|2013/7/12
|-
|小米2S
|aries
|2013/6/17
|-
|小米1S
|mione
|2012/8/23
|}

=== Nothing Phone ===
{| class="wikitable"
|+
!机型设备
!机型型号
!机型代号
!发布时间
|-
|Nothing Phone (2)
|A065/AIN065(India)
|Pong
|2023/07/12
|-
|Nothing Phone (1)
|A603
|Spacewar
|2022/7/12
|}

=== 一加 ===
{| class="wikitable"
|+
!机型设备
!机型代号
!发布时间
|-
|一加 7T Pro 5G
|hotdogg
|2019/11/05
|-
|一加 7T Pro
|hotdog
|2019/10/15
|-
|一加 7T
|hotdogb
|2019/10/15
|-
|一加 7 Pro
|guacamole
|2019/05/16
|-
|一加 7
|guacamoleb
|2019/05/16
|-
|一加 6T
|fajita
|2018/11/05
|-
|一加 6
|enchilada
|2018/05/22
|-
|一加 5
|cheeseburger
|2017/11/28
|-
|一加 5T
|dumpling
|2017/12/01
|}

Fastboot 命令

2024-08-14T09:28:33Z

MoeGLuwu：bootloader: 空行

=== '''<big>什么是Fastboot 命令？</big>''' ===
我们在手机进入Fastboot模式后，可以连接电脑，通过Fastboot指令进行调试
----

==== '''列出Fastboot设备''' ====
<code>fastboot devices</code>

==== '''重启相关''' ====
<code>fastboot reboot</code> #重启⼿机

<code>fastboot reboot-bootloader</code> #重启到bootloader模式,其实就是再次进入fastboot

==== '''擦除相关（erase）''' ====
<code>fastboot erase boot</code> #擦除boot分区(擦了引导就没了,会卡在第一屏,)

<code>fastboot erase recovery</code> #擦除recovery分区

<code>fastboot erase system</code> #擦除system分区(擦了系统就没了,会卡在第二屏)

<code>fastboot erase userdata</code> #擦除userdata分区(可擦,清空数据用)

<code>fastboot erase cache</code> #擦除cache分区(可擦,清空数据用)

==== '''刷入分区（flash）''' ====
<code>fastboot flash boot boot.img</code> #写⼊boot分区

<code>fastboot flash recovery recovery.img</code> 写⼊recovery分

<code>fastboot flash system system.img</code> #写⼊system分区

==== '''获取手机的全部信息''' ====
<code>fastboot getvar all</code>

==== '''切换槽位（ab/vab分区专属）''' ====
<code>fastboot set_active other # 切换到另一个槽位。引导加载器模式也可用这条命令.</code>

==== '''其它:''' ====
<code>fastboot -w reboot</code> #清除手机中所有数据然后重启，等同于系统中的“恢复出厂设置”，或Recovery模式的“清空所有数据”操作

<code>fastboot boot <内核镜像文件名或路径></code> #临时启动镜像，不会烧录和替换内核文件到存储中,类似于在PC端用U盘启动PE系统

<code>fastboot oem device-info</code> #输出当前BL锁状态(非MTK)

<code>fastboot oem lks</code> #输出当前BL锁状态(MTK)

<code>fastboot oem reboot-recovery</code> #重启进入Recovery模式

<code>fastboot oem poweroff</code> # 拔掉数据线后关机

<code>fastboot oem lock</code> #重新上BL锁并清空所有数据(需未开启root)

<code>fastboot oem unlock</code> #解除BL锁并清空所有数据(小米手机必须绑定账号,主动申请解锁,等待7天,使用工具才行)

<code>fastboot oem edl</code> #进入高通9008模式,无需工程线或主板短接,可无视BL锁线刷

Fastboot 命令

2024-08-14T09:27:46Z

MoeGLuwu：bootloader: 添加切换槽位命令

Fastbootd

2024-08-14T09:26:14Z

MoeGLuwu：删除重复命令

==== 提示：本教程不是指引导加载程序。 ====

== 关于fastbootd ==

Fastbootd，即用户空间fastboot，是在Android 10开始使用的功能更为强大的刷机模式。

您可以简单理解为fastbootd就是fastboot的升级版。

一般来说fastbootd会整合进recovery。在类原生上，从recovery进入fastbootd方法一般是Advanced -> Enter fastboot。

fastbootd支持对动态分区进行调整和刷写。具体请看下文。

本文不会重复介绍引导加载器一章里的命令。如有必要请前往引导加载器页面：https://wiki.uotan.cn/index.php?title=Fastboot_%E5%91%BD%E4%BB%A4

===== 注意：fastbootd要求最新adb-fastboot工具包，请自行去Google官网下载最新版！ =====

== 命令及详细介绍 ==

===== 通用： =====

* 进入fastbootd
adb reboot fastboot # 开机状态
fastboot reboot fastboot # 引导加载器状态
* 检查当前状态是否为fastbootd
fastboot getvar is-userspace # 如果是，则返回yes；如果不是，则返回no
同理，您可以把<code>is-userspace</code>替换为您需要的变量名进行获取。

===== 动态分区专属： =====
* 清空/重新改造动态分区
fastboot wipe-super path-to-super_empty.img # 使用<code>path-to-super_empty.img</code>来清空动态分区内容并重新改造。在引导加载器也可以执行但是可能会出现玄学问题。
* 逻辑分区相关
fastboot getvar is-logical:partition_name # 检查名为<code>partition_name</code>的分区是否是逻辑分区.
fastboot delete-logical-partition partition_name # 删除名为<code>partition_name</code>的逻辑分区。
fastboot create-logical-partition partition_name 1145141919810 # 新建一个名称为<code>partition_name</code>，大小为<code>1145141919810 Byte</code>的逻辑分区。
fastboot resize-logical-partition partition_name 1145141919810 # 将名为<code>partition_name</code>的大小修改为<code>1145141919810 Byte</code>. 现有可用空间必须大于等于你所修改的分区大小.
* （危险！）在引导加载器模式下刷写动态分区内的分区
fastboot --force flash partition_name path-to-image.img # 强制刷写分区。

== 在设备rom里添加fastbootd（如果不存在） ==
请参考此处提交：https://github.com/PixelExperience-Devices/device_xiaomi_sdm845-common/commit/dcc9496eb18af9522fedf6ce0a8031d1fa2880e0

Fastbootd

2024-08-14T09:15:02Z

MoeGLuwu：/* 关于fastbootd */

==== 提示：本教程不是指引导加载程序。 ====

== 关于fastbootd ==

Fastbootd，即用户空间fastboot，是在Android 10开始使用的功能更为强大的刷机模式。

您可以简单理解为fastbootd就是fastboot的升级版。

一般来说fastbootd会整合进recovery。在类原生上，从recovery进入fastbootd方法一般是Advanced -> Enter fastboot。

fastbootd支持对动态分区进行调整和刷写。具体请看下文。

===== 注意：fastbootd要求最新adb-fastboot工具包，请自行去Google官网下载最新版！ =====

== 命令及详细介绍 ==

===== 通用： =====

* 进入fastbootd
adb reboot fastboot # 开机状态
fastboot reboot fastboot # 引导加载器状态
* 检查当前状态是否为fastbootd
fastboot getvar is-userspace # 如果是，则返回yes；如果不是，则返回no
同理，您可以把<code>is-userspace</code>替换为您需要的变量名进行获取。
* 切换槽位（ab/vab分区专属）
fastboot set_active other # 切换到另一个槽位。引导加载器模式也可用这条命令.
* 刷入分区
fastboot flash partition_name path-to-image.img # 将<code>path-to-image.img</code>刷入到名为<code>partition_name</code>的分区。
* 清空分区
fastboot erase partition_name # 清空名为<code>partition_name</code>的分区.
===== 动态分区专属： =====
* 清空/重新改造动态分区
fastboot wipe-super path-to-super_empty.img # 使用<code>path-to-super_empty.img</code>来清空动态分区内容并重新改造
* 逻辑分区相关
fastboot getvar is-logical:partition_name # 检查名为<code>partition_name</code>的分区是否是逻辑分区.
fastboot delete-logical-partition partition_name # 删除名为<code>partition_name</code>的逻辑分区。
fastboot create-logical-partition partition_name 1145141919810 # 新建一个名称为<code>partition_name</code>，大小为<code>1145141919810 Byte</code>的逻辑分区。
fastboot resize-logical-partition partition_name 1145141919810 # 将名为<code>partition_name</code>的大小修改为<code>1145141919810 Byte</code>. 现有可用空间必须大于等于你所修改的分区大小.
* （危险！）在引导加载器模式下刷写动态分区内的分区
fastboot --force flash partition_name path-to-image.img # 强制刷写分区。

== 在设备rom里添加fastbootd（如果不存在） ==
请参考此处提交：https://github.com/PixelExperience-Devices/device_xiaomi_sdm845-common/commit/dcc9496eb18af9522fedf6ce0a8031d1fa2880e0

Fastbootd

2024-08-14T09:10:49Z

MoeGLuwu：创建页面，内容为“== 关于fastbootd == ===== 提示：本教程不是指引导加载程序。 ===== Fastbootd，即用户空间fastboot，是在Android 10开始使用的功能更为强大的刷机模式。您可以简单理解为fastbootd就是fastboot的升级版。一般来说fastbootd会整合进recovery。在类原生上，从recovery进入fastbootd方法一般是Advanced -> Enter fastboot。 fastbootd支持对动态分区进行调整和刷写。具体请看下文。…”

== 关于fastbootd ==

===== 提示：本教程不是指引导加载程序。 =====
Fastbootd，即用户空间fastboot，是在Android 10开始使用的功能更为强大的刷机模式。

您可以简单理解为fastbootd就是fastboot的升级版。

一般来说fastbootd会整合进recovery。在类原生上，从recovery进入fastbootd方法一般是Advanced -> Enter fastboot。

fastbootd支持对动态分区进行调整和刷写。具体请看下文。

===== 注意：fastbootd要求最新adb-fastboot工具包，请自行去Google官网下载最新版！ =====

== 命令及详细介绍 ==

===== 通用： =====

* 进入fastbootd
adb reboot fastboot # 开机状态
fastboot reboot fastboot # 引导加载器状态
* 检查当前状态是否为fastbootd
fastboot getvar is-userspace # 如果是，则返回yes；如果不是，则返回no
同理，您可以把<code>is-userspace</code>替换为您需要的变量名进行获取。
* 切换槽位（ab/vab分区专属）
fastboot set_active other # 切换到另一个槽位。引导加载器模式也可用这条命令.
* 刷入分区
fastboot flash partition_name path-to-image.img # 将<code>path-to-image.img</code>刷入到名为<code>partition_name</code>的分区。
* 清空分区
fastboot erase partition_name # 清空名为<code>partition_name</code>的分区.
===== 动态分区专属： =====
* 清空/重新改造动态分区
fastboot wipe-super path-to-super_empty.img # 使用<code>path-to-super_empty.img</code>来清空动态分区内容并重新改造
* 逻辑分区相关
fastboot getvar is-logical:partition_name # 检查名为<code>partition_name</code>的分区是否是逻辑分区.
fastboot delete-logical-partition partition_name # 删除名为<code>partition_name</code>的逻辑分区。
fastboot create-logical-partition partition_name 1145141919810 # 新建一个名称为<code>partition_name</code>，大小为<code>1145141919810 Byte</code>的逻辑分区。
fastboot resize-logical-partition partition_name 1145141919810 # 将名为<code>partition_name</code>的大小修改为<code>1145141919810 Byte</code>. 现有可用空间必须大于等于你所修改的分区大小.
* （危险！）在引导加载器模式下刷写动态分区内的分区
fastboot --force flash partition_name path-to-image.img # 强制刷写分区。

== 在设备rom里添加fastbootd（如果不存在） ==
请参考此处提交：https://github.com/PixelExperience-Devices/device_xiaomi_sdm845-common/commit/dcc9496eb18af9522fedf6ce0a8031d1fa2880e0