Java_Resources_on_Android.md

Android上的Java资源

概览

Android上的Chrome使用了Java代码中的一些资源（例如，Android layout和相关的字符串或图像）。这些资源依照Android的资源目录结构存储于Java根目录内，

• content/public/android/java/res - Java resources available within content and anything that depends on content
• chrome/android/java/res - Java resources available within chrome and anything that depends on chrome
• ui/android/java/res - Java resources available within ui and anything that depends on ui

Java代码可以使用自动生成的R类正常地引用这些资源，但请确认使用正确的包名修饰R类。

// Use a resource from content
setImageResource(org.chromium.content.R.drawable.globe_favicon);

// Use a resource from chrome
setContentView(org.chromium.chrome.R.layout.month_picker);

资源如何打包

在编译Java代码时，会基于Java上下文资源生成一个R.java文件。这个R.java包含了一些非常量的变量，只在编译（以及任何基于content的非APK目的）的时候使用，R.java不会被包含在content jar包中。

在构建一个APK的时候，比如content_shell_apk，资源会从content、任何其他依赖、content shell本身中合并进来。这些合并的资源会得到处理并包含在APK中。基于这些资源，会生成一个有着正确的资源->ID映射的新的R.java文件。这个R.java会被复制到每个依赖R的包中 (例如. org.chromium.content.R和org.chromium.content_shell.R), 所有这些副本会被包含在APK中。

这个过程遵循Android对于library工程的资源的处理方式，在这些工程中，content和chrome都是library，尽管我们不会用Android的SDK去编译我们的library。因此同样有些警告是有效的。尤其是，两个有着相同ID的资源不可以共存。在最高依赖链（比如，在content shell）上的资源会覆盖其他的资源（比如，在content中）。

支持gyp资源

为了增加资源到另一个Java根目录，需要添加has_java_resources, R_package, 和 R_package_relpath变量到gyp target，以构建java代码。例如：

{
  'target_name': 'content_java',
  'type': 'none',
  'dependencies': [ ... ],
  'variables': {
    'package_name': 'content',
    'java_in_dir': '../content/public/android/java',

    # Support Java resources in content
    'has_java_resources': 1,
    'R_package': 'org.chromium.content',
    'R_package_relpath': 'org/chromium/content',
  },
  'includes': [ '../build/java.gypi' ],
},