Android Wear独立应用签名打包时出现循环依赖及资源链接错误

问题描述 #

在Android Studio Dolphin | 2021.3.1中构建独立Wear应用签名App Bundle时，遭遇循环依赖错误。曾尝试通过禁用Instant Run解决，但该选项已被移除。

移除gradle文件中的wearApp project(":wear")行后，循环依赖错误消失，但所有视图均出现AGPBI: {"kind":"error","text":"Android resource linking failed"}错误。

循环依赖任务链如下：

:wear:compileReleaseArtProfile
--- :wear:mergeDexRelease
--- :wear:dexBuilderRelease
+--- :wear:compileReleaseJavaWithJavac
|    +--- :wear:dataBindingGenBaseClassesRelease
|    |    +--- :wear:mergeReleaseResources
|    |    |    +--- :wear:generateReleaseResources
|    |    |    |    --- :wear:handleReleaseMicroApk
|    |    |    |         --- :wear:packageRelease
|    |    |    |              +--- :wear:compileReleaseArtProfile (*)
|    |    |    |              +--- :wear:compileReleaseJavaWithJavac (*)
|    |    |    |              +--- :wear:mergeDexRelease (*)
|    |    |    |              +--- :wear:optimizeReleaseResources
|    |    |    |              |    --- :wear:processReleaseResources
|    |    |    |              |         +--- :wear:mergeReleaseResources (*)
|    |    |    |              |         +--- :wear:parseReleaseLocalResources
|    |    |    |              |         |    --- :wear:packageReleaseResources
|    |    |    |              |         |         +--- :wear:generateReleaseResources (*)
|    |    |    |              |         |         --- :wear:handleReleaseMicroApk (*)
|    |    |    |              |         +--- :wear:processReleaseManifest
|    |    |    |              |         |    --- :wear:processReleaseMainManifest
|    |    |    |              |         |         --- :wear:handleReleaseMicroApk (*)
|    |    |    |              |         --- :wear:processReleaseManifestForPackage
|    |    |    |              |              --- :wear:processReleaseManifest (*)
|    |    |    |              +--- :wear:processReleaseManifestForPackage (*)
|    |    |    |              --- :wear:processReleaseResources (*)
|    |    |    --- :wear:handleReleaseMicroApk (*)
|    |    --- :wear:parseReleaseLocalResources (*)
|    --- :wear:processReleaseResources (*)
--- :wear:processReleaseResources (*)

相关gradle配置：

plugins {
    id 'com.android.application'
}

android {

    namespace 'com.kingandy.pickleballwatch'
    compileSdk 32

    defaultConfig {
        applicationId "com.kingandy.pickleballwatch"
        minSdk 28
        targetSdk 32
        versionCode 1
        versionName "1.0"

    }

    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
    buildFeatures {
        viewBinding true
    }
}

dependencies {
    implementation 'com.google.android.gms:play-services-wearable:18.0.0'
    implementation 'androidx.percentlayout:percentlayout:1.0.0'
    implementation 'androidx.legacy:legacy-support-v4:1.0.0'
    implementation 'androidx.recyclerview:recyclerview:1.2.1'
    implementation 'androidx.wear:wear:1.2.0'
    wearApp project(":wear")
}

相关Manifest配置：

<uses-permission android:name="android.permission.WAKE_LOCK" />

<uses-feature android:name="android.hardware.type.watch" />

<application
    android:allowBackup="true"
    android:icon="@mipmap/ic_launcher"
    android:label="@string/app_name"
    android:supportsRtl="true"
    android:theme="@android:style/Theme.DeviceDefault">
    <uses-library
        android:name="com.google.android.wearable"
        android:required="true" />

    <!--
           Set to true if your app is Standalone, that is, it does not require the handheld
           app to run.
    -->
    <meta-data
        android:name="com.google.android.wearable.standalone"
        android:value="true" />

    <activity
        android:name=".MainActivity"
        android:exported="true"
        android:label="@string/app_name">
        <intent-filter>
            <action android:name="android.intent.action.MAIN" />

            <category android:name="android.intent.category.LAUNCHER" />
        </intent-filter>
    </activity>
</application>

解决方案 #

1. 彻底移除wearApp依赖项 #

循环依赖的核心原因是独立Wear应用不需要引用自身模块。wearApp project(":wear")是用于手机应用打包时嵌入对应Wear应用的配置，而你的项目本身就是Wear独立应用，添加这个依赖会导致模块自引用，触发循环依赖。直接删除该行即可解决循环依赖问题。

2. 修复资源链接错误 #

移除wearApp后出现的资源链接失败，可按以下步骤排查：

• 检查资源完整性：确认所有布局文件、drawable、string等资源存在，文件名无拼写错误（Android资源区分大小写）。
• 验证ViewBinding配置：确保所有布局文件没有语法错误，比如标签未闭合、属性引用错误等。若使用ViewBinding，检查是否有布局文件未被正确生成绑定类。
• 清理重建项目：执行./gradlew clean assembleRelease命令，清理旧构建缓存后重新构建，避免缓存导致的资源冲突。
• 查看详细资源错误日志：运行./gradlew assembleRelease --info，在输出日志中找到具体的资源链接失败原因（比如某个资源找不到、属性冲突等），针对性修复。

3. 确认独立Wear应用配置正确性 #

你的Manifest中已正确设置com.google.android.wearable.standalone为true，且声明了android.hardware.type.watch特性，这部分无需修改。确保没有其他与独立应用冲突的配置（比如引用了手机端专属的库或权限）。

4. 排查其他潜在依赖问题 #

若仍有异常，检查项目中是否存在其他隐式循环依赖：

• 确认没有其他模块引用当前wear模块，同时当前模块也未引用其他模块形成闭环。
• 检查gradle配置中是否有其他自定义任务或插件导致依赖链异常。

5. 利用gradle命令定位深层问题 #

• 运行./gradlew assembleRelease --stacktrace获取完整的错误栈追踪，定位循环依赖或资源错误的具体触发点。
• 运行./gradlew assembleRelease --scan生成构建分析报告，直观查看依赖关系和任务执行流程，快速定位问题。

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