本文详解如何解决因 material design 库 1.10.0-alpha01 强制依赖 android 下一代预览版 sdk（upsidedowncake）导致的构建失败问题，提供编译配置调整与版本降级两种可靠方案。
本文详解如何解决因 material design 库 1.10.0-alpha01 强制依赖 android 下一代预览版 sdk（upsidedowncake）导致的构建失败问题，提供编译配置调整与版本降级两种可靠方案。
当在 Android Studio 中构建项目时遇到如下错误：
Dependency 'com.google.android.material:material:1.10.0-alpha01' requires libraries and applications that depend on it to compile against codename "UpsideDownCake" of the Android APIs. :app is currently compiled against android-33.
其根本原因在于：com.google.android.material:material:1.10.0-alpha01 是面向 Android 下一代预览版 SDK（代号 UpsideDownCake，即 Android 14 预览版）发布的 Alpha 版本，强制要求项目使用 compileSdkPreview "UpsideDownCake"，而当前项目仍基于稳定版 compileSdk 33（Android 13），导致元数据校验失败。
✅ 解决方案一：启用 UpsideDownCake 预览 SDK（仅限实验性开发）
若你确需体验 Material 1.10 的新特性（如新版 NavigationBar、改进的 MotionLayout 支持等），且已安装 Android 14 预览版 SDK，请按以下步骤配置：
- 在 Android Studio 中打开 SDK Manager → SDK Platforms，勾选并安装 Android SDK Platform-UpsideDownCake (Preview)；
- 修改模块级 build.gradle（或 build.gradle.kts）中的 android 块：
android {
compileSdkPreview = "UpsideDownCake" // ⚠️ 注意：Gradle 8.0+ 推荐写法
// 或旧版写法（Gradle < 8.0）：
// compileSdkVersion "android-UpsideDownCake"
defaultConfig {
targetSdk 34 // UpsideDownCake 对应 API 34，需同步更新
// ...
}
}? 提示：compileSdkPreview 是 Gradle 8.0+ 的标准属性；若使用较旧 Gradle 版本，请改用 compileSdkVersion "android-UpsideDownCake"，并确保 targetSdk 设为 34。
✅ 解决方案二：降级至稳定版 Material 库（推荐生产环境）
绝大多数项目无需提前接入预览版 SDK。强烈建议切换至最新稳定版 Material 组件，兼顾兼容性与功能完整性：
dependencies {
implementation("com.google.android.material:material:1.10.0") // ✅ 2023年10月起已发布稳定版
// 或更保守的选择（如需最大兼容性）：
// implementation("com.google.android.material:material:1.9.0")
}? 补充说明：Material 1.10.0（稳定版）已于 2023 年 10 月正式发布，全面支持 compileSdk 33 和 targetSdk 33/34，无需预览 SDK，且修复了 alpha 版本中大量已知问题。
⚠️ 注意事项与最佳实践
- 避免混用预览版依赖：除非明确参与 Android 14 Beta 测试，否则不应在生产项目中引入任何 *-alpha* 或 *-beta* 的 Google 官方库；
- 同步更新 build tools：启用 UpsideDownCake 后，建议升级至 Android Gradle Plugin 8.1+ 与 Gradle 8.0+，以获得完整支持；
- 检查其他依赖兼容性：部分第三方库可能尚未适配 API 34，启用预览 SDK 前请验证全链路兼容性；
- 及时回退策略：若启用预览 SDK 后出现不可预知问题，可快速切回 compileSdk 33 + material:1.10.0 组合，零成本恢复稳定构建。
通过以上任一方式，即可彻底解决 AAR 元数据校验失败问题。对于绝大多数开发者，选择稳定版 Material 库是更安全、高效、可持续的工程实践。
