文档教程知识库【免费下载链接】tldrCollaborative cheatsheets for console commands .项目地址https://gitcode.com/GitHub_Trending/tl/tldr点击查看免费下载amActivity Manager是 Android 系统中用于与活动管理服务交互的命令行工具通常经由adb shell在设备或模拟器上执行。本篇文章以 tldr 开源仓库中的保加利亚语速查页 pages.bg/android/am.md 为核心骨架结合英文原页 pages.en/android/am.md 与仓库的规范文档、测试脚本逐条拆解am命令最常用的启动与意图转换场景并解析 tldr 页面在占位符语法、选项助记符、翻译本地化与自动化校验方面的工程实践。读完本文你既能直接上手 Android Activity 的启动与 Intent 操作也能理解 tldr 项目一命令一页、最多八例的文档写作与维护机制。一、页面定位am 速查页在仓库中的位置tldr 仓库按平台与语言双重维度组织文档pages/与pages.en/存放英文页面pages.bg/存放保加利亚语български翻译平台目录下再按android、common、linux、osx、windows等细分。am是 Android 专属命令因此存放在android/目录下完整路径为 pages.bg/android/am.md保加利亚语与 pages.en/android/am.md英文。根据仓库的风格指南tldr 页面遵循统一模板标题为命令名本身、以开头的命令描述、官方文档链接以及描述 命令交替排列的示例列表整页最多 8 个命令示例。am页面正是这一模板的典型体现保加利亚语版包含 4 个示例英文原页则多出第 5 个am start -W。同时页面文件名必须全小写且与命令名严格一致am.md标题无需小写但必须与命令名匹配——style-guide.md 明确要求页面文件名与标题必须等于命令名。在 tldr 客户端中当用户查询am时客户端会根据运行平台自动选择最合适的页面版本Android 设备匹配android/目录这正是风格指南中平台差异一节所描述的机制。二、页面结构标题、描述与信息链接am.md开头三行构成页面的元信息区# am Мениджър на дейности на Android. Повече информация: https://developer.android.com/tools/adb#am.标题# am与命令名一致描述行Мениджър на дейности на Android.保加利亚语意为 Android activity managerAndroid 活动管理器。按照风格指南要求描述不应重复页面标题而是简洁地说明功能并避免出现 command-line 之类的冗余修饰信息链接行指向 Android 官方开发者文档中adb#am锚点。风格指南要求More information链接用尖括号包裹、优先链接作者官方文档且建议翻译页与英文页统一使用英文内容的链接本页保加利亚语版即保留了英文官方文档链接因为翻译常与英文页不同步链接若变更难以维护。同目录下的 pages.bg/android/bugreport.md 还明确提示该命令只能通过adb shell使用可以佐证am类系统工具的通用执行环境先adb shell进入设备 shell再执行am ...命令与系统 Activity Manager 服务交互。三、四个核心示例逐条拆解保加利亚语版 am.md 的四个示例完整覆盖了am的两大常用子命令start启动 Activity与to-uri将 Intent 转为 URI。3.1 按组件名与包名启动 ActivityСтартиране на дейността с конкретен компонент и име на пакет [n]ame: 启动具有指定组件与包[n]名的活动am start -n {{com.android.settings/.Settings}}-n是[n]ame的助记符mnemonic用于指定目标组件。参数格式为包名/类名com.android.settings是包名/后的.Settings表示包内相对类名等价于com.android.settings.Settings。该命令可直接启动系统设置页面是自动化测试与日常调试中最常用的启动方式之一。3.2 通过 Action 与 Data 启动意图Стартиране на действие [a]ction и предаване на [d]ata към него: 启动一个动[a]作并向其传递数[d]据am start -a {{android.intent.action.VIEW}} -d {{tel:123}}-a指定 Intent 的[a]ction-d指定[d]ataURI。android.intent.action.VIEW是查看类动作配合tel:123数据会唤起拨号界面并预填号码 123。这条命令演示了隐式 Intent的构造方式不指定具体组件而由系统根据 Action Data 匹配合适的应用。3.3 按 Action 与 Category 启动 ActivityСтартиране на дейност, съответстваща на конкретно [a]ction и [c]ategory: 启动与特定动[a]作和类[c]别相匹配的活动am start -a {{android.intent.action.MAIN}} -c {{android.intent.category.HOME}}-c指定 Intent 的[c]ategory。android.intent.action.MAINandroid.intent.category.HOME组合是 Android 主屏 Activity 的入口条件因此这条命令会启动设备的主界面。该组合也常用于验证设备是否处于可正常回桌面的状态。3.4 将 Intent 转换为 URIКонвертиране на намерение в URI: 将 Intent 转换为 URIam to-uri -a {{android.intent.action.VIEW}} -d {{tel:123}}am to-uri子命令不会真正启动任何 Activity而是把命令行构造出的 Intent 序列化为intent:协议的 URI 并打印到标准输出。该结果可被用于adb shell日志回放、跨进程传递或写入快捷方式等场景。示例与 3.2 保持同一组 Action/DataVIEWtel:123便于对照理解同一 Intent 的启动版与序列化版。四、补充示例英文原页的等待启动英文原页 pages.en/android/am.md与 pages/android/am.md 内容一致在保加利亚语版的基础上多出第 5 个示例Start the home activity on an emulator or device: 在模拟器或设备上启动主界面 Activityam start -W -c android.intent.category.HOME -a android.intent.action.MAIN该命令同样使用MAINHOME组合启动主屏但额外加入了-W选项-W表示等待wait启动流程完成后才返回适合在脚本中需要确认 Activity 已成功启动再继续后续步骤的场景。此例也演示了同一功能在 tldr 中平台页优先、翻译页按需同步的演进关系——翻译页允许暂时落后于英文页由母语维护者后续同步见风格指南中的翻译同步说明。五、tldr 语法规范在 am 页面中的体现5.1 占位符{{ }}页面中所有用户可替换的值都用{{...}}包裹如{{com.android.settings/.Settings}}、{{tel:123}}。这是 tldr 的核心约定客户端可以识别并对占位符做高亮、复制替换等增强处理。风格指南的 Placeholder Syntax 一节规定占位符用于标注用户的选择而描述中已明确写死的值例如-W -c android.intent.category.HOME则不加占位符——am start -W示例中 action 与 category 均为固定值因此直接裸写这正是该规范的忠实执行。5.2 短选项助记符mnemonics页面描述里出现的[n]、[a]、[d]、[c]属于 tldr 独有的短选项助记符用方括号标出短选项所代表的英文单词首字母帮助用户记住-n、-a、-d、-c的含义分别为 name、action、data、category。风格指南对助记符有严格要求必须与官方文档中的含义一致本例即对应am各选项的官方语义区分大小写如-v版本与-V冗长模式不可混淆连续多个助记字符应放在同一组方括号内如e[xp]i[r]ation而非e[x][p]i[r]ation。5.3 描述使用祈使语气风格指南规定所有示例描述必须使用祈使语气imperative moodam页面各条描述均以动词原形开头Стартиране…、Конвертиране…符合描述命令做什么而非正在做什么的写作规范。六、翻译本地化保加利亚语页面的处理方式保加利亚语版 am.md 展示了 tldr 翻译页的典型处理策略命令与选项不翻译am start -n、android.intent.action.VIEW等命令字面量保持英文原样只有描述文本被翻译为保加利亚语助记符保留英文原词描述中同时保留[n]ame、[a]ction、[d]ata、[c]ategory的英文单词。这与风格指南 Short option mnemonics 一节给出的翻译建议一致——当被高亮字符在译文中不存在时可将英文原词放在括号内并列例如 ekstrak (E[x]tract) 的印尼语模式本页即采用在保加利亚语描述中嵌入英文助记词的等价做法专有名词不翻译如Android、URI等作为固定技术词汇保留。此外翻译页默认沿用英文页的祈使语气与占位符规范除非各语言专区另有规定风格指南中仅对中文、印尼语、法语、葡萄牙语、西班牙语等设有专区规则保加利亚语目前遵循通用规则。七、质量保障lint 与测试机制tldr 仓库为每个页面配备了两层自动化校验保证am.md这类页面长期符合格式规范tldr-lint专门校验 tldr 页面格式页面布局、占位符语法、助记符、命令示例数量等。仓库的 scripts/test-tldr-lint.sh 展示了实际的 lint 配置默认忽略TLDR104检查项阿拉伯语、孟加拉语、波斯语、印地语、日语、韩语、老挝语、马拉雅拉姆语、尼泊尔语、泰语、泰米尔语、土耳其语等语言额外检查TLDR003/TLDR004/TLDR015中文额外检查TLDR005而英文pages.en符号链接指向pages则不做任何忽略保加利亚语pages.bg不在特例列表中故仅忽略TLDR104。本地复现校验可运行npx tldr-lint pages.bg/android/am.mdmarkdownlint仓库 package.json 中定义了lint-markdownmarkdownlint pages*/**/*.md、lint-tldr-pagestldr-lint ./pages与testbash scripts/test.sh等 npm scripts提交前可通过这些命令批量验证全仓库页面。风格指南还提示若想本地预览页面渲染效果可使用tldr --render path/to/tldr_page.md配合编辑器即可在提交前检查am.md这类页面的最终呈现。八、关联 Android 命令页与扩展阅读am只是 Android 设备调试命令族的一员pages.bg/android/目录还收录了同属adb shell环境的相关命令可对照阅读pages.bg/android/bugreport.md生成设备完整错误报告页面明确标注仅能通过adb shell使用pages.bg/android/cmd.mdAndroid 服务管理器cmd -l列出所有运行中的服务pages.bg/android/dalvikvm.md启动 Dalvik/ART Java 虚拟机的类路径入口。若希望深入了解 tldr 页面格式的完整约定页面模板、占位符命名、路径写法、助记符规则、翻译规范等可精读 contributing-guides/style-guide.mdCLIENT-SPECIFICATION.md 则面向 tldr 客户端实现者说明了客户端如何解析页面并决定按平台展示android/目录下的对应页面。掌握am页面的同时也就掌握了 tldr 社区简洁、规范、可校验的速查文档方法论。赞分享文档教程知识库【免费下载链接】tldrCollaborative cheatsheets for console commands .项目地址https://gitcode.com/GitHub_Trending/tl/tldr点击查看免费下载相关推荐tldr 项目实战解读Android amActivity Manager命令速查手册tldr 项目实战解读Android am Activity Manager命令速查手册 am 是 Android 系统自带的 活动管理器Activit文档教程知识库tldr 中的 cp 命令阿拉伯语速查页面的八个实战示例与多语言规范解析tldr 中的 cp 命令阿拉伯语速查页面的八个实战示例与多语言规范解析 导读 cp copy是 GNU coreutils 中最常用的文件复制命令几乎文档教程知识库scp 命令速查指南tldr 仓库中基于 SSH 的安全文件复制实战与页面规范解析scp 命令速查指南tldr 仓库中基于 SSH 的安全文件复制实战与页面规范解析 scp Secure Copy Protocol是在 SSH 之上完成文档教程知识库创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考