APN وCarrierConfig

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

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

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

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

إعداد بيئة تطوير محلية

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

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

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

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

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

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

العنوان: إضافة/تعديل/إزالة نقاط الوصول لـ CarrierXYZ

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

خطأ في CarrierConfig

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

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

الوصف: أضِف وصفًا مفصّلاً للتغييرات التي تتمثّل في طلبك.

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

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

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

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

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

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

يحتوي الملف على إعدادات APN بتنسيق 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 ورسائل الوسائط المتعددة في كل ملف شخصي للتأكّد من أنّها تعمل بشكل صحيح.

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

[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/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]

نموذج طلب الائتمان

اطّلِع على ملف إعدادات مشغّل شبكة الجوّال المعدَّل للاطّلاع على مثال على ملف CL.

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

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

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

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