萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android 4.1 (Jelly Bean) AOSP 編譯找不到資源文件 (R.java) 解決方案:public.xml 公開資源聲明機制變更

問題現象

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) 引用。未聲明的資源視為內部私有,編譯期不可見。

解決步驟

  1. 在 frameworks/base/core/res/res/values/public.xml 中添加對應 <java-symbol> 條目。
  2. 重新編譯 framework-res (生成更新後的 R.java)。
  3. 再編譯依賴模組 (如 SystemUI、Settings)。

public.xml 添加範例

<!-- 佈局文件 -->
<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" />

驗證方法

  1. 編譯後檢查 out/target/common/R/com/android/internal/R.java 是否包含新增的 ID 常量。
  2. 確認引用模組的 Java 代碼已 import com.android.internal.R;。

其他常見找不到資源原因 (排查清單)

  • 資源 ID 拼寫錯誤 (大小寫敏感)。
  • 未先編譯 framework-res 就編譯依賴模組 (順序錯誤)。
  • 引用模組未 import 正確的 R 類 (誤 import 自身包名 R)。
  • 資源文件名不合法 (必須小寫字母、數字、下劃線,不能以數字開頭)。

現代 Android (Android.bp / Soong) 備註

Android 8.0+ 遷移至 Soong 建置系統 (Android.bp),資源導出控制改由 resource_dirs、sdk_version、platform_apis 等屬性管理,public.xml 機制仍存在但配置方式不同。本文針對傳統 Make (Android.mk) 體系 (Android 4.1~7.x)。

copyright © 萬盛學電腦網 all rights reserved