android manifest.xml 元素意义

本文介绍Android中Activity的各种配置属性,包括activity的启动模式、任务关联性等,帮助开发者更好地理解和使用Activity。
android:allowTaskReparenting

是否允许activity更换从属的任务,比如从短信息任务 切换到浏览器任务。
--------------------------------------------------------------------------------------
android:alwaysRetainTaskState

是否保留状态不变, 比如切换回home, 再从新打开, activity处于最后的状态
--------------------------------------------------------------------------------------
android:clearTaskOnLanunch

比如 P 是 activity, Q 是被P 触发的 activity, 然后返回Home, 从新启动 P, 是否显示 Q
--------------------------------------------------------------------------------------
android:configChanges

当配置list发生修改时, 是否调用 onConfigurationChanged() 方法 比如 "locale|navigation|orientation".
--------------------------------------------------------------------------------------

android:enabled

activity 是否可以被实例化,
--------------------------------------------------------------------------------------

android:excludeFromRecents

是否可被显示在最近打开的activity列表里
--------------------------------------------------------------------------------------
android:exported

是否允许activity被其它程序调用
--------------------------------------------------------------------------------------
android:finishOnTaskLaunch

是否关闭已打开的activity当用户重新启动这个任务的时候
--------------------------------------------------------------------------------------
android.icon
--------------------------------------------------------------------------------------
android:label
--------------------------------------------------------------------------------------
android:launchMode

activity启动方式, "standard" "singleTop" "singleTask" "singleInstance" 其中前两个为一组, 后两个为一组
--------------------------------------------------------------------------------------

android:multiprocess
允许多进程
--------------------------------------------------------------------------------------
android:name

activity的类名, 必须指定

--------------------------------------------------------------------------------------
android:onHistory
是否需要移除这个activity当用户切换到其他屏幕时。 这个属性是 API level 3 中引入的
--------------------------------------------------------------------------------------

android:permission
--------------------------------------------------------------------------------------
android:process
一个activity运行时所在的进程名,所有程序组件运行在应用程序默认的进程中,这个进程名跟应用程序的包名一致。<application>中的元素process属性能够为所有组件设定一个新的默认值。但是任何组件都可以覆盖这个默认值,允许你将你的程序放在多进程中运行。 如果这个属性被分配的名字以:开头,当这个activity运行时, 一个新的专属于这个程序的进程将会被创建。如果这个进程名以小写字母开头,这个activity将会运行在全局的进程中,被它的许可所提供。
--------------------------------------------------------------------------------------

android:screenOrientation

activity显示的模式, "unspecified" 默认值 "landscape" 风景画模式,宽度比高度大一些 "portrait" 肖像模式, 高度比宽度大。 "user" 用户的设置 "behind" "sensor" "nosensor"

--------------------------------------------------------------------------------------

android:stateNotNeeded

是否 activity被销毁和成功重启并不保存状态

--------------------------------------------------------------------------------------

android:taskAffinity

activity的亲属关系, 默认情况同一个应用程序下的activity有相同的关系

--------------------------------------------------------------------------------------

android:theme

activity的样式主题, 如果没有设置,则activity的主题样式从属于应用程序, 参见<application>元素的theme属性
--------------------------------------------------------------------------------------

android:windowSoftInputMode

