Android 4.1 (API 16) 起,在 frameworks/base/core/res/res/ 新增資源文件 (layout/drawable/string/id 等) 後,編譯依賴模組 (如 SystemUI) 時報錯:「找不到資源 ID」,即使已重新編譯 framework-res。
Android 4.1 引入 public.xml 白名單機制。只有在 frameworks/base/core/res/res/values/public.xml 中聲明的資源,才會被導出為 com.android.internal.R 供外部模組 (Framework/App) 引用。未聲明的資源視為內部私有,編譯期不可見。
frameworks/base/core/res/res/values/public.xml 中添加對應 <java-symbol> 條目。framework-res (生成更新後的 R.java)。<!-- 佈局文件 -->
<java-symbol type="layout" name="usb_storage_connection_connected" />
<!-- 字符串 -->
<java-symbol type="string" name="usb_storage_connection_message" />
<!-- 圖片 (drawable) -->
<java-symbol type="drawable" name="usb_storage_connected" />
<!-- ID (佈局中 android:id="@+id/my_view") -->
<java-symbol type="id" name="mytextView" />
<!-- 顏色 -->
<java-symbol type="color" name="my_custom_color" />
<!-- 尺寸 -->
<java-symbol type="dimen" name="my_spacing" />
<!-- 樣式 -->
<java-symbol type="style" name="MyCustomTheme" />
out/target/common/R/com/android/internal/R.java 是否包含新增的 ID 常量。import com.android.internal.R;。framework-res 就編譯依賴模組 (順序錯誤)。Android 8.0+ 遷移至 Soong 建置系統 (Android.bp),資源導出控制改由 resource_dirs、sdk_version、platform_apis 等屬性管理,public.xml 機制仍存在但配置方式不同。本文針對傳統 Make (Android.mk) 體系 (Android 4.1~7.x)。