ARSCLib

arsclib

Androidバイナリリソース読み取り/書き込みJavaライブラリ

このライブラリは、androidfw/resourceTypes.hのAOSP構造に基づいて開発されており、aapt/aapt2を完全に置き換える

読み取り、書き込み、変更、作成

• リソーステーブル（Resources.ARSC）
• バイナリXMLファイル（AndroidManifest.xml＆Resource XML）

json文字列から/jsonストリングに変換する（難読化されたリソース用）

• 読みやすいJSONにリソースを解読します
• JSON形式のソースをバイナリリソースにエンコード/ビルドします

/XML文字列から/XML文字列に変換する（肥大化されていないリソース用）

• リソースを解読してコードをソースにします
• ソースXMLをバイナリリソースにエンコード/ビルドします

注：

1- XMLへのデコードリソースには、すべてのソース名が困惑し、有効である必要があります

2-このLIBのユーザーは、AndroidソースXML構文について十分な知識を持っていると想定されているため、エンコード/ビルディング中にXML構文エラーはAPT/AAPT2のように頻繁に検証またはスローしません。たとえば、一部の場所に間違った値を設定することが許可されており、成功した建物を妨げません。 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
    }
}