package app.revanced.util import app.revanced.patcher.FingerprintBuilder import app.revanced.patcher.extensions.InstructionExtensions.addInstruction import app.revanced.patcher.extensions.InstructionExtensions.addInstructions import app.revanced.patcher.extensions.InstructionExtensions.addInstructionsWithLabels import app.revanced.patcher.extensions.InstructionExtensions.getInstruction import app.revanced.patcher.extensions.InstructionExtensions.instructions import app.revanced.patcher.extensions.InstructionExtensions.removeInstruction import app.revanced.patcher.patch.BytecodePatchContext import app.revanced.patcher.patch.PatchException import app.revanced.patcher.util.proxy.mutableTypes.MutableClass import app.revanced.patcher.util.proxy.mutableTypes.MutableMethod import app.revanced.patches.shared.misc.mapping.get import app.revanced.patches.shared.misc.mapping.resourceMappingPatch import app.revanced.patches.shared.misc.mapping.resourceMappings import com.android.tools.smali.dexlib2.Opcode import com.android.tools.smali.dexlib2.iface.Method import com.android.tools.smali.dexlib2.iface.instruction.Instruction import com.android.tools.smali.dexlib2.iface.instruction.OneRegisterInstruction import com.android.tools.smali.dexlib2.iface.instruction.ReferenceInstruction import com.android.tools.smali.dexlib2.iface.instruction.WideLiteralInstruction import com.android.tools.smali.dexlib2.iface.reference.Reference import com.android.tools.smali.dexlib2.util.MethodUtil /** * Find the [MutableMethod] from a given [Method] in a [MutableClass]. * * @param method The [Method] to find. * @return The [MutableMethod]. */ fun MutableClass.findMutableMethodOf(method: Method) = this.methods.first { MethodUtil.methodSignaturesMatch(it, method) } /** * Apply a transform to all methods of the class. * * @param transform The transformation function. Accepts a [MutableMethod] and returns a transformed [MutableMethod]. */ fun MutableClass.transformMethods(transform: MutableMethod.() -> MutableMethod) { val transformedMethods = methods.map { it.transform() } methods.clear() methods.addAll(transformedMethods) } /** * Inject a call to a method that hides a view. * * @param insertIndex The index to insert the call at. * @param viewRegister The register of the view to hide. * @param classDescriptor The descriptor of the class that contains the method. * @param targetMethod The name of the method to call. */ fun MutableMethod.injectHideViewCall( insertIndex: Int, viewRegister: Int, classDescriptor: String, targetMethod: String, ) = addInstruction( insertIndex, "invoke-static { v$viewRegister }, $classDescriptor->$targetMethod(Landroid/view/View;)V", ) /** * Inserts instructions at a given index, using the existing control flow label at that index. * Inserted instructions can have it's own control flow labels as well. * * Effectively this changes the code from: * :label * (original code) * * Into: * :label * (patch code) * (original code) */ internal fun MutableMethod.addInstructionsAtControlFlowLabel( insertIndex: Int, instructions: String, ) { // Duplicate original instruction and add to +1 index. addInstruction(insertIndex + 1, getInstruction(insertIndex)) // Add patch code at same index as duplicated instruction, // so it uses the original instruction control flow label. addInstructionsWithLabels(insertIndex + 1, instructions) // Remove original non duplicated instruction. removeInstruction(insertIndex) // Original instruction is now after the inserted patch instructions, // and the original control flow label is on the first instruction of the patch code. } /** * Get the index of the first instruction with the id of the given resource id name. * * Requires [resourceMappingPatch] as a dependency. * * @param resourceName the name of the resource to find the id for. * @return the index of the first instruction with the id of the given resource name, or -1 if not found. * @throws PatchException if the resource cannot be found. * @see [indexOfFirstResourceIdOrThrow], [indexOfFirstLiteralInstructionReversed] */ fun Method.indexOfFirstResourceId(resourceName: String): Int { val resourceId = resourceMappings["id", resourceName] return indexOfFirstLiteralInstruction(resourceId) } /** * Get the index of the first instruction with the id of the given resource name or throw a [PatchException]. * * Requires [resourceMappingPatch] as a dependency. * * @throws [PatchException] if the resource is not found, or the method does not contain the resource id literal value. * @see [indexOfFirstResourceId], [indexOfFirstLiteralInstructionReversedOrThrow] */ fun Method.indexOfFirstResourceIdOrThrow(resourceName: String): Int { val index = indexOfFirstResourceId(resourceName) if (index < 0) { throw PatchException("Found resource id for: '$resourceName' but method does not contain the id: $this") } return index } /** * Find the index of the first literal instruction with the given value. * * @return the first literal instruction with the value, or -1 if not found. * @see indexOfFirstLiteralInstructionOrThrow */ fun Method.indexOfFirstLiteralInstruction(literal: Long) = implementation?.let { it.instructions.indexOfFirst { instruction -> (instruction as? WideLiteralInstruction)?.wideLiteral == literal } } ?: -1 /** * Find the index of the first literal instruction with the given value, * or throw an exception if not found. * * @return the first literal instruction with the value, or throws [PatchException] if not found. */ fun Method.indexOfFirstLiteralInstructionOrThrow(literal: Long): Int { val index = indexOfFirstLiteralInstruction(literal) if (index < 0) throw PatchException("Could not find literal value: $literal") return index } /** * Find the index of the last literal instruction with the given value. * * @return the last literal instruction with the value, or -1 if not found. * @see indexOfFirstLiteralInstructionOrThrow */ fun Method.indexOfFirstLiteralInstructionReversed(literal: Long) = implementation?.let { it.instructions.indexOfLast { instruction -> (instruction as? WideLiteralInstruction)?.wideLiteral == literal } } ?: -1 /** * Find the index of the last wide literal instruction with the given value, * or throw an exception if not found. * * @return the last literal instruction with the value, or throws [PatchException] if not found. */ fun Method.indexOfFirstLiteralInstructionReversedOrThrow(literal: Long): Int { val index = indexOfFirstLiteralInstructionReversed(literal) if (index < 0) throw PatchException("Could not find literal value: $literal") return index } /** * Check if the method contains a literal with the given value. * * @return if the method contains a literal with the given value. */ fun Method.containsLiteralInstruction(literal: Long) = indexOfFirstLiteralInstruction(literal) >= 0 /** * Traverse the class hierarchy starting from the given root class. * * @param targetClass the class to start traversing the class hierarchy from. * @param callback function that is called for every class in the hierarchy. */ fun BytecodePatchContext.traverseClassHierarchy(targetClass: MutableClass, callback: MutableClass.() -> Unit) { callback(targetClass) targetClass.superclass ?: return classBy { targetClass.superclass == it.type }?.mutableClass?.let { traverseClassHierarchy(it, callback) } } /** * Get the [Reference] of an [Instruction] as [T]. * * @param T The type of [Reference] to cast to. * @return The [Reference] as [T] or null * if the [Instruction] is not a [ReferenceInstruction] or the [Reference] is not of type [T]. * @see ReferenceInstruction */ inline fun Instruction.getReference() = (this as? ReferenceInstruction)?.reference as? T /** * @return The index of the first opcode specified, or -1 if not found. * @see indexOfFirstInstructionOrThrow */ fun Method.indexOfFirstInstruction(targetOpcode: Opcode): Int = indexOfFirstInstruction(0, targetOpcode) /** * @param startIndex Optional starting index to start searching from. * @return The index of the first opcode specified, or -1 if not found. * @see indexOfFirstInstructionOrThrow */ fun Method.indexOfFirstInstruction(startIndex: Int = 0, targetOpcode: Opcode): Int = indexOfFirstInstruction(startIndex) { opcode == targetOpcode } /** * Get the index of the first [Instruction] that matches the predicate, starting from [startIndex]. * * @param startIndex Optional starting index to start searching from. * @return -1 if the instruction is not found. * @see indexOfFirstInstructionOrThrow */ fun Method.indexOfFirstInstruction(startIndex: Int = 0, filter: Instruction.() -> Boolean): Int { var instructions = this.implementation!!.instructions if (startIndex != 0) { instructions = instructions.drop(startIndex) } val index = instructions.indexOfFirst(filter) return if (index >= 0) { startIndex + index } else { -1 } } /** * @return The index of the first opcode specified * @throws PatchException * @see indexOfFirstInstruction */ fun Method.indexOfFirstInstructionOrThrow(targetOpcode: Opcode): Int = indexOfFirstInstructionOrThrow(0, targetOpcode) /** * @return The index of the first opcode specified, starting from the index specified. * @throws PatchException * @see indexOfFirstInstruction */ fun Method.indexOfFirstInstructionOrThrow(startIndex: Int = 0, targetOpcode: Opcode): Int = indexOfFirstInstructionOrThrow(startIndex) { opcode == targetOpcode } /** * Get the index of the first [Instruction] that matches the predicate, starting from [startIndex]. * * @return The index of the instruction. * @throws PatchException * @see indexOfFirstInstruction */ fun Method.indexOfFirstInstructionOrThrow(startIndex: Int = 0, filter: Instruction.() -> Boolean): Int { val index = indexOfFirstInstruction(startIndex, filter) if (index < 0) { throw PatchException("Could not find instruction index") } return index } /** * Get the index of matching instruction, * starting from and [startIndex] and searching down. * * @param startIndex Optional starting index to search down from. Searching includes the start index. * @return -1 if the instruction is not found. * @see indexOfFirstInstructionReversedOrThrow */ fun Method.indexOfFirstInstructionReversed(startIndex: Int? = null, targetOpcode: Opcode): Int = indexOfFirstInstructionReversed(startIndex) { opcode == targetOpcode } /** * Get the index of matching instruction, * starting from and [startIndex] and searching down. * * @param startIndex Optional starting index to search down from. Searching includes the start index. * @return -1 if the instruction is not found. * @see indexOfFirstInstructionReversedOrThrow */ fun Method.indexOfFirstInstructionReversed(startIndex: Int? = null, filter: Instruction.() -> Boolean): Int { var instructions = this.implementation!!.instructions if (startIndex != null) { instructions = instructions.take(startIndex + 1) } return instructions.indexOfLast(filter) } /** * Get the index of matching instruction, * starting from the end of the method and searching down. * * @return -1 if the instruction is not found. */ fun Method.indexOfFirstInstructionReversed(targetOpcode: Opcode): Int = indexOfFirstInstructionReversed { opcode == targetOpcode } /** * Get the index of matching instruction, * starting from and [startIndex] and searching down. * * @param startIndex Optional starting index to search down from. Searching includes the start index. * @return The index of the instruction. * @see indexOfFirstInstructionReversed */ fun Method.indexOfFirstInstructionReversedOrThrow(startIndex: Int? = null, targetOpcode: Opcode): Int = indexOfFirstInstructionReversedOrThrow(startIndex) { opcode == targetOpcode } /** * Get the index of matching instruction, * starting from the end of the method and searching down. * * @return -1 if the instruction is not found. */ fun Method.indexOfFirstInstructionReversedOrThrow(targetOpcode: Opcode): Int = indexOfFirstInstructionReversedOrThrow { opcode == targetOpcode } /** * Get the index of matching instruction, * starting from and [startIndex] and searching down. * * @param startIndex Optional starting index to search down from. Searching includes the start index. * @return The index of the instruction. * @see indexOfFirstInstructionReversed */ fun Method.indexOfFirstInstructionReversedOrThrow(startIndex: Int? = null, filter: Instruction.() -> Boolean): Int { val index = indexOfFirstInstructionReversed(startIndex, filter) if (index < 0) { throw PatchException("Could not find instruction index") } return index } /** * @return An immutable list of indices of the instructions in reverse order. * _Returns an empty list if no indices are found_ * @see findInstructionIndicesReversedOrThrow */ fun Method.findInstructionIndicesReversed(filter: Instruction.() -> Boolean): List = instructions .withIndex() .filter { (_, instruction) -> filter(instruction) } .map { (index, _) -> index } .asReversed() /** * @return An immutable list of indices of the instructions in reverse order. * @throws PatchException if no matching indices are found. */ fun Method.findInstructionIndicesReversedOrThrow(filter: Instruction.() -> Boolean): List { val indexes = findInstructionIndicesReversed(filter) if (indexes.isEmpty()) throw PatchException("No matching instructions found in: $this") return indexes } /** * @return An immutable list of indices of the opcode in reverse order. * _Returns an empty list if no indices are found_ * @see findInstructionIndicesReversedOrThrow */ fun Method.findInstructionIndicesReversed(opcode: Opcode): List = findInstructionIndicesReversed { this.opcode == opcode } /** * @return An immutable list of indices of the opcode in reverse order. * @throws PatchException if no matching indices are found. */ fun Method.findInstructionIndicesReversedOrThrow(opcode: Opcode): List { val instructions = findInstructionIndicesReversed(opcode) if (instructions.isEmpty()) throw PatchException("Could not find opcode: $opcode in: $this") return instructions } internal fun MutableMethod.insertFeatureFlagBooleanOverride(literal: Long, extensionsMethod: String) { val literalIndex = indexOfFirstLiteralInstructionOrThrow(literal) val index = indexOfFirstInstructionOrThrow(literalIndex, Opcode.MOVE_RESULT) val register = getInstruction(index).registerA val operation = if (register < 16) { "invoke-static { v$register }" } else { "invoke-static/range { v$register .. v$register }" } addInstructions( index + 1, """ $operation, $extensionsMethod move-result v$register """, ) } /** * Called for _all_ instructions with the given literal value. */ fun BytecodePatchContext.forEachLiteralValueInstruction( literal: Long, block: MutableMethod.(literalInstructionIndex: Int) -> Unit, ) { classes.forEach { classDef -> classDef.methods.forEach { method -> method.implementation?.instructions?.forEachIndexed { index, instruction -> if (instruction.opcode == Opcode.CONST && (instruction as WideLiteralInstruction).wideLiteral == literal ) { val mutableMethod = proxy(classDef).mutableClass.findMutableMethodOf(method) block.invoke(mutableMethod, index) } } } } } /** * Return the method early. */ fun MutableMethod.returnEarly(bool: Boolean = false) { val const = if (bool) "0x1" else "0x0" val stringInstructions = when (returnType.first()) { 'L' -> """ const/4 v0, $const return-object v0 """ 'V' -> "return-void" 'I', 'Z' -> """ const/4 v0, $const return v0 """ else -> throw Exception("Return type is not supported: $this") } addInstructions(0, stringInstructions) } /** * Set the custom condition for this fingerprint to check for a literal value. * * @param literalSupplier The supplier for the literal value to check for. */ // TODO: add a way for subclasses to also use their own custom fingerprint. fun FingerprintBuilder.literal(literalSupplier: () -> Long) { custom { method, _ -> method.containsLiteralInstruction(literalSupplier()) } }