APN ו-CarrierConfig

ספקים יכולים לעדכן את פרטי שם נקודת הגישה (APN) שלהם ואת הגדרות אישיות ספציפיות לספק (CarrierConfig) בפרויקט הקוד הפתוח של Android (AOSP).

חשבון Google עם כתובת האימייל של החברה שלך

כדי לעדכן את פרטי ה-APN או את CarrierConfig, צריך לשלוח את הבקשה באמצעות חשבון Google עם כתובת אימייל פעילה של החברה (לדוגמה, בקשה לעדכון APN מחברת Acme צריכה להגיע כמו foobar@acme.com).

אם אין לכם חשבון Google שמקשר לכתובת האימייל של החברה כתובת, צא מכל חשבונות Gmail מהדפדפן (מומלץ להשתמש תכונה של גלישה פרטית, כמו חלון פרטי, כדי למנוע בלבול את החשבונות האחרים שלכם) ואז ליצור חשבון חשבון באמצעות כתובת האימייל שלך בחברה.

הכנת סביבת פיתוח מקומית

אם אף פעם לא שלחתם קוד ל-AOSP, צריך לאתחל את סביבת ה-build, להכיר את הכלים להבין איך לשלוח תיקונים:

בנוסף, מומלץ מאוד להשתמש מעקב אחר בעיות של Google לעקוב אחרי השינויים.

דיווח על באג

  1. עוברים אל issuetracker.google.com ולהיכנס באמצעות כתובת האימייל של החברה שלך (מידע נוסף זמין בכתובת חשבון Google עם כתובת האימייל העסקית שלכם).
  2. אחרי ההתחברות, לוחצים על Create issue (יצירת בעיה) בצד השמאלי של האפליקציה. מסך.
  3. בקטע רכיב, בוחרים באפשרות Android Public tracker > מסגרת
  4. אפשר להמשיך אל עדכון ה-APN או עדכון CarrierConfig, בהתאם לצורך כדי להזין את הכותרת והתיאור.

באג ב-APN

מגדירים את מאפייני הבאג באופן הבא:

כותרת: הוספה/שינוי/הסרה של נקודות APN עבור CarrierXYZ

תיאור: תיאור מפורט של השינויים שמתבצעים הבקשה נשלחת, כולל הגדרות ה-APN עצמן.

באג ב-CarrierConfig

מגדירים את מאפייני הבאג באופן הבא:

כותרת: שינויי הגדרה של CarrierXYZ

תיאור: תיאור מפורט של השינויים שמתבצעים בתהליך בקשה.

שלח שינויים

כך מבצעים שינויים:

  1. מזהים את הקובץ שרוצים לשנות.
  2. מבצעים את השינויים הרצויים בקובץ.
  3. שומרים את השינויים במאגר המקומי לפי ההוראות עבור שליחת תיקונים, תשומת לב להנחיות לשמירת הודעות, כולל הפורמט המומלץ.
  4. אחרי שמבצעים את השינוי בהיסטוריה האישית, צריך להעלות אותו ל-Gerrit באמצעות הפקודה repo upload.
  5. לאחר העלאה תקינה, המאגר מספק את כתובת ה-URL של דף חדש באתר גריט. השתמשו בכתובת ה-URL הזו כדי:
    • הצגת התיקון בשרת הביקורות
    • הוספת תגובות
    • בקשת בודקים ספציפיים לתיקון התיקון

תחביר APN

שם פרויקט Android – מכשיר/דוגמה

שמות הקבצים – וכו'/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 שבו יש לכם גישה לרמה הבסיסית (root).
  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 לדוגמה

ראו נקודות 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 לדוגמה

ראה קובץ תצורה מעודכן של הספק בשביל CL לדוגמה.

בקשת בדיקה

כדי לבקש בדיקה:

  • צריך להיכנס לכתובת ה-URL של Gerrit של השינוי ולהוסיף אותה android-carrier-config-review@google.com כבודק.
  • ניתן גם להוסיף את איש הקשר שלך ב-Google לרשימת הכתוביות ב-Gerrit.
  • למטרות מעקב, אפשר לשנות את מקבל ההקצאה של הבעיה ל- android-carrier-config-review@google.com.

אחרי ששולחים את הבקשה, הם עוברים את תהליך הבדיקה והאימות, Gerrit ממזג את השינוי באופן אוטומטי למאגר הציבורי. משתמשים אחרים. יכולים להריץ את repo sync כדי למשוך את העדכון ללקוח המקומי.