ARSCLib

Arsclib

الموارد الثنائية Android قراءة/كتابة مكتبة Java

تم تطوير هذه المكتبة على أساس بنية AOSP من AndroidFW/ResourceTypes.h ، لاستبدال AAPT/AAPT2 بالكامل

اقرأ ، الكتابة ، تعديل وإنشاء

• جدول الموارد (الموارد. arsc)
• ملفات XML الثنائية (AndroidManifest.xml & Resource XML)

تحويل من/json String (للموارد المفرطة)

• تدلل الموارد إلى JSON القابلة للقراءة
• يشفر/يبني مصادر بتنسيق JSON على الموارد الثنائية

تحويل من/سلسلة XML (للموارد غير المقلدة)

• يدلل الموارد إلى رمز المصدر
• يشفر/يبني المصدر XML على الموارد الثنائية

ملحوظات:

1- تتطلب موارد فك التشفير إلى XML أن جميع أسماء المصادر يجب أن تكون غير معروفة وصالحة

2- من المفترض أن يكون لدى المستخدم من هذا LIB معرفة جيدة ببناء مجموعة XML مصدر Android ، وبالتالي أثناء الترميز/إنشاء ، لا يتحقق أو يرمي أخطاء بناء جملة XML كلما AAPT/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
    }
}