如何手动正确使用AAR文件构建Android应用？

1. 解决ClassNotFoundException: androidx.constraintlayout.widget.ConstraintLayout #

核心问题是ConstraintLayout的类未被正确打包进APK的dex文件，仅编译阶段引入不够：

• 解压下载的ConstraintLayout AAR，取出classes.jar
• 编译Java代码时，将该jar加入javac的classpath：

  javac -cp "$ANDROID_HOME/platforms/android-33/android.jar:./constraintlayout-classes.jar:./your-source-dir" -d ./classes ./your-source-dir/**/*.java
  

• 用d8编译生成dex时，必须把constraintlayout-classes.jar和你的编译产物一起作为输入：

  d8 --classpath $ANDROID_HOME/platforms/android-33/android.jar ./classes ./constraintlayout-classes.jar --output ./dex
  

2. 处理lifecycle、androidx.collection等依赖缺失警告 #

ConstraintLayout 2.2.0依赖这些AndroidX库，必须补充对应依赖包：

• 从Maven仓库下载对应版本的依赖AAR/JAR（比如androidx.lifecycle:lifecycle-common:2.0.0、androidx.collection:collection:1.0.0）
• 解压后将它们的classes.jar同样加入javac和d8的classpath，确保编译和打包阶段都能找到这些依赖类。

3. 解决NoClassDefFoundError: androidx.constraintlayout.widget.R$styleable #

你用aapt2 link添加--extra-packages的做法是正确的，因为AAR包含资源文件，需要让aapt2为其生成对应包名的R类：

• 先编译ConstraintLayout的资源：

  aapt2 compile --dir ./constraintlayout-res -o ./constraintlayout-res.zip
  

• 链接阶段合并资源并生成R类：

  aapt2 link -o ./merged-res.apk --manifest ./AndroidManifest.xml \
    --java ./gen \
    --extra-packages androidx.constraintlayout.widget \
    -I $ANDROID_HOME/platforms/android-33/android.jar \
    ./your-res.zip ./constraintlayout-res.zip
  

• 编译自己的Java代码时，要把gen目录（生成的R类所在）加入classpath。

4. d8 desugaring相关问题 #

关闭desugaring出现NoSuchMethodError是因为ConstraintLayout使用了Java 8+的API，低版本Android系统不支持，必须开启desugaring：

• 开启desugaring的d8命令示例：

  d8 --classpath $ANDROID_HOME/platforms/android-33/android.jar \
    --desugar \
    --desugar-classpath $ANDROID_HOME/build-tools/33.0.2/lib/desugar_jdk_libs.jar \
    ./classes ./constraintlayout-classes.jar ./lifecycle-classes.jar ./collection-classes.jar \
    --output ./dex
  

• 开启后出现的警告大多是关于未使用的desugar规则，只要功能正常可以忽略；如果需要消除警告，可以创建desugar配置文件指定需要的规则。

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