تحضير تطبيقك للإصدار

لإعداد تطبيقك للإصدار، عليك إعداد إصدار وإنشائه واختباره. من تطبيقك. تتضمن مهام التهيئة تعليمة برمجية أساسية مهام التنظيف وتعديل الرموز التي تساعد في تحسين تطبيقك. عملية التصميم هي تشبه عملية إنشاء تصحيح الأخطاء، ويمكن إجراؤها باستخدام أدوات JDK وAndroid SDK.

الاختبار المهام بمثابة فحص نهائي، لأنّها تساعد في ضمان أداء تطبيقك على النحو المتوقّع في الواقع الظروف. توفّر منصة Firebase مجموعة كبيرة من أجهزة الاختبار الفعلية والافتراضية من خلال مركز الاختبار الافتراضي لمنصة Firebase والذي يمكنك استخدامها لتحسين جودة تطبيقك.

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

يلخص هذا المستند المهام الرئيسية التي تحتاج إلى القيام بها لإعداد تطبيقك . تنطبق المهام الموضحة في هذه الصفحة على جميع تطبيقات Android، بغض النظر عن وكيفية إصدارها أو توزيعها على المستخدمين. في حال طرح تطبيقك من خلال Google اللعب، يُرجى قراءة مقالة إصدار التطبيقات والألعاب بثقة.

ملاحظة: وفقًا لأفضل الممارسات، عليك أن تتأكد من أن تطبيقك يلبي جميع معايير الإصدار للوظائف والأداء والثبات قبل تنفيذ المهام الموضحة في هذه الصفحة.

الشكل 1. يلزم إعداد مرحلة التحضير للإصدار وهي الخطوة الأولى في عملية النشر

مهام يجب إعدادها للإصدار

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

الشكل 2. هناك خمس مهام رئيسية لإعداد تطبيقك .

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

لإعداد تطبيقك للإصدار، عادةً ما تؤدي خمس مهام رئيسية، كما هو موضح في الشكل 2. قد تتضمن كل مهمة رئيسية واحدة أو أكثر من المهام الأصغر، اعتمادًا على كيفية إصدار التطبيق. على سبيل المثال، إذا كنت بصدد طرح تطبيقك من خلال Google Play، قد تحتاج إلى لإضافة قواعد فلترة خاصة إلى البيان أثناء إعداد تطبيقك لـ . وبالمثل، لاستيفاء إرشادات النشر على Google Play، قد يُطلب منك إعداد لقطات شاشة. وإنشاء نص ترويجي أثناء قيامك بجمع مواد الإصدار.

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

جمع المواد والموارد

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

مفاتيح التشفير

يتطلب Android توقيع جميع حِزم APK رقميًا باستخدام شهادة قبل تثبيتها. على الجهاز أو تم تحديثه. بالنسبة إلى متجر Google Play، ستصل جميع التطبيقات التي تم إنشاؤها بعد آب (أغسطس) 2021 مطلوبة لاستخدام ميزة "توقيع التطبيق" من Play لكن تحميل لا يزال يتطلّب استخدام AAB إلى Play Console توقيعه باستخدام شهادة المطوّر. صفحة أقدم يظل بإمكان تطبيقاتك إجراء توقيع ذاتي، ولكن سواء كنت تستخدم ميزة "توقيع التطبيق" من Play أو بنفسك، عليك توقيع تطبيقك قبل أن تتمكّن من تحميله.

لمعرفة متطلبات الشهادة، يُرجى الاطّلاع على توقيع تطبيقك.

ملاحظة مهمة: يجب توقيع تطبيقك باستخدام ترميز. تنتهي مدة صلاحيته بعد 22 تشرين الأول (أكتوبر) 2033.

قد تحتاج أيضًا إلى الحصول على مفاتيح إصدار أخرى إذا كان تطبيقك يصل إلى خدمة أو يستخدم أي مكتبة تابعة لجهة خارجية تتطلب منك استخدام مفتاح يستند إلى مفتاحك الخاص.

رمز التطبيق

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

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

اتفاقية ترخيص المستخدم النهائي

ننصحك بإعداد اتفاقية ترخيص المستخدم النهائي (EULA) لتطبيقك. يمكن أن تساعدك اتفاقية ترخيص المستخدم النهائي حماية شخصك ومؤسستك وملكيتك الفكرية، وننصحك بتقديم مع تطبيقك.

مواد متنوعة

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

