إعداد الوحدة الأساسية

تختلف حِزمة التطبيق عن حِزمة APK في أنّه لا يمكن نشرها على جهاز معيّن. إنّها تنسيق نشر يتضمّن جميع الرموز البرمجية المجمّعة والموارد الخاصة بتطبيقك في عنصر إصدار واحد. لذا، بعد تحميل حِزمة التطبيق الموقَّعة، سيتوفّر لدى Google Play كل ما يلزم لإنشاء حِزم APK لتطبيقك وتوقيعها، وعرضها للمستخدمين.

البدء

لن تتطلّب معظم مشاريع التطبيقات الكثير من الجهد لإتاحة استخدام "مجموعات حزمات تطبيق Android". ويرجع ذلك إلى أنّ الوحدة التي تتضمّن الرموز البرمجية والموارد لحزمة APK الأساسية لتطبيقك هي وحدة التطبيق العادية التي تحصل عليها تلقائيًا عند إنشاء مشروع تطبيق جديد في "استوديو Android". أي أنّ الوحدة التي تطبّق المكوّن الإضافي application، كما هو موضّح في المقتطف التالي، على ملف build.gradle الخاص بها توفّر الرمز البرمجي والموارد للوظائف الأساسية لتطبيقك.

أنيق

// The standard application plugin creates your app's base module.
plugins {
 id 'com.android.application'
}

Kotlin

plugins {
    // The standard application plugin creates your app's base module.
    id("com.android.application")
}

بالإضافة إلى توفير الوظيفة الأساسية لتطبيقك، توفّر الوحدة الأساسية أيضًا العديد من إعدادات التصميم وإدخالات البيان التي تؤثر في مشروع تطبيقك بالكامل.

إعدادات تصميم الوحدة الأساسية

بالنسبة إلى معظم مشاريع التطبيقات الحالية، ليس عليك تغيير أي شيء في إعدادات التصميم الخاصة بالوحدة الأساسية. ومع ذلك، إذا كنت تفكر في إضافة وحدات ميزات إلى مشروع تطبيقك أو إذا كنت قد أصدرت تطبيقك سابقًا باستخدام حِزم APK متعددة، فهناك بعض الجوانب المتعلقة بإعدادات التصميم للوحدة الأساسية التي يجب وضعها في الاعتبار.

رمز الإصدار وتحديثات التطبيق

باستخدام مجموعة حزمات تطبيق Android، لن تحتاج إلى إدارة رموز الإصدارات لملفات APK المتعددة التي تحمّلها إلى Google Play. بدلاً من ذلك، يمكنك إدارة رمز إصدار واحد فقط في الوحدة الأساسية لتطبيقك، كما هو موضّح أدناه:

// In your base module build.gradle file
android {
    defaultConfig {
        …
        // You specify your app's version code only in the base module.
        versionCode 5
        versionName "1.0"
    }
}

بعد تحميل حِزمة التطبيق، يستخدم Google Play رمز الإصدار في الوحدة الأساسية لتعيين رمز الإصدار نفسه لجميع حِزم APK التي يتم إنشاؤها من تلك الحِزمة. وهذا يعني أنّه عندما يتم تنزيل تطبيقك وتثبيته على جهاز، فإنّ جميع حِزم APK المجزّأة لهذا التطبيق تشترك في رمز الإصدار نفسه.

عندما تريد تحديث تطبيقك برمز أو موارد جديدة، عليك تحديث رمز الإصدار في الوحدة الأساسية لتطبيقك وإنشاء حزمة تطبيق جديدة كاملة. عند تحميل حِزمة التطبيق هذه إلى Google Play، يتم إنشاء مجموعة جديدة من حِزم APK استنادًا إلى رمز الإصدار الذي تحدّده الوحدة الأساسية. وبعد ذلك، عندما يحدِّث المستخدمون تطبيقك، يقدِّم لهم Google Play الإصدارات المحدَّثة من جميع حِزم APK المثبَّتة حاليًا على الجهاز. وهذا يعني أنّه يتم تحديث جميع حِزم APK المثبَّتة إلى رمز الإصدار الجديد.

