APN وCarrierConfig

يمكن لمشغّلي شبكات الجوّال تعديل معلومات "اسم نقطة الوصول" (APN) وإعدادات الضبط الخاصة بهم (CarrierConfig) في "مشروع Android المفتوح المصدر" (AOSP).

حساب Google باستخدام عنوان بريدك الإلكتروني للشركة

لتعديل معلومات اسم نقطة الوصول (APN) أو CarrierConfig، عليك إرسال الطلب باستخدام حساب Google يتضمّن عنوان بريد إلكتروني نشطًا خاصًا بالشركة (على سبيل المثال، يجب أن يأتي طلب تعديل اسم نقطة الوصول من شركة Acme من عنوان بريد إلكتروني مثل foobar@acme.com).

إذا لم يكن لديك حساب على Google مرتبط بعنوان بريدك الإلكتروني الخاص بالعمل، سجِّل الخروج من جميع حسابات Gmail من المتصفّح (ننصحك باستخدام ميزة التصفّح الخاص، مثل نافذة التصفّح المتخفي، لتجنُّب الخلط بين حساباتك الأخرى)، ثم أنشئ حسابًا على Google باستخدام عنوان بريدك الإلكتروني الخاص بالعمل.

إعداد بيئة تطوير على الجهاز

إذا لم يسبق لك إرسال رمز إلى AOSP، عليك تهيئة بيئة الإصدار والتعرّف على الأدوات وفهم كيفية إرسال تصحيحات:

بالإضافة إلى ذلك، ننصحك بشدة باستخدام Google Issue Tracker لتتبُّع التغييرات.

الإبلاغ عن خطأ

  1. انتقِل إلى issuetracker.google.com وسجِّل الدخول باستخدام عنوان بريدك الإلكتروني الخاص بالشركة (راجِع حساب Google باستخدام عنوان بريدك الإلكتروني الخاص بالشركة).
  2. بعد تسجيل الدخول، انقر على إنشاء مشكلة على الجانب الأيمن من الشاشة.
  3. في المكوّن، اختَر أداة تتبُّع المشاكل العامة في Android > إطار العمل.
  4. تابِع إلى تعديل APN أو تعديل CarrierConfig، حسب الاقتضاء، لإدخال العنوان والوصف.

خلل في اسم نقطة الوصول

اضبط سمات الخطأ على النحو التالي:

العنوان: إضافة/تعديل/إزالة أسماء نقاط الوصول لشركة الاتصالات CarrierXYZ

الوصف: أضِف وصفًا تفصيليًا للتغييرات التي تطلبها، بما في ذلك إعدادات اسم نقطة الوصول نفسها.

خطأ في CarrierConfig

اضبط سمات الخطأ على النحو التالي:

العنوان: تغييرات في الإعدادات لمشغّل شبكة الجوّال CarrierXYZ

الوصف: أضِف وصفًا تفصيليًا للتغييرات التي تطلبها.

إرسال التغييرات

لإجراء تغييرات:

  1. حدِّد الملف الذي تريد تغييره.
  2. أدخِل التغييرات على الملف.
  3. نفِّذ التغييرات في المستودع المحلي باتّباع التعليمات الخاصة بإرسال حِزم التعديل، مع الانتباه إلى إرشادات رسالة التنفيذ، بما في ذلك التنسيق المقترَح.
  4. بعد إكمال التغيير في سجلّك الشخصي، حمِّله إلى Gerrit باستخدام الأمر repo upload.
  5. بعد اكتمال عملية التحميل بنجاح، يوفّر repo عنوان URL لصفحة جديدة على Gerrit. استخدِم عنوان URL هذا لإجراء ما يلي:
    • عرض التصحيح على خادم المراجعة
    • إضافة تعليقات
    • طلب مراجعة التصحيح من مراجعين محدّدين

بنية اسم نقطة الوصول

اسم مشروع Android - الجهاز/العينة

أسماء الملفات - etc/apns-full-conf.xml (رابط Google Git الرئيسي)

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

تبدو إعدادات اسم نقطة الوصول (APN) النموذجية على النحو التالي:

<apn carrier="CarrierXYZ"
      mcc="123"
      mnc="123"
      apn="carrierxyz"
      type="default,supl,mms,ims,cbs"
      mmsc="http://mms.carrierxyz.com"
      mmsproxy="0.0.0.0"
      mmsport="80"
      bearer_bitmask="4|5|6|7|8|12"
/>

الاختبار

  1. وصِّل أي جهاز Android يمكنك الوصول إلى جذره.
  2. أضِف الإعدادات إلى /etc/apns-conf.xml.
  3. إعادة ضبط إعدادات APN
  4. في إعدادات APN، تأكَّد من تحميل الملفات الشخصية بشكلٍ صحيح.
  5. بالنسبة إلى كل ملف شخصي، اختبِر اتصال البيانات ونقطة اتصال Wi-Fi ورسائل MMS للتأكّد من أنّها تعمل بشكل صحيح.

رسالة الإتمام

[Example - "Add CarrierXYZ apns to sample apns"]
Bug: [Issue ID from Google Issue Tracker]
Test: No change to behavior as this is only a sample file

عيّنة من قائمة التغيير

يمكنك الاطّلاع على نموذج APN لنظام BICS للحصول على مثال على CL.

بنية CarrierConfig

اسم المشروع - platform/packages/apps/CarrierConfig

أسماء الملفات - assets/carrier_config_.xml (رابط Google الرئيسي على Git)

حدِّد ملفات XML ذات الصلة في مجلد "الأصول" من خلال مجموعات رموز MCC/MNC ذات الصلة. يحتوي الملف على عنصر إعدادات مشغّل شبكة الجوّال بتنسيق XML. يتم تحديد أسماء السمات كمفاتيح ضمن CarrierConfigManager، ويتم تحديد نوع القيمة (عدد صحيح/سلسلة/قيمة منطقية) من خلال اللاحقات.

تبدو السمات النموذجية من النوع int/string/bool على النحو التالي:

<int name="vvm_port_number_int" value="5499" />
<string name="vvm_type_string">vvm_type_omtp</string >
<boolean name="vvm_cellular_data_required_bool" value="true" />

رسالة الإتمام

[Example - "Add VVM settings for CarrierXYZ"]

[Example - "Updated <mccmnc> carrier config file to include VVM settings
as defined by CarrierXYZ."]

Bug: [Issue ID from Google Issue Tracker]
Test: [Testing notes]

عيّنة من قائمة التغيير

يمكنك الاطّلاع على ملف إعدادات مشغّل شبكة الجوّال المعدَّل للحصول على مثال على قائمة التغيير.

طلب إجراء مراجعة

لطلب إجراء مراجعة، اتّبِع الخطوات التالية:

  • انتقِل إلى عنوان URL الخاص بالتغيير في Gerrit وأضِف android-carrier-config-review@google.com كمراجع.
  • يمكنك أيضًا إضافة جهة اتصال Google إلى قائمة النسخة إلى على Gerrit.
  • لأغراض التتبُّع، يمكنك تغيير الجهة المكلّفة بحلّ المشكلة إلى android-carrier-config-review@google.com.

بعد أن يجتاز طلب الإرسال عملية المراجعة والتحقّق، يدمج Gerrit التغيير تلقائيًا في المستودع العلني. يمكن للمستخدمين الآخرين تشغيل repo sync لسحب التعديل إلى برنامجهم المحلي.