首頁 > 軟體

Android開發AsmClassVisitorFactory使用詳解

2022-06-21 22:00:36

前言

之前就和大家介紹過AGP(Android Gradle Plugin) 7.0.0版本之後Transform 已經過期即將廢棄的事情。而且也簡單的介紹了替換的方式是Transform Action,經過我這一陣子的學習和調研,發現只能說答對了一半吧。下面介紹個新東西AsmClassVisitorFactory

com.android.build.api.instrumentation.AsmClassVisitorFactory

A factory to create class visitor objects to instrument classes.

The implementation of this interface must be an abstract class where the parameters and instrumentationContext are left unimplemented. The class must have an empty constructor which will be used to construct the factory object.

當前官方推薦使用的應該是這個類,這個類的底層實現就是基於gradle原生的Transform Action,這次的學習過程其實走了一點點彎路,一開始嘗試的是Transform Action,但是貌似彎彎繞繞的,最後也沒有成功,而且Transform Action的輸入產物都是單一檔案,修改也是針對單一檔案的,所以貌似也不完全是一個很好的替換方案,之前文章介紹的那種複雜的asm操作則無法負荷了。

AsmClassVisitorFactory根據官方說法,編譯速度會有提升,大概18%左右,這個下面我們會在使用階段對其進行介紹的。

我們先從AsmClassVisitorFactory這個抽象介面開始介紹起吧。

AsmClassVisitorFactory

@Incubating
interface AsmClassVisitorFactory<ParametersT : InstrumentationParameters> : Serializable {
    /**
     * The parameters that will be instantiated, configured using the given config when registering
     * the visitor, and injected on instantiation.
     *
     * This field must be left unimplemented.
     */
    @get:Nested
    val parameters: Property<ParametersT>
    /**
     * Contains parameters to help instantiate the visitor objects.
     *
     * This field must be left unimplemented.
     */
    @get:Nested
    val instrumentationContext: InstrumentationContext
    /**
     * Creates a class visitor object that will visit a class with the given [classContext]. The
     * returned class visitor must delegate its calls to [nextClassVisitor].
     *
     * The given [classContext] contains static information about the classes before starting the
     * instrumentation process. Any changes in interfaces or superclasses for the class with the
     * given [classContext] or for any other class in its classpath by a previous visitor will
     * not be reflected in the [classContext] object.
     *
     * [classContext] can also be used to get the data for classes that are in the runtime classpath
     * of the class being visited.
     *
     * This method must handle asynchronous calls.
     *
     * @param classContext contains information about the class that will be instrumented by the
     *                     returned class visitor.
     * @param nextClassVisitor the [ClassVisitor] to which the created [ClassVisitor] must delegate
     *                         method calls.
     */
    fun createClassVisitor(
        classContext: ClassContext,
        nextClassVisitor: ClassVisitor
    ): ClassVisitor
    /**
     * Whether or not the factory wants to instrument the class with the given [classData].
     *
     * If returned true, [createClassVisitor] will be called and the returned class visitor will
     * visit the class.
     *
     * This method must handle asynchronous calls.
     */
    fun isInstrumentable(classData: ClassData): Boolean
}

簡單的分析下這個介面,我們要做的就是在createClassVisitor這個方法中返回一個ClassVisitor,正常我們在構造ClassVisitor範例的時候是需要傳入下一個ClassVisitor範例的,所以我們之後在new的時候傳入nextClassVisitor就行了。

另外就是isInstrumentable,這個方法是判斷當前類是否要進行掃描,因為如果所有類都要通過ClassVisitor進行掃描還是太耗時了,我們可以通過這個方法過濾掉很多我們不需要掃描的類。

@Incubating
interface ClassData {
    /**
     * Fully qualified name of the class.
     */
    val className: String
    /**
     * List of the annotations the class has.
     */
    val classAnnotations: List<String>
    /**
     * List of all the interfaces that this class or a superclass of this class implements.
     */
    val interfaces: List<String>
    /**
     * List of all the super classes that this class or a super class of this class extends.
     */
    val superClasses: List<String>
}

ClassData並不是asm的api,所以其中包含的內容相對來說比較少,但是應該也勉強夠用了。這部分大家簡單看看就行了,就不多做介紹了呢。

新的Extension

AGP版本升級之後,應該是為了區分新舊版的Extension,所以在AppExtension的基礎上,新增了一個AndroidComponentsExtension出來。

我們的transformClassesWith就需要註冊在這個上面。這個需要考慮到變種,和之前的Transform還是有比較大的區別的,這樣我們就可以基於不同的變種增加對應的適配工作了。

        val androidComponents = project.extensions.getByType(AndroidComponentsExtension::class.java)
        androidComponents.onVariants { variant ->
            variant.transformClassesWith(PrivacyClassVisitorFactory::class.java,
                    InstrumentationScope.ALL) {}
            variant.setAsmFramesComputationMode(FramesComputationMode.COPY_FRAMES)
        }