اعتبارات أخرى

  • توقيع التطبيق: إذا كنت تريد تضمين معلومات التوقيع في ملفات الإصدار، يجب تضمينها فقط في ملف إعدادات التصميم للوحدة الأساسية. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة ضبط Gradle لتوقيع تطبيقك.
  • تخفيض حجم الرموز: إذا أردت تفعيل تخفيض حجم الرموز لمشروع تطبيقك بالكامل (بما في ذلك وحدات الميزات)، عليك إجراء ذلك من ملف build.gradle الخاص بالوحدة الأساسية. وهذا يعني أنّه يمكنك تضمين قواعد ProGuard مخصّصة في وحدة ميزات، ولكن يتم تجاهل السمة minifyEnabled في إعدادات تصميم وحدة الميزات.
  • يتم تجاهل مجموعة splits: عند إنشاء حزمة تطبيق، يتجاهل Gradle السمات في مجموعة android.splits. إذا أردت التحكّم في أنواع حِزم APK للإعدادات التي تتوافق مع حِزمة تطبيقك، استخدِم android.bundle لإيقاف أنواع حِزم APK للإعدادات.
  • إصدار التطبيق: تحدّد الوحدة الأساسية رمز الإصدار واسم الإصدار لمشروع تطبيقك بالكامل. لمزيد من المعلومات، يُرجى الاطّلاع على رمز الإصدار وتحديثات التطبيق.

إعادة تفعيل أنواع حزم APK للإعدادات أو إيقافها

عند إنشاء حِزمة تطبيق، تتيح تلقائيًا إنشاء حِزم APK لضبط الإعدادات لكل مجموعة من موارد اللغة وموارد كثافة الشاشة ومكتبات الواجهة الثنائية للتطبيق (ABI). باستخدام حزمة android.bundle في ملف build.gradle للوحدة الأساسية، كما هو موضّح أدناه، يمكنك إيقاف إتاحة نوع واحد أو أكثر من حِزم APK للإعدادات:

أنيق

android {
    // When building Android App Bundles, the splits block is ignored.
    // You can remove it, unless you're going to continue to build multiple
    // APKs in parallel with the app bundle
    splits {...}

    // Instead, use the bundle block to control which types of configuration APKs
    // you want your app bundle to support.
    bundle {
        language {
            // This property is set to true by default.
            // You can specify `false` to turn off
            // generating configuration APKs for language resources.
            // These resources are instead packaged with each base and
            // feature APK.
            // Continue reading below to learn about situations when an app
            // might change setting to `false`, otherwise consider leaving
            // the default on for more optimized downloads.
            enableSplit = false
        }
        density {
            // This property is set to true by default.
            enableSplit = true
        }
        abi {
            // This property is set to true by default.
            enableSplit = true
        }
    }
}

Kotlin

android {
    // When building Android App Bundles, the splits block is ignored.
    // You can remove it, unless you're going to continue to build multiple
    // APKs in parallel with the app bundle
    splits {...}

    // Instead, use the bundle block to control which types of configuration APKs
    // you want your app bundle to support.
    bundle {
        language {
            // This property is set to true by default.
            // You can specify `false` to turn off
            // generating configuration APKs for language resources.
            // These resources are instead packaged with each base and
            // feature APK.
            // Continue reading below to learn about situations when an app
            // might change setting to `false`, otherwise consider leaving
            // the default on for more optimized downloads.
            enableSplit = false
        }
        density {
            // This property is set to true by default.
            enableSplit = true
        }
        abi {
            // This property is set to true by default.
            enableSplit = true
        }
    }
}

التعامل مع تغييرات اللغة

يحدّد Google Play موارد اللغة التي سيتم تثبيتها مع التطبيق استنادًا إلى اللغة التي تم اختيارها في إعدادات جهاز المستخدم. لنفترض أنّ أحد المستخدمين غيّر لغة النظام التلقائية بعد تنزيل تطبيقك. إذا كان تطبيقك يتيح استخدام هذه اللغة، سيطلب الجهاز حِزم APK إضافية لإعداد موارد هذه اللغة وينزّلها من Google Play.

بالنسبة إلى التطبيقات التي توفّر أداة اختيار اللغة داخل التطبيق وتغيّر لغة التطبيق بشكل ديناميكي، بغض النظر عن إعدادات اللغة على مستوى النظام، عليك إجراء بعض التغييرات لمنع حدوث أعطال بسبب عدم توفّر الموارد. يمكنك ضبط السمة android.bundle.language.enableSplit على false أو تنفيذ عمليات تنزيل اللغات عند الطلب باستخدام مكتبة Play الأساسية كما هو موضّح في مقالة تنزيل موارد لغوية إضافية.