ضبط تطبيقك للإصدار

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

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

اختيار معرّف تطبيق مناسب

تأكد من اختيار رقم تعريف تطبيق مناسب طوال فترة عمل تطبيقك. إِنْتَ لا يمكنك تغيير معرّف التطبيق بعد توزيع التطبيق على المستخدمين. لضبطها، استخدِم السمة applicationId في مستوى الوحدة ملف build.gradle أو build.gradle.kts. لمزيد من المعلومات، يُرجى مراجعة اضبط رقم تعريف التطبيق.

إيقاف تصحيح الأخطاء

  android {
    ...
    buildTypes {
      release {
        isDebuggable = false
        ...
      }
      debug {
        isDebuggable = true
        ...
      }
    }
    ...
  }
  

  android {
    ...
    buildTypes {
      release {
        debuggable false
        ...
      }
      debug {
        debuggable true
        ...
      }
    }
    ...
  }

تفعيل وضبط تقليص حجم التطبيقات

يمكن برمجة العديد من التحسينات التالية من خلال تفعيل التناقص في إصدار تطبيقك على سبيل المثال، يمكنك إضافة قواعد ProGuard لإزالة عبارات السجل، وستحدد أداة تقليص الرموز البرمجية غير المستخدمة وتزيلها الموارد. يمكن للعامل التقليل أيضًا أن يستبدل أسماء الفئات والمتغيرات بأسماء أقصر لإضافة لتقليل حجم DEX.

إيقاف تسجيل الأخطاء

يجب إيقاف التسجيل قبل إنشاء تطبيقك للإصدار. يمكنك إيقاف التسجيل من خلال إزالة الطلبات الموجَّهة إلى Log طريقة في مصدرك الملفات. عليك أيضًا إزالة أي ملفات سجلّ أو ملفات اختبار ثابتة تم إنشاؤها في مشروعك.

إزالة جميع Debug أيضًا وتتبُّع المكالمات التي أضفتها إلى الرمز، مثل startMethodTracing() stopMethodTracing() لاستدعاءات الطريقة.

ملاحظة مهمة: تأكَّد من إيقاف تصحيح أخطاء تطبيقك في حال استخدام WebView عرض محتوى مدفوع أو إذا كنت تستخدم واجهات JavaScript، لأنّ تصحيح الأخطاء يتيح للمستخدمين إدخال النصوص البرمجية واستخراج المحتوى باستخدام أدوات مطوري البرامج في Chrome. لإيقاف تصحيح الأخطاء، استخدم WebView.setWebContentsDebuggingEnabled() .

تنظيف أدلة المشروع

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

• مراجعة محتوى cpp/ وlib/ وsrc/ الأخرى. يجب أن يحتوي الدليل cpp/ على الملفات المصدر المرتبطة بـ Android NDK، مثل ملفات المصدر C أو C++ وملفات العناوين أو إنشاء ملفات. يجب أن يحتوي الدليل lib/ على ملفات مكتبة خارجية فقط أو ملفات المكتبة الخاصة، بما في ذلك المكتبات المشتركة والثابتة المنشأة مسبقًا. src/ الدليل على الملفات المصدر الخاصة بتطبيقك فقط (Java وKotlin وAIDL) ). يجب ألا يحتوي دليل src/ على أي ملفات JAR.
• يجب فحص مشروعك بحثًا عن ملفات بيانات خاصة أو مملوكة لا يستخدمها تطبيقك. وإزالتها. على سبيل المثال، ابحث في دليل res/ لمشروعك عن الملفات القابلة للرسم وملفات التخطيط وملفات القيم التي لم تعد تستخدمها واحذفها.
• راجِع دليل lib/ بحثًا عن مكتبات الاختبار وأزِلها في حال عدم توفّرها. أكثر استخدامًا بواسطة تطبيقك.
• راجِع محتوى دليل assets/ وres/raw/. دليل لملفات الأصول الأولية والملفات الثابتة التي تحتاج إلى تحديثها أو إزالتها قبل .

مراجعة وتعديل إعدادات إصدار Gradle وبيانه

تحقَّق من ضبط عناصر البيان التالية وملفات الإصدار بشكل صحيح:

• عنصر واحد ( <uses-permission>)

  حدد فقط تلك الأذونات ذات الصلة والمطلوبة لـ التطبيق.

• السمتان android:icon وandroid:label

  يجب تحديد قيم لهذه السمات، وتقع في <application> العنصر.

