android - 我应该将 .idea/caches/build_file_checksums.ser 添加到 .gitignore 吗？

Question

我更新了我的 Android Studio from 3.0.1 to 3.1，并注意到我现有项目中有一个不熟悉的文件:

.idea/caches/build_file_checksums.ser

这不取决于你是否将 Android Gradle 插件更新为 the latest 3.1.0 ；一旦我在 Android Studio 3.1 中打开一个现有项目，它会自动创建文件 build_file_checksums.ser，即使我保持项目使用之前的 3.0.1 插件如下。

dependencies {
    classpath 'com.android.tools.build:gradle:3.0.1'
}

我也在Android Studio 3.1新建了一个项目，发现build_file_checksums.ser文件是从头创建的。

在撰写本文时，似乎没有关于此的官方文件。如果有人能找到，我将不胜感激。

---

编辑:

我用 inspected jdeserialize-1.2 内容，因为 Samuel 指出它似乎包含一些系统路径。

$ java -jar ~/Downloads/jdeserialize-1.2.jar .idea/caches/build_file_checksums.ser 
read: com.android.tools.idea.gradle.project.ProjectBuildFileChecksums _h0x7e0002 = r_0x7e0000;  
//// BEGIN stream content output
com.android.tools.idea.gradle.project.ProjectBuildFileChecksums _h0x7e0002 = r_0x7e0000;  
//// END stream content output

//// BEGIN class declarations (excluding array classes)
class java.util.HashMap implements java.io.Serializable {
    float loadFactor;
    int threshold;
}

class com.android.tools.idea.gradle.project.ProjectBuildFileChecksums implements java.io.Serializable {
    long myLastGradleSyncTimestamp;
    java.util.Map myFileChecksums;
}

//// END class declarations

//// BEGIN instance dump
[instance 0x7e0004: 0x7e0003/java.util.HashMap
  object annotations:
    java.util.HashMap
        [blockdata 0x00: 8 bytes]
        [String 0x7e0005: "settings.gradle"]
        [array 0x7e0007 classdesc [cd 0x7e0006: name [B uid -5984413125824719648]: [arraycoll sz 16 -89, -2, 26, -61, -111, 105, -75, -27, 40, 90, 94, 83, 102, 47, 37, 27]
        [String 0x7e0008: "build.gradle"]
        [array 0x7e0009 classdesc [cd 0x7e0006: name [B uid -5984413125824719648]: [arraycoll sz 16 70, 101, -14, 32, 100, -60, -85, -103, 73, -86, 15, 54, -45, 125, 50, 39]
        [String 0x7e000a: "local.properties"]
        [array 0x7e000b classdesc [cd 0x7e0006: name [B uid -5984413125824719648]: [arraycoll sz 16 -107, 64, 60, -33, -18, 18, 56, -84, 15, 0, -86, -73, -27, 127, -94, 27]
        [String 0x7e000c: "/Users/qtmfld/.gradle/gradle.properties"]
        [array 0x7e000d classdesc [cd 0x7e0006: name [B uid -5984413125824719648]: [arraycoll sz 16 -44, 29, -116, -39, -113, 0, -78, 4, -23, -128, 9, -104, -20, -8, 66, 126]
        [String 0x7e000e: "gradle.properties"]
        [array 0x7e000f classdesc [cd 0x7e0006: name [B uid -5984413125824719648]: [arraycoll sz 16 16, -69, 118, 80, -49, -19, 41, -8, 56, -86, 64, -63, 112, -14, 98, 47]
        [String 0x7e0010: "app/build.gradle"]
        [array 0x7e0011 classdesc [cd 0x7e0006: name [B uid -5984413125824719648]: [arraycoll sz 16 -3, -11, 63, -26, 67, -41, -100, 33, 85, -59, -49, -3, -90, 53, -106, 94]

  field data:
    0x7e0003/java.util.HashMap:
        threshold: 12
        loadFactor: 0.75
]
[instance 0x7e0002: 0x7e0000/com.android.tools.idea.gradle.project.ProjectBuildFileChecksums
  field data:
    0x7e0000/com.android.tools.idea.gradle.project.ProjectBuildFileChecksums:
        myFileChecksums: r0x7e0004: java.util.HashMap _h0x7e0004 = r_0x7e0003;  
        myLastGradleSyncTimestamp: 1522297024540
]
//// END instance dump

$ 

您可以在java.util.HashMap中看到以下字符串。

• “settings.gradle”
• “build.gradle”
• “local.properties”
• “/Users/qtmfld/.gradle/gradle.properties”
• “gradle.properties”
• “app/build.gradle”

Wh0 已在 Android Studio 3.2 Preview 上澄清了相同的结果。
https://wh0.github.io/2018/02/17/build-file-checksums-ser.html

Answer 1

您应该将它添加到 .gitignore。不要将它包含在您的 git add 中。

在左侧的项目窗口中，

(a) 将 Android View 更改为 the Android project view , 带有下拉菜单。
(b) 您可以在文件夹 .idea/caches 中看到 build_file_checksums.ser。
(c) 打开项目根目录的.gitignore。 (不要与 app 模块的 .gitignore 混淆。)

在右侧的.gitignore内容中，

(d) 添加/.idea/caches/build_file_checksums.ser。

---

JetBrain's guide告诉你应该分享

• All the files under .idea directory in the project root except the workspace.xml and tasks.xml files which store user specific settings

它还说

You may consider not to share the following:

• .iml files for the Gradle or Maven based projects, since these files will be generated on import
• gradle.xml file, see this discussion
• user dictionaries folder (to avoid conflicts if other developer has the same name)
• XML files under .idea/libraries in case they are generated from Gradle or Maven project

因此，Android Studio 中新建项目的默认 .gitignore 为:

*.iml
.gradle
/local.properties
/.idea/libraries
/.idea/modules.xml
/.idea/workspace.xml
.DS_Store
/build
/captures
.externalNativeBuild

但是，build_file_checksums.ser 文件是一个 Java 序列化对象，其中包含以下内容的哈希和时间戳:

• “settings.gradle”
• “build.gradle”
• “local.properties”
• "/Users/(用户名)/.gradle/gradle.properties"
• “gradle.properties”
• “app/build.gradle”

所以，看起来像 the issue是优先级 P2 和严重性 S2，并且已经被接受和修复。我期待 future 的版本，其中默认的 .gitignore 包括

/.idea/caches/build_file_checksums.ser