APN و CarrierConfig

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

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

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

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

تهيئة بيئة تنموية محلية

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

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

أبلغ عن خطأ

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

علة APN

عيّن سمات الخطأ كما يلي:

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

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

خطأ CarrierConfig

قم بتعيين سمات الخطأ كما يلي:

العنوان: تغييرات التكوين الخاصة بـ CarrierXYZ

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

أرسل التغييرات

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

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

بناء جملة APN

اسم مشروع 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 و 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

عينة CL

انظر عينة BICS APNs للحصول على مثال CL.

بناء جملة CarrierConfig

اسم المشروع - النظام الأساسي / الحزم / التطبيقات / CarrierConfig

اسم (أسماء) الملف - الأصول / 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

راجع ملف تكوين ناقل محدث للحصول على مثال CL.

اطلب مراجعة

لطلب مراجعة:

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

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