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 نفسها.

خطأ في تكوين الناقل

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

العنوان: تغييرات التكوين لـ 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 ورسائل الوسائط المتعددة للتأكد من أنها تعمل بشكل صحيح.

رسالة الالتزام

[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 لسحب التحديث إلى عميلهم المحلي.