无法导入android.os.SystemProperties的问题排查求助

核心背景 #

android.os.SystemProperties是Android系统的隐藏API，默认情况下SDK不对外暴露直接引用权限，所以你的IDE会报错且不显示自动补全，而同事能正常使用大概率是项目或IDE配置了访问权限。

排查步骤与解决办法 #

1. 检查项目Gradle配置（最可能原因） #

在模块级build.gradle（或build.gradle.kts）中添加/修改以下配置，开启隐藏API访问：

android {
    // 确保compileSdk、targetSdk和同事完全一致
    compileSdkVersion 33 // 替换为项目实际使用的版本
    targetSdkVersion 33

    defaultConfig {
        // 其他原有配置...
        // 添加此行，允许访问隐藏API
        manifestPlaceholders += [allowHiddenApi: "true"]
    }

    lintOptions {
        // 禁用隐藏API相关的lint检查
        checkReleaseBuilds false
        abortOnError false
        disable 'HiddenApi'
    }
}

同时在项目根目录的gradle.properties中添加：

# 允许IDE识别并使用隐藏API
android.injected.testOnly=false

2. 验证SDK安装完整性 #

打开File > Settings > Android SDK：

• 确认你安装的SDK Platform版本、Build Number和同事完全一致
• 勾选对应SDK版本的Sources for Android SDK，点击Apply重新安装源码
• 安装完成后重启Android Studio

3. 清理IDE与项目缓存 #

• 点击File > Invalidate Caches...，勾选Invalidate and Restart，等待IDE重启并重建缓存
• 手动删除项目根目录的.gradle、.idea文件夹，以及模块下的build文件夹，再点击Sync按钮重新同步项目

4. 确认SDK路径一致性 #

打开File > Project Structure > SDK Location，检查你的Android SDK路径是否和同事相同。如果路径不同，切换到相同路径后重新同步项目。

内容的提问来源于stack exchange，提问作者Muthyam Sriram