實戰

這次還是在之前的敏感許可權api替換的位元組碼替換工具的基礎上進行測試開發。

ClassVisitor

看看我們正常是如何寫一個簡單的ClassVisitor的。

ClassWriter classWriter = new ClassWriter(ClassWriter.COMPUTE_MAXS);
ClassVisitor methodFilterCV = new ClassFilterVisitor(classWriter);
ClassReader cr = new ClassReader(srcClass);
cr.accept(methodFilterCV, ClassReader.SKIP_DEBUG);
return classWriter.toByteArray();

首先我們會構造好一個空的ClassWriter,接著會構造一個ClassVisitor範例,然後傳入這個ClassWriter。然後我們構造一個ClassReader範例,然後將byte陣列傳入,之後呼叫classReader.accept方法,之後我們就能在visitor中逐個存取資料了。

那麼其實我們的類資訊,方法啥的都是通過ClassReader讀入的,然後由當前的ClassVisitor存取完之後交給我們最後一個ClassWriter

其中ClassWriter也是一個ClassVisitor物件,他複雜重新將修改過的類轉化成byte資料。可以看得出來ClassVisitor就有一個非常簡單的連結串列結構,之後逐層向下存取。

介紹完了這個哦,我們做個大膽的假設,如果我們這個ClassVisitor連結串列前插入幾個不同的ClassVisitor,那麼我們是不是就可以讓asm修改逐個生效,然後也不需要多餘的io操作了呢。這就是新的asm api 的設計思路了,也是我們這邊大佬的位元組碼框架大佬的設計。另外bytex內的設計思路也是如此。

tips ClassNode 因為是先生成的語法樹,所以和一般的ClassVisitor有點小區別,需要在visitEnd方法內呼叫accept(next)

實際程式碼分析

接下來我們上實戰咯。我將之前的程式碼套用到這次的邏輯上來。

demo地址

abstract class PrivacyClassVisitorFactory : AsmClassVisitorFactory<InstrumentationParameters.None> {
    override fun createClassVisitor(classContext: ClassContext, nextClassVisitor: ClassVisitor): ClassVisitor {
        return PrivacyClassNode(nextClassVisitor)
    }
    override fun isInstrumentable(classData: ClassData): Boolean {
        return true
    }
}

我在isInstrumentable都返回的是true,其實我可以將掃描規則限定在特定包名內,這樣就可以加快構建速度了。

class PrivacyClassNode(private val nextVisitor: ClassVisitor) : ClassNode(Opcodes.ASM5) {
    override fun visitEnd() {
        super.visitEnd()
        PrivacyHelper.whiteList.let {
            val result = it.firstOrNull { whiteName ->
                name.contains(whiteName, true)
            }
            result
        }.apply {
            if (this == null) {
                //   println("filter: $name")
            }
        }
        PrivacyHelper.whiteList.firstOrNull {
            name.contains(it, true)
        }?.apply {
            val iterator: Iterator<MethodNode> = methods.iterator()
            while (iterator.hasNext()) {
                val method = iterator.next()
                method.instructions?.iterator()?.forEach {
                    if (it is MethodInsnNode) {
                        it.isPrivacy()?.apply {
                            println("privacy transform classNodeName: ${name@this}")
                            it.opcode = code
                            it.owner = owner
                            it.name = name
                            it.desc = desc
                        }
                    }
                }
            }
        }
        accept(nextVisitor)
    }
}
private fun MethodInsnNode.isPrivacy(): PrivacyAsmEntity? {
    val pair = PrivacyHelper.privacyList.firstOrNull {
        val first = it.first
        first.owner == owner && first.code == opcode && first.name == name && first.desc == desc
    }
    return pair?.second
}

這部分比較簡單,把邏輯抽象定義在類ClassNode內,然後在visitEnd方法的時候呼叫我之前說的accept(nextVisitor)方法。

另外就是註冊邏輯了,和我前面介紹的內容基本都是一樣的。

個人觀點

AsmClassVisitorFactory相比較於之前的Transform確實簡化了非常非常多,我們不需要關心之前的增量更新等等邏輯,只要專注於asm api的操作就行了。

其次就是因為減少了io操作,所以其速度自然也就比之前有所提升。同時因為基於的是Transform Action,所以整體效能還是非常ok的,那部分增量可以說是更簡單了。

另外我也和我的同事大佬交流過哦,複雜的這種類似上篇文章介紹的,最好還是使用Gradle Task的形式進行修改。

以上就是Android開發AsmClassVisitorFactory使用詳解的詳細內容,更多關於Android開發AsmClassVisitorFactory的資料請關注it145.com其它相關文章!


IT145.com E-mail:sddin#qq.com