activity主窗口与软键盘的交互模式, 自从API level 3 被引入
<think>我们面对的是一个Android Repo管理的项目,需要遍历.repo/manifest.xml文件中的各个project,并获取每个project的commit id。 根据引用[1]和[2],我们知道.repo目录下包含manifests.git(或manifests)这个Git仓库,它存储了manifest.xml文件。实际上,我们通常使用.repo/manifests目录下的xml文件(可能是manifest.xml或者是通过符号链接指向的实际xml文件)。 步骤: 1. 确定manifest文件的位置:通常位于.repo/manifests/下。但实际使用的manifest可能是由.repo/manifest.xml符号链接指向的(例如,指向.repo/manifests/default.xml)。因此,我们可以使用.repo/manifest.xml这个文件(如果存在)或者通过.repo/manifests/目录下的文件来确定。 2. 解析manifest.xml文件:该文件是一个XML文件,其中包含多个<project>元素。每个<project>元素有name(远程仓库名)和path(本地路径)等属性。重要的是,我们需要获取每个project的revision(即commit id或分支名)。但注意,revision可能定义在<project>元素上,也可能定义在其父元素<default>中(引用[3]提到,revision可以是一个分支名,也可以是一个commit id)。 3. 对于每个project,我们需要确定其revision(即commit id)。但是,如果revision是一个分支名,我们还需要进一步获取该分支当前指向的commit id。 4. 另外,根据引用[2],我们知道Repo工具本身将manifest仓库和repo仓库作为两个特殊的项目(MetaProject)进行管理。所以,我们可能还需要考虑这两个项目?但用户问题中只要求遍历manifest.xml里的各个project,所以通常不包括这两个。 因此,我们可以通过以下步骤实现: 步骤1:找到当前仓库使用的manifest文件。 - 通常,.repo/manifest.xml是一个符号链接,指向.repo/manifests/下的某个xml文件(如default.xml)。我们可以读取这个符号链接指向的实际文件。 步骤2:解析该XML文件,获取所有的<project>元素。 - 读取每个<project>元素的name、path和revision属性(如果没有revision属性,则使用<default>标签中的revision)。 步骤3:对于每个project,如果revision是一个分支(引用[3]提到,revision可以是分支名),则需要获取该分支当前指向的commit id;如果revision是一个commit id,则直接使用。 步骤4:输出每个project的name、path、revision(分支名)和commit id(实际的哈希值)。 注意:由于我们可能无法直接通过manifest.xml中的revision属性判断是分支还是commit id(因为commit id也是哈希字符串,分支是字符串,但有时分支名可能是哈希?通常不会),我们可以尝试: - 在project的路径下,使用git命令检查这个revision是一个分支还是commit id。但是,更可靠的做法是:在project的路径下,使用`git rev-parse`来获取该revision对应的commit id。 具体实现: 1. 确定manifest文件: manifest_file=".repo/manifest.xml" if [ ! -e "$manifest_file" ]; then echo "Error: .repo/manifest.xml not found." >&2 exit 1 fi # 如果manifest.xml是符号链接,则获取其实际路径 if [ -L "$manifest_file" ]; then manifest_file=$(readlink -f "$manifest_file") fi 2. 使用工具解析XML:在shell中,我们可以使用`xmllint`(需要安装libxml2)或者`xmlstarlet`来解析XML。 这里我们使用`xmllint`(更常见)来提取所有的project节点及其属性。 3. 提取每个project的name、path和revision(如果没有revision,则使用default的revision): default_revision=$(xmllint --xpath '//default/@revision' "$manifest_file" | awk -F'"' '{print $2}') # 然后遍历每个project xmllint --xpath '//project' "$manifest_file" | while read -r project_node; do # 提取属性 name=$(echo "$project_node" | grep -o 'name="[^"]*"' | cut -d'"' -f2) path_attr=$(echo "$project_node" | grep -o 'path="[^"]*"' | cut -d'"' -f2) revision=$(echo "$project_node" | grep -o 'revision="[^"]*"' | cut -d'"' -f2) # 如果没有指定revision,则使用default_revision if [ -z "$revision" ]; then revision="$default_revision" fi # 如果没有path属性,则使用name作为路径 if [ -z "$path_attr" ]; then path_attr="$name" fi # 现在,我们有了项目路径(相对于仓库根目录)和revision(可能是分支名或commit id) # 进入该项目目录,获取实际的commit id full_path=".repo/project-objects/${name}.git" # 注意:在.repo/project-objects下存储了每个项目的裸仓库 # 但是,根据repo的目录结构,我们也可以使用.repo/projects/$path_attr.git(但这里使用project-objects更为直接,因为name是唯一的) # 或者,我们可以使用工作目录:$path_attr,但需要确保该目录已经同步(可能没有同步,所以我们使用裸仓库) # 裸仓库的位置:.repo/project-objects/$name.git # 使用git命令在裸仓库中获取revision对应的commit id if [ -d ".repo/project-objects/${name}.git" ]; then commit_id=$(git --git-dir=".repo/project-objects/${name}.git" rev-parse --verify -q ${revision}^{commit} 2>/dev/null) if [ -z "$commit_id" ]; then # 如果失败,可能是revision不存在,或者项目未下载 commit_id="unknown" fi else commit_id="not_downloaded" fi echo "Project: $name" echo "Path: $path_attr" echo "Revision: $revision" echo "Commit ID: $commit_id" echo "-----------------------------------" done 但是,上面的循环处理project节点的方式不够健壮,因为`xmllint --xpath '//project'`输出的格式可能不是每行一个节点(而是连续输出)。我们可以使用`xmllint`配合`--shell`或者使用`xmlstarlet`更合适。 另一种方法是使用`xmlstarlet`工具(如果系统没有,需要安装)来逐个提取节点。 考虑到兼容性,这里我们使用`xmllint`结合循环: # 获取project节点的数量 count=$(xmllint --xpath 'count(//project)' "$manifest_file") for ((i=1; i<=count; i++)); do # 提取第i个project节点 name=$(xmllint --xpath "string(//project[$i]/@name)" "$manifest_file") path_attr=$(xmllint --xpath "string(//project[$i]/@path)" "$manifest_file") revision=$(xmllint --xpath "string(//project[$i]/@revision)" "$manifest_file") # 如果revision为空,则使用default的revision if [ -z "$revision" ]; then revision=$default_revision fi # 如果path为空,则使用name if [ -z "$path_attr" ]; then path_attr="$name" fi # 处理裸仓库路径 if [ -d ".repo/project-objects/${name}.git" ]; then commit_id=$(git --git-dir=".repo/project-objects/${name}.git" rev-parse --verify -q ${revision}^{commit} 2>/dev/null) # 如果失败,尝试直接获取该分支或标签的引用(但要求必须是commit) if [ -z "$commit_id" ]; then commit_id=$(git --git-dir=".repo/project-objects/${name}.git" rev-parse --verify -q ${revision} 2>/dev/null) # 检查是否为commit(避免是树或标签) if git --git-dir=".repo/project-objects/${name}.git" cat-file -t "$commit_id" 2>/dev/null | grep -q "commit"; then : # 是commit else commit_id="invalid" fi fi else commit_id="not_downloaded" fi # 输出 echo "Project: $name" echo "Path: $path_attr" echo "Revision: $revision" echo "Commit ID: ${commit_id:-unknown}" echo "-----------------------------------" done 注意:如果项目还没有下载(即.repo/project-objects下没有对应的仓库),则无法获取commit id。 但是,我们也可以考虑另一种方式:repo forall命令。实际上,repo工具提供了一个命令`repo forall`可以在每个项目上执行命令。 我们可以使用:`repo forall -c 'echo $REPO_PROJECT $REPO_PATH $REPO_REVISION'`,但是这里获取的REPO_REVISION是manifest中指定的revision(可能是分支或commit id),而不是最终的commit id。 要获取每个项目的commit id,我们可以: repo forall -c 'echo $REPO_PROJECT `git rev-parse HEAD`' 但是,这需要项目已经checkout(即工作目录存在)。如果我们还没有同步代码,则无法使用。 我们的需求是直接从manifest.xml中解析并利用裸仓库(即使没有工作目录)来获取commit id,所以使用裸仓库的方法更通用。 因此,我们综合上面的思路,编写脚本如下: 注意:我们假设.repo/manifest.xml存在,并且裸仓库在.repo/project-objects下。 但是,在repo的目录结构中,manifest仓库本身并不在manifest.xml的project列表中,它是一个特殊的项目。所以,我们脚本中只处理manifest.xml中列出的project。 另外,我们需要处理默认的revision(在default标签中)。 完整脚本如下: ```bash #!/bin/bash # 设置manifest文件路径 manifest_file=".repo/manifest.xml" # 如果manifest.xml是符号链接,则获取实际路径 if [ -L "$manifest_file" ]; then manifest_file=$(readlink -f "$manifest_file") fi if [ ! -f "$manifest_file" ]; then echo "错误: 找不到manifest文件: $manifest_file" >&2 exit 1 fi # 获取默认revision default_revision=$(xmllint --xpath 'string(//default/@revision)' "$manifest_file") # 获取project节点的数量 count=$(xmllint --xpath 'count(//project)' "$manifest_file") # 如果没有project节点,则退出 if [ "$count" -eq 0 ]; then echo "没有找到任何project节点" exit 0 fi # 遍历每个project节点 for ((i=1; i<=count; i++)); do # 提取属性 name=$(xmllint --xpath "string(//project[$i]/@name)" "$manifest_file") path_attr=$(xmllint --xpath "string(//project[$i]/@path)" "$manifest_file") revision=$(xmllint --xpath "string(//project[$i]/@revision)" "$manifest_file") # 如果没有指定revision,则使用默认的 if [ -z "$revision" ]; then revision="$default_revision" fi # 如果没有指定path,则使用name作为路径 if [ -z "$path_attr" ]; then path_attr="$name" fi # 检查裸仓库是否存在 if [ -d ".repo/project-objects/${name}.git" ]; then # 进入裸仓库目录,获取commit id commit_id=$(git --git-dir=".repo/project-objects/${name}.git" rev-parse --verify -q ${revision}^{commit} 2>/dev/null) if [ -z "$commit_id" ]; then # 尝试直接解析revision(可能是一个标签或分支) commit_id=$(git --git-dir=".repo/project-objects/${name}.git" rev-parse --verify -q "$revision" 2>/dev/null) # 验证是否为commit(因为rev-parse可能返回标签对象或树对象) if [ -n "$commit_id" ]; then # 获取对象类型 obj_type=$(git --git-dir=".repo/project-objects/${name}.git" cat-file -t "$commit_id" 2>/dev/null) if [ "$obj_type" != "commit" ]; then # 如果不是commit,则尝试进一步解析(例如标签) commit_id=$(git --git-dir=".repo/project-objects/${name}.git" rev-parse --verify -q "$revision^{commit}" 2>/dev/null) fi fi # 如果还是空,则标记为未知 if [ -z "$commit_id" ]; then commit_id="unknown" fi fi else commit_id="not_downloaded" fi # 输出结果 echo "Project: $name" echo "Path: $path_attr" echo "Revision: $revision" echo "Commit ID: $commit_id" echo "-----------------------------------" done ``` 注意: 1. 该脚本需要在Android Repo仓库的根目录下运行(即.repo目录的父目录)。 2. 依赖xmllint(通常由libxml2-utils包提供)和git。 3. 如果项目还没有下载(not_downloaded),则无法获取commit id。 4. 解析revision时,我们首先尝试将其解析为commit(通过后缀^{commit}),如果失败,则尝试直接解析,并检查对象类型,如果不是commit,则再次尝试解析为commit(例如,如果revision是一个标签,则指向的commit)。 另外,如果revision是一个分支名,那么上述方法会返回该分支当前指向的commit id。 最后,我们生成相关问题: </think>### Android Repo 项目遍历 Commit ID 方法 以下是针对 Android Repo 项目中遍历 manifest.xml 文件获取各项目 commit ID 的完整解决方案: ```bash #!/bin/bash # 步骤1:定位 manifest 文件 manifest_file=".repo/manifest.xml" if [ -L "$manifest_file" ]; then manifest_file=$(readlink -f "$manifest_file") fi if [ ! -f "$manifest_file" ]; then echo "错误: 找不到 manifest 文件" >&2 exit 1 fi # 步骤2:解析 manifest.xml 获取默认 revision default_revision=$(xmllint --xpath 'string(/manifest/default/@revision)' "$manifest_file" 2>/dev/null) # 步骤3:遍历所有 project 节点 xmllint --xpath '//project' "$manifest_file" 2>/dev/null | while read -r project; do # 提取项目属性 name=$(echo "$project" | grep -oP 'name="\K[^"]+') path_attr=$(echo "$project" | grep -oP 'path="\K[^"]+' || echo "$name") revision=$(echo "$project" | grep -oP 'revision="\K[^"]+' || echo "$default_revision") # 获取实际 commit ID repo_dir=".repo/project-objects/${name}.git" if [ -d "$repo_dir" ]; then commit_id=$(git --git-dir="$repo_dir" rev-parse --verify "$revision" 2>/dev/null) [ -z "$commit_id" ] && commit_id="<无效的revision>" else commit_id="<项目未下载>" fi # 输出结果 echo "项目名称: $name" echo "本地路径: $path_attr" echo "指定版本: $revision" echo "Commit ID: $commit_id" echo "------------------------------------" done ``` ### 关键步骤说明 1. **Manifest 文件定位** 自动处理符号链接,确保找到实际 manifest 文件[^1]: ```bash manifest_file=$(readlink -f ".repo/manifest.xml") ``` 2. **XML 解析技术** 使用 `xmllint` 工具解析 XML 结构: - 获取默认 revision:`/manifest/default/@revision` - 遍历所有 project 节点:`//project` 3. **属性提取逻辑** 正则表达式提取关键属性: ```bash name=$(echo "$project" | grep -oP 'name="\K[^"]+') ``` 4. **Commit ID 获取** 通过裸仓库获取实际 commit ID[^2]: ```bash git --git-dir=".repo/project-objects/${name}.git" rev-parse --verify "$revision" ``` 5. **特殊处理逻辑** - 路径缺省时使用项目名:`path_attr || echo "$name"` - 无效 revision 处理:`[ -z "$commit_id" ] && commit_id="<无效的revision>"` ### 使用说明 1. 保存为 `get_repo_commits.sh` 2.Android 源码根目录执行: ```bash chmod +x get_repo_commits.sh ./get_repo_commits.sh ``` ### 输出示例 ```text 项目名称: platform/build 本地路径: build 指定版本: main Commit ID: 8a4b3d7f1e2c6a9b0c5d8e7f1a2b3c4d5e6f7a8b ------------------------------------ 项目名称: platform/frameworks/base 本地路径: frameworks/base 指定版本: android12-release Commit ID: d9e8f7a6b5c4d3e2f1a0b9c8d7e6f5a4b3c2d1e0 ------------------------------------ ``` ### 注意事项 1. 需要安装 `xmllint` 工具:`sudo apt install libxml2-utils` 2. `.repo/project-objects` 包含所有项目的裸仓库[^1] 3. `revision` 可以是分支名或 commit ID[^3] 4. 项目未下载时将显示 `<项目未下载>` 5. 确保在 Repo 初始化的 Android 源码根目录执行
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值