【问题标题】:Migrating a Cordova Android project to AndroidX将 Cordova Android 项目迁移到 AndroidX
【发布时间】:2019-12-20 17:23:56
【问题描述】:

我目前正在使用 AdMob 测试广告测试混合 Cordova/Android 应用。该应用程序使用一个自定义(即内部)插件,我可以通过该插件访问 Google Play Services AdMob API。 plugin.xml文件的相关位如下

<platform name="android">
 <preference name="PLAY_SERVICES_VERSION" default="17.2.0"/>
 <preference name="ADMOB_APP_ID" default="ca-app-pub-...."/>

 <framework src="com.android.support:appcompat-v7:27.1.0" />
 <framework src="com.google.android.gms:play-services-ads:17.2.0"/>

应用程序的config.xml 文件声明以下内容

 <preference name="android-minSdkVersion" value="23" />
 <preference name="android-targetSdkVersion" value="28" />

在here 讨论之后加载和显示激励视频广告的 Java 代码。

虽然这行得通,但在这里困扰我的是我使用的是相当古老的play-services-ads API。问题是,如果我尝试按照shown here 的说明升级到最新的 API。我修改后的 plugin.xml 文件反映了使用最新 API 所需的更改

<platform name="android">
  <preference name="PLAY_SERVICES_VERSION" default="18.3.0"/>
  <preference name="ADMOB_APP_ID" default="ca-app-pub-..."/>

  <framework src="com.android.support:appcompat-v7:28.0.0" />
  <framework src="com.google.android.gms:play-services-ads:18.3.0"/>

问题是我不再能够编译应用程序。 Cordova CLI 报告了我在下面显示的一系列问题

退出代码 1 错误输出: 注意: path\to\app\platforms\android\CordovaLib\src\org\apache\cordova\engine\SystemCookieManager.java 使用或覆盖已弃用的 API。 注意:使用 -Xlint:deprecation 重新编译以获取详细信息。 path\to\app\platforms\android\app\src\main\AndroidManifest.xml:22:18-86 错误: 属性 application@appComponentFactory value=(androidx.core.app.CoreComponentFactory) 来自 [androidx.core:core:1.0.0] AndroidManifest.xml:22:18-86 也存在于 [com.android.support:support-compat:28.0.0] AndroidManifest.xml:22:18-91 value=(android.support.v4.app.CoreComponentFactory)。 建议:将 'tools:replace="android:appComponentFactory"' 添加到 AndroidManifest.xml:4:5-21:19 的元素以覆盖。

FAILURE:构建失败并出现异常。

  • 出了什么问题: 任务 ':app:processDebugManifest' 执行失败。

    清单合并失败:来自 [androidx.core:core:1.0.0] AndroidManifest.xml:22:18-86 的属性 application@appComponentFactory value=(androidx.core.app.CoreComponentFactory) 也存在于 [com.android.support:support-compat:28.0.0] AndroidManifest.xml:22:18-91 value=(android.support.v4.app.CoreComponentFactory)。 建议:将 'tools:replace="android:appComponentFactory"' 添加到 AndroidManifest.xml:4:5-21:19 的元素以覆盖。

我将问题缩小到gms:play-services-ads,它似乎引入了与旧式android 库不兼容的androidx 库。上面 Gradle 的有用建议 - ** add tools:replace="android:appComponentFactory ** 没有帮助,因为无法识别 application 节点的 tools:replace 属性。

我实施的有效解决方案如下

  • 我在path/to/myapp/platforms/android 下创建了一个build-extras.gradle 文件,其中包含以下行

    android.useAndroidX=true android.enableJetifier=true

  • 作为权宜之计,我使用了this plugin,它处理了 androidx 和 android 库之间的不兼容问题。虽然这可行,但我不太热衷于使用其他插件。我怀疑这个插件所做的只是确保 AndroidManifest.xml 是正确的,但我不知道如何。我将非常感谢任何能够解释在没有额外插件的情况下需要做什么才能让事情正常工作的人。

【问题讨论】:

    标签: android cordova google-play-services androidx cordova-cli


    【解决方案1】:

    请阅读: https://cordova.apache.org/announcements/2020/06/29/cordova-android-9.0.0.html

    确定:

    • 清除您的 gradle 缓存目录(在 home/.gradle/caches 中)
    • 删除和添加android平台
    • 按照上述文章检查您的要求

    然后:

    在您的 config.xml 中添加以下内容:

    <preference name="AndroidXEnabled" value="true" />
    <preference name="GradlePluginKotlinEnabled" value="true" />
    <preference name="GradlePluginKotlinCodeStyle" value="official" />
    <preference name="GradlePluginKotlinVersion" value="1.3.50" />
    

    (AndroidXEnabled偏好在gradle.properties中添加jetifyer和androidX)

    您的构建现在应该可以工作了

    【讨论】:

    【解决方案2】:

    为了任何遇到此线程的人的利益 - 如果您有一个带有多个第三方插件的 Cordova 应用程序,您最好使用我上面提到的 dpa99 androidx adapter。如果像我一样,您只依赖自己的插件来使用 AndroidX 来代替旧式 Android 支持库是很容易的。

    第 1 步

    在path/to/project/platforms/android 中创建一个名为build-extras.gradle 的文件并对其进行编辑以包含以下内容

    android.useAndroidX=true
    android.enableJetifier=false
    

    第一行是不言自明的。要了解enableJetifier,请先考虑此声明

    独立的 Jetifier 工具将依赖于支持库的库迁移为依赖等效的 AndroidX 包。

    在Google documentation。鉴于您正在考虑自己旋转,因为您不使用其他外部 Cordova 插件,因此您不需要启用 Jetifier。

    第 2 步

    完成后,剩下要做的就是替换

    <framework src="com.android.support:appcompat-v7:28.0.0" />
    

    在您自己的plugin.xml 文件中使用

    <framework src="androidx.appcompat:appcompat:1.0.0" />
    

    第 3 步

    最后继续替换任何旧的原生 Android 库 - 例如播放服务广告 - 您当前正在使用的最新版本现在使用 AndroidX。现在运行cordova build android,你就完成了转换!

    【讨论】:

    • 不出所料,androidx-adapter插件相当没用。将您指出的 androidx 框架添加到 plugin.xml 解决了构建问题,谢谢先生。
    【解决方案3】:

    该插件所做的是搜索 node_modules 中的所有插件并修补所有插件代码用法和依赖项以使用 Android X 等效项。

    因此,您可以更新所有使用旧的 android 支持库而不是 android X 的插件,或使用与插件相同的工具(如 jetifier),或继续使用该插件。

    【讨论】:

      【解决方案4】:

      这是一个简单的方法

      “防止因包含不同版本的 Play Services 库组件而导致构建失败。” https://github.com/dpa99c/cordova-android-play-services-gradle-release

      “此 Cordova/Phonegap 插件在 Cordova 项目中启用 AndroidX” https://github.com/dpa99c/cordova-plugin-androidx

      “如果您的 Cordova 项目包含同时引用 Android 支持库和 AndroidX 的插件/库,您的 Android 构建将失败,因为这两者不能在 Android 构建中并存。” https://github.com/dpa99c/cordova-plugin-androidx-adapter

      Ps:我不是维护者

      【讨论】:

        猜你喜欢
        • 1970-01-01
        • 2019-06-21
        • 1970-01-01
        • 1970-01-01
        • 1970-01-01
        • 1970-01-01
        • 1970-01-01
        • 1970-01-01
        • 2020-01-27
        相关资源
        最近更新 更多