ARSCLib

Arsclib

Android Binary Resources Lisez / écriture de la bibliothèque Java

Cette bibliothèque est développée sur la base de la structure AOSP d'AndroidFW / ResourceCetypes.h, pour remplacer totalement AAPT / AAPT2

Lire, écrire, modifier et créer

• Tableau de ressources (Resources.ARSC)
• Fichiers XML binaires (AndroidManifest.xml & Resource XML)

Convertir à partir de / en JSON String (pour les ressources obscurcis)

• Décode les ressources à JSON lisible
• Encode / construit des sources au format JSON aux ressources binaires

Convertir de / en chaîne XML (pour les ressources non obstruées)

• Décode les ressources au code source
• Encode / construit une source XML aux ressources binaires

Notes:

1- Le décodage des ressources à XML exige que tous les noms de source ne devraient être pas obtenus et valides

2- L'utilisateur de cette LIB est supposé avoir une bonne connaissance de la syntaxe XML source Android, donc lors du codage / construction, il ne valide pas ou ne lance pas des erreurs de syntaxe XML aussi souvent que AAPT / AAPT2. Par exemple, vous êtes autorisé à définir de mauvaises valeurs à certains endroits et n'empêche pas une construction réussie. Sur AndroidManifest.xml, vous pouvez définir package="Wrong ? (package) name!" Ensuite, vous devez savoir que ces valeurs sont acceptables par les appareils Android.

Exemple d'application

Consultez cet outil développé à l'aide de cette bibliothèque https://github.com/reandroid/apkeditor

Fonctionne sur toutes les plates-formes prises en charge Java (Android, Linux, Mac, Windows)

• Maven

 repositories {
   mavenCentral()
}
dependencies {
   implementation( " io.github.reandroid:ARSCLib:+ " )
}

• Pot

 dependencies {
    implementation(files( " $r ootProject . projectDir /libs/ARSCLib.jar " ))
}

Build

 git clone https://github.com/REAndroid/ARSCLib.git
cd ARSCLib
./gradlew jar
# Built jar will be placed ./build/libs/ARSCLib-x.x.x.jar 

Exemples

Java example

 import com . reandroid . apk . AndroidFrameworks ;
import com . reandroid . apk . ApkModule ;
import com . reandroid . apk . FrameworkApk ;
import com . reandroid . archive . ByteInputSource ;
import com . reandroid . arsc . chunk . PackageBlock ;
import com . reandroid . arsc . chunk . TableBlock ;
import com . reandroid . arsc . chunk . xml . AndroidManifestBlock ;
import com . reandroid . arsc . chunk . xml . ResXmlAttribute ;
import com . reandroid . arsc . chunk . xml . ResXmlElement ;
import com . reandroid . arsc . coder . EncodeResult ;
import com . reandroid . arsc . coder . ValueCoder ;
import com . reandroid . arsc . value . Entry ;

import java . io . File ;
import java . io . IOException ;

public class ARSCLibExample {

    public static void createNewApk () throws IOException {

        ApkModule apkModule = new ApkModule ();

        TableBlock tableBlock = new TableBlock ();
        AndroidManifestBlock manifest = new AndroidManifestBlock ();

        apkModule . setTableBlock ( tableBlock );
        apkModule . setManifest ( manifest );

        FrameworkApk framework = apkModule . initializeAndroidFramework (
                AndroidFrameworks . getLatest (). getVersionCode ());

        PackageBlock packageBlock = tableBlock . newPackage ( 0x7f , "com.example" );

        Entry appIcon = packageBlock . getOrCreate ( "" , "drawable" , "ic_launcher" );

        EncodeResult color = ValueCoder . encode ( "#006400" );
        appIcon . setValueAsRaw ( color . valueType , color . value );

        Entry appNameDefault = packageBlock . getOrCreate ( "" , "string" , "app_name" );
        appNameDefault . setValueAsString ( "My Application" );

        Entry appNameDe = packageBlock . getOrCreate ( "-de" , "string" , "app_name" );
        appNameDe . setValueAsString ( "Meine Bewerbung" );

        Entry appNameRu = packageBlock . getOrCreate ( "-ru-rRU" , "string" , "app_name" );
        appNameRu . setValueAsString ( "Мое заявление" );

        manifest . setPackageName ( "com.example" );
        manifest . setVersionCode ( 100 );
        manifest . setVersionName ( "1.0.0" );
        manifest . setIconResourceId ( appIcon . getResourceId ());
        manifest . setCompileSdkVersion ( framework . getVersionCode ());
        manifest . setCompileSdkVersionCodename ( framework . getVersionName ());
        manifest . setPlatformBuildVersionCode ( framework . getVersionCode ());
        manifest . setPlatformBuildVersionName ( framework . getVersionName ());

        manifest . addUsesPermission ( "android.permission.INTERNET" );
        manifest . addUsesPermission ( "android.permission.READ_EXTERNAL_STORAGE" );

        //all appName entries created above have the same resource ids
        manifest . setApplicationLabel ( appNameDefault . getResourceId ());

        ResXmlElement mainActivity = manifest . getOrCreateMainActivity ( "android.app.Activity" );
        ResXmlAttribute labelAttribute = mainActivity
                . getOrCreateAndroidAttribute ( AndroidManifestBlock . NAME_label , AndroidManifestBlock . ID_label );
        labelAttribute . setValueAsString ( "Hello World" );

        //Android os requires at least one dex file on base apk
        ByteInputSource dummyDex = new ByteInputSource ( new byte [ 0 ], "classes.dex" );
        apkModule . add ( dummyDex );

        File outFile = new File ( "test_out.apk" );
        apkModule . writeApk ( outFile );
        //Sign and install
    }
}