الرفرفة: تستمر مشكلة الهدف Android 14 API Level 34 على الرغم من التحديثات

لماذا لا أزال أرى تحذير API المستوى 34؟

في تطوير Flutter، يعد استهداف أحدث مستوى لواجهة برمجة تطبيقات Android أمرًا بالغ الأهمية لضمان توافق التطبيق مع الميزات الجديدة وترقيات الأمان. في الآونة الأخيرة، بعد تغيير targetSdkVersion إلى مستوى واجهة برمجة التطبيقات (API) 34 (Android 14)، أبلغ المطورون أن Play Console لا يزال يحذر من أن التطبيق يجب أن يستهدف Android 14 أو أعلى، على الرغم من نجاح البناء.

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

فهم الحل لاستهداف مستوى واجهة برمجة التطبيقات في Flutter

يقوم البرنامج النصي الأول بتعديل إعداد Android لمشروع Flutter للتأكد من أن التطبيق يستهدف مستوى واجهة برمجة التطبيقات (API) 34 بشكل صحيح. الأوامر الحاسمة هي compileSdkVersion وtargetSdkVersion، والتي تحدد إصدارات Android SDK المستخدمة أثناء التجميع والنشر. يضمن ضبط compileSdkVersion على 34 أن البرنامج مصمم باستخدام Android 14، بينما يحدد targetSdkVersion إصدار Android المقصود لتشغيل التطبيق عليه. تعمل هذه التعديلات على تحديث إعدادات المشروع لتلبية أحدث معايير التقديم في متجر Google Play، وإزالة التحذير المتعلق بمستويات واجهة برمجة التطبيقات غير المدعومة.

يتصل البرنامج النصي الثاني بـ Google Play Console API عبر Python. يقوم بأتمتة عملية اكتشاف وإزالة حزم البرامج القديمة التي قد تسبب مشكلات. google.auth.default() يُرجع بيانات الاعتماد الافتراضية للوصول إلى Play Store API، في حين يقوم build('androidpublisher', 'v3') بتهيئة Google Play Developer API. يستخدم البرنامج النصي بعد ذلك service.edits().bundles().list() للحصول على حزم التطبيقات النشطة، وإذا تم اكتشاف إصدار قديم، service.edits().bundles().delete() يحذفه. أخيرًا، يقوم الأمر service.edits().commit() بحفظ جميع التغييرات وتطبيقها، مما يضمن خلو التطبيق من أي حزم قديمة قد تتسبب في ظهور رسالة الخطأ.

android {
    compileSdkVersion 34
    defaultConfig {
        applicationId "com.example.myapp"
        minSdkVersion 21
        targetSdkVersion 34
        versionCode 1
        versionName "1.0"
    }
}

import google.auth
from googleapiclient.discovery import build
credentials, project = google.auth.default()
service = build('androidpublisher', 'v3', credentials=credentials)
package_name = 'com.example.myapp'
edit_id = service.edits().insert(body={}, packageName=package_name).execute()['id']
bundles = service.edits().bundles().list(packageName=package_name, editId=edit_id).execute()
for bundle in bundles['bundles']:
    if bundle['versionCode'] == 1:  # First build still active
        service.edits().bundles().delete(packageName=package_name, editId=edit_id,
                                        bundleId=bundle['id']).execute()
service.edits().commit(packageName=package_name, editId=edit_id).execute()

حل الحزم المتضاربة في تحديثات تطبيق Flutter.

إحدى المشكلات الشائعة عند تحديث targetSdkVersion لتطبيق Flutter هي وجود حزم التطبيقات القديمة التي لا تزال تظهر على أنها نشطة في Google Play Console. حتى إذا كانت هذه الحزم قديمة، فيمكنها منع التعرف على أحدث إصدار بشكل صحيح، مما يؤدي إلى ظهور تحذيرات مثل "يجب أن يستهدف التطبيق Android 14 (مستوى واجهة برمجة التطبيقات 34) أو أعلى". أثناء تغيير targetSdkVersion إلى 34، يجب على المطورين أيضًا التأكد من أن الإصدارات السابقة لا تعطل عملية التحديث. يمكن أن تساعد إدارة إصدارات التطبيق، وخاصة إزالة الحزم القديمة، في حل هذه المشكلة.

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