ضبط وحدة التطبيق

تصف هذه الصفحة إعدادات التطبيق المفيدة في build.gradle.kts على مستوى الوحدة. الملف. بالإضافة إلى تقديم نظرة عامة على الخصائص المهمة المحددة في ملف build.gradle.kts، تعرّف على طريقة:

• يمكنك تغيير رقم تعريف التطبيق لإعدادات الإصدار المختلفة.
• يمكنك تعديل مساحة الاسم بأمان بغض النظر عن معرّف التطبيق.

ضبط معرّف التطبيق

يحتوي كل تطبيق Android على معرّف تطبيق فريد يشبه Java أو حزمة Kotlin مثل com.example.myapp. ويعرِّف هذا المعرّف تطبيقك بشكلٍ فريد على وفي "متجر Google Play".

يتم تحديد معرّف التطبيق من خلال السمة applicationId في الوحدة build.gradle.kts، كما هو موضح هنا. تعديل قيمة applicationId من خلال استبدال com.example.myapp بـ معرّف التطبيق:

android {
    defaultConfig {
        applicationId = "com.example.myapp"
        minSdk = 15
        targetSdk = 24
        versionCode = 1
        versionName = "1.0"
    }
    ...
}

android {
    defaultConfig {
        applicationId "com.example.myapp"
        minSdkVersion 15
        targetSdkVersion 24
        versionCode 1
        versionName "1.0"
    }
    ...
}

رغم أن معرّف التطبيق يبدو كحزمة Kotlin أو Java تقليدية. الاسم وقواعد التسمية لمعرف التطبيق أكثر تقييدًا:

• يجب أن يحتوي على جزأين على الأقل (نقطة واحدة أو أكثر).
• يجب أن يبدأ كل مقطع بحرف.
• يجب أن تكون جميع الأحرف أبجدية رقمية أو شرطة سفلية [a-zA-Z0-9_].

عند إنشاء مشروع جديد في Android الاستوديو، applicationId يتم تلقائيًا تخصيص اسم الحزمة التي اخترتها أثناء الإعداد. إِنْتَ من الناحية الفنية، يمكن تبديل الموقعَين بشكل مستقلّ من وقت لآخر، ولكنّها لا يوصى به.

ننصحك بتنفيذ ما يلي عند ضبط معرّف التطبيق:

• حافِظ على معرّف التطبيق هو نفسه مساحة الاسم. الفرق بين أن الموقعين قد يكونان مُحيرَين بعض الشيء، ولكن إذا احتفظت بهما كما هو، عليك فلا داعي للقلق.
• لا تغيِّر معرِّف التطبيق بعد نشر التطبيق. إذا قمت بتغييره، يتعامل "متجر Google Play" مع عملية التحميل اللاحق على أنّها تطبيق جديد.
• تحديد معرّف التطبيق بوضوح. إذا لم يكن معرّف التطبيق واضحًا محدد باستخدام السمة applicationId، فإنه يأخذ تلقائيًا على نفس كمساحة الاسم. هذا يعني أن تغيير مساحة الاسم يؤدي إلى تغيير بمعرف التطبيق، وهو عادة ليس ما تريده.

تغيير معرّف التطبيق للاختبار

تطبِّق أدوات التصميم تلقائيًا معرّف تطبيق على اختبار قياس حالة التطبيق حزمة APK تستخدم معرّف التطبيق لصيغة الإصدار المحدَّد مرفقة مع .test على سبيل المثال، ملف APK تجريبي صيغة واحدة (com.example.myapp.free) من الإصدار رقم تعريف التطبيق com.example.myapp.free.test

رغم أنّه من المفترض ألّا يكون ذلك ضروريًا، يمكنك تغيير معرّف التطبيق من خلال تحديد السمة testApplicationId في defaultConfig حظر "productFlavor"

تعيين مساحة الاسم

تتضمن كل وحدة من وحدات Android مساحة اسم تُستخدم كلغة Kotlin أو Java. اسم الحزمة لـ التي تم إنشاؤها صفّتَي R وBuildConfig.

يتم تحديد مساحة الاسم من خلال السمة namespace في الوحدة build.gradle.kts، كما هو موضح في مقتطف الرمز التالي. namespace يتم ضبطه مبدئيًا على اسم الحزمة الذي تختاره عند إنشاء مشروعك

android {
    namespace = "