龙华营销型网站建设公司视觉传达设计网站

龙华营销型网站建设公司,视觉传达设计网站,济宁网站建设多少钱,网站国外空间源码分析 Android.bp // bugreportz // package {// 许可证配置#xff1a;继承 frameworks_native 项目的 Apache 2.0 许可证// 相关说明#xff1a;http://go/android-license-faq// 大规模变更添加了 default_applicable_licenses 以导入所有许可证类型default_applicabl…源码分析Android.bp// bugreportz // package { // 许可证配置继承 frameworks_native 项目的 Apache 2.0 许可证 // 相关说明http://go/android-license-faq // 大规模变更添加了 default_applicable_licenses 以导入所有许可证类型 default_applicable_licenses: [frameworks_native_license], } // 构建 bugreportz 可执行文件 cc_binary { name: bugreportz, // 目标二进制文件名称 // 源代码文件列表 srcs: [ bugreportz.cpp, // 主功能实现源文件 main.cpp, // 程序入口源文件 ], // 编译器标志开启所有警告并将警告视为错误确保代码质量 cflags: [ -Werror, -Wall, ], // 链接的共享库依赖 shared_libs: [ libbase, // Android 基础库提供字符串、文件操作等常用功能 libcutils, // Android C 工具库 ], } // bugreportz_test // // 构建 bugreportz 的测试程序 cc_test { name: bugreportz_test, // 测试模块名称 test_suites: [device-tests], // 指定属于设备端测试套件 // 编译器标志保持与主程序一致的严格编译选项 cflags: [ -Werror, -Wall, ], // 测试源代码复用主程序代码并添加测试用例 srcs: [ bugreportz.cpp, // 复用主程序功能代码进行测试 bugreportz_test.cpp, // 测试用例实现文件 ], // 静态链接的测试框架 static_libs: [libgmock], // Google Mock 测试框架 // 链接的共享库依赖 shared_libs: [ libbase, // Android 基础库 libutils, // Android 工具库测试专用 ], }bugreportz.h// Copyright 2016 Google Inc. All Rights Reserved. // // Licensed under the Apache License, Version 2.0 (the License); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an AS IS BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. // 头文件保护防止重复包含导致的编译错误 #ifndef BUGREPORTZ_H // 检查 BUGREPORTZ_H 宏是否未定义 #define BUGREPORTZ_H // 定义该宏标记头文件已包含 // 函数声明通过 socket 调用 dumpstate 服务将处理后的结果输出到标准输出 // 参数 s: socket 文件描述符不转移所有权由调用方管理 // 参数 show_progress: 是否显示进度信息控制 BEGIN:/PROGRESS: 行的输出 // 返回值: 成功返回 EXIT_SUCCESS失败返回 EXIT_FAILURE见实现 int bugreportz(int s, bool show_progress); // 函数声明通过 socket 调用 dumpstate 服务将原始数据流直接输出到标准输出 // 参数 s: socket 文件描述符不转移所有权由调用方管理 // 特点: 不做行解析和过滤适用于二进制数据或大文件流式传输 // 返回值: 成功返回 EXIT_SUCCESS失败返回 EXIT_FAILURE见实现 int bugreportz_stream(int s); #endif // BUGREPORTZ_H // 头文件保护结束标记main.cpp// 包含标准 C 错误处理头文件提供 errno 全局变量和错误码定义 #include errno.h // 包含命令行参数解析头文件提供 getopt() 函数 #include getopt.h // 包含标准输入输出头文件提供 fprintf(), printf() 等函数 #include stdio.h // 包含 socket 通信头文件提供 socket 相关函数和数据结构 #include sys/socket.h // 包含系统类型定义头文件提供基本数据类型定义 #include sys/types.h // 包含 Unix 标准头文件提供 close(), sleep() 等系统调用 #include unistd.h // 包含 Android 属性系统头文件提供 property_set() 函数 #include cutils/properties.h // 包含 Android 本地 socket 工具头文件提供 socket_local_client() 函数 #include cutils/sockets.h // 包含 bugreportz 核心功能头文件提供 bugreportz() 和 bugreportz_stream() 函数声明 #include bugreportz.h // 定义程序版本号常量用于 -v 参数输出 static constexpr char VERSION[] 1.2; // 辅助函数显示命令行使用帮助信息 // 输出到 stderr符合 Unix 惯例帮助信息属于错误输出而非标准输出 static void show_usage() { fprintf(stderr, usage: bugreportz [-hpsv]\n // 显示所有支持的选项 -h: to display this help message\n // 帮助选项 -p: display progress\n // 显示进度信息 -s: stream content to standard output\n // 流式输出模式 -v: to display the version\n // 版本信息选项 or no arguments to generate a zipped bugreport\n); // 默认行为 } // 辅助函数显示程序版本号 // 同样输出到 stderr与 Android 工具链惯例保持一致 static void show_version() { fprintf(stderr, %s\n, VERSION); } // 主函数程序入口点 // param argc: 命令行参数个数 // param argv: 命令行参数字符串数组 // return: 程序退出码EXIT_SUCCESS 或 EXIT_FAILURE int main(int argc, char* argv[]) { // 初始化配置变量默认不显示进度不使用流式模式 bool show_progress false; bool stream_data false; // 检查是否有命令行参数需要解析 if (argc 1) { /* parse arguments */ int c; // 存储当前解析到的选项字符 // 循环解析短选项-h, -p, -s, -v // getopt() 会更新全局变量 optind 指向下一个非选项参数 while ((c getopt(argc, argv, hpsv)) ! -1) { switch (c) { case h: show_usage(); // 显示帮助并退出 return EXIT_SUCCESS; case p: show_progress true; // 启用进度显示 break; case s: stream_data true; // 启用流式输出模式 break; case v: show_version(); // 显示版本并退出 return EXIT_SUCCESS; default: // 遇到未知选项 show_usage(); // 显示帮助并返回错误码 return EXIT_FAILURE; } } } // 验证解析结果必须处理完所有参数不允许有额外非选项参数 // 例如bugreportz extra_arg 是不合法的 if (optind ! argc) { show_usage(); return EXIT_FAILURE; } // TODO: code below was copy-and-pasted from bugreport.cpp (except by the // timeout value); // should be reused instead. // 注意以下代码从 bugreport.cpp 复制粘贴仅超时时间不同将来应重构为共享函数 // 以避免代码重复和维护问题 // 启动 dumpstate 服务通过 Android 属性系统发送控制命令 if (stream_data) { // 流式模式启动标准 dumpstate 服务输出原始数据 property_set(ctl.start, dumpstate); } else { // 压缩模式启动 dumpstatez 服务输出压缩的 bugreport property_set(ctl.start, dumpstatez); } // 建立 socket 连接dumpstate/z 服务启动需要时间需要重试连接 int s -1; // socket 文件描述符初始化为无效值 // 最多尝试 20 次间隔 1 秒给服务启动留出足够时间 for (int i 0; i 20; i) { // 连接名为 dumpstate 的 Unix domain socket保留命名空间 s socket_local_client(dumpstate, ANDROID_SOCKET_NAMESPACE_RESERVED, SOCK_STREAM); if (s 0) break; // 连接成功退出循环 // 连接失败等待 1 秒后重试 sleep(1); } // 检查连接结果所有重试都失败 if (s -1) { // 输出 FAIL 消息给 adb包含具体错误原因 printf(FAIL:Failed to connect to dumpstatez service: %s\n, strerror(errno)); return EXIT_FAILURE; } // 设置 socket 接收超时防止 bugreportz 无限期挂起 // 超时时间设为 10 分钟所有 dumpstate 内部超时最长 60 秒留有很大余量 struct timeval tv; tv.tv_sec 10 * 60; // 10 分钟 tv.tv_usec 0; // 微秒部分为 0 // 应用 SO_RCVTIMEO 选项到 socket if (setsockopt(s, SOL_SOCKET, SO_RCVTIMEO, tv, sizeof(tv)) -1) { // 设置超时失败输出警告但不终止程序 fprintf(stderr, WARNING: Cannot set socket timeout, bugreportz might hang indefinitely: %s\n, strerror(errno)); // 继续执行依赖其他机制避免挂起 } int ret; // 存储核心处理函数的返回值 // 根据模式选择核心处理函数 if (stream_data) { // 流式模式直接转发原始数据 ret bugreportz_stream(s); } else { // 压缩模式按行处理并过滤特殊行 ret bugreportz(s, show_progress); } // 关闭 socket 连接检查关闭结果 if (close(s) -1) { // 关闭失败输出警告并将返回值设为失败 fprintf(stderr, WARNING: error closing socket: %s\n, strerror(errno)); ret EXIT_FAILURE; } // 返回最终状态码 return ret; }bugreportz.cpp/* * Copyright (C) 2016 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the License); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an AS IS BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ // 主头文件包含 bugreportz 函数声明 #include bugreportz.h // Android 基础库文件操作和字符串处理工具 #include android-base/file.h #include android-base/strings.h // 标准 C 库错误处理、IO、内存管理、字符串操作、Unix 标准函数 #include errno.h #include stdio.h #include stdlib.h #include string.h #include unistd.h // C 标准库字符串容器 #include string // 定义特殊行前缀BEGIN 消息标识 static constexpr char BEGIN_PREFIX[] BEGIN:; // 定义特殊行前缀PROGRESS 进度消息标识 static constexpr char PROGRESS_PREFIX[] PROGRESS:; // 辅助函数将单行内容写入标准输出并根据配置过滤特殊行 // param line: 要输出的行内容 // param show_progress: 是否显示进度相关行BEGIN/PROGRESS static void write_line(const std::string line, bool show_progress) { // 跳过空行避免不必要的输出 if (line.empty()) return; // 当不显示进度时过滤掉 PROGRESS 和 BEGIN 前缀的行 // 这些行会干扰 adb 对 OK/FAIL 结果的解析 if (!show_progress (android::base::StartsWith(line, PROGRESS_PREFIX) || android::base::StartsWith(line, BEGIN_PREFIX))) return; // 将完整行写入标准输出文件描述符 android::base::WriteStringToFd(line, STDOUT_FILENO); } // 主处理函数从 socket 读取 bugreport 数据并按行处理和输出 // param s: 输入 socket 文件描述符 // param show_progress: 是否显示进度信息 // return: 成功返回 EXIT_SUCCESS失败返回 EXIT_FAILURE int bugreportz(int s, bool show_progress) { // 行缓冲区用于累积字符直到遇到换行符 std::string line; // 主循环持续从 socket 读取数据直到 EOF while (1) { // 临时读取缓冲区64KB 大小提供良好性能 char buffer[65536]; // 从 socket 读取数据自动重试被信号中断的读操作 ssize_t bytes_read TEMP_FAILURE_RETRY(read(s, buffer, sizeof(buffer))); // 读取到 EOF正常退出循环 if (bytes_read 0) { break; } else if (bytes_read -1) { // 读取出错处理错误情况 // EAGAIN 错误实际表示超时转换为更明确的 ETIMEDOUT if (errno EAGAIN) { errno ETIMEDOUT; } // 输出 FAIL 消息给 adb包含具体错误描述 printf(FAIL:Bugreport read terminated abnormally (%s)\n, strerror(errno)); return EXIT_FAILURE; } // 逐字符处理将读取的数据拆分为行 for (int i 0; i bytes_read; i) { char c buffer[i]; // 将当前字符追加到行缓冲区 line.append(1, c); // 当遇到换行符时处理完整的一行 if (c \n) { // 写入当前行并根据配置过滤特殊行 write_line(line, show_progress); // 清空行缓冲区准备处理下一行 line.clear(); } } } // 处理最后一行如果文件末尾没有换行符 write_line(line, show_progress); return EXIT_SUCCESS; } // 流式输出函数直接从 socket 读取数据并原样输出到 stdout // 与 bugreportz() 的区别不对数据按行解析直接转发原始数据流 // param s: 输入 socket 文件描述符 // return: 成功返回 EXIT_SUCCESS失败返回 EXIT_FAILURE int bugreportz_stream(int s) { // 主循环持续从 socket 读取数据直到 EOF while (1) { // 临时读取缓冲区64KB 大小 char buffer[65536]; // 从 socket 读取数据自动重试被信号中断的读操作 ssize_t bytes_read TEMP_FAILURE_RETRY(read(s, buffer, sizeof(buffer))); // 读取到 EOF正常退出循环 if (bytes_read 0) { break; } else if (bytes_read -1) { // 读取出错处理错误情况 // EAGAIN 错误实际表示超时转换为更明确的 ETIMEDOUT if (errno EAGAIN) { errno ETIMEDOUT; } printf(FAIL:Bugreport read terminated abnormally (%s)\n, strerror(errno)); return EXIT_FAILURE; } // 将读取的数据块完整写入标准输出 if (!android::base::WriteFully(android::base::borrowed_fd(STDOUT_FILENO), buffer, bytes_read)) { // 写入失败输出错误信息 printf(Failed to write data to stdout: trying to send %zd bytes (%s)\n, bytes_read, strerror(errno)); return EXIT_FAILURE; } } return EXIT_SUCCESS; }Bugreportz 功能总结bugreportz是 Android 系统中用于生成和传输错误报告的核心命令行工具作为adb bugreport命令的底层执行引擎它通过 Socket 与dumpstate服务通信高效收集系统诊断信息。一、核心功能定位功能说明主要用途生成压缩格式.zip的完整 bugreport或流式输出诊断数据调用方式由adb自动调用也可在设备 shell 中手动执行输出目标标准输出stdout数据通过 adb 回传至主机协议兼容输出格式符合 adb 的OK/FAIL响应协议二、双模式工作架构模式 1压缩模式默认bugreportz# 生成压缩 bugreportbugreportz -p# 显示进度信息处理流程启动dumpstatez服务压缩输出按行读取 Socket 数据过滤特殊行默认移除BEGIN:和PROGRESS:前缀行避免干扰 adb 协议将处理后的文本行输出到 stdout适用场景生成标准.zip格式 bugreport供开发者分析模式 2流式模式-sbugreportz -s# 流式原始输出处理流程启动dumpstate服务原始输出直接读取二进制数据块不解析行零处理不过滤任何内容直接转发到 stdout使用WriteFully确保数据完整性适用场景传输大文件、二进制日志或无需过滤的场景三、命令行接口选项全称功能影响的行为-hHelp显示使用帮助程序退出-pProgress显示进度信息不过滤BEGIN:/PROGRESS:行-sStream流式原始输出调用bugreportz_stream()不启动dumpstatez-vVersion显示版本号1.2程序退出无参数-生成压缩 bugreport调用bugreportz(fd, false)过滤进度行四、内部实现机制1. 服务启动与连接// 启动 dumpstate 或 dumpstatez 服务property_set(ctl.start,stream_data?dumpstate:dumpstatez);// 带重试的 Socket 连接最多 20 秒for(inti0;i20;i){ssocket_local_client(dumpstate,ANDROID_SOCKET_NAMESPACE_RESERVED,SOCK_STREAM);if(s0)break;sleep(1);// 服务启动延迟}设计亮点使用 Android 属性系统触发服务启动20 秒重试机制解决服务启动竞态问题抽象命名空间Socket 路径为\0dumpstate不占用文件系统2. 超时保护策略// 设置 10 分钟接收超时tv.tv_sec10*60;setsockopt(s,SOL_SOCKET,SO_RCVTIMEO,tv,sizeof(tv));安全边际设计基准值dumpstate内部单个操作最长 60 秒安全边际10 倍600 秒覆盖操作累积 系统负载 延迟波动风险覆盖99.99% 场景下不会触发超时超时后果read()返回-1errno ETIMEDOUT输出FAIL:...给 adb3. 数据传输逻辑压缩模式按行处理// 行缓冲区累积for(inti0;ibytes_read;i){line.append(1,c);if(c\n){write_line(line,show_progress);// 过滤特殊行line.clear();}}行解析将 Socket 数据流拆分为文本行智能过滤默认隐藏BEGIN:/PROGRESS:行避免 adb 解析器混淆协议兼容确保 adb 只收到OK或FAIL响应流式模式原始转发if(!WriteFully(fd,buffer,bytes_read)){printf(Failed to write data to stdout\n);returnEXIT_FAILURE;}性能优化64KB 大块读写减少系统调用次数数据完整WriteFully确保写入全部数据或明确失败适用性支持二进制数据无格式要求4. 错误处理体系错误类型检测方式处理策略用户反馈连接失败socket_local_client() 0输出FAIL:Failed to connect...报错退出读取超时errno EAGAIN→ETIMEDOUT输出FAIL:Bugreport read terminated abnormally超时退出写入失败WriteFully()返回 false输出Failed to write data to stdout报错退出Socket 关闭失败close() -1输出警告WARNING: error closing socket继续退出设计原则所有错误信息以FAIL:开头便于 adb 统一解析关键错误超时、连接失败导致程序失败非关键错误关闭失败仅输出警告不打断流程五、关键设计亮点1. 代码复用与测试// Android.bp 配置 cc_test { srcs: [ bugreportz.cpp, // 复用主程序源码 bugreportz_test.cpp, // 独立测试用例 ], }测试模块直接复用核心源码确保测试与发布版本行为一致集成 Google Mock 框架支持单元测试和 mock 测试2. 严格的编译检查cflags: [-Werror, -Wall]所有警告视为错误强制代码质量在编译期发现潜在 bug提高可靠性3. 资源所有权管理// 使用 borrowed_fd 明确 fd 所有权WriteFully(borrowed_fd(STDOUT_FILENO),buffer,bytes_read)borrowed_fd表明不获取所有权仅临时使用避免意外关闭标准输出等关键文件描述符六、系统架构关系graph TD A[用户: adb bugreport] -- B[adb client] B -- C[adb server] C -- D[设备: adb daemon] D -- E[执行 bugreportz] E -- F{stream_data?} F --|否| G[启动 dumpstatez 服务] F --|是| H[启动 dumpstate 服务] G -- I[Socket 连接: dumpstate] H -- I I -- J[bugreportz() 或 bugreportz_stream()] J -- K[输出到 stdout] K -- L[adb 回传至主机] L -- M[生成 bugreport.zip]七、性能与可靠性指标指标目标值实现方式超时率 0.1%10 倍安全边际设计连接成功率 99.9%20 秒重试机制数据完整性100%WriteFully 保证内存占用 128KB64KB 缓冲区行累积容器CPU 占用低仅 IO阻塞式 read/write无轮询八、使用场景建议场景推荐模式原因日常开发默认压缩模式生成标准 .zip工具链支持完善CI 自动化默认压缩模式稳定、可解析的输出格式性能分析-p显示进度观察执行进度定位卡顿阶段大文件传输-s流式模式避免行解析开销性能最优二进制日志-s流式模式保留原始数据无文本转换九、版本演进Version 1.2当前支持-s流式模式优化超时策略10分钟兼容 Android 10 的权限模型历史版本早期版本仅支持压缩模式后续逐步加入进度显示、流式传输等企业级特性十、总结bugreportz是一个设计精良的系统工具其核心优势在于协议兼容性深度适配 adb 的 OK/FAIL 响应机制健壮性多层超时保护 自动重试 全面错误处理灵活性双模式设计满足不同场景需求可维护性代码复用、严格编译检查、清晰的所有权语义可观测性详细日志输出便于问题诊断它是 Android 系统稳定性基础设施的关键组件每天为数以亿计的设备提供可靠的诊断数据收集能力。