系统sdcard预置文件规则与错误检查

本文档主要讨论的是在Android系统构建过程中，如何将特定文件预置到系统的SD卡目录（/sdcard）的问题。在这个上下文中，"PRODUCT_COPY_FILES"变量在makefile中起着关键作用，它定义了一个机制来管理产品级别的预编译文件复制。以下是关于这个过程的重要知识点： 1. **预置文件规则**: - `PRODUCT_COPY_FILES`是一个用于配置系统预置文件列表的变量，它允许开发者指定哪些文件应在系统安装时被复制到目标设备上，包括但不限于.apk应用、配置文件、元数据等。 2. **检查文件类型**: - 验证目标文件（`$(2)`）是否符合预期格式，例如检查是否是APK文件。如果发现预编译的APK，提示用户应该使用`BUILD_PREBUILT`替代。 3. **VINTF元数据处理**: - VINTF（Vendor Interface for New Technology）是Android系统中的一种机制，涉及设备兼容性信息。文档指出，只有当VINTF相关文件如/etc/vintf/目录下的meta数据出现在`PRODUCT_COPY_FILES`中时，才会抛出错误，建议使用`vintf_fragments`或`DEVICE_PRODUCT_COMPATIBILITY_MATRIX_FILE`等正确路径。 4. **文件路径限制**: - 避免将VINTF元数据放置在`TARGET_COPY_OUT_SYSTEM`、`TARGET_COPY_OUT_PRODUCT`或`TARGET_COPY_OUT_SYSTEM_EXT`中的/etc/vintf/目录下，因为这些路径已经预留给了特定的VINTF处理方式。 5. **构建流程控制**: - `BUILD_BROKEN_VINTF_PRODUCT_COPY_FILES`变量的存在会影响文件复制决策，如果这个标志为真，那么只有特定的VINTF文件（如manifest.xml和compatibility_matrix.xml）会被允许。 6. **错误处理和指导**: - 文档中强调了错误信息的提示方式，以帮助开发者明确理解何时出现错误以及如何改正，例如对于预编译APK的使用提示和VINTF元数据的正确放置路径。 总结来说，这份文档提供了Android系统构建过程中关于预置文件到SD卡目录的详细规则和注意事项，确保了系统的稳定性和兼容性。开发人员在使用`PRODUCT_COPY_FILES`时，需要遵循这些规范以避免潜在问题。