Patch Anatomy

val COMPATIBILITY_XYZ = Compatibility(
    packageName = "app.xyz.mobile",
    name = "XYZ App",
    apkFileType = ApkFileType.XAPK,
    appIconColor = 0xFF3300,   // 0xRRGGBB — six-digit hex, zero alpha byte
    targets = listOf(
        AppTarget(version = "2.0.0"),
        AppTarget(version = "1.0.42"),
    )
)

@Suppress("unused")
val disableAdsPatch = bytecodePatch(
    name = "Disable ads",
    description = "Disables ads in the app.",
    default = true               // omit or set false for universal patches (enforced by builder)
) {
    compatibleWith(COMPATIBILITY_XYZ)
    dependsOn(disableAdsResourcePatch)
    extendWith("disable-ads.mpe")   // ← extension artifact is .mpe, not .mpp

    execute {
        showAdsFingerprint.method.addInstructions(0, """
            invoke-static {}, LDisableAdsPatch;->shouldDisableAds()Z
            move-result v0
            return v0
        """)
    }

    finalize {
        // Post-processing after all dependent patches execute
    }
}

// ✅ Current
method.addInstructions(0, "const/4 v0, 0x1\nreturn v0")

// ❌ Deprecated — will be deleted
method.addInstructions("const/4 v0, 0x1\nreturn v0")

val patch = bytecodePatch(name = "Configurable") {
    val value by stringOption(name = "Color")
    val custom by option<String>(name = "Custom option")
    execute { println(value) }
}

val sharedOption = stringOption(name = "Shared")
bytecodePatch(name = "A") { val v by sharedOption() }
bytecodePatch(name = "B") { val v by sharedOption() }

public class ComplexPatch {
    public static void doSomething() { /* complex logic */ }
}

val patch = bytecodePatch(name = "Complex") {
    extendWith("complex-patch.mpe")   // ← .mpe not .mpp
    execute {
        fingerprint.method.addInstructions(0, "invoke-static {}, LComplexPatch;->doSomething()V")
    }
}

extendWithAll(Supplier { listOf(stream1, stream2) })

val patch = bytecodePatch(name = "Main") {
    dependsOn(bytecodePatch(name = "Dep") {
        execute { print("1") }
        finalize { print("4") }
    })
    execute { print("2") }
    finalize { print("3") }
}
// Output: 1234 (execute in dependency order, finalize in reverse)

val COMPAT = Compatibility(
    packageName = "com.example.app",  // must match Android package name regex
    name = "App Name",                // required when packageName is non-null, must be non-blank
    description = "Optional description.",
    apkFileType = ApkFileType.XAPK,   // see ApkFileType below
    appIconColor = 0x6200EE,          // 0xRRGGBB — alpha byte MUST be 0x00
    signatures = setOf(
        "a1b2c3...64hexchars"         // SHA-256 from apksigner verify --print-certs, 64 hex chars
    ),
    targets = listOf(                 // must be non-empty; newest first
        AppTarget(version = "2.0.0", minSdk = 28, isExperimental = true),
        AppTarget(version = "1.0.0", minSdk = 26),
    )
)

val COMPAT_PLUS = COMPAT.including(AppTarget(version = "3.0.0"))
val COMPAT_MINUS = COMPAT.excluding("1.0.0", "1.0.42")

enum class ApkFileType {
    APK,           // single APK (recommended)
    APK_REQUIRED,  // single APK (required — other formats rejected)
    APKM,          // APKMirror bundle (recommended)
    APKM_REQUIRED, // APKMirror bundle (required)
    APKS,          // bundletool APKS (recommended)
    APKS_REQUIRED, // bundletool APKS (required)
    XAPK,          // APKPure XAPK (recommended)
    XAPK_REQUIRED, // APKPure XAPK (required)
}