• versionCode وversionName موقع

  ننصحك بتحديد قيم لهذه السمات تتوفّر في التطبيق. على مستوى الوحدة build.gradle أو build.gradle.kts. لمزيد من المعلومات، يُرجى الاطّلاع على تحديد إصدار تطبيقك

هناك العديد من عناصر ملف الإصدار الإضافية التي يمكنك تعيينها إذا كنت بصدد إصدار التطبيق على Google Play. على سبيل المثال، minSdk سمات targetSdk المتوفّرة على مستوى وحدة التطبيق ملف build.gradle أو build.gradle.kts لمزيد من المعلومات عن هذه وإعدادات Google Play الأخرى، يُرجى الاطّلاع على الفلاتر على Google. اللعب.

حلّ المشاكل المتعلّقة بالتوافق

يوفر Android العديد من الأدوات والتقنيات التي تساعد على توافق تطبيقك مع مجموعة واسعة من نطاق من الأجهزة. لإتاحة تطبيقك لأكبر عدد ممكن من المستخدمين، يُرجى مراعاة ذلك القيام بما يلي:

إضافة دعم تهيئات شاشة متعددة.

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

تحسين تطبيقك ليناسب الشاشات الأكبر حجمًا.

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

ننصحك باستخدام مكتبات Jetpack.

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

تعديل عناوين URL للخوادم والخدمات

إذا كان تطبيقك يصل إلى الخوادم أو الخدمات البعيدة، عليك التأكُّد من أنّك تستخدم الإصدار العلني عنوان URL أو مسار للخادم أو الخدمة وليس عنوان URL أو مسار تجريبي.

تنفيذ الترخيص في Google Play

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

لمزيد من المعلومات حول "خدمة الترخيص في Google Play" وكيفية استخدامها في يُرجى الاطّلاع على ترخيص التطبيق.

إنشاء تطبيقك من أجل إصداره

بعد الانتهاء من ضبط تطبيقك، يمكنك تحويله إلى إصدار جاهز للإصدار. ملف APK الذي تم توقيعه وتحسينه. يتضمن سجل JDK أدوات توقيع ملف APK (Keytool وJarsigner) تتضمن حزمة Android SDK أدوات لتجميع تحسين ملف APK. في حال استخدام "استوديو Android" أو استخدام نظام إنشاء Gradle من سطر الأوامر، يمكنك أتمتة عملية الإنشاء بأكملها. لمزيد من المعلومات حول ضبط إصدارات Gradle، يُرجى الاطّلاع على ضبط صيغ الإصدار

إذا كنت تستخدم التكامل المستمر ، يمكنك ضبط مهمة لتشغيل عملية الإصدار لديك بشكل تلقائي. وهذا لا يقتصر على إنشاء APK للإصدار أو AAB يمكنك أيضًا ضبطه لتحميل الإصدار تلقائيًا. العناصر إلى Play Console

الإنشاء باستخدام Android Studio

يمكنك استخدام نظام تصميم Gradle المتوافق مع "استوديو Android" لإنشاء إصدار جاهز حزمة APK التي تم توقيعها باستخدام مفتاحك الخاص وتم تحسينها للتعرف على كيفية إعداد وإنشاء إصدارات من "استوديو Android" والاطّلاع على إنشاء تطبيقك وتشغيله:

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

إعداد الخوادم والموارد الخارجية

إذا كان تطبيقك يعتمد على خادم بعيد، يُرجى التأكّد من أنّ الخادم آمن وأنّه مهيأ للاستخدام في الإنتاج. ويُعتبر ذلك أمرًا مهمًا على وجه الخصوص إذا كنت تنفِّذ الفوترة داخل التطبيقات في تطبيقك وكنت إجراء خطوة التحقق من التوقيع على خادم بعيد.

بالإضافة إلى ذلك، في حال كان تطبيقك يجلب المحتوى من خادم بعيد أو من خدمة في الوقت الفعلي (مثل المحتوى)، فتأكد من أن المحتوى الذي تقدمه حديث وجاهز للإنتاج.

اختبار تطبيقك لإصداره

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

كنقطة بداية للاختبار، انظر جودة التطبيق الأساسية: عند إتمامك للاختبار والتأكّد من أنّ إصدار الإصدار من تطبيقك بشكل صحيح، يمكنك إطلاق تطبيقك للمستخدمين. لمزيد من المعلومات، يُرجى مراجعة أطلِق المستخدمين.