Android開發升級AGP7.0後的一些適配方法技巧

2022-06-22 22:00:43

升級

年初了，我們打算升級下apg，這樣之後就擁抱下jetpack compose了！！

想用comopse有兩個必選項agp7.0和kotlin版本1.5.31.

Java11設定

因為apg7.0需要把所有的module編譯環境切換到java11版本上，然而這個地方很容易出錯。

首先是命令列的設定，對於mac使用者來說，可能會寫死預設的java環境到1.8. 這個時候我們需要做的就是刪除bashprofile內的java設定。

同時最好用命令列java --version嘗試下輸出的版本是不是java11。

as的設定則相對來說比較簡單了。

按照這兩個設定完成之後重新同步下工程應該就行了。

AndroidComponentsExtension

之前在現在準備好告別Transform了嗎？的文章就簡單展開了下AndroidComponentsExtension，新版本更換了extensions。這次給專案升級適配之前寫的哪些外掛，想了想用新不用久嗎，嘗試下新東西了。

onVariants

以前在寫android外掛的時候很多時候都需要在gralde的afterEvaluate方法執行之後才能獲取到很多安卓對應的屬性。

這次在v2的api中，則提供了非常多不同的節點，讓我們在不同的階段做一些不同的事情。

比如說onVariants,beforeVariants,finalizeDsl這三個不同的階段，正常情況下我們選擇onVariants就足夠了。

Component Artifacts

demo 地址

Gralde 內的一部分核心是Task，但是要想寫好一個Task其實並沒有想象中的那麼容易。特別是一個CacheableTask,他更多的關注與他們的輸入和輸出。

構建快取(build cache)的工作原理是：在快取中儲存已編譯的類、測試輸出和其他構建構件，同時考慮所有的任務輸入，包括輸入檔案內容、相關類路徑和任務設定。

所以在AGP 7.0中，提供了這部分新的api讓我們簡化對於task，輸入輸出這些引數的優化，讓我們可以更專注到我們想要變更的東西上。

比如說APk,MANIFEST,MAPPING_FILE,BUNDLE,AAR或者其他的一些編譯產物，當前agp給我們提供的也是相對來說比較少的一部分功能。

另外一點就是，我們如果想要知道一個task的輸入其實如果不去閱讀原始碼，之後獲取對應的路徑或者原始碼，其實是一個非常繁瑣的過程。之後還要通過變更dependon或者finalizedBy等等手段將任務插入到編譯流程內。

所以就有了我們這次的其中一個主角Artifacts,他主要負責幫助我們將我們的task，插入到編譯流程內，讓我們儘量少的關注到輸入和輸出。

          // 生成TaskProvider 
          val taskProvider = project.tasks.register(
                  "manifestCopy${variant.name}Task",
                  ManifestSampleTask::class.java
          )
          // 獲取variant的artifacts之後將Task轉化成我們所想要的
          variant.artifacts.use(taskProvider).wiredWithFiles(
                  ManifestSampleTask::mergedManifest,
                  ManifestSampleTask::outputManifest
          ).toTransform(SingleArtifact.MERGED_MANIFEST)

這個就是官方的一個Artifacts的簡單的使用了，通過變化我們可以輕鬆的完成一個有獲取合併後的Manifest作為輸入，之後以另外一個Manifest檔案作為輸出的一個task。而且會被直接新增編譯流程內，就不需要我們關心他們的前置和後置任務是啥了。

registerJavaGenerateTask 沒了

原先在v1的api上吧，有registerJavaGenerateTask這個方法，能加一些簡單的程式碼生成的操作，比如j神以前生成的R2就是通過掛載這個方法。

這次v2版本我在AndroidComponentsExtension中沒找到的對應的api，所以只能無中生友，自己搞一個出來咯。

@Override
 public void registerJavaGeneratingTask(@NonNull Task task, @NonNull File... sourceFolders) {
     getVariantData().registerJavaGeneratingTask(task, sourceFolders);
 }
 open fun registerJavaGeneratingTask(
    task: Task,
    generatedSourceFolders: Collection&lt;File&gt;
) {
    @Suppress("DEPRECATION")
    taskContainer.sourceGenTask.dependsOn(task)
    val fileTrees = extraGeneratedSourceFileTrees ?: mutableListOf&lt;ConfigurableFileTree&gt;().also {
        extraGeneratedSourceFileTrees = it
    }
    for (f in generatedSourceFolders) {
        val fileTree = services.fileTree(f).builtBy(task)
        fileTrees.add(fileTree)
    }
    addJavaSourceFoldersToModel(generatedSourceFolders)
}

我仔細觀察了下registerJavaGenerateTask的原始碼，發現其中只做了兩件比較簡單的事情。將Task掛載到generateVariantResources任務之後，然後將生成java類的資料夾加入到sourcetSet上去，這樣就行了。

sourcetSet就是javac的將java轉化成class的編譯路徑。

所以相對來說就比較簡單，我們用新的api模擬出原來的效果就差不多可以了，我們只要找到掛載的任務之後，順便把程式碼新增到java和kotlin的sourceset中就行了

fun Project.registerJavaGenerateTask(
    variant: String?,
    task: TaskProvider<out Task>,
    generatedSourceFolders: Collection<File>
) {
    if (variant.isNullOrEmpty().not()) {
        variant?.apply {
            // 因為task生成在設定階段完成之後
            afterEvaluate {
                findJavaGenerateTask(variant)?.dependsOn(task)
            }
            //  獲取最新版本sourceSet
            val application = extensions.findByType(ApplicationExtension::class.java)
            application?.sourceSets {
                findByName(variant)?.apply {
                    generatedSourceFolders.forEach {
                        java.srcDir(it)
                        kotlin.srcDir(it)
                    }
                }
            }
        }
    }
}

這次升級適配主要的程式碼就是這個了，其實程式碼量上來說不多。但是把有個坑點，之前因為偷懶就直接用了setSrcDirs這個api，所以檔案就被覆蓋了。導致了一部分程式碼沒有被編譯成class，導致了classnotfound異常。

其他

獲取applicationId,我們的外掛內有對於應用id的判斷，之後進行不同的manifest pleaceholder的調整。邏輯比較簡單，只是切換了新版本的api而已。

  if (variant is ApplicationVariant) {
    val applicationId = variant.applicationId.get()
      variant.manifestPlaceholders.put("xxxxx", applicationId)
  }

對resValue插入新的string或者values。也是原來就有的能力，但是要對新版本進行一次小小的適配和更換。

private fun addAPGClassFile(config: Variant, key: String, value: String) {
    val resValue = ResValue(value)
    val reskey = config.makeResValueKey("string", key)
    config.resValues.put(reskey, resValue)
}