حل مشكلة You can’t use this package name because it hasn’t been registered بعد تحديث Android Developer Verification
بدأ عدد كبير من مطوري Android مؤخرًا بمواجهة مشكلة جديدة داخل Google Play Console بعد التحديثات الأخيرة من جوجل.
وخاصة أثناء محاولة إنشاء تطبيق جديد باستخدام Package Name تم استخدامه مسبقًا على أي جهاز Android.
وفجأة تظهر الرسالة التالية:
You can't use this package name because it hasn't been registered
وفي هذا المقال سنتعرف بالتفصيل على سبب ظهور هذه المشكلة، وما هو نظام Android Developer Verification الجديد، وكيفية حل المشكلة خطوة بخطوة، بالإضافة إلى أشهر الأخطاء التي قد تقع فيها أثناء التحقق.
ما هو Android Developer Verification؟
هو نظام جديد بدأت جوجل بتطبيقه داخل:
Google Play Console
وهدفه الأساسي هو حماية:
- أسماء التطبيقات.
- الـ Package Names.
- هوية المطورين.
- التطبيقات التي يتم اختبارها خارجيًا.
بمعنى آخر:
إذا قمت سابقًا بـ:
- تثبيت APK على هاتف.
- رفع التطبيق على Firebase App Distribution.
- إرسال نسخة تجريبية للعميل.
- اختبار التطبيق داخليًا.
فجوجل أصبحت تعتبر أن هذا الـ Package Name مستخدم بالفعل ويحتاج إلى إثبات ملكية قبل استخدامه داخل Play Console.
سبب ظهور رسالة الخطأ
تظهر الرسالة التالية:
You can't use this package name because it hasn't been registered
عندما تحاول إنشاء تطبيق جديد باستخدام Package Name سبق استخدامه على أي جهاز Android بدون إكمال عملية التحقق الجديدة.
وهذا لا يعني بالضرورة أن شخصًا آخر استخدم الاسم.
بل قد يكون التطبيق تابعًا لك أنت بالفعل.
لماذا بدأت جوجل تطبيق هذا النظام؟
الهدف الأساسي هو منع:
- سرقة أسماء التطبيقات.
- انتحال التطبيقات.
- رفع تطبيقات مزيفة.
- الاستيلاء على Package Names مستخدمة.
خصوصًا مع انتشار مشاركة ملفات APK خارج المتجر.
كيفية حل المشكلة بالكامل
لحل المشكلة يجب تنفيذ 3 خطوات أساسية.
الخطوة الأولى — إثبات ملكية الـ Keystore
في البداية ستطلب منك جوجل إثبات أنك صاحب الـ Signing Key الخاصة بالتطبيق.
وذلك من خلال مطابقة:
- SHA-256
الخاصة بالـ Keystore.
استخراج SHA-256 من الـ Keystore
افتح Terminal أو CMD واكتب:
keytool -list -v -keystore yourkey.jks
بعدها سيطلب منك:
- Password الخاصة بالـ Keystore.
وبعد التنفيذ ستظهر بيانات كثيرة أهمها:
SHA256:
قم بمقارنة القيمة مع القيم التي تعرضها جوجل ثم اختر المفتاح الصحيح.
مشاكل شائعة أثناء استخراج SHA-256
ظهور خطأ keytool is not recognized
إذا ظهر الخطأ التالي:
keytool is not recognized
فهذا يعني أن Java غير مضافة داخل PATH.
يمكنك استخدام المسار الكامل لـ keytool:
C:\Program Files\Java\jdk-21\bin\keytool.exe
نسيان ملف الـ Keystore
هذه تعتبر من أكبر المشاكل التي قد تواجه أي مطور Android.
لأن فقدان الـ Keystore يعني:
- عدم القدرة على إثبات ملكية التطبيق.
- فشل عملية التحقق.
- عدم القدرة على استخدام نفس Package Name أحيانًا.
ولهذا يجب دائمًا الاحتفاظ بنسخة احتياطية من ملفات:
- Keystore.
- Passwords.
- Alias.
الخطوة الثانية — إنشاء ملف التوثيق
بعد إثبات الـ Key ستطلب منك جوجل إنشاء ملف جديد باسم:
adi-registration.properties
مكان الملف الصحيح
ضع الملف داخل:
android/app/src/main/assets/
إذا كان مجلد:
assets
غير موجود يمكنك إنشاؤه يدويًا.
محتوى الملف
ستعطيك جوجل Token أو كود مخصص تضيفه داخل الملف.
غالبًا يكون بالشكل التالي:
token=xxxxxxxxxxxxxxxx
ولا يجب تعديل القيمة أو تغيير اسم الملف.
وظيفة ملف adi-registration.properties
هذا الملف يعتبر إثبات إضافي أن:
- المشروع تابع لك.
- لديك وصول للسورس كود.
- أنت المالك الحقيقي للتطبيق.
الخطوة الثالثة — Build ورفع APK
في هذه المرحلة ستطلب منك جوجل رفع:
Signed Release APK
وليس:
App Bundle (.aab)
وهذه نقطة يقع فيها عدد كبير من المطورين.
إنشاء APK Release في Flutter
flutter build apk --release
إنشاء APK Release في Android Native
./gradlew assembleRelease
أو من Android Studio:
- Build
- Generate Signed Bundle / APK
- APK
مهم جدًا — لا ترفع App Bundle
الكثير من المطورين يقومون برفع:
.aab
بدل:
.apk
مما يؤدي لفشل التحقق مباشرة.
لأن الـ APK هنا يعتبر فقط وسيلة لإثبات ملكية التطبيق وليس نسخة نشر نهائية.
بعد رفع الـ APK ماذا يحدث؟
بعد الضغط على Submit تقوم جوجل بـ:
- فحص الـ Signature.
- مطابقة الـ Package Name.
- التحقق من الـ Keystore.
- مراجعة ملف التوثيق.
وبعد دقائق قليلة غالبًا سيتم قبول الطلب.
وبعدها يمكنك إنشاء التطبيق بشكل طبيعي داخل:
Google Play Console
أشهر المشاكل أثناء Android Developer Verification
رفع Debug APK بدل Release
يجب أن يكون الملف:
- Release.
- Signed.
وليس:
- Debug APK.
اختيار SHA-256 خاطئ
إذا اخترت Signing Key مختلف ستفشل عملية التحقق بالكامل.
ولهذا يجب التأكد أن:
- الـ APK.
- الـ Keystore.
- SHA-256.
كلهم تابعين لنفس التطبيق.
وضع ملف التوثيق في مسار خاطئ
المسار الصحيح فقط هو:
android/app/src/main/assets/
وأي مسار آخر سيؤدي لفشل التحقق.
نسيان عمل Signing للـ APK
رفع APK بدون Signing سيؤدي لرفض الملف مباشرة.
هل يمكن حجز Package Name قبل إنهاء التطبيق؟
نعم.
يمكنك إنشاء APK بسيط جدًا فقط من أجل:
- إثبات الملكية.
- حجز الـ Package Name.
حتى إذا كان التطبيق غير مكتمل.
الخلاصة
يعتبر نظام Android Developer Verification من أكبر التحديثات الجديدة داخل Google Play Console.
وهو يهدف إلى حماية المطورين ومنع سرقة التطبيقات والـ Package Names.
ولحل مشكلة:
You can't use this package name because it hasn't been registered
يجب تنفيذ 3 خطوات أساسية:
- إثبات ملكية الـ Keystore.
- إنشاء ملف adi-registration.properties.
- رفع Signed Release APK.
وبعدها يمكنك إنشاء التطبيق بشكل طبيعي بدون أي مشاكل.
لمزيد من المقالات : تعلم كيفية ضبط حجم الخط بشكل مثالي في Flutter
لمزيد من المقالات : شرح كيفيه تشفير وفك تشفير الملفات في Flutter باستخدام كود Native
مزيد من المقالات : Windsurf واحد من اشهر ادوات vibe coding لتسريع عملية التطوير للمبرمجين
