«نام نقطه دسترسی» و CarrierConfig

شرکت‌های مخابراتی می‌توانند اطلاعات «نام نقطه دسترسی» (APN) و تنظیمات پیکربندی مختص شرکت مخابراتی (CarrierConfig) خود را در «پروژه منبع باز Android»‏ (AOSP) به‌روز کنند.

«حساب Google» با نشانی ایمیل شرکتی شما

برای به‌روزرسانی اطلاعات APN یا CarrierConfig، باید درخواست را بااستفاده از «حساب Google» با نشانی ایمیل شرکتی فعال ارسال کنید (برای مثال، درخواست به‌روزرسانی APN از Acme Company باید از نشانی ایمیلی مانند foobar@acme.com ارسال شود).

اگر «حساب Google» ندارید که به نشانی ایمیل شرکتی‌تان پیوند داشته باشد، از سیستم همه حساب‌های Gmail در مرورگرتان خارج شوید (توصیه می‌کنیم از ویژگی مرور خصوصی، مثل پنجره ناشناس، استفاده کنید تا با حساب‌های دیگرتان اشتباه نشود) و سپس با نشانی ایمیل شرکتی‌تان حساب Google ایجاد کنید.

آماده کردن محیط توسعه محلی

اگر قبلاً هرگز کدی به AOSP ارسال نکرده‌اید، باید محیط ساخت خود را مقداردهی اولیه کنید، با ابزارها آشنا شوید، و نحوه ارسال وصله‌ها را درک کنید:

علاوه‌براین، اکیداً توصیه می‌کنیم که از Google Issue Tracker برای پیگیری تغییرات استفاده کنید.

گزارش اشکال

  1. به issuetracker.google.com بروید و بااستفاده از نشانی ایمیل شرکتتان به سیستم وارد شوید ( «حساب Google» با نشانی ایمیل شرکتتان را ببینید).
  2. پس‌از ورود به سیستم، روی ایجاد مشکل در سمت راست صفحه کلیک کنید.
  3. در Component (جزء)، Android Public Tracker > Framework (ردیاب عمومی Android > چارچوب) را انتخاب کنید
  4. برای وارد کردن «عنوان» و «شرح»، به‌تناسب به به‌روزرسانی APN یا به‌روزرسانی CarrierConfig بروید.

اشکال «نام نقطه دسترسی»

مشخصه‌های اشکال را به‌صورت زیر تنظیم کنید:

عنوان: افزودن/اصلاح/برداشتن «نام‌های نقطه دسترسی» برای CarrierXYZ

شرح: شرح مفصلی از تغییراتی که درخواست می‌کنید اضافه کنید، ازجمله تنظیمات APN.

اشکال CarrierConfig

مشخصه‌های اشکال را به‌صورت زیر تنظیم کنید:

عنوان: تغییرات پیکربندی برای CarrierXYZ

شرح: شرح مفصلی از تغییراتی که درخواست می‌کنید اضافه کنید.

ارسال تغییرات

برای ایجاد تغییرات:

  1. فایل موردنظر برای تغییر را شناسایی کنید.
  2. تغییراتی در فایل ایجاد کنید.
  3. با دنبال کردن دستورالعمل‌های ارسال وصله‌ها، تغییرات را در مخزن محلی خود ثبت کنید و به دستورالعمل‌های پیام ثبت، ازجمله قالب توصیه‌شده، توجه کنید.
  4. پس‌از اینکه تغییرتان را در سابقه شخصی‌تان ثبت کردید، آن را بااستفاده از فرمان repo upload در Gerrit بارگذاری کنید.
  5. پس‌از بارگذاری موفقیت‌آمیز، repo نشانی وب صفحه جدیدی را در Gerrit ارائه می‌دهد. از این نشانی وب برای موارد زیر استفاده کنید:
    • مشاهده وصله در سرور مرور
    • افزودن نظر
    • درخواست مرورکنندگان خاص برای وصله

نحو APN

نام پروژه Android - دستگاه/نمونه

نام(های) فایل - etc/apns-full-conf.xml (پیوند اصلی Google Git)

این فایل حاوی تنظیمات APN در قالب XML است و به‌عنوان فایل نمونه عمل می‌کند بنابراین تغییری در رفتار دستگاه‌های Android ایجاد نمی‌شود.

پیکربندی معمول «نام نقطه دسترسی» به این شکل است:

<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

برای نمونه CL، نمونه «نام‌های نقطه دسترسی BICS» را ببینید.

نحو 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]

نمونه CL

برای نمونه CL، فایل پیکربندی شرکت مخابراتی به‌روزشده را ببینید.

درخواست بازبینی

برای درخواست بازبینی:

  • به نشانی وب Gerrit تغییرتان بروید و android-carrier-config-review@google.com را به‌عنوان بازبین اضافه کنید.
  • همچنین می‌توانید مخاطب Google خود را به فهرست رونوشت در Gerrit اضافه کنید.
  • برای اهداف پیگیری، می‌توانید واگذارنده مشکل را به android-carrier-config-review@google.com تغییر دهید.

پس‌از اینکه ارسال از فرایند بازبینی و درستی‌سنجی عبور کرد، Gerrit به‌طور خودکار تغییر را در مخزن عمومی ادغام می‌کند. کاربران دیگر می‌توانند repo sync را اجرا کنند تا به‌روزرسانی را به کارخواه محلی خود بکشند.