Exploring the Android Transform API

What do ProGuard, Multidex, Resource Merger and Realm have in common? Answer: All of these components owe key functionality to the Android Transform API. It is a centerpiece of the Android Gradle Plugin's internal architecutre, as it is responsible for processing intermediary build artifacts, and before the introduction of D8, it was even tasked with the bytecode transformation of Java 8 code for Android as well. To third-party developers, it offers a hook into the creation of an APK through a centralized concept, the Transform, which can inspect and modify classes or resources. Little documentation and a lack of accessibility to the topic have rendered the Transform API a "hidden gem" in the Android plugin infrastructure.

Transcript

1. &YQMPSJOH
   UIF
   "OESPJE
   5SBOTGPSN
   "1*
   .BSDFM
   4DIOFMMF !NBSDFMTDIOFMMF
2. "(1
   
   FNCSBDFE
   +BWB
   
3. public static void main(String[] args) { process(i -> System.out.println(i + " is the answer!")); } private static void process(IntConsumer consumer) { consumer.accept(42); } class MyProgram { } interface IntConsumer { void accept(int value); }
4. interface IntConsumer { void accept(int value); } class MyProgram { private static void process(IntConsumer consumer) { consumer.accept(42); } public static void main(String[] args) { process(i -> System.out.println(i + " is the answer!")); } } #FGPSF
   "(1
    Uncaught translation error: com.android.dx.cf.code.SimException: ERROR in MyProgram.main:([Ljava/lang/String;)V: invalid opcode ba - invokedynamic requires --min-sdk-version >= 26 (currently 19) 1 error; aborting BUILD FAILED in 1s
5. interface IntConsumer { void accept(int value); } class MyProgram { private static void process(IntConsumer consumer) { consumer.accept(42); } public static void main(String[] args) { process(i -> System.out.println(i + " is the answer!")); } } 8JUI
   "(1
    BUILD SUCCESSFUL in 1s
6. #VU
   IPX
   EPFT
   JU
   XPSL
7. l%FTVHBSJOHz 3FXSJUJOH
   +BWB
   
   CZUFDPEF
   UP
   CF
   DPNQBUJCMF
   XJUI
   +BWB
   
   3VOUJNFT 
   3FUSPMBNCEB 
   %Y
   %FTVHBS
   5SBOTGPSN 
   %
   %FTVHBS
   #VJMUJO 
   +BDL
   5PPMDIBJO
8. %FTVHBSJOH
   XJUI
   EY
   JT
   BO
   FYBNQMF
   PG
   B
   Transform
9. App Sources Library Sources javac/kotlinc Transforms dx/D8
10. Transforms Instant Run ProGuard Java Resource Merging Retrolambda dx Desugar Dex Archive Jetifier Realm ...
11. "
    Transform
    JT
    OPU
    BO
    "OOPUBUJPO
    1SPDFTTPS
12. "
    Transform
    DBO
    NBOJQVMBUF
    FH
    +BWB
    CZUFDPEF
    PS
    SFTPVSDF
    GJMFT
    BNPOH
    PUIFST "O
    "OOPUBUJPO
    1SPDFTTPS
    HFOFSBUFT
    OFX
    TPVSDF
    DPEF ≠
13. $SFBUJOH
    B
    Transform  $SFBUF
    buildSrc
    NPEVMF
     "EE
    EFQFOEFODZ
    PO
    com.android.tools.build:gradle-api
     $SFBUF
    B
    DMBTT
    FYUFOEJOH
    Transform
     *NQMFNFOU
    ZPVS
    USBOTGPSN
    FH
    VTJOH
    +BWBTTJTU
    "1*
     *O
    UIF
    BQQ`T
    CVJMEHSBEMF
    SFHJTUFS
    UIF
    USBOTGPSN
    android.registerTransform
14. Transform
    "1*  fun getName(): String
 6OJRVF
    JEFOUJpFS
    PG
    UIF
    Transform  fun isIncremental(): Boolean
 (FU
    BMM
    DMBTT
    pMFT
    PS
    KVTU
    B
    EJ⒎
    PG
    DIBOHFE
    pMFT  fun getInputTypes(): Set<ContentType>
 $MBTTFT
    PS
    3FTPVSDFT  fun getScopes(): MutableSet<in Scope>
 )PX
    NVDI
    EFUBJM
15. Transform#transform(TransformInvocation)  inputs: Collection<TransformInput>
 5IF
    pMFT
    NBOJQVMBUFE
    CZ
    UIF
    5SBOTGPSN  referencedInputs: Collection<TransformInput>
 5IF
    pMFT
    OPU
    NBOJQVMBUFE
    CZ
    UIF
    5SBOTGPSN  secondaryInputs: Collection<TransformInput>
 SFMBUFE
    UP
    JODSFNFOUBM
    QSPDFTTJOH  context: Context
 "DDFTT
    UP
    MPHHJOH
    
    CVJME
    JOGP  outputProvider: TransformOutputProvider
 'BDUPSZ
    GPS
    PVUQVU
    GPMEFST
    UP
    XSJUF
    UIF
    SFTVMUT
    UP
16. &YBNQMF
    "1*
    #BDLQPSU
18. // Create an immutable list of 3 strings (Java 9) List<String> values = List.of("Hello", "Mr.", "Hoge"); // Create an immutable list of 3 strings (Kotlin) val values = listOf("Hello", "Mr.", "Hoge") // Create an immutable list of 3 strings (Java 7) List<String> values = new ArrayList<>(3); values.add("Hello"); values.add("Mr."); values.add("Hoge"); values = Collections.unmodifiableList(values);
20. 1SPCMFN
    "OESPJE
    EPFTO`U
    TVQQPSU
    +BWB
    
    ZFU
21. )BDLJOH
    +BWB
    
    "1*T
    JOUP
    BOESPJEKBS  $PQZ
    platforms/android-28
    BOE
    SFOBNF
    UP
    platforms/android-1000
     3FQMBDF
    NFOUJPOT
    PG
    "1*
    -FWFM
    
    XJUI
    
    package.xml, build.prop, source.properties  3FQMBDF
    java.util
    QBDLBHF
    JOTJEF
    android.jar
    XJUI
    DMBTTFT
    UBLFO
    GSPN
    +%,
    
    jar uf <jar-file> <updated-class-files>
     6QEBUF
    build.gradle
    UP
    QPJOU
    UP
    android-1000
    JOTUFBE
     (SBEMF
    4ZOD
     8F
    IBWF
    UIF
    +BWB
    
    "1*T
    OPX
     *
    EJTDPVSBHF
    NBOJQVMBUJPO
    PG
    UIF
    "OESPJE
    1MBUGPSN
    MJLF
    UIJT
    
    EFNPOTUSBUJPO
    POMZ
    /FWFS
    CVJME
    BHBJOTU
    B
    NPOLFZQBUDIFE
    +"3
22. -FU`T
    XSJUF
    B
    Transform
23. %FNP
    5JNF
24. IUUQTHJUIVCDPNNBOOPEFSNBVTUSBOTGPSNGVO IUUQTHJUIVCDPNFWBOUHSBEMFSFUSPMBNCEBCMPCNBTUFSHSBEMFSFUSPMBNCEBTSDNBJOHSPPWZNFUBUBSLB
    IUUQTHJUIVCDPNSFBMNSFBMNKBWBUSFFNBTUFSSFBMNUSBOTGPSNFSTSDNBJOLPUMJOJPSFBMNUSBOTGPSNFS
    IUUQTHJUIVCDPN.JDIBFM3PDLTMJHIUTBCFSUSFFEFWFMPQHSBEMFQMVHJOTSDNBJOKBWBJPNJDIBFMSPDLTMJHIUTBCFSQMVHJO
25. Ҏ্ɻ