56 lines
3.4 KiB
Markdown
56 lines
3.4 KiB
Markdown
## release tool
|
||
|
||
### 编译方法
|
||
- 支持CMake, 安装CMake后执行`cmake . && make`
|
||
- 支持Android Make, 源码放到system/tools/release_tools后执行`mm -j4`
|
||
|
||
### 使用说明
|
||
build脚本生成的manifest通常无法直接用来回朔或代码定点发布等, 并且存在 需要切分支/remote修改或部分工程需要隐藏 等问题;
|
||
本工具用于manifest的更新, 适用于代码定点发布, 固件版本回朔等, 使用方法不固定, 可以自行发掘.
|
||
|
||
- 映射服务器mainfest定点更新, 如10.10.10.78服务器作为29服务器的映射, 后期持续维护中只会更新AOSP的代码(只更新tag)以及部分rk稳定的仓库(用hash值固定), 以下命令可以帮助更新78服务器中的那些稳定仓库的hash值.
|
||
```
|
||
release_tool -i rk3326_repository.xml -b manifest_20181119.1436.xml -o rk3326_repository_new.xml [-dir ./PATCHES, 如manifest_2018xxx.xml存在本地提交, 使用这个参数恢复]
|
||
```
|
||
|
||
- 对外服务器定点更新, 对外推送时希望更新对外的manifest中的hash值, 以往都是对比build脚本生成的manifest手动修改hash值, 用脚本机械化会更简单省时.
|
||
```
|
||
release_tool -i rk3326_pie_sdk_express_release_v1.0.xml -b manifest_20181119.1436.xml -o rk3326_repository_new.xml [-dir ./PATCHES, 如manifest_2018xxx.xml存在本地提交, 根据提示的分支处理]
|
||
```
|
||
|
||
- 代码回朔, 由于build脚本生成的manifest只是所有project最新点的快照, 无法区分本地提交或是服务器提交, 用以下命令可以恢复这些有问题的hash值, 输出的manifest能够直接sync, 配合restore_patches.sh能够恢复本地的提交和补丁
|
||
```
|
||
release_tool -i manifest_20181119.1436.xml -b manifest_20181119.1436.xml -o manifest_temp.xml -dir ./PATCHES
|
||
```
|
||
|
||
- 更新时保持某些仓库的点不更新, 注意: 配置文件的优先级比补丁包[-dir参数]高!
|
||
```
|
||
release_tool -i manifest_20181119.1436.xml -b manifest_20181119.1436.xml -o manifest_temp.xml -dir ./PATCHES -c config.ini
|
||
```
|
||
|
||
### 参数说明
|
||
```
|
||
-i 需要基于这些工程进行更新的manifest文件, 需要更新这个列表内的hash值;
|
||
-b 使用 `build.sh` 或 `repo manifest` 命令编译出的manifest文件, 包含所有SDK工程的hash值;
|
||
-o 输出文件, 只更新-i参数中文件的hash值, 不会修改仓库列表及remote地址等;
|
||
-c 使用配置文件, 可以用来过滤project, 使用时此参数时, 当遍历到属于[Filter]这个session下的project时, 会保留原始commitID, 该project的hash值不会更新, 配置文件可以参考config.ini;
|
||
-dir 用于恢复服务器不存在的hash值, 用于代码回朔, 遍历 build.sh脚本所生成的 git-merge-base.txt 文件, 输出-o文件后可直接用于sync.
|
||
```
|
||
|
||
### 一键切换到补丁状态
|
||
- SDK根目录执行以下脚本, 能够自动切换至补丁包中git-merge-base.txt的点并打好其中的补丁:
|
||
```
|
||
./restore_patches.sh [可选, 补丁包路径, 若不指定则默认为: SDK/PATCHES]
|
||
```
|
||
|
||
### AOSP + Gerrit工具
|
||
这两个脚本提供了新工程整合时的操作，注意，脚本依赖gitolite_tool，可以用cmake自行编译下
|
||
- 检查xml中的project是否都在gerrit上创建过，如果没有创建，则创建，注意要删除kernel等无用的工程，以免浪费gerrit的空间
|
||
```shell
|
||
./create_gerrit_projects.sh /path/to/xml
|
||
```
|
||
- 检查上一步中去掉的gerrit上无用的工程，生成remove.xml，整合工程时include即可
|
||
```shell
|
||
./genernate_remove.sh /path/to/xml output.xml
|
||
```
|