اسم نقطة الوصول (APN) وإعدادات مشغّل شبكة الجوال

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

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

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

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

تجهيز بيئة تطوير محلية

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

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

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

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

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

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

العنوان: إضافة/تعديل/إزالة أسماء نقاط الوصول (APN) لـ CarrierXYZ

الوصف: إضافة وصف تفصيلي للتغييرات التي تجريها يطلبونها، بما في ذلك إعدادات اسم نقطة الوصول (APN) نفسها.

خطأ في CarrierConfig

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

العنوان: تغييرات في إعدادات CarrierXYZ

الوصف: إضافة وصف تفصيلي للتغييرات التي تجريها يطلبها.

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

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

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

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

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

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

[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

عرض نماذج أسماء نقاط الوصول (APN) لمعيار BICS كمثال على سجل الفوترة.

بنية CarrierConfig

اسم المشروع - المنصة/الحزم/apps/CarrierConfig

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

حدِّد ملفات XML ذات الصلة في مجلد مواد العرض من خلال حساب "مركز عملائي"/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 إلى قائمة "نسخة إلى" على Gerrit.
  • لأغراض التتبع، يمكنك تغيير الشخص المسؤول عن المشكلة إلى android-carrier-config-review@google.com.

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