ARSCLib

arsclib

Android二进制资源读/编写Java库

该库是基于AndroidFW/ResourceTypes.h的AOSP结构开发的，以完全替换AAPT/AAPT22

阅读，写作，修改和创建

• 资源表（Resources.ARSC）
• 二进制XML文件（androidManifest.xml＆Resource XML）

从/转换为JSON字符串（用于混淆的资源）

• 将资源解码为可读的JSON
• 用JSON格式编码/构建源以二进制资源

从/转换为XML字符串（用于未捕获的资源）

• 将资源解码为源代码
• 编码/构建源XML到二进制资源

笔记：

1-将资源解码为XML要求所有源名称均应无用且有效

2-假定该LIB的用户对Android源XML语法有很好的了解，因此在编码/构建过程中，它不会像AAPT/AAPT2一样验证或投掷XML语法错误。例如，您被允许在某些地方设置错误的价值，并且不能阻止成功建造。在AndroidManifest.xml上，您可以设置package="Wrong ? (package) name!"然后，您必须知道Android设备可以接受此类值。

示例应用程序

检查使用此库开发的此工具https://github.com/reandroid/apkeditor

在所有Java支持的平台（Android，Linux，Mac，Windows）上工作

• 小牛

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

• 罐

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

建立罐子

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

例子

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
